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

package/dist/generators/handshake-diff.js

@@ -0,0 +1,183 @@
+/**
+ * Handshake Diff — BET-286 Slice 4
+ *
+ * Persists handshake --generate state between runs and produces a diff
+ * showing what changed (added, removed, changed rules) since the last run.
+ *
+ * Chain: BET-286 (Chain-Derived Agent Configuration)
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+// ── State file path ────────────────────────────────────────────────────
+const STATE_FILENAME = '.handshake-state.json';
+function stateFilePath(pbDir) {
+    return join(pbDir, STATE_FILENAME);
+}
+// ── State builder ─────────────────────────────────────────────────────
+/**
+ * Build a HandshakeStateRule from a CanonicalRule and classified governance entries.
+ * Only applies to chain:// sourced rules.
+ */
+function buildStateRule(rule, classified) {
+    // Extract function key from sourcePath ('chain://<functionKey>')
+    const functionKey = rule.sourcePath.replace('chain://', '');
+    // Find all entries that classified to this governance function
+    const matching = classified.filter((e) => e.governanceFunction === functionKey);
+    const entryIds = matching.map((e) => e.entryId);
+    // Average confidence across contributing entries (0 if none matched)
+    const confidence = matching.length > 0
+        ? Math.round((matching.reduce((sum, e) => sum + e.confidence, 0) / matching.length) * 100) / 100
+        : 0;
+    return {
+        name: rule.name,
+        functionKey,
+        sourcePath: rule.sourcePath,
+        confidence,
+        entryIds,
+    };
+}
+// ── Public API ─────────────────────────────────────────────────────────
+/**
+ * Build a HandshakeState in memory from rules and classified entries.
+ * Only includes chain:// sourced rules (ignores manual rules).
+ * Filters out the sentinel rule (chain://_sentinel) to avoid diff noise.
+ */
+export function buildCurrentState(rules, classified) {
+    const chainRules = rules.filter((r) => r.sourcePath.startsWith('chain://') && r.sourcePath !== 'chain://_sentinel');
+    return {
+        timestamp: new Date().toISOString(),
+        rules: chainRules.map((r) => buildStateRule(r, classified)),
+    };
+}
+/**
+ * Save current handshake state to .productbrain/.handshake-state.json.
+ * Only persists chain:// sourced rules (ignores manual rules and sentinel).
+ */
+export function saveHandshakeState(pbDir, rules, classified) {
+    const state = buildCurrentState(rules, classified);
+    writeFileSync(stateFilePath(pbDir), JSON.stringify(state, null, 2) + '\n');
+}
+/**
+ * Load previous handshake state from .productbrain/.handshake-state.json.
+ * Returns null if no previous state exists or the file cannot be parsed.
+ */
+export function loadPreviousState(pbDir) {
+    const filePath = stateFilePath(pbDir);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`Warning: failed to parse ${filePath} — ${err instanceof Error ? err.message : err}\n`);
+        return null;
+    }
+}
+/**
+ * Compare current rules against previous state and produce a diff.
+ * When previous is null, all current rules are reported as added (first run).
+ */
+export function diffHandshakeState(current, previous) {
+    if (previous === null) {
+        return {
+            added: current.rules.map((r) => ({
+                name: r.name,
+                change: 'added',
+                details: `confidence: ${r.confidence}, ${r.entryIds.length} entries`,
+            })),
+            removed: [],
+            changed: [],
+            isFirstRun: true,
+        };
+    }
+    const currentByName = new Map(current.rules.map((r) => [r.name, r]));
+    const previousByName = new Map(previous.rules.map((r) => [r.name, r]));
+    const added = [];
+    const removed = [];
+    const changed = [];
+    // Added: in current but not previous
+    for (const [name, rule] of currentByName) {
+        if (!previousByName.has(name)) {
+            added.push({
+                name,
+                change: 'added',
+                details: `confidence: ${rule.confidence}, ${rule.entryIds.length} entries`,
+            });
+        }
+    }
+    // Removed: in previous but not current
+    for (const [name] of previousByName) {
+        if (!currentByName.has(name)) {
+            removed.push({
+                name,
+                change: 'removed',
+                details: 'removed — no matching entries',
+            });
+        }
+    }
+    // Changed: in both but different
+    for (const [name, curr] of currentByName) {
+        const prev = previousByName.get(name);
+        if (!prev)
+            continue; // handled as added above
+        const details = buildChangedDetails(prev, curr);
+        if (details !== null) {
+            changed.push({ name, change: 'changed', details });
+        }
+    }
+    return { added, removed, changed, isFirstRun: false };
+}
+/**
+ * Build a details string for a changed rule. Returns null if no meaningful change detected.
+ */
+function buildChangedDetails(prev, curr) {
+    const parts = [];
+    // Confidence delta — only report if it changed
+    if (prev.confidence !== curr.confidence) {
+        parts.push(`confidence: ${prev.confidence} → ${curr.confidence}`);
+    }
+    // Entry changes — compute added/removed entry IDs
+    const prevSet = new Set(prev.entryIds);
+    const currSet = new Set(curr.entryIds);
+    const addedEntries = curr.entryIds.filter((id) => !prevSet.has(id));
+    const removedEntries = prev.entryIds.filter((id) => !currSet.has(id));
+    if (addedEntries.length > 0 || removedEntries.length > 0) {
+        const entryParts = [];
+        if (addedEntries.length > 0)
+            entryParts.push(...addedEntries.map((id) => `+${id}`));
+        if (removedEntries.length > 0)
+            entryParts.push(...removedEntries.map((id) => `-${id}`));
+        parts.push(`entries: ${entryParts.join(', ')}`);
+    }
+    if (parts.length === 0)
+        return null;
+    return parts.join(', ');
+}
+/**
+ * Format a HandshakeDiff for console output.
+ */
+export function formatDiff(diff) {
+    if (diff.isFirstRun) {
+        return 'First run — no previous state to compare.';
+    }
+    const hasChanges = diff.added.length > 0 || diff.removed.length > 0 || diff.changed.length > 0;
+    if (!hasChanges) {
+        return 'No changes.';
+    }
+    const lines = ['Handshake diff (vs previous run):'];
+    for (const rule of diff.added) {
+        const detail = rule.details ? ` (${rule.details})` : '';
+        lines.push(`  + ${rule.name}${detail}`);
+    }
+    for (const rule of diff.removed) {
+        const detail = rule.details ? ` (${rule.details})` : '';
+        lines.push(`  - ${rule.name}${detail}`);
+    }
+    for (const rule of diff.changed) {
+        const detail = rule.details ? ` (${rule.details})` : '';
+        lines.push(`  ~ ${rule.name}${detail}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=handshake-diff.js.map

package/dist/generators/handshake-diff.js.map

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

package/dist/generators/handshake-diff.test.d.ts

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

package/dist/generators/handshake-diff.test.d.ts.map

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

package/dist/generators/handshake-diff.test.js

@@ -0,0 +1,264 @@
+/**
+ * handshake-diff — unit tests.
+ * BET-286 Slice 4: diff engine for handshake --generate runs.
+ */
+import { afterEach, describe, expect, it } from 'vitest';
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { saveHandshakeState, loadPreviousState, diffHandshakeState, formatDiff, } from './handshake-diff.js';
+// ── Helpers ────────────────────────────────────────────────────────────
+function makeTempDir() {
+    const dir = join(tmpdir(), `handshake-diff-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function makeCanonicalRule(overrides) {
+    return {
+        description: 'A rule description',
+        body: 'Rule body content',
+        autoApply: true,
+        level: 'core',
+        scope: undefined,
+        targets: undefined,
+        ...overrides,
+    };
+}
+function makeClassifiedEntry(overrides) {
+    return {
+        name: `Entry ${overrides.entryId}`,
+        collectionSlug: 'standards',
+        confidence: 0.65,
+        matchedSignals: ['collection \'standards\' → constraint'],
+        data: null,
+        relations: [],
+        ...overrides,
+    };
+}
+function makeHandshakeState(rules, timestamp = '2024-01-01T00:00:00.000Z') {
+    return { timestamp, rules };
+}
+function makeStateRule(overrides) {
+    return {
+        functionKey: 'constraint',
+        sourcePath: 'chain://constraint',
+        confidence: 0.65,
+        entryIds: ['STD-1'],
+        ...overrides,
+    };
+}
+// Track temp dirs for cleanup
+const tempDirs = [];
+afterEach(() => {
+    for (const dir of tempDirs) {
+        if (existsSync(dir))
+            rmSync(dir, { recursive: true, force: true });
+    }
+    tempDirs.length = 0;
+});
+// ── Tests ──────────────────────────────────────────────────────────────
+describe('loadPreviousState', () => {
+    it('returns null when no state file exists', () => {
+        const dir = makeTempDir();
+        tempDirs.push(dir);
+        const result = loadPreviousState(dir);
+        expect(result).toBeNull();
+    });
+    it('returns null when state file contains invalid JSON', () => {
+        const dir = makeTempDir();
+        tempDirs.push(dir);
+        writeFileSync(join(dir, '.handshake-state.json'), 'not valid json', 'utf8');
+        const result = loadPreviousState(dir);
+        expect(result).toBeNull();
+    });
+});
+describe('saveHandshakeState', () => {
+    it('creates a valid JSON state file', () => {
+        const dir = makeTempDir();
+        tempDirs.push(dir);
+        const rules = [
+            makeCanonicalRule({ name: 'chain-constraints', sourcePath: 'chain://constraint' }),
+        ];
+        const classified = [
+            makeClassifiedEntry({ entryId: 'STD-1', governanceFunction: 'constraint', confidence: 0.65 }),
+        ];
+        saveHandshakeState(dir, rules, classified);
+        const loaded = loadPreviousState(dir);
+        expect(loaded).not.toBeNull();
+        expect(loaded.rules).toHaveLength(1);
+        expect(loaded.rules[0].name).toBe('chain-constraints');
+        expect(loaded.rules[0].functionKey).toBe('constraint');
+        expect(loaded.rules[0].sourcePath).toBe('chain://constraint');
+        expect(loaded.rules[0].entryIds).toEqual(['STD-1']);
+        expect(loaded.rules[0].confidence).toBe(0.65);
+        expect(typeof loaded.timestamp).toBe('string');
+    });
+    it('only saves chain:// rules (ignores manual rules)', () => {
+        const dir = makeTempDir();
+        tempDirs.push(dir);
+        const rules = [
+            makeCanonicalRule({ name: 'chain-constraints', sourcePath: 'chain://constraint' }),
+            makeCanonicalRule({ name: 'my-manual-rule', sourcePath: '.productbrain/rules/my-manual-rule.md' }),
+        ];
+        const classified = [];
+        saveHandshakeState(dir, rules, classified);
+        const loaded = loadPreviousState(dir);
+        expect(loaded.rules).toHaveLength(1);
+        expect(loaded.rules[0].name).toBe('chain-constraints');
+    });
+    it('averages confidence across multiple entries for the same function', () => {
+        const dir = makeTempDir();
+        tempDirs.push(dir);
+        const rules = [
+            makeCanonicalRule({ name: 'chain-constraints', sourcePath: 'chain://constraint' }),
+        ];
+        const classified = [
+            makeClassifiedEntry({ entryId: 'STD-1', governanceFunction: 'constraint', confidence: 0.5 }),
+            makeClassifiedEntry({ entryId: 'STD-2', governanceFunction: 'constraint', confidence: 0.9 }),
+        ];
+        saveHandshakeState(dir, rules, classified);
+        const loaded = loadPreviousState(dir);
+        expect(loaded.rules[0].confidence).toBe(0.7); // (0.5 + 0.9) / 2 = 0.7
+        expect(loaded.rules[0].entryIds).toContain('STD-1');
+        expect(loaded.rules[0].entryIds).toContain('STD-2');
+    });
+});
+describe('diffHandshakeState', () => {
+    it('first run: isFirstRun is true, all current rules are added', () => {
+        const current = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints' }),
+            makeStateRule({ name: 'chain-boundary', functionKey: 'boundary', sourcePath: 'chain://boundary' }),
+        ]);
+        const diff = diffHandshakeState(current, null);
+        expect(diff.isFirstRun).toBe(true);
+        expect(diff.added).toHaveLength(2);
+        expect(diff.removed).toHaveLength(0);
+        expect(diff.changed).toHaveLength(0);
+        expect(diff.added.map((r) => r.name)).toContain('chain-constraints');
+        expect(diff.added.map((r) => r.name)).toContain('chain-boundary');
+    });
+    it('no changes: added/removed/changed all empty', () => {
+        const rules = [makeStateRule({ name: 'chain-constraints', confidence: 0.65, entryIds: ['STD-1'] })];
+        const current = makeHandshakeState(rules);
+        const previous = makeHandshakeState(rules);
+        const diff = diffHandshakeState(current, previous);
+        expect(diff.isFirstRun).toBe(false);
+        expect(diff.added).toHaveLength(0);
+        expect(diff.removed).toHaveLength(0);
+        expect(diff.changed).toHaveLength(0);
+    });
+    it('added rule detected', () => {
+        const previous = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints' }),
+        ]);
+        const current = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints' }),
+            makeStateRule({ name: 'chain-boundary', functionKey: 'boundary', sourcePath: 'chain://boundary', entryIds: ['ARCH-1'] }),
+        ]);
+        const diff = diffHandshakeState(current, previous);
+        expect(diff.added).toHaveLength(1);
+        expect(diff.added[0].name).toBe('chain-boundary');
+        expect(diff.added[0].change).toBe('added');
+        expect(diff.removed).toHaveLength(0);
+        expect(diff.changed).toHaveLength(0);
+    });
+    it('removed rule detected', () => {
+        const previous = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints' }),
+            makeStateRule({ name: 'chain-workflow', functionKey: 'workflow', sourcePath: 'chain://workflow' }),
+        ]);
+        const current = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints' }),
+        ]);
+        const diff = diffHandshakeState(current, previous);
+        expect(diff.removed).toHaveLength(1);
+        expect(diff.removed[0].name).toBe('chain-workflow');
+        expect(diff.removed[0].change).toBe('removed');
+        expect(diff.added).toHaveLength(0);
+        expect(diff.changed).toHaveLength(0);
+    });
+    it('changed confidence detected with correct details string', () => {
+        const previous = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints', confidence: 0.5, entryIds: ['STD-1'] }),
+        ]);
+        const current = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints', confidence: 0.9, entryIds: ['STD-1'] }),
+        ]);
+        const diff = diffHandshakeState(current, previous);
+        expect(diff.changed).toHaveLength(1);
+        expect(diff.changed[0].name).toBe('chain-constraints');
+        expect(diff.changed[0].change).toBe('changed');
+        expect(diff.changed[0].details).toContain('confidence: 0.5 → 0.9');
+        expect(diff.added).toHaveLength(0);
+        expect(diff.removed).toHaveLength(0);
+    });
+    it('changed entries detected with +/- notation', () => {
+        const previous = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints', confidence: 0.65, entryIds: ['STD-1', 'STD-7'] }),
+        ]);
+        const current = makeHandshakeState([
+            makeStateRule({ name: 'chain-constraints', confidence: 0.65, entryIds: ['STD-1', 'STD-22'] }),
+        ]);
+        const diff = diffHandshakeState(current, previous);
+        expect(diff.changed).toHaveLength(1);
+        expect(diff.changed[0].details).toContain('+STD-22');
+        expect(diff.changed[0].details).toContain('-STD-7');
+    });
+});
+describe('formatDiff', () => {
+    it('outputs "First run" message when isFirstRun is true', () => {
+        const diff = { added: [], removed: [], changed: [], isFirstRun: true };
+        const output = formatDiff(diff);
+        expect(output).toBe('First run — no previous state to compare.');
+    });
+    it('outputs "No changes." when diff is empty', () => {
+        const diff = { added: [], removed: [], changed: [], isFirstRun: false };
+        const output = formatDiff(diff);
+        expect(output).toBe('No changes.');
+    });
+    it('formats added rules with + prefix', () => {
+        const diff = {
+            added: [{ name: 'chain-constraints', change: 'added', details: 'confidence: 0.65, 3 entries' }],
+            removed: [],
+            changed: [],
+            isFirstRun: false,
+        };
+        const output = formatDiff(diff);
+        expect(output).toContain('Handshake diff (vs previous run):');
+        expect(output).toContain('  + chain-constraints (confidence: 0.65, 3 entries)');
+    });
+    it('formats removed rules with - prefix', () => {
+        const diff = {
+            added: [],
+            removed: [{ name: 'chain-workflow', change: 'removed', details: 'removed — no matching entries' }],
+            changed: [],
+            isFirstRun: false,
+        };
+        const output = formatDiff(diff);
+        expect(output).toContain('  - chain-workflow (removed — no matching entries)');
+    });
+    it('formats changed rules with ~ prefix', () => {
+        const diff = {
+            added: [],
+            removed: [],
+            changed: [{ name: 'chain-boundary', change: 'changed', details: 'confidence: 0.50 → 0.70, entries: +ARCH-5' }],
+            isFirstRun: false,
+        };
+        const output = formatDiff(diff);
+        expect(output).toContain('  ~ chain-boundary (confidence: 0.50 → 0.70, entries: +ARCH-5)');
+    });
+    it('outputs readable console text with all change types', () => {
+        const diff = {
+            added: [{ name: 'chain-constraints', change: 'added', details: 'confidence: 0.65, 3 entries' }],
+            removed: [{ name: 'chain-workflow', change: 'removed', details: 'removed — no matching entries' }],
+            changed: [{ name: 'chain-boundary', change: 'changed', details: 'confidence: 0.50 → 0.70' }],
+            isFirstRun: false,
+        };
+        const output = formatDiff(diff);
+        expect(output).toContain('Handshake diff (vs previous run):');
+        expect(output).toContain('  + chain-constraints');
+        expect(output).toContain('  - chain-workflow');
+        expect(output).toContain('  ~ chain-boundary');
+    });
+});
+//# sourceMappingURL=handshake-diff.test.js.map

package/dist/generators/handshake-diff.test.js.map

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

package/dist/generators/manifest.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Manifest reader — reads .productbrain/manifest.yaml for adoption state.
+ * WP-310 E1: personal workspace layer — manifest-based filtering.
+ * WP-421 S1 (#35): extends Manifest with DEC-951 authority keys (`materialize`,
+ * `surfaces`, `lock`) and adds `readManifestStatus()` — a typed reader that
+ * returns the FULL UNION of legacy + new fields plus a `parseStatus`
+ * discriminator (DEC-955, DEC-963 "Authority mode parse semantics").
+ *
+ * No external YAML dependency is required; the manifest schema is
+ * simple enough to parse with a minimal line-by-line parser.
+ */
+/** Authority materialize modes per DEC-951. */
+export type AuthorityMode = 'off' | 'observe' | 'project' | 'govern';
+/** Lock levels per DEC-951 — controls who can author a setup asset. */
+export type LockLevel = 'platform' | 'workspace' | 'personal';
+/** Parse status discriminator per DEC-963 (Authority mode parse semantics). */
+export type ManifestParseStatus = 'absent' | 'unparseable' | 'ok';
+export interface Manifest {
+    version: string;
+    method_source?: 'chain' | 'bundled';
+    boundary_enforcement_mode?: string;
+    boundaryEnforcementMode?: string;
+    /** Allowlist — if present and non-empty, ONLY these rule/skill names pass. */
+    adopted?: string[];
+    /** Denylist — always excluded regardless of adopted list. */
+    rejected?: string[];
+    hooks?: {
+        cursor?: boolean;
+        copilot?: boolean;
+    };
+    /**
+     * Authority materialize mode (DEC-951). Optional in the manifest file.
+     * When absent, `readManifestStatus()` defaults to 'observe' per DEC-955.
+     */
+    materialize?: AuthorityMode;
+    /**
+     * Surfaces this workspace allows PB to project to (e.g. `.claude`, `.cursor`).
+     * Per STD-236, disk writes are permitted ONLY within these surfaces (plus
+     * the hard-coded `.productbrain/` root).
+     */
+    surfaces?: string[];
+    /**
+     * Per-asset lock overrides — maps asset id → lock level (DEC-951).
+     * Example: { "RULE-foo": "platform", "SKILL-bar": "workspace" }.
+     */
+    lock?: Record<string, LockLevel>;
+}
+/**
+ * Typed result returned by `readManifestStatus()` (WP-421 S1, #35).
+ *
+ * Shape: full union of legacy + WP-421 keys + parse-status discriminator.
+ * Defaults (DEC-955, DEC-963):
+ *   - No `.productbrain/` directory:      mode='off',     parseStatus='absent'
+ *   - Folder + no manifest:               mode='observe', parseStatus='absent'
+ *   - Manifest present + no `materialize`: mode='observe', parseStatus='ok'
+ *   - Malformed YAML:                     mode='observe', parseStatus='unparseable'
+ *
+ * Critical invariant (DEC-963): when `parseStatus !== 'ok'`, mode is NEVER
+ * 'project' or 'govern'. The reader fails closed to 'observe'.
+ */
+export interface ManifestStatus {
+    /** Effective authority mode after defaults applied. */
+    mode: AuthorityMode;
+    /** Surfaces list; empty array when manifest is absent or `surfaces` key missing. */
+    surfaces: string[];
+    /** Per-asset lock overrides; empty object when absent. */
+    lock: Record<string, LockLevel>;
+    /** Parse-status discriminator. */
+    parseStatus: ManifestParseStatus;
+    /**
+     * The underlying parsed `Manifest` when `parseStatus === 'ok'`, else null.
+     * Callers needing legacy fields (adopted/rejected/hooks/method_source) read
+     * them from this object — keeps the legacy `readManifest()` shape intact
+     * while exposing the WP-421 typed contract through `mode`/`surfaces`/`lock`.
+     */
+    manifest: Manifest | null;
+}
+/**
+ * Read .productbrain/manifest.yaml.
+ * Returns null if the file is absent or unparseable (treat as no-op).
+ *
+ * Legacy reader — kept for callers that only need adoption-state filtering.
+ * WP-421 callers should prefer `readManifestStatus()` for typed authority
+ * mode + parse-status discriminator.
+ */
+export declare function readManifest(productbrainDir: string): Manifest | null;
+/**
+ * Read manifest with full WP-421 authority typing (#35).
+ *
+ * Returns the FULL UNION of legacy + DEC-951 keys plus a `parseStatus`
+ * discriminator. Defaults per DEC-955 / DEC-963:
+ *   - `.productbrain/` directory absent → mode='off', parseStatus='absent'
+ *   - Directory present, manifest absent → mode='observe', parseStatus='absent'
+ *   - Manifest present, no `materialize:` → mode='observe', parseStatus='ok'
+ *   - Manifest unparseable / fails shape validation → mode='observe',
+ *     parseStatus='unparseable' (NEVER 'project'/'govern' — fail closed).
+ *
+ * @param productbrainDir Absolute path to the `.productbrain/` directory.
+ *   The directory itself MAY be absent — caller passes the candidate path
+ *   regardless and this reader infers the mode from filesystem state.
+ */
+export declare function readManifestStatus(productbrainDir: string): ManifestStatus;
+/**
+ * Filter a list of items by the manifest's adopted/rejected lists.
+ *
+ * Rules:
+ * - No manifest → return all items unchanged (no-op, preserves current behaviour).
+ * - rejected denylist applied first — excluded regardless of adopted.
+ * - adopted allowlist applied second — only items in the list pass (only when non-empty).
+ * - Empty adopted array → allowlist is inactive, all non-rejected items pass.
+ */
+export declare function filterByAdoptionState<T extends {
+    name: string;
+}>(items: T[], manifest: Manifest | null): T[];
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,aAAa,CAAC;IACpB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,kCAAkC;IAClC,WAAW,EAAE,mBAAmB,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AA8KD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAUrE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAyC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,GACxB,CAAC,EAAE,CAgBL"}