daftari 3.6.0 → 3.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +34 -0
- package/README.md +4 -0
- package/dist/access/rbac.d.ts +1 -0
- package/dist/access/rbac.d.ts.map +1 -1
- package/dist/access/rbac.js +8 -0
- package/dist/access/rbac.js.map +1 -1
- package/dist/attest/bundle.d.ts +53 -0
- package/dist/attest/bundle.d.ts.map +1 -0
- package/dist/attest/bundle.js +141 -0
- package/dist/attest/bundle.js.map +1 -0
- package/dist/attest/index.d.ts +2 -0
- package/dist/attest/index.d.ts.map +1 -0
- package/dist/attest/index.js +139 -0
- package/dist/attest/index.js.map +1 -0
- package/dist/attest/sign.d.ts +16 -0
- package/dist/attest/sign.d.ts.map +1 -0
- package/dist/attest/sign.js +75 -0
- package/dist/attest/sign.js.map +1 -0
- package/dist/attest/verify.d.ts +21 -0
- package/dist/attest/verify.d.ts.map +1 -0
- package/dist/attest/verify.js +148 -0
- package/dist/attest/verify.js.map +1 -0
- package/dist/board/board.d.ts +37 -0
- package/dist/board/board.d.ts.map +1 -0
- package/dist/board/board.js +233 -0
- package/dist/board/board.js.map +1 -0
- package/dist/board/board.test.d.ts +2 -0
- package/dist/board/board.test.d.ts.map +1 -0
- package/dist/board/board.test.js +753 -0
- package/dist/board/board.test.js.map +1 -0
- package/dist/board/dormancy.test.d.ts +2 -0
- package/dist/board/dormancy.test.d.ts.map +1 -0
- package/dist/board/dormancy.test.js +79 -0
- package/dist/board/dormancy.test.js.map +1 -0
- package/dist/board/identity.d.ts +5 -0
- package/dist/board/identity.d.ts.map +1 -0
- package/dist/board/identity.js +146 -0
- package/dist/board/identity.js.map +1 -0
- package/dist/board/identity.test.d.ts +2 -0
- package/dist/board/identity.test.d.ts.map +1 -0
- package/dist/board/identity.test.js +291 -0
- package/dist/board/identity.test.js.map +1 -0
- package/dist/board/ledger.d.ts +41 -0
- package/dist/board/ledger.d.ts.map +1 -0
- package/dist/board/ledger.js +197 -0
- package/dist/board/ledger.js.map +1 -0
- package/dist/board/ledger.test.d.ts +2 -0
- package/dist/board/ledger.test.d.ts.map +1 -0
- package/dist/board/ledger.test.js +873 -0
- package/dist/board/ledger.test.js.map +1 -0
- package/dist/board/principals.d.ts +4 -0
- package/dist/board/principals.d.ts.map +1 -0
- package/dist/board/principals.js +37 -0
- package/dist/board/principals.js.map +1 -0
- package/dist/board/principals.test.d.ts +2 -0
- package/dist/board/principals.test.d.ts.map +1 -0
- package/dist/board/principals.test.js +296 -0
- package/dist/board/principals.test.js.map +1 -0
- package/dist/board/reconcile.d.ts +12 -0
- package/dist/board/reconcile.d.ts.map +1 -0
- package/dist/board/reconcile.js +293 -0
- package/dist/board/reconcile.js.map +1 -0
- package/dist/board/reconcile.test.d.ts +2 -0
- package/dist/board/reconcile.test.d.ts.map +1 -0
- package/dist/board/reconcile.test.js +788 -0
- package/dist/board/reconcile.test.js.map +1 -0
- package/dist/board/sources/index.d.ts +24 -0
- package/dist/board/sources/index.d.ts.map +1 -0
- package/dist/board/sources/index.js +64 -0
- package/dist/board/sources/index.js.map +1 -0
- package/dist/board/sources/lint.d.ts +3 -0
- package/dist/board/sources/lint.d.ts.map +1 -0
- package/dist/board/sources/lint.js +218 -0
- package/dist/board/sources/lint.js.map +1 -0
- package/dist/board/sources/lint.test.d.ts +2 -0
- package/dist/board/sources/lint.test.d.ts.map +1 -0
- package/dist/board/sources/lint.test.js +616 -0
- package/dist/board/sources/lint.test.js.map +1 -0
- package/dist/board/sources/staged.d.ts +3 -0
- package/dist/board/sources/staged.d.ts.map +1 -0
- package/dist/board/sources/staged.js +116 -0
- package/dist/board/sources/staged.js.map +1 -0
- package/dist/board/sources/staged.test.d.ts +2 -0
- package/dist/board/sources/staged.test.d.ts.map +1 -0
- package/dist/board/sources/staged.test.js +418 -0
- package/dist/board/sources/staged.test.js.map +1 -0
- package/dist/board/sources/staleness.d.ts +43 -0
- package/dist/board/sources/staleness.d.ts.map +1 -0
- package/dist/board/sources/staleness.js +346 -0
- package/dist/board/sources/staleness.js.map +1 -0
- package/dist/board/sources/staleness.test.d.ts +2 -0
- package/dist/board/sources/staleness.test.d.ts.map +1 -0
- package/dist/board/sources/staleness.test.js +923 -0
- package/dist/board/sources/staleness.test.js.map +1 -0
- package/dist/board/sources/tension.d.ts +3 -0
- package/dist/board/sources/tension.d.ts.map +1 -0
- package/dist/board/sources/tension.js +152 -0
- package/dist/board/sources/tension.js.map +1 -0
- package/dist/board/sources/tension.test.d.ts +2 -0
- package/dist/board/sources/tension.test.d.ts.map +1 -0
- package/dist/board/sources/tension.test.js +440 -0
- package/dist/board/sources/tension.test.js.map +1 -0
- package/dist/board/sources/tier2.d.ts +17 -0
- package/dist/board/sources/tier2.d.ts.map +1 -0
- package/dist/board/sources/tier2.js +233 -0
- package/dist/board/sources/tier2.js.map +1 -0
- package/dist/board/sources/tier2.test.d.ts +2 -0
- package/dist/board/sources/tier2.test.d.ts.map +1 -0
- package/dist/board/sources/tier2.test.js +480 -0
- package/dist/board/sources/tier2.test.js.map +1 -0
- package/dist/board/types.d.ts +161 -0
- package/dist/board/types.d.ts.map +1 -0
- package/dist/board/types.js +37 -0
- package/dist/board/types.js.map +1 -0
- package/dist/canon/index.d.ts +3 -1
- package/dist/canon/index.d.ts.map +1 -1
- package/dist/canon/index.js +35 -8
- package/dist/canon/index.js.map +1 -1
- package/dist/canon/types.d.ts +3 -0
- package/dist/canon/types.d.ts.map +1 -1
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +15 -0
- package/dist/cli.js.map +1 -1
- package/dist/consolidate/birth.d.ts +1 -1
- package/dist/consolidate/birth.d.ts.map +1 -1
- package/dist/consolidate/birth.js +22 -0
- package/dist/consolidate/birth.js.map +1 -1
- package/dist/consolidate/edge-write.d.ts +11 -0
- package/dist/consolidate/edge-write.d.ts.map +1 -1
- package/dist/consolidate/edge-write.js +41 -0
- package/dist/consolidate/edge-write.js.map +1 -1
- package/dist/consolidate/index.js +5 -2
- package/dist/consolidate/index.js.map +1 -1
- package/dist/consolidate/revision.d.ts +4 -2
- package/dist/consolidate/revision.d.ts.map +1 -1
- package/dist/consolidate/revision.js +23 -0
- package/dist/consolidate/revision.js.map +1 -1
- package/dist/curation/edge-staleness.d.ts +4 -2
- package/dist/curation/edge-staleness.d.ts.map +1 -1
- package/dist/curation/edge-staleness.js +36 -3
- package/dist/curation/edge-staleness.js.map +1 -1
- package/dist/curation/edges.d.ts +7 -0
- package/dist/curation/edges.d.ts.map +1 -1
- package/dist/curation/edges.js +13 -7
- package/dist/curation/edges.js.map +1 -1
- package/dist/curation/staged-actions.d.ts +2 -0
- package/dist/curation/staged-actions.d.ts.map +1 -1
- package/dist/curation/staged-actions.js +5 -0
- package/dist/curation/staged-actions.js.map +1 -1
- package/dist/curation/tension-access.d.ts +1 -0
- package/dist/curation/tension-access.d.ts.map +1 -1
- package/dist/curation/tension-access.js +18 -1
- package/dist/curation/tension-access.js.map +1 -1
- package/dist/curation/tension.d.ts +3 -0
- package/dist/curation/tension.d.ts.map +1 -1
- package/dist/curation/tension.js +36 -0
- package/dist/curation/tension.js.map +1 -1
- package/dist/curation/vault-docs.d.ts +1 -0
- package/dist/curation/vault-docs.d.ts.map +1 -1
- package/dist/curation/vault-docs.js +1 -0
- package/dist/curation/vault-docs.js.map +1 -1
- package/dist/distill/adapters/claude-session.d.ts +6 -0
- package/dist/distill/adapters/claude-session.d.ts.map +1 -0
- package/dist/distill/adapters/claude-session.js +71 -0
- package/dist/distill/adapters/claude-session.js.map +1 -0
- package/dist/distill/cli.d.ts.map +1 -1
- package/dist/distill/cli.js +119 -9
- package/dist/distill/cli.js.map +1 -1
- package/dist/distill/cost.d.ts +6 -0
- package/dist/distill/cost.d.ts.map +1 -1
- package/dist/distill/cost.js +2 -3
- package/dist/distill/cost.js.map +1 -1
- package/dist/distill/extract.d.ts +52 -0
- package/dist/distill/extract.d.ts.map +1 -1
- package/dist/distill/extract.js +24 -2
- package/dist/distill/extract.js.map +1 -1
- package/dist/distill/index.d.ts +1 -0
- package/dist/distill/index.d.ts.map +1 -1
- package/dist/distill/index.js +3 -0
- package/dist/distill/index.js.map +1 -1
- package/dist/distill/propose.d.ts +67 -6
- package/dist/distill/propose.d.ts.map +1 -1
- package/dist/distill/propose.js +142 -32
- package/dist/distill/propose.js.map +1 -1
- package/dist/distill/reader-fingerprint.d.ts +69 -0
- package/dist/distill/reader-fingerprint.d.ts.map +1 -0
- package/dist/distill/reader-fingerprint.js +145 -0
- package/dist/distill/reader-fingerprint.js.map +1 -0
- package/dist/distill/receipt-store.d.ts +5 -0
- package/dist/distill/receipt-store.d.ts.map +1 -0
- package/dist/distill/receipt-store.js +24 -0
- package/dist/distill/receipt-store.js.map +1 -0
- package/dist/eval/llm-openrouter.d.ts.map +1 -1
- package/dist/eval/llm-openrouter.js +4 -0
- package/dist/eval/llm-openrouter.js.map +1 -1
- package/dist/eval/llm.d.ts +22 -0
- package/dist/eval/llm.d.ts.map +1 -1
- package/dist/eval/llm.js +94 -24
- package/dist/eval/llm.js.map +1 -1
- package/dist/federation/classification.d.ts.map +1 -1
- package/dist/federation/classification.js +3 -0
- package/dist/federation/classification.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +31 -0
- package/dist/index.js.map +1 -1
- package/dist/search/coverage.d.ts +5 -1
- package/dist/search/coverage.d.ts.map +1 -1
- package/dist/search/coverage.js +47 -15
- package/dist/search/coverage.js.map +1 -1
- package/dist/search/hybrid.d.ts +7 -1
- package/dist/search/hybrid.d.ts.map +1 -1
- package/dist/search/hybrid.js +31 -8
- package/dist/search/hybrid.js.map +1 -1
- package/dist/search/retrieval-metrics.d.ts +5 -0
- package/dist/search/retrieval-metrics.d.ts.map +1 -0
- package/dist/search/retrieval-metrics.js +60 -0
- package/dist/search/retrieval-metrics.js.map +1 -0
- package/dist/search/suppression.d.ts +9 -0
- package/dist/search/suppression.d.ts.map +1 -0
- package/dist/search/suppression.js +107 -0
- package/dist/search/suppression.js.map +1 -0
- package/dist/serve/index.d.ts.map +1 -1
- package/dist/serve/index.js +286 -4
- package/dist/serve/index.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +4 -6
- package/dist/server.js.map +1 -1
- package/dist/storage/index-db.d.ts +1 -0
- package/dist/storage/index-db.d.ts.map +1 -1
- package/dist/storage/index-db.js.map +1 -1
- package/dist/tools/board.d.ts +32 -0
- package/dist/tools/board.d.ts.map +1 -0
- package/dist/tools/board.js +615 -0
- package/dist/tools/board.js.map +1 -0
- package/dist/tools/board.test.d.ts +2 -0
- package/dist/tools/board.test.d.ts.map +1 -0
- package/dist/tools/board.test.js +964 -0
- package/dist/tools/board.test.js.map +1 -0
- package/dist/tools/edge-staleness.d.ts.map +1 -1
- package/dist/tools/edge-staleness.js +18 -4
- package/dist/tools/edge-staleness.js.map +1 -1
- package/dist/tools/positions.d.ts.map +1 -1
- package/dist/tools/positions.js +6 -0
- package/dist/tools/positions.js.map +1 -1
- package/dist/tools/read.d.ts +2 -0
- package/dist/tools/read.d.ts.map +1 -1
- package/dist/tools/read.js +43 -13
- package/dist/tools/read.js.map +1 -1
- package/dist/tools/receipt.d.ts +6 -0
- package/dist/tools/receipt.d.ts.map +1 -1
- package/dist/tools/receipt.js +47 -1
- package/dist/tools/receipt.js.map +1 -1
- package/dist/tools/search.d.ts.map +1 -1
- package/dist/tools/search.js +79 -17
- package/dist/tools/search.js.map +1 -1
- package/dist/tools/staged-actions.d.ts.map +1 -1
- package/dist/tools/staged-actions.js +26 -2
- package/dist/tools/staged-actions.js.map +1 -1
- package/dist/tools/write.d.ts +1 -0
- package/dist/tools/write.d.ts.map +1 -1
- package/dist/tools/write.js +475 -227
- package/dist/tools/write.js.map +1 -1
- package/dist/utils/config.d.ts +21 -0
- package/dist/utils/config.d.ts.map +1 -1
- package/dist/utils/config.js +104 -1
- package/dist/utils/config.js.map +1 -1
- package/dist/utils/git.d.ts +18 -2
- package/dist/utils/git.d.ts.map +1 -1
- package/dist/utils/git.js +116 -13
- package/dist/utils/git.js.map +1 -1
- package/dist/version.d.ts +2 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +8 -0
- package/dist/version.js.map +1 -0
- package/dist/view/board-page.d.ts +4 -0
- package/dist/view/board-page.d.ts.map +1 -0
- package/dist/view/board-page.js +278 -0
- package/dist/view/board-page.js.map +1 -0
- package/dist/view/board-page.test.d.ts +2 -0
- package/dist/view/board-page.test.d.ts.map +1 -0
- package/dist/view/board-page.test.js +548 -0
- package/dist/view/board-page.test.js.map +1 -0
- package/dist/view/pages.d.ts.map +1 -1
- package/dist/view/pages.js +13 -2
- package/dist/view/pages.js.map +1 -1
- package/dist/view/render.d.ts.map +1 -1
- package/dist/view/render.js +2 -1
- package/dist/view/render.js.map +1 -1
- package/package.json +2 -2
package/dist/distill/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export type { DistillConfig } from "../utils/config.js";
|
|
2
2
|
export { ChatTranscriptAdapter } from "./adapters/chat-transcript.js";
|
|
3
|
+
export { ClaudeSessionAdapter } from "./adapters/claude-session.js";
|
|
3
4
|
export type { MessageType, NormalizedMessage, SourceAdapter } from "./adapters/types.js";
|
|
4
5
|
export { CHUNK_WINDOW, type Chunk, chunkMessages } from "./chunk.js";
|
|
5
6
|
export { type ExtractedClaim, type ExtractOpts, type ExtractOutcome, extractClaims, } from "./extract.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distill/index.ts"],"names":[],"mappings":"AAoBA,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distill/index.ts"],"names":[],"mappings":"AAoBA,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,oBAAoB,CAAC;AAGpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,KAAK,EAAiB,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAG1D,CAAC;AAMF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,YAAY,CAAC;CACzB;AAMD,eAAO,MAAM,0BAA0B,QAE0B,CAAC;AAiBlE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAgBhC;AASD,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEtC,0EAA0E;AAE1E,MAAM,WAAW,aAAa;CAAG;AAEjC,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,oCAAoC;IACpC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,aAAa,CAe1E"}
|
package/dist/distill/index.js
CHANGED
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
// ./cli.ts (split out in U9); this module owns the pipeline stub plus the
|
|
19
19
|
// config/client resolver it shares with the CLI.
|
|
20
20
|
export { ChatTranscriptAdapter } from "./adapters/chat-transcript.js";
|
|
21
|
+
export { ClaudeSessionAdapter } from "./adapters/claude-session.js";
|
|
21
22
|
export { CHUNK_WINDOW, chunkMessages } from "./chunk.js";
|
|
22
23
|
export { extractClaims, } from "./extract.js";
|
|
23
24
|
// ---------------------------------------------------------------------------
|
|
@@ -28,6 +29,7 @@ import { createOpenRouterClient, resolveTransport, } from "../eval/llm-openroute
|
|
|
28
29
|
import { err, ok } from "../frontmatter/types.js";
|
|
29
30
|
import { loadConfig } from "../utils/config.js";
|
|
30
31
|
import { ChatTranscriptAdapter } from "./adapters/chat-transcript.js";
|
|
32
|
+
import { ClaudeSessionAdapter } from "./adapters/claude-session.js";
|
|
31
33
|
import { chunkMessages } from "./chunk.js";
|
|
32
34
|
// ---------------------------------------------------------------------------
|
|
33
35
|
// Adapter registry
|
|
@@ -35,6 +37,7 @@ import { chunkMessages } from "./chunk.js";
|
|
|
35
37
|
/** Built-in adapter registry, keyed by sourceId(). */
|
|
36
38
|
export const ADAPTER_REGISTRY = {
|
|
37
39
|
"chat-transcript": new ChatTranscriptAdapter(),
|
|
40
|
+
"claude-session": new ClaudeSessionAdapter(),
|
|
38
41
|
};
|
|
39
42
|
// ---------------------------------------------------------------------------
|
|
40
43
|
// Shared error messages (m1 — deduplicate refuse string)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distill/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,8DAA8D;AAC9D,EAAE;AACF,kBAAkB;AAClB,EAAE;AACF,0BAA0B;AAC1B,gFAAgF;AAChF,iFAAiF;AACjF,kHAAkH;AAClH,iFAAiF;AACjF,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,iDAAiD;AAGjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distill/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,8DAA8D;AAC9D,EAAE;AACF,kBAAkB;AAClB,EAAE;AACF,0BAA0B;AAC1B,gFAAgF;AAChF,iFAAiF;AACjF,kHAAkH;AAClH,iFAAiF;AACjF,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,iDAAiD;AAGjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAIL,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,OAAO,EAAE,qBAAqB,EAAkB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,sBAAsB,EAEtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAsB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,iBAAiB,EAAE,IAAI,qBAAqB,EAAE;IAC9C,gBAAgB,EAAE,IAAI,oBAAoB,EAAE;CAC7C,CAAC;AAkBF,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GACrC,yEAAyE;IACzE,+DAA+D,CAAC;AAElE,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,SAAS,YAAY,CAAC,SAAqC;IACzD,MAAM,MAAM,GAAG,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACvF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,MAAM,oCAAoC,SAAS,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,SAAkB;IAElB,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAErC,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,YAAY,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AA+BD;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,OAAsB;IACzD,YAAY;IACZ,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpC,uCAAuC;IACvC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEvC,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,mDAAmD;IACnD,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { AccessContext } from "../access/rbac.js";
|
|
2
2
|
import { type StageOutcome } from "../curation/staged-actions.js";
|
|
3
|
-
import type { ExtractedClaim } from "./extract.js";
|
|
3
|
+
import type { ClaimRunMeta, ExtractedClaim } from "./extract.js";
|
|
4
|
+
import { type LineageOp } from "./reader-fingerprint.js";
|
|
4
5
|
/** Target collection for all distill proposals. */
|
|
5
6
|
export declare const DISTILL_COLLECTION = "distill";
|
|
6
7
|
/** The proposing agent identity, recorded on every proposal. */
|
|
@@ -12,14 +13,28 @@ export declare const DISTILL_AGENT = "agent:distill";
|
|
|
12
13
|
*/
|
|
13
14
|
export declare const OVERLAP_HINT_TOP_K = 3;
|
|
14
15
|
/**
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
16
|
+
* The result of an overlap search (U8 + R7): the vault-relative paths of the
|
|
17
|
+
* top-K likely-overlapping documents AND the fused search score of the single
|
|
18
|
+
* top neighbor. The paths feed the proposal's rationale (advisory context for
|
|
19
|
+
* the ratifier); the top score is the corroboration signal stamped onto the
|
|
20
|
+
* staged proposal (R7) that the confidence gate reads later.
|
|
21
|
+
*/
|
|
22
|
+
export interface OverlapHint {
|
|
23
|
+
/** Vault-relative paths of the top-K likely-overlapping documents. */
|
|
24
|
+
paths: string[];
|
|
25
|
+
/** Fused search score of the top neighbor, min-normalized to [0,1]; 0 if none. */
|
|
26
|
+
topScore: number;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* A function that, given a claim statement, returns an OverlapHint: the
|
|
30
|
+
* vault-relative paths of documents likely to overlap with the claim, plus the
|
|
31
|
+
* top neighbor's fused search score (no LLM, no tension scan — pure local index
|
|
32
|
+
* query). An empty `paths` array with `topScore: 0` means no overlaps found.
|
|
18
33
|
*
|
|
19
34
|
* Errors thrown by this function are caught by proposeAllClaims and cause a
|
|
20
|
-
* graceful no-hint degradation (the claim still stages).
|
|
35
|
+
* graceful no-hint degradation (the claim still stages, corroboration 0).
|
|
21
36
|
*/
|
|
22
|
-
export type OverlapSearchFn = (statement: string) => Promise<
|
|
37
|
+
export type OverlapSearchFn = (statement: string) => Promise<OverlapHint>;
|
|
23
38
|
/**
|
|
24
39
|
* Build an overlap-search function backed by the vault's hybrid search index.
|
|
25
40
|
* The CLI wires this into proposeAllClaims; tests inject stubs instead.
|
|
@@ -30,6 +45,10 @@ export type OverlapSearchFn = (statement: string) => Promise<string[]>;
|
|
|
30
45
|
* correct primitive — confirmed deviation from the plan's `vault_search_related`
|
|
31
46
|
* wording.
|
|
32
47
|
*
|
|
48
|
+
* The returned top score is `hits[0].score` — the fused BM25/vector score,
|
|
49
|
+
* already min-normalized to [0,1] by the hybrid ranker. It becomes the
|
|
50
|
+
* proposal's corroboration signal (R7).
|
|
51
|
+
*
|
|
33
52
|
* @param vaultRoot Absolute path to the vault root.
|
|
34
53
|
* @param access Optional RBAC context forwarded to vaultSearch.
|
|
35
54
|
*/
|
|
@@ -70,6 +89,48 @@ export interface ProposeOutcome {
|
|
|
70
89
|
error: string;
|
|
71
90
|
}>;
|
|
72
91
|
}
|
|
92
|
+
/**
|
|
93
|
+
* The reader_* frontmatter fields stamped from a claim's run_meta. Every field
|
|
94
|
+
* is a DECLARED-OPTIONAL schema extension (see docs/schema-extensions.md); the
|
|
95
|
+
* fields land typed in a vault whose config declares them, untyped-but-preserved
|
|
96
|
+
* otherwise, and never block a write (optional, advisory).
|
|
97
|
+
*
|
|
98
|
+
* null is never written for any field — a null on a declared extension DELETES
|
|
99
|
+
* it (serializeDocument treats null as absent). So a value that would be null is
|
|
100
|
+
* either given a sentinel (served_model → "unreported") or the field is OMITTED
|
|
101
|
+
* (temperature, which is a number and cannot carry a sentinel).
|
|
102
|
+
*/
|
|
103
|
+
export interface ReaderFrontmatter {
|
|
104
|
+
reader_model: string;
|
|
105
|
+
reader_served_model: string;
|
|
106
|
+
reader_temperature?: number;
|
|
107
|
+
reader_via_retry: boolean;
|
|
108
|
+
reader_prompt_version: string;
|
|
109
|
+
reader_chunk_window: number;
|
|
110
|
+
reader_input_cap: number;
|
|
111
|
+
readers: string[];
|
|
112
|
+
/** Append-only lineage (6mf.4 R1). Raw-only; never enters typed Frontmatter. */
|
|
113
|
+
reader_lineage: string[];
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Build the reader_* frontmatter fields from a claim's run_meta. The prompt
|
|
117
|
+
* version is READER_PROMPT_VERSION (the hash of the effective extraction prompt
|
|
118
|
+
* contract at this build). `readers` carries exactly ONE entry at ingest — the
|
|
119
|
+
* parentage SET a later merge bead unions. `reader_lineage` carries the first
|
|
120
|
+
* append-only provenance entry for this belief (6mf.4 R1).
|
|
121
|
+
*
|
|
122
|
+
* Locked field rules (see the bead spec):
|
|
123
|
+
* - reader_served_model uses the "unreported" sentinel when servedModel is
|
|
124
|
+
* undefined — NEVER null (null deletes the field).
|
|
125
|
+
* - reader_temperature is OMITTED when effectiveTemperature is undefined — a
|
|
126
|
+
* number field cannot hold a sentinel.
|
|
127
|
+
* - reader_via_retry defaults to false when viaRetry is undefined.
|
|
128
|
+
*
|
|
129
|
+
* @param runMeta The extraction run metadata.
|
|
130
|
+
* @param op The lineage op for this write. Defaults to `"ingest"` (new
|
|
131
|
+
* belief). Pass `"update"` for update-in-place re-distillations.
|
|
132
|
+
*/
|
|
133
|
+
export declare function buildReaderFrontmatter(runMeta: ClaimRunMeta, op?: LineageOp): ReaderFrontmatter;
|
|
73
134
|
/**
|
|
74
135
|
* Emit each claim as a `write` staged-action proposal at draft/low/synthesized.
|
|
75
136
|
* Routes through `stageActionWithConflictCheck` so inter-proposal conflicts
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,+BAA+B,CAAC;AAGhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,+BAA+B,CAAC;AAGhG,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,yBAAyB,CAAC;AAMjC,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAMpC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,CAc5F;AAMD,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oFAAoF;IACpF,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AA+CD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,EAAE,GAAE,SAAoB,GACvB,iBAAiB,CAmBnB;AA6GD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,aAAa,CAAC,EAAE,eAAe,GAC9B,OAAO,CAAC,cAAc,CAAC,CA8FzB"}
|
package/dist/distill/propose.js
CHANGED
|
@@ -22,6 +22,7 @@ import { stageActionWithConflictCheck } from "../curation/staged-actions.js";
|
|
|
22
22
|
import { slugifyKey } from "../import/langgraph-store.js";
|
|
23
23
|
import { vaultSearch } from "../tools/search.js";
|
|
24
24
|
import { refuseRawDistillOutput } from "./output-fence.js";
|
|
25
|
+
import { encodeLineageEntry, encodeReader, READER_PROMPT_VERSION, } from "./reader-fingerprint.js";
|
|
25
26
|
// ---------------------------------------------------------------------------
|
|
26
27
|
// Public constants
|
|
27
28
|
// ---------------------------------------------------------------------------
|
|
@@ -45,6 +46,10 @@ export const OVERLAP_HINT_TOP_K = 3;
|
|
|
45
46
|
* correct primitive — confirmed deviation from the plan's `vault_search_related`
|
|
46
47
|
* wording.
|
|
47
48
|
*
|
|
49
|
+
* The returned top score is `hits[0].score` — the fused BM25/vector score,
|
|
50
|
+
* already min-normalized to [0,1] by the hybrid ranker. It becomes the
|
|
51
|
+
* proposal's corroboration signal (R7).
|
|
52
|
+
*
|
|
48
53
|
* @param vaultRoot Absolute path to the vault root.
|
|
49
54
|
* @param access Optional RBAC context forwarded to vaultSearch.
|
|
50
55
|
*/
|
|
@@ -52,8 +57,12 @@ export function makeOverlapHinter(vaultRoot, access) {
|
|
|
52
57
|
return async (statement) => {
|
|
53
58
|
const result = await vaultSearch(vaultRoot, { query: statement, limit: OVERLAP_HINT_TOP_K }, access);
|
|
54
59
|
if (!result.ok)
|
|
55
|
-
return [];
|
|
56
|
-
|
|
60
|
+
return { paths: [], topScore: 0 };
|
|
61
|
+
const hits = result.value.hits.slice(0, OVERLAP_HINT_TOP_K);
|
|
62
|
+
return {
|
|
63
|
+
paths: hits.map((h) => h.path),
|
|
64
|
+
topScore: hits.length > 0 ? hits[0].score : 0,
|
|
65
|
+
};
|
|
57
66
|
};
|
|
58
67
|
}
|
|
59
68
|
// ---------------------------------------------------------------------------
|
|
@@ -94,10 +103,74 @@ function derivePath(claim, sourceId) {
|
|
|
94
103
|
const titleSlug = title.trim() ? slugifyKey(title) : slugifyKey(claim.claim_key);
|
|
95
104
|
return join(DISTILL_COLLECTION, sourceGroup, `${titleSlug}--${hash8}.md`);
|
|
96
105
|
}
|
|
106
|
+
/**
|
|
107
|
+
* Build the reader_* frontmatter fields from a claim's run_meta. The prompt
|
|
108
|
+
* version is READER_PROMPT_VERSION (the hash of the effective extraction prompt
|
|
109
|
+
* contract at this build). `readers` carries exactly ONE entry at ingest — the
|
|
110
|
+
* parentage SET a later merge bead unions. `reader_lineage` carries the first
|
|
111
|
+
* append-only provenance entry for this belief (6mf.4 R1).
|
|
112
|
+
*
|
|
113
|
+
* Locked field rules (see the bead spec):
|
|
114
|
+
* - reader_served_model uses the "unreported" sentinel when servedModel is
|
|
115
|
+
* undefined — NEVER null (null deletes the field).
|
|
116
|
+
* - reader_temperature is OMITTED when effectiveTemperature is undefined — a
|
|
117
|
+
* number field cannot hold a sentinel.
|
|
118
|
+
* - reader_via_retry defaults to false when viaRetry is undefined.
|
|
119
|
+
*
|
|
120
|
+
* @param runMeta The extraction run metadata.
|
|
121
|
+
* @param op The lineage op for this write. Defaults to `"ingest"` (new
|
|
122
|
+
* belief). Pass `"update"` for update-in-place re-distillations.
|
|
123
|
+
*/
|
|
124
|
+
export function buildReaderFrontmatter(runMeta, op = "ingest") {
|
|
125
|
+
const readerStr = encodeReader(runMeta, READER_PROMPT_VERSION);
|
|
126
|
+
const ts = new Date().toISOString();
|
|
127
|
+
const fm = {
|
|
128
|
+
reader_model: runMeta.requestedModel,
|
|
129
|
+
reader_served_model: runMeta.servedModel ?? "unreported",
|
|
130
|
+
reader_via_retry: runMeta.viaRetry ?? false,
|
|
131
|
+
reader_prompt_version: READER_PROMPT_VERSION,
|
|
132
|
+
reader_chunk_window: runMeta.chunkWindow,
|
|
133
|
+
reader_input_cap: runMeta.inputCap,
|
|
134
|
+
readers: [readerStr],
|
|
135
|
+
reader_lineage: [encodeLineageEntry(ts, op, readerStr)],
|
|
136
|
+
};
|
|
137
|
+
// Omit reader_temperature entirely when unknown: a number can't hold a
|
|
138
|
+
// sentinel and null would delete a declared extension.
|
|
139
|
+
if (runMeta.effectiveTemperature !== undefined) {
|
|
140
|
+
fm.reader_temperature = runMeta.effectiveTemperature;
|
|
141
|
+
}
|
|
142
|
+
return fm;
|
|
143
|
+
}
|
|
97
144
|
// ---------------------------------------------------------------------------
|
|
98
145
|
// Note assembly (mirrors langgraph-store.ts deriveNotes)
|
|
99
146
|
// ---------------------------------------------------------------------------
|
|
100
|
-
|
|
147
|
+
// Human-readable "Reader" subsection of the Provenance body, mirroring the
|
|
148
|
+
// reader_* frontmatter. Returns [] (no subsection) when the claim carries no
|
|
149
|
+
// run_meta, so a claim without reader provenance produces the original body.
|
|
150
|
+
function readerProvenanceLines(reader) {
|
|
151
|
+
if (reader === null)
|
|
152
|
+
return [];
|
|
153
|
+
return [
|
|
154
|
+
"",
|
|
155
|
+
"### Reader",
|
|
156
|
+
"",
|
|
157
|
+
`- **Model (requested):** \`${reader.reader_model}\``,
|
|
158
|
+
`- **Model (served):** \`${reader.reader_served_model}\``,
|
|
159
|
+
...(reader.reader_temperature !== undefined
|
|
160
|
+
? [`- **Effective temperature:** \`${reader.reader_temperature}\``]
|
|
161
|
+
: []),
|
|
162
|
+
`- **Via retry:** \`${reader.reader_via_retry}\``,
|
|
163
|
+
`- **Prompt version:** \`${reader.reader_prompt_version}\``,
|
|
164
|
+
`- **Chunk window:** \`${reader.reader_chunk_window}\``,
|
|
165
|
+
`- **Input cap:** \`${reader.reader_input_cap}\``,
|
|
166
|
+
`- **Readers:** \`${reader.readers.join(", ")}\``,
|
|
167
|
+
"",
|
|
168
|
+
"_This fingerprint identifies the run configuration; it does not guarantee " +
|
|
169
|
+
"bit-identical re-extraction (temperature 0 is not seeded; provider/quantization " +
|
|
170
|
+
"variance)._",
|
|
171
|
+
];
|
|
172
|
+
}
|
|
173
|
+
function assembleBody(claim, frontmatter, ids, reader) {
|
|
101
174
|
return [
|
|
102
175
|
"---",
|
|
103
176
|
dump(frontmatter).trimEnd(),
|
|
@@ -111,38 +184,55 @@ function assembleBody(claim, frontmatter, ids) {
|
|
|
111
184
|
`- **Claim key:** \`${claim.claim_key}\``,
|
|
112
185
|
`- **Run id:** \`${ids.runId}\``,
|
|
113
186
|
`- **Source ref:** \`distill:${ids.sourceId}#${claim.claim_key}\``,
|
|
187
|
+
...readerProvenanceLines(reader),
|
|
114
188
|
"",
|
|
115
189
|
].join("\n");
|
|
116
190
|
}
|
|
117
191
|
// ---------------------------------------------------------------------------
|
|
118
|
-
//
|
|
192
|
+
// Proposal metadata builder (U8 rationale + R7 corroboration)
|
|
119
193
|
// ---------------------------------------------------------------------------
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
194
|
+
/**
|
|
195
|
+
* Build the proposal's rationale AND corroboration score in one pass over the
|
|
196
|
+
* overlap search.
|
|
197
|
+
*
|
|
198
|
+
* Rationale (U8, unchanged behavior): the statement is always the lead so
|
|
199
|
+
* stageActionWithConflictCheck's firstSentence() extraction and the ratifier's
|
|
200
|
+
* first read both land on the claim itself. A non-empty overlap `paths` list
|
|
201
|
+
* appends a "Possible overlaps: ..." line separated by a blank line. An empty
|
|
202
|
+
* list, a missing hinter, or a throwing overlapSearch produces the statement
|
|
203
|
+
* alone — no "Possible overlaps:" line at all.
|
|
204
|
+
*
|
|
205
|
+
* Corroboration (R7): the top neighbor's fused search score, min-normalized to
|
|
206
|
+
* [0,1]. Defaults to 0 when there is no hinter, no neighbor, a search error, or
|
|
207
|
+
* a non-finite score. This is the confidence-gate signal a later review pass
|
|
208
|
+
* reads off `proposedDiff.corroboration` — never computed or thresholded here.
|
|
209
|
+
*/
|
|
210
|
+
async function buildProposalMeta(statement, overlapSearch) {
|
|
127
211
|
if (!overlapSearch)
|
|
128
|
-
return statement;
|
|
129
|
-
let
|
|
212
|
+
return { rationale: statement, corroboration: 0 };
|
|
213
|
+
let hint;
|
|
130
214
|
try {
|
|
131
|
-
|
|
215
|
+
hint = await overlapSearch(statement);
|
|
132
216
|
}
|
|
133
217
|
catch {
|
|
134
218
|
// Degrade to no-hint: a search failure must never block staging.
|
|
135
|
-
return statement;
|
|
219
|
+
return { rationale: statement, corroboration: 0 };
|
|
136
220
|
}
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
221
|
+
const corroboration = Number.isFinite(hint.topScore) ? hint.topScore : 0;
|
|
222
|
+
// No neighbors ⇒ statement-only rationale, but keep the (well-defined) score.
|
|
223
|
+
if (!hint.paths || hint.paths.length === 0) {
|
|
224
|
+
return { rationale: statement, corroboration };
|
|
225
|
+
}
|
|
226
|
+
const safePaths = hint.paths
|
|
227
|
+
.slice(0, OVERLAP_HINT_TOP_K)
|
|
228
|
+
// Sanitize newlines in paths — a path containing \r or \n would break the
|
|
229
|
+
// "statement is the lead" invariant that stageActionWithConflictCheck's
|
|
230
|
+
// firstSentence() relies on.
|
|
231
|
+
.map((p) => p.replace(/[\r\n]+/g, " "));
|
|
232
|
+
return {
|
|
233
|
+
rationale: `${statement}\n\nPossible overlaps: ${safePaths.join(", ")}`,
|
|
234
|
+
corroboration,
|
|
235
|
+
};
|
|
146
236
|
}
|
|
147
237
|
// ---------------------------------------------------------------------------
|
|
148
238
|
// Core emitter
|
|
@@ -207,19 +297,39 @@ export async function proposeAllClaims(vaultRoot, claims, ids, pathOverrides, ov
|
|
|
207
297
|
errors.push({ claim_key: claim.claim_key, error: fence.error.message });
|
|
208
298
|
continue;
|
|
209
299
|
}
|
|
210
|
-
|
|
211
|
-
//
|
|
212
|
-
//
|
|
213
|
-
//
|
|
214
|
-
//
|
|
215
|
-
//
|
|
216
|
-
|
|
300
|
+
// f3h: the producing extraction call's run metadata reaches this point as
|
|
301
|
+
// `claim.run_meta` (ClaimRunMeta | undefined) — servedModel,
|
|
302
|
+
// effectiveTemperature, viaRetry, requestedModel, chunkWindow, inputCap. When
|
|
303
|
+
// present, stamp the reader fingerprint onto the belief's frontmatter as
|
|
304
|
+
// declared-optional schema_extensions (reader_*/readers/reader_lineage). When
|
|
305
|
+
// ABSENT (older paths, mocks that omit it), skip every reader field entirely —
|
|
306
|
+
// they are optional and must not crash or write empty/null placeholders.
|
|
307
|
+
//
|
|
308
|
+
// 6mf.4: the op is "update" iff this claim has a path override (meaning it is
|
|
309
|
+
// an update-in-place re-distillation of an existing landed belief), else "ingest".
|
|
310
|
+
// The land-time union (Task 2) merges the incoming lineage with the existing one.
|
|
311
|
+
const isUpdate = pathOverrides?.[claim.claim_key] !== undefined;
|
|
312
|
+
const lineageOp = isUpdate ? "update" : "ingest";
|
|
313
|
+
const reader = claim.run_meta ? buildReaderFrontmatter(claim.run_meta, lineageOp) : null;
|
|
314
|
+
if (reader)
|
|
315
|
+
Object.assign(frontmatter, reader);
|
|
316
|
+
const body = assembleBody(claim, frontmatter, ids, reader);
|
|
317
|
+
// U8/R5 + R7: overlap-hint. Attach top-K likely-collision neighbor paths to
|
|
318
|
+
// the rationale so the ratifier can see possible overlaps at a glance, and
|
|
319
|
+
// stamp the top neighbor's fused search score as `corroboration`. No LLM or
|
|
320
|
+
// tension-scan runs here — overlapSearch is a pure local index query
|
|
321
|
+
// injected by the caller. A missing or throwing overlapSearch degrades to
|
|
322
|
+
// no-hint (claim still stages, original rationale preserved, corroboration 0).
|
|
323
|
+
const { rationale, corroboration } = await buildProposalMeta(claim.statement, overlapSearch);
|
|
217
324
|
const staged = await stageActionWithConflictCheck(vaultRoot, {
|
|
218
325
|
actionType: "write",
|
|
219
326
|
targetPath,
|
|
220
327
|
proposedBy: DISTILL_AGENT,
|
|
221
328
|
rationale,
|
|
222
|
-
|
|
329
|
+
// R7 carrier key: corroboration ∈ [0,1]. `proposedDiff` is `unknown` at
|
|
330
|
+
// the staged-action type level, so this extra key is non-breaking; the
|
|
331
|
+
// review-side reader parses it defensively.
|
|
332
|
+
proposedDiff: { frontmatter, body, corroboration },
|
|
223
333
|
runId: ids.runId,
|
|
224
334
|
});
|
|
225
335
|
if (!staged.ok) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,4CAA4C;AAC5C,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,cAAc;AACd,2EAA2E;AAC3E,yEAAyE;AAEzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAqB,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import type { ClaimRunMeta } from "./extract.js";
|
|
2
|
+
/** First 8 hex chars of sha256(text). The short, stable version token form. */
|
|
3
|
+
export declare function hash8(text: string): string;
|
|
4
|
+
/**
|
|
5
|
+
* The 8-hex-char version token of the effective extraction prompt contract.
|
|
6
|
+
* Computed once at module load — it is a pure function of two module constants,
|
|
7
|
+
* so it is a stable constant for a given build. Changing EXTRACT_SYSTEM or
|
|
8
|
+
* EXTRACT_SCHEMA changes this value.
|
|
9
|
+
*/
|
|
10
|
+
export declare const READER_PROMPT_VERSION: string;
|
|
11
|
+
/**
|
|
12
|
+
* Encode one reader as a compact, stable, single-line string suitable as an
|
|
13
|
+
* element of the `readers` parentage SET. Shape:
|
|
14
|
+
*
|
|
15
|
+
* `${requestedModel}@${effTempOrNA}|prompt=${promptVersion}|retry=${viaRetry}`
|
|
16
|
+
*
|
|
17
|
+
* - requestedModel is always present on ClaimRunMeta.
|
|
18
|
+
* - effTempOrNA is the effective temperature, or "na" when undefined.
|
|
19
|
+
* - promptVersion is the caller-supplied version token (READER_PROMPT_VERSION at
|
|
20
|
+
* ingest) — passed in rather than read from the module constant so a future
|
|
21
|
+
* caller stamping historical content can encode against the version that
|
|
22
|
+
* actually produced it.
|
|
23
|
+
* - viaRetry defaults to false when undefined (mirrors reader_via_retry).
|
|
24
|
+
*
|
|
25
|
+
* One belief carries exactly ONE reader at ingest; the SET grows only when a
|
|
26
|
+
* merge unions parents. The encoding is intentionally free of characters that a
|
|
27
|
+
* later parser would need to escape (no commas, no newlines).
|
|
28
|
+
*/
|
|
29
|
+
export declare function encodeReader(runMeta: ClaimRunMeta, promptVersion: string): string;
|
|
30
|
+
/** Discriminant for the operation that produced a lineage entry. */
|
|
31
|
+
export type LineageOp = "ingest" | "update" | "revision";
|
|
32
|
+
/** A parsed lineage entry. `reader` is the full `encodeReader` string (may contain pipes). */
|
|
33
|
+
export interface ParsedLineageEntry {
|
|
34
|
+
ts: string;
|
|
35
|
+
op: string;
|
|
36
|
+
reader: string;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Encode one lineage entry as `<ts>|<op>|<reader>`.
|
|
40
|
+
* `reader` is an already-encoded reader string (may itself contain pipes);
|
|
41
|
+
* the first two pipes are the field delimiters — all further pipes belong to reader.
|
|
42
|
+
*/
|
|
43
|
+
export declare function encodeLineageEntry(ts: string, op: LineageOp, reader: string): string;
|
|
44
|
+
/**
|
|
45
|
+
* Parse a lineage entry produced by `encodeLineageEntry`.
|
|
46
|
+
* Splits on the FIRST two `|` only so the reader (which may contain pipes) is preserved.
|
|
47
|
+
* Returns null for malformed input (fewer than 2 separators or empty string).
|
|
48
|
+
*/
|
|
49
|
+
export declare function parseLineageEntry(entry: string): ParsedLineageEntry | null;
|
|
50
|
+
/**
|
|
51
|
+
* Materialise the SET-projection of a lineage: the deduplicated list of reader
|
|
52
|
+
* strings, in first-seen order. Malformed entries are silently skipped.
|
|
53
|
+
*/
|
|
54
|
+
export declare function readersFromLineage(lineage: string[]): string[];
|
|
55
|
+
/**
|
|
56
|
+
* Append-only union of two lineages.
|
|
57
|
+
* Starts from `existing` (order preserved, never re-sorted).
|
|
58
|
+
* For each entry in `incoming`, appends iff no existing entry shares the same `(op, reader)` pair
|
|
59
|
+
* (timestamp is ignored for dedup — a duplicate re-append is declined).
|
|
60
|
+
*/
|
|
61
|
+
export declare function unionLineage(existing: string[], incoming: string[]): string[];
|
|
62
|
+
/**
|
|
63
|
+
* Encode a revision-panel reader fingerprint.
|
|
64
|
+
* Shape: `<model>@na|prompt=<hash8(SYSTEM_BASE+templates)>|retry=false`
|
|
65
|
+
* The prompt hash here is the READER_PROMPT_VERSION (extraction contract),
|
|
66
|
+
* re-used as the closest stable contract identifier for the revision panel.
|
|
67
|
+
*/
|
|
68
|
+
export declare function encodeRevisionReader(model: string): string;
|
|
69
|
+
//# sourceMappingURL=reader-fingerprint.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reader-fingerprint.d.ts","sourceRoot":"","sources":["../../src/distill/reader-fingerprint.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAoD,CAAC;AAQzF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKjF;AAMD,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAW1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAkB7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D"}
|