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

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

@@ -0,0 +1,63 @@
+/**
+ * Chain Classifier — BET-286 Slice 1
+ *
+ * Pure function that maps governance entries (from getGovernanceWithRelations)
+ * to the governance function each entry serves. No LLM, no network calls.
+ * Deterministic: same input always produces same output.
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration)
+ */
+/** The governance functions that archetypes exist for. */
+export type GovernanceFunction = 'constraint' | 'boundary' | 'convention' | 'policy' | 'workflow' | 'quality-gate' | 'unclassified';
+/** Typed relation edge — mirrors GovernanceRelationEdge from convex/agentKnowledge/governanceQuery.ts */
+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. */
+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[];
+}
+/**
+ * Classify a batch of governance entries, returning one ClassifiedGovernance
+ * per entry that has a non-null entryId. Entries with null entryId are silently
+ * excluded (safety guard — entries without IDs cannot be referenced by archetypes).
+ */
+export declare function classifyGovernance(entries: GovernanceEntryInput[], collections?: GovernanceCollectionInput[]): ClassifiedGovernance[];
+//# 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;;;;;;;;GAQG;AAIH,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,cAAc,GACd,cAAc,CAAC;AAEnB,yGAAyG;AACzG,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,uDAAuD;AACvD,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;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,WAAW,GAAE,yBAAyB,EAAO,GAC5C,oBAAoB,EAAE,CAwFxB"}

package/dist/generators/chain-classifier.js

@@ -0,0 +1,131 @@
+/**
+ * Chain Classifier — BET-286 Slice 1
+ *
+ * Pure function that maps governance entries (from getGovernanceWithRelations)
+ * to the governance function each entry serves. No LLM, no network calls.
+ * Deterministic: same input always produces same output.
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration)
+ */
+/** Base score awarded for a collection-type match. */
+const COLLECTION_BASE_SCORE = 0.45;
+/** Score boost for a supporting relation type match. */
+const RELATION_BOOST = 0.2;
+/** Score boost for a supporting name pattern match. */
+const NAME_BOOST = 0.15;
+/**
+ * Relation-type signals that boost a governance function.
+ * Key: relation type string (lowercased).
+ * Value: [governanceFunction, boost].
+ */
+const RELATION_SIGNALS = [
+    { type: 'constrains', fn: 'constraint', boost: RELATION_BOOST },
+    { type: 'governs', fn: 'policy', boost: RELATION_BOOST },
+    { type: 'part_of', fn: 'workflow', boost: RELATION_BOOST },
+];
+// ── Classifier ────────────────────────────────────────────────────────
+/**
+ * Classify a batch of governance entries, returning one ClassifiedGovernance
+ * per entry that has a non-null entryId. Entries with null entryId are silently
+ * excluded (safety guard — entries without IDs cannot be referenced by archetypes).
+ */
+export function classifyGovernance(entries, collections = []) {
+    const results = [];
+    const collectionBySlug = new Map(collections.map((c) => [c.slug, c]));
+    for (const entry of entries) {
+        // Safety: skip entries without a human-readable ID
+        if (entry.entryId === null)
+            continue;
+        const scores = new Map();
+        const signals = [];
+        const slug = entry.collectionSlug;
+        const collection = collectionBySlug.get(slug);
+        // ── Signal 1: Collection type (strongest) ──────────────────────
+        const primaryFn = inferCollectionGovernanceFunction(collection, entry);
+        if (primaryFn && primaryFn !== 'unclassified') {
+            addScore(scores, primaryFn, COLLECTION_BASE_SCORE);
+            signals.push(`collection metadata '${slug}' → ${primaryFn}`);
+        }
+        // ── Signal 2: Relation types (refining) ───────────────────────
+        for (const rel of entry.relations) {
+            const relTypeLower = rel.type.toLowerCase();
+            for (const sig of RELATION_SIGNALS) {
+                if (relTypeLower === sig.type) {
+                    addScore(scores, sig.fn, sig.boost);
+                    signals.push(`relation '${rel.type}' → boost ${sig.fn}`);
+                }
+            }
+            if (relTypeLower === 'informed_by' && rel.otherCollectionSlug) {
+                const otherFn = inferCollectionGovernanceFunction(collectionBySlug.get(rel.otherCollectionSlug));
+                if (otherFn === 'boundary') {
+                    // Boost only (matches Signal-2 convention above): an informed_by edge
+                    // REFINES the score, it must not contribute a full collection base —
+                    // otherwise a single edge outscores the entry's own collection signal.
+                    addScore(scores, 'boundary', RELATION_BOOST);
+                    signals.push(`relation '${rel.type}' to boundary collection '${rel.otherCollectionSlug}' → boost boundary`);
+                }
+            }
+        }
+        // ── Signal 3: Workspace collection name signals (weakest) ────
+        if (primaryFn && collection?.classificationSignals?.length) {
+            const entryText = entry.name.toLowerCase();
+            const matchedSignal = collection.classificationSignals.find((signal) => entryText.includes(signal.toLowerCase()));
+            if (matchedSignal) {
+                addScore(scores, primaryFn, NAME_BOOST);
+                signals.push(`collection signal '${matchedSignal}' → boost ${primaryFn}`);
+            }
+        }
+        // ── Pick winner ───────────────────────────────────────────────
+        let bestFn = 'unclassified';
+        let bestScore = 0;
+        for (const [fn, score] of scores) {
+            if (score > bestScore) {
+                bestScore = score;
+                bestFn = fn;
+            }
+        }
+        if (collection?.governanceFunction === 'unclassified') {
+            bestFn = 'unclassified';
+            bestScore = 0;
+        }
+        // Confidence: clamp to [0, 1]
+        const confidence = Math.min(1, Math.max(0, bestScore));
+        results.push({
+            entryId: entry.entryId,
+            name: entry.name,
+            collectionSlug: entry.collectionSlug,
+            governanceFunction: bestFn,
+            confidence,
+            matchedSignals: signals,
+            data: entry.data,
+            relations: entry.relations,
+        });
+    }
+    return results;
+}
+// ── Helpers ────────────────────────────────────────────────────────────
+function addScore(scores, fn, delta) {
+    scores.set(fn, (scores.get(fn) ?? 0) + delta);
+}
+function inferCollectionGovernanceFunction(collection, entry) {
+    const explicit = normalizeGovernanceFunction(collection?.governanceFunction);
+    if (explicit)
+        return explicit;
+    const dataFn = normalizeGovernanceFunction(entry?.data?.governanceFunction);
+    if (dataFn)
+        return dataFn;
+    return 'unclassified';
+}
+function normalizeGovernanceFunction(value) {
+    if (value === 'constraint' ||
+        value === 'boundary' ||
+        value === 'convention' ||
+        value === 'policy' ||
+        value === 'workflow' ||
+        value === 'quality-gate' ||
+        value === 'unclassified') {
+        return value;
+    }
+    return null;
+}
+//# 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":"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"}

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

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

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

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

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

@@ -0,0 +1,371 @@
+/**
+ * chain-classifier — unit tests.
+ * BET-286 Slice 1: relation-aware governance function classifier.
+ */
+import { describe, expect, it } from 'vitest';
+import { classifyGovernance, } from './chain-classifier.js';
+// ── Helpers ────────────────────────────────────────────────────────────
+function makeEntry(overrides) {
+    return {
+        status: 'committed',
+        verificationStatus: null,
+        data: null,
+        relations: [],
+        ...overrides,
+    };
+}
+function makeRelation(overrides) {
+    return {
+        direction: 'outgoing',
+        otherEntryId: null,
+        otherName: 'other entry',
+        otherCollectionSlug: null,
+        ...overrides,
+    };
+}
+const COLLECTIONS = [
+    {
+        slug: 'standards',
+        name: 'Standards',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'standard',
+        governanceFunction: 'constraint',
+        classificationSignals: ['quality', 'test', 'gate'],
+        usageGuidance: 'Rules and standards that constrain behavior and must be followed.',
+    },
+    {
+        slug: 'business-rules',
+        name: 'Business Rules',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'business-rule',
+        governanceFunction: 'constraint',
+        classificationSignals: ['auth', 'security'],
+        usageGuidance: 'Operational rules that constrain product behavior and govern workflows.',
+    },
+    {
+        slug: 'architecture',
+        name: 'Architecture',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'architecture_note',
+        governanceFunction: 'boundary',
+        usageGuidance: 'Architecture notes that define system boundaries, interfaces, domains, and layers.',
+    },
+    {
+        slug: 'decisions',
+        name: 'Decisions',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'decision',
+        governanceFunction: 'convention',
+        classificationSignals: ['deployment'],
+        usageGuidance: 'Decisions record choices, practices, and conventions.',
+    },
+    {
+        slug: 'patterns',
+        name: 'Patterns',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'pattern',
+        governanceFunction: 'convention',
+        usageGuidance: 'Reusable patterns and conventions.',
+    },
+    {
+        slug: 'policies',
+        name: 'Policies',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'policy',
+        governanceFunction: 'policy',
+        usageGuidance: 'Policies for access, permissions, auth, and security.',
+    },
+    {
+        slug: 'flows',
+        name: 'Flows',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'flow',
+        governanceFunction: 'workflow',
+        usageGuidance: 'Workflow and process lifecycle definitions.',
+    },
+    {
+        slug: 'glossary',
+        name: 'Glossary',
+        governanceRole: 'reference',
+        defaultCanonicalKey: 'glossary_term',
+        governanceFunction: 'unclassified',
+        usageGuidance: 'Reference definitions.',
+    },
+    {
+        slug: 'compliance-gates',
+        name: 'Compliance Gates',
+        governanceRole: 'binding',
+        defaultCanonicalKey: 'quality_gate',
+        governanceFunction: 'quality-gate',
+        classificationSignals: ['coverage', 'verification'],
+        usageGuidance: 'Quality gates and verification checks.',
+    },
+];
+// ── Test cases ─────────────────────────────────────────────────────────
+describe('classifyGovernance — collection signal', () => {
+    it('STD entry with constrains relation → constraint with high confidence (>=0.6)', () => {
+        const entry = makeEntry({
+            entryId: 'STD-1',
+            name: 'Trunk-based development standard',
+            collectionSlug: 'standards',
+            relations: [makeRelation({ type: 'constrains', otherCollectionSlug: 'bets' })],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('constraint');
+        expect(results[0].confidence).toBeGreaterThanOrEqual(0.6);
+    });
+    it('ARCH entry → boundary with medium confidence (>=0.4)', () => {
+        const entry = makeEntry({
+            entryId: 'ARCH-1',
+            name: 'Seven system domains',
+            collectionSlug: 'architecture',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('boundary');
+        expect(results[0].confidence).toBeGreaterThanOrEqual(0.4);
+    });
+    it('DEC entry with deployment in name → convention with boosted confidence', () => {
+        const entry = makeEntry({
+            entryId: 'DEC-1',
+            name: 'deployment ordering for Convex and Railway',
+            collectionSlug: 'decisions',
+        });
+        const noNameEntry = makeEntry({
+            entryId: 'DEC-2',
+            name: 'some decision',
+            collectionSlug: 'decisions',
+        });
+        const withName = classifyGovernance([entry], COLLECTIONS);
+        const withoutName = classifyGovernance([noNameEntry], COLLECTIONS);
+        expect(withName[0].governanceFunction).toBe('convention');
+        expect(withName[0].confidence).toBeGreaterThan(withoutName[0].confidence);
+    });
+    it('FLOW entry → workflow', () => {
+        const entry = makeEntry({
+            entryId: 'FLOW-1',
+            name: 'Feature flag lifecycle flow',
+            collectionSlug: 'flows',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('workflow');
+    });
+    it('POL entry with governs relation → policy with high confidence', () => {
+        const entry = makeEntry({
+            entryId: 'POL-1',
+            name: 'Access control policy',
+            collectionSlug: 'policies',
+            relations: [makeRelation({ type: 'governs', otherCollectionSlug: 'bets' })],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('policy');
+        expect(results[0].confidence).toBeGreaterThanOrEqual(0.6);
+    });
+    it('custom quality-gate collection → quality-gate from explicit metadata', () => {
+        const entry = makeEntry({
+            entryId: 'QG-2',
+            name: 'Test coverage quality gate for all slices',
+            collectionSlug: 'compliance-gates',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('quality-gate');
+        expect(results[0].confidence).toBeGreaterThanOrEqual(0.5);
+    });
+});
+describe('classifyGovernance — null entryId safety', () => {
+    it('entry with null entryId is excluded from output', () => {
+        const entry = makeEntry({
+            entryId: null,
+            name: 'Draft entry without ID',
+            collectionSlug: 'standards',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(0);
+    });
+});
+describe('classifyGovernance — empty input', () => {
+    it('empty input → empty output', () => {
+        const results = classifyGovernance([], COLLECTIONS);
+        expect(results).toHaveLength(0);
+    });
+});
+describe('classifyGovernance — unclassified', () => {
+    it('glossary entry → unclassified regardless of signals', () => {
+        const entry = makeEntry({
+            entryId: 'GLO-1',
+            name: 'Trunk-based development',
+            collectionSlug: 'glossary',
+            relations: [makeRelation({ type: 'constrains' })],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        expect(results[0].governanceFunction).toBe('unclassified');
+        expect(results[0].confidence).toBe(0);
+    });
+});
+describe('classifyGovernance — multiple signal matches', () => {
+    it('entry with multiple signals → highest confidence function wins', () => {
+        // BR entry with both constrains AND governs relations.
+        // constrains boosts 'constraint', governs boosts 'policy'.
+        // business-rules base maps to 'constraint', so constraint should win.
+        const entry = makeEntry({
+            entryId: 'BR-1',
+            name: 'Entry creation must use createEntry gate',
+            collectionSlug: 'business-rules',
+            relations: [
+                makeRelation({ type: 'constrains' }),
+                makeRelation({ type: 'constrains' }),
+                makeRelation({ type: 'governs' }),
+            ],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results).toHaveLength(1);
+        // Both constraint and policy are plausible; the function with the highest score wins.
+        // With 2x constrains boosts, constraint should dominate.
+        expect(results[0].governanceFunction).toBe('constraint');
+        expect(results[0].confidence).toBeGreaterThanOrEqual(0.6);
+    });
+});
+describe('classifyGovernance — passthrough fields', () => {
+    it('passes data and relations through to result', () => {
+        const data = { someField: 'someValue' };
+        const relation = makeRelation({ type: 'constrains' });
+        const entry = makeEntry({
+            entryId: 'STD-99',
+            name: 'Some standard',
+            collectionSlug: 'standards',
+            data,
+            relations: [relation],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results[0].data).toBe(data);
+        expect(results[0].relations).toEqual([relation]);
+    });
+    it('returns entryId, name, and collectionSlug unchanged', () => {
+        const entry = makeEntry({
+            entryId: 'ARCH-42',
+            name: 'My architecture entry',
+            collectionSlug: 'architecture',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results[0].entryId).toBe('ARCH-42');
+        expect(results[0].name).toBe('My architecture entry');
+        expect(results[0].collectionSlug).toBe('architecture');
+    });
+});
+describe('classifyGovernance — name signal boosts', () => {
+    it('workspace collection signals boost that collection metadata function', () => {
+        const withKeyword = makeEntry({
+            entryId: 'BR-2',
+            name: 'Auth security check before MCP tool execution',
+            collectionSlug: 'business-rules',
+        });
+        const withoutKeyword = makeEntry({
+            entryId: 'BR-3',
+            name: 'Some business rule',
+            collectionSlug: 'business-rules',
+        });
+        const [withResult] = classifyGovernance([withKeyword], COLLECTIONS);
+        const [withoutResult] = classifyGovernance([withoutKeyword], COLLECTIONS);
+        expect(withResult.governanceFunction).toBe('constraint');
+        expect(withResult.confidence).toBeGreaterThan(withoutResult.confidence);
+        expect(withoutResult.governanceFunction).toBe('constraint');
+    });
+    it('matchedSignals contains human-readable explanations', () => {
+        const entry = makeEntry({
+            entryId: 'STD-5',
+            name: 'Quality gate for test coverage',
+            collectionSlug: 'standards',
+            relations: [makeRelation({ type: 'constrains' })],
+        });
+        const [result] = classifyGovernance([entry], COLLECTIONS);
+        expect(result.matchedSignals.length).toBeGreaterThan(0);
+        expect(result.matchedSignals.some((s) => s.includes('standards'))).toBe(true);
+    });
+});
+describe('classifyGovernance — mixed null/non-null entryIds', () => {
+    it('only entries with non-null entryIds are returned', () => {
+        const entries = [
+            makeEntry({ entryId: 'STD-1', name: 'Valid standard', collectionSlug: 'standards' }),
+            makeEntry({ entryId: null, name: 'Draft entry', collectionSlug: 'standards' }),
+            makeEntry({ entryId: 'ARCH-2', name: 'Architecture entry', collectionSlug: 'architecture' }),
+        ];
+        const results = classifyGovernance(entries, COLLECTIONS);
+        expect(results).toHaveLength(2);
+        expect(results.map((r) => r.entryId)).toEqual(['STD-1', 'ARCH-2']);
+    });
+});
+describe('classifyGovernance — patterns collection', () => {
+    it('PAT entry → convention', () => {
+        const entry = makeEntry({
+            entryId: 'PAT-1',
+            name: 'Additive wrapping pattern for feature flags',
+            collectionSlug: 'patterns',
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results[0].governanceFunction).toBe('convention');
+    });
+});
+describe('classifyGovernance — informed_by ARCH relation boosts boundary', () => {
+    it('DEC informed_by an architecture entry → keeps own convention; one informed_by edge boosts but does not override the entry base', () => {
+        // A single informed_by→boundary edge must REFINE, not OVERRIDE, the entry's
+        // own collection signal. The boost is RELATION_BOOST (0.2), never a full
+        // base, so the entry's own convention base (0.45) still wins.
+        const entry = makeEntry({
+            entryId: 'DEC-5',
+            name: 'Domain boundaries for the seven layers',
+            collectionSlug: 'decisions',
+            relations: [
+                makeRelation({
+                    type: 'informed_by',
+                    direction: 'outgoing',
+                    otherCollectionSlug: 'architecture',
+                    otherName: 'Seven system domains',
+                    otherEntryId: 'ARCH-26',
+                }),
+            ],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results[0].governanceFunction).toBe('convention');
+    });
+    it('informed_by→boundary still lifts an entry with no own collection base to boundary', () => {
+        // Guard: the boost must remain a real signal. An entry whose own collection
+        // carries no governanceFunction (no base) classifies to boundary purely from
+        // the informed_by→architecture edge.
+        const entry = makeEntry({
+            entryId: 'X-1',
+            name: 'Some cross-cutting note',
+            collectionSlug: 'uncatalogued-collection',
+            relations: [
+                makeRelation({
+                    type: 'informed_by',
+                    direction: 'outgoing',
+                    otherCollectionSlug: 'architecture',
+                    otherName: 'Seven system domains',
+                    otherEntryId: 'ARCH-26',
+                }),
+            ],
+        });
+        const results = classifyGovernance([entry], COLLECTIONS);
+        expect(results[0].governanceFunction).toBe('boundary');
+    });
+    it('custom slugs classify from governanceFunction metadata, not PB slug names', () => {
+        const collections = [
+            { slug: 'working-agreements', governanceRole: 'binding', governanceFunction: 'constraint' },
+            { slug: 'system-shape', governanceRole: 'binding', governanceFunction: 'boundary' },
+        ];
+        const results = classifyGovernance([
+            makeEntry({ entryId: 'WA-1', name: 'Team agreement', collectionSlug: 'working-agreements' }),
+            makeEntry({ entryId: 'SYS-1', name: 'System boundary', collectionSlug: 'system-shape' }),
+        ], collections);
+        expect(results.map((r) => [r.collectionSlug, r.governanceFunction])).toEqual([
+            ['working-agreements', 'constraint'],
+            ['system-shape', 'boundary'],
+        ]);
+    });
+});
+//# sourceMappingURL=chain-classifier.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain-classifier.test.js","sourceRoot":"","sources":["../../src/generators/chain-classifier.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,GAInB,MAAM,uBAAuB,CAAC;AAE/B,0EAA0E;AAE1E,SAAS,SAAS,CAAC,SAA2G;IAC5H,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,kBAAkB,EAAE,IAAI;QACxB,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,EAAE;QACb,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,SAA6D;IACjF,OAAO;QACL,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,aAAa;QACxB,mBAAmB,EAAE,IAAI;QACzB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAgC;IAC/C;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,UAAU;QAC/B,kBAAkB,EAAE,YAAY;QAChC,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;QAClD,aAAa,EAAE,mEAAmE;KACnF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,gBAAgB;QACtB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,eAAe;QACpC,kBAAkB,EAAE,YAAY;QAChC,qBAAqB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;QAC3C,aAAa,EAAE,yEAAyE;KACzF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,cAAc;QACpB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,mBAAmB;QACxC,kBAAkB,EAAE,UAAU;QAC9B,aAAa,EAAE,oFAAoF;KACpG;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,UAAU;QAC/B,kBAAkB,EAAE,YAAY;QAChC,qBAAqB,EAAE,CAAC,YAAY,CAAC;QACrC,aAAa,EAAE,uDAAuD;KACvE;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,SAAS;QAC9B,kBAAkB,EAAE,YAAY;QAChC,aAAa,EAAE,oCAAoC;KACpD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,QAAQ;QAC7B,kBAAkB,EAAE,QAAQ;QAC5B,aAAa,EAAE,uDAAuD;KACvE;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,MAAM;QAC3B,kBAAkB,EAAE,UAAU;QAC9B,aAAa,EAAE,6CAA6C;KAC7D;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,cAAc,EAAE,WAAW;QAC3B,mBAAmB,EAAE,eAAe;QACpC,kBAAkB,EAAE,cAAc;QAClC,aAAa,EAAE,wBAAwB;KACxC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,kBAAkB;QACxB,cAAc,EAAE,SAAS;QACzB,mBAAmB,EAAE,cAAc;QACnC,kBAAkB,EAAE,cAAc;QAClC,qBAAqB,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;QACnD,aAAa,EAAE,wCAAwC;KACxD;CACF,CAAC;AAEF,0EAA0E;AAE1E,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,kCAAkC;YACxC,cAAc,EAAE,WAAW;YAC3B,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC;SAC/E,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,sBAAsB;YAC5B,cAAc,EAAE,cAAc;SAC/B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,4CAA4C;YAClD,cAAc,EAAE,WAAW;SAC5B,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,SAAS,CAAC;YAC5B,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,eAAe;YACrB,cAAc,EAAE,WAAW;SAC5B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAEnE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,6BAA6B;YACnC,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,uBAAuB;YAC7B,cAAc,EAAE,UAAU;YAC1B,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC;SAC5E,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,2CAA2C;YACjD,cAAc,EAAE,kBAAkB;SACnC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,wBAAwB;YAC9B,cAAc,EAAE,WAAW;SAC5B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,yBAAyB;YAC/B,cAAc,EAAE,UAAU;YAC1B,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,uDAAuD;QACvD,2DAA2D;QAC3D,sEAAsE;QACtE,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,0CAA0C;YAChD,cAAc,EAAE,gBAAgB;YAChC,SAAS,EAAE;gBACT,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;gBACpC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;gBACpC,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aAClC;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,sFAAsF;QACtF,yDAAyD;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,eAAe;YACrB,cAAc,EAAE,WAAW;YAC3B,IAAI;YACJ,SAAS,EAAE,CAAC,QAAQ,CAAC;SACtB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,uBAAuB;YAC7B,cAAc,EAAE,cAAc;SAC/B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,WAAW,GAAG,SAAS,CAAC;YAC5B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,+CAA+C;YACrD,cAAc,EAAE,gBAAgB;SACjC,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,SAAS,CAAC;YAC/B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,oBAAoB;YAC1B,cAAc,EAAE,gBAAgB;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,GAAG,kBAAkB,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QACpE,MAAM,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAAC,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,CAAC;QAE1E,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,gCAAgC;YACtC,cAAc,EAAE,WAAW;YAC3B,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,OAAO,GAAG;YACd,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;YACpF,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;YAC9E,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;SAC7F,CAAC;QAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,6CAA6C;YACnD,cAAc,EAAE,UAAU;SAC3B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC9E,EAAE,CAAC,gIAAgI,EAAE,GAAG,EAAE;QACxI,4EAA4E;QAC5E,yEAAyE;QACzE,8DAA8D;QAC9D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,wCAAwC;YAC9C,cAAc,EAAE,WAAW;YAC3B,SAAS,EAAE;gBACT,YAAY,CAAC;oBACX,IAAI,EAAE,aAAa;oBACnB,SAAS,EAAE,UAAU;oBACrB,mBAAmB,EAAE,cAAc;oBACnC,SAAS,EAAE,sBAAsB;oBACjC,YAAY,EAAE,SAAS;iBACxB,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,4EAA4E;QAC5E,6EAA6E;QAC7E,qCAAqC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,yBAAyB;YAC/B,cAAc,EAAE,yBAAyB;YACzC,SAAS,EAAE;gBACT,YAAY,CAAC;oBACX,IAAI,EAAE,aAAa;oBACnB,SAAS,EAAE,UAAU;oBACrB,mBAAmB,EAAE,cAAc;oBACnC,SAAS,EAAE,sBAAsB;oBACjC,YAAY,EAAE,SAAS;iBACxB,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,WAAW,GAAgC;YAC/C,EAAE,IAAI,EAAE,oBAAoB,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE;YAC3F,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,UAAU,EAAE;SACpF,CAAC;QACF,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC;YAC5F,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;SACzF,EAAE,WAAW,CAAC,CAAC;QAEhB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3E,CAAC,oBAAoB,EAAE,YAAY,CAAC;YACpC,CAAC,cAAc,EAAE,UAAU,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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;AAI7D,OAAO,KAAK,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIhE,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,CA4F3B"}