Epic: structure as identity -- architecture fingerprints you can trust and compare (lessons from DOOM's DNA and agent-habits)

オープン
  • 何か問題がありますか？
#7,533 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
8/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
活発
技術スタック
python
領域
devtools

調査の方向性

This is a tracking epic, not a single task, so pick one unchecked child rather than the whole list. The most self-contained is #7504, where several functions on one line lose all but the first; start from the function-splitting logic it refers to and reproduce with a one-line, multi-function Python file. Other children touch traceability.json (#7532) and the sfs 3-line function floor, and need design decisions first. Done for a child means its acceptance point in the list is met and the change is covered by a test.

索引モデルが issue の本文から書いたものです。

説明

enhancement epic roadmap

The finding this epic acts on

Three studies point the same way:

  • DOOM's DNA: GitGalaxy's structural signal recovered lineage across 43 descendants and showed which translations kept the original blueprint, against chance and negative controls.
  • agent-habits (https://github.com/squid-protocol/agent-habits): structure alone identified which AI model wrote a program 83 % of the time (chance 27 %, permutation p < 0.001; exploratory, registered for replication as round 3). Each model's structure is stable across independent runs: distance 0.32 within a model against 0.62 between models.
  • temporal crucible: structure did not predict defects beyond file size ("history predicts, structure describes").

So GitGalaxy's structural signal is strongest at describing and comparing code (identity, lineage, translation fidelity, drift) and weakest as a risk predictor. This epic points the architecture work at comparison, and fixes what the studies showed breaks it.

Child work

1. Make formatting irrelevant (the measurements must survive how code is laid out)
  • #7501 / #7503: dense hand-written code is no longer excluded as minified (merged)
  • #7504: several functions on one line lose all but the first
  • Measure on statements and tokens, not physical lines, wherever a metric divides by lines (comment ratio, per-function size). An audit of every line-based metric.
  • sfs's 3-line function floor drops one-line functions, which hides dense authors. Review it, or measure on a canonical form.
2. Calibrated fingerprints with a built-in noise floor
  • An engine-level architecture fingerprint per repo and per module, with the distance scale it should be read against. agent-habits gives the first calibration: same author ≈ 0.32, different author ≈ 0.62, different language ≈ 1.0.
  • An architecture drift signal: did a change move a module's fingerprint beyond its own noise floor?
3. Report style and architecture as separate layers
  • Comments, naming and keywords are habit; decomposition, call graph and module shape are architecture. In agent-habits, different model pairs separate on different layers (Haiku against Sonnet on comments; Sonnet against Codex on structure). Today's exposures blend them.
4. Cross-language blueprint fidelity
  • #7532: paragraph-to-method fidelity along traceability.json. Global fingerprints can't trace a mechanical det-port to its source: 1-3 of 124, chance 0.8 %.
  • A translation-invariant representation for whole-program comparison across languages; the portable lens is not invariant to a systematic translation style.
5. Provenance as a report, with honest confidence
  • Lineage (forks, vendored copies) and author attribution (human or which model), with sample sizes and confidence stated; style can shift between model versions.
6. Validate continuously against AI-written code
  • Add the agent-habits programs, and future rounds, to a crucible corpus, with a standing GitGalaxy / tree-sitter / ctags agreement check per author.
  • Tooling lesson: ctags' default COBOL parser assumes fixed format and silently mismatches free-format code. The comparison tooling should choose the parser from the source format.
7. Agents as an architecture lab (the bigger lever)
  • Coding agents make controlled variation possible: many independent implementations of one spec. Use it, pre-registered as in agent-habits, to tie structure to outcomes: which architectural shapes go with stronger chess engines, faster solvers, or code that absorbs a spec change. This is the "better or worse" study held back for now, plus fault injection.

Not in scope here

Evidence-level work on the burned estates (cases, proofs, ladder) is melek's lane. Item 4 measures translations; it adds no evidence records.

主要言語
Python
スター
57
フォーク
11
平均マージ
1時間 35分
マージ済み PR（30日）
975

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

squid-protocol/gitgalaxy のほかの issue

squid-protocol/gitgalaxy の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。