mumei-dashboard 0.4.2 → 0.4.3

package/dist/server/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';
 import { execFile } from 'child_process';
 import { existsSync, createReadStream, stat as stat$1, unwatchFile, watchFile, watch as watch$1 } from 'fs';
-import { readFile, readdir, stat, access, realpath, lstat, open } from 'fs/promises';
+import { readdir, readFile, stat, access, realpath, lstat, open } from 'fs/promises';
 import * as sp2 from 'path';
 import sp2__default, { resolve, join, relative, sep } from 'path';
 import { promisify } from 'util';
@@ -43717,6 +43717,21 @@ var FeatureDetailSchema = Type.Object(
     ),
     timeline: Type.Array(TimelineEntrySchema),
     acs: Type.Array(AcSchema, { description: "Empty array when planVehicle=true." }),
+    phase: Type.Union(
+      [
+        Type.Literal("plan"),
+        Type.Literal("implement"),
+        Type.Literal("review"),
+        Type.Literal("done"),
+        Type.Null()
+      ],
+      {
+        description: "Phase from state.json. Null when state.json is missing or unreadable. Frontend's Tasks tab only renders the active-Wave shimmer while phase === 'implement' (and not archived)."
+      }
+    ),
+    currentWave: Type.Union([Type.Integer({ minimum: 0 }), Type.Null()], {
+      description: "Current Wave index from state.json (spec vehicle only). Null when planVehicle=true, when state.json is absent, or when current_wave is unset. Frontend's Tasks tab highlights this Wave only while phase === 'implement' and !archived; otherwise all Waves render as historical state."
+    }),
     waveplan: Type.Array(WaveplanEntrySchema),
     reviews: Type.Array(ReviewSummarySchema),
     costPerIter: Type.Array(CostPerIterSchema)
@@ -43770,7 +43785,9 @@ var FeatureSummarySchema = Type.Object(
     lastVerdict: Type.Union([VerdictSchema, Type.Null()], {
       description: "Verdict from the most recent review JSON (Phase 5 / /mumei:review). Null when no review has run yet."
     }),
-    lastIter: Type.Union([Type.Integer({ minimum: 1, maximum: 3 }), Type.Null()]),
+    lastIter: Type.Union([Type.Integer({ minimum: 1 }), Type.Null()], {
+      description: "Review iter index from the most recent review JSON. Current orchestrator caps at 3 (REQ-7.6) but historical archived reviews may carry higher values; no upper bound is enforced here."
+    }),
     tokens: Type.Integer({
       minimum: 0,
       description: "Sum of input_tokens + output_tokens from cost-log.jsonl entries (phase=after) for this feature."
@@ -43921,11 +43938,218 @@ var HooksTrendSchema = Type.Array(
     description: "GET /api/trends/hooks?topN=10&windowH=24 result. Top-N hook_id rows by firing count within the window."
   }
 );
-
-// src/schemas/_formats.ts
-var ISO_DATE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
-if (!format_exports.Has("date-time")) {
-  format_exports.Set("date-time", (v) => typeof v === "string" && ISO_DATE_TIME.test(v));
+async function* readJsonl(filePath, opts) {
+  try {
+    await access(filePath);
+  } catch {
+    return;
+  }
+  const stream = createReadStream(filePath, { encoding: "utf8" });
+  const rl = createInterface({ input: stream, crlfDelay: Infinity });
+  let lineNumber = 0;
+  try {
+    for await (const line of rl) {
+      lineNumber += 1;
+      if (!line.trim()) continue;
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (opts?.validate && !opts.validate(parsed)) {
+        process.stderr.write(
+          `[mumei dashboard] JSONL shape violation, skipping: file=${filePath} line=${lineNumber}
+`
+        );
+        continue;
+      }
+      yield parsed;
+    }
+  } finally {
+    rl.close();
+    stream.destroy();
+  }
+}
+function utcDay(iso) {
+  const isoDay = iso.slice(0, 10);
+  if (/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/.test(isoDay)) return isoDay;
+  return "";
+}
+async function aggregateTokensByDay(files, days, now = /* @__PURE__ */ new Date()) {
+  const buckets = /* @__PURE__ */ new Map();
+  const dayKeys = utcDayWindow(now, days);
+  for (const k of dayKeys) buckets.set(k, 0);
+  const earliest = dayKeys[0];
+  if (!earliest) return [];
+  for (const file of files) {
+    for await (const e of readJsonl(file)) {
+      if (e.phase !== "after") continue;
+      const d = utcDay(e.ts);
+      if (!d || d < earliest) continue;
+      if (!buckets.has(d)) continue;
+      const tokens = (e.input_tokens ?? 0) + (e.output_tokens ?? 0);
+      buckets.set(d, (buckets.get(d) ?? 0) + tokens);
+    }
+  }
+  return dayKeys.map((d) => ({ d, v: buckets.get(d) ?? 0 }));
+}
+async function aggregateMonthTokens(files, now = /* @__PURE__ */ new Date()) {
+  const monthPrefix = now.toISOString().slice(0, 7);
+  let monthTokens = 0;
+  let cacheRead = 0;
+  let nonCacheInput = 0;
+  for (const file of files) {
+    for await (const e of readJsonl(file)) {
+      if (e.phase !== "after") continue;
+      if (!e.ts.startsWith(monthPrefix)) continue;
+      const inputT = e.input_tokens ?? 0;
+      const outputT = e.output_tokens ?? 0;
+      const readT = e.cache_read_input_tokens ?? 0;
+      monthTokens += inputT + outputT;
+      cacheRead += readT;
+      nonCacheInput += inputT;
+    }
+  }
+  const denom = nonCacheInput + cacheRead;
+  const cacheHitRate = denom > 0 ? cacheRead / denom : 0;
+  return { monthTokens, cacheHitRate };
+}
+async function aggregateReviewsByDay(reviewDirs, days, now = /* @__PURE__ */ new Date()) {
+  const buckets = /* @__PURE__ */ new Map();
+  const dayKeys = utcDayWindow(now, days);
+  for (const k of dayKeys) buckets.set(k, { d: k, PASS: 0, NI: 0, MI: 0 });
+  const earliest = dayKeys[0];
+  if (!earliest) return [];
+  for (const dir of reviewDirs) {
+    const entries = await safeReaddir(dir);
+    for (const ent of entries) {
+      if (!ent.isFile()) continue;
+      if (!ent.name.endsWith(".json")) continue;
+      if (ent.name.endsWith("-detectors.json")) continue;
+      const fp = sp2__default.join(dir, ent.name);
+      const body = await safeReadFile(fp);
+      if (!body) continue;
+      let parsed;
+      try {
+        parsed = JSON.parse(body);
+      } catch {
+        continue;
+      }
+      const mt = await safeMtime(fp);
+      const iso = mt ?? parsed.ts ?? "";
+      const d = utcDay(iso);
+      if (!d || d < earliest) continue;
+      const bucket = buckets.get(d);
+      if (!bucket) continue;
+      switch (parsed.verdict) {
+        case "PASS":
+          bucket.PASS += 1;
+          break;
+        case "NEEDS_IMPROVEMENT":
+          bucket.NI += 1;
+          break;
+        case "MAJOR_ISSUES":
+          bucket.MI += 1;
+          break;
+      }
+    }
+  }
+  return dayKeys.map((d) => buckets.get(d) ?? { d, PASS: 0, NI: 0, MI: 0 });
+}
+async function aggregateHooksTopN(filePath, topN, windowH, now = /* @__PURE__ */ new Date()) {
+  const cutoff = new Date(now.getTime() - windowH * 36e5).toISOString();
+  const counts = /* @__PURE__ */ new Map();
+  for await (const e of readJsonl(filePath)) {
+    if (!e.ts || e.ts < cutoff) continue;
+    if (!e.hook_id) continue;
+    const slot = counts.get(e.hook_id) ?? { count: 0, decisions: /* @__PURE__ */ new Map() };
+    slot.count += 1;
+    const dec = e.decision || "noop";
+    slot.decisions.set(dec, (slot.decisions.get(dec) ?? 0) + 1);
+    counts.set(e.hook_id, slot);
+  }
+  const rows = [];
+  for (const [hook_id, slot] of counts) {
+    let topDecision = "noop";
+    let topCount = -1;
+    for (const [d, c] of slot.decisions) {
+      if (c > topCount) {
+        topCount = c;
+        topDecision = d;
+      }
+    }
+    rows.push({ hook_id, count: slot.count, decision: topDecision });
+  }
+  rows.sort((a, b) => b.count - a.count);
+  return rows.slice(0, topN);
+}
+async function eventCount24h(args) {
+  const now = args.now ?? /* @__PURE__ */ new Date();
+  const cutoff = new Date(now.getTime() - 24 * 36e5).toISOString();
+  let count = 0;
+  for (const file of args.costLogFiles) {
+    for await (const e of readJsonl(file)) {
+      if (e.phase === "after" && e.ts >= cutoff) count += 1;
+    }
+  }
+  for await (const e of readJsonl(args.hookStatsFile)) {
+    if (e.ts && e.ts >= cutoff) count += 1;
+  }
+  for (const dir of args.reviewDirs) {
+    const entries = await safeReaddir(dir);
+    for (const ent of entries) {
+      if (!ent.isFile()) continue;
+      if (!ent.name.endsWith(".json")) continue;
+      const fp = sp2__default.join(dir, ent.name);
+      const mt = await safeMtime(fp);
+      if (mt && mt >= cutoff) count += 1;
+    }
+  }
+  for (const ts of args.gitTimestamps) {
+    if (ts >= cutoff) count += 1;
+  }
+  return count;
+}
+async function hooksPerSec(filePath, now = /* @__PURE__ */ new Date()) {
+  const cutoff = new Date(now.getTime() - 24 * 36e5).toISOString();
+  let count = 0;
+  for await (const e of readJsonl(filePath)) {
+    if (e.ts && e.ts >= cutoff) count += 1;
+  }
+  return count / (24 * 3600);
+}
+function utcDayWindow(now, days) {
+  if (days <= 0) return [];
+  const out = [];
+  const today = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+  for (let i = days - 1; i >= 0; i--) {
+    const d = new Date(today.getTime() - i * 864e5);
+    out.push(d.toISOString().slice(0, 10));
+  }
+  return out;
+}
+async function safeReaddir(dir) {
+  try {
+    return await readdir(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+}
+async function safeReadFile(p) {
+  try {
+    return await readFile(p, "utf8");
+  } catch {
+    return null;
+  }
+}
+async function safeMtime(p) {
+  try {
+    const s = await stat(p);
+    return s.mtime.toISOString();
+  } catch {
+    return null;
+  }
 }
 
 // node_modules/@sinclair/typebox/build/esm/errors/function.mjs
@@ -46226,6 +46450,12 @@ var TypeCompiler;
   TypeCompiler2.Compile = Compile;
 })(TypeCompiler || (TypeCompiler = {}));
 
+// src/schemas/_formats.ts
+var ISO_DATE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+if (!format_exports.Has("date-time")) {
+  format_exports.Set("date-time", (v) => typeof v === "string" && ISO_DATE_TIME.test(v));
+}
+
 // src/schemas/cost-log.ts
 var CostLogEntrySchema = Type.Object(
   {
@@ -46374,130 +46604,6 @@ var ReviewSchema = Type.Object(
   }
 );
 
-// src/schemas/sse-event.ts
-var InlineActivityEventSchema = Type.Union([
-  Type.Object(
-    {
-      ts: Type.String({ format: "date-time" }),
-      kind: Type.Literal("commit"),
-      slug: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-      ref: Type.String({ pattern: "^[0-9a-f]{7,40}$" }),
-      message: Type.String()
-    },
-    { additionalProperties: false }
-  ),
-  Type.Object(
-    {
-      ts: Type.String({ format: "date-time" }),
-      kind: Type.Literal("review"),
-      slug: Type.String(),
-      verdict: Type.Union([
-        Type.Literal("PASS"),
-        Type.Literal("NEEDS_IMPROVEMENT"),
-        Type.Literal("MAJOR_ISSUES")
-      ]),
-      iter: Type.Integer({ minimum: 1, maximum: 3 })
-    },
-    { additionalProperties: false }
-  ),
-  Type.Object(
-    {
-      ts: Type.String({ format: "date-time" }),
-      kind: Type.Literal("phase"),
-      slug: Type.String(),
-      from: Type.Union([
-        Type.Literal("plan"),
-        Type.Literal("implement"),
-        Type.Literal("review"),
-        Type.Literal("done")
-      ]),
-      to: Type.Union([
-        Type.Literal("plan"),
-        Type.Literal("implement"),
-        Type.Literal("review"),
-        Type.Literal("done")
-      ])
-    },
-    { additionalProperties: false }
-  ),
-  Type.Object(
-    {
-      ts: Type.String({ format: "date-time" }),
-      kind: Type.Literal("hook"),
-      hook_id: Type.String({
-        description: "Hook rule short id emitted by hooks/_lib/hook-stats.sh:mumei_hook_stats_record."
-      }),
-      decision: Type.Union([
-        Type.Literal("allow"),
-        Type.Literal("deny"),
-        Type.Literal("warn"),
-        Type.Literal("block"),
-        Type.Literal("noop"),
-        Type.Literal("pass")
-      ])
-    },
-    { additionalProperties: false }
-  )
-]);
-var FeatureUpdateEventSchema = Type.Object(
-  {
-    type: Type.Literal("feature.update"),
-    slug: Type.Optional(
-      Type.String({
-        pattern: "^(REQ-[0-9]+(-[a-z0-9-]+)?|[a-z0-9][a-z0-9-]*)$",
-        description: "Feature key whose state.json or review changed (REQ-N-slug for spec, bare slug for plan); useEventStream invalidates ['features'], ['feature', slug, 'detail'], AND ['meta','stats']. Omit when the change is project-wide (e.g. .hook-stats.jsonl) and only `affects` is meaningful."
-      })
-    ),
-    affects: Type.Optional(
-      Type.Array(
-        Type.Union([Type.Literal("hooks"), Type.Literal("reviews"), Type.Literal("tokens")]),
-        {
-          uniqueItems: true,
-          description: "Trend kinds whose underlying data changed. useEventStream invalidates `['trend', kind, ...]` for each entry, in addition to the slug-scoped invalidations above. Omit when no trend is affected."
-        }
-      )
-    )
-  },
-  { additionalProperties: false }
-);
-var CostUpdatedEventSchema = Type.Object(
-  {
-    type: Type.Literal("cost.updated"),
-    slug: Type.Optional(
-      Type.Union([Type.String(), Type.Null()], {
-        description: "Feature slug owning the cost-log, or null when the change was project-wide."
-      })
-    )
-  },
-  { additionalProperties: false }
-);
-var ActivityChangedEventSchema = Type.Object(
-  {
-    type: Type.Literal("activity.changed")
-  },
-  { additionalProperties: false }
-);
-var ActivityAddedEventSchema = Type.Object(
-  {
-    type: Type.Literal("activity.added"),
-    event: InlineActivityEventSchema
-  },
-  { additionalProperties: false }
-);
-var SseEventSchema = Type.Union(
-  [
-    FeatureUpdateEventSchema,
-    CostUpdatedEventSchema,
-    ActivityChangedEventSchema,
-    ActivityAddedEventSchema
-  ],
-  {
-    $id: "https://mumei.dev/schemas/sse-event.schema.json",
-    title: "mumei dashboard SSE event",
-    description: "Server-Sent Events emitted by dashboard/server/sse.ts on /api/events. All events are debounced 200ms per (event, slug). state.json updates emit BOTH feature.update AND activity.changed; review/hook activity emits only activity.changed. The client treats activity.changed and activity.added as cache-invalidation triggers and refetches /api/activity. Producer: backend chokidar -> EventEmitter pipeline. Consumer: dashboard/src/hooks/useEventStream.ts."
-  }
-);
-
 // src/schemas/state.ts
 var StateSchema = Type.Object(
   {
@@ -46598,225 +46704,10 @@ var StateSchema = Type.Object(
   }
 );
 
-// src/lib/validators.ts
+// server/lib/validators.ts
 var validateState = TypeCompiler.Compile(StateSchema);
 var validateCostLogEntry = TypeCompiler.Compile(CostLogEntrySchema);
 var validateReview = TypeCompiler.Compile(ReviewSchema);
-TypeCompiler.Compile(SseEventSchema);
-TypeCompiler.Compile(ActivityEventSchema);
-async function* readJsonl(filePath, opts) {
-  try {
-    await access(filePath);
-  } catch {
-    return;
-  }
-  const stream = createReadStream(filePath, { encoding: "utf8" });
-  const rl = createInterface({ input: stream, crlfDelay: Infinity });
-  let lineNumber = 0;
-  try {
-    for await (const line of rl) {
-      lineNumber += 1;
-      if (!line.trim()) continue;
-      let parsed;
-      try {
-        parsed = JSON.parse(line);
-      } catch {
-        continue;
-      }
-      if (opts?.validate && !opts.validate(parsed)) {
-        process.stderr.write(
-          `[mumei dashboard] JSONL shape violation, skipping: file=${filePath} line=${lineNumber}
-`
-        );
-        continue;
-      }
-      yield parsed;
-    }
-  } finally {
-    rl.close();
-    stream.destroy();
-  }
-}
-function utcDay(iso) {
-  const isoDay = iso.slice(0, 10);
-  if (/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/.test(isoDay)) return isoDay;
-  return "";
-}
-async function aggregateTokensByDay(files, days, now = /* @__PURE__ */ new Date()) {
-  const buckets = /* @__PURE__ */ new Map();
-  const dayKeys = utcDayWindow(now, days);
-  for (const k of dayKeys) buckets.set(k, 0);
-  const earliest = dayKeys[0];
-  if (!earliest) return [];
-  for (const file of files) {
-    for await (const e of readJsonl(file)) {
-      if (e.phase !== "after") continue;
-      const d = utcDay(e.ts);
-      if (!d || d < earliest) continue;
-      if (!buckets.has(d)) continue;
-      const tokens = (e.input_tokens ?? 0) + (e.output_tokens ?? 0);
-      buckets.set(d, (buckets.get(d) ?? 0) + tokens);
-    }
-  }
-  return dayKeys.map((d) => ({ d, v: buckets.get(d) ?? 0 }));
-}
-async function aggregateMonthTokens(files, now = /* @__PURE__ */ new Date()) {
-  const monthPrefix = now.toISOString().slice(0, 7);
-  let monthTokens = 0;
-  let cacheRead = 0;
-  let nonCacheInput = 0;
-  for (const file of files) {
-    for await (const e of readJsonl(file)) {
-      if (e.phase !== "after") continue;
-      if (!e.ts.startsWith(monthPrefix)) continue;
-      const inputT = e.input_tokens ?? 0;
-      const outputT = e.output_tokens ?? 0;
-      const readT = e.cache_read_input_tokens ?? 0;
-      monthTokens += inputT + outputT;
-      cacheRead += readT;
-      nonCacheInput += inputT;
-    }
-  }
-  const denom = nonCacheInput + cacheRead;
-  const cacheHitRate = denom > 0 ? cacheRead / denom : 0;
-  return { monthTokens, cacheHitRate };
-}
-async function aggregateReviewsByDay(reviewDirs, days, now = /* @__PURE__ */ new Date()) {
-  const buckets = /* @__PURE__ */ new Map();
-  const dayKeys = utcDayWindow(now, days);
-  for (const k of dayKeys) buckets.set(k, { d: k, PASS: 0, NI: 0, MI: 0 });
-  const earliest = dayKeys[0];
-  if (!earliest) return [];
-  for (const dir of reviewDirs) {
-    const entries = await safeReaddir(dir);
-    for (const ent of entries) {
-      if (!ent.isFile()) continue;
-      if (!ent.name.endsWith(".json")) continue;
-      if (ent.name.endsWith("-detectors.json")) continue;
-      const fp = sp2__default.join(dir, ent.name);
-      const body = await safeReadFile(fp);
-      if (!body) continue;
-      let parsed;
-      try {
-        parsed = JSON.parse(body);
-      } catch {
-        continue;
-      }
-      const mt = await safeMtime(fp);
-      const iso = mt ?? parsed.ts ?? "";
-      const d = utcDay(iso);
-      if (!d || d < earliest) continue;
-      const bucket = buckets.get(d);
-      if (!bucket) continue;
-      switch (parsed.verdict) {
-        case "PASS":
-          bucket.PASS += 1;
-          break;
-        case "NEEDS_IMPROVEMENT":
-          bucket.NI += 1;
-          break;
-        case "MAJOR_ISSUES":
-          bucket.MI += 1;
-          break;
-      }
-    }
-  }
-  return dayKeys.map((d) => buckets.get(d) ?? { d, PASS: 0, NI: 0, MI: 0 });
-}
-async function aggregateHooksTopN(filePath, topN, windowH, now = /* @__PURE__ */ new Date()) {
-  const cutoff = new Date(now.getTime() - windowH * 36e5).toISOString();
-  const counts = /* @__PURE__ */ new Map();
-  for await (const e of readJsonl(filePath)) {
-    if (!e.ts || e.ts < cutoff) continue;
-    if (!e.hook_id) continue;
-    const slot = counts.get(e.hook_id) ?? { count: 0, decisions: /* @__PURE__ */ new Map() };
-    slot.count += 1;
-    const dec = e.decision || "noop";
-    slot.decisions.set(dec, (slot.decisions.get(dec) ?? 0) + 1);
-    counts.set(e.hook_id, slot);
-  }
-  const rows = [];
-  for (const [hook_id, slot] of counts) {
-    let topDecision = "noop";
-    let topCount = -1;
-    for (const [d, c] of slot.decisions) {
-      if (c > topCount) {
-        topCount = c;
-        topDecision = d;
-      }
-    }
-    rows.push({ hook_id, count: slot.count, decision: topDecision });
-  }
-  rows.sort((a, b) => b.count - a.count);
-  return rows.slice(0, topN);
-}
-async function eventCount24h(args) {
-  const now = args.now ?? /* @__PURE__ */ new Date();
-  const cutoff = new Date(now.getTime() - 24 * 36e5).toISOString();
-  let count = 0;
-  for (const file of args.costLogFiles) {
-    for await (const e of readJsonl(file)) {
-      if (e.phase === "after" && e.ts >= cutoff) count += 1;
-    }
-  }
-  for await (const e of readJsonl(args.hookStatsFile)) {
-    if (e.ts && e.ts >= cutoff) count += 1;
-  }
-  for (const dir of args.reviewDirs) {
-    const entries = await safeReaddir(dir);
-    for (const ent of entries) {
-      if (!ent.isFile()) continue;
-      if (!ent.name.endsWith(".json")) continue;
-      const fp = sp2__default.join(dir, ent.name);
-      const mt = await safeMtime(fp);
-      if (mt && mt >= cutoff) count += 1;
-    }
-  }
-  for (const ts of args.gitTimestamps) {
-    if (ts >= cutoff) count += 1;
-  }
-  return count;
-}
-async function hooksPerSec(filePath, now = /* @__PURE__ */ new Date()) {
-  const cutoff = new Date(now.getTime() - 24 * 36e5).toISOString();
-  let count = 0;
-  for await (const e of readJsonl(filePath)) {
-    if (e.ts && e.ts >= cutoff) count += 1;
-  }
-  return count / (24 * 3600);
-}
-function utcDayWindow(now, days) {
-  if (days <= 0) return [];
-  const out = [];
-  const today = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
-  for (let i = days - 1; i >= 0; i--) {
-    const d = new Date(today.getTime() - i * 864e5);
-    out.push(d.toISOString().slice(0, 10));
-  }
-  return out;
-}
-async function safeReaddir(dir) {
-  try {
-    return await readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-}
-async function safeReadFile(p) {
-  try {
-    return await readFile(p, "utf8");
-  } catch {
-    return null;
-  }
-}
-async function safeMtime(p) {
-  try {
-    const s = await stat(p);
-    return s.mtime.toISOString();
-  } catch {
-    return null;
-  }
-}
 
 // server/activity.ts
 var exec = promisify(execFile);
@@ -47188,12 +47079,13 @@ async function buildWaveplan(args) {
     memo.set(memoKey, { ts: Date.now(), payload: [] });
     return [];
   }
+  const isArchive = tf.includes(`${sp2__default.sep}archive${sp2__default.sep}`);
   let waveplan;
   try {
-    waveplan = await parseTasksMdViaBash({ pluginRoot, tasksFile: tf, featureKey, projectRoot });
+    waveplan = isArchive ? await parseTasksMdInline(tf) : await parseTasksMdViaBash({ pluginRoot, tasksFile: tf, featureKey, projectRoot });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    logAtLevel("warn", `[tasks-bridge] parseTasksMdViaBash failed for ${featureKey}: ${message}
+    logAtLevel("warn", `[tasks-bridge] tasks parse failed for ${featureKey}: ${message}
 `);
     waveplan = [];
   }
@@ -47267,6 +47159,63 @@ function extractWaveHeaders(body) {
   if (current) waves.push(current);
   return waves;
 }
+async function parseTasksMdInline(tasksFile) {
+  const fs = await import('fs/promises');
+  const body = await fs.readFile(tasksFile, "utf8");
+  const waves = extractWaveHeaders(body);
+  const tasks = extractTasksWithMeta(body);
+  return waves.map(({ wave, goal, verify }) => ({
+    wave,
+    goal,
+    verify,
+    tasks: tasks.filter((t) => t.id.startsWith(`${wave}.`))
+  }));
+}
+function extractTasksWithMeta(body) {
+  const out = [];
+  const taskRe = /^- \[([x ])\] (\d+(?:\.\d+)+)\s+(.*)$/;
+  const filesRe = /^\s*_Files:_\s*(.+?)\s*$/;
+  const dependsRe = /^\s*_Depends:_\s*(.+?)\s*$/;
+  const reqsRe = /^\s*_Requirements:_\s*(.+?)\s*$/;
+  let cur = null;
+  for (const raw of body.split("\n")) {
+    const taskMatch = taskRe.exec(raw);
+    if (taskMatch) {
+      if (cur) out.push(cur);
+      cur = {
+        id: taskMatch[2] ?? "",
+        done: taskMatch[1] === "x",
+        description: taskMatch[3] ?? "",
+        files: [],
+        depends: [],
+        reqs: []
+      };
+      continue;
+    }
+    if (!cur) continue;
+    if (/^##/.test(raw)) {
+      out.push(cur);
+      cur = null;
+      continue;
+    }
+    const filesMatch = filesRe.exec(raw);
+    if (filesMatch) {
+      cur.files = splitCsv(filesMatch[1] ?? "");
+      continue;
+    }
+    const dependsMatch = dependsRe.exec(raw);
+    if (dependsMatch) {
+      cur.depends = splitCsv(dependsMatch[1] ?? "").filter((d) => d !== "-");
+      continue;
+    }
+    const reqsMatch = reqsRe.exec(raw);
+    if (reqsMatch) {
+      cur.reqs = splitCsv(reqsMatch[1] ?? "");
+    }
+  }
+  if (cur) out.push(cur);
+  return out;
+}
 function extractTaskDescriptions(body) {
   const map3 = /* @__PURE__ */ new Map();
   const lineRe = /^- \[[x ]\] (\d+(?:\.\d+)*)\s+(.*)$/;
@@ -47296,6 +47245,9 @@ async function buildFeatureDetail(args) {
   const planVehicle = dir.subroot === "plans";
   const slug = featureKey;
   const acs = planVehicle ? [] : await parseAcs(sp2__default.join(dir.absDir, "requirements.md"));
+  const stateForWave = planVehicle ? null : await readStateJson(dir.absDir);
+  const currentWave = stateForWave?.current_wave ?? null;
+  const phase = stateForWave?.phase ?? null;
   const waveplan = await buildWaveplan({ projectRoot, featureKey, pluginRoot });
   const reviews = await loadReviews(sp2__default.join(dir.absDir, "reviews"));
   const costPerIter = await loadCostPerIter({
@@ -47316,6 +47268,8 @@ async function buildFeatureDetail(args) {
     archived,
     timeline,
     acs,
+    phase,
+    currentWave,
     waveplan: waveplan.map((w) => ({
       wave: w.wave,
       goal: w.goal,
@@ -47664,24 +47618,51 @@ async function buildTimeline(args) {
   return dedupTimeline(events);
 }
 var exec4 = promisify(execFile);
+var StateValidationError = class extends Error {
+  file;
+  fieldErrors;
+  stage;
+  constructor(args) {
+    super(args.message);
+    this.name = "StateValidationError";
+    this.file = args.file;
+    this.fieldErrors = args.fieldErrors;
+    this.stage = args.stage;
+  }
+};
 function parseStateOrThrow(body, file) {
   let parsed;
   try {
     parsed = JSON.parse(body);
   } catch (e) {
+    const msg = e.message;
     process.stderr.write(
-      `[mumei dashboard] state.json JSON.parse failed: file=${file} err=${e.message}
+      `[mumei dashboard] state.json JSON.parse failed: file=${file} err=${msg}
 `
     );
-    throw new Error(`state.json JSON.parse failed at ${file}`);
+    throw new StateValidationError({
+      file,
+      stage: "json",
+      fieldErrors: [{ path: "/", message: msg }],
+      message: `state.json JSON.parse failed at ${file}`
+    });
   }
   if (!validateState.Check(parsed)) {
-    const errors = [...validateState.Errors(parsed)].map((e) => `${e.path}: ${e.message}`).join("; ");
+    const fieldErrors = [...validateState.Errors(parsed)].map((e) => ({
+      path: e.path,
+      message: e.message
+    }));
+    const joined = fieldErrors.map((e) => `${e.path}: ${e.message}`).join("; ");
     process.stderr.write(
-      `[mumei dashboard] state.json validation failed: file=${file} errors=${errors}
+      `[mumei dashboard] state.json validation failed: file=${file} errors=${joined}
 `
     );
-    throw new Error(`state.json validation failed at ${file}: ${errors}`);
+    throw new StateValidationError({
+      file,
+      stage: "shape",
+      fieldErrors,
+      message: `state.json validation failed at ${file}: ${joined}`
+    });
   }
   return parsed;
 }
@@ -50203,7 +50184,12 @@ var SlugParam = Type.Object({
 });
 var DocParam = Type.Object({
   slug: Type.String({ pattern: "^[A-Za-z0-9_-]+$", minLength: 1, maxLength: 100 }),
-  doc: Type.Union([Type.Literal("requirements"), Type.Literal("design"), Type.Literal("tasks")])
+  doc: Type.Union([
+    Type.Literal("requirements"),
+    Type.Literal("design"),
+    Type.Literal("tasks"),
+    Type.Literal("scratch")
+  ])
 });
 var FeatureQuery = Type.Object({
   feature: Type.String({ pattern: "^[A-Za-z0-9_-]+$", minLength: 1, maxLength: 100 })
@@ -50302,18 +50288,76 @@ app.get("/api/hook-stats", async () => {
   ]);
   return JSON.parse(stdout);
 });
+var DOC_SLUG_RE = /^[A-Za-z0-9_-]{1,100}$/;
+async function readMarkdownIfInside(file, root) {
+  const resolved = sp2__default.resolve(file);
+  if (!resolved.startsWith(root + sp2__default.sep)) return null;
+  try {
+    return await readFile(resolved, "utf8");
+  } catch {
+    return null;
+  }
+}
 app.get("/api/feature/:slug/:doc", { schema: { params: DocParam } }, async (req, reply) => {
   const { slug, doc } = req.params;
+  if (!DOC_SLUG_RE.test(slug)) {
+    reply.code(400);
+    return { error: "invalid slug" };
+  }
+  if (doc === "scratch") {
+    const bare = slug.replace(/^REQ-\d+-/, "");
+    const candidates2 = [
+      sp2__default.join(MUMEI_DIR, "scratch", `${bare}.md`),
+      sp2__default.join(MUMEI_DIR, "scratch", `${slug}.md`)
+    ];
+    for (const p of candidates2) {
+      const body = await readMarkdownIfInside(p, MUMEI_DIR);
+      if (body !== null) {
+        reply.type("text/markdown");
+        return body;
+      }
+    }
+    reply.code(404);
+    return { error: "not found" };
+  }
   const candidates = [
     sp2__default.join(MUMEI_DIR, "specs", slug, `${doc}.md`),
     sp2__default.join(MUMEI_DIR, "plans", slug, `${doc}.md`)
   ];
+  try {
+    const specsRoot = sp2__default.join(MUMEI_DIR, "specs");
+    for (const ent of await readdir(specsRoot, { withFileTypes: true })) {
+      if (ent.isDirectory() && ent.name.endsWith(`-${slug}`) && DOC_SLUG_RE.test(ent.name)) {
+        candidates.push(sp2__default.join(specsRoot, ent.name, `${doc}.md`));
+      }
+    }
+  } catch {
+  }
+  try {
+    const archiveRoot = sp2__default.join(MUMEI_DIR, "archive");
+    const months = (await readdir(archiveRoot, { withFileTypes: true })).sort(
+      (a, b) => b.name.localeCompare(a.name)
+    );
+    for (const m of months) {
+      if (!m.isDirectory()) continue;
+      const monthDir = sp2__default.join(archiveRoot, m.name);
+      candidates.push(sp2__default.join(monthDir, slug, `${doc}.md`));
+      try {
+        for (const sub of await readdir(monthDir, { withFileTypes: true })) {
+          if (sub.isDirectory() && sub.name.endsWith(`-${slug}`) && DOC_SLUG_RE.test(sub.name)) {
+            candidates.push(sp2__default.join(monthDir, sub.name, `${doc}.md`));
+          }
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
   for (const p of candidates) {
-    try {
-      const body = await readFile(p, "utf8");
+    const body = await readMarkdownIfInside(p, MUMEI_DIR);
+    if (body !== null) {
       reply.type("text/markdown");
       return body;
-    } catch {
     }
   }
   reply.code(404);
@@ -50321,6 +50365,15 @@ app.get("/api/feature/:slug/:doc", { schema: { params: DocParam } }, async (req,
 });
 app.setErrorHandler((err, req, reply) => {
   req.log.error({ err }, "request handler threw");
+  if (err instanceof StateValidationError) {
+    reply.code(500).send({
+      error: "state.json shape violation",
+      stage: err.stage,
+      file: err.file,
+      fieldErrors: err.fieldErrors
+    });
+    return;
+  }
   const fastifyErr = err;
   if (fastifyErr.validation) {
     reply.code(400).send({ error: "validation_failed", details: fastifyErr.validation });