Skip to content

feat(branch-archaeology): add machine-readable branch archaeology artifacts and docs - #268

Open
cto-new[bot] wants to merge 1 commit into
CoPilot_Experiment_0from
audit/branch-archaeology-kg
Open

feat(branch-archaeology): add machine-readable branch archaeology artifacts and docs#268
cto-new[bot] wants to merge 1 commit into
CoPilot_Experiment_0from
audit/branch-archaeology-kg

Conversation

@cto-new

@cto-new cto-new Bot commented Dec 25, 2025

Copy link
Copy Markdown

Summary

This change introduces a semantic knowledge graph of repository branches by auditing 260 remote branches and emitting machine-readable representations (JSON-LD, YAML-LD, TTL). It adds human-readable documentation (BRANCH_ARCHAEOLOGY.md, BRANCH_ANOMALIES.md), a metadata index (branch_archaeology_meta.yaml), and a regeneration tool (tooling/branch_archaeologist.py). It preserves the branch stratigraphy for agent learning, documents the CoPilot_Experiment_0 and CatCleanup convergence anomaly, and places data under knowledge_core/ with a discoverable docs layout. It includes a quick reference and a summary artifact for operational transparency. No breaking API changes.

Details

  • Audited 260 remote branches; inferred statuses, relationships, version series, and purposes
  • Generated machine-readable outputs: knowledge_core/branch_archaeology.jsonld, knowledge_core/branch_archaeology.yaml, knowledge_core/branch_archaeology.ttl
  • Created knowledge_core/branch_archaeology_meta.yaml metadata linking machine and human outputs
  • Added BRANCH_ARCHAEOLOGY_QUICKREF.md and BRANCH_ARCHAEOLOGY_SUMMARY.md for quick reference and summary
  • Added human-readable docs: docs/BRANCH_ARCHAEOLOGY.md and docs/BRANCH_ANOMALIES.md
  • Implemented regeneration tool: tooling/branch_archaeologist.py
  • Documented CoPilot_Experiment_0 and CatCleanup convergence as deliberate fork-from-cleanup pattern
  • Prepared for L2 repository sync and agent queries; data is discoverable under knowledge_core/ and docs/

Warning: Task VM test is not fully passing, using partial setup (3/3 steps working)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants