@productbrain/cli 0.1.0-beta.22 → 0.1.0-beta.2200

package/dist/formatters/update.js

@@ -2,6 +2,7 @@
  * Update receipt formatter — terminal output for pb update.
  * BET-192 / FEAT-575: Added normalization + validation warning rendering.
  */
+import { formatCoachingSection } from './coaching.js';
 export function formatUpdateReceipt(data) {
     const lines = [];
     // Summary line
@@ -38,6 +39,9 @@ export function formatUpdateReceipt(data) {
             lines.push(`    - ${warning}`);
         }
     }
+    // WP-475 E1: rubric coaching verdict — advisory, never blocking (BR-144).
+    // Passive tiers / empty rubrics render nothing (zero-noise floor).
+    lines.push(...formatCoachingSection(data.coaching));
     lines.push('');
     lines.push(`  View: pb get ${data.entryId}`);
     return lines.join('\n');

package/dist/formatters/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/formatters/update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,eAAe;IACf,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,IAAI,GAAG;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhF,SAAS;IACT,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,0FAA0F;IAC1F,0EAA0E;IAC1E,IAAI,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,kFAAkF;IAClF,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAE7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/formatters/update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAuB,MAAM,eAAe,CAAC;AAgB3E,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,eAAe;IACf,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,IAAI,GAAG;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhF,SAAS;IACT,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,0FAA0F;IAC1F,0EAA0E;IAC1E,IAAI,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,kFAAkF;IAClF,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAE7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/formatters/verify.d.ts

@@ -1,11 +1,19 @@
-/**
- * Verify receipt formatter — terminal output for pb verify.
- * BET-240 E1: Verification status for chain entries.
- */
 export interface VerifyReceiptData {
     entryId: string;
     verificationStatus: 'verified';
     alreadyVerified: boolean;
+    /** WP-A T8: server-shipped honest label (Task 4/5). Never re-derived client-side (spec §5). */
+    verifiedBy?: string;
+    /**
+     * WP-A T8: server-shipped attestation strength/basis (Task 4/5). Optional — old server
+     * omits it (spec §11). `basis` mirrors formatters/entry.ts: 'attested' or a 'legacy-*'
+     * class (Finding 1, PR #341 review) — used to render legacy verifiedBy strings as a
+     * qualifier, never as "— by <legacy string>".
+     */
+    attestation?: {
+        strength: string;
+        basis?: string;
+    };
 }
 export declare function formatVerifyReceipt(data: VerifyReceiptData): string;
 //# sourceMappingURL=verify.d.ts.map

package/dist/formatters/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/formatters/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAKnE"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/formatters/verify.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAqBnE"}

package/dist/formatters/verify.js

@@ -2,10 +2,28 @@
  * Verify receipt formatter — terminal output for pb verify.
  * BET-240 E1: Verification status for chain entries.
  */
+import { stripControlChars } from '../lib/strip.js';
 export function formatVerifyReceipt(data) {
+    // BET-269 C3: stripControlChars on all user-controlled strings before terminal output
+    // (Finding 2, PR #341 review) — verifiedBy is server-provided and may echo a workspace
+    // member's displayName/email.
+    const s = stripControlChars;
+    let who = '';
+    if (data.verifiedBy && data.attestation) {
+        // Final-review Fix 1 mirror (formatters/entry.ts): a non-'attested' basis (the
+        // pre-branch legacy corpus, spec §7.1) renders the honest legacy qualifier instead of
+        // "— by X (strength)" — the shipped verifiedBy is already the resolved legacy string
+        // ("legacy — unclassified").
+        if (data.attestation.basis && data.attestation.basis !== 'attested') {
+            who = ` (${s(data.verifiedBy)})`;
+        }
+        else {
+            who = ` — by ${s(data.verifiedBy)} (${s(data.attestation.strength)})`;
+        }
+    }
     if (data.alreadyVerified) {
-        return `${data.entryId} is already verified.`;
+        return `${data.entryId} is already verified${who}.`;
     }
-    return `Verified ${data.entryId}. Status: verified.`;
+    return `Verified ${data.entryId}${who}.`;
 }
 //# sourceMappingURL=verify.js.map

package/dist/formatters/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/formatters/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC,OAAO,uBAAuB,CAAC;IAChD,CAAC;IACD,OAAO,YAAY,IAAI,CAAC,OAAO,qBAAqB,CAAC;AACvD,CAAC"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/formatters/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAiBpD,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,sFAAsF;IACtF,uFAAuF;IACvF,8BAA8B;IAC9B,MAAM,CAAC,GAAG,iBAAiB,CAAC;IAC5B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACxC,+EAA+E;QAC/E,sFAAsF;QACtF,qFAAqF;QACrF,6BAA6B;QAC7B,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACpE,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC;QACxE,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC,OAAO,uBAAuB,GAAG,GAAG,CAAC;IACtD,CAAC;IACD,OAAO,YAAY,IAAI,CAAC,OAAO,GAAG,GAAG,GAAG,CAAC;AAC3C,CAAC"}

package/dist/generated/healthGapKinds.generated.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source of truth: `convex/lib/healthGap.ts` (WP-480 S2, FEAT-1359).
+ * Regenerate via: `npm run codegen` from `packages/cli`.
+ *
+ * Drift guard: src/__tests__/health-gap-kinds-drift.test.ts re-extracts
+ * the kinds from the source and fails CI when this file is stale.
+ */
+export declare const HEALTH_GAP_KINDS: readonly ["workspace-missing", "starter-setup-missing", "platform-domains-missing", "system-entries-missing", "system-collection-definitions-missing", "glossary-keys-missing", "semantic-types-missing", "team-missing", "projected-methods-missing", "authority-domain-degraded", "import-flow-defaults-missing", "occurredAt-backfill-pending"];
+export type HealthGapKind = (typeof HEALTH_GAP_KINDS)[number];
+//# sourceMappingURL=healthGapKinds.generated.d.ts.map

package/dist/generated/healthGapKinds.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthGapKinds.generated.d.ts","sourceRoot":"","sources":["../../src/generated/healthGapKinds.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,gBAAgB,oVAanB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/generated/healthGapKinds.generated.js

@@ -0,0 +1,24 @@
+/**
+ * GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source of truth: `convex/lib/healthGap.ts` (WP-480 S2, FEAT-1359).
+ * Regenerate via: `npm run codegen` from `packages/cli`.
+ *
+ * Drift guard: src/__tests__/health-gap-kinds-drift.test.ts re-extracts
+ * the kinds from the source and fails CI when this file is stale.
+ */
+export const HEALTH_GAP_KINDS = [
+    'workspace-missing',
+    'starter-setup-missing',
+    'platform-domains-missing',
+    'system-entries-missing',
+    'system-collection-definitions-missing',
+    'glossary-keys-missing',
+    'semantic-types-missing',
+    'team-missing',
+    'projected-methods-missing',
+    'authority-domain-degraded',
+    'import-flow-defaults-missing',
+    'occurredAt-backfill-pending',
+];
+//# sourceMappingURL=healthGapKinds.generated.js.map

package/dist/generated/healthGapKinds.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthGapKinds.generated.js","sourceRoot":"","sources":["../../src/generated/healthGapKinds.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,mBAAmB;IACnB,uBAAuB;IACvB,0BAA0B;IAC1B,wBAAwB;IACxB,uCAAuC;IACvC,uBAAuB;IACvB,wBAAwB;IACxB,cAAc;IACd,2BAA2B;IAC3B,2BAA2B;IAC3B,8BAA8B;IAC9B,6BAA6B;CACpB,CAAC"}

package/dist/generators/adapters.d.ts

@@ -41,4 +41,37 @@ export interface CopilotMdOptions {
     }>;
 }
 export declare function generateCopilotMd(timestamp: string, options?: CopilotMdOptions): string;
+/** Minimal canonical-rule shape needed to project a path-scoped Copilot instruction file. */
+export interface CopilotInstructionRule {
+    name: string;
+    body: string;
+    /** Path-scope glob, e.g. "convex/**\/*.ts". Rules without it are repo-wide, not projected here. */
+    applyTo?: string;
+    /** Provenance (filesystem path or `db:<ENTRY-ID>`) — emitted as a breadcrumb comment only. */
+    sourcePath?: string;
+}
+export interface GeneratedInstructionFile {
+    /** Path relative to repo root, e.g. ".github/instructions/security-boundaries.instructions.md". */
+    relativePath: string;
+    content: string;
+}
+/**
+ * Project path-scoped GitHub Copilot instruction files from canonical rules.
+ *
+ * One `.github/instructions/<slug>.instructions.md` per rule that declares `applyTo`. Each file
+ * carries the `applyTo` frontmatter, the full rule body, and the pb-handshake MARKER.
+ *
+ * DECISION (DEC-1343, as refined): the committed `.github/instructions/*.instructions.md` are
+ * hand-maintained SSOT and carry NO MARKER, so handshake classifies them as user-owned and leaves
+ * them untouched (`shouldWriteAdapter`). This generator therefore only MATERIALIZES a file — with
+ * the MARKER, marking it pb-managed — when a Chain rule declares `applyTo` AND no committed file
+ * already occupies that path. On this repo no Chain rule declares `applyTo`, so it emits nothing
+ * and never dirties the tree; the path-scoped review files are the hand-authored committed ones.
+ *
+ * A provenance breadcrumb records the source entry/path WITHOUT requiring the consumer to resolve
+ * it: Copilot code review is pb-blind, so the body is inlined and the id is reference-only
+ * (DEC-1343 / INS-1969). Basenames are de-duped deterministically so two rules never clobber one
+ * file.
+ */
+export declare function generateCopilotInstructionFiles(rules: CopilotInstructionRule[], timestamp: string): GeneratedInstructionFile[];
 //# sourceMappingURL=adapters.d.ts.map

package/dist/generators/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,QAAA,MAAM,MAAM,mCAAmC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAgFrF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAsCpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAkCrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAuIvF"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,QAAA,MAAM,MAAM,mCAAmC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAgFrF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAsCpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAkCrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA0IvF;AAUD,6FAA6F;AAC7F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,sBAAsB,EAAE,EAC/B,SAAS,EAAE,MAAM,GAChB,wBAAwB,EAAE,CAiC5B"}

package/dist/generators/adapters.js

@@ -79,7 +79,7 @@ pb capture "INS: learned that X"
 
 Close with \`pb session close\` — reviews what was captured, refreshes context for the next session.
 
-All captures are drafts. The human reviews and commits in Product Brain Studio.
+All captures are drafts. The human reviews and accepts in Cortex.
 ${skillsSection}
 ## Governance Summary
 
@@ -122,7 +122,7 @@ pb capture "INS: learned that X"
 
 Close with \`pb session close\` — reviews what was captured, refreshes context for the next session.
 
-All captures are drafts. The human reviews and commits in Product Brain Studio.
+All captures are drafts. The human reviews and accepts in Cortex.
 `;
 }
 export function generateCursorMdc(timestamp, profile) {
@@ -155,7 +155,7 @@ Start with \`pb session start\`. When you make a decision, discover a tension, o
 - \`pb capture "TEN: description"\` — capture a tension
 - \`pb capture "DEC: decided X because Y"\` — capture a decision
 - \`pb capture "INS: learned that X"\` — capture an insight
-Close with \`pb session close\`. All captures are drafts — human reviews and commits.
+Close with \`pb session close\`. All captures are drafts — human reviews and accepts.
 
 <!-- ${MARKER} — ${timestamp} -->
 `;
@@ -207,7 +207,7 @@ Before substantive implementation, review, diagnosis, or security-sensitive reas
 ## Session lifecycle — close the loop
 
 Start with \`pb session start\`. Capture knowledge during work with \`pb capture "text"\`.
-Close with \`pb session close\`. All captures are drafts — human reviews and commits.
+Close with \`pb session close\`. All captures are drafts — human reviews and accepts.
 `;
     // When no enrichment options provided, return base for backward compat
     if (!skills?.length && !rules?.length) {
@@ -249,42 +249,102 @@ Close with \`pb session close\`. All captures are drafts — human reviews and c
         // Everything fits — no truncation needed
         return base + allChunksText;
     }
-    // Need to truncate. Try adding chunks one by one, reserving budget for the truncation note.
-    // We skip section headers (index 0 of skillChunks and index 0 of ruleChunks) if there are
-    // no item chunks that follow — but for simplicity, we include section headers as chunks and
-    // let the budget math handle them.
-    let accumulated = base;
-    let i = 0;
-    // Count total "items" (non-header chunks) for the omission note
-    // Headers are chunks whose content starts with '\n## '
+    // Need to truncate. Greedy approach: keep adding chunks while they fit,
+    // always reserving space for the worst-case truncation note.
     const isHeader = (c) => c.trimStart().startsWith('## ');
     const itemCount = allChunks.filter((c) => !isHeader(c)).length;
+    // Worst-case note reserves for the maximum possible omission count
+    const worstCaseNoteLen = truncationNote(itemCount).length;
+    let accumulated = base;
     let fittedItemCount = 0;
-    while (i < allChunks.length) {
+    for (let i = 0; i < allChunks.length; i++) {
         const chunk = allChunks[i];
         const remaining = allChunks.slice(i + 1).join('');
-        const noteLen = itemCount - fittedItemCount > 0 ? truncationNote(itemCount - fittedItemCount).length : 0;
-        if (accumulated.length + chunk.length + remaining.length + noteLen <= budget) {
-            // Everything from here fits — just append the rest
+        // If everything from here fits without any note, append and done
+        if (accumulated.length + chunk.length + remaining.length <= budget) {
             accumulated += allChunks.slice(i).join('');
             fittedItemCount = itemCount;
             break;
         }
-        if (accumulated.length + chunk.length + noteLen <= budget) {
+        // Does this chunk fit if we reserve space for the worst-case note?
+        if (accumulated.length + chunk.length + worstCaseNoteLen <= budget) {
             accumulated += chunk;
             if (!isHeader(chunk))
                 fittedItemCount++;
-            i++;
         }
         else {
-            // This chunk doesn't fit even with just the note — stop
             break;
         }
     }
     omittedCount = itemCount - fittedItemCount;
     if (omittedCount > 0) {
-        accumulated += truncationNote(omittedCount);
+        const note = truncationNote(omittedCount);
+        // Only append the note if it fits within budget; if the base alone
+        // nearly fills the budget, omit the note to honour the hard cap.
+        if (accumulated.length + note.length <= budget) {
+            accumulated += note;
+        }
     }
     return accumulated;
 }
+/** Slugify a rule name into a filesystem-safe instruction-file basename. */
+function instructionSlug(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'rule');
+}
+/**
+ * Project path-scoped GitHub Copilot instruction files from canonical rules.
+ *
+ * One `.github/instructions/<slug>.instructions.md` per rule that declares `applyTo`. Each file
+ * carries the `applyTo` frontmatter, the full rule body, and the pb-handshake MARKER.
+ *
+ * DECISION (DEC-1343, as refined): the committed `.github/instructions/*.instructions.md` are
+ * hand-maintained SSOT and carry NO MARKER, so handshake classifies them as user-owned and leaves
+ * them untouched (`shouldWriteAdapter`). This generator therefore only MATERIALIZES a file — with
+ * the MARKER, marking it pb-managed — when a Chain rule declares `applyTo` AND no committed file
+ * already occupies that path. On this repo no Chain rule declares `applyTo`, so it emits nothing
+ * and never dirties the tree; the path-scoped review files are the hand-authored committed ones.
+ *
+ * A provenance breadcrumb records the source entry/path WITHOUT requiring the consumer to resolve
+ * it: Copilot code review is pb-blind, so the body is inlined and the id is reference-only
+ * (DEC-1343 / INS-1969). Basenames are de-duped deterministically so two rules never clobber one
+ * file.
+ */
+export function generateCopilotInstructionFiles(rules, timestamp) {
+    const files = [];
+    const seen = new Set();
+    for (const rule of rules) {
+        if (!rule.applyTo || !rule.applyTo.trim())
+            continue;
+        const slug = instructionSlug(rule.name);
+        let unique = slug;
+        let n = 2;
+        while (seen.has(unique))
+            unique = `${slug}-${n++}`;
+        seen.add(unique);
+        // Portable provenance: keep a `db:<ID>` reference as-is; reduce a filesystem path to its
+        // basename so a committed file never leaks an absolute, machine-specific path. Split on BOTH
+        // separators — a Windows authoring host yields `C:\…\rules\foo.md`, and splitting on '/' alone
+        // would leak the whole backslash path into committed provenance.
+        const src = rule.sourcePath
+            ? rule.sourcePath.startsWith('db:')
+                ? rule.sourcePath
+                : rule.sourcePath.split(/[/\\]/).pop()
+            : undefined;
+        const provenance = src ? `\n<!-- source: ${src} -->` : '';
+        // The rule body conventionally carries its own H1, so no heading is prepended here.
+        const content = `---
+applyTo: ${JSON.stringify(rule.applyTo.trim())}
+---
+<!-- ${MARKER} — ${timestamp} -->
+<!-- Re-run \`pb handshake\` to refresh. Edit the rule in the Chain, not this file. -->${provenance}
+
+${rule.body.trim()}
+`;
+        files.push({ relativePath: `.github/instructions/${unique}.instructions.md`, content });
+    }
+    return files;
+}
 //# sourceMappingURL=adapters.js.map

package/dist/generators/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,GAAG,gCAAgC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAalB,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAyB;IAC3E,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEnD,0DAA0D;IAC1D,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAC1B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,eAAe,gBAAgB,CAAC,KAAK,MAAM,CAAC,CAAC;QACjG,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC;QACrG,IAAI,gBAAgB,CAAC,cAAc,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,yBAAyB,gBAAgB,CAAC,cAAc,MAAM,CAAC,CAAC;QAC7H,IAAI,gBAAgB,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,YAAY,IAAI,CAAC,CAAC;QACnH,gBAAgB,GAAG;;;;;EAKrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,oEAAoE;IACpE,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/F,OAAO,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,MAAM,QAAQ,IAAI,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,aAAa,GAAG;;;;;EAKlB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;;;EAQpC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BhB,aAAa;;;;CAId,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAwB;IAC1E,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCrC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAwB;IAC3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BF,MAAM,MAAM,SAAS;CAC3B,CAAC;AACF,CAAC;AAcD,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAA0B;IAC7E,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAE7C,0DAA0D;IAC1D,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAC1B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,eAAe,gBAAgB,CAAC,KAAK,MAAM,CAAC,CAAC;QACjG,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC;QACrG,IAAI,gBAAgB,CAAC,cAAc,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,yBAAyB,gBAAgB,CAAC,cAAc,MAAM,CAAC,CAAC;QAC7H,IAAI,gBAAgB,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,YAAY,IAAI,CAAC,CAAC;QACnH,gBAAgB,GAAG;;;;;EAKrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,kFAAkF;IAClF,MAAM,IAAI,GAAG,QAAQ,MAAM,MAAM,SAAS;;;;;;;EAO1C,gBAAgB;;;;;;;;;;;;;;;;;CAiBjB,CAAC;IAEA,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,4CAA4C;IAC5C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,KAAK,GAAG,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC;YAClD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,KAAK,IAAI,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9D,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,+GAA+G;IAC/G,MAAM,SAAS,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC;IAElD,qDAAqD;IACrD,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,qBAAqB,CAAC,yDAAyD,CAAC;IAEtH,qEAAqE;IACrE,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sFAAsF;IACtF,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACjD,yCAAyC;QACzC,OAAO,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;IAED,4FAA4F;IAC5F,0FAA0F;IAC1F,4FAA4F;IAC5F,mCAAmC;IACnC,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,gEAAgE;IAChE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzG,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7E,mDAAmD;YACnD,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,eAAe,GAAG,SAAS,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;YAC1D,WAAW,IAAI,KAAK,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,eAAe,EAAE,CAAC;YACxC,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,MAAM;QACR,CAAC;IACH,CAAC;IAED,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"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"}

package/dist/generators/archetypes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Archetype loader and resolver — BET-286 Slice 2
+ *
+ * Loads archetype templates from packages/cli/templates/archetypes/ and
+ * resolves their {{slot}} placeholders using ClassifiedGovernance entries.
+ * Each resolved archetype produces a CanonicalRule ready to merge into
+ * the canonical rules array.
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration), FEAT-894 (chain:// convention)
+ */
+import type { CanonicalRule } from './portable-knowledge.js';
+import type { ClassifiedGovernance, GovernanceFunction } from './chain-classifier.js';
+/** Parsed archetype template, ready for slot resolution. */
+interface ArchetypeTemplate {
+    functionKey: GovernanceFunction;
+    /** Frontmatter fields */
+    name: string;
+    description: string;
+    autoApply: boolean;
+    level: string;
+    /** Template body with {{slot}} placeholders */
+    body: string;
+}
+/** Result of resolving an archetype against classified governance entries. */
+export interface ResolvedArchetype {
+    /** Ready to merge into the canonical rules array */
+    rule: CanonicalRule;
+    functionKey: GovernanceFunction;
+    /** Which entry IDs contributed to this rule */
+    resolvedEntryIds: string[];
+}
+/** Discriminated reason when resolveArchetype returns null. */
+export type ArchetypeSkipReason = 'no-template' | 'manual-suppression' | 'zero-entries';
+/**
+ * Load the archetype template for a governance function.
+ * Returns null if the function is 'unclassified' or no template file exists.
+ */
+export declare function loadArchetype(functionKey: GovernanceFunction): ArchetypeTemplate | null;
+/**
+ * Resolve an archetype's slots using classified governance entries.
+ *
+ * Returns a discriminated result:
+ * - `{ resolved: ResolvedArchetype }` on success
+ * - `{ skipped: ArchetypeSkipReason }` when the archetype cannot be produced
+ */
+export declare function resolveArchetype(functionKey: GovernanceFunction, classified: ClassifiedGovernance[], manualRuleNames: Set<string>): {
+    resolved: ResolvedArchetype;
+} | {
+    skipped: ArchetypeSkipReason;
+};
+export {};
+//# sourceMappingURL=archetypes.d.ts.map

package/dist/generators/archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../../src/generators/archetypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAItF,4DAA4D;AAC5D,UAAU,iBAAiB;IACzB,WAAW,EAAE,kBAAkB,CAAC;IAChC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,kBAAkB,CAAC;IAChC,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,oBAAoB,GAAG,cAAc,CAAC;AAkDxF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CAkBvF;AA2ED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,kBAAkB,EAC/B,UAAU,EAAE,oBAAoB,EAAE,EAClC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B;IAAE,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAwDpE"}

package/dist/generators/archetypes.js

@@ -0,0 +1,190 @@
+/**
+ * Archetype loader and resolver — BET-286 Slice 2
+ *
+ * Loads archetype templates from packages/cli/templates/archetypes/ and
+ * resolves their {{slot}} placeholders using ClassifiedGovernance entries.
+ * Each resolved archetype produces a CanonicalRule ready to merge into
+ * the canonical rules array.
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration), FEAT-894 (chain:// convention)
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Cap for the inline `{{entry_ids}}` / `{{entry_names}}` reference lists in a generated rule
+ * BODY (TEN-2373 Slice 4). The slots are emitted into agent config; at 4k scale an uncapped
+ * list inlines hundreds of IDs — the INS-1833 flood reappears as all-the-right-entries. The ID
+ * list is a bounded reference index (best-first, overflow signalled), not an exhaustive dump —
+ * the readable surface is the `*_summary` prose (capped at MAX_SUMMARY_LISTED). 25 ≈ 5× that.
+ * Does NOT bound `resolvedEntryIds` or the diff/state path — those keep full provenance.
+ */
+const MAX_RULE_ENTRY_REFS = 25;
+// ── Path resolution ───────────────────────────────────────────────────
+/** Resolved archetypes template directory (relative to this module).
+ *  From dist/generators/archetypes.js → ../../templates/archetypes/
+ */
+const TEMPLATES_DIR = (() => {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return join(__dirname, '..', '..', 'templates', 'archetypes');
+})();
+function parseArchetypeFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { fields: {}, body: raw };
+    const yaml = match[1];
+    const body = match[2] ?? '';
+    const fields = {};
+    for (const line of yaml.split('\n')) {
+        const kv = line.match(/^([\w-]+):\s*(.*)/);
+        if (kv) {
+            fields[kv[1]] = kv[2].trim().replace(/^["']|["']$/g, '');
+        }
+    }
+    return { fields, body };
+}
+// ── Loader ────────────────────────────────────────────────────────────
+/**
+ * Load the archetype template for a governance function.
+ * Returns null if the function is 'unclassified' or no template file exists.
+ */
+export function loadArchetype(functionKey) {
+    if (functionKey === 'unclassified')
+        return null;
+    const filePath = join(TEMPLATES_DIR, `${functionKey}.md`);
+    if (!existsSync(filePath))
+        return null;
+    const raw = readFileSync(filePath, 'utf8');
+    const { fields, body } = parseArchetypeFrontmatter(raw);
+    return {
+        functionKey,
+        name: fields['name'] ?? functionKey,
+        description: fields['description'] ?? '',
+        autoApply: fields['autoApply'] === 'true',
+        level: fields['level'] ?? 'core',
+        body,
+    };
+}
+// ── Slot resolution ───────────────────────────────────────────────────
+/** Replace all {{slot}} placeholders in a string. */
+function resolveSlots(text, slots) {
+    return text.replace(/\{\{(\w+)\}\}/g, (_match, key) => slots[key] ?? _match);
+}
+/** Readable-surface cap for the `*_summary` prose slot. */
+const MAX_SUMMARY_LISTED = 5;
+/**
+ * Rank classified entries best-first for inclusion in a rule's reference lists: highest
+ * confidence first, then highest relation density. Ties preserve input order (JS sort is
+ * stable; input order is the query's deterministic per-collection paging order) — so ranking
+ * only reorders when confidence/density genuinely differ. Pure; does not mutate the input.
+ */
+function rankEntries(entries) {
+    return [...entries].sort((a, b) => {
+        if (b.confidence !== a.confidence)
+            return b.confidence - a.confidence;
+        return b.relations.length - a.relations.length;
+    });
+}
+/**
+ * Build a capped, comma-joined reference list from already-ranked entries, appending a
+ * `…and N more (M total)` suffix when the full set exceeds the cap. `project` selects the
+ * field (entryId or name). Keeps the agent-injected rule body bounded (TEN-2373 Slice 4).
+ */
+function capJoin(ranked, project, limit) {
+    const total = ranked.length;
+    const shown = ranked.slice(0, limit).map(project);
+    if (total <= limit)
+        return shown.join(', ');
+    return `${shown.join(', ')}, …and ${total - limit} more (${total} total)`;
+}
+/**
+ * Build the *_summary slot value from already-ranked entries.
+ * Lists up to MAX_SUMMARY_LISTED entry names (best-first) then "and N more".
+ */
+function buildSummary(entries) {
+    if (entries.length === 0)
+        return '(none)';
+    const names = entries.map((e) => e.name);
+    const listed = names.slice(0, MAX_SUMMARY_LISTED);
+    const remaining = names.length - MAX_SUMMARY_LISTED;
+    const lines = listed.map((n) => `- ${n}`);
+    if (remaining > 0) {
+        lines.push(`- ...and ${remaining} more`);
+    }
+    return lines.join('\n');
+}
+/** Map function key to its summary slot name. */
+function summarySlotName(functionKey) {
+    const map = {
+        constraint: 'constraint_summary',
+        boundary: 'boundary_summary',
+        convention: 'convention_summary',
+        policy: 'policy_summary',
+        workflow: 'workflow_summary',
+        'quality-gate': 'quality_summary',
+    };
+    return map[functionKey] ?? `${functionKey}_summary`;
+}
+// ── Resolver ──────────────────────────────────────────────────────────
+/**
+ * Resolve an archetype's slots using classified governance entries.
+ *
+ * Returns a discriminated result:
+ * - `{ resolved: ResolvedArchetype }` on success
+ * - `{ skipped: ArchetypeSkipReason }` when the archetype cannot be produced
+ */
+export function resolveArchetype(functionKey, classified, manualRuleNames) {
+    const template = loadArchetype(functionKey);
+    if (!template)
+        return { skipped: 'no-template' };
+    // Manual rule suppression: if a manual rule with this name exists, skip
+    if (manualRuleNames.has(template.name))
+        return { skipped: 'manual-suppression' };
+    // Filter to entries matching this function
+    const matching = classified.filter((e) => e.governanceFunction === functionKey);
+    if (matching.length === 0)
+        return { skipped: 'zero-entries' };
+    // Rank best-first once; the body slots show a capped reference index (TEN-2373 Slice 4),
+    // while entry_count and resolvedEntryIds below keep the FULL set (state-of-record provenance).
+    const ranked = rankEntries(matching);
+    const entryIds = capJoin(ranked, (e) => e.entryId, MAX_RULE_ENTRY_REFS);
+    const entryNames = capJoin(ranked, (e) => e.name, MAX_RULE_ENTRY_REFS);
+    const entryCount = String(matching.length);
+    const summary = buildSummary(ranked);
+    const summarySlot = summarySlotName(functionKey);
+    const slots = {
+        entry_ids: entryIds,
+        entry_names: entryNames,
+        entry_count: entryCount,
+        // Populate all summary slots — only the relevant one gets the real summary;
+        // others get empty string so stale placeholders resolve to blank, not wrong data.
+        constraint_summary: '',
+        boundary_summary: '',
+        convention_summary: '',
+        policy_summary: '',
+        workflow_summary: '',
+        quality_summary: '',
+        [summarySlot]: summary,
+    };
+    const resolvedDescription = resolveSlots(template.description, slots);
+    const resolvedBody = resolveSlots(template.body, slots);
+    const rule = {
+        name: template.name,
+        description: resolvedDescription,
+        autoApply: template.autoApply,
+        level: template.level,
+        body: resolvedBody,
+        sourcePath: `chain://${functionKey}`,
+        scope: undefined,
+        targets: undefined,
+    };
+    return {
+        resolved: {
+            rule,
+            functionKey,
+            resolvedEntryIds: matching.map((e) => e.entryId),
+        },
+    };
+}
+//# sourceMappingURL=archetypes.js.map