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

package/dist/generators/boundary-manifest.real-file.test.js.map

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

package/dist/generators/boundary-manifest.test.d.ts

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

package/dist/generators/boundary-manifest.test.d.ts.map

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

package/dist/generators/boundary-manifest.test.js

@@ -0,0 +1,91 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { join } from 'path';
+const { vfs, PB_DIR } = vi.hoisted(() => ({
+    vfs: {},
+    PB_DIR: '/tmp/pb-test/.productbrain',
+}));
+vi.mock('fs', () => ({
+    existsSync: vi.fn((path) => path in vfs),
+    readFileSync: vi.fn((path, _enc) => {
+        if (path in vfs)
+            return vfs[path];
+        throw Object.assign(new Error(`ENOENT: no such file '${path}'`), { code: 'ENOENT' });
+    }),
+}));
+import { generateBoundaryManifest, getBoundaryEnforcementMode, parseBoundaryRules, } from './boundary-manifest.js';
+const SOURCE_PATH = join(PB_DIR, 'rules', 'architecture-boundaries.md');
+function boundaryMarkdown(depcruiseRuleName = 'core-no-feature') {
+    return `---
+name: architecture-boundaries
+enforcement:
+  boundaries:
+    - id: core-no-feature
+      kind: policyBoundary
+      status: active
+      scope: convex
+      chainRefs: [BR-19, ARCH-29]
+      description: "Core must not import Feature."
+      from:
+        path: "^convex/gitchain/"
+      to:
+        path: "^convex/chainwork/"
+      severity: error
+      enforcement:
+        depcruiseRuleName: ${depcruiseRuleName}
+    - id: no-circular
+      kind: localOnlyTechnical
+      status: active
+      scope: repo
+      chainRefs: []
+      description: "Technical graph integrity check."
+      enforcement:
+        depcruiseRuleName: no-circular
+---
+
+# Architecture Boundaries
+`;
+}
+describe('boundary manifest generator', () => {
+    beforeEach(() => {
+        Object.keys(vfs).forEach((key) => delete vfs[key]);
+        vi.clearAllMocks();
+    });
+    it('defaults new workspaces to advisory mode', () => {
+        expect(getBoundaryEnforcementMode(null)).toBe('advisory');
+    });
+    it('parses structured Product Brain boundary frontmatter', () => {
+        const rules = parseBoundaryRules(boundaryMarkdown());
+        expect(rules).toHaveLength(2);
+        expect(rules[0]).toMatchObject({
+            id: 'core-no-feature',
+            kind: 'policyBoundary',
+            status: 'active',
+            scope: 'convex',
+            chainRefs: ['BR-19', 'ARCH-29'],
+            from: { path: '^convex/gitchain/' },
+            to: { path: '^convex/chainwork/' },
+            severity: 'error',
+            enforcement: { depcruiseRuleName: 'core-no-feature' },
+        });
+    });
+    it('generates a stable manifest with source and chain metadata', () => {
+        vfs[SOURCE_PATH] = boundaryMarkdown();
+        const content = generateBoundaryManifest(PB_DIR);
+        expect(content).not.toBeNull();
+        const manifest = JSON.parse(content);
+        expect(manifest.sources[0].path).toBe('.productbrain/rules/architecture-boundaries.md');
+        expect(manifest.chainSources.map((source) => source.entryId)).toEqual([
+            'ARCH-29',
+            'BR-19',
+        ]);
+        expect(manifest.rules.map((rule) => rule.id)).toEqual([
+            'core-no-feature',
+            'no-circular',
+        ]);
+    });
+    it('rejects duplicate dependency-cruiser rule names', () => {
+        vfs[SOURCE_PATH] = boundaryMarkdown('no-circular');
+        expect(() => generateBoundaryManifest(PB_DIR)).toThrow('Duplicate dependency-cruiser rule name "no-circular".');
+    });
+});
+//# sourceMappingURL=boundary-manifest.test.js.map

package/dist/generators/boundary-manifest.test.js.map

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

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/chain-classifier-kernel-client-drift.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chain-classifier-kernel-client-drift.test.d.ts.map

package/dist/generators/chain-classifier-kernel-client-drift.test.d.ts.map

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

package/dist/generators/chain-classifier-kernel-client-drift.test.js

@@ -0,0 +1,41 @@
+/**
+ * Compile-time drift test — PR #393 review (Codex P2), post-Lane-C-S3a fix.
+ *
+ * `chain-classifier.ts`'s `GovernanceFunction`/`GovernanceRelationEdge` are LOCAL,
+ * structural declarations again (not `import type`-re-exported from
+ * `@productbrain/kernel-client/governance`) — a re-export would leak the kernel-client
+ * import specifier into cli's PUBLISHED `.d.ts` output (`npm pack --dry-run` confirmed
+ * `dist/generators/chain-classifier.d.ts` ships in the tarball; a TypeScript consumer
+ * following that declaration would hit `TS2307: Cannot find module
+ * '@productbrain/kernel-client/governance'`, since that package is `private: true` and
+ * never published).
+ *
+ * This file is what replaces the deleted pre-S3a "zero drift risk" comment's unverified
+ * promise with an ENFORCED one: it imports BOTH chain-classifier.ts's local types and
+ * kernel-client's canonical originals, and asserts mutual structural assignability at
+ * the TYPE level. If either shape drifts without the other being updated to match, this
+ * file FAILS TO COMPILE (`tsc --noEmit` / `check:package-types` / this vitest run all
+ * fail) — a real, re-runnable check.
+ *
+ * This file exports NOTHING, so its own compiled declaration carries no kernel-client
+ * reference (verified: `npm pack --dry-run` shows no import in the emitted
+ * `chain-classifier-kernel-client-drift.test.d.ts` — nothing here is part of the public
+ * surface a consumer could ever deep-import).
+ */
+import { describe, expect, it } from 'vitest';
+// If either line below fails to compile, chain-classifier.ts's local mirror has drifted
+// from kernel-client's canonical shape — update the local declaration in
+// chain-classifier.ts to match kernel/governance/classifyGovernance.ts's real shape.
+const _governanceFunctionMatchesKernelClient = true;
+const _governanceRelationEdgeMatchesKernelClient = true;
+void _governanceFunctionMatchesKernelClient;
+void _governanceRelationEdgeMatchesKernelClient;
+describe('chain-classifier.ts governance types stay structurally identical to @productbrain/kernel-client/governance (PR #393 review)', () => {
+    it('compiles only when both AssertEqual checks above resolve to `true` — this test passing IS the drift check; the assertion below is a no-op runtime confirmation', () => {
+        // The real check already ran at compile time (the `const _...: AssertEqual<...> =
+        // true` lines above). If this test file compiled and vitest is running it, the
+        // types matched. This assertion just gives the check a visible, reportable pass.
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=chain-classifier-kernel-client-drift.test.js.map

package/dist/generators/chain-classifier-kernel-client-drift.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-classifier-kernel-client-drift.test.js","sourceRoot":"","sources":["../../src/generators/chain-classifier-kernel-client-drift.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AA0B9C,wFAAwF;AACxF,yEAAyE;AACzE,qFAAqF;AACrF,MAAM,sCAAsC,GAA8D,IAAI,CAAC;AAC/G,MAAM,0CAA0C,GAAsE,IAAI,CAAC;AAC3H,KAAK,sCAAsC,CAAC;AAC5C,KAAK,0CAA0C,CAAC;AAEhD,QAAQ,CAAC,6HAA6H,EAAE,GAAG,EAAE;IAC3I,EAAE,CAAC,gKAAgK,EAAE,GAAG,EAAE;QACxK,kFAAkF;QAClF,+EAA+E;QAC/E,iFAAiF;QACjF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/generators/chain-classifier.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Chain Classifier — types only.
+ *
+ * WP-488 Slice 4 (FEAT-1378, TEN-2733): the classifier IMPLEMENTATION moved to
+ * kernel/governance/classifyGovernance.ts, served over the gateway as
+ * `chain.classifyGovernance` — no connector-local scorer (see chain-rules.ts, which
+ * calls the served verdict). These type/interface declarations stay here because
+ * `handshake-diff.ts` / `archetypes.ts` / `chain-rules.ts` need the SHAPES, and
+ * `packages/cli` cannot import `kernel/` directly (`kernel/` is a private, unpublished
+ * workspace package; CLI compiles with plain `tsc`, no bundler — a `kernel` import
+ * would emit an unresolvable specifier into the published `dist/`, verified in WP-488
+ * Slice 3 for the identical class of failure).
+ *
+ * Lane C S3a (TEN-2733 pattern extension), REVISED post-merge (PR #393 review,
+ * Codex P2): `GovernanceFunction`/`GovernanceRelationEdge` were briefly `import
+ * type`-only re-exports from `@productbrain/kernel-client/governance`. Confirmed real:
+ * `import type` erases from EMITTED JS (no runtime import — verified, unchanged), but
+ * `tsc`'s DECLARATION (`.d.ts`) output for a re-export like `export type { X } from
+ * 'module'` PRESERVES the import specifier — and `npm pack --dry-run` confirms
+ * `dist/generators/chain-classifier.d.ts` ships in the published tarball. A TypeScript
+ * consumer following that shipped declaration (cli's package.json has no "exports" map,
+ * so nothing blocks a deep import of `dist/generators/chain-classifier.js`) would hit
+ * `TS2307: Cannot find module '@productbrain/kernel-client/governance'` — that package
+ * is `private: true`, never published. A `type X = import('@productbrain/kernel-client/
+ * governance').X` alias form doesn't fix this either — the import specifier still leaks
+ * into the declaration the same way.
+ *
+ * FIX: `GovernanceFunction`/`GovernanceRelationEdge` are LOCAL, structural declarations
+ * again (below) — the published `.d.ts` is fully self-contained, no kernel-client
+ * reference at all. Binding to kernel-client's canonical shape moved from "the type
+ * IS the import" to "a committed, compile-time DRIFT TEST" —
+ * `chain-classifier-kernel-client-drift.test.ts` (same directory) imports BOTH this
+ * file's local types AND kernel-client's `@productbrain/kernel-client/governance`
+ * originals and asserts mutual structural assignability; if either shape drifts without
+ * the other being updated to match, that test FAILS TO COMPILE — a real, enforced
+ * check, not the deleted pre-S3a "zero drift risk" comment's unverified promise. The
+ * drift test itself exports nothing, so ITS declaration carries no kernel-client
+ * reference either (verified: `npm pack --dry-run` shows an empty/no-op `.d.ts` for it).
+ *
+ * `@productbrain/kernel-client/governance` (the subpath added in S3a) still exists and
+ * is still useful — it's now the drift test's comparison source, and remains available
+ * for any FUTURE consumer that can afford a kernel-client type dependency (mcp-server,
+ * which never ships declarations at all — it bundles via tsup, not `tsc -d`).
+ *
+ * `GovernanceEntryInput`/`GovernanceCollectionInput`/`ClassifiedGovernance` below remain
+ * hand-declared (never re-exported from kernel-client — same self-contained-declaration
+ * reasoning now applies to them too, not just out of scope).
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration), TEN-2733, TEN-2705
+ */
+/** The governance functions that archetypes exist for. Mirrors kernel/governance/
+ * classifyGovernance.ts's GovernanceFunction exactly — verified by
+ * chain-classifier-kernel-client-drift.test.ts's compile-time assertion. */
+export type GovernanceFunction = 'constraint' | 'boundary' | 'convention' | 'policy' | 'workflow' | 'quality-gate' | 'unclassified';
+/** Typed relation edge. Mirrors GovernanceRelationEdge from kernel/governance/
+ * classifyGovernance.ts exactly — verified by
+ * chain-classifier-kernel-client-drift.test.ts's compile-time assertion. */
+export interface GovernanceRelationEdge {
+    type: string;
+    direction: 'outgoing' | 'incoming';
+    otherEntryId: string | null;
+    otherName: string;
+    otherCollectionSlug: string | null;
+}
+/** Input shape — matches GovernanceEntry from the Convex query. */
+export interface GovernanceEntryInput {
+    entryId: string | null;
+    name: string;
+    collectionSlug: string;
+    status: string;
+    verificationStatus: 'verified' | 'unverified' | null;
+    data: Record<string, unknown> | null;
+    relations: GovernanceRelationEdge[];
+}
+/** Workspace collection metadata from chain.listCollections. */
+export interface GovernanceCollectionInput {
+    slug: string;
+    name?: string;
+    description?: string;
+    purpose?: string;
+    usageGuidance?: string;
+    classificationCheck?: string;
+    classificationSignals?: string[];
+    defaultCanonicalKey?: string;
+    governanceRole?: string;
+    thinkingLayer?: string;
+    governanceFunction?: GovernanceFunction;
+}
+/** Result of classifying a single governance entry (as returned by chain.classifyGovernance). */
+export interface ClassifiedGovernance {
+    entryId: string;
+    name: string;
+    collectionSlug: string;
+    governanceFunction: GovernanceFunction;
+    confidence: number;
+    matchedSignals: string[];
+    /** Original entry data passed through for archetype slot resolution */
+    data: Record<string, unknown> | null;
+    /** Original relations passed through */
+    relations: GovernanceRelationEdge[];
+}
+//# sourceMappingURL=chain-classifier.d.ts.map

package/dist/generators/chain-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-classifier.d.ts","sourceRoot":"","sources":["../../src/generators/chain-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH;;4EAE4E;AAC5E,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,cAAc,GACd,cAAc,CAAC;AAEnB;;4EAE4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,iGAAiG;AACjG,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,wCAAwC;IACxC,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC"}

package/dist/generators/chain-classifier.js

@@ -0,0 +1,52 @@
+/**
+ * Chain Classifier — types only.
+ *
+ * WP-488 Slice 4 (FEAT-1378, TEN-2733): the classifier IMPLEMENTATION moved to
+ * kernel/governance/classifyGovernance.ts, served over the gateway as
+ * `chain.classifyGovernance` — no connector-local scorer (see chain-rules.ts, which
+ * calls the served verdict). These type/interface declarations stay here because
+ * `handshake-diff.ts` / `archetypes.ts` / `chain-rules.ts` need the SHAPES, and
+ * `packages/cli` cannot import `kernel/` directly (`kernel/` is a private, unpublished
+ * workspace package; CLI compiles with plain `tsc`, no bundler — a `kernel` import
+ * would emit an unresolvable specifier into the published `dist/`, verified in WP-488
+ * Slice 3 for the identical class of failure).
+ *
+ * Lane C S3a (TEN-2733 pattern extension), REVISED post-merge (PR #393 review,
+ * Codex P2): `GovernanceFunction`/`GovernanceRelationEdge` were briefly `import
+ * type`-only re-exports from `@productbrain/kernel-client/governance`. Confirmed real:
+ * `import type` erases from EMITTED JS (no runtime import — verified, unchanged), but
+ * `tsc`'s DECLARATION (`.d.ts`) output for a re-export like `export type { X } from
+ * 'module'` PRESERVES the import specifier — and `npm pack --dry-run` confirms
+ * `dist/generators/chain-classifier.d.ts` ships in the published tarball. A TypeScript
+ * consumer following that shipped declaration (cli's package.json has no "exports" map,
+ * so nothing blocks a deep import of `dist/generators/chain-classifier.js`) would hit
+ * `TS2307: Cannot find module '@productbrain/kernel-client/governance'` — that package
+ * is `private: true`, never published. A `type X = import('@productbrain/kernel-client/
+ * governance').X` alias form doesn't fix this either — the import specifier still leaks
+ * into the declaration the same way.
+ *
+ * FIX: `GovernanceFunction`/`GovernanceRelationEdge` are LOCAL, structural declarations
+ * again (below) — the published `.d.ts` is fully self-contained, no kernel-client
+ * reference at all. Binding to kernel-client's canonical shape moved from "the type
+ * IS the import" to "a committed, compile-time DRIFT TEST" —
+ * `chain-classifier-kernel-client-drift.test.ts` (same directory) imports BOTH this
+ * file's local types AND kernel-client's `@productbrain/kernel-client/governance`
+ * originals and asserts mutual structural assignability; if either shape drifts without
+ * the other being updated to match, that test FAILS TO COMPILE — a real, enforced
+ * check, not the deleted pre-S3a "zero drift risk" comment's unverified promise. The
+ * drift test itself exports nothing, so ITS declaration carries no kernel-client
+ * reference either (verified: `npm pack --dry-run` shows an empty/no-op `.d.ts` for it).
+ *
+ * `@productbrain/kernel-client/governance` (the subpath added in S3a) still exists and
+ * is still useful — it's now the drift test's comparison source, and remains available
+ * for any FUTURE consumer that can afford a kernel-client type dependency (mcp-server,
+ * which never ships declarations at all — it bundles via tsup, not `tsc -d`).
+ *
+ * `GovernanceEntryInput`/`GovernanceCollectionInput`/`ClassifiedGovernance` below remain
+ * hand-declared (never re-exported from kernel-client — same self-contained-declaration
+ * reasoning now applies to them too, not just out of scope).
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration), TEN-2733, TEN-2705
+ */
+export {};
+//# sourceMappingURL=chain-classifier.js.map

package/dist/generators/chain-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-classifier.js","sourceRoot":"","sources":["../../src/generators/chain-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG"}

package/dist/generators/chain-rules.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Chain Rules Assembler — BET-286 Slice 3
+ *
+ * Fetches governance entries via MCP, classifies them, resolves archetype
+ * templates, and returns CanonicalRule objects ready to merge into the
+ * canonical rules array in runHandshake().
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration)
+ */
+import type { CanonicalRule } from './portable-knowledge.js';
+import type { kernelCall as McpCallFn } from '../lib/client.js';
+/** Statistics from a generateChainRules() call. */
+export interface ChainRulesStats {
+    totalEntries: number;
+    classifiedEntries: number;
+    generatedRules: number;
+    suppressedByManual: number;
+    suppressedByZeroEntries: number;
+}
+/** Result returned by generateChainRules(). */
+export interface ChainRulesResult {
+    /** Generated rules ready to merge into canonical rules array. */
+    rules: CanonicalRule[];
+    /** Function keys with no matching governance entries. */
+    gaps: string[];
+    /** Sentinel rule when MCP is unreachable — null on success. */
+    sentinel: CanonicalRule | null;
+    stats: ChainRulesStats;
+    /** Classified governance entries — passed through for diff engine confidence data. */
+    classified: import('./chain-classifier.js').ClassifiedGovernance[];
+}
+/**
+ * Fetch governance entries, classify them, resolve archetypes, and produce
+ * CanonicalRule objects ready to merge into the handshake pipeline.
+ *
+ * @param kernelCallFn - Injected kernelCall function for testability.
+ * @param manualRules - Existing manual rules from .productbrain/rules/.
+ *                      Used to suppress generated rules when a manual rule
+ *                      with the same name already exists.
+ */
+export declare function generateChainRules(kernelCallFn: typeof McpCallFn, manualRules: CanonicalRule[]): Promise<ChainRulesResult>;
+//# sourceMappingURL=chain-rules.d.ts.map

package/dist/generators/chain-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-rules.d.ts","sourceRoot":"","sources":["../../src/generators/chain-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKhE,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,yDAAyD;IACzD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+DAA+D;IAC/D,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,sFAAsF;IACtF,UAAU,EAAE,OAAO,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;CACpE;AAkCD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,OAAO,SAAS,EAC9B,WAAW,EAAE,aAAa,EAAE,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA+M3B"}