@specship/specship 0.11.0

package/dist/server/static-handler.js

@@ -0,0 +1,87 @@
+/**
+ * In-house static file serving for the desktop SPA. Replaces the
+ * `@fastify/static` plugin so we don't pull in `glob` (deprecated maintainer-side
+ * across every 10.x and 11.x release, which polluted every user's install
+ * with a deprecation warning).
+ *
+ * Usage from server.ts:
+ *
+ *   const serveStatic = makeStaticHandler(options.webDir);
+ *   app.setNotFoundHandler((req, reply) => {
+ *     if (req.method !== 'GET' || req.url.startsWith('/api/')) {
+ *       reply.code(404).send({ error: 'not found' });
+ *       return;
+ *     }
+ *     const hit = serveStatic(req.url);
+ *     if (hit) { reply.type(hit.contentType).send(hit.body); return; }
+ *     reply.code(200).type('text/html').send(cachedIndex);
+ *   });
+ *
+ * Path traversal is blocked by resolving the requested path inside webDir and
+ * rejecting anything that resolves outside.
+ */
+import { readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+const CT = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.wasm': 'application/wasm',
+};
+export function makeStaticHandler(rootDir) {
+    const absRoot = path.resolve(rootDir);
+    return function serveStatic(urlPath) {
+        // Strip query/hash — Fastify gives us the raw URL.
+        const qIdx = urlPath.indexOf('?');
+        const hIdx = urlPath.indexOf('#');
+        let clean = urlPath;
+        if (qIdx >= 0)
+            clean = clean.slice(0, qIdx);
+        if (hIdx >= 0)
+            clean = clean.slice(0, hIdx);
+        // Decode percent-encoding (but reject anything that throws).
+        let decoded;
+        try {
+            decoded = decodeURIComponent(clean);
+        }
+        catch {
+            return null;
+        }
+        // Strip leading slash so path.resolve doesn't escape the root.
+        const rel = decoded.replace(/^\/+/, '');
+        // Resolve under root and verify containment to block ../../ traversal.
+        const candidate = path.resolve(absRoot, rel);
+        if (candidate !== absRoot && !candidate.startsWith(absRoot + path.sep)) {
+            return null;
+        }
+        let stat;
+        try {
+            stat = statSync(candidate);
+        }
+        catch {
+            return null;
+        }
+        if (!stat.isFile())
+            return null;
+        const body = readFileSync(candidate);
+        const ext = path.extname(candidate).toLowerCase();
+        const contentType = CT[ext] ?? 'application/octet-stream';
+        return { body, contentType };
+    };
+}

package/dist/statusline/active-run.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Active workflow run marker (REQ-STATUSLINE-005.A4).
+ *
+ * The workflow executor writes the in-flight run's spec ID + status here on
+ * each status change so the status-line reader can surface it without opening
+ * the `workflow_runs` table (which would mean a DB connection on the render
+ * path). `clearActiveRun` removes the marker when no run is active.
+ */
+import { ActiveRun } from './types';
+/** Atomically record the active run. Best-effort; never throws. */
+export declare function writeActiveRun(projectRoot: string, specId: string | null, status: string): void;
+/** Remove the active-run marker (e.g. once a run is merged/cancelled). */
+export declare function clearActiveRun(projectRoot: string): void;
+/** Read the active-run marker, or null when none. */
+export declare function readActiveRun(projectRoot: string): ActiveRun | null;
+//# sourceMappingURL=active-run.d.ts.map

package/dist/statusline/active-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-run.d.ts","sourceRoot":"","sources":["../../src/statusline/active-run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO/F;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAGnE"}

package/dist/statusline/active-run.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Active workflow run marker (REQ-STATUSLINE-005.A4).
+ *
+ * The workflow executor writes the in-flight run's spec ID + status here on
+ * each status change so the status-line reader can surface it without opening
+ * the `workflow_runs` table (which would mean a DB connection on the render
+ * path). `clearActiveRun` removes the marker when no run is active.
+ */
+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.writeActiveRun = writeActiveRun;
+exports.clearActiveRun = clearActiveRun;
+exports.readActiveRun = readActiveRun;
+const fs = __importStar(require("fs"));
+const paths_1 = require("./paths");
+/** Atomically record the active run. Best-effort; never throws. */
+function writeActiveRun(projectRoot, specId, status) {
+    const data = { v: 1, specId, status, updatedAt: Date.now() };
+    try {
+        (0, paths_1.writeJsonAtomic)((0, paths_1.activeRunPath)(projectRoot), data);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** Remove the active-run marker (e.g. once a run is merged/cancelled). */
+function clearActiveRun(projectRoot) {
+    try {
+        fs.unlinkSync((0, paths_1.activeRunPath)(projectRoot));
+    }
+    catch {
+        /* already absent */
+    }
+}
+/** Read the active-run marker, or null when none. */
+function readActiveRun(projectRoot) {
+    const r = (0, paths_1.readJsonSafe)((0, paths_1.activeRunPath)(projectRoot));
+    return r && r.v === 1 ? r : null;
+}
+//# sourceMappingURL=active-run.js.map

package/dist/statusline/active-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-run.js","sourceRoot":"","sources":["../../src/statusline/active-run.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,wCAOC;AAGD,wCAMC;AAGD,sCAGC;AA3BD,uCAAyB;AAEzB,mCAAuE;AAEvE,mEAAmE;AACnE,SAAgB,cAAc,CAAC,WAAmB,EAAE,MAAqB,EAAE,MAAc;IACvF,MAAM,IAAI,GAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACxE,IAAI,CAAC;QACH,IAAA,uBAAe,EAAC,IAAA,qBAAa,EAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,SAAgB,cAAc,CAAC,WAAmB;IAChD,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,IAAA,qBAAa,EAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,SAAgB,aAAa,CAAC,WAAmB;IAC/C,MAAM,CAAC,GAAG,IAAA,oBAAY,EAAY,IAAA,qBAAa,EAAC,WAAW,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/dist/statusline/cache.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tier-A status-line cache: the producer (`writeStatuslineCache`) and the
+ * reader (`readStatuslineCache`) for `.specship/statusline.json`.
+ *
+ * The producer is called from index/sync/watcher events where the database
+ * is already open (REQ-STATUSLINE-003). The reader is called from the
+ * `specship statusline` command and does a single `readFileSync` with no
+ * database access (REQ-STATUSLINE-002).
+ */
+import { StatuslineCache } from './types';
+/** Fields the producer supplies; the writer stamps `v` and `updatedAt`. */
+export type StatuslineCacheInput = Omit<StatuslineCache, 'v' | 'updatedAt'>;
+/**
+ * Atomically write the Tier-A cache. Best-effort: any failure (e.g.
+ * read-only filesystem) is swallowed so a cache-write never breaks the
+ * index/sync operation that triggered it.
+ */
+export declare function writeStatuslineCache(projectRoot: string, input: StatuslineCacheInput): void;
+/** Read the Tier-A cache, or null when absent/corrupt (caller degrades). */
+export declare function readStatuslineCache(projectRoot: string): StatuslineCache | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/statusline/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/statusline/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAO3F;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAG/E"}

package/dist/statusline/cache.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Tier-A status-line cache: the producer (`writeStatuslineCache`) and the
+ * reader (`readStatuslineCache`) for `.specship/statusline.json`.
+ *
+ * The producer is called from index/sync/watcher events where the database
+ * is already open (REQ-STATUSLINE-003). The reader is called from the
+ * `specship statusline` command and does a single `readFileSync` with no
+ * database access (REQ-STATUSLINE-002).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeStatuslineCache = writeStatuslineCache;
+exports.readStatuslineCache = readStatuslineCache;
+const paths_1 = require("./paths");
+/**
+ * Atomically write the Tier-A cache. Best-effort: any failure (e.g.
+ * read-only filesystem) is swallowed so a cache-write never breaks the
+ * index/sync operation that triggered it.
+ */
+function writeStatuslineCache(projectRoot, input) {
+    const data = { v: 1, updatedAt: Date.now(), ...input };
+    try {
+        (0, paths_1.writeJsonAtomic)((0, paths_1.statuslineCachePath)(projectRoot), data);
+    }
+    catch {
+        /* best-effort producer — never throw into the indexer */
+    }
+}
+/** Read the Tier-A cache, or null when absent/corrupt (caller degrades). */
+function readStatuslineCache(projectRoot) {
+    const c = (0, paths_1.readJsonSafe)((0, paths_1.statuslineCachePath)(projectRoot));
+    return c && c.v === 1 ? c : null;
+}
+//# sourceMappingURL=cache.js.map

package/dist/statusline/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/statusline/cache.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAaH,oDAOC;AAGD,kDAGC;AAvBD,mCAA6E;AAK7E;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,WAAmB,EAAE,KAA2B;IACnF,MAAM,IAAI,GAAoB,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;IACxE,IAAI,CAAC;QACH,IAAA,uBAAe,EAAC,IAAA,2BAAmB,EAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,MAAM,CAAC,GAAG,IAAA,oBAAY,EAAkB,IAAA,2BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/dist/statusline/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SpecShip status-line segment — public entry (SHIP-STATUSLINE-DOC).
+ *
+ * `buildSegment` is the whole read path: it takes Claude Code's status-line
+ * JSON (as a raw string), locates the project from `workspace.current_dir`,
+ * reads the two cache files, and renders one line. It opens no database,
+ * spawns no process, and never throws — every failure degrades to a minimal
+ * valid line (REQ-STATUSLINE-001/002).
+ */
+export * from './types';
+export { writeStatuslineCache } from './cache';
+export type { StatuslineCacheInput } from './cache';
+export { initSession, recordCall, readSessionMarker } from './session-marker';
+export { writeActiveRun, clearActiveRun, readActiveRun } from './active-run';
+export { renderSegment } from './render';
+/**
+ * Build the segment line from Claude Code's raw stdin JSON. Always returns a
+ * single line; never throws.
+ *
+ * @param rawStdin  The status-line JSON string Claude Code pipes in.
+ * @param noColor   Whether to strip ANSI (defaults to honoring `NO_COLOR`).
+ */
+export declare function buildSegment(rawStdin: string, noColor?: boolean): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/statusline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/statusline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAgCzC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,UAAyB,GAAG,MAAM,CAmBvF"}

package/dist/statusline/index.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * SpecShip status-line segment — public entry (SHIP-STATUSLINE-DOC).
+ *
+ * `buildSegment` is the whole read path: it takes Claude Code's status-line
+ * JSON (as a raw string), locates the project from `workspace.current_dir`,
+ * reads the two cache files, and renders one line. It opens no database,
+ * spawns no process, and never throws — every failure degrades to a minimal
+ * valid line (REQ-STATUSLINE-001/002).
+ */
+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;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSegment = exports.readActiveRun = exports.clearActiveRun = exports.writeActiveRun = exports.readSessionMarker = exports.recordCall = exports.initSession = exports.writeStatuslineCache = void 0;
+exports.buildSegment = buildSegment;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const directory_1 = require("../directory");
+const cache_1 = require("./cache");
+const session_marker_1 = require("./session-marker");
+const active_run_1 = require("./active-run");
+const render_1 = require("./render");
+__exportStar(require("./types"), exports);
+var cache_2 = require("./cache");
+Object.defineProperty(exports, "writeStatuslineCache", { enumerable: true, get: function () { return cache_2.writeStatuslineCache; } });
+var session_marker_2 = require("./session-marker");
+Object.defineProperty(exports, "initSession", { enumerable: true, get: function () { return session_marker_2.initSession; } });
+Object.defineProperty(exports, "recordCall", { enumerable: true, get: function () { return session_marker_2.recordCall; } });
+Object.defineProperty(exports, "readSessionMarker", { enumerable: true, get: function () { return session_marker_2.readSessionMarker; } });
+var active_run_2 = require("./active-run");
+Object.defineProperty(exports, "writeActiveRun", { enumerable: true, get: function () { return active_run_2.writeActiveRun; } });
+Object.defineProperty(exports, "clearActiveRun", { enumerable: true, get: function () { return active_run_2.clearActiveRun; } });
+Object.defineProperty(exports, "readActiveRun", { enumerable: true, get: function () { return active_run_2.readActiveRun; } });
+var render_2 = require("./render");
+Object.defineProperty(exports, "renderSegment", { enumerable: true, get: function () { return render_2.renderSegment; } });
+/**
+ * Walk up from `startDir` to the nearest directory containing a `.specship/`
+ * folder. Unlike `findNearestSpecShipRoot`, this does NOT require `specship.db`
+ * to exist — the status-line reader is cache-based and must resolve the project
+ * even when the database is absent or locked (REQ-STATUSLINE-002.A2).
+ */
+function findSpecShipRootForRead(startDir) {
+    let current = path.resolve(startDir);
+    const root = path.parse(current).root;
+    while (true) {
+        try {
+            if (fs.existsSync(path.join(current, directory_1.SPECSHIP_DIR)))
+                return current;
+        }
+        catch {
+            /* unreadable — keep walking up */
+        }
+        if (current === root)
+            return null;
+        current = path.dirname(current);
+    }
+}
+/** Pull the project directory Claude is in out of the status-line JSON. */
+function projectDirFromInput(raw) {
+    try {
+        const json = JSON.parse(raw);
+        return json.workspace?.current_dir || json.cwd || process.cwd();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+/**
+ * Build the segment line from Claude Code's raw stdin JSON. Always returns a
+ * single line; never throws.
+ *
+ * @param rawStdin  The status-line JSON string Claude Code pipes in.
+ * @param noColor   Whether to strip ANSI (defaults to honoring `NO_COLOR`).
+ */
+function buildSegment(rawStdin, noColor = !!process.env.NO_COLOR) {
+    let root = null;
+    try {
+        root = findSpecShipRootForRead(projectDirFromInput(rawStdin));
+    }
+    catch {
+        root = null;
+    }
+    if (!root) {
+        // No SpecShip project here — render the idle degraded line.
+        return (0, render_1.renderSegment)({ cache: null, marker: null, run: null, noColor });
+    }
+    return (0, render_1.renderSegment)({
+        cache: (0, cache_1.readStatuslineCache)(root),
+        marker: (0, session_marker_1.readSessionMarker)(root),
+        run: (0, active_run_1.readActiveRun)(root),
+        noColor,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/statusline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/statusline/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDH,oCAmBC;AAvED,uCAAyB;AACzB,2CAA6B;AAC7B,4CAA4C;AAC5C,mCAA8C;AAC9C,qDAAqD;AACrD,6CAA6C;AAC7C,qCAAyC;AAEzC,0CAAwB;AACxB,iCAA+C;AAAtC,6GAAA,oBAAoB,OAAA;AAE7B,mDAA8E;AAArE,6GAAA,WAAW,OAAA;AAAE,4GAAA,UAAU,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AACnD,2CAA6E;AAApE,4GAAA,cAAc,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,2GAAA,aAAa,OAAA;AACtD,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,QAAgB;IAC/C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACtC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,wBAAY,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAS,mBAAmB,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2D,CAAC;QACvF,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,QAAgB,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ;IAC7E,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,CAAC;QACH,IAAI,GAAG,uBAAuB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,4DAA4D;QAC5D,OAAO,IAAA,sBAAa,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAA,sBAAa,EAAC;QACnB,KAAK,EAAE,IAAA,2BAAmB,EAAC,IAAI,CAAC;QAChC,MAAM,EAAE,IAAA,kCAAiB,EAAC,IAAI,CAAC;QAC/B,GAAG,EAAE,IAAA,0BAAa,EAAC,IAAI,CAAC;QACxB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/statusline/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cache-file paths + a tiny atomic JSON writer for the status-line segment.
+ *
+ * Kept self-contained (no import from the installer or DB layers) so the
+ * read path can pull these helpers without dragging in heavy dependencies —
+ * the status line re-renders sub-second and must stay cheap (REQ-STATUSLINE-002).
+ */
+/** `.specship/statusline.json` — Tier-A index-state cache. */
+export declare function statuslineCachePath(projectRoot: string): string;
+/** `.specship/session/marker.json` — per-session call marker. */
+export declare function sessionMarkerPath(projectRoot: string): string;
+/** `.specship/session/active-run.json` — current workflow run. */
+export declare function activeRunPath(projectRoot: string): string;
+/**
+ * Atomic JSON write (temp-file + rename) so a concurrent status-line read
+ * never observes a half-written file (REQ-STATUSLINE-003.A3). Creates the
+ * parent directory if missing. Errors propagate to the caller, which is
+ * always a best-effort producer that swallows them.
+ */
+export declare function writeJsonAtomic(filePath: string, data: unknown): void;
+/**
+ * Read + parse a small JSON cache file. Returns null on any failure
+ * (missing, unreadable, corrupt, wrong shape) — the read path treats every
+ * failure as "no data" and degrades, never throws (REQ-STATUSLINE-002.A2).
+ */
+export declare function readJsonSafe<T>(filePath: string): T | null;
+//# sourceMappingURL=paths.d.ts.map

package/dist/statusline/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/statusline/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAWrE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAQ1D"}

package/dist/statusline/paths.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Cache-file paths + a tiny atomic JSON writer for the status-line segment.
+ *
+ * Kept self-contained (no import from the installer or DB layers) so the
+ * read path can pull these helpers without dragging in heavy dependencies —
+ * the status line re-renders sub-second and must stay cheap (REQ-STATUSLINE-002).
+ */
+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.statuslineCachePath = statuslineCachePath;
+exports.sessionMarkerPath = sessionMarkerPath;
+exports.activeRunPath = activeRunPath;
+exports.writeJsonAtomic = writeJsonAtomic;
+exports.readJsonSafe = readJsonSafe;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const directory_1 = require("../directory");
+/** `.specship/statusline.json` — Tier-A index-state cache. */
+function statuslineCachePath(projectRoot) {
+    return path.join((0, directory_1.getSpecShipDir)(projectRoot), 'statusline.json');
+}
+/** `.specship/session/marker.json` — per-session call marker. */
+function sessionMarkerPath(projectRoot) {
+    return path.join((0, directory_1.getSpecShipDir)(projectRoot), 'session', 'marker.json');
+}
+/** `.specship/session/active-run.json` — current workflow run. */
+function activeRunPath(projectRoot) {
+    return path.join((0, directory_1.getSpecShipDir)(projectRoot), 'session', 'active-run.json');
+}
+/**
+ * Atomic JSON write (temp-file + rename) so a concurrent status-line read
+ * never observes a half-written file (REQ-STATUSLINE-003.A3). Creates the
+ * parent directory if missing. Errors propagate to the caller, which is
+ * always a best-effort producer that swallows them.
+ */
+function writeJsonAtomic(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${filePath}.tmp.${process.pid}`;
+    try {
+        fs.writeFileSync(tmp, JSON.stringify(data));
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+}
+/**
+ * Read + parse a small JSON cache file. Returns null on any failure
+ * (missing, unreadable, corrupt, wrong shape) — the read path treats every
+ * failure as "no data" and degrades, never throws (REQ-STATUSLINE-002.A2).
+ */
+function readJsonSafe(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/statusline/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/statusline/paths.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,kDAEC;AAGD,8CAEC;AAGD,sCAEC;AAQD,0CAWC;AAOD,oCAQC;AAnDD,uCAAyB;AACzB,2CAA6B;AAC7B,4CAA8C;AAE9C,8DAA8D;AAC9D,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAA,0BAAc,EAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACnE,CAAC;AAED,iEAAiE;AACjE,SAAgB,iBAAiB,CAAC,WAAmB;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAA,0BAAc,EAAC,WAAW,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAC1E,CAAC;AAED,kEAAkE;AAClE,SAAgB,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAA,0BAAc,EAAC,WAAW,CAAC,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAI,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QACpC,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/statusline/render.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Render the SpecShip status-line segment (REQ-STATUSLINE-001/005).
+ *
+ * Pure + deterministic: given the three caches it returns one line. No I/O,
+ * no clock — the caller supplies everything. Output is the project's art-deco
+ * style (gold ANSI, `◈`/`◆` separators) and strips all ANSI under `NO_COLOR`.
+ *
+ * Honesty rule (REQ-STATUSLINE-005.A5): this function NEVER emits a
+ * tokens/cost "saved" figure. The call count is the only usage signal, framed
+ * as "N calls" — what specship was asked, not a fabricated counterfactual.
+ */
+import { StatuslineCache, SessionMarker, ActiveRun } from './types';
+export interface RenderInput {
+    cache: StatuslineCache | null;
+    marker: SessionMarker | null;
+    run: ActiveRun | null;
+    /** When true, emit no ANSI escapes. */
+    noColor: boolean;
+}
+/**
+ * Build the segment line. Always returns a single non-empty line; degrades to
+ * a minimal `◈ specship … ◈` when caches are absent rather than erroring.
+ */
+export declare function renderSegment(input: RenderInput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/statusline/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/statusline/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAsBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAuCxD"}

package/dist/statusline/render.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Render the SpecShip status-line segment (REQ-STATUSLINE-001/005).
+ *
+ * Pure + deterministic: given the three caches it returns one line. No I/O,
+ * no clock — the caller supplies everything. Output is the project's art-deco
+ * style (gold ANSI, `◈`/`◆` separators) and strips all ANSI under `NO_COLOR`.
+ *
+ * Honesty rule (REQ-STATUSLINE-005.A5): this function NEVER emits a
+ * tokens/cost "saved" figure. The call count is the only usage signal, framed
+ * as "N calls" — what specship was asked, not a fabricated counterfactual.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSegment = renderSegment;
+const ESC = '\u001b';
+// ANSI 256-color palette — the gold deco family, matching the bars.
+const COLOR = {
+    orn: 178, // antique gold — ornaments / brand
+    frame: 137, // muted bronze — separators
+    synced: 71, // green
+    pending: 214, // amber
+    drift: 203, // red
+    wasm: 220, // bright gold/yellow — slow-path warning
+    calls: 178, // gold
+    run: 75, // blue — spec/run
+    dim: 240, // grey — degraded/idle
+};
+function paint(noColor, code, s) {
+    if (noColor)
+        return s;
+    return `${ESC}[38;5;${code}m${s}${ESC}[0m`;
+}
+/**
+ * Build the segment line. Always returns a single non-empty line; degrades to
+ * a minimal `◈ specship … ◈` when caches are absent rather than erroring.
+ */
+function renderSegment(input) {
+    const { cache, marker, run, noColor } = input;
+    const c = (code, s) => paint(noColor, code, s);
+    const orn = c(COLOR.orn, '◈');
+    const sep = c(COLOR.frame, ' ◆ ');
+    const brand = c(COLOR.orn, 'specship');
+    const parts = [];
+    // Degraded paths: no project / no cache → idle, but still surface calls if known.
+    if (!cache || !cache.initialized) {
+        const label = cache && !cache.initialized ? 'indexing…' : 'idle';
+        parts.push(c(COLOR.dim, label));
+    }
+    else {
+        // Sync state — ✓ synced, or ⟳N pending.
+        const pending = cache.pending.added + cache.pending.modified + cache.pending.removed;
+        parts.push(pending === 0
+            ? c(COLOR.synced, '✓ synced')
+            : c(COLOR.pending, `⟳ ${pending} pending`));
+        // Drift queue, only when non-zero.
+        if (cache.drift > 0)
+            parts.push(c(COLOR.drift, `⚠ ${cache.drift} drift`));
+        // Backend health — flag a degraded (non-WAL) DB where reads can block.
+        if (cache.degraded)
+            parts.push(c(COLOR.wasm, `⚠ ${cache.backend}`));
+    }
+    // Session call count — the honest usage signal. Zero placeholder when no marker.
+    const calls = marker ? marker.calls : 0;
+    parts.push(c(COLOR.calls, `${calls} ${calls === 1 ? 'call' : 'calls'}`));
+    // Active workflow run, only when one exists.
+    if (run) {
+        const label = run.specId ? `${run.specId}·${run.status}` : run.status;
+        parts.push(c(COLOR.run, label));
+    }
+    return `${orn} ${brand}${sep}${parts.join(sep)} ${orn}`;
+}
+//# sourceMappingURL=render.js.map