@specship/specship 0.11.0

package/dist/reflect/sweep.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Reflection orchestration (REQ-REFLECT-001 / 006).
+ *
+ * `analyze` runs the miner and persists the batch, returning the current open
+ * proposals — this is what the on-demand button and `specship reflect` call.
+ *
+ * `sweep` does the same but additionally returns the proposals that should fire
+ * a notification: freshly-inserted (not previously seen, applied, or dismissed)
+ * AND high-severity. Already-seen and lower-severity findings are persisted and
+ * listed, but never re-notified.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyze = analyze;
+exports.sweep = sweep;
+const miner_1 = require("./miner");
+const store_1 = require("./store");
+function analyze(db, ctx, now = () => Date.now()) {
+    const store = new store_1.ReflectStore(db, now);
+    const mined = (0, miner_1.mineProposals)(db, ctx);
+    if (mined.length > 0)
+        store.upsertMined(mined);
+    return { open: store.list('open'), empty: mined.length === 0 };
+}
+function sweep(db, ctx, now = () => Date.now()) {
+    const store = new store_1.ReflectStore(db, now);
+    const mined = (0, miner_1.mineProposals)(db, ctx);
+    const notify = [];
+    if (mined.length > 0) {
+        const { stored, insertedHashes } = store.upsertMined(mined);
+        for (const p of stored) {
+            // Notify only on a brand-new, still-open, high-severity proposal. A row
+            // that already existed (even if re-mined) is not "new"; an applied or
+            // dismissed one is filtered by the open check.
+            if (insertedHashes.has(p.contentHash) && p.severity === 'high' && p.state === 'open') {
+                notify.push(p);
+            }
+        }
+    }
+    return { open: store.list('open'), empty: mined.length === 0, notify };
+}
+//# sourceMappingURL=sweep.js.map

package/dist/reflect/sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.js","sourceRoot":"","sources":["../../src/reflect/sweep.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAmBH,0BASC;AAED,sBAoBC;AA/CD,mCAAwC;AACxC,mCAAuC;AAevC,SAAgB,OAAO,CACrB,EAAkB,EAClB,GAAmB,EACnB,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IAEpC,MAAM,KAAK,GAAG,IAAI,oBAAY,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAA,qBAAa,EAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,SAAgB,KAAK,CACnB,EAAkB,EAClB,GAAmB,EACnB,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IAEpC,MAAM,KAAK,GAAG,IAAI,oBAAY,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAA,qBAAa,EAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,wEAAwE;YACxE,sEAAsE;YACtE,+CAA+C;YAC/C,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AACzE,CAAC"}

package/dist/reflect/targets.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Target resolution (REQ-REFLECT-002).
+ *
+ * Each proposal type maps to a concrete write target with its own marker
+ * convention so the apply can be idempotent (re-apply = no-op) and reversible
+ * (undo strips exactly what apply added — REQ-REFLECT-004):
+ *
+ *   - memory_rule, project scope  → a `<!-- SPECSHIP_LEARNING:<id> -->` block in
+ *                                    the project CLAUDE.md
+ *   - memory_rule, portable scope → a new `~/.claude/memory/<slug>.md` note
+ *                                    (carrying a `specship_proposal:` frontmatter
+ *                                    marker) + a one-line `MEMORY.md` pointer
+ *   - skill                       → a new `commands/ss-<name>.md` (carrying a
+ *                                    leading marker comment)
+ *   - hook                        → a hook entry merged into `.claude/settings.json`
+ *
+ * This module is pure: it builds the payload + path, it does not touch disk.
+ */
+import { Proposal, ProposalEvidence, ProposalSeverity, ProposalType, ReflectContext } from './types';
+/** Marker bounding an engine-written block in CLAUDE.md / command files. */
+export declare function learningMarkers(id: string): {
+    start: string;
+    end: string;
+};
+/** Frontmatter marker line stamped into an engine-created memory note. */
+export declare function memoryNoteMarker(id: string): string;
+/**
+ * Assemble a fully-formed Proposal from a rule's raw inputs. Computes the target
+ * path, builds the type-specific payload (including its markers), and derives the
+ * stable content hash. `createdAt`/`updatedAt` are stamped by the caller (the
+ * store) — here they default to 0 so the object is pure/deterministic.
+ */
+export declare function buildProposal(ctx: ReflectContext, input: {
+    type: ProposalType;
+    severity: ProposalSeverity;
+    title: string;
+    body: string;
+    evidence: ProposalEvidence;
+    /** memory_rule scope: 'project' → CLAUDE.md, 'portable' → ~/.claude/memory note. */
+    scope?: 'project' | 'portable';
+    /** The durable rule/skill/hook content, type-dependent. */
+    content: string;
+    /** Hook-only: the settings.json event + matcher + command. */
+    hook?: {
+        event: string;
+        matcher: string;
+        command: string;
+    };
+    /** A short name seed (for slug / command name). */
+    nameSeed: string;
+}): Proposal;
+//# sourceMappingURL=targets.d.ts.map

package/dist/reflect/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/reflect/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EACL,QAAQ,EACR,gBAAgB,EAEhB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAEf,MAAM,SAAS,CAAC;AAEjB,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK1E;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAUD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE;IACL,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oFAAoF;IACpF,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,QAAQ,CAsEV"}

package/dist/reflect/targets.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Target resolution (REQ-REFLECT-002).
+ *
+ * Each proposal type maps to a concrete write target with its own marker
+ * convention so the apply can be idempotent (re-apply = no-op) and reversible
+ * (undo strips exactly what apply added — REQ-REFLECT-004):
+ *
+ *   - memory_rule, project scope  → a `<!-- SPECSHIP_LEARNING:<id> -->` block in
+ *                                    the project CLAUDE.md
+ *   - memory_rule, portable scope → a new `~/.claude/memory/<slug>.md` note
+ *                                    (carrying a `specship_proposal:` frontmatter
+ *                                    marker) + a one-line `MEMORY.md` pointer
+ *   - skill                       → a new `commands/ss-<name>.md` (carrying a
+ *                                    leading marker comment)
+ *   - hook                        → a hook entry merged into `.claude/settings.json`
+ *
+ * This module is pure: it builds the payload + path, it does not touch disk.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.learningMarkers = learningMarkers;
+exports.memoryNoteMarker = memoryNoteMarker;
+exports.buildProposal = buildProposal;
+const path = __importStar(require("path"));
+const hash_1 = require("./hash");
+/** Marker bounding an engine-written block in CLAUDE.md / command files. */
+function learningMarkers(id) {
+    return {
+        start: `<!-- SPECSHIP_LEARNING:${id} -->`,
+        end: `<!-- /SPECSHIP_LEARNING:${id} -->`,
+    };
+}
+/** Frontmatter marker line stamped into an engine-created memory note. */
+function memoryNoteMarker(id) {
+    return `specship_proposal: ${id}`;
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '')
+        .slice(0, 48) || 'learning';
+}
+/**
+ * Assemble a fully-formed Proposal from a rule's raw inputs. Computes the target
+ * path, builds the type-specific payload (including its markers), and derives the
+ * stable content hash. `createdAt`/`updatedAt` are stamped by the caller (the
+ * store) — here they default to 0 so the object is pure/deterministic.
+ */
+function buildProposal(ctx, input) {
+    let targetKind;
+    let targetPath;
+    let payload;
+    if (input.type === 'memory_rule') {
+        if (input.scope === 'portable') {
+            const slug = slugify(input.nameSeed);
+            targetKind = 'memory_note';
+            targetPath = path.join(ctx.homeDir, '.claude', 'memory', `${slug}.md`);
+            // Hash needs a deterministic id; derive a provisional one from the slug so
+            // the marker is stable, then fold everything into the final hash below.
+            const note = renderMemoryNote(slug, input.title, input.content);
+            const indexLine = `- [${input.title}](${slug}.md) — ${firstSentence(input.body)}`;
+            payload = { kind: 'memory_note', slug, note, indexLine };
+        }
+        else {
+            targetKind = 'claude_md';
+            targetPath = path.join(ctx.projectRoot, 'CLAUDE.md');
+            // markerId is finalized after we know the hash; use a placeholder then
+            // re-render once hashed (below) so the block carries its own id.
+            payload = { kind: 'claude_md', markerId: '', block: '' };
+        }
+    }
+    else if (input.type === 'skill') {
+        const name = slugify(input.nameSeed).replace(/^ss-/, '');
+        targetKind = 'command';
+        targetPath = path.join(ctx.projectRoot, 'commands', `ss-${name}.md`);
+        payload = { kind: 'command', name: `ss-${name}`, content: '' };
+    }
+    else {
+        // hook
+        targetKind = 'settings_hook';
+        targetPath = path.join(ctx.projectRoot, '.claude', 'settings.json');
+        const h = input.hook;
+        payload = {
+            kind: 'settings_hook',
+            event: h.event,
+            matcher: h.matcher,
+            entry: { type: 'command', command: h.command },
+        };
+    }
+    // First-pass hash over the (still-placeholder) identity, then bake the id into
+    // marker-bearing payloads and re-hash so the persisted hash matches the bytes.
+    let contentHash = (0, hash_1.proposalHash)({ type: input.type, targetKind, targetPath, payload });
+    if (payload.kind === 'claude_md') {
+        const { start, end } = learningMarkers(contentHash);
+        const block = `${start}\n${renderClaudeRule(input.title, input.content)}\n${end}`;
+        payload = { kind: 'claude_md', markerId: contentHash, block };
+        contentHash = (0, hash_1.proposalHash)({ type: input.type, targetKind, targetPath, payload });
+    }
+    else if (payload.kind === 'command') {
+        const content = renderCommand(contentHash, payload.name, input.title, input.content);
+        payload = { kind: 'command', name: payload.name, content };
+        contentHash = (0, hash_1.proposalHash)({ type: input.type, targetKind, targetPath, payload });
+    }
+    return {
+        contentHash,
+        type: input.type,
+        severity: input.severity,
+        title: input.title,
+        body: input.body,
+        targetKind,
+        targetPath,
+        payload,
+        evidence: input.evidence,
+        state: 'open',
+        createdAt: 0,
+        updatedAt: 0,
+        appliedAt: null,
+    };
+}
+function firstSentence(s) {
+    const m = s.split(/(?<=[.!?])\s/)[0] ?? s;
+    return m.length > 100 ? m.slice(0, 100) + '…' : m;
+}
+/** The rule body written inside a CLAUDE.md marked block. */
+function renderClaudeRule(title, content) {
+    return `## ${title}\n\n${content}\n\n_(Added by SpecShip reflection — edit or remove freely.)_`;
+}
+/** A self-contained memory note matching the user's memory-file convention. */
+function renderMemoryNote(slug, title, content) {
+    return [
+        '---',
+        `name: ${slug}`,
+        `description: ${firstSentence(title)}`,
+        `${memoryNoteMarker(slug)}`,
+        'metadata:',
+        '  type: feedback',
+        '---',
+        '',
+        content,
+        '',
+    ].join('\n');
+}
+/** A minimal slash-command skill file. */
+function renderCommand(id, name, title, content) {
+    const { start, end } = learningMarkers(id);
+    return [
+        start,
+        `# ${title}`,
+        '',
+        `> \`/${name}\` — proposed by SpecShip reflection from a recurring pattern.`,
+        '',
+        content,
+        '',
+        end,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=targets.js.map

package/dist/reflect/targets.js.map

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

package/dist/reflect/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Reflection engine types (REFLECT-DOC).
+ *
+ * A Proposal is a durable, human-gated self-improvement suggestion mined from
+ * the ingested `claude_*` transcript tables. It is never advisory text alone —
+ * it resolves to a concrete, previewable file change (REQ-REFLECT-002), keyed by
+ * a stable `contentHash` so re-mining the same pattern converges to one row
+ * (REQ-REFLECT-007). The engine PROPOSES; bytes reach disk only on an explicit
+ * per-proposal apply (REQ-REFLECT-005).
+ */
+/** The kind of durable artifact a proposal produces. */
+export type ProposalType = 'memory_rule' | 'skill' | 'hook';
+/** Severity, reusing the tips engine's scale. `high` drives sweep notifications. */
+export type ProposalSeverity = 'high' | 'warn' | 'info';
+/** Persisted lifecycle state (REQ-REFLECT-007). */
+export type ProposalState = 'open' | 'applied' | 'undone' | 'dismissed';
+/** The concrete file the apply writes. */
+export type TargetKind = 'claude_md' | 'memory_note' | 'command' | 'settings_hook';
+/** What the proposal was derived from, so the user can judge it (REQ-REFLECT-001). */
+export interface ProposalEvidence {
+    /** Contributing session ids. */
+    sessions: string[];
+    /** Contributing prompt ids. */
+    prompts: string[];
+    /** Human-readable one-line summary of the observed pattern. */
+    detail: string;
+}
+/**
+ * Artifact-type-specific payload — the exact intended content the preview
+ * renders and the apply writes (REQ-REFLECT-002.A4). Discriminated on `kind`,
+ * which matches the proposal's `targetKind`.
+ */
+export type ProposalPayload = {
+    kind: 'claude_md';
+    markerId: string;
+    block: string;
+} | {
+    kind: 'memory_note';
+    slug: string;
+    note: string;
+    indexLine: string;
+} | {
+    kind: 'command';
+    name: string;
+    content: string;
+} | {
+    kind: 'settings_hook';
+    event: string;
+    matcher: string;
+    entry: Record<string, unknown>;
+};
+/** A single reflection proposal. */
+export interface Proposal {
+    /** Stable id over (type, targetKind, targetPath, payload) — excludes evidence/timestamps. */
+    contentHash: string;
+    type: ProposalType;
+    severity: ProposalSeverity;
+    title: string;
+    body: string;
+    targetKind: TargetKind;
+    /** Absolute path the apply will write. */
+    targetPath: string;
+    payload: ProposalPayload;
+    evidence: ProposalEvidence;
+    state: ProposalState;
+    createdAt: number;
+    updatedAt: number;
+    appliedAt: number | null;
+}
+/** Result of applying a proposal (REQ-REFLECT-004). */
+export type ApplyOutcome = 'applied' | 'unchanged' | 'conflict';
+/** Result of undoing a proposal (REQ-REFLECT-004.A3). */
+export type UndoOutcome = 'undone' | 'noop';
+/** A non-mutating preview of the change a proposal would make (REQ-REFLECT-003). */
+export interface PreviewResult {
+    targetPath: string;
+    targetKind: TargetKind;
+    /** Whether the target file already exists on disk. */
+    exists: boolean;
+    /** Current file content (empty string when the file is absent). */
+    before: string;
+    /** File content after the change would be applied. */
+    after: string;
+    /** A line-based unified-style diff of before → after. */
+    diff: string;
+    /** Set when the apply would be refused — a non-marked file already occupies the path. */
+    conflict?: boolean;
+}
+/** Options the engine needs to resolve target paths. */
+export interface ReflectContext {
+    /** Absolute project root (for project CLAUDE.md / commands / .claude/settings.json). */
+    projectRoot: string;
+    /** Home directory (for ~/.claude/memory notes). */
+    homeDir: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reflect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reflect/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExE,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,eAAe,CAAC;AAEnF,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE9F,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEhE,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5C,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/reflect/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Reflection engine types (REFLECT-DOC).
+ *
+ * A Proposal is a durable, human-gated self-improvement suggestion mined from
+ * the ingested `claude_*` transcript tables. It is never advisory text alone —
+ * it resolves to a concrete, previewable file change (REQ-REFLECT-002), keyed by
+ * a stable `contentHash` so re-mining the same pattern converges to one row
+ * (REQ-REFLECT-007). The engine PROPOSES; bytes reach disk only on an explicit
+ * per-proposal apply (REQ-REFLECT-005).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/reflect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reflect/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/resolution/brief-link-resolver.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Brief ↔ spec link reconciliation (REQ-FUNNEL-002).
+ *
+ * A brainstorm brief (`specs/<slug>/brief.md`, indexed as a `brief`-kind spec by
+ * REQ-FUNNEL-001) is linked to the spec it produced by reconciling BOTH pointer
+ * directions:
+ *
+ *   - the brief's own `spec:` frontmatter (carried in `brief.metadata.spec`),
+ *     which MAY name a requirement — in which case it resolves UP to that
+ *     requirement's enclosing document; and
+ *   - a document spec whose `brief:` frontmatter points back at the brief's file.
+ *
+ * A link is established when EITHER direction resolves. With neither, the brief
+ * is an unlinked `idea`. When the two directions resolve to DIFFERENT documents,
+ * the link is `conflict` — surfaced rather than silently resolved to one side.
+ *
+ * The link is COMPUTED from current DB state (not materialized), so it is always
+ * fresh and needs no re-index bookkeeping.
+ */
+import { Spec, SpecLink } from '../types';
+export type BriefLinkState = 'idea' | 'specified' | 'conflict';
+export interface BriefLink {
+    briefId: string;
+    /** Document the brief links to, or null when `idea` / `conflict`. */
+    linkedSpecId: string | null;
+    state: BriefLinkState;
+    /** Document the brief's own `spec:` resolves to (requirement → document), or null. */
+    briefSide: string | null;
+    /** Document whose `brief:` points back at this brief, or null. */
+    specSide: string | null;
+}
+/** Minimal slice of SpecQueries this resolver needs (eases testing). */
+export interface SpecLookup {
+    getSpecById(id: string): Spec | null;
+    getAllSpecs(): Spec[];
+}
+/** Strip a trailing ` # comment` and surrounding quotes from a frontmatter value. */
+export declare function cleanSpecPointer(raw: unknown): string | null;
+/** Resolve a spec id up to its enclosing document id (walk parent_id to the root). */
+export declare function resolveToDocumentId(sq: SpecLookup, id: string): string | null;
+/** Reconcile a brief's link to its spec from both pointer directions. */
+export declare function resolveBriefLink(sq: SpecLookup, brief: Spec): BriefLink;
+export interface SpecFunnelSummary {
+    ideas: number;
+    specified: number;
+    conflicts: number;
+    documents: number;
+    requirements: number;
+    links: {
+        implemented: number;
+        verified: number;
+        drifted: number;
+        broken: number;
+        orphaned: number;
+    };
+}
+export interface SpecFunnelDoc {
+    id: string;
+    title: string;
+    rollup: BriefRollup;
+}
+export interface SpecFunnel {
+    summary: SpecFunnelSummary;
+    documents: SpecFunnelDoc[];
+    ideas: Array<{
+        briefId: string;
+        title: string;
+    }>;
+    conflicts: Array<{
+        briefId: string;
+        briefSide: string | null;
+        specSide: string | null;
+    }>;
+}
+/** Compute the project-wide spec lifecycle funnel (idea → spec → implemented). */
+export declare function computeSpecFunnel(sq: FunnelLookup): SpecFunnel;
+/** All briefs that resolve (non-conflicting) to a given document. */
+export declare function findBriefsForSpec(sq: SpecLookup, docId: string): BriefLink[];
+/** SpecLookup plus the queries needed to roll up a document's implementation. */
+export interface FunnelLookup extends SpecLookup {
+    getSpecsByParent(parentId: string): Spec[];
+    getLinksBySpec(specId: string): SpecLink[];
+}
+/**
+ * Implementation rollup for a linked brief's document — counts of the
+ * document's requirement→code links by state. `implemented` (declared) and
+ * `verified` (test-confirmed) are kept distinct so a declared-but-unverified
+ * link is never reported as proven. `drafted` / `implementing` are in-progress
+ * and counted as neither (they are not "implemented").
+ */
+export interface BriefRollup {
+    requirements: number;
+    implemented: number;
+    verified: number;
+    drifted: number;
+    broken: number;
+    orphaned: number;
+}
+export interface BriefFunnelEntry {
+    briefId: string;
+    state: BriefLinkState;
+    linkedSpecId: string | null;
+    /** Implementation rollup of the linked document; null for `idea` / `conflict`. */
+    rollup: BriefRollup | null;
+}
+/**
+ * Roll a brief up to its lifecycle state (REQ-FUNNEL-003): `idea` (unlinked),
+ * `conflict` (ambiguous link), or `specified` with an implementation rollup of
+ * the linked document's requirements. A document whose links are all
+ * drifted/broken/orphaned yields implemented=0 — degraded states are surfaced
+ * rather than mistaken for a working implementation.
+ */
+export declare function summarizeBriefFunnel(sq: FunnelLookup, brief: Spec): BriefFunnelEntry;
+//# sourceMappingURL=brief-link-resolver.d.ts.map

package/dist/resolution/brief-link-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-link-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/brief-link-resolver.ts"],"names":[],"mappings":"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"}