@selvakumaresra/specship 0.4.0 → 0.6.0

package/dist/resolution/brief-link-resolver.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * 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.
+ */
+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.cleanSpecPointer = cleanSpecPointer;
+exports.resolveToDocumentId = resolveToDocumentId;
+exports.resolveBriefLink = resolveBriefLink;
+exports.computeSpecFunnel = computeSpecFunnel;
+exports.findBriefsForSpec = findBriefsForSpec;
+exports.summarizeBriefFunnel = summarizeBriefFunnel;
+const path = __importStar(require("path"));
+/** Strip a trailing ` # comment` and surrounding quotes from a frontmatter value. */
+function cleanSpecPointer(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    let v = raw.trim();
+    if (!v)
+        return null;
+    if ((v.startsWith('"') && v.endsWith('"')) ||
+        (v.startsWith("'") && v.endsWith("'"))) {
+        v = v.slice(1, -1).trim();
+    }
+    else {
+        // Strip an unquoted trailing comment (whitespace + '#'), mirroring the
+        // server's parseBriefField — a '#fragment' with no leading space is kept.
+        const h = v.search(/\s#/);
+        if (h !== -1)
+            v = v.slice(0, h).trim();
+    }
+    return v || null;
+}
+const fwd = (p) => p.replace(/\\/g, '/');
+/** Resolve a spec id up to its enclosing document id (walk parent_id to the root). */
+function resolveToDocumentId(sq, id) {
+    let cur = sq.getSpecById(id);
+    if (!cur)
+        return null;
+    const seen = new Set();
+    while (cur.kind !== 'document' && cur.parentId && !seen.has(cur.id)) {
+        seen.add(cur.id);
+        const parent = sq.getSpecById(cur.parentId);
+        if (!parent)
+            break;
+        cur = parent;
+    }
+    return cur.id;
+}
+/** The document (if any) whose `brief:` frontmatter resolves to this brief's file. */
+function documentPointingAtBrief(sq, brief) {
+    const target = fwd(brief.sourcePath);
+    for (const s of sq.getAllSpecs()) {
+        if (s.kind !== 'document' || !s.metadata || typeof s.metadata !== 'object')
+            continue;
+        const ref = cleanSpecPointer(s.metadata.brief);
+        if (!ref)
+            continue;
+        // `brief:` is relative to the spec file's own directory.
+        const resolved = path.posix.normalize(path.posix.join(path.posix.dirname(fwd(s.sourcePath)), fwd(ref)));
+        if (resolved === target)
+            return s.id;
+    }
+    return null;
+}
+/** Reconcile a brief's link to its spec from both pointer directions. */
+function resolveBriefLink(sq, brief) {
+    const meta = brief.metadata && typeof brief.metadata === 'object'
+        ? brief.metadata
+        : {};
+    const ptr = cleanSpecPointer(meta.spec);
+    const briefSide = ptr ? resolveToDocumentId(sq, ptr) : null;
+    const specSide = documentPointingAtBrief(sq, brief);
+    if (briefSide && specSide && briefSide !== specSide) {
+        return { briefId: brief.id, linkedSpecId: null, state: 'conflict', briefSide, specSide };
+    }
+    const linkedSpecId = briefSide ?? specSide ?? null;
+    return {
+        briefId: brief.id,
+        linkedSpecId,
+        state: linkedSpecId ? 'specified' : 'idea',
+        briefSide,
+        specSide,
+    };
+}
+/** Implementation rollup for a single document's requirements. */
+function documentRollup(sq, docId) {
+    const reqs = sq.getSpecsByParent(docId).filter((s) => s.kind === 'requirement');
+    const r = {
+        requirements: reqs.length,
+        implemented: 0,
+        verified: 0,
+        drifted: 0,
+        broken: 0,
+        orphaned: 0,
+    };
+    for (const req of reqs) {
+        for (const lk of sq.getLinksBySpec(req.id)) {
+            if (lk.state === 'implemented')
+                r.implemented++;
+            else if (lk.state === 'verified')
+                r.verified++;
+            else if (lk.state === 'drifted')
+                r.drifted++;
+            else if (lk.state === 'broken')
+                r.broken++;
+            else if (lk.state === 'orphaned')
+                r.orphaned++;
+        }
+    }
+    return r;
+}
+/** Compute the project-wide spec lifecycle funnel (idea → spec → implemented). */
+function computeSpecFunnel(sq) {
+    const all = sq.getAllSpecs();
+    const documents = all.filter((s) => s.kind === 'document');
+    const requirements = all.filter((s) => s.kind === 'requirement');
+    const briefLinks = all.filter((s) => s.kind === 'brief').map((b) => resolveBriefLink(sq, b));
+    const links = { implemented: 0, verified: 0, drifted: 0, broken: 0, orphaned: 0 };
+    for (const req of requirements) {
+        for (const lk of sq.getLinksBySpec(req.id)) {
+            if (lk.state === 'implemented')
+                links.implemented++;
+            else if (lk.state === 'verified')
+                links.verified++;
+            else if (lk.state === 'drifted')
+                links.drifted++;
+            else if (lk.state === 'broken')
+                links.broken++;
+            else if (lk.state === 'orphaned')
+                links.orphaned++;
+        }
+    }
+    const ideas = briefLinks
+        .filter((l) => l.state === 'idea')
+        .map((l) => ({ briefId: l.briefId, title: sq.getSpecById(l.briefId)?.title ?? '' }));
+    const conflicts = briefLinks
+        .filter((l) => l.state === 'conflict')
+        .map((l) => ({ briefId: l.briefId, briefSide: l.briefSide, specSide: l.specSide }));
+    return {
+        summary: {
+            ideas: ideas.length,
+            specified: briefLinks.filter((l) => l.state === 'specified').length,
+            conflicts: conflicts.length,
+            documents: documents.length,
+            requirements: requirements.length,
+            links,
+        },
+        documents: documents.map((d) => ({ id: d.id, title: d.title, rollup: documentRollup(sq, d.id) })),
+        ideas,
+        conflicts,
+    };
+}
+/** All briefs that resolve (non-conflicting) to a given document. */
+function findBriefsForSpec(sq, docId) {
+    const out = [];
+    for (const s of sq.getAllSpecs()) {
+        if (s.kind !== 'brief')
+            continue;
+        const link = resolveBriefLink(sq, s);
+        if (link.linkedSpecId === docId)
+            out.push(link);
+    }
+    return out;
+}
+/**
+ * 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.
+ */
+function summarizeBriefFunnel(sq, brief) {
+    const link = resolveBriefLink(sq, brief);
+    if (link.state !== 'specified' || !link.linkedSpecId) {
+        return { briefId: brief.id, state: link.state, linkedSpecId: link.linkedSpecId, rollup: null };
+    }
+    const requirements = sq
+        .getSpecsByParent(link.linkedSpecId)
+        .filter((s) => s.kind === 'requirement');
+    const rollup = {
+        requirements: requirements.length,
+        implemented: 0,
+        verified: 0,
+        drifted: 0,
+        broken: 0,
+        orphaned: 0,
+    };
+    for (const req of requirements) {
+        for (const lk of sq.getLinksBySpec(req.id)) {
+            switch (lk.state) {
+                case 'implemented':
+                    rollup.implemented++;
+                    break;
+                case 'verified':
+                    rollup.verified++;
+                    break;
+                case 'drifted':
+                    rollup.drifted++;
+                    break;
+                case 'broken':
+                    rollup.broken++;
+                    break;
+                case 'orphaned':
+                    rollup.orphaned++;
+                    break;
+                default: break; // drafted / implementing — in-progress, not "implemented"
+            }
+        }
+    }
+    return { briefId: brief.id, state: 'specified', linkedSpecId: link.linkedSpecId, rollup };
+}
+//# sourceMappingURL=brief-link-resolver.js.map

package/dist/resolution/brief-link-resolver.js.map

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

package/dist/server/ingest/impact-backfill.js

@@ -0,0 +1,69 @@
+/**
+ * Lazy backfill of `displaced_files` / `resolution` for pre-existing rows.
+ *
+ * After the v9 migration, existing `claude_tool_calls` rows have `is_specship`
+ * set (from the SQL migration) but `resolution IS NULL` and
+ * `displaced_files IS NULL`. This module fills them in so the impact dashboard
+ * reflects historical SpecShip usage, not just calls ingested post-upgrade.
+ *
+ * Design notes:
+ *   - Only touches rows where `is_specship = 1 AND resolution IS NULL`.
+ *   - Resolves the graph once per distinct `project_path` (cached in a Map).
+ *   - Calls `classifyToolCall` — same logic as live ingest (DRY).
+ *   - Idempotent: a second run is always a no-op (no eligible rows remain).
+ *   - The `resolveGraph` call is wrapped in try/catch — a locked or corrupt
+ *     index falls back to null, which classifies the row as 'unresolved'.
+ *   - Must never crash the caller. The server bootstrap wraps in try/catch.
+ */
+import { classifyToolCall } from './specship-classify.js';
+/**
+ * Backfill `resolution` and `displaced_files` for every `claude_tool_calls`
+ * row that has `is_specship = 1 AND resolution IS NULL`.
+ *
+ * @param db            - The analytics SQLite handle (same type as ingestor uses).
+ * @param resolveGraph  - Factory returning a `GraphLike` for a project path,
+ *                        or null if unavailable.
+ */
+export function backfillDisplaced(db, resolveGraph) {
+    // Fetch all eligible rows in one query. JOIN to sessions to get project_path.
+    // We limit to is_specship=1 AND resolution IS NULL so already-classified rows
+    // are never re-processed, giving natural idempotency.
+    const rows = db.prepare(`
+    SELECT tc.id, tc.tool_name, tc.input_json, tc.result_length, s.project_path
+    FROM claude_tool_calls tc
+    JOIN claude_sessions s ON s.id = tc.session_id
+    -- NULL = never classified (pre-upgrade rows). 'unresolved' = classified but
+    -- the graph/symbols didn't resolve — retry those too, since the resolver and
+    -- the symbol extractor have both been fixed, and a row left unresolved while
+    -- its project wasn't primary should resolve once that project IS primary.
+    -- 'resolved' and 'n/a' are terminal and never reprocessed.
+    WHERE tc.is_specship = 1 AND (tc.resolution IS NULL OR tc.resolution = 'unresolved')
+  `).all();
+    if (rows.length === 0)
+        return;
+    // Cache resolved graphs so we open each project at most once per call.
+    const graphCache = new Map();
+    const updateStmt = db.prepare('UPDATE claude_tool_calls SET resolution = ?, displaced_files = ? WHERE id = ?');
+    // Wrap everything in a single transaction for speed + atomicity.
+    const runTxn = db.transaction(() => {
+        for (const row of rows) {
+            // Resolve the graph for this project path (cached).
+            let graph;
+            if (graphCache.has(row.project_path)) {
+                graph = graphCache.get(row.project_path);
+            }
+            else {
+                try {
+                    graph = resolveGraph(row.project_path);
+                }
+                catch {
+                    graph = null;
+                }
+                graphCache.set(row.project_path, graph);
+            }
+            const cls = classifyToolCall({ toolName: row.tool_name, inputJson: row.input_json, resultLength: row.result_length }, graph);
+            updateStmt.run(cls.resolution, cls.displacedFiles, row.id);
+        }
+    });
+    runTxn();
+}