Skip to content

Commit f64e669

Browse files
Gate 10 align Reading pipeline names
Rename the second Reading pipeline and dependent contract fields to ReadFitsFindingSynthesis, including route payloads, Terminal harness types, QA text, and gate checks. Move the concrete ReadFitsFindingSynthesis PTRR agent files and runtime registry keys under prefixed names so setup, read-comprehension, and AssetPack synthesis identifiers match the V28 pipeline contract.
1 parent d28506b commit f64e669

26 files changed

Lines changed: 351 additions & 293 deletions

BITCODE_SPEC_V28.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -598,7 +598,7 @@ Purpose:
598598
Finish the enterprise Reading product experience around two named pipelines
599599
and five reviewable Terminal steps. `ReadNeedComprehensionSynthesis` turns a
600600
reader's Read Request into a measured Need that the reader can review.
601-
`ReadFindingFitsSynthesis` accepts only that reviewed Need, searches the Bitcode
601+
`ReadFitsFindingSynthesis` accepts only that reviewed Need, searches the Bitcode
602602
Depository for every qualifying fit deposit above the configured confidence and
603603
quality thresholds, synthesizes a source-safe AssetPack from those deposits
604604
when enough fit evidence exists, and prepares BTC settlement and pull-request
@@ -613,13 +613,13 @@ Acceptance criteria:
613613
comprehension, Need measurement, and operator review. All phase ids, agent
614614
ids, PTRR step ids, ThricifiedGeneration ids, prompt ids, and telemetry ids are prefixed under
615615
`ReadNeedComprehensionSynthesis`.
616-
- `ReadFindingFitsSynthesis` owns accepted-Need admission, setup/read
616+
- `ReadFitsFindingSynthesis` owns accepted-Need admission, setup/read
617617
comprehension, depository discovery, vector/lexical Finding Fits search,
618618
AssetPack implementation from qualifying fit deposits, validation,
619619
source-safe preview, Share-to-Fee pricing, settlement readback, and
620620
pull-request delivery. All phase ids, agent ids, PTRR step ids,
621621
ThricifiedGeneration ids, tool ids, prompt ids, and telemetry ids are prefixed under
622-
`ReadFindingFitsSynthesis`.
622+
`ReadFitsFindingSynthesis`.
623623
- the Read-Need comprehension pipeline stores prompt templates, prompt inputs,
624624
interpolated context, raw model responses when used, parsed typed Need,
625625
measurement root, review state, feedback history, resynthesis attempts, and
@@ -837,7 +837,7 @@ Gate 10 acceptance requires:
837837
appends operator feedback without losing earlier feedback turns;
838838
- accepted Need truth: accepting a Need computes an acceptance root, records
839839
review state `accepted`, and emits Finding Fits admission evidence;
840-
- strict admission: `ReadFindingFitsSynthesis` receives only an accepted
840+
- strict admission: `ReadFitsFindingSynthesis` receives only an accepted
841841
`bitcode.read.need` when `requireAcceptedReadNeed=true`; raw Read requests
842842
and unaccepted Needs produce blocked readiness;
843843
- Terminal exposes the first two enterprise Reading steps without raw JSON:
@@ -846,7 +846,7 @@ Gate 10 acceptance requires:
846846

847847
### Gate 11: Finding Fits And Source-Safe AssetPack Preview
848848

849-
Gate 11 owns `ReadFindingFitsSynthesis`: depository search, candidate fit
849+
Gate 11 owns `ReadFitsFindingSynthesis`: depository search, candidate fit
850850
ranking, fitting deposits as synthesis context, AssetPack measurement, source-
851851
safe preview, Share-to-Fee quote, and proof-rich Terminal stream visibility.
852852

@@ -979,15 +979,15 @@ The Terminal enterprise Reading path is exactly five user steps:
979979
history. Terminal shows the full Need; the user can accept it or request
980980
resynthesis with feedback. No depository search, BTC fee, BTD mint, or
981981
AssetPack source disclosure is allowed before Need acceptance.
982-
3. **Request Fit.** `ReadFindingFitsSynthesis` accepts only the latest accepted
982+
3. **Request Fit.** `ReadFitsFindingSynthesis` accepts only the latest accepted
983983
Need. The pipeline verifies Need schema/review/measurement roots, prepares
984984
setup and read-comprehension context, then the discovery phase searches the
985985
Depository through lexical and vector channels, admits every deposit whose
986986
source-bound score, confidence, proof, measurement, and readback posture are
987987
above the configured thresholds, ranks those fits, and returns
988988
`worthy_fit`, `no_worthy_fit`, or `blocked_readiness`.
989989
4. **Review synthesized AssetPack.** When a worthy fit exists,
990-
`ReadFindingFitsSynthesis` implementation uses the discovered fit deposits
990+
`ReadFitsFindingSynthesis` implementation uses the discovered fit deposits
991991
as contextual knowledge to synthesize a source-safe AssetPack preview for
992992
the accepted Need. Preview may show Need measurement, Fit measurement, fit
993993
deposit ids, roots, score bands, proof posture, ownership boundary,
@@ -1063,26 +1063,26 @@ and `retry`. Every PTRR step owns three ThricifiedGeneration units for
10631063
`prepare-concise-context`, `chunk-then-sum`, and `stitch-until-complete`; each
10641064
ThricifiedGeneration is the strict reason, judge, structured-output sequence.
10651065

1066-
`ReadFindingFitsSynthesis` has seven phases, eight PTRR agents, thirty-two
1066+
`ReadFitsFindingSynthesis` has seven phases, eight PTRR agents, thirty-two
10671067
declared PTRR steps, ninety-six ThricifiedGeneration units, sixteen
10681068
model-structured PTRR steps, and four tool contracts:
10691069

10701070
| Phase | PTRR agent | Agent objective | Return type |
10711071
| --- | --- | --- | --- |
1072-
| `ReadFindingFitsSynthesis.admit` | `ReadFindingFitsSynthesis.admit.accepted-need-gate` | verify accepted Need: schema, review state, measurement root | `ReadFindingFitsAdmission` |
1073-
| `ReadFindingFitsSynthesis.prepare` | `ReadFindingFitsSynthesis.prepare.setup-plan` | setup plan: summarize Read, source revision, fit boundaries | `PlanSchema` |
1074-
| `ReadFindingFitsSynthesis.prepare` | `ReadFindingFitsSynthesis.prepare.read-comprehension` | comprehend Read: primary intent, satisfaction criteria, entities, risk admission | `BoundedReadComprehensionSchema` |
1075-
| `ReadFindingFitsSynthesis.discovery` | `ReadFindingFitsSynthesis.discovery.finding-fits` | discover fit deposits: build query, lexical search, vector search, admit qualifying fit deposits, rank fit deposits | `DepositoryFitsResult` |
1076-
| `ReadFindingFitsSynthesis.implementation` | `ReadFindingFitsSynthesis.implementation.asset-pack` | structured AssetPack synthesis from fit deposits: plan pack, write evidence, bind proof, prepare preview | `AssetPackSynthesisOutput` |
1077-
| `ReadFindingFitsSynthesis.validate` | `ReadFindingFitsSynthesis.validate.fit-quality` | source/proof readiness: validate search, synthesis, disclosure, finish readiness | `ReadyToFinishOutput` |
1078-
| `ReadFindingFitsSynthesis.preview` | `ReadFindingFitsSynthesis.preview.source-safe-preview` | measure fee and lock source: Share-to-Fee, range projection, access policy, source lock | `AssetPackSourceSafePreview` |
1079-
| `ReadFindingFitsSynthesis.settle` | `ReadFindingFitsSynthesis.settle.buy-deliver` | buy and deliver: reader BTC fee, range/license/journal readback, pull request, completion | `AssetPackCompletionOutput` |
1072+
| `ReadFitsFindingSynthesis.admit` | `ReadFitsFindingSynthesis.admit.accepted-need-gate` | verify accepted Need: schema, review state, measurement root | `ReadFitsFindingAdmission` |
1073+
| `ReadFitsFindingSynthesis.prepare` | `ReadFitsFindingSynthesis.prepare.setup-plan` | setup plan: summarize Read, source revision, fit boundaries | `PlanSchema` |
1074+
| `ReadFitsFindingSynthesis.prepare` | `ReadFitsFindingSynthesis.prepare.read-comprehension` | comprehend Read: primary intent, satisfaction criteria, entities, risk admission | `BoundedReadComprehensionSchema` |
1075+
| `ReadFitsFindingSynthesis.discovery` | `ReadFitsFindingSynthesis.discovery.finding-fits` | discover fit deposits: build query, lexical search, vector search, admit qualifying fit deposits, rank fit deposits | `DepositoryFitsResult` |
1076+
| `ReadFitsFindingSynthesis.implementation` | `ReadFitsFindingSynthesis.implementation.asset-pack` | structured AssetPack synthesis from fit deposits: plan pack, write evidence, bind proof, prepare preview | `AssetPackSynthesisOutput` |
1077+
| `ReadFitsFindingSynthesis.validate` | `ReadFitsFindingSynthesis.validate.fit-quality` | source/proof readiness: validate search, synthesis, disclosure, finish readiness | `ReadyToFinishOutput` |
1078+
| `ReadFitsFindingSynthesis.preview` | `ReadFitsFindingSynthesis.preview.source-safe-preview` | measure fee and lock source: Share-to-Fee, range projection, access policy, source lock | `AssetPackSourceSafePreview` |
1079+
| `ReadFitsFindingSynthesis.settle` | `ReadFitsFindingSynthesis.settle.buy-deliver` | buy and deliver: reader BTC fee, range/license/journal readback, pull request, completion | `AssetPackCompletionOutput` |
10801080

10811081
The required tool contracts are
1082-
`ReadFindingFitsSynthesis.tool.lexical-depository-search`,
1083-
`ReadFindingFitsSynthesis.tool.vector-depository-search`,
1084-
`ReadFindingFitsSynthesis.tool.verification-evidence`, and
1085-
`ReadFindingFitsSynthesis.tool.vcs-create-pull-request`. Every inference telemetry
1082+
`ReadFitsFindingSynthesis.tool.lexical-depository-search`,
1083+
`ReadFitsFindingSynthesis.tool.vector-depository-search`,
1084+
`ReadFitsFindingSynthesis.tool.verification-evidence`, and
1085+
`ReadFitsFindingSynthesis.tool.vcs-create-pull-request`. Every inference telemetry
10861086
line must expose prompt template, interpolated prompt/messages, raw response,
10871087
parsed typed output, schema/return type, usage/timing, execution state, and
10881088
fail-closed status. Every tool telemetry line must expose tool id, input
@@ -1106,15 +1106,15 @@ Terminal step 2: review synthesized Need
11061106
-> ReadNeedComprehensionSynthesis.review
11071107
-> accepted bitcode.read.need
11081108
Terminal step 3: request Fit
1109-
-> ReadFindingFitsSynthesis.admit
1110-
-> ReadFindingFitsSynthesis.prepare
1111-
-> ReadFindingFitsSynthesis.discovery
1109+
-> ReadFitsFindingSynthesis.admit
1110+
-> ReadFitsFindingSynthesis.prepare
1111+
-> ReadFitsFindingSynthesis.discovery
11121112
Terminal step 4: review synthesized AssetPack
1113-
-> ReadFindingFitsSynthesis.implementation
1114-
-> ReadFindingFitsSynthesis.validate
1115-
-> ReadFindingFitsSynthesis.preview
1113+
-> ReadFitsFindingSynthesis.implementation
1114+
-> ReadFitsFindingSynthesis.validate
1115+
-> ReadFitsFindingSynthesis.preview
11161116
Terminal step 5: buy AssetPack, settle
1117-
-> ReadFindingFitsSynthesis.settle
1117+
-> ReadFitsFindingSynthesis.settle
11181118
-> BTC fee readback + BTD range/license/journal readback + pull request
11191119
```
11201120

@@ -1146,7 +1146,7 @@ Prompt and return-type audit:
11461146
| Pipeline | Model-structured PTRR agents | Model-structured PTRR steps | Model prompt templates | Parsed return types |
11471147
| --- | ---: | ---: | --- | --- |
11481148
| `ReadNeedComprehensionSynthesis` | 1 | 4 | `ReadNeedComprehensionSynthesis.prompt.need-synthesis` | `ReadNeed` |
1149-
| `ReadFindingFitsSynthesis` | 4 | 16 | `ReadFindingFitsSynthesis.prompt.setup-plan`; `ReadFindingFitsSynthesis.prompt.read-comprehension`; `ReadFindingFitsSynthesis.prompt.asset-pack-synthesis`; `ReadFindingFitsSynthesis.prompt.fit-quality-validation` | `PlanSchema`; `BoundedReadComprehensionSchema`; `AssetPackSynthesisOutput`; `ReadyToFinishOutput` |
1149+
| `ReadFitsFindingSynthesis` | 4 | 16 | `ReadFitsFindingSynthesis.prompt.setup-plan`; `ReadFitsFindingSynthesis.prompt.read-comprehension`; `ReadFitsFindingSynthesis.prompt.asset-pack-synthesis`; `ReadFitsFindingSynthesis.prompt.fit-quality-validation` | `PlanSchema`; `BoundedReadComprehensionSchema`; `AssetPackSynthesisOutput`; `ReadyToFinishOutput` |
11501150

11511151
Every model-structured PTRR step records the common prompt registry posture:
11521152
`factoryAgentWithPTRR` with the `prompt` + `stepPrompts` carrier, agent
@@ -1159,7 +1159,7 @@ Tool audit:
11591159
| Pipeline | Tool count | Tool ids | Return types |
11601160
| --- | ---: | --- | --- |
11611161
| `ReadNeedComprehensionSynthesis` | 0 | none | none |
1162-
| `ReadFindingFitsSynthesis` | 4 | `ReadFindingFitsSynthesis.tool.lexical-depository-search`; `ReadFindingFitsSynthesis.tool.vector-depository-search`; `ReadFindingFitsSynthesis.tool.verification-evidence`; `ReadFindingFitsSynthesis.tool.vcs-create-pull-request` | `DepositorySearchResult`; `EmbeddingSearchResult`; `AssetPackVerificationEvidenceResult`; `PullRequestDeliveryResult` |
1162+
| `ReadFitsFindingSynthesis` | 4 | `ReadFitsFindingSynthesis.tool.lexical-depository-search`; `ReadFitsFindingSynthesis.tool.vector-depository-search`; `ReadFitsFindingSynthesis.tool.verification-evidence`; `ReadFitsFindingSynthesis.tool.vcs-create-pull-request` | `DepositorySearchResult`; `EmbeddingSearchResult`; `AssetPackVerificationEvidenceResult`; `PullRequestDeliveryResult` |
11631163

11641164
### Share-to-Fee measurement clarity
11651165

0 commit comments

Comments
 (0)