@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/generators/adapters.js

@@ -0,0 +1,350 @@
+/**
+ * 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 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, work packages, 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 accepts in Cortex.
+${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. -->
+
+# Product Brain Context
+
+Read \`.productbrain/context.md\` for full workspace briefing (stage, work packages, 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 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 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 accepts in Cortex.
+`;
+}
+export function generateCursorMdc(timestamp, profile) {
+    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, work packages, 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 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\`. 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 accepts.
+
+<!-- ${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, work packages, 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 accepts.
+`;
+    // 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;
+}
+/** 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

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

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;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