@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.15

package/dist/formatters/session.js

@@ -0,0 +1,51 @@
+/**
+ * Session formatters — terminal output for session start / close.
+ */
+export function formatSessionStart(session, superseded) {
+    const lines = [];
+    lines.push('');
+    lines.push(`Session started: ${session.sessionId}`);
+    lines.push(`Workspace: ${session.workspaceName}`);
+    lines.push(`Time: ${session.startedAt}`);
+    if (superseded) {
+        lines.push('');
+        lines.push(`Note: superseded previous session ${superseded.previousSessionId}`);
+        lines.push(`  Started: ${superseded.startedAt} by ${superseded.initiatedBy}`);
+    }
+    lines.push('');
+    lines.push('You now have write access. Use `pb capture "<text>"` to capture knowledge.');
+    lines.push('Run `pb session close` when done.');
+    return lines.join('\n');
+}
+export function formatSessionClose(session) {
+    const lines = [];
+    const count = session.entriesCaptured.length;
+    lines.push('');
+    lines.push('Session closed.');
+    lines.push(`Duration: ${formatDuration(session.startedAt)}`);
+    if (count > 0) {
+        lines.push('');
+        lines.push(`Entries captured: ${count} (all as drafts)`);
+        for (const id of session.entriesCaptured) {
+            lines.push(`  • ${id}`);
+        }
+        lines.push('');
+        lines.push('Review and commit drafts in Product Brain Studio, or via MCP.');
+    }
+    else {
+        lines.push('No entries captured this session.');
+    }
+    return lines.join('\n');
+}
+function formatDuration(startedAt) {
+    const ms = Date.now() - new Date(startedAt).getTime();
+    const mins = Math.floor(ms / 60000);
+    if (mins < 1)
+        return 'less than a minute';
+    if (mins < 60)
+        return `${mins}m`;
+    const hrs = Math.floor(mins / 60);
+    const rem = mins % 60;
+    return rem > 0 ? `${hrs}h ${rem}m` : `${hrs}h`;
+}
+//# sourceMappingURL=session.js.map

package/dist/formatters/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,UAAkF;IAElF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEzC,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,SAAS,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IACzF,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAEhD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAE7D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,kBAAkB,CAAC,CAAC;QACzD,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAC1C,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,GAAG,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AACjD,CAAC"}

package/dist/formatters/update.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Update receipt formatter — terminal output for pb update.
+ * BET-192 / FEAT-575: Added normalization + validation warning rendering.
+ */
+export interface UpdateReceiptData {
+    entryId: string;
+    changeNote?: string;
+    fieldsChanged: string[];
+    name?: string;
+    status?: string;
+    /** BET-192: Fields silently dropped by normalizeEntryData. */
+    normalizationWarnings?: string[];
+    /** BET-192: Missing required fields, type mismatches, etc. */
+    validationWarnings?: string[];
+}
+export declare function formatUpdateReceipt(data: UpdateReceiptData): string;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/formatters/update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAyCnE"}

package/dist/formatters/update.js

@@ -0,0 +1,43 @@
+/**
+ * Update receipt formatter — terminal output for pb update.
+ * BET-192 / FEAT-575: Added normalization + validation warning rendering.
+ */
+export function formatUpdateReceipt(data) {
+    const lines = [];
+    // Summary line
+    const changes = [];
+    if (data.name)
+        changes.push(`name`);
+    if (data.status)
+        changes.push(`status → ${data.status}`);
+    for (const f of data.fieldsChanged) {
+        const key = f.split('=')[0]?.trim();
+        if (key)
+            changes.push(key);
+    }
+    lines.push(`Updated ${data.entryId}: ${data.changeNote ?? changes.join(', ')}`);
+    // Detail
+    if (data.changeNote && changes.length > 0) {
+        lines.push(`  Fields: ${changes.join(', ')}`);
+    }
+    // BET-192 / FEAT-575: Surface normalization warnings — fields that were rejected/dropped.
+    if (data.normalizationWarnings && data.normalizationWarnings.length > 0) {
+        lines.push('');
+        lines.push('  ⚠ Normalization warnings:');
+        for (const warning of data.normalizationWarnings) {
+            lines.push(`    - ${warning}`);
+        }
+    }
+    // BET-192 / FEAT-575: Surface validation warnings — missing required fields, etc.
+    if (data.validationWarnings && data.validationWarnings.length > 0) {
+        lines.push('');
+        lines.push('  ⚠ Validation warnings:');
+        for (const warning of data.validationWarnings) {
+            lines.push(`    - ${warning}`);
+        }
+    }
+    lines.push('');
+    lines.push(`  View: pb get ${data.entryId}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=update.js.map

package/dist/formatters/update.js.map

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

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/adapters.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Adapter file generators — thin pointers for each AI tool.
+ * Each function returns the file content as a string.
+ */
+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;
+//# sourceMappingURL=adapters.d.ts.map

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

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

package/dist/generators/adapters.js

@@ -0,0 +1,102 @@
+/**
+ * Adapter file generators — thin pointers for each AI tool.
+ * Each function returns the file content as a string.
+ */
+const MARKER = 'auto-generated by pb handshake';
+export { MARKER };
+export function generateClaudeMd(timestamp) {
+    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.
+
+## The Chain is the SSOT. Use \`pb\` before everything.
+
+| Command | Purpose |
+|---------|---------|
+| \`pb orient -b\` | Current workspace focus |
+| \`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.
+
+## Session lifecycle — close the loop
+
+Start every session with \`pb session start\`. This opens a tracked write session and refreshes context.
+
+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.
+`;
+}
+export function generateCursorMdc(timestamp) {
+    return `---
+description: Product Brain Chain context — workspace knowledge for AI-assisted development
+globs:
+alwaysApply: true
+---
+
+# 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.
+
+## The Chain is the SSOT. Use \`pb\` before everything.
+
+- \`pb orient -b\` — Current workspace focus
+- \`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.
+
+## Session lifecycle — close the loop
+
+Start with \`pb session start\`. When you make a decision, discover a tension, or learn something:
+- \`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.
+
+<!-- ${MARKER} — ${timestamp} -->
+`;
+}
+export function generateCopilotMd(timestamp) {
+    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.
+
+## The Chain is the SSOT. Use \`pb\` before everything.
+
+- \`pb orient -b\` — Current workspace focus
+- \`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.
+
+## 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.
+`;
+}
+//# sourceMappingURL=adapters.js.map

package/dist/generators/adapters.js.map

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

package/dist/generators/briefing-md.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates .productbrain/briefing.md — entries matched to this specific repo.
+ * Pure function: search results + repo context in, markdown string out.
+ */
+import type { SearchResult } from '../formatters/search.js';
+import type { RepoContext } from '../lib/repo-detect.js';
+export declare function generateBriefingMd(entries: SearchResult[], repo: RepoContext, searchQueries: string[], timestamp: string): string;
+//# sourceMappingURL=briefing-md.d.ts.map

package/dist/generators/briefing-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing-md.d.ts","sourceRoot":"","sources":["../../src/generators/briefing-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,GAChB,MAAM,CAiDR"}

package/dist/generators/briefing-md.js

@@ -0,0 +1,51 @@
+/**
+ * Generates .productbrain/briefing.md — entries matched to this specific repo.
+ * Pure function: search results + repo context in, markdown string out.
+ */
+export function generateBriefingMd(entries, repo, searchQueries, timestamp) {
+    const lines = [];
+    lines.push('<!-- auto-generated by pb handshake — ' + timestamp + ' -->');
+    lines.push('<!-- Re-run `pb handshake` to refresh. Do not edit manually. -->');
+    lines.push('');
+    lines.push(`# Repo Briefing — ${repo.name ?? 'Unknown'}`);
+    lines.push('');
+    lines.push(`_Generated: ${timestamp}_`);
+    if (repo.repoSlug)
+        lines.push(`_Repo: ${repo.repoSlug}_`);
+    if (repo.detectedStack.length > 0)
+        lines.push(`_Stack: ${repo.detectedStack.join(', ')}_`);
+    lines.push('');
+    if (entries.length === 0) {
+        lines.push('No matching Chain entries found for this repository.');
+        lines.push('');
+        lines.push(`Searched for: ${searchQueries.join(', ')}`);
+        lines.push('');
+        lines.push('Try `pb search <query>` for manual searches.');
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push(`**${entries.length}** entries found relevant to this repository.`);
+    lines.push('');
+    // Group by collection
+    const grouped = new Map();
+    for (const e of entries) {
+        const coll = e.collectionSlug ?? 'other';
+        if (!grouped.has(coll))
+            grouped.set(coll, []);
+        grouped.get(coll).push(e);
+    }
+    for (const [coll, items] of grouped) {
+        lines.push(`## ${coll} (${items.length})`);
+        for (const e of items) {
+            const id = e.entryId ?? e.name;
+            lines.push(`- **${id}** — ${e.name}${e.status ? ` [${e.status}]` : ''}`);
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push(`_Searched for: ${searchQueries.join(', ')}_`);
+    lines.push('_Run `pb get <ID>` for full details on any entry._');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=briefing-md.js.map

package/dist/generators/briefing-md.js.map

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

package/dist/generators/context-md.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates .productbrain/context.md — workspace briefing snapshot.
+ * Pure function: orient view in, markdown string out.
+ */
+import type { OrientViewFromApi } from '../commands/orient.js';
+import type { RepoContext } from '../lib/repo-detect.js';
+export declare function generateContextMd(view: OrientViewFromApi, repo: RepoContext, timestamp: string): string;
+//# sourceMappingURL=context-md.d.ts.map

package/dist/generators/context-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-md.d.ts","sourceRoot":"","sources":["../../src/generators/context-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA2GvG"}

package/dist/generators/context-md.js

@@ -0,0 +1,123 @@
+/**
+ * Generates .productbrain/context.md — workspace briefing snapshot.
+ * Pure function: orient view in, markdown string out.
+ */
+function entryLine(e, maxPreview = 100) {
+    const id = e.entryId ?? e.name;
+    if (e.preview) {
+        const p = e.preview.length > maxPreview ? e.preview.slice(0, maxPreview) + '...' : e.preview;
+        return `- **${id}** — ${p}`;
+    }
+    return `- **${id}** — ${e.name}`;
+}
+export function generateContextMd(view, repo, timestamp) {
+    const lines = [];
+    lines.push('<!-- auto-generated by pb handshake — ' + timestamp + ' -->');
+    lines.push('<!-- Re-run `pb handshake` to refresh. Do not edit manually. -->');
+    lines.push('');
+    lines.push('# Product Brain — Workspace Context');
+    lines.push('');
+    lines.push(`_Generated: ${timestamp}_`);
+    if (repo.name)
+        lines.push(`_Repo: ${repo.name}${repo.repoSlug ? ` (${repo.repoSlug})` : ''}_`);
+    lines.push('');
+    // Stage
+    lines.push('## Stage');
+    lines.push(`**${view.stage}**`);
+    lines.push('');
+    // Strategic context
+    const sc = view.strategicContext;
+    lines.push('## Strategic Context');
+    if (sc.vision)
+        lines.push(`- **Vision**: ${sc.vision}`);
+    if (sc.purpose)
+        lines.push(`- **Purpose**: ${sc.purpose}`);
+    if (sc.currentBet)
+        lines.push(`- **Current bet**: ${sc.currentBet}`);
+    lines.push(`- **Active bets**: ${sc.activeBetCount}`);
+    lines.push(`- **Active tensions**: ${sc.activeTensionCount}`);
+    if (sc.productAreas.length > 0)
+        lines.push(`- **Product areas**: ${sc.productAreas.join(', ')}`);
+    lines.push('');
+    // Active bets
+    if (view.activeBets.length > 0) {
+        lines.push('## Active Bets');
+        for (const bet of view.activeBets.slice(0, 10)) {
+            lines.push(`- **${bet.entryId ?? bet.name}** — ${bet.name}`);
+            if (bet.linkedTensions && bet.linkedTensions.length > 0) {
+                for (const t of bet.linkedTensions.slice(0, 3)) {
+                    lines.push(`  - ${t.name}`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    // Governance
+    const gov = view.governance;
+    if (gov) {
+        const hasGov = gov.principles.length > 0 || gov.standards.length > 0 || gov.businessRules.length > 0;
+        if (hasGov) {
+            lines.push('## Governance');
+            if (gov.principles.length > 0) {
+                lines.push('### Principles');
+                for (const p of gov.principles.slice(0, 5))
+                    lines.push(entryLine(p));
+            }
+            if (gov.standards.length > 0) {
+                lines.push('### Standards');
+                for (const s of gov.standards.slice(0, 5))
+                    lines.push(entryLine(s));
+            }
+            if (gov.businessRules.length > 0) {
+                lines.push('### Business Rules');
+                for (const br of gov.businessRules.slice(0, 5))
+                    lines.push(entryLine(br));
+            }
+            lines.push('');
+        }
+    }
+    // Architecture notes
+    if (view.architectureNotes && view.architectureNotes.length > 0) {
+        lines.push('## Architecture');
+        for (const a of view.architectureNotes.slice(0, 5))
+            lines.push(entryLine(a));
+        lines.push('');
+    }
+    // Open tensions
+    if (view.tensions && view.tensions.length > 0) {
+        lines.push('## Open Tensions');
+        for (const t of view.tensions.slice(0, 10)) {
+            lines.push(`- **${t.entryId ?? t.name}** — ${t.name}`);
+        }
+        lines.push('');
+    }
+    // Planned work
+    const pw = view.plannedWork;
+    if (pw) {
+        const hasPlanned = pw.uncommittedDrafts.length > 0 || pw.inProgressEntries.length > 0 || pw.openTensions.length > 0;
+        if (hasPlanned) {
+            lines.push('## Planned Work');
+            if (pw.uncommittedDrafts.length > 0) {
+                lines.push('### Drafts');
+                for (const d of pw.uncommittedDrafts.slice(0, 5))
+                    lines.push(`- ${d.name} [${d.collection}]`);
+            }
+            if (pw.inProgressEntries.length > 0) {
+                lines.push('### In Progress');
+                for (const e of pw.inProgressEntries.slice(0, 5))
+                    lines.push(`- ${e.name} [${e.collection}]`);
+            }
+            if (pw.openTensions.length > 0) {
+                lines.push('### Open Tensions');
+                for (const t of pw.openTensions.slice(0, 5))
+                    lines.push(`- ${t.name}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push('---');
+    lines.push('_This is a snapshot. Run `pb orient` for live data. Run `pb get <ID>` for full entry details._');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=context-md.js.map

package/dist/generators/context-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-md.js","sourceRoot":"","sources":["../../src/generators/context-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,SAAS,SAAS,CAAC,CAA6D,EAAE,UAAU,GAAG,GAAG;IAChG,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7F,OAAO,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAuB,EAAE,IAAiB,EAAE,SAAiB;IAC7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,wCAAwC,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,oBAAoB;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,cAAc;IACd,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,aAAa;IACb,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;IAC5B,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QACrG,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC5B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACjC,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,eAAe;IACf,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5B,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QACpH,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACzB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBAChC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,gGAAgG,CAAC,CAAC;IAC7G,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generators/portable-knowledge.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Portable knowledge — reads canonical skills/rules from .productbrain/
+ * and generates tool-specific copies for Cursor, Claude Code, etc.
+ */
+export interface CanonicalSkill {
+    name: string;
+    description: string;
+    triggers: string[];
+    body: string;
+    sourcePath: string;
+    targets?: string[];
+    level?: string;
+}
+export interface CanonicalRule {
+    name: string;
+    description: string;
+    scope?: string;
+    autoApply: boolean;
+    body: string;
+    sourcePath: string;
+    targets?: string[];
+    level?: string;
+}
+export type TargetName = 'cursor' | 'claude' | 'copilot';
+/** Returns true if the entry should be emitted to the given target. */
+export declare function shouldEmitToTarget(entry: CanonicalRule | CanonicalSkill, target: TargetName): boolean;
+export type HandshakeLevel = 'beginner' | 'intermediate' | 'expert';
+/**
+ * Filter items by graduated level.
+ * - If requestedLevel is undefined/null: return ALL items (backward compat).
+ * - Items with no `level` field: always included (backward compat).
+ * - Otherwise: include items whose level is within the hierarchy for requestedLevel.
+ */
+export declare function filterByLevel<T extends {
+    level?: string;
+}>(items: T[], requestedLevel?: string): T[];
+export declare function readCanonicalSkills(productbrainDir: string): CanonicalSkill[];
+export declare function readCanonicalRules(productbrainDir: string): CanonicalRule[];
+/**
+ * Strip transport-conditional sections from a skill body.
+ *
+ * Sections are delimited by HTML comments:
+ *   <!-- transport:TARGET_NAME -->
+ *   ...content...
+ *   <!-- /transport -->
+ *
+ * - Blocks matching the current target: keep the content, remove the delimiter comments.
+ * - Blocks for OTHER targets: remove entirely (delimiters + content).
+ * - Content outside any transport block: keep as-is (universal content).
+ */
+export declare function stripTransportSections(body: string, target: TargetName): string;
+/**
+ * Generate a Cursor SKILL.md from a canonical skill.
+ * Cursor expects: name, description (with triggers embedded).
+ */
+export declare function generateCursorSkill(skill: CanonicalSkill): string;
+/**
+ * Generate a Cursor .mdc rule from a canonical rule.
+ * Cursor expects: description, globs, alwaysApply.
+ */
+export declare function generateCursorRule(rule: CanonicalRule): string;
+/**
+ * Generate a Claude Code .md rule from a canonical rule.
+ * Claude Code expects: description, optional paths (array).
+ */
+export declare function generateClaudeRule(rule: CanonicalRule): string;
+/**
+ * Generate a Claude Code skill-router.md — imperative skill activation rule.
+ * Loaded automatically by Claude Code via .claude/rules/ with no paths (always active).
+ */
+export declare function generateClaudeSkillRouter(skills: CanonicalSkill[]): string;
+//# sourceMappingURL=portable-knowledge.d.ts.map

package/dist/generators/portable-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-knowledge.d.ts","sourceRoot":"","sources":["../../src/generators/portable-knowledge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAGrG;AAID,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;AAUpE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CASpG;AAkED,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,EAAE,CAsB7E;AAED,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,EAAE,CAuB3E;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAa/E;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAc9D;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAqB9D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CA4B1E"}