All runbooks
evidenceuai-explorerredacted view

Repo Docs Catalog Sync Evidence

Synced UAI Explorer evidence documentation from docs/evidence/repo-docs-catalog-sync-2026-06-21.md.

Updated 2026-06-21·Freshness: Reference·Sensitive tokens or credentials were hidden before display.

Repo Docs Catalog Sync Evidence

Date: 2026-06-21
Timezone: America/St_Johns

Scope

Synced repo-native Markdown documentation into the curated UAI Explorer catalog so current runbooks, rules, start files, plans, surveys, diary entries, and evidence are reachable through Explorer instead of remaining local-only files.

This lane is for public-safe repo documentation only. It does not read or publish raw survey zones, selected-redaction inputs, uploads, .env, .ssh, auth stores, browser profiles, or arbitrary device paths.

Worker

Worker: tools/sync_repo_docs_catalog.py

The worker:

  • discovers root Markdown docs and docs/**/*.md,
  • rejects secret-shaped Markdown content before copying,
  • copies docs into the Explorer DATA_ROOT under uai-explorer-docs/,
  • creates or updates catalog rows with required tags,
  • marks synced docs human-visible and AI-visible for authorized docs and uai-explorer users,
  • records a public-safe JSON result.

Local Verification

Focused tests passed:

python -m unittest tests.test_sync_repo_docs_catalog -v

Coverage includes:

  • [REDACTED:high-entropy],
  • test_dry_run_does_not_mutate_data_or_db,
  • test_secret_shaped_doc_fails_closed.

Dry-run generated [REDACTED:high-entropy].json with apply=false.

Production And Sandbox Apply

Final apply result:

  • CT 121 docs sync output kind: uai-repo-docs-catalog-sync.
  • CT 121 docs synced: 60.
  • CT 121 catalog count after sync: 67.
  • CT 126 docs sync output kind: uai-repo-docs-catalog-sync.
  • CT 126 docs synced: 60.
  • CT 126 catalog count after sync: 67.

Both CT 121 and CT 126 then returned /ready with status=ready, public_safe_mode=true, redaction_boundary=server-side, raw downloads disabled, legacy file APIs disabled, uploads disabled, and no raw survey mount.

The catalog is the operational documentation surface.

Boundary

  • Raw content included: false.
  • Raw source paths included: false.
  • Raw source hashes included: false.
  • External exposure changed: false.
  • Storage cleanup performed: false.
  • Node onboarding performed: false.

Result

Current UAI Explorer Markdown documentation, including the AI bootstrap contract evidence, final QA/QoL punch list, UAI development standards runbook, AI memory/knowledge/Beacon/Mesh runbook, and UAI-wide agent feedback convention, is synced into the live Explorer catalog. Local repo and device copies are now caches or drafting lanes; the catalog is the operational documentation surface.