@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.90

package/dist/formatters/update.js

@@ -21,12 +21,14 @@ export function formatUpdateReceipt(data) {
         lines.push(`  Fields: ${changes.join(', ')}`);
     }
     // BET-192 / FEAT-575: Surface normalization warnings — fields that were rejected/dropped.
+    // BET-271 S1: Include `pb fields` suggestion for rejected field warnings.
     if (data.normalizationWarnings && data.normalizationWarnings.length > 0) {
         lines.push('');
         lines.push('  ⚠ Normalization warnings:');
         for (const warning of data.normalizationWarnings) {
             lines.push(`    - ${warning}`);
         }
+        lines.push(`    Run \`pb fields\` to see valid fields for this entry.`);
     }
     // BET-192 / FEAT-575: Surface validation warnings — missing required fields, etc.
     if (data.validationWarnings && data.validationWarnings.length > 0) {

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,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;IACH,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;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"}

package/dist/formatters/verify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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;
+}
+export declare function formatVerifyReceipt(data: VerifyReceiptData): string;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +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"}

package/dist/formatters/verify.js

@@ -0,0 +1,11 @@
+/**
+ * Verify receipt formatter — terminal output for pb verify.
+ * BET-240 E1: Verification status for chain entries.
+ */
+export function formatVerifyReceipt(data) {
+    if (data.alreadyVerified) {
+        return `${data.entryId} is already verified.`;
+    }
+    return `Verified ${data.entryId}. Status: verified.`;
+}
+//# sourceMappingURL=verify.js.map

package/dist/formatters/verify.js.map

@@ -0,0 +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"}

package/dist/generators/__tests__/surface-profiles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surface-profiles.test.d.ts.map

package/dist/generators/__tests__/surface-profiles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-profiles.test.d.ts","sourceRoot":"","sources":["../../../src/generators/__tests__/surface-profiles.test.ts"],"names":[],"mappings":""}

package/dist/generators/__tests__/surface-profiles.test.js

@@ -0,0 +1,89 @@
+/**
+ * surface-profiles — unit tests.
+ * BET-270 Slice 0: type system + registry.
+ */
+import { describe, expect, it } from 'vitest';
+import { SURFACE_PROFILES, resolveSurfaceProfile } from '../surface-profiles.js';
+// ── Helper ─────────────────────────────────────────────────────────────
+function isValidProfile(profile) {
+    if (!profile || typeof profile !== 'object')
+        return false;
+    const p = profile;
+    return (['batch', 'interactive', 'passive'].includes(p.executionModel) &&
+        ['multi-file', 'single-file'].includes(p.format) &&
+        ['stateless', 'conversational', 'autonomous'].includes(p.sessionModel) &&
+        typeof p.tokenBudget === 'number' &&
+        p.tokenBudget > 0 &&
+        ['orchestrated', 'direct', 'guided'].includes(p.workflowStyle));
+}
+// ── Registry ───────────────────────────────────────────────────────────
+describe('SURFACE_PROFILES registry', () => {
+    it('defines all 4 known targets', () => {
+        expect(Object.keys(SURFACE_PROFILES).sort()).toEqual(['claude', 'codex', 'copilot', 'cursor']);
+    });
+    it.each(['claude', 'cursor', 'codex', 'copilot'])('%s profile has all required fields with correct types', (target) => {
+        expect(isValidProfile(SURFACE_PROFILES[target])).toBe(true);
+    });
+    it('claude profile has correct values', () => {
+        const p = SURFACE_PROFILES.claude;
+        expect(p.executionModel).toBe('interactive');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('conversational');
+        expect(p.tokenBudget).toBe(50000);
+        expect(p.workflowStyle).toBe('orchestrated');
+    });
+    it('cursor profile has correct values', () => {
+        const p = SURFACE_PROFILES.cursor;
+        expect(p.executionModel).toBe('interactive');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('conversational');
+        expect(p.tokenBudget).toBe(50000);
+        expect(p.workflowStyle).toBe('orchestrated');
+    });
+    it('codex profile has correct values', () => {
+        const p = SURFACE_PROFILES.codex;
+        expect(p.executionModel).toBe('batch');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('autonomous');
+        expect(p.tokenBudget).toBe(100000);
+        expect(p.workflowStyle).toBe('direct');
+    });
+    it('copilot profile has correct values', () => {
+        const p = SURFACE_PROFILES.copilot;
+        expect(p.executionModel).toBe('passive');
+        expect(p.format).toBe('single-file');
+        expect(p.sessionModel).toBe('stateless');
+        expect(p.tokenBudget).toBe(30000);
+        expect(p.workflowStyle).toBe('guided');
+    });
+});
+// ── Resolver ──────────────────────────────────────────────────────────
+describe('resolveSurfaceProfile', () => {
+    it.each(['claude', 'cursor', 'codex', 'copilot'])('resolves known target "%s" to a valid profile', (target) => {
+        const profile = resolveSurfaceProfile(target);
+        expect(isValidProfile(profile)).toBe(true);
+    });
+    it('resolves "claude" to the claude profile', () => {
+        expect(resolveSurfaceProfile('claude')).toBe(SURFACE_PROFILES.claude);
+    });
+    it('resolves "cursor" to the cursor profile', () => {
+        expect(resolveSurfaceProfile('cursor')).toBe(SURFACE_PROFILES.cursor);
+    });
+    it('resolves "codex" to the codex profile', () => {
+        expect(resolveSurfaceProfile('codex')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('resolves "copilot" to the copilot profile', () => {
+        expect(resolveSurfaceProfile('copilot')).toBe(SURFACE_PROFILES.copilot);
+    });
+    it('returns codex profile as fallback for unknown targets', () => {
+        expect(resolveSurfaceProfile('unknown-tool')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('returns codex profile for empty string', () => {
+        expect(resolveSurfaceProfile('')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('fallback profile is a valid profile', () => {
+        const fallback = resolveSurfaceProfile('completely-unknown-surface');
+        expect(isValidProfile(fallback)).toBe(true);
+    });
+});
+//# sourceMappingURL=surface-profiles.test.js.map

package/dist/generators/__tests__/surface-profiles.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-profiles.test.js","sourceRoot":"","sources":["../../../src/generators/__tests__/surface-profiles.test.ts"],"names":[],"mappings":"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"}

package/dist/generators/adapters.d.ts

@@ -2,9 +2,43 @@
  * Adapter file generators — thin pointers for each AI tool.
  * Each function returns the file content as a string.
  */
+import type { SurfaceProfile } from './surface-profiles.js';
 declare const MARKER = "auto-generated by pb handshake";
 export { MARKER };
-export declare function generateClaudeMd(timestamp: string): string;
-export declare function generateCursorMdc(timestamp: string): string;
-export declare function generateCopilotMd(timestamp: string): string;
+export interface AgentsMdOptions {
+    profile?: SurfaceProfile;
+    workspaceContext?: {
+        stage?: string;
+        focus?: string;
+        governanceMode?: string;
+        totalEntries?: number;
+    };
+    skills?: Array<{
+        name: string;
+        description: string;
+        triggers?: string[];
+    }>;
+}
+export declare function generateAgentsMd(timestamp: string, options?: AgentsMdOptions): string;
+export declare function generateClaudeMd(timestamp: string, profile?: SurfaceProfile): string;
+export declare function generateCursorMdc(timestamp: string, profile?: SurfaceProfile): string;
+export interface CopilotMdOptions {
+    profile?: SurfaceProfile;
+    workspaceContext?: {
+        stage?: string;
+        focus?: string;
+        governanceMode?: string;
+        totalEntries?: number;
+    };
+    skills?: Array<{
+        name: string;
+        description: string;
+        triggers?: string[];
+    }>;
+    rules?: Array<{
+        name: string;
+        description: string;
+    }>;
+}
+export declare function generateCopilotMd(timestamp: string, options?: CopilotMdOptions): string;
 //# 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,QAAA,MAAM,MAAM,mCAAmC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoC1D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgC3D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwB3D"}
+{"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"}

package/dist/generators/adapters.js

@@ -4,7 +4,89 @@
  */
 const MARKER = 'auto-generated by pb handshake';
 export { MARKER };
-export function generateClaudeMd(timestamp) {
+export function generateAgentsMd(timestamp, options) {
+    const { workspaceContext, skills } = options ?? {};
+    // Workspace context section (only when data is available)
+    let workspaceSection = '';
+    if (workspaceContext && Object.values(workspaceContext).some((v) => v !== undefined)) {
+        const rows = [];
+        if (workspaceContext.stage !== undefined)
+            rows.push(`| Stage | \`${workspaceContext.stage}\` |`);
+        if (workspaceContext.focus !== undefined)
+            rows.push(`| Current focus | ${workspaceContext.focus} |`);
+        if (workspaceContext.governanceMode !== undefined)
+            rows.push(`| Governance mode | \`${workspaceContext.governanceMode}\` |`);
+        if (workspaceContext.totalEntries !== undefined)
+            rows.push(`| Chain entries | ${workspaceContext.totalEntries} |`);
+        workspaceSection = `
+## Workspace Context
+
+| Field | Value |
+|-------|-------|
+${rows.join('\n')}
+`;
+    }
+    // Skill directory section (only when skills provided and non-empty)
+    let skillsSection = '';
+    if (skills && skills.length > 0) {
+        const rows = skills.map((s) => {
+            const triggers = s.triggers && s.triggers.length > 0 ? s.triggers.slice(0, 3).join(', ') : '—';
+            return `| \`${s.name}\` | ${s.description} | ${triggers} |`;
+        });
+        skillsSection = `
+## Skill Directory
+
+| Skill | Description | Triggers |
+|-------|-------------|----------|
+${rows.join('\n')}
+`;
+    }
+    return `<!-- ${MARKER} — ${timestamp} -->
+<!-- Re-run \`pb handshake\` to refresh. Do not edit manually. -->
+
+# Product Brain Context
+
+Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
+Read \`.productbrain/briefing.md\` for entries matched to this repo.
+Read \`.productbrain/soul.md\` when identity, working style, or collaboration preferences matter.
+${workspaceSection}
+## The Chain is the SSOT. Use \`pb\` before everything.
+
+| Command | Purpose |
+|---------|---------|
+| \`pb orient -b\` | Current workspace focus |
+| \`pb orient --task "<task>"\` | Task-shaped governance and context before implementation, review, or diagnosis |
+| \`pb get <ID>\` | Full entry (BET, DEC, STD, BR, TEN, ARCH) |
+| \`pb context <ID>\` | Constellation context for an entry |
+| \`pb search <query>\` | Find entries across the Chain |
+| \`pb handshake\` | Refresh these context files |
+
+**Before implementing any feature, ticket, or fix:** run \`pb get <ID>\` to read the actual spec, exclusions, acceptance criteria, and governance relations. Never assume you know the spec from the conversation alone.
+**Before substantive implementation, review, diagnosis, or security-sensitive reasoning:** run \`pb orient --task "<what you're doing>"\` so task-relevant governance becomes active before you propose a solution. Treat \`pb orient -b\` as workspace orientation, not sufficient task grounding.
+
+## Session lifecycle — close the loop
+
+Start every write-heavy session with \`pb session start\`. This opens a tracked write session and refreshes context.
+
+For reusable Product Brain workflows in Codex, read \`.codex/skills/README.md\` first, then open the matching skill file under \`.codex/skills/\`.
+
+When you make a decision, discover a tension, or learn something during work:
+\`\`\`
+pb capture "TEN: description of the tension"
+pb capture "DEC: decided X because Y"
+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.
+${skillsSection}
+## Governance Summary
+
+This workspace uses Product Brain governance. Decisions, standards, and tensions are tracked on the Chain. Use \`pb orient -b\` for current focus.
+`;
+}
+export function generateClaudeMd(timestamp, profile) {
     return `<!-- ${MARKER} — ${timestamp} -->
 <!-- Re-run \`pb handshake\` to refresh. Do not edit manually. -->
 
@@ -18,12 +100,14 @@ Read \`.productbrain/briefing.md\` for entries matched to this repo.
 | Command | Purpose |
 |---------|---------|
 | \`pb orient -b\` | Current workspace focus |
+| \`pb orient --task "<task>"\` | Task-shaped governance and context before implementation, review, or diagnosis |
 | \`pb get <ID>\` | Full entry (BET, DEC, STD, BR, TEN, ARCH) |
 | \`pb context <ID>\` | Constellation context for an entry |
 | \`pb search <query>\` | Find entries across the Chain |
 | \`pb handshake\` | Refresh these context files |
 
 **Before implementing any feature, ticket, or fix:** run \`pb get <ID>\` to read the actual spec, exclusions, acceptance criteria, and governance relations. Never assume you know the spec from the conversation alone.
+**Before substantive implementation, review, diagnosis, or security-sensitive reasoning:** run \`pb orient --task "<what you're doing>"\` so task-relevant governance becomes active before you propose a solution. Treat \`pb orient -b\` as workspace orientation, not sufficient task grounding.
 
 ## Session lifecycle — close the loop
 
@@ -41,7 +125,7 @@ Close with \`pb session close\` — reviews what was captured, refreshes context
 All captures are drafts. The human reviews and commits in Product Brain Studio.
 `;
 }
-export function generateCursorMdc(timestamp) {
+export function generateCursorMdc(timestamp, profile) {
     return `---
 description: Product Brain Chain context — workspace knowledge for AI-assisted development
 globs:
@@ -56,12 +140,14 @@ Read \`.productbrain/briefing.md\` for entries matched to this repo.
 ## The Chain is the SSOT. Use \`pb\` before everything.
 
 - \`pb orient -b\` — Current workspace focus
+- \`pb orient --task "<task>"\` — Task-shaped governance and context before implementation, review, or diagnosis
 - \`pb get <ID>\` — Full entry (BET, DEC, STD, BR, TEN, ARCH)
 - \`pb context <ID>\` — Constellation context for an entry
 - \`pb search <query>\` — Find entries across the Chain
 - \`pb handshake\` — Refresh these context files
 
 Before implementing any feature, ticket, or fix: run \`pb get <ID>\` to read the actual spec, exclusions, acceptance criteria, and governance relations. Never assume you know the spec from the conversation alone.
+Before substantive implementation, review, diagnosis, or security-sensitive reasoning: run \`pb orient --task "<what you're doing>"\` so task-relevant governance becomes active before you propose a solution. Treat \`pb orient -b\` as workspace orientation, not sufficient task grounding.
 
 ## Session lifecycle — close the loop
 
@@ -74,29 +160,131 @@ Close with \`pb session close\`. All captures are drafts — human reviews and c
 <!-- ${MARKER} — ${timestamp} -->
 `;
 }
-export function generateCopilotMd(timestamp) {
-    return `<!-- ${MARKER} — ${timestamp} -->
+export function generateCopilotMd(timestamp, options) {
+    const { profile, workspaceContext, skills, rules } = options ?? {};
+    const budget = profile?.tokenBudget ?? 30000;
+    // Workspace context section (only when data is available)
+    let workspaceSection = '';
+    if (workspaceContext && Object.values(workspaceContext).some((v) => v !== undefined)) {
+        const rows = [];
+        if (workspaceContext.stage !== undefined)
+            rows.push(`| Stage | \`${workspaceContext.stage}\` |`);
+        if (workspaceContext.focus !== undefined)
+            rows.push(`| Current focus | ${workspaceContext.focus} |`);
+        if (workspaceContext.governanceMode !== undefined)
+            rows.push(`| Governance mode | \`${workspaceContext.governanceMode}\` |`);
+        if (workspaceContext.totalEntries !== undefined)
+            rows.push(`| Chain entries | ${workspaceContext.totalEntries} |`);
+        workspaceSection = `
+## Workspace Context
+
+| Field | Value |
+|-------|-------|
+${rows.join('\n')}
+`;
+    }
+    // Build the invariant base (header + workspace + command ref + session lifecycle)
+    const base = `<!-- ${MARKER} — ${timestamp} -->
 <!-- Re-run \`pb handshake\` to refresh. Do not edit manually. -->
 
 # Product Brain Context
 
 Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
 Read \`.productbrain/briefing.md\` for entries matched to this repo.
-
+${workspaceSection}
 ## The Chain is the SSOT. Use \`pb\` before everything.
 
 - \`pb orient -b\` — Current workspace focus
+- \`pb orient --task "<task>"\` — Task-shaped governance and context before implementation, review, or diagnosis
 - \`pb get <ID>\` — Full entry (BET, DEC, STD, BR, TEN, ARCH)
 - \`pb context <ID>\` — Constellation context for an entry
 - \`pb search <query>\` — Find entries across the Chain
 - \`pb handshake\` — Refresh these context files
 
 Before implementing any feature, ticket, or fix: run \`pb get <ID>\` to read the actual spec, exclusions, acceptance criteria, and governance relations. Never assume you know the spec from the conversation alone.
+Before substantive implementation, review, diagnosis, or security-sensitive reasoning: run \`pb orient --task "<what you're doing>"\` so task-relevant governance becomes active before you propose a solution. Treat \`pb orient -b\` as workspace orientation, not sufficient task grounding.
 
 ## 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.
 `;
+    // When no enrichment options provided, return base for backward compat
+    if (!skills?.length && !rules?.length) {
+        return base;
+    }
+    // Build skill summaries and rule summaries as independent chunks
+    // so we can truncate from the end if needed
+    const skillChunks = [];
+    if (skills && skills.length > 0) {
+        skillChunks.push('\n## Skills\n');
+        for (const s of skills) {
+            let chunk = `\n### ${s.name}\n${s.description}\n`;
+            if (s.triggers && s.triggers.length > 0) {
+                chunk += `Triggers: ${s.triggers.slice(0, 3).join(', ')}\n`;
+            }
+            skillChunks.push(chunk);
+        }
+    }
+    const ruleChunks = [];
+    if (rules && rules.length > 0) {
+        ruleChunks.push('\n## Rules\n');
+        for (const r of rules) {
+            ruleChunks.push(`\n### ${r.name}\n${r.description}\n`);
+        }
+    }
+    // All appendable chunks: skill section header + individual skills, then rule section header + individual rules
+    const allChunks = [...skillChunks, ...ruleChunks];
+    // Greedily append chunks while staying within budget
+    let result = base;
+    let omittedCount = 0;
+    const truncationNote = (n) => `\n<!-- Truncated: ${n} skills/rules omitted to stay within token budget -->\n`;
+    // Check if base already exceeds budget (rare, but handle gracefully)
+    if (base.length >= budget) {
+        return base;
+    }
+    // We need to find how many chunks fit. Reserve space for a truncation note if needed.
+    const allChunksText = allChunks.join('');
+    if (base.length + allChunksText.length <= budget) {
+        // Everything fits — no truncation needed
+        return base + allChunksText;
+    }
+    // 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;
+    for (let i = 0; i < allChunks.length; i++) {
+        const chunk = allChunks[i];
+        const remaining = allChunks.slice(i + 1).join('');
+        // 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;
+        }
+        // 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++;
+        }
+        else {
+            break;
+        }
+    }
+    omittedCount = itemCount - fittedItemCount;
+    if (omittedCount > 0) {
+        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;
 }
 //# 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;AAEH,MAAM,MAAM,GAAG,gCAAgC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCrC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BF,MAAM,MAAM,SAAS;CAC3B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;CAsBrC,CAAC;AACF,CAAC"}
+{"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,wEAAwE;IACxE,6DAA6D;IAC7D,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;IAE/D,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAE1D,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,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;QAElD,iEAAiE;QACjE,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YACnE,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,eAAe,GAAG,SAAS,CAAC;YAC5B,MAAM;QACR,CAAC;QAED,mEAAmE;QACnE,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,gBAAgB,IAAI,MAAM,EAAE,CAAC;YACnE,WAAW,IAAI,KAAK,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,eAAe,EAAE,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,mEAAmE;QACnE,iEAAiE;QACjE,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC/C,WAAW,IAAI,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapters.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.test.d.ts","sourceRoot":"","sources":["../../src/generators/adapters.test.ts"],"names":[],"mappings":""}

package/dist/generators/adapters.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest';
+import { generateAgentsMd, generateClaudeMd, generateCopilotMd, generateCursorMdc } from './adapters.js';
+describe('generateAgentsMd', () => {
+    it('includes Product Brain bootstrap guidance for Codex-style agents', () => {
+        const output = generateAgentsMd('2026-04-02T00:00:00.000Z');
+        expect(output).toContain('auto-generated by pb handshake');
+        expect(output).toContain('Read `.productbrain/context.md`');
+        expect(output).toContain('Read `.productbrain/briefing.md`');
+        expect(output).toContain('Read `.productbrain/soul.md`');
+        expect(output).toContain('`.codex/skills/README.md`');
+        expect(output).toContain('pb orient -b');
+        expect(output).toContain('pb orient --task');
+        expect(output).toContain('pb session start');
+        expect(output).toContain('not sufficient task grounding');
+        expect(output).toContain('pb capture "TEN: description of the tension"');
+        expect(output).toContain('pb session close');
+    });
+});
+describe('adapter variants', () => {
+    it('propagates task-shaped startup guidance across generated adapters', () => {
+        const timestamp = '2026-04-02T00:00:00.000Z';
+        expect(generateClaudeMd(timestamp)).toContain('pb orient --task');
+        expect(generateCursorMdc(timestamp)).toContain('pb orient --task');
+        expect(generateCopilotMd(timestamp)).toContain('pb orient --task');
+    });
+});
+//# sourceMappingURL=adapters.test.js.map

package/dist/generators/adapters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.test.js","sourceRoot":"","sources":["../../src/generators/adapters.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEzG,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,gBAAgB,CAAC,0BAA0B,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAG,0BAA0B,CAAC;QAE7C,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAClE,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACnE,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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;AAwCxF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CAkBvF;AA4CD;;;;;;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,CAsDpE"}