open-multi-agent-kit 0.90.0 → 0.90.4

package/dist/core/pi-package-intake-candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"pi-package-intake-candidates.js","sourceRoot":"","sources":["../../src/core/pi-package-intake-candidates.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CandidatePackageInput, SourceText } from \"./package-procurement.ts\";\n\nexport type PiPackageLane = \"mcp\" | \"lens\" | \"browser\" | \"subagent\" | \"footer\" | \"todo\";\n\nexport type PiPackagePortMode = \"omk-native\" | \"reference\" | \"measurement-gated\";\n\nexport interface PiPackagePortCandidate {\n\treadonly id: string;\n\treadonly lane: PiPackageLane;\n\treadonly laneLabel: string;\n\treadonly portMode: PiPackagePortMode;\n\treadonly piOrigins: readonly string[];\n\treadonly candidate: CandidatePackageInput;\n}\n\nexport interface PiPackageCandidateReviewInput {\n\treadonly candidateId: string;\n\treadonly declaredLicense?: string;\n\treadonly packageJsonScripts?: Record<string, string>;\n\treadonly reviewedScriptAllowlist?: string[];\n\treadonly sources?: SourceText[];\n\treadonly transitiveLicenses?: string[];\n}\n\nconst P0_SYNTHETIC_PIN = \"0.0.0-p0.0\";\n\nexport const P0_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[] = [\n\t{\n\t\tid: \"pi-mcp-adapter\",\n\t\tlane: \"mcp\",\n\t\tlaneLabel: \"MCP\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-mcp-adapter\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-mcp-adapter\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"loadout\",\n\t\t\texpectedResources: [\"extension\", \"tool\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"mcp-adapter\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/mcp-presets.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"mcp-server-discovery\", \"tool-registration-parity\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-lens\",\n\t\tlane: \"lens\",\n\t\tlaneLabel: \"lens\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-lens\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-lens\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"observability\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tmetrics: [\"lens-render-latency\", \"context-signal-coverage\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-agent-browser-native\",\n\t\tlane: \"browser\",\n\t\tlaneLabel: \"browser\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-agent-browser-native\", \"pi-browse\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-agent-browser-native\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"loadout\",\n\t\t\texpectedResources: [\"tool\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"agent-browser-native\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/browser-use.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"browser-action-success-rate\", \"browser-session-isolation\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-subagents\",\n\t\tlane: \"subagent\",\n\t\tlaneLabel: \"subagent\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"pi-subagents\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-subagents\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"workflow-reference\",\n\t\t\texpectedResources: [\"extension\", \"skill\"],\n\t\t\tpolicyOverlay: { declaredUse: \"workflow-reference\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-powerline-footer\",\n\t\tlane: \"footer\",\n\t\tlaneLabel: \"footer\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-footer\", \"pi-powerline-footer\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-powerline-footer\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"observability\",\n\t\t\texpectedResources: [\"theme\", \"extension\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"powerline-footer\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/footer-data-provider.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"footer-width-stability\", \"footer-render-latency\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-long-task\",\n\t\tlane: \"todo\",\n\t\tlaneLabel: \"todo\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-long-task\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-long-task\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"checkpoint\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tmetrics: [\"long-task-resume-rate\", \"todo-state-parity\"],\n\t\t},\n\t},\n];\n"]}
+{"version":3,"file":"pi-package-intake-candidates.js","sourceRoot":"","sources":["../../src/core/pi-package-intake-candidates.ts"],"names":[],"mappings":"AAwCA,MAAM,gBAAgB,GAAG,YAAY,CAAC;AACtC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAsC;IAC/E;QACC,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,kBAAkB,CAAC;QAC/B,SAAS,EAAE;YACV,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,QAAQ;YACrB,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;YACzC,aAAa,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,0BAA0B,EAAE,KAAK,EAAE;SAC3E;KACD;IACD;QACC,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,eAAe,CAAC;QAC5B,SAAS,EAAE;YACV,IAAI,EAAE,eAAe;YACrB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,oBAAoB;YACjC,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,aAAa,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,KAAK,EAAE;SACvF;KACD;IACD;QACC,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE;YACV,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,YAAY;YACzB,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YACxC,+EAA+E;YAC/E,+EAA+E;YAC/E,2EAA2E;YAC3E,mEAAmE;YACnE,OAAO,EAAE,CAAC,wBAAwB,EAAE,4BAA4B,EAAE,uBAAuB,CAAC;SAC1F;KACD;IACD;QACC,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,eAAe,CAAC;QAC5B,SAAS,EAAE;YACV,IAAI,EAAE,eAAe;YACrB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,oBAAoB;YACjC,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,2EAA2E;YAC3E,+DAA+D;YAC/D,aAAa,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,KAAK,EAAE;SACvF;KACD;IACD;QACC,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE;YACV,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,SAAS;YACtB,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YACxC,OAAO,EAAE,CAAC,+BAA+B,EAAE,2BAA2B,CAAC;SACvE;KACD;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,0BAA0B,CAAC;QACvC,SAAS,EAAE;YACV,IAAI,EAAE,0BAA0B;YAChC,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,eAAe;YAC5B,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,iFAAiF;YACjF,8EAA8E;YAC9E,kFAAkF;YAClF,aAAa,EAAE;gBACd,WAAW,EAAE,eAAe;gBAC5B,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;aACvG;SACD;KACD;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,mBAAmB,CAAC;QAChC,SAAS,EAAE;YACV,IAAI,EAAE,mBAAmB;YACzB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,oBAAoB;YACjC,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,uEAAuE;YACvE,oEAAoE;YACpE,aAAa,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,KAAK,EAAE;SACvF;KACD;IACD;QACC,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,gBAAgB;QAC3B,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE;YACV,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,SAAS;YACtB,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YACxC,OAAO,EAAE,CAAC,gCAAgC,EAAE,6BAA6B,CAAC;SAC1E;KACD;IACD;QACC,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,sBAAsB,CAAC;QACnC,SAAS,EAAE;YACV,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,oBAA6B;YAC1C,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,OAAO,EAAE,CAAC,iCAAiC,EAAE,uBAAuB,CAAC;SACrE;KACD;IACD;QACC,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE;YACV,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,SAAS;YACtB,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,yEAAyE;YACzE,6EAA6E;YAC7E,qEAAqE;YACrE,yBAAyB;SACzB;KACD;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAsC;IAC/E;QACC,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,CAAC,gBAAgB,CAAC;QAC7B,SAAS,EAAE;YACV,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,SAAS;YACtB,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YACxC,UAAU,EAAE;gBACX,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,aAAa;gBACtB,QAAQ,EAAE,+CAA+C;aACzD;YACD,OAAO,EAAE,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;SAC7D;KACD;IACD;QACC,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,SAAS,CAAC;QACtB,SAAS,EAAE;YACV,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,eAAe;YAC5B,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,OAAO,EAAE,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;SAC3D;KACD;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,CAAC,yBAAyB,EAAE,WAAW,CAAC;QACnD,SAAS,EAAE;YACV,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,SAAS;YACtB,iBAAiB,EAAE,CAAC,MAAM,CAAC;YAC3B,UAAU,EAAE;gBACX,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,sBAAsB;gBAC/B,QAAQ,EAAE,+CAA+C;aACzD;YACD,OAAO,EAAE,CAAC,6BAA6B,EAAE,2BAA2B,CAAC;SACrE;KACD;IACD;QACC,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,CAAC,cAAc,CAAC;QAC3B,SAAS,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,oBAAoB;YACjC,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;YACzC,aAAa,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,KAAK,EAAE;SACvF;KACD;IACD;QACC,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,CAAC,WAAW,EAAE,qBAAqB,CAAC;QAC/C,SAAS,EAAE;YACV,IAAI,EAAE,qBAAqB;YAC3B,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,eAAe;YAC5B,iBAAiB,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;YACzC,UAAU,EAAE;gBACX,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,kBAAkB;gBAC3B,QAAQ,EAAE,wDAAwD;aAClE;YACD,OAAO,EAAE,CAAC,wBAAwB,EAAE,uBAAuB,CAAC;SAC5D;KACD;IACD;QACC,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,CAAC,cAAc,CAAC;QAC3B,SAAS,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,YAAY;YACzB,iBAAiB,EAAE,CAAC,WAAW,CAAC;YAChC,OAAO,EAAE,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;SACvD;KACD;CACD,CAAC","sourcesContent":["import type { CandidatePackageInput, SourceText } from \"./package-procurement.ts\";\n\nexport type PiPackageLane =\n\t| \"mcp\"\n\t| \"lens\"\n\t| \"browser\"\n\t| \"subagent\"\n\t| \"footer\"\n\t| \"todo\"\n\t| \"memory\"\n\t| \"safety\"\n\t| \"context-opt\"\n\t| \"goal\"\n\t| \"code-search\"\n\t| \"observability\"\n\t| \"actor\"\n\t| \"interactive-ui\"\n\t| \"side-channel\"\n\t| \"review\";\n\nexport type PiPackagePortMode = \"omk-native\" | \"reference\" | \"measurement-gated\";\n\nexport interface PiPackagePortCandidate {\n\treadonly id: string;\n\treadonly lane: PiPackageLane;\n\treadonly laneLabel: string;\n\treadonly portMode: PiPackagePortMode;\n\treadonly piOrigins: readonly string[];\n\treadonly candidate: CandidatePackageInput;\n}\n\nexport interface PiPackageCandidateReviewInput {\n\treadonly candidateId: string;\n\treadonly declaredLicense?: string;\n\treadonly packageJsonScripts?: Record<string, string>;\n\treadonly reviewedScriptAllowlist?: string[];\n\treadonly sources?: SourceText[];\n\treadonly transitiveLicenses?: string[];\n}\n\nconst P0_SYNTHETIC_PIN = \"0.0.0-p0.0\";\nconst P1_SYNTHETIC_PIN = \"0.0.0-p1.0\";\n\n/**\n * P1 batch: sourced from a full crawl of pi.dev/packages (94 pages, 4653 unique\n * packages, crawled 2026-07-01), cross-referenced against the P0 lanes above to avoid\n * duplicates, then filtered to the highest-download, most clearly-scoped package per\n * new capability lane. None of these have had a source-level compatibility/capability\n * scan run yet (no `sources` supplied here) - that is why every one of them uses a\n * conservative `intendedUse` (`reference`, `measurement-gated`, or `report-only`, never\n * `native` or `permanent-adopt`) until a real review supplies `sources`/`declaredLicense`\n * for the actual npm package content. See\n * `.omk/runs/pi-package-catalog-20260701/` for the full crawled catalog and per-lane\n * shortlist this batch was drawn from.\n */\nexport const P1_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[] = [\n\t{\n\t\tid: \"pi-hermes-memory\",\n\t\tlane: \"memory\",\n\t\tlaneLabel: \"memory\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"pi-hermes-memory\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-hermes-memory\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"memory\",\n\t\t\texpectedResources: [\"extension\", \"skill\"],\n\t\t\tpolicyOverlay: { declaredUse: \"memory\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"cc-safety-net\",\n\t\tlane: \"safety\",\n\t\tlaneLabel: \"safety\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"cc-safety-net\"],\n\t\tcandidate: {\n\t\t\tname: \"cc-safety-net\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"workflow-reference\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tpolicyOverlay: { declaredUse: \"workflow-reference\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-lean-ctx\",\n\t\tlane: \"context-opt\",\n\t\tlaneLabel: \"context-opt\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-lean-ctx\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-lean-ctx\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"cache-perf\",\n\t\t\texpectedResources: [\"extension\", \"tool\"],\n\t\t\t// Same underlying lean-ctx engine as the currently-disabled `lean-ctx` OMK MCP\n\t\t\t// server (unstable stdio connection, see prior session diagnosis). Measurement\n\t\t\t// must directly compare this extension path's stability against that known\n\t\t\t// failure mode before any native/permanent adoption is considered.\n\t\t\tmetrics: [\"session-cache-hit-rate\", \"stdio-connection-stability\", \"token-cost-per-reread\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-codex-goal\",\n\t\tlane: \"goal\",\n\t\tlaneLabel: \"goal\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"pi-codex-goal\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-codex-goal\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"workflow-reference\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\t// OMK already has native goal tracking (omk_orchestrate_goal / Ouroboros);\n\t\t\t// reference-only to compare UX patterns, not a functional gap.\n\t\t\tpolicyOverlay: { declaredUse: \"workflow-reference\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-readseek\",\n\t\tlane: \"code-search\",\n\t\tlaneLabel: \"code-search\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-readseek\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-readseek\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"quality\",\n\t\t\texpectedResources: [\"extension\", \"tool\"],\n\t\t\tmetrics: [\"hash-anchor-edit-success-rate\", \"structural-search-latency\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"braintrust-pi-extension\",\n\t\tlane: \"observability\",\n\t\tlaneLabel: \"observability\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"@braintrust/pi-extension\"],\n\t\tcandidate: {\n\t\t\tname: \"@braintrust/pi-extension\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"advisory\",\n\t\t\tdeclaredUse: \"observability\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\t// Third-party telemetry (matches package-procurement.ts's `telemetry` capability\n\t\t\t// rule verbatim - the pattern literally includes `@braintrust`). Must land as\n\t\t\t// report-only/advisory with a strict export policy, never a default-on data path.\n\t\t\tpolicyOverlay: {\n\t\t\t\tdeclaredUse: \"observability\",\n\t\t\t\texportPolicy: { defaultOff: true, offlineDisables: true, denyRawPrompt: true, denyRawToolOutput: true },\n\t\t\t},\n\t\t},\n\t},\n\t{\n\t\tid: \"llblab-pi-actors\",\n\t\tlane: \"actor\",\n\t\tlaneLabel: \"actor\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"@llblab/pi-actors\"],\n\t\tcandidate: {\n\t\t\tname: \"@llblab/pi-actors\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"workflow-reference\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\t// OMK already has the subagent tool + AdaptOrch WPL for orchestration;\n\t\t\t// reference-only pattern comparison for a local actor-kernel model.\n\t\t\tpolicyOverlay: { declaredUse: \"workflow-reference\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-ask-user\",\n\t\tlane: \"interactive-ui\",\n\t\tlaneLabel: \"interactive-ui\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-ask-user\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-ask-user\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"quality\",\n\t\t\texpectedResources: [\"extension\", \"tool\"],\n\t\t\tmetrics: [\"clarification-round-trip-count\", \"selection-ui-render-latency\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"rpiv-btw\",\n\t\tlane: \"side-channel\",\n\t\tlaneLabel: \"side-channel\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"@juicesharp/rpiv-btw\"],\n\t\tcandidate: {\n\t\t\tname: \"@juicesharp/rpiv-btw\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"workflow-reference\" as const,\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tmetrics: [\"main-transcript-pollution-delta\", \"side-question-latency\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-simplify\",\n\t\tlane: \"review\",\n\t\tlaneLabel: \"review\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"pi-simplify\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-simplify\",\n\t\t\texactVersion: P1_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"report-only\",\n\t\t\tdeclaredUse: \"quality\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\t// Review/advisory tool - decision matrix routes declaredUse \"quality\" to\n\t\t\t// report-only and denies it if it also claims filesystem-write/child-process\n\t\t\t// capabilities, which is exactly the right default for an unreviewed\n\t\t\t// code-review extension.\n\t\t},\n\t},\n];\n\nexport const P0_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[] = [\n\t{\n\t\tid: \"pi-mcp-adapter\",\n\t\tlane: \"mcp\",\n\t\tlaneLabel: \"MCP\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-mcp-adapter\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-mcp-adapter\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"loadout\",\n\t\t\texpectedResources: [\"extension\", \"tool\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"mcp-adapter\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/mcp-presets.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"mcp-server-discovery\", \"tool-registration-parity\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-lens\",\n\t\tlane: \"lens\",\n\t\tlaneLabel: \"lens\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-lens\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-lens\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"observability\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tmetrics: [\"lens-render-latency\", \"context-signal-coverage\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-agent-browser-native\",\n\t\tlane: \"browser\",\n\t\tlaneLabel: \"browser\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-agent-browser-native\", \"pi-browse\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-agent-browser-native\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"loadout\",\n\t\t\texpectedResources: [\"tool\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"agent-browser-native\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/browser-use.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"browser-action-success-rate\", \"browser-session-isolation\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-subagents\",\n\t\tlane: \"subagent\",\n\t\tlaneLabel: \"subagent\",\n\t\tportMode: \"reference\",\n\t\tpiOrigins: [\"pi-subagents\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-subagents\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"reference\",\n\t\t\tdeclaredUse: \"workflow-reference\",\n\t\t\texpectedResources: [\"extension\", \"skill\"],\n\t\t\tpolicyOverlay: { declaredUse: \"workflow-reference\", activateAlongsideScheduler: false },\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-powerline-footer\",\n\t\tlane: \"footer\",\n\t\tlaneLabel: \"footer\",\n\t\tportMode: \"omk-native\",\n\t\tpiOrigins: [\"pi-footer\", \"pi-powerline-footer\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-powerline-footer\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"native\",\n\t\t\tdeclaredUse: \"observability\",\n\t\t\texpectedResources: [\"theme\", \"extension\"],\n\t\t\tnativeSpec: {\n\t\t\t\texists: true,\n\t\t\t\ttrackId: \"powerline-footer\",\n\t\t\t\tspecPath: \"packages/coding-agent/src/core/footer-data-provider.ts\",\n\t\t\t},\n\t\t\tmetrics: [\"footer-width-stability\", \"footer-render-latency\"],\n\t\t},\n\t},\n\t{\n\t\tid: \"pi-long-task\",\n\t\tlane: \"todo\",\n\t\tlaneLabel: \"todo\",\n\t\tportMode: \"measurement-gated\",\n\t\tpiOrigins: [\"pi-long-task\"],\n\t\tcandidate: {\n\t\t\tname: \"pi-long-task\",\n\t\t\texactVersion: P0_SYNTHETIC_PIN,\n\t\t\tintendedUse: \"measurement-gated\",\n\t\t\tdeclaredUse: \"checkpoint\",\n\t\t\texpectedResources: [\"extension\"],\n\t\t\tmetrics: [\"long-task-resume-rate\", \"todo-state-parity\"],\n\t\t},\n\t},\n];\n"]}

package/dist/core/pi-package-intake.d.ts

@@ -1,7 +1,14 @@
 import { type ProcurementReview } from "./package-procurement.ts";
 import { type PiPackageCandidateReviewInput, type PiPackageLane, type PiPackagePortCandidate } from "./pi-package-intake-candidates.ts";
 export type { PiPackageCandidateReviewInput, PiPackageLane, PiPackagePortCandidate, PiPackagePortMode, } from "./pi-package-intake-candidates.ts";
-export { P0_PI_PACKAGE_PORT_CANDIDATES } from "./pi-package-intake-candidates.ts";
+export { P0_PI_PACKAGE_PORT_CANDIDATES, P1_PI_PACKAGE_PORT_CANDIDATES } from "./pi-package-intake-candidates.ts";
+/**
+ * Combined default candidate set (P0 + P1). P1 was drawn from a full crawl of
+ * pi.dev/packages (4653 unique packages) and is intentionally more conservative
+ * (reference/measurement-gated/report-only only, never native) since no source-level
+ * review has been run on any P1 candidate yet.
+ */
+export declare const ALL_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[];
 export interface PiPackageIntakeInput {
     readonly candidates?: readonly PiPackagePortCandidate[];
     readonly reviews?: readonly PiPackageCandidateReviewInput[];

package/dist/core/pi-package-intake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi-package-intake.d.ts","sourceRoot":"","sources":["../../src/core/pi-package-intake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,iBAAiB,EAAoB,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAEN,KAAK,6BAA6B,EAClC,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACX,6BAA6B,EAC7B,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CACzC;AAuBD,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,oBAAyB,GAAG,qBAAqB,CAO/F;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,sBAAsB,EAClC,WAAW,CAAC,EAAE,6BAA6B,EAC3C,GAAG,CAAC,EAAE,IAAI,GACR,qBAAqB,CAkBvB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,sBAAsB,CAgD1G","sourcesContent":["import { type Adoption, type ProcurementReview, procureCandidate } from \"./package-procurement.ts\";\nimport {\n\tP0_PI_PACKAGE_PORT_CANDIDATES,\n\ttype PiPackageCandidateReviewInput,\n\ttype PiPackageLane,\n\ttype PiPackagePortCandidate,\n} from \"./pi-package-intake-candidates.ts\";\n\nexport type {\n\tPiPackageCandidateReviewInput,\n\tPiPackageLane,\n\tPiPackagePortCandidate,\n\tPiPackagePortMode,\n} from \"./pi-package-intake-candidates.ts\";\nexport { P0_PI_PACKAGE_PORT_CANDIDATES } from \"./pi-package-intake-candidates.ts\";\n\nexport interface PiPackageIntakeInput {\n\treadonly candidates?: readonly PiPackagePortCandidate[];\n\treadonly reviews?: readonly PiPackageCandidateReviewInput[];\n\treadonly now?: Date;\n}\n\nexport interface PiPackageLaneSummary {\n\treadonly lane: PiPackageLane;\n\treadonly label: string;\n\treadonly total: number;\n\treadonly accepted: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n}\n\nexport interface PiPackageIntakeSummary {\n\treadonly total: number;\n\treadonly acceptedNative: number;\n\treadonly acceptedReference: number;\n\treadonly acceptedMeasurement: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n\treadonly topLanes: readonly PiPackageLaneSummary[];\n}\n\nexport interface PiPackageIntakeResult {\n\treadonly definition: PiPackagePortCandidate;\n\treadonly review: ProcurementReview;\n\treadonly hardForkBlocked: boolean;\n\treadonly hardForkReasons: readonly string[];\n\treadonly directPermanentPiAdoption: boolean;\n}\n\nexport interface PiPackageIntakeReport {\n\treadonly results: readonly PiPackageIntakeResult[];\n\treadonly summary: PiPackageIntakeSummary;\n}\n\nconst HARD_FORK_FINDING_KINDS = new Set([\n\t\"legacy-home-path\",\n\t\"legacy-state-dir\",\n\t\"legacy-project-path\",\n\t\"legacy-package-path\",\n\t\"legacy-cli-invocation\",\n\t\"legacy-import\",\n]);\n\nconst DIRECT_PI_ADOPTION_BLOCKED = new Set<Adoption>([\"permanent-package\"]);\n\ninterface MutablePiPackageLaneSummary {\n\tlane: PiPackageLane;\n\tlabel: string;\n\ttotal: number;\n\taccepted: number;\n\tdeferred: number;\n\treject: number;\n\thardForkBlocked: number;\n}\n\nexport function evaluatePiPackageIntake(input: PiPackageIntakeInput = {}): PiPackageIntakeReport {\n\tconst candidates = input.candidates ?? P0_PI_PACKAGE_PORT_CANDIDATES;\n\tconst reviewInputs = new Map((input.reviews ?? []).map((review) => [review.candidateId, review]));\n\tconst results = candidates.map((definition) =>\n\t\tevaluatePiPackageCandidate(definition, reviewInputs.get(definition.id), input.now),\n\t);\n\treturn { results, summary: summarizePiPackageIntake(results) };\n}\n\nexport function evaluatePiPackageCandidate(\n\tdefinition: PiPackagePortCandidate,\n\treviewInput?: PiPackageCandidateReviewInput,\n\tnow?: Date,\n): PiPackageIntakeResult {\n\tconst review = procureCandidate({\n\t\tcandidate: definition.candidate,\n\t\tdeclaredLicense: reviewInput?.declaredLicense ?? \"MIT\",\n\t\tpackageJsonScripts: reviewInput?.packageJsonScripts,\n\t\treviewedScriptAllowlist: reviewInput?.reviewedScriptAllowlist,\n\t\tsources: reviewInput?.sources,\n\t\ttransitiveLicenses: reviewInput?.transitiveLicenses,\n\t\tnow,\n\t});\n\tconst hardForkReasons = hardForkBlockReasons(review);\n\treturn {\n\t\tdefinition,\n\t\treview,\n\t\thardForkBlocked: hardForkReasons.length > 0,\n\t\thardForkReasons,\n\t\tdirectPermanentPiAdoption: isDirectPermanentPiAdoption(definition, review),\n\t};\n}\n\nexport function summarizePiPackageIntake(results: readonly PiPackageIntakeResult[]): PiPackageIntakeSummary {\n\tconst laneSummaries = new Map<PiPackageLane, MutablePiPackageLaneSummary>();\n\tlet acceptedNative = 0;\n\tlet acceptedReference = 0;\n\tlet acceptedMeasurement = 0;\n\tlet deferred = 0;\n\tlet reject = 0;\n\tlet hardForkBlocked = 0;\n\n\tfor (const result of results) {\n\t\tconst lane = laneSummaries.get(result.definition.lane) ?? laneSummaryFor(result);\n\t\tlaneSummaries.set(result.definition.lane, lane);\n\t\tlane.total += 1;\n\n\t\tif (result.hardForkBlocked) {\n\t\t\thardForkBlocked += 1;\n\t\t\tlane.hardForkBlocked += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.review.adoption === \"native\") {\n\t\t\tacceptedNative += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"reference-only\") {\n\t\t\tacceptedReference += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"measurement-gated\") {\n\t\t\tacceptedMeasurement += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"deferred\") {\n\t\t\tdeferred += 1;\n\t\t\tlane.deferred += 1;\n\t\t} else if (result.review.adoption === \"reject\") {\n\t\t\treject += 1;\n\t\t\tlane.reject += 1;\n\t\t}\n\t}\n\n\treturn {\n\t\ttotal: results.length,\n\t\tacceptedNative,\n\t\tacceptedReference,\n\t\tacceptedMeasurement,\n\t\tdeferred,\n\t\treject,\n\t\thardForkBlocked,\n\t\ttopLanes: [...laneSummaries.values()].sort(compareLaneSummaries).map((lane) => ({ ...lane })),\n\t};\n}\n\nfunction hardForkBlockReasons(review: ProcurementReview): string[] {\n\tconst reasons = review.compatibilityFindings\n\t\t.filter((finding) => finding.severity === \"block\" && HARD_FORK_FINDING_KINDS.has(finding.kind))\n\t\t.map((finding) => `${finding.kind}:${finding.path ?? \"source\"}:${finding.line}`);\n\tif (review.lifecycleVerdict === \"reject\") {\n\t\treasons.push(...review.declaredLifecycleScripts.map((script) => `lifecycle-script:${script}`));\n\t}\n\treturn [...new Set(reasons)];\n}\n\nfunction isDirectPermanentPiAdoption(definition: PiPackagePortCandidate, review: ProcurementReview): boolean {\n\treturn definition.candidate.intendedUse === \"permanent-adopt\" || DIRECT_PI_ADOPTION_BLOCKED.has(review.adoption);\n}\n\nfunction laneSummaryFor(result: PiPackageIntakeResult): MutablePiPackageLaneSummary {\n\treturn {\n\t\tlane: result.definition.lane,\n\t\tlabel: result.definition.laneLabel,\n\t\ttotal: 0,\n\t\taccepted: 0,\n\t\tdeferred: 0,\n\t\treject: 0,\n\t\thardForkBlocked: 0,\n\t};\n}\n\nfunction compareLaneSummaries(a: PiPackageLaneSummary, b: PiPackageLaneSummary): number {\n\tconst acceptedDelta = b.accepted - a.accepted;\n\tif (acceptedDelta !== 0) return acceptedDelta;\n\tconst totalDelta = b.total - a.total;\n\tif (totalDelta !== 0) return totalDelta;\n\treturn laneRank(a.lane) - laneRank(b.lane);\n}\n\nfunction laneRank(lane: PiPackageLane): number {\n\treturn P0_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);\n}\n"]}
+{"version":3,"file":"pi-package-intake.d.ts","sourceRoot":"","sources":["../../src/core/pi-package-intake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,iBAAiB,EAAoB,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAGN,KAAK,6BAA6B,EAClC,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACX,6BAA6B,EAC7B,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAEjH;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,sBAAsB,EAG3E,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CACzC;AAuBD,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,oBAAyB,GAAG,qBAAqB,CAO/F;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,sBAAsB,EAClC,WAAW,CAAC,EAAE,6BAA6B,EAC3C,GAAG,CAAC,EAAE,IAAI,GACR,qBAAqB,CAkBvB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,sBAAsB,CAgD1G","sourcesContent":["import { type Adoption, type ProcurementReview, procureCandidate } from \"./package-procurement.ts\";\nimport {\n\tP0_PI_PACKAGE_PORT_CANDIDATES,\n\tP1_PI_PACKAGE_PORT_CANDIDATES,\n\ttype PiPackageCandidateReviewInput,\n\ttype PiPackageLane,\n\ttype PiPackagePortCandidate,\n} from \"./pi-package-intake-candidates.ts\";\n\nexport type {\n\tPiPackageCandidateReviewInput,\n\tPiPackageLane,\n\tPiPackagePortCandidate,\n\tPiPackagePortMode,\n} from \"./pi-package-intake-candidates.ts\";\nexport { P0_PI_PACKAGE_PORT_CANDIDATES, P1_PI_PACKAGE_PORT_CANDIDATES } from \"./pi-package-intake-candidates.ts\";\n\n/**\n * Combined default candidate set (P0 + P1). P1 was drawn from a full crawl of\n * pi.dev/packages (4653 unique packages) and is intentionally more conservative\n * (reference/measurement-gated/report-only only, never native) since no source-level\n * review has been run on any P1 candidate yet.\n */\nexport const ALL_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[] = [\n\t...P0_PI_PACKAGE_PORT_CANDIDATES,\n\t...P1_PI_PACKAGE_PORT_CANDIDATES,\n];\n\nexport interface PiPackageIntakeInput {\n\treadonly candidates?: readonly PiPackagePortCandidate[];\n\treadonly reviews?: readonly PiPackageCandidateReviewInput[];\n\treadonly now?: Date;\n}\n\nexport interface PiPackageLaneSummary {\n\treadonly lane: PiPackageLane;\n\treadonly label: string;\n\treadonly total: number;\n\treadonly accepted: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n}\n\nexport interface PiPackageIntakeSummary {\n\treadonly total: number;\n\treadonly acceptedNative: number;\n\treadonly acceptedReference: number;\n\treadonly acceptedMeasurement: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n\treadonly topLanes: readonly PiPackageLaneSummary[];\n}\n\nexport interface PiPackageIntakeResult {\n\treadonly definition: PiPackagePortCandidate;\n\treadonly review: ProcurementReview;\n\treadonly hardForkBlocked: boolean;\n\treadonly hardForkReasons: readonly string[];\n\treadonly directPermanentPiAdoption: boolean;\n}\n\nexport interface PiPackageIntakeReport {\n\treadonly results: readonly PiPackageIntakeResult[];\n\treadonly summary: PiPackageIntakeSummary;\n}\n\nconst HARD_FORK_FINDING_KINDS = new Set([\n\t\"legacy-home-path\",\n\t\"legacy-state-dir\",\n\t\"legacy-project-path\",\n\t\"legacy-package-path\",\n\t\"legacy-cli-invocation\",\n\t\"legacy-import\",\n]);\n\nconst DIRECT_PI_ADOPTION_BLOCKED = new Set<Adoption>([\"permanent-package\"]);\n\ninterface MutablePiPackageLaneSummary {\n\tlane: PiPackageLane;\n\tlabel: string;\n\ttotal: number;\n\taccepted: number;\n\tdeferred: number;\n\treject: number;\n\thardForkBlocked: number;\n}\n\nexport function evaluatePiPackageIntake(input: PiPackageIntakeInput = {}): PiPackageIntakeReport {\n\tconst candidates = input.candidates ?? ALL_PI_PACKAGE_PORT_CANDIDATES;\n\tconst reviewInputs = new Map((input.reviews ?? []).map((review) => [review.candidateId, review]));\n\tconst results = candidates.map((definition) =>\n\t\tevaluatePiPackageCandidate(definition, reviewInputs.get(definition.id), input.now),\n\t);\n\treturn { results, summary: summarizePiPackageIntake(results) };\n}\n\nexport function evaluatePiPackageCandidate(\n\tdefinition: PiPackagePortCandidate,\n\treviewInput?: PiPackageCandidateReviewInput,\n\tnow?: Date,\n): PiPackageIntakeResult {\n\tconst review = procureCandidate({\n\t\tcandidate: definition.candidate,\n\t\tdeclaredLicense: reviewInput?.declaredLicense ?? \"MIT\",\n\t\tpackageJsonScripts: reviewInput?.packageJsonScripts,\n\t\treviewedScriptAllowlist: reviewInput?.reviewedScriptAllowlist,\n\t\tsources: reviewInput?.sources,\n\t\ttransitiveLicenses: reviewInput?.transitiveLicenses,\n\t\tnow,\n\t});\n\tconst hardForkReasons = hardForkBlockReasons(review);\n\treturn {\n\t\tdefinition,\n\t\treview,\n\t\thardForkBlocked: hardForkReasons.length > 0,\n\t\thardForkReasons,\n\t\tdirectPermanentPiAdoption: isDirectPermanentPiAdoption(definition, review),\n\t};\n}\n\nexport function summarizePiPackageIntake(results: readonly PiPackageIntakeResult[]): PiPackageIntakeSummary {\n\tconst laneSummaries = new Map<PiPackageLane, MutablePiPackageLaneSummary>();\n\tlet acceptedNative = 0;\n\tlet acceptedReference = 0;\n\tlet acceptedMeasurement = 0;\n\tlet deferred = 0;\n\tlet reject = 0;\n\tlet hardForkBlocked = 0;\n\n\tfor (const result of results) {\n\t\tconst lane = laneSummaries.get(result.definition.lane) ?? laneSummaryFor(result);\n\t\tlaneSummaries.set(result.definition.lane, lane);\n\t\tlane.total += 1;\n\n\t\tif (result.hardForkBlocked) {\n\t\t\thardForkBlocked += 1;\n\t\t\tlane.hardForkBlocked += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.review.adoption === \"native\") {\n\t\t\tacceptedNative += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"reference-only\") {\n\t\t\tacceptedReference += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"measurement-gated\") {\n\t\t\tacceptedMeasurement += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"deferred\") {\n\t\t\tdeferred += 1;\n\t\t\tlane.deferred += 1;\n\t\t} else if (result.review.adoption === \"reject\") {\n\t\t\treject += 1;\n\t\t\tlane.reject += 1;\n\t\t}\n\t}\n\n\treturn {\n\t\ttotal: results.length,\n\t\tacceptedNative,\n\t\tacceptedReference,\n\t\tacceptedMeasurement,\n\t\tdeferred,\n\t\treject,\n\t\thardForkBlocked,\n\t\ttopLanes: [...laneSummaries.values()].sort(compareLaneSummaries).map((lane) => ({ ...lane })),\n\t};\n}\n\nfunction hardForkBlockReasons(review: ProcurementReview): string[] {\n\tconst reasons = review.compatibilityFindings\n\t\t.filter((finding) => finding.severity === \"block\" && HARD_FORK_FINDING_KINDS.has(finding.kind))\n\t\t.map((finding) => `${finding.kind}:${finding.path ?? \"source\"}:${finding.line}`);\n\tif (review.lifecycleVerdict === \"reject\") {\n\t\treasons.push(...review.declaredLifecycleScripts.map((script) => `lifecycle-script:${script}`));\n\t}\n\treturn [...new Set(reasons)];\n}\n\nfunction isDirectPermanentPiAdoption(definition: PiPackagePortCandidate, review: ProcurementReview): boolean {\n\treturn definition.candidate.intendedUse === \"permanent-adopt\" || DIRECT_PI_ADOPTION_BLOCKED.has(review.adoption);\n}\n\nfunction laneSummaryFor(result: PiPackageIntakeResult): MutablePiPackageLaneSummary {\n\treturn {\n\t\tlane: result.definition.lane,\n\t\tlabel: result.definition.laneLabel,\n\t\ttotal: 0,\n\t\taccepted: 0,\n\t\tdeferred: 0,\n\t\treject: 0,\n\t\thardForkBlocked: 0,\n\t};\n}\n\nfunction compareLaneSummaries(a: PiPackageLaneSummary, b: PiPackageLaneSummary): number {\n\tconst acceptedDelta = b.accepted - a.accepted;\n\tif (acceptedDelta !== 0) return acceptedDelta;\n\tconst totalDelta = b.total - a.total;\n\tif (totalDelta !== 0) return totalDelta;\n\treturn laneRank(a.lane) - laneRank(b.lane);\n}\n\nfunction laneRank(lane: PiPackageLane): number {\n\treturn ALL_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);\n}\n"]}

package/dist/core/pi-package-intake.js

@@ -1,6 +1,16 @@
 import { procureCandidate } from "./package-procurement.js";
-import { P0_PI_PACKAGE_PORT_CANDIDATES, } from "./pi-package-intake-candidates.js";
-export { P0_PI_PACKAGE_PORT_CANDIDATES } from "./pi-package-intake-candidates.js";
+import { P0_PI_PACKAGE_PORT_CANDIDATES, P1_PI_PACKAGE_PORT_CANDIDATES, } from "./pi-package-intake-candidates.js";
+export { P0_PI_PACKAGE_PORT_CANDIDATES, P1_PI_PACKAGE_PORT_CANDIDATES } from "./pi-package-intake-candidates.js";
+/**
+ * Combined default candidate set (P0 + P1). P1 was drawn from a full crawl of
+ * pi.dev/packages (4653 unique packages) and is intentionally more conservative
+ * (reference/measurement-gated/report-only only, never native) since no source-level
+ * review has been run on any P1 candidate yet.
+ */
+export const ALL_PI_PACKAGE_PORT_CANDIDATES = [
+    ...P0_PI_PACKAGE_PORT_CANDIDATES,
+    ...P1_PI_PACKAGE_PORT_CANDIDATES,
+];
 const HARD_FORK_FINDING_KINDS = new Set([
     "legacy-home-path",
     "legacy-state-dir",
@@ -11,7 +21,7 @@ const HARD_FORK_FINDING_KINDS = new Set([
 ]);
 const DIRECT_PI_ADOPTION_BLOCKED = new Set(["permanent-package"]);
 export function evaluatePiPackageIntake(input = {}) {
-    const candidates = input.candidates ?? P0_PI_PACKAGE_PORT_CANDIDATES;
+    const candidates = input.candidates ?? ALL_PI_PACKAGE_PORT_CANDIDATES;
     const reviewInputs = new Map((input.reviews ?? []).map((review) => [review.candidateId, review]));
     const results = candidates.map((definition) => evaluatePiPackageCandidate(definition, reviewInputs.get(definition.id), input.now));
     return { results, summary: summarizePiPackageIntake(results) };
@@ -117,6 +127,6 @@ function compareLaneSummaries(a, b) {
     return laneRank(a.lane) - laneRank(b.lane);
 }
 function laneRank(lane) {
-    return P0_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);
+    return ALL_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);
 }
 //# sourceMappingURL=pi-package-intake.js.map

package/dist/core/pi-package-intake.js.map

@@ -1 +1 @@
-{"version":3,"file":"pi-package-intake.js","sourceRoot":"","sources":["../../src/core/pi-package-intake.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Adoption, type ProcurementReview, procureCandidate } from \"./package-procurement.ts\";\nimport {\n\tP0_PI_PACKAGE_PORT_CANDIDATES,\n\ttype PiPackageCandidateReviewInput,\n\ttype PiPackageLane,\n\ttype PiPackagePortCandidate,\n} from \"./pi-package-intake-candidates.ts\";\n\nexport type {\n\tPiPackageCandidateReviewInput,\n\tPiPackageLane,\n\tPiPackagePortCandidate,\n\tPiPackagePortMode,\n} from \"./pi-package-intake-candidates.ts\";\nexport { P0_PI_PACKAGE_PORT_CANDIDATES } from \"./pi-package-intake-candidates.ts\";\n\nexport interface PiPackageIntakeInput {\n\treadonly candidates?: readonly PiPackagePortCandidate[];\n\treadonly reviews?: readonly PiPackageCandidateReviewInput[];\n\treadonly now?: Date;\n}\n\nexport interface PiPackageLaneSummary {\n\treadonly lane: PiPackageLane;\n\treadonly label: string;\n\treadonly total: number;\n\treadonly accepted: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n}\n\nexport interface PiPackageIntakeSummary {\n\treadonly total: number;\n\treadonly acceptedNative: number;\n\treadonly acceptedReference: number;\n\treadonly acceptedMeasurement: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n\treadonly topLanes: readonly PiPackageLaneSummary[];\n}\n\nexport interface PiPackageIntakeResult {\n\treadonly definition: PiPackagePortCandidate;\n\treadonly review: ProcurementReview;\n\treadonly hardForkBlocked: boolean;\n\treadonly hardForkReasons: readonly string[];\n\treadonly directPermanentPiAdoption: boolean;\n}\n\nexport interface PiPackageIntakeReport {\n\treadonly results: readonly PiPackageIntakeResult[];\n\treadonly summary: PiPackageIntakeSummary;\n}\n\nconst HARD_FORK_FINDING_KINDS = new Set([\n\t\"legacy-home-path\",\n\t\"legacy-state-dir\",\n\t\"legacy-project-path\",\n\t\"legacy-package-path\",\n\t\"legacy-cli-invocation\",\n\t\"legacy-import\",\n]);\n\nconst DIRECT_PI_ADOPTION_BLOCKED = new Set<Adoption>([\"permanent-package\"]);\n\ninterface MutablePiPackageLaneSummary {\n\tlane: PiPackageLane;\n\tlabel: string;\n\ttotal: number;\n\taccepted: number;\n\tdeferred: number;\n\treject: number;\n\thardForkBlocked: number;\n}\n\nexport function evaluatePiPackageIntake(input: PiPackageIntakeInput = {}): PiPackageIntakeReport {\n\tconst candidates = input.candidates ?? P0_PI_PACKAGE_PORT_CANDIDATES;\n\tconst reviewInputs = new Map((input.reviews ?? []).map((review) => [review.candidateId, review]));\n\tconst results = candidates.map((definition) =>\n\t\tevaluatePiPackageCandidate(definition, reviewInputs.get(definition.id), input.now),\n\t);\n\treturn { results, summary: summarizePiPackageIntake(results) };\n}\n\nexport function evaluatePiPackageCandidate(\n\tdefinition: PiPackagePortCandidate,\n\treviewInput?: PiPackageCandidateReviewInput,\n\tnow?: Date,\n): PiPackageIntakeResult {\n\tconst review = procureCandidate({\n\t\tcandidate: definition.candidate,\n\t\tdeclaredLicense: reviewInput?.declaredLicense ?? \"MIT\",\n\t\tpackageJsonScripts: reviewInput?.packageJsonScripts,\n\t\treviewedScriptAllowlist: reviewInput?.reviewedScriptAllowlist,\n\t\tsources: reviewInput?.sources,\n\t\ttransitiveLicenses: reviewInput?.transitiveLicenses,\n\t\tnow,\n\t});\n\tconst hardForkReasons = hardForkBlockReasons(review);\n\treturn {\n\t\tdefinition,\n\t\treview,\n\t\thardForkBlocked: hardForkReasons.length > 0,\n\t\thardForkReasons,\n\t\tdirectPermanentPiAdoption: isDirectPermanentPiAdoption(definition, review),\n\t};\n}\n\nexport function summarizePiPackageIntake(results: readonly PiPackageIntakeResult[]): PiPackageIntakeSummary {\n\tconst laneSummaries = new Map<PiPackageLane, MutablePiPackageLaneSummary>();\n\tlet acceptedNative = 0;\n\tlet acceptedReference = 0;\n\tlet acceptedMeasurement = 0;\n\tlet deferred = 0;\n\tlet reject = 0;\n\tlet hardForkBlocked = 0;\n\n\tfor (const result of results) {\n\t\tconst lane = laneSummaries.get(result.definition.lane) ?? laneSummaryFor(result);\n\t\tlaneSummaries.set(result.definition.lane, lane);\n\t\tlane.total += 1;\n\n\t\tif (result.hardForkBlocked) {\n\t\t\thardForkBlocked += 1;\n\t\t\tlane.hardForkBlocked += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.review.adoption === \"native\") {\n\t\t\tacceptedNative += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"reference-only\") {\n\t\t\tacceptedReference += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"measurement-gated\") {\n\t\t\tacceptedMeasurement += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"deferred\") {\n\t\t\tdeferred += 1;\n\t\t\tlane.deferred += 1;\n\t\t} else if (result.review.adoption === \"reject\") {\n\t\t\treject += 1;\n\t\t\tlane.reject += 1;\n\t\t}\n\t}\n\n\treturn {\n\t\ttotal: results.length,\n\t\tacceptedNative,\n\t\tacceptedReference,\n\t\tacceptedMeasurement,\n\t\tdeferred,\n\t\treject,\n\t\thardForkBlocked,\n\t\ttopLanes: [...laneSummaries.values()].sort(compareLaneSummaries).map((lane) => ({ ...lane })),\n\t};\n}\n\nfunction hardForkBlockReasons(review: ProcurementReview): string[] {\n\tconst reasons = review.compatibilityFindings\n\t\t.filter((finding) => finding.severity === \"block\" && HARD_FORK_FINDING_KINDS.has(finding.kind))\n\t\t.map((finding) => `${finding.kind}:${finding.path ?? \"source\"}:${finding.line}`);\n\tif (review.lifecycleVerdict === \"reject\") {\n\t\treasons.push(...review.declaredLifecycleScripts.map((script) => `lifecycle-script:${script}`));\n\t}\n\treturn [...new Set(reasons)];\n}\n\nfunction isDirectPermanentPiAdoption(definition: PiPackagePortCandidate, review: ProcurementReview): boolean {\n\treturn definition.candidate.intendedUse === \"permanent-adopt\" || DIRECT_PI_ADOPTION_BLOCKED.has(review.adoption);\n}\n\nfunction laneSummaryFor(result: PiPackageIntakeResult): MutablePiPackageLaneSummary {\n\treturn {\n\t\tlane: result.definition.lane,\n\t\tlabel: result.definition.laneLabel,\n\t\ttotal: 0,\n\t\taccepted: 0,\n\t\tdeferred: 0,\n\t\treject: 0,\n\t\thardForkBlocked: 0,\n\t};\n}\n\nfunction compareLaneSummaries(a: PiPackageLaneSummary, b: PiPackageLaneSummary): number {\n\tconst acceptedDelta = b.accepted - a.accepted;\n\tif (acceptedDelta !== 0) return acceptedDelta;\n\tconst totalDelta = b.total - a.total;\n\tif (totalDelta !== 0) return totalDelta;\n\treturn laneRank(a.lane) - laneRank(b.lane);\n}\n\nfunction laneRank(lane: PiPackageLane): number {\n\treturn P0_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);\n}\n"]}
+{"version":3,"file":"pi-package-intake.js","sourceRoot":"","sources":["../../src/core/pi-package-intake.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Adoption, type ProcurementReview, procureCandidate } from \"./package-procurement.ts\";\nimport {\n\tP0_PI_PACKAGE_PORT_CANDIDATES,\n\tP1_PI_PACKAGE_PORT_CANDIDATES,\n\ttype PiPackageCandidateReviewInput,\n\ttype PiPackageLane,\n\ttype PiPackagePortCandidate,\n} from \"./pi-package-intake-candidates.ts\";\n\nexport type {\n\tPiPackageCandidateReviewInput,\n\tPiPackageLane,\n\tPiPackagePortCandidate,\n\tPiPackagePortMode,\n} from \"./pi-package-intake-candidates.ts\";\nexport { P0_PI_PACKAGE_PORT_CANDIDATES, P1_PI_PACKAGE_PORT_CANDIDATES } from \"./pi-package-intake-candidates.ts\";\n\n/**\n * Combined default candidate set (P0 + P1). P1 was drawn from a full crawl of\n * pi.dev/packages (4653 unique packages) and is intentionally more conservative\n * (reference/measurement-gated/report-only only, never native) since no source-level\n * review has been run on any P1 candidate yet.\n */\nexport const ALL_PI_PACKAGE_PORT_CANDIDATES: readonly PiPackagePortCandidate[] = [\n\t...P0_PI_PACKAGE_PORT_CANDIDATES,\n\t...P1_PI_PACKAGE_PORT_CANDIDATES,\n];\n\nexport interface PiPackageIntakeInput {\n\treadonly candidates?: readonly PiPackagePortCandidate[];\n\treadonly reviews?: readonly PiPackageCandidateReviewInput[];\n\treadonly now?: Date;\n}\n\nexport interface PiPackageLaneSummary {\n\treadonly lane: PiPackageLane;\n\treadonly label: string;\n\treadonly total: number;\n\treadonly accepted: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n}\n\nexport interface PiPackageIntakeSummary {\n\treadonly total: number;\n\treadonly acceptedNative: number;\n\treadonly acceptedReference: number;\n\treadonly acceptedMeasurement: number;\n\treadonly deferred: number;\n\treadonly reject: number;\n\treadonly hardForkBlocked: number;\n\treadonly topLanes: readonly PiPackageLaneSummary[];\n}\n\nexport interface PiPackageIntakeResult {\n\treadonly definition: PiPackagePortCandidate;\n\treadonly review: ProcurementReview;\n\treadonly hardForkBlocked: boolean;\n\treadonly hardForkReasons: readonly string[];\n\treadonly directPermanentPiAdoption: boolean;\n}\n\nexport interface PiPackageIntakeReport {\n\treadonly results: readonly PiPackageIntakeResult[];\n\treadonly summary: PiPackageIntakeSummary;\n}\n\nconst HARD_FORK_FINDING_KINDS = new Set([\n\t\"legacy-home-path\",\n\t\"legacy-state-dir\",\n\t\"legacy-project-path\",\n\t\"legacy-package-path\",\n\t\"legacy-cli-invocation\",\n\t\"legacy-import\",\n]);\n\nconst DIRECT_PI_ADOPTION_BLOCKED = new Set<Adoption>([\"permanent-package\"]);\n\ninterface MutablePiPackageLaneSummary {\n\tlane: PiPackageLane;\n\tlabel: string;\n\ttotal: number;\n\taccepted: number;\n\tdeferred: number;\n\treject: number;\n\thardForkBlocked: number;\n}\n\nexport function evaluatePiPackageIntake(input: PiPackageIntakeInput = {}): PiPackageIntakeReport {\n\tconst candidates = input.candidates ?? ALL_PI_PACKAGE_PORT_CANDIDATES;\n\tconst reviewInputs = new Map((input.reviews ?? []).map((review) => [review.candidateId, review]));\n\tconst results = candidates.map((definition) =>\n\t\tevaluatePiPackageCandidate(definition, reviewInputs.get(definition.id), input.now),\n\t);\n\treturn { results, summary: summarizePiPackageIntake(results) };\n}\n\nexport function evaluatePiPackageCandidate(\n\tdefinition: PiPackagePortCandidate,\n\treviewInput?: PiPackageCandidateReviewInput,\n\tnow?: Date,\n): PiPackageIntakeResult {\n\tconst review = procureCandidate({\n\t\tcandidate: definition.candidate,\n\t\tdeclaredLicense: reviewInput?.declaredLicense ?? \"MIT\",\n\t\tpackageJsonScripts: reviewInput?.packageJsonScripts,\n\t\treviewedScriptAllowlist: reviewInput?.reviewedScriptAllowlist,\n\t\tsources: reviewInput?.sources,\n\t\ttransitiveLicenses: reviewInput?.transitiveLicenses,\n\t\tnow,\n\t});\n\tconst hardForkReasons = hardForkBlockReasons(review);\n\treturn {\n\t\tdefinition,\n\t\treview,\n\t\thardForkBlocked: hardForkReasons.length > 0,\n\t\thardForkReasons,\n\t\tdirectPermanentPiAdoption: isDirectPermanentPiAdoption(definition, review),\n\t};\n}\n\nexport function summarizePiPackageIntake(results: readonly PiPackageIntakeResult[]): PiPackageIntakeSummary {\n\tconst laneSummaries = new Map<PiPackageLane, MutablePiPackageLaneSummary>();\n\tlet acceptedNative = 0;\n\tlet acceptedReference = 0;\n\tlet acceptedMeasurement = 0;\n\tlet deferred = 0;\n\tlet reject = 0;\n\tlet hardForkBlocked = 0;\n\n\tfor (const result of results) {\n\t\tconst lane = laneSummaries.get(result.definition.lane) ?? laneSummaryFor(result);\n\t\tlaneSummaries.set(result.definition.lane, lane);\n\t\tlane.total += 1;\n\n\t\tif (result.hardForkBlocked) {\n\t\t\thardForkBlocked += 1;\n\t\t\tlane.hardForkBlocked += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.review.adoption === \"native\") {\n\t\t\tacceptedNative += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"reference-only\") {\n\t\t\tacceptedReference += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"measurement-gated\") {\n\t\t\tacceptedMeasurement += 1;\n\t\t\tlane.accepted += 1;\n\t\t} else if (result.review.adoption === \"deferred\") {\n\t\t\tdeferred += 1;\n\t\t\tlane.deferred += 1;\n\t\t} else if (result.review.adoption === \"reject\") {\n\t\t\treject += 1;\n\t\t\tlane.reject += 1;\n\t\t}\n\t}\n\n\treturn {\n\t\ttotal: results.length,\n\t\tacceptedNative,\n\t\tacceptedReference,\n\t\tacceptedMeasurement,\n\t\tdeferred,\n\t\treject,\n\t\thardForkBlocked,\n\t\ttopLanes: [...laneSummaries.values()].sort(compareLaneSummaries).map((lane) => ({ ...lane })),\n\t};\n}\n\nfunction hardForkBlockReasons(review: ProcurementReview): string[] {\n\tconst reasons = review.compatibilityFindings\n\t\t.filter((finding) => finding.severity === \"block\" && HARD_FORK_FINDING_KINDS.has(finding.kind))\n\t\t.map((finding) => `${finding.kind}:${finding.path ?? \"source\"}:${finding.line}`);\n\tif (review.lifecycleVerdict === \"reject\") {\n\t\treasons.push(...review.declaredLifecycleScripts.map((script) => `lifecycle-script:${script}`));\n\t}\n\treturn [...new Set(reasons)];\n}\n\nfunction isDirectPermanentPiAdoption(definition: PiPackagePortCandidate, review: ProcurementReview): boolean {\n\treturn definition.candidate.intendedUse === \"permanent-adopt\" || DIRECT_PI_ADOPTION_BLOCKED.has(review.adoption);\n}\n\nfunction laneSummaryFor(result: PiPackageIntakeResult): MutablePiPackageLaneSummary {\n\treturn {\n\t\tlane: result.definition.lane,\n\t\tlabel: result.definition.laneLabel,\n\t\ttotal: 0,\n\t\taccepted: 0,\n\t\tdeferred: 0,\n\t\treject: 0,\n\t\thardForkBlocked: 0,\n\t};\n}\n\nfunction compareLaneSummaries(a: PiPackageLaneSummary, b: PiPackageLaneSummary): number {\n\tconst acceptedDelta = b.accepted - a.accepted;\n\tif (acceptedDelta !== 0) return acceptedDelta;\n\tconst totalDelta = b.total - a.total;\n\tif (totalDelta !== 0) return totalDelta;\n\treturn laneRank(a.lane) - laneRank(b.lane);\n}\n\nfunction laneRank(lane: PiPackageLane): number {\n\treturn ALL_PI_PACKAGE_PORT_CANDIDATES.findIndex((candidate) => candidate.lane === lane);\n}\n"]}

package/dist/core/reasoning-router-bias.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Reasoning-router bias compiler — Goal 009 Wave 1 Lane L (privacy-safe learning ledger).
+ *
+ * Pure, deterministic compiler from a set of privacy-safe feedback records
+ * (see router-feedback-collector.ts) to a bounded, per-cell reasoning-level
+ * bias snapshot. No clock, randomness, network, or model calls: the same
+ * input array always produces the same output (`JSON.stringify` byte-
+ * identical), regardless of input record order. This module is a standalone,
+ * pure utility — nothing here is wired into a router resolver or
+ * agent-session.ts by this lane.
+ *
+ * Goal 010 Lane I addition: `isRouterBiasCell` / `isRouterBiasSnapshot` /
+ * `parseRouterBiasSnapshot` / `getDefaultRouterBiasSnapshotPath` below let a
+ * (now opt-in) caller safely load a snapshot this module previously only
+ * wrote. `parseRouterBiasSnapshot` performs no filesystem access itself — it
+ * only validates already-read text — so this module's zero-I/O determinism
+ * guarantee for `compileBiasSnapshot`/`getBiasStepsForCell` is unchanged; the
+ * actual disk read lives in agent-session.ts.
+ */
+import { type RouterFeedbackLaneType, type RouterFeedbackLenBucket, type RouterFeedbackTaskClass, type RouterFeedbackVersion } from "./router-feedback-collector.ts";
+/** Minimum non-neutral ("strong") record count per cell before any bias applies. */
+export declare const BIAS_STRONG_THRESHOLD = 5;
+/** Bias magnitude bound, matching the resolver's existing bias clamp (reasoning-router-v2.ts BIAS_MAX). */
+export declare const BIAS_MAX_STEPS = 2;
+/** Bounded per-cell bias, in ladder steps. Never outside [-2, 2]. */
+export type RouterBiasSteps = -2 | -1 | 0 | 1 | 2;
+/** The feature tuple a bias cell is keyed on — identical dimensions the router already computes locally. */
+export interface RouterBiasCellKey {
+    readonly predictedClass: RouterFeedbackTaskClass;
+    readonly laneType: RouterFeedbackLaneType;
+    readonly lenBucket: RouterFeedbackLenBucket;
+    readonly hadFence: boolean;
+    readonly hadDiff: boolean;
+}
+export interface RouterBiasCell extends RouterBiasCellKey {
+    readonly biasSteps: RouterBiasSteps;
+    /** Non-neutral (up/down-signaling) record count for this cell. */
+    readonly nStrong: number;
+    /** Total record count for this cell, including neutral (accepted/same/pass) records. */
+    readonly nTotal: number;
+}
+export interface RouterBiasSnapshot {
+    readonly schemaVersion: "router-bias-snapshot/v1";
+    /** sha256 hex digest of the canonicalized valid-record set actually compiled; not a prompt hash. */
+    readonly sourceRecordDigest: string;
+    /** Count of records that were validated and included in this snapshot. */
+    readonly consideredCount: number;
+    /** Count of records excluded from this snapshot (schema-invalid, or router-version mismatch). */
+    readonly droppedCount: number;
+    /** Bias cells, sorted deterministically. Empty when there is no ledger data or no cell reaches the threshold. */
+    readonly biasCells: readonly RouterBiasCell[];
+}
+export interface CompileBiasSnapshotOptions {
+    /**
+     * Restrict compilation to one router version — `compileBiasSnapshot` never
+     * mixes records from different router versions into one snapshot. Records
+     * tagged with any other `routerVersion` are excluded from this snapshot and
+     * counted in `droppedCount`. Defaults to "v3" for API compatibility; the
+     * offline CLI now defaults to "v4", matching the only auto-router wired to
+     * consume a learning-bias snapshot at runtime.
+     */
+    readonly routerVersion?: RouterFeedbackVersion;
+}
+/**
+ * Deterministically compile a bounded bias snapshot from raw (possibly
+ * malformed) ledger entries. Unknown-shaped entries — including ones with
+ * extra keys, missing keys, or out-of-range enum values — are dropped and
+ * counted, never thrown. Records tagged with a `routerVersion` other than the
+ * target version are also dropped and counted (never merged across router
+ * versions into one snapshot). An empty or all-dropped input compiles to an
+ * empty-bias snapshot (`biasCells: []`), which is exactly the shipped
+ * no-learning behavior — this makes "empty ledger -> zero bias" true by
+ * construction, not by a special case.
+ *
+ * Pure: same `records` (any order) -> same `RouterBiasSnapshot` (byte-
+ * identical `JSON.stringify` output), because cells are grouped by an
+ * order-independent key and the emitted cell/record ordering is always
+ * sorted before serialization.
+ */
+export declare function compileBiasSnapshot(records: readonly unknown[], options?: CompileBiasSnapshotOptions): RouterBiasSnapshot;
+/** Look up the compiled bias for one feature cell; 0 (no bias) when the cell is absent from the snapshot. */
+export declare function getBiasStepsForCell(snapshot: RouterBiasSnapshot, key: RouterBiasCellKey): RouterBiasSteps;
+/**
+ * Strict runtime validator for one compiled bias cell. Exact eight-key
+ * allowlist plus bounded per-field checks, reusing the same closed enums as
+ * `isRouterFeedbackRecord` (`ROUTER_FEEDBACK_TASK_CLASSES`,
+ * `ROUTER_FEEDBACK_LANE_TYPES`, `ROUTER_FEEDBACK_LEN_BUCKETS`) so this
+ * validator cannot silently drift from the ledger's own schema. `nStrong` is
+ * additionally required to never exceed `nTotal` (true by construction for
+ * every cell `compileBiasSnapshot` can produce; a cheap sanity bound against
+ * a hand-tampered file).
+ */
+export declare function isRouterBiasCell(value: unknown): value is RouterBiasCell;
+/**
+ * Strict runtime validator for a compiled bias snapshot. Exact five-key
+ * allowlist; `biasCells` must be an array whose every element passes
+ * `isRouterBiasCell`. Never trusts on-disk content: any unexpected shape,
+ * extra key, or out-of-range value returns `false` rather than throwing.
+ */
+export declare function isRouterBiasSnapshot(value: unknown): value is RouterBiasSnapshot;
+/**
+ * Safe parse of raw (untrusted, e.g. on-disk) JSON text into a validated
+ * `RouterBiasSnapshot`. Never throws: malformed JSON or any schema violation
+ * returns `null`. Performs no filesystem access itself — callers own the
+ * actual read — so this module's zero-I/O determinism guarantee for
+ * `compileBiasSnapshot`/`getBiasStepsForCell` is unaffected.
+ */
+export declare function parseRouterBiasSnapshot(raw: string): RouterBiasSnapshot | null;
+/**
+ * Default compiled-bias-snapshot path:
+ * `<agentDir>/router-feedback/weights/router-bias-snapshot.<version>.json` —
+ * matches `compile-bias-snapshot.ts`'s own default `--out` naming exactly, so
+ * a snapshot compiled offline for `version` is found here with no extra
+ * configuration. Owner-only agent dir, never repo-local (mirrors
+ * `getDefaultRouterFeedbackLedgerPath`). Defaults to "v4", the router version
+ * this lane wires bias *consumption* for.
+ */
+export declare function getDefaultRouterBiasSnapshotPath(version?: RouterFeedbackVersion): string;
+//# sourceMappingURL=reasoning-router-bias.d.ts.map

package/dist/core/reasoning-router-bias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-router-bias.d.ts","sourceRoot":"","sources":["../../src/core/reasoning-router-bias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAKN,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAE5B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,MAAM,gCAAgC,CAAC;AAExC,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,2GAA2G;AAC3G,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,8GAA4G;AAC5G,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,oGAAoG;IACpG,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iGAAiG;IACjG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,iHAAiH;IACjH,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAgDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,GAAE,0BAA+B,GACtC,kBAAkB,CA0DpB;AAED,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAMzG;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAaxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAYhF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAQ9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,qBAA4B,GAAG,MAAM,CAE9F","sourcesContent":["/**\n * Reasoning-router bias compiler — Goal 009 Wave 1 Lane L (privacy-safe learning ledger).\n *\n * Pure, deterministic compiler from a set of privacy-safe feedback records\n * (see router-feedback-collector.ts) to a bounded, per-cell reasoning-level\n * bias snapshot. No clock, randomness, network, or model calls: the same\n * input array always produces the same output (`JSON.stringify` byte-\n * identical), regardless of input record order. This module is a standalone,\n * pure utility — nothing here is wired into a router resolver or\n * agent-session.ts by this lane.\n *\n * Goal 010 Lane I addition: `isRouterBiasCell` / `isRouterBiasSnapshot` /\n * `parseRouterBiasSnapshot` / `getDefaultRouterBiasSnapshotPath` below let a\n * (now opt-in) caller safely load a snapshot this module previously only\n * wrote. `parseRouterBiasSnapshot` performs no filesystem access itself — it\n * only validates already-read text — so this module's zero-I/O determinism\n * guarantee for `compileBiasSnapshot`/`getBiasStepsForCell` is unchanged; the\n * actual disk read lives in agent-session.ts.\n */\n\nimport { createHash } from \"crypto\";\nimport { join } from \"path\";\nimport { getAgentDir } from \"../config.ts\";\nimport {\n\tisRouterFeedbackRecord,\n\tROUTER_FEEDBACK_LANE_TYPES,\n\tROUTER_FEEDBACK_LEN_BUCKETS,\n\tROUTER_FEEDBACK_TASK_CLASSES,\n\ttype RouterFeedbackLaneType,\n\ttype RouterFeedbackLenBucket,\n\ttype RouterFeedbackRecord,\n\ttype RouterFeedbackTaskClass,\n\ttype RouterFeedbackVersion,\n} from \"./router-feedback-collector.ts\";\n\n/** Minimum non-neutral (\"strong\") record count per cell before any bias applies. */\nexport const BIAS_STRONG_THRESHOLD = 5;\n\n/** Bias magnitude bound, matching the resolver's existing bias clamp (reasoning-router-v2.ts BIAS_MAX). */\nexport const BIAS_MAX_STEPS = 2;\n\n/** Bounded per-cell bias, in ladder steps. Never outside [-2, 2]. */\nexport type RouterBiasSteps = -2 | -1 | 0 | 1 | 2;\n\n/** The feature tuple a bias cell is keyed on — identical dimensions the router already computes locally. */\nexport interface RouterBiasCellKey {\n\treadonly predictedClass: RouterFeedbackTaskClass;\n\treadonly laneType: RouterFeedbackLaneType;\n\treadonly lenBucket: RouterFeedbackLenBucket;\n\treadonly hadFence: boolean;\n\treadonly hadDiff: boolean;\n}\n\nexport interface RouterBiasCell extends RouterBiasCellKey {\n\treadonly biasSteps: RouterBiasSteps;\n\t/** Non-neutral (up/down-signaling) record count for this cell. */\n\treadonly nStrong: number;\n\t/** Total record count for this cell, including neutral (accepted/same/pass) records. */\n\treadonly nTotal: number;\n}\n\nexport interface RouterBiasSnapshot {\n\treadonly schemaVersion: \"router-bias-snapshot/v1\";\n\t/** sha256 hex digest of the canonicalized valid-record set actually compiled; not a prompt hash. */\n\treadonly sourceRecordDigest: string;\n\t/** Count of records that were validated and included in this snapshot. */\n\treadonly consideredCount: number;\n\t/** Count of records excluded from this snapshot (schema-invalid, or router-version mismatch). */\n\treadonly droppedCount: number;\n\t/** Bias cells, sorted deterministically. Empty when there is no ledger data or no cell reaches the threshold. */\n\treadonly biasCells: readonly RouterBiasCell[];\n}\n\nexport interface CompileBiasSnapshotOptions {\n\t/**\n\t * Restrict compilation to one router version — `compileBiasSnapshot` never\n\t * mixes records from different router versions into one snapshot. Records\n\t * tagged with any other `routerVersion` are excluded from this snapshot and\n\t * counted in `droppedCount`. Defaults to \"v3\" for API compatibility; the\n\t * offline CLI now defaults to \"v4\", matching the only auto-router wired to\n\t * consume a learning-bias snapshot at runtime.\n\t */\n\treadonly routerVersion?: RouterFeedbackVersion;\n}\n\nfunction cellKeyString(key: RouterBiasCellKey): string {\n\treturn [key.predictedClass, key.laneType, String(key.lenBucket), String(key.hadFence), String(key.hadDiff)].join(\n\t\t\"|\",\n\t);\n}\n\n/** +1 \"needed more effort\", -1 \"needed less effort\", 0 neutral (no directional bias contribution). */\nfunction outcomeDirection(outcome: RouterFeedbackRecord[\"outcome\"]): -1 | 0 | 1 {\n\tif (outcome === \"up\" || outcome === \"fail\" || outcome === \"debug-follow-up\") return 1;\n\tif (outcome === \"down\") return -1;\n\treturn 0;\n}\n\n/** Fixed-key-order JSON so identical records always canonicalize to identical bytes. */\nfunction canonicalRecordJson(record: RouterFeedbackRecord): string {\n\treturn JSON.stringify({\n\t\trouterVersion: record.routerVersion,\n\t\tlaneType: record.laneType,\n\t\tpredictedClass: record.predictedClass,\n\t\tresolvedLevel: record.resolvedLevel,\n\t\tacceptedLevel: record.acceptedLevel,\n\t\tsignal: record.signal,\n\t\toutcome: record.outcome,\n\t\tlenBucket: record.lenBucket,\n\t\thadFence: record.hadFence,\n\t\thadDiff: record.hadDiff,\n\t});\n}\n\ninterface CellAccumulator extends RouterBiasCellKey {\n\tnTotal: number;\n\tupVotes: number;\n\tdownVotes: number;\n}\n\nfunction computeBiasSteps(upVotes: number, downVotes: number, nStrong: number): RouterBiasSteps {\n\tif (nStrong < BIAS_STRONG_THRESHOLD) return 0;\n\tconst majority = upVotes - downVotes;\n\tif (majority === 0) return 0;\n\n\tconst dominance = Math.abs(majority) / nStrong;\n\tconst magnitude = dominance >= 0.75 ? BIAS_MAX_STEPS : 1;\n\tconst signedMagnitude = majority > 0 ? magnitude : -magnitude;\n\treturn Math.max(-BIAS_MAX_STEPS, Math.min(BIAS_MAX_STEPS, signedMagnitude)) as RouterBiasSteps;\n}\n\n/**\n * Deterministically compile a bounded bias snapshot from raw (possibly\n * malformed) ledger entries. Unknown-shaped entries — including ones with\n * extra keys, missing keys, or out-of-range enum values — are dropped and\n * counted, never thrown. Records tagged with a `routerVersion` other than the\n * target version are also dropped and counted (never merged across router\n * versions into one snapshot). An empty or all-dropped input compiles to an\n * empty-bias snapshot (`biasCells: []`), which is exactly the shipped\n * no-learning behavior — this makes \"empty ledger -> zero bias\" true by\n * construction, not by a special case.\n *\n * Pure: same `records` (any order) -> same `RouterBiasSnapshot` (byte-\n * identical `JSON.stringify` output), because cells are grouped by an\n * order-independent key and the emitted cell/record ordering is always\n * sorted before serialization.\n */\nexport function compileBiasSnapshot(\n\trecords: readonly unknown[],\n\toptions: CompileBiasSnapshotOptions = {},\n): RouterBiasSnapshot {\n\tconst routerVersion = options.routerVersion ?? \"v3\";\n\tconst valid: RouterFeedbackRecord[] = [];\n\tlet droppedCount = 0;\n\n\tfor (const entry of records) {\n\t\tif (isRouterFeedbackRecord(entry) && entry.routerVersion === routerVersion) {\n\t\t\tvalid.push(entry);\n\t\t} else {\n\t\t\tdroppedCount += 1;\n\t\t}\n\t}\n\n\tconst cells = new Map<string, CellAccumulator>();\n\tfor (const record of valid) {\n\t\tconst key: RouterBiasCellKey = {\n\t\t\tpredictedClass: record.predictedClass,\n\t\t\tlaneType: record.laneType,\n\t\t\tlenBucket: record.lenBucket,\n\t\t\thadFence: record.hadFence,\n\t\t\thadDiff: record.hadDiff,\n\t\t};\n\t\tconst mapKey = cellKeyString(key);\n\t\tconst existing = cells.get(mapKey) ?? { ...key, nTotal: 0, upVotes: 0, downVotes: 0 };\n\t\texisting.nTotal += 1;\n\t\tconst direction = outcomeDirection(record.outcome);\n\t\tif (direction === 1) existing.upVotes += 1;\n\t\telse if (direction === -1) existing.downVotes += 1;\n\t\tcells.set(mapKey, existing);\n\t}\n\n\tconst biasCells: RouterBiasCell[] = [];\n\tfor (const mapKey of [...cells.keys()].sort()) {\n\t\tconst acc = cells.get(mapKey);\n\t\tif (!acc) continue;\n\t\tconst nStrong = acc.upVotes + acc.downVotes;\n\t\tbiasCells.push({\n\t\t\tpredictedClass: acc.predictedClass,\n\t\t\tlaneType: acc.laneType,\n\t\t\tlenBucket: acc.lenBucket,\n\t\t\thadFence: acc.hadFence,\n\t\t\thadDiff: acc.hadDiff,\n\t\t\tbiasSteps: computeBiasSteps(acc.upVotes, acc.downVotes, nStrong),\n\t\t\tnStrong,\n\t\t\tnTotal: acc.nTotal,\n\t\t});\n\t}\n\n\tconst canonicalValid = valid.map(canonicalRecordJson).sort();\n\tconst sourceRecordDigest = createHash(\"sha256\").update(canonicalValid.join(\"\\n\")).digest(\"hex\");\n\n\treturn {\n\t\tschemaVersion: \"router-bias-snapshot/v1\",\n\t\tsourceRecordDigest,\n\t\tconsideredCount: valid.length,\n\t\tdroppedCount,\n\t\tbiasCells,\n\t};\n}\n\n/** Look up the compiled bias for one feature cell; 0 (no bias) when the cell is absent from the snapshot. */\nexport function getBiasStepsForCell(snapshot: RouterBiasSnapshot, key: RouterBiasCellKey): RouterBiasSteps {\n\tconst wantKey = cellKeyString(key);\n\tfor (const cell of snapshot.biasCells) {\n\t\tif (cellKeyString(cell) === wantKey) return cell.biasSteps;\n\t}\n\treturn 0;\n}\n\n// ============================================================================\n// Snapshot parser / loader (Goal 010 Lane I)\n// ============================================================================\n//\n// Everything below lets a caller safely turn untrusted on-disk JSON text into\n// a validated RouterBiasSnapshot. Same posture as isRouterFeedbackRecord in\n// router-feedback-collector.ts: an exact positive key-set allowlist (not a\n// denylist), bounded per-field checks reusing the ledger's own closed enums,\n// and \"never throw, return null/false instead\" on any malformed input.\n\n/** Bounded bias-step values a compiled cell may carry; mirrors RouterBiasSteps. */\nconst ROUTER_BIAS_STEPS_VALUES: readonly RouterBiasSteps[] = [-2, -1, 0, 1, 2];\n\n/** Exact allowed key set for one compiled `RouterBiasCell`, sorted for canonical set-equality comparison. */\nconst ROUTER_BIAS_CELL_KEYS: readonly string[] = [\n\t\"predictedClass\",\n\t\"laneType\",\n\t\"lenBucket\",\n\t\"hadFence\",\n\t\"hadDiff\",\n\t\"biasSteps\",\n\t\"nStrong\",\n\t\"nTotal\",\n].sort();\n\n/** Exact allowed key set for a `RouterBiasSnapshot`, sorted for canonical set-equality comparison. */\nconst ROUTER_BIAS_SNAPSHOT_KEYS: readonly string[] = [\n\t\"schemaVersion\",\n\t\"sourceRecordDigest\",\n\t\"consideredCount\",\n\t\"droppedCount\",\n\t\"biasCells\",\n].sort();\n\n/** sha256 hex digest shape check for `sourceRecordDigest` (never trusts the value is actually a real digest of anything, only that it has the right shape). */\nconst SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction hasExactKeySet(value: Record<string, unknown>, allowedSortedKeys: readonly string[]): boolean {\n\tconst keys = Object.keys(value).sort();\n\tif (keys.length !== allowedSortedKeys.length) return false;\n\tfor (let i = 0; i < keys.length; i++) {\n\t\tif (keys[i] !== allowedSortedKeys[i]) return false;\n\t}\n\treturn true;\n}\n\nfunction isBoundedNonNegativeInteger(value: unknown): value is number {\n\treturn typeof value === \"number\" && Number.isInteger(value) && value >= 0;\n}\n\n/**\n * Strict runtime validator for one compiled bias cell. Exact eight-key\n * allowlist plus bounded per-field checks, reusing the same closed enums as\n * `isRouterFeedbackRecord` (`ROUTER_FEEDBACK_TASK_CLASSES`,\n * `ROUTER_FEEDBACK_LANE_TYPES`, `ROUTER_FEEDBACK_LEN_BUCKETS`) so this\n * validator cannot silently drift from the ledger's own schema. `nStrong` is\n * additionally required to never exceed `nTotal` (true by construction for\n * every cell `compileBiasSnapshot` can produce; a cheap sanity bound against\n * a hand-tampered file).\n */\nexport function isRouterBiasCell(value: unknown): value is RouterBiasCell {\n\tif (!isPlainObject(value)) return false;\n\tif (!hasExactKeySet(value, ROUTER_BIAS_CELL_KEYS)) return false;\n\tif (!ROUTER_FEEDBACK_TASK_CLASSES.includes(value.predictedClass as RouterFeedbackTaskClass)) return false;\n\tif (!ROUTER_FEEDBACK_LANE_TYPES.includes(value.laneType as RouterFeedbackLaneType)) return false;\n\tif (!ROUTER_FEEDBACK_LEN_BUCKETS.includes(value.lenBucket as RouterFeedbackLenBucket)) return false;\n\tif (typeof value.hadFence !== \"boolean\") return false;\n\tif (typeof value.hadDiff !== \"boolean\") return false;\n\tif (!ROUTER_BIAS_STEPS_VALUES.includes(value.biasSteps as RouterBiasSteps)) return false;\n\tif (!isBoundedNonNegativeInteger(value.nStrong)) return false;\n\tif (!isBoundedNonNegativeInteger(value.nTotal)) return false;\n\tif ((value.nStrong as number) > (value.nTotal as number)) return false;\n\treturn true;\n}\n\n/**\n * Strict runtime validator for a compiled bias snapshot. Exact five-key\n * allowlist; `biasCells` must be an array whose every element passes\n * `isRouterBiasCell`. Never trusts on-disk content: any unexpected shape,\n * extra key, or out-of-range value returns `false` rather than throwing.\n */\nexport function isRouterBiasSnapshot(value: unknown): value is RouterBiasSnapshot {\n\tif (!isPlainObject(value)) return false;\n\tif (!hasExactKeySet(value, ROUTER_BIAS_SNAPSHOT_KEYS)) return false;\n\tif (value.schemaVersion !== \"router-bias-snapshot/v1\") return false;\n\tif (typeof value.sourceRecordDigest !== \"string\" || !SHA256_HEX_PATTERN.test(value.sourceRecordDigest)) return false;\n\tif (!isBoundedNonNegativeInteger(value.consideredCount)) return false;\n\tif (!isBoundedNonNegativeInteger(value.droppedCount)) return false;\n\tif (!Array.isArray(value.biasCells)) return false;\n\tfor (const cell of value.biasCells) {\n\t\tif (!isRouterBiasCell(cell)) return false;\n\t}\n\treturn true;\n}\n\n/**\n * Safe parse of raw (untrusted, e.g. on-disk) JSON text into a validated\n * `RouterBiasSnapshot`. Never throws: malformed JSON or any schema violation\n * returns `null`. Performs no filesystem access itself — callers own the\n * actual read — so this module's zero-I/O determinism guarantee for\n * `compileBiasSnapshot`/`getBiasStepsForCell` is unaffected.\n */\nexport function parseRouterBiasSnapshot(raw: string): RouterBiasSnapshot | null {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch {\n\t\treturn null;\n\t}\n\treturn isRouterBiasSnapshot(parsed) ? parsed : null;\n}\n\n/**\n * Default compiled-bias-snapshot path:\n * `<agentDir>/router-feedback/weights/router-bias-snapshot.<version>.json` —\n * matches `compile-bias-snapshot.ts`'s own default `--out` naming exactly, so\n * a snapshot compiled offline for `version` is found here with no extra\n * configuration. Owner-only agent dir, never repo-local (mirrors\n * `getDefaultRouterFeedbackLedgerPath`). Defaults to \"v4\", the router version\n * this lane wires bias *consumption* for.\n */\nexport function getDefaultRouterBiasSnapshotPath(version: RouterFeedbackVersion = \"v4\"): string {\n\treturn join(getAgentDir(), \"router-feedback\", \"weights\", `router-bias-snapshot.${version}.json`);\n}\n"]}