Skip to content

Implement #300 version-bound component qualification harness - #302

Merged
Knapp-Kevin merged 30 commits into
mainfrom
implementation/300-component-qualification-harness
Aug 14, 2026
Merged

Knapp-Kevin merged 30 commits into
mainfrom
implementation/300-component-qualification-harness

Conversation

@Knapp-Kevin

@Knapp-Kevin Knapp-Kevin commented Aug 14, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Implements the first reusable provider-neutral component adapter + capability qualification harness from #300, including a real pinned CodeGenome/Graphify proof for the code_graph_traversal capability family.

This PR implements:

  • machine-readable component-capability-qualification evidence schema;
  • exact component/capability/adapter/profile/runtime applicability hashing;
  • explicit stale-qualification refusal after version/configuration drift;
  • provider-neutral AdapterResult preserving raw provider output separately from normalized facts;
  • explicit maturity progression: maturity_before -> earned_maturity, bounded by profile_maturity_ceiling;
  • invariant authority_effect = none for adapter and qualification evidence;
  • deterministic v1/v2 Rust fixture with overlapping middle target line and distinct old/decoy/replacement leaf identities;
  • stale-currentness negative tests;
  • exact pinned CodeGenome and Graphify execution workflow;
  • raw artifact upload plus normalized qualification records;
  • explicit full-rebuild currentness posture for this first provider proof;
  • no scalar winner and no promotion of unrelated capabilities.

Evidence boundary

Base:

db0c52920bb7d704cd8d38af598fe3bd622fe897

Executed provider pins:

  • CodeGenome 43a6b7147ec78ec5c616723fa1dd30f342174860
  • Graphify v0.9.43 / commit 7281f27eac568f77f50910f59f84543458f5dfd1

The CodeGenome planning pin was originally d2578729a46d495369bd7613845002d50cf20f4c. The qualification fixture exposed a remaining cross-file semantic resolver collision at that revision: symbol lookup was keyed only by name and caller-span lookup only by line range, allowing a decoy file to contaminate traversal despite the earlier target-file fix. That defect was repaired in CodeGenome #12 / PR #13 and merged as 43a6b7147ec78ec5c616723fa1dd30f342174860. This PR deliberately re-pins to the repaired merged revision rather than weakening the qualification checks.

Graphify's native NetworkX node-link evidence stores relationships under links; the normalizer now consumes that native shape and preserves edges only as a compatibility fallback.

The workflow verifies the exact source refs and source-rights files before executing either provider.

Qualification profile

This bounded profile may advance a successfully wired provider from runtime_wired to at most evidence_proven.

It deliberately does not claim reference_qualified, because #300 still requires broader negative-path evidence such as explicit provider-unavailability/fallback behavior before that maturity is earned.

Currentness is proven using an explicit full rebuild between fixture v1 and v2 rather than pretending incremental refresh exists when it has not been proven.

Key boundaries

installation declaration != qualification evidence
provider success != Agent Memory conformance
old qualification != changed-version qualification
normalization != canonicalization
qualification != authority
one qualified capability != whole-component maturity
matched result != scalar product winner

Closes #301.
Refs #300.
Refs #293.
Refs MythologIQ-Labs-LLC/CodeGenome#12.
Refs MythologIQ-Labs-LLC/CodeGenome#13.

@Knapp-Kevin Knapp-Kevin changed the title Implement #300 qualification contract foundation Implement #300 version-bound component qualification harness Aug 14, 2026

Copy link
Copy Markdown
Collaborator Author

Exact-head CI repair result

Final repaired head: 676d2602e380270249f1ae00e0a6cc22a6246556

Required gates are green:

  • Component Qualification Foundation run 31851016615 — success
  • Component Qualification Evidence run 31851016868 — success
  • Validate Doctrine Evidence run 31851016646 — success
  • all other workflows associated with this exact head are also completed successfully

The uploaded qualification artifact (9237584732, digest sha256:6b66839775b7d44b91e4fc41a32126c3ac8bd9002560b7ed5016979dfe335d50) proves:

CodeGenome passed = true
Graphify passed = true
both_passed = true
winner = null
authority_effect = none
unrelated_capabilities_promoted = []

CodeGenome now passes the file-isolation and direction regressions at exact merged revision 43a6b7147ec78ec5c616723fa1dd30f342174860, including v1/v2 decoy exclusion and full-rebuild currentness.

Graphify's native links evidence normalizes to the expected v1/v2 call facts and drops the stale v1 middle -> leaf edge after the v2 rebuild.

The failed CI run therefore produced two useful outcomes rather than being papered over: a real CodeGenome defect was repaired upstream, and a real Graphify normalizer defect was repaired in this harness.

@Knapp-Kevin
Knapp-Kevin marked this pull request as ready for review August 14, 2026 23:43
@Knapp-Kevin
Knapp-Kevin merged commit 6b7af35 into main Aug 14, 2026
67 checks passed
@Knapp-Kevin
Knapp-Kevin deleted the implementation/300-component-qualification-harness branch August 14, 2026 23:43
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.

[Implementation Slice] #300 contract/schema + deterministic harness foundation

1 participant