{
  "generated_at": "2026-05-11T13:53:52.711Z",
  "system": {
    "id": "topolo-docs",
    "name": "TopoloDocs",
    "slug": "topolo-docs",
    "kind": "application",
    "summary": "Canonical documentation, system registry, machine-readable platform evidence, and docs validation surface for the Topolo Platform.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-05-11",
    "owners": [
      "platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloDocs"
    ],
    "service_ids": [
      "srv_topolo_docs"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloDocs/src/content/internal/platform/docs-governance.mdx",
      "notes": "TopoloDocs owns the canonical published docs, internal handbooks, system registry JSON, generated Auth catalog snapshot, and security/privacy evidence reports used by launch and deployment gates."
    },
    "primary_hosts": [
      "https://docs.topolo.app",
      "https://docs.stg.topolo.us"
    ],
    "doc_paths": [
      "applications/docs",
      "internal/apps/docs"
    ],
    "security_assurance": {
      "risk_tier": "high",
      "auth_boundary": "Public documentation plus internal machine evidence and operator validation workflows; authoring and deployment remain repository and CloudControl controlled.",
      "tenant_isolation": "internal",
      "external_inputs": [
        "browser",
        "api",
        "operator_tool"
      ],
      "sensitive_data": [
        "telemetry",
        "provider_credentials"
      ],
      "last_security_review": "2026-05-11",
      "security_review_status": "reviewed",
      "pentest_status": "not_started",
      "evidence_doc": "internal/apps/docs"
    },
    "data_privacy": {
      "classification": "internal",
      "sensitive_data_classes": [
        "telemetry",
        "provider_credentials"
      ],
      "storage_locations": [
        "source_control"
      ],
      "encryption_at_rest": "platform_managed",
      "encryption_in_transit": "https_only",
      "key_management": "cloudflare_managed",
      "retention_policy": "partial",
      "deletion_export_status": "planned",
      "logging_redaction_status": "partial",
      "privacy_review_status": "reviewed",
      "enterprise_ready": false,
      "evidence_doc": "internal/apps/docs"
    },
    "dependencies": [
      "topolo-auth",
      "cloud-control"
    ],
    "bugfix_policy": {
      "tier": "autonomous",
      "preferred_agent": "either",
      "require_validator": false
    },
    "public_hub_url": "/systems/topolo-docs",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-docs",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-docs.json",
      "application": "/machine/applications/topolo-docs.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/docs",
        "title": "TopoloDocs",
        "summary": "Canonical documentation, system registry, and machine-readable launch evidence for the Topolo Platform.",
        "audience": "public",
        "tags": [
          "docs",
          "registry",
          "platform"
        ],
        "url": "/applications/docs",
        "last_verified": "2026-05-11"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloDocs"
    ],
    "service_ids": [
      "srv_topolo_docs"
    ],
    "dependencies": [
      "topolo-auth",
      "cloud-control"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloDocs/src/content/internal/platform/docs-governance.mdx",
    "contract_source_exists": true,
    "openapi": null,
    "readme": null
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "id": "aks_docs_docs_read",
        "name": "docs.read",
        "description": "View documentation pages and metadata",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_docs_docs_write",
        "name": "docs.write",
        "description": "Author and edit documentation content",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "id": "aks_docs_validation_invoke",
        "name": "validation.invoke",
        "description": "Run documentation validation and link checks",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "id": "perm_docs_docs_read",
        "name": "docs:read",
        "description": "View documentation pages and metadata",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_docs_docs_write",
        "name": "docs:write",
        "description": "Author and edit documentation content",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "id": "perm_docs_validation_invoke",
        "name": "validation:invoke",
        "description": "Run documentation validation and link checks",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [
      "https://docs.topolo.app",
      "https://docs.stg.topolo.us"
    ],
    "repo_entries": [
      "PlatformApplications/TopoloDocs/astro.config.mjs",
      "PlatformApplications/TopoloDocs/functions/",
      "PlatformApplications/TopoloDocs/package-lock.json",
      "PlatformApplications/TopoloDocs/package.json",
      "PlatformApplications/TopoloDocs/pnpm-lock.yaml",
      "PlatformApplications/TopoloDocs/public/",
      "PlatformApplications/TopoloDocs/scripts/",
      "PlatformApplications/TopoloDocs/src/",
      "PlatformApplications/TopoloDocs/templates/",
      "PlatformApplications/TopoloDocs/test/",
      "PlatformApplications/TopoloDocs/topolo.cloudcontrol.json",
      "PlatformApplications/TopoloDocs/tsconfig.json",
      "PlatformApplications/TopoloDocs/vitest.config.ts"
    ],
    "wrangler_surfaces": [],
    "packages": [
      {
        "path": "PlatformApplications/TopoloDocs/package.json",
        "name": "topolo-docs",
        "description": "Topolo Developer Documentation - docs.topolo.app",
        "scripts": [
          "dev",
          "build",
          "build:production",
          "build:publication",
          "deploy",
          "deploy:staging",
          "deploy:gated",
          "security-gate",
          "security-gate:production",
          "security-gate:publication",
          "privacy-gate",
          "privacy-gate:production",
          "privacy-gate:publication",
          "security-report",
          "auth-catalog:snapshot",
          "auth-catalog:check"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "astro dev"
          },
          {
            "name": "build",
            "command": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\" && astro build && node ./scripts/write-manifest.mjs && node ./scripts/write-security-assurance-report.mjs"
          },
          {
            "name": "build:production",
            "command": "npm run security-gate:production && npm run build"
          },
          {
            "name": "build:publication",
            "command": "npm run security-gate:publication && npm run build"
          },
          {
            "name": "deploy",
            "command": "node -e 'console.error(\"\\n✘ Bare \\\"deploy\\\" is disabled. Use deploy:staging or deploy:production.\\n\"); process.exit(1)'"
          },
          {
            "name": "deploy:staging",
            "command": "DEPLOY_ENVIRONMENT=staging CLOUDFLARE_ACCOUNT_ID=4f4e1c69a3830946f9fea7b1eb7531ac python3 .github/scripts/standard_deploy.py local-deploy"
          },
          {
            "name": "deploy:gated",
            "command": "npm run build:production && node ./scripts/deploy-pages.mjs"
          },
          {
            "name": "security-gate",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=advisory"
          },
          {
            "name": "security-gate:production",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=production"
          },
          {
            "name": "security-gate:publication",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=publication"
          },
          {
            "name": "privacy-gate",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=advisory"
          },
          {
            "name": "privacy-gate:production",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=production"
          },
          {
            "name": "privacy-gate:publication",
            "command": "node ./scripts/check-security-assurance-thresholds.mjs --profile=publication"
          },
          {
            "name": "security-report",
            "command": "node ./scripts/write-security-assurance-report.mjs"
          },
          {
            "name": "auth-catalog:snapshot",
            "command": "node ./scripts/write-auth-catalog-snapshot.mjs"
          },
          {
            "name": "auth-catalog:check",
            "command": "node ./scripts/write-auth-catalog-snapshot.mjs --check"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [],
    "bindings": [],
    "queue_bindings": [],
    "storage_kinds": [],
    "workflow_signals": []
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloDocs/package.json :: node -e \"fs.rmSync('dist', { recursive: true, force: true })\" && astro build && node ./scripts/write-manifest.mjs && node ./scripts/write-security-assurance-report.mjs"
      },
      {
        "name": "build:production",
        "command": "PlatformApplications/TopoloDocs/package.json :: npm run security-gate:production && npm run build"
      },
      {
        "name": "build:publication",
        "command": "PlatformApplications/TopoloDocs/package.json :: npm run security-gate:publication && npm run build"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloDocs/package.json :: node -e 'console.error(\"\\n✘ Bare \\\"deploy\\\" is disabled. Use deploy:staging or deploy:production.\\n\"); process.exit(1)'"
      },
      {
        "name": "deploy:staging",
        "command": "PlatformApplications/TopoloDocs/package.json :: DEPLOY_ENVIRONMENT=staging CLOUDFLARE_ACCOUNT_ID=4f4e1c69a3830946f9fea7b1eb7531ac python3 .github/scripts/standard_deploy.py local-deploy"
      },
      {
        "name": "deploy:gated",
        "command": "PlatformApplications/TopoloDocs/package.json :: npm run build:production && node ./scripts/deploy-pages.mjs"
      }
    ],
    "routes": [],
    "environments": [],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [
      "No wrangler.toml surface was discovered under the registered repo paths.",
      "Neither OpenAPI nor README-derived interface detail was found."
    ],
    "entrypoints": [
      "PlatformApplications/TopoloDocs/src/content/internal/platform/docs-governance.mdx",
      "PlatformApplications/TopoloDocs/package.json"
    ]
  }
}