@svenroth-ai/shipwright 0.25.0 → 0.27.0

package/server/dist/core/shipslog-docs-reader.js

@@ -0,0 +1,181 @@
+/*
+ * shipslog-docs-reader.ts — pure, fs-backed reader for the Ship's-Log
+ * Documents panel (iterate-2026-08-31-shipslog-documents-panel). Curates
+ * four groups from a project's own tree — no client input beyond
+ * `projectRoot` (already resolved server-side from a trusted project
+ * record), so every path here is either a fixed constant or discovered by
+ * readdir-ing a fixed directory, never client-supplied.
+ *
+ * "Requirements" = the ur-spec per PLANNING SECTION (a direct subdirectory
+ * of .shipwright/planning/ that is not iterate/adr/campaigns and carries
+ * its own spec.md) — distinct from "Iterate" (the flat *.md mini-specs
+ * under .shipwright/planning/iterate/), which is a SEPARATE tab in the UI
+ * (see ShipsLogSpecsTabs.tsx) precisely because they answer different
+ * questions ("what did we commit to" vs. "what changed, run by run").
+ *
+ * Agent Docs / Compliance are a fixed, curated 5-row list each — a file
+ * that doesn't exist on disk is skipped silently (no "unavailable" row);
+ * these docs are not guaranteed to exist in every clone/fork.
+ *
+ * Dates are filesystem mtime, not `git log` — cheap even at 200+ iterate
+ * specs, and it's already what mtime reflects for these files.
+ *
+ * CLAUDE.md rule 10 / ADR-044: every path (even a dynamically-readdir'd
+ * one) is re-verified with pathGuard + realPathGuard before it is stat'd
+ * or returned — the same discipline external/tree/routes.ts applies to a
+ * client-supplied path, as defense in depth even though nothing here is
+ * client-controlled. `realpathSync(projectRoot)` is hoisted ONCE per read
+ * (path-guard.ts's own documented optimization for a batch caller) rather
+ * than re-paid on every one of the ~230 iterate-spec entries.
+ */
+import { readdir, stat } from "node:fs/promises";
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { pathGuard, realPathGuard } from "./path-guard.js";
+const AGENT_DOCS = [
+    { file: "build_dashboard.md", label: "Dashboard" },
+    { file: "architecture.md", label: "Architecture" },
+    { file: "decision_log.md", label: "Decision Log" },
+    { file: "conventions.md", label: "Conventions" },
+    { file: "design_tokens.md", label: "Design Tokens" },
+];
+const COMPLIANCE_DOCS = [
+    { file: "dashboard.md", label: "Dashboard" },
+    { file: "traceability-matrix.md", label: "Traceability Matrix" },
+    { file: "test-evidence.md", label: "Test Evidence" },
+    { file: "change-history.md", label: "Change History" },
+    { file: "sbom.md", label: "SBOM" },
+];
+const PLANNING_SECTION_EXCLUDES = new Set(["iterate", "adr", "campaigns"]);
+/** "01-adopted" → "01 — Adopted"; no dash → the raw name unchanged. */
+function sectionLabel(dirName) {
+    const dash = dirName.indexOf("-");
+    if (dash === -1)
+        return dirName;
+    const num = dirName.slice(0, dash);
+    const rest = dirName
+        .slice(dash + 1)
+        .split("-")
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+    return rest ? `${num} — ${rest}` : dirName;
+}
+/** Guard + realpath-verify `relPath`; null if it fails the guard, doesn't
+ *  exist, or escapes the project root via a symlink (skip-silently caller
+ *  contract — see module doc). */
+function verifiedAbsolute(projectRoot, realRoot, relPath) {
+    const guard = pathGuard(projectRoot, relPath);
+    if (!guard.ok)
+        return null;
+    const real = realPathGuard(projectRoot, guard.absolute, realRoot);
+    return real.ok ? real.absolute : null;
+}
+async function mtimeIso(absPath) {
+    try {
+        const s = await stat(absPath);
+        return s.mtime.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+async function curatedRows(projectRoot, realRoot, relDir, files) {
+    const rows = [];
+    for (const { file, label } of files) {
+        const relPath = `${relDir}/${file}`;
+        const abs = verifiedAbsolute(projectRoot, realRoot, relPath);
+        if (!abs)
+            continue; // missing on disk — skip silently, no error row
+        const when = await mtimeIso(abs);
+        if (when === null)
+            continue; // vanished between realpath and stat — skip
+        rows.push({ path: relPath, label, when });
+    }
+    return rows;
+}
+async function readRequirements(projectRoot, realRoot) {
+    const planningRel = ".shipwright/planning";
+    const guard = pathGuard(projectRoot, planningRel);
+    if (!guard.ok)
+        return [];
+    let entries;
+    try {
+        entries = await readdir(guard.absolute, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const d of entries) {
+        if (!d.isDirectory() || PLANNING_SECTION_EXCLUDES.has(d.name))
+            continue;
+        const relPath = `${planningRel}/${d.name}/spec.md`;
+        const abs = verifiedAbsolute(projectRoot, realRoot, relPath);
+        if (!abs)
+            continue; // section without its own spec.md — skip
+        const when = await mtimeIso(abs);
+        if (when === null)
+            continue;
+        rows.push({ path: relPath, label: sectionLabel(d.name), when });
+    }
+    rows.sort((a, b) => a.label.localeCompare(b.label));
+    return rows;
+}
+async function readIterateSpecs(projectRoot, realRoot) {
+    const relDir = ".shipwright/planning/iterate";
+    const guard = pathGuard(projectRoot, relDir);
+    if (!guard.ok)
+        return [];
+    let entries;
+    try {
+        entries = await readdir(guard.absolute, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const d of entries) {
+        // Flat files only (per the panel's Iterate tab spec) — a subdirectory
+        // like campaigns/ or a per-run folder is out of scope here.
+        if (!d.isFile() || !d.name.endsWith(".md"))
+            continue;
+        const relPath = `${relDir}/${d.name}`;
+        const abs = verifiedAbsolute(projectRoot, realRoot, relPath);
+        if (!abs)
+            continue;
+        const when = await mtimeIso(abs);
+        rows.push({ path: relPath, label: d.name, when });
+    }
+    // Newest first; a row with no readable mtime sorts last rather than
+    // fabricating a position it didn't earn.
+    rows.sort((a, b) => {
+        if (a.when === b.when)
+            return a.label.localeCompare(b.label);
+        if (a.when === null)
+            return 1;
+        if (b.when === null)
+            return -1;
+        return a.when < b.when ? 1 : -1;
+    });
+    return rows;
+}
+export async function readShipsLogDocs(projectRoot) {
+    let realRoot;
+    try {
+        realRoot = realpathSync(path.resolve(projectRoot));
+    }
+    catch {
+        // Project root itself unreadable — every group degrades to empty
+        // rather than throwing (this is a read-only observer, spec AC-honesty).
+        return { requirements: [], iterateSpecs: [], agentDocs: [], compliance: [] };
+    }
+    const [requirements, iterateSpecs, agentDocs, compliance] = await Promise.all([
+        readRequirements(projectRoot, realRoot),
+        readIterateSpecs(projectRoot, realRoot),
+        curatedRows(projectRoot, realRoot, ".shipwright/agent_docs", AGENT_DOCS),
+        curatedRows(projectRoot, realRoot, ".shipwright/compliance", COMPLIANCE_DOCS),
+    ]);
+    return { requirements, iterateSpecs, agentDocs, compliance };
+}
+//# sourceMappingURL=shipslog-docs-reader.js.map

package/server/dist/core/shipslog-docs-reader.js.map

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

package/server/dist/core/shipslog-docs-types.d.ts

@@ -0,0 +1,15 @@
+export interface ShipsLogDocRow {
+    /** Project-root-relative POSIX path, passed straight to SmartViewerModal. */
+    path: string;
+    label: string;
+    /** ISO mtime, or null when the stat failed after the existence check
+     *  (a TOCTOU race — treated as "date unknown", never fabricated). */
+    when: string | null;
+}
+export interface ShipsLogDocsBundle {
+    requirements: ShipsLogDocRow[];
+    iterateSpecs: ShipsLogDocRow[];
+    agentDocs: ShipsLogDocRow[];
+    compliance: ShipsLogDocRow[];
+}
+//# sourceMappingURL=shipslog-docs-types.d.ts.map

package/server/dist/core/shipslog-docs-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipslog-docs-types.d.ts","sourceRoot":"","sources":["../../src/core/shipslog-docs-types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;yEACqE;IACrE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/server/dist/core/shipslog-docs-types.js

@@ -0,0 +1,14 @@
+/*
+ * shipslog-docs-types.ts — shape contract for the Ship's-Log Documents
+ * panel read surface (iterate-2026-08-31-shipslog-documents-panel):
+ * curated links to a project's Requirements spec(s) (per planning-section
+ * ur-spec, .shipwright/planning/<section>/spec.md), Iterate mini-specs
+ * (.shipwright/planning/iterate/*.md), Agent Docs and Compliance docs.
+ *
+ * Split out (not folded into the reader) to match the run-data-types.ts
+ * precedent; verbatim-mirrored client-side in
+ * client/src/lib/shipsLogDocsApi.ts (ADR-080 — no cross-package import).
+ * Drift guard: server/src/test/shipslog-docs-mirror-sync.test.ts.
+ */
+export {};
+//# sourceMappingURL=shipslog-docs-types.js.map

package/server/dist/core/shipslog-docs-types.js.map

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

package/server/dist/core/shipwright-plugin-version-reader.d.ts

@@ -0,0 +1,15 @@
+export interface ShipwrightPluginVersionReaderDeps {
+    /** Injected for tests; defaults to fs/promises.readFile + utf-8. */
+    readFile?: (path: string) => Promise<string>;
+    /** Injected for tests; defaults to os.homedir(). */
+    homedir?: () => string;
+}
+/** Absolute path to the shipwright marketplace manifest. */
+export declare function shipwrightMarketplaceManifestPath(home: string): string;
+/**
+ * Read the shipwright plugin suite's version, or `null` when it can't be
+ * determined (not installed, unreadable, malformed). Swallows every error —
+ * the caller treats `null` as "unknown", never as a 500.
+ */
+export declare function readShipwrightPluginVersion(deps?: ShipwrightPluginVersionReaderDeps): Promise<string | null>;
+//# sourceMappingURL=shipwright-plugin-version-reader.d.ts.map

package/server/dist/core/shipwright-plugin-version-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipwright-plugin-version-reader.d.ts","sourceRoot":"","sources":["../../src/core/shipwright-plugin-version-reader.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,iCAAiC;IAChD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,4DAA4D;AAC5D,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,GAAE,iCAAsC,GAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}

package/server/dist/core/shipwright-plugin-version-reader.js

@@ -0,0 +1,49 @@
+/*
+ * Shipwright plugin-suite version reader (iterate-2026-09-05-nav-collapse-
+ * and-version-badges).
+ *
+ * Reads the single suite-wide `version` stamp from the "shipwright"
+ * marketplace manifest at `~/.claude/plugins/marketplaces/shipwright/
+ * .claude-plugin/marketplace.json`. All 14 shipwright plugins release in
+ * lockstep and share this one version (see CLAUDE.md memory: "Monorepo
+ * release MUST bump all 14 plugin.json + marketplace.json stamps"), so the
+ * marketplace manifest's top-level `version` is the single unambiguous
+ * source for "the current plugin version" the Diagnostics page shows —
+ * reading any one of the 14 per-plugin manifests would be an arbitrary pick.
+ *
+ * Read-only, best-effort, same shape as claude-theme-reader.ts: a missing
+ * marketplace (plugin not installed), unreadable file, non-JSON body, or
+ * absent/non-string `version` all resolve to `null` (never throw).
+ */
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Absolute path to the shipwright marketplace manifest. */
+export function shipwrightMarketplaceManifestPath(home) {
+    return join(home, ".claude", "plugins", "marketplaces", "shipwright", ".claude-plugin", "marketplace.json");
+}
+/**
+ * Read the shipwright plugin suite's version, or `null` when it can't be
+ * determined (not installed, unreadable, malformed). Swallows every error —
+ * the caller treats `null` as "unknown", never as a 500.
+ */
+export async function readShipwrightPluginVersion(deps = {}) {
+    const home = (deps.homedir ?? homedir)();
+    const fsRead = deps.readFile ?? ((p) => readFile(p, "utf-8"));
+    try {
+        const raw = await fsRead(shipwrightMarketplaceManifestPath(home));
+        const parsed = JSON.parse(raw);
+        if (parsed &&
+            typeof parsed === "object" &&
+            "version" in parsed &&
+            typeof parsed.version === "string") {
+            const version = parsed.version.trim();
+            return version.length > 0 ? version : null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=shipwright-plugin-version-reader.js.map

package/server/dist/core/shipwright-plugin-version-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipwright-plugin-version-reader.js","sourceRoot":"","sources":["../../src/core/shipwright-plugin-version-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,4DAA4D;AAC5D,MAAM,UAAU,iCAAiC,CAAC,IAAY;IAC5D,OAAO,IAAI,CACT,IAAI,EACJ,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA0C,EAAE;IAE5C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IACE,MAAM;YACN,OAAO,MAAM,KAAK,QAAQ;YAC1B,SAAS,IAAI,MAAM;YACnB,OAAQ,MAA+B,CAAC,OAAO,KAAK,QAAQ,EAC5D,CAAC;YACD,MAAM,OAAO,GAAI,MAA8B,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/server/dist/external/design-review/serve.js

@@ -61,33 +61,33 @@ const SERVE_MIME = Object.freeze({
  *  markdown to the WebUI host. `write()` captures the blob text and posts it;
  *  it must NEVER reject (a throw would drop the viewer into its download
  *  fallback). Posts with `targetOrigin === location.origin` (same-origin host). */
-const FEEDBACK_BRIDGE = `<script>
-(function () {
-  var HOST_ORIGIN = window.location.origin;
-  function post(text) {
-    try {
-      window.parent.postMessage(
-        { type: "shipwright:design-feedback", markdown: String(text) },
-        HOST_ORIGIN
-      );
-    } catch (e) { /* never let a post error trip the viewer's download fallback */ }
-  }
-  window.showSaveFilePicker = function () {
-    return Promise.resolve({
-      createWritable: function () {
-        return Promise.resolve({
-          write: function (blob) {
-            return Promise.resolve(
-              blob && typeof blob.text === "function" ? blob.text() : blob
-            ).then(post, function () { /* swallow */ });
-          },
-          close: function () { return Promise.resolve(); },
-        });
-      },
-    });
-  };
-})();
-</script>
+const FEEDBACK_BRIDGE = `<script>
+(function () {
+  var HOST_ORIGIN = window.location.origin;
+  function post(text) {
+    try {
+      window.parent.postMessage(
+        { type: "shipwright:design-feedback", markdown: String(text) },
+        HOST_ORIGIN
+      );
+    } catch (e) { /* never let a post error trip the viewer's download fallback */ }
+  }
+  window.showSaveFilePicker = function () {
+    return Promise.resolve({
+      createWritable: function () {
+        return Promise.resolve({
+          write: function (blob) {
+            return Promise.resolve(
+              blob && typeof blob.text === "function" ? blob.text() : blob
+            ).then(post, function () { /* swallow */ });
+          },
+          close: function () { return Promise.resolve(); },
+        });
+      },
+    });
+  };
+})();
+</script>
 `;
 /** Insert the bridge before the first <script> (so the override is defined
  *  before the viewer script runs), else before </body>, else append. */

package/server/dist/external/inbox/_derive.d.ts

@@ -1,30 +1,7 @@
 import { SessionWatcher } from "../../core/session-watcher.js";
 import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
-export type AggregatedEntry = {
-    kind: "ask_tool";
-    taskId: string;
-    sessionUuid: string;
-    taskTitle: string;
-    toolUseId: string;
-    toolName: string;
-    input: unknown;
-    bestEffort: true;
-} | {
-    kind: "text_question";
-    taskId: string;
-    sessionUuid: string;
-    taskTitle: string;
-    questionId: string;
-    questionText: string;
-    bestEffort: true;
-} | {
-    kind: "terminal_prompt";
-    taskId: string;
-    sessionUuid: string;
-    taskTitle: string;
-    promptText: string;
-    bestEffort: true;
-};
+export type { AggregatedEntry } from "./_types.js";
+import type { AggregatedEntry } from "./_types.js";
 /**
  * Walk every task in the store, return cached entries on a warm hit
  * (mtime + dismissed unchanged), otherwise re-read the JSONL +

package/server/dist/external/inbox/_derive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_derive.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/_derive.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAO/D,OAAO,EACL,gBAAgB,EAEjB,MAAM,kCAAkC,CAAC;AAS1C,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;CAClB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,CAAC;CAClB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAEN;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAyH/D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EAAE,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KAClD,CAAC;CACH,GACA,IAAI,CA2CN"}
+{"version":3,"file":"_derive.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/_derive.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAO/D,OAAO,EACL,gBAAgB,EAEjB,MAAM,kCAAkC,CAAC;AAS1C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAyH/D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EAAE,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KAClD,CAAC;CACH,GACA,IAAI,CA2CN"}

package/server/dist/external/inbox/_derive.js.map

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

package/server/dist/external/inbox/_lead.d.ts

@@ -0,0 +1,23 @@
+import type { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+import type { AggregatedEntry } from "./_types.js";
+/** Dismiss-id prefix for a `lead_question` — disambiguates from a JSONL `toolUseId` (which never starts with this). */
+export declare const LEAD_QUESTION_DISMISS_PREFIX = "lq-";
+export declare function leadQuestionDismissId(taskId: string): string;
+/**
+ * FR-04.37 outbound: the marker line is an internal sentinel and must
+ * never reach the rendered "notification" (the inbox card) — strip it
+ * and return the human-authored body only. `null` when no marker is
+ * present (an ordinary task description, not a waiting follow-up).
+ */
+export declare function extractLeadQuestionBody(description: string | undefined): string | null;
+/**
+ * Post-pass over the store (mirrors `appendTerminalPrompts`'s shape):
+ * append one `lead_question` entry per waiting, non-dismissed, unanswered
+ * task. Runs after the JSONL-derived pass; a task already surfaced under
+ * another kind (e.g. a live `ask_tool`) still gets its own lead_question
+ * entry too — the two are independent waiting states on the same task.
+ */
+export declare function appendLeadQuestions(entries: AggregatedEntry[], args: {
+    store: SdkSessionsStore;
+}): void;
+//# sourceMappingURL=_lead.d.ts.map

package/server/dist/external/inbox/_lead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_lead.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/_lead.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD,uHAAuH;AACvH,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EAAE,EAC1B,IAAI,EAAE;IAAE,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChC,IAAI,CAkBN"}

package/server/dist/external/inbox/_lead.js

@@ -0,0 +1,83 @@
+/*
+ * external/inbox/_lead.ts — the `lead_question` inbox kind (FR-04.17/18/19).
+ *
+ * Unlike `ask_tool`/`text_question`/`terminal_prompt` (derived from a JSONL
+ * or live-terminal read — see `./_derive.ts`), a `lead_question` is WRITTEN:
+ * leadwright's `renderLeadQuestion` (separate repo, `lib/lead-question.ts`)
+ * puts a `<!-- lead-question:TYPE -->` marker line at the top of a task's
+ * `description` when it proposes a follow-up. This module only needs to
+ * detect that marker's PRESENCE and strip it — the six named question
+ * types are leadwright's own vocabulary (FR-04.18), not webui's. Per
+ * CLAUDE.md DO-NOT #7 this is a verbatim, independent mirror of the
+ * detection regex, not a cross-package import.
+ *
+ * A task is "waiting" iff its description carries the marker AND it has
+ * not yet been answered (`poFeedback` unset) and not yet dismissed.
+ *
+ * CONTRACT (by design, not a bug): both suppressions are per-TASK, not
+ * per-question. Once `poFeedback` is set (answered) or `lq-<taskId>` is
+ * dismissed, this task can surface no FURTHER lead_question until
+ * leadwright clears `poFeedback` and rewrites `description` for the next
+ * follow-up — there is no per-question id to key a narrower suppression on,
+ * and inventing one is explicitly out of scope here (that's leadwright's
+ * FR-04.18 concern, not webui's). If leadwright ever needs to re-ask on the
+ * SAME task while an old answer is still present, it must clear
+ * `poFeedback` first.
+ */
+const LEAD_QUESTION_MARKER_RE = /^<!--\s*lead-question:[a-zäöüß-]+\s*-->/;
+// Same marker, but matched anywhere on its own line — used to strip a
+// re-ask's marker appended BELOW the leading one, so the sentinel can never
+// survive into the body even from a second occurrence (FR-04.37).
+const LEAD_QUESTION_MARKER_LINE_RE = /^[ \t]*<!--\s*lead-question:[a-zäöüß-]+\s*-->[ \t]*$/gim;
+/** Dismiss-id prefix for a `lead_question` — disambiguates from a JSONL `toolUseId` (which never starts with this). */
+export const LEAD_QUESTION_DISMISS_PREFIX = "lq-";
+export function leadQuestionDismissId(taskId) {
+    return `${LEAD_QUESTION_DISMISS_PREFIX}${taskId}`;
+}
+/**
+ * FR-04.37 outbound: the marker line is an internal sentinel and must
+ * never reach the rendered "notification" (the inbox card) — strip it
+ * and return the human-authored body only. `null` when no marker is
+ * present (an ordinary task description, not a waiting follow-up).
+ */
+export function extractLeadQuestionBody(description) {
+    if (typeof description !== "string")
+        return null;
+    const match = LEAD_QUESTION_MARKER_RE.exec(description);
+    if (!match)
+        return null;
+    return description
+        .slice(match[0].length)
+        .replace(/^[\r\n]+/, "")
+        .replace(LEAD_QUESTION_MARKER_LINE_RE, "");
+}
+/**
+ * Post-pass over the store (mirrors `appendTerminalPrompts`'s shape):
+ * append one `lead_question` entry per waiting, non-dismissed, unanswered
+ * task. Runs after the JSONL-derived pass; a task already surfaced under
+ * another kind (e.g. a live `ask_tool`) still gets its own lead_question
+ * entry too — the two are independent waiting states on the same task.
+ */
+export function appendLeadQuestions(entries, args) {
+    const { store } = args;
+    for (const task of store.list()) {
+        if (task.state === "done" || task.state === "launch_failed")
+            continue;
+        if (task.poFeedback)
+            continue;
+        const body = extractLeadQuestionBody(task.description);
+        if (body === null)
+            continue;
+        if (task.inbox.dismissedToolUseIds.includes(leadQuestionDismissId(task.taskId))) {
+            continue;
+        }
+        entries.push({
+            kind: "lead_question",
+            taskId: task.taskId,
+            sessionUuid: task.sessionUuid,
+            taskTitle: task.title,
+            questionText: body,
+        });
+    }
+}
+//# sourceMappingURL=_lead.js.map

package/server/dist/external/inbox/_lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_lead.js","sourceRoot":"","sources":["../../../src/external/inbox/_lead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAC1E,sEAAsE;AACtE,4EAA4E;AAC5E,kEAAkE;AAClE,MAAM,4BAA4B,GAChC,yDAAyD,CAAC;AAE5D,uHAAuH;AACvH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,GAAG,4BAA4B,GAAG,MAAM,EAAE,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAA+B;IAE/B,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,WAAW;SACf,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA0B,EAC1B,IAAiC;IAEjC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,eAAe;YAAE,SAAS;QACtE,IAAI,IAAI,CAAC,UAAU;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAChF,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/server/dist/external/inbox/_types.d.ts

@@ -0,0 +1,32 @@
+export type AggregatedEntry = {
+    kind: "ask_tool";
+    taskId: string;
+    sessionUuid: string;
+    taskTitle: string;
+    toolUseId: string;
+    toolName: string;
+    input: unknown;
+    bestEffort: true;
+} | {
+    kind: "text_question";
+    taskId: string;
+    sessionUuid: string;
+    taskTitle: string;
+    questionId: string;
+    questionText: string;
+    bestEffort: true;
+} | {
+    kind: "terminal_prompt";
+    taskId: string;
+    sessionUuid: string;
+    taskTitle: string;
+    promptText: string;
+    bestEffort: true;
+} | {
+    kind: "lead_question";
+    taskId: string;
+    sessionUuid: string;
+    taskTitle: string;
+    questionText: string;
+};
+//# sourceMappingURL=_types.d.ts.map

package/server/dist/external/inbox/_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/_types.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;CAClB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,CAAC;CAClB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;CAClB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/server/dist/external/inbox/_types.js

@@ -0,0 +1,10 @@
+/*
+ * external/inbox/_types.ts — the aggregator's output shape, shared by
+ * `_derive.ts` (JSONL/terminal-derived kinds) and `_lead.ts` (the written
+ * `lead_question` kind). Split out to keep `_derive.ts` under the 300-LOC
+ * guideline. Discriminated union precedence: ask_tool > terminal_prompt >
+ * text_question; `lead_question` is independent of that precedence — it
+ * reflects a different waiting state on the same task, not a JSONL read.
+ */
+export {};
+//# sourceMappingURL=_types.js.map

package/server/dist/external/inbox/_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../../src/external/inbox/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/server/dist/external/inbox/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/routes.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAKpE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KAClD,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA0C7D"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/external/inbox/routes.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAUpE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KAClD,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAoE7D"}