@pi-unipi/kanboard 2.6.1 → 2.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.6.1",
-  "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
+  "version": "2.9.0",
+  "description": "Visualization layer for unipi workflow \u2014 HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -39,19 +39,23 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.1"
+    "@pi-unipi/core": "2.9.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.80.0",
-    "@earendil-works/pi-tui": "^0.80.0"
+    "@earendil-works/pi-coding-agent": "^0.84.0",
+    "@earendil-works/pi-tui": "^0.84.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
     "typescript": "^6.0.0"
   },
   "pi": {
-    "extensions": [],
-    "skills": [],
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ],
     "prompts": [],
     "themes": []
   }

package/parser/checkbox-parser.ts

@@ -0,0 +1,165 @@
+/**
+ * @pi-unipi/kanboard — Config-driven checkbox document parser
+ *
+ * Replaces 7 separate parser classes (Spec, QuickWork, Debug, Fix, Chore, Review,
+ * and the checkbox-extraction half of Milestone) with one config-driven class.
+ * Each doc type is just: path regex + type label + command string + checkbox pattern.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { DocParser, ParsedDoc, ParsedItem, DocType } from "../types.js";
+import { parseFrontmatter } from "./frontmatter.js";
+
+/** Config for a checkbox-based document type. */
+interface CheckboxDocConfig {
+  /** Document type label */
+  type: DocType;
+  /** Path regex to match (e.g. /\/specs\//) */
+  pathRegex: RegExp;
+  /** Command string for parsed items */
+  command: string | ((fileName: string) => string);
+  /** Whether to also extract ## headers as items (default: false) */
+  extractHeaders?: boolean;
+  /** Status for header items (default: "todo") */
+  headerStatus?: "todo" | "done";
+  /** Extra metadata fields to include */
+  extraMetadata?: (metadata: Record<string, string>) => Record<string, string>;
+  /** Custom title extraction (default: metadata.title ?? fileName) */
+  titleExtractor?: (metadata: Record<string, string>, fileName: string) => string;
+}
+
+const CHECKBOX_PATTERN = /^\s*-\s*\[([ xX])\]\s*(.*)$/;
+const HEADER_PATTERN = /^##\s+(.+)$/;
+
+/** Config-driven parser for checkbox-style documents. */
+export class CheckboxParser implements DocParser {
+  constructor(private config: CheckboxDocConfig) {}
+
+  canParse(filePath: string): boolean {
+    return this.config.pathRegex.test(filePath) && filePath.endsWith(".md");
+  }
+
+  parse(filePath: string): ParsedDoc {
+    const warnings: string[] = [];
+    const items: ParsedItem[] = [];
+    let content: string;
+
+    try {
+      content = fs.readFileSync(filePath, "utf-8");
+    } catch (err: unknown) {
+      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
+      return this.emptyDoc(filePath, warnings);
+    }
+
+    const { metadata, bodyStart } = parseFrontmatter(content);
+    const lines = content.split("\n");
+    const fileName = path.basename(filePath);
+    const cmd = typeof this.config.command === "function"
+      ? this.config.command(fileName)
+      : this.config.command;
+
+    for (let i = bodyStart; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNum = i + 1;
+
+      // Match ## headers if configured
+      if (this.config.extractHeaders) {
+        const headerMatch = line.match(HEADER_PATTERN);
+        if (headerMatch) {
+          items.push({
+            text: headerMatch[1].trim(),
+            status: this.config.headerStatus ?? "todo",
+            lineNumber: lineNum,
+            sourceFile: fileName,
+            command: cmd,
+          });
+        }
+      }
+
+      // Match checklist items
+      const checkboxMatch = line.match(CHECKBOX_PATTERN);
+      if (checkboxMatch) {
+        const checked = checkboxMatch[1].toLowerCase() === "x";
+        const text = checkboxMatch[2].trim();
+        if (text) {
+          items.push({
+            text,
+            status: checked ? "done" : "todo",
+            lineNumber: lineNum,
+            sourceFile: fileName,
+            command: cmd,
+          });
+        }
+      }
+    }
+
+    const title = this.config.titleExtractor
+      ? this.config.titleExtractor(metadata, fileName)
+      : (metadata.title ?? fileName.replace(/\.md$/, ""));
+
+    const finalMetadata = this.config.extraMetadata
+      ? this.config.extraMetadata(metadata)
+      : metadata;
+
+    return {
+      type: this.config.type,
+      title,
+      filePath,
+      items,
+      metadata: finalMetadata,
+      warnings,
+    };
+  }
+
+  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
+    return {
+      type: this.config.type,
+      title: path.basename(filePath).replace(/\.md$/, ""),
+      filePath,
+      items: [],
+      metadata: {},
+      warnings,
+    };
+  }
+}
+
+/** All checkbox doc configs — drives the 6 simple parsers. */
+export const CHECKBOX_DOC_CONFIGS: CheckboxDocConfig[] = [
+  {
+    type: "spec",
+    pathRegex: /\/specs\//,
+    command: (f) => `/unipi:plan specs:${f}`,
+  },
+  {
+    type: "quick-work",
+    pathRegex: /\/quick-work\//,
+    command: "/unipi:quick-work",
+  },
+  {
+    type: "debug",
+    pathRegex: /\/debug\//,
+    command: (f) => `/unipi:fix debug:${f}`,
+    extractHeaders: true,
+    headerStatus: "todo",
+  },
+  {
+    type: "fix",
+    pathRegex: /\/fix\//,
+    command: "/unipi:fix",
+    extractHeaders: true,
+    headerStatus: "done",
+    extraMetadata: (m) => ({ ...m, related_debug: m.related_debug ?? m.debug ?? "" }),
+  },
+  {
+    type: "chore",
+    pathRegex: /\/chore\//,
+    command: (f) => `/unipi:chore-execute chore:${f}`,
+    titleExtractor: (m, f) => m.title ?? m.name ?? f.replace(/\.md$/, ""),
+  },
+  {
+    type: "review",
+    pathRegex: /\/reviews\//,
+    command: "/unipi:review-work",
+  },
+];

package/parser/frontmatter.ts

@@ -0,0 +1,26 @@
+/** Shared frontmatter parser for kanboard document parsers. */
+
+/** Parse frontmatter from markdown content.
+ * Returns metadata key-value pairs and the line number where the body starts. */
+export function parseFrontmatter(content: string): {
+  metadata: Record<string, string>;
+  bodyStart: number;
+} {
+  const metadata: Record<string, string> = {};
+  const lines = content.split("\n");
+
+  if (lines[0]?.trim() !== "---") return { metadata, bodyStart: 0 };
+
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === "---") {
+      return { metadata, bodyStart: i + 1 };
+    }
+    const match = line.match(/^(\w[\w-]*):\s*(.*)$/);
+    if (match) {
+      metadata[match[1]] = match[2].trim();
+    }
+  }
+
+  return { metadata, bodyStart: 0 };
+}

package/parser/index.ts

@@ -7,27 +7,7 @@
 
 import * as fs from "node:fs";
 import * as path from "node:path";
-import type { DocParser, ParsedDoc, DocType } from "../types.js";
-
-/** Path patterns for doc type detection */
-const PATH_PATTERNS: Array<{ pattern: RegExp; type: DocType }> = [
-  { pattern: /\/specs\//, type: "spec" },
-  { pattern: /\/plans\//, type: "plan" },
-  { pattern: /MILESTONES\.md$/i, type: "milestone" },
-  { pattern: /\/quick-work\//, type: "quick-work" },
-  { pattern: /\/debug\//, type: "debug" },
-  { pattern: /\/fix\//, type: "fix" },
-  { pattern: /\/chore\//, type: "chore" },
-  { pattern: /\/reviews\//, type: "review" },
-];
-
-/** Detect doc type from file path */
-export function detectDocType(filePath: string): DocType | null {
-  for (const { pattern, type } of PATH_PATTERNS) {
-    if (pattern.test(filePath)) return type;
-  }
-  return null;
-}
+import type { DocParser, ParsedDoc } from "../types.js";
 
 /** Parser registry — manages all document parsers */
 export class ParserRegistry {
@@ -92,30 +72,23 @@ export class ParserRegistry {
   }
 }
 
-/** Create a registry with all default parsers registered */
+/** Create a registry with all default parsers registered. */
 export async function createDefaultRegistry(): Promise<ParserRegistry> {
   const registry = new ParserRegistry();
 
-  // Import and register all parsers
-  const { SpecParser } = await import("./specs.js");
+  // Register checkbox-driven parsers (spec, quick-work, debug, fix, chore, review)
+  const { CheckboxParser, CHECKBOX_DOC_CONFIGS } = await import("./checkbox-parser.js");
+  for (const config of CHECKBOX_DOC_CONFIGS) {
+    registry.register(new CheckboxParser(config));
+  }
+
+  // Register plan parser (task-header + status-line format, not checkbox)
   const { PlanParser } = await import("./plans.js");
-  const { MilestoneParser } = await import("./milestones.js");
-  const {
-    QuickWorkParser,
-    DebugParser,
-    FixParser,
-    ChoreParser,
-    ReviewParser,
-  } = await import("./remaining.js");
-
-  registry.register(new SpecParser());
   registry.register(new PlanParser());
+
+  // Register milestone parser (inline frontmatter + phase headers)
+  const { MilestoneParser } = await import("./milestones.js");
   registry.register(new MilestoneParser());
-  registry.register(new QuickWorkParser());
-  registry.register(new DebugParser());
-  registry.register(new FixParser());
-  registry.register(new ChoreParser());
-  registry.register(new ReviewParser());
 
   return registry;
 }

package/parser/plans.ts

@@ -9,31 +9,9 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import type { DocParser, ParsedDoc, ParsedItem, ItemStatus } from "../types.js";
+import { parseFrontmatter } from "./frontmatter.js";
 
 /** Parse frontmatter from markdown file */
-function parseFrontmatter(content: string): {
-  metadata: Record<string, string>;
-  bodyStart: number;
-} {
-  const metadata: Record<string, string> = {};
-  const lines = content.split("\n");
-
-  if (lines[0]?.trim() !== "---") return { metadata, bodyStart: 0 };
-
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (line.trim() === "---") {
-      return { metadata, bodyStart: i + 1 };
-    }
-    const match = line.match(/^(\w[\w-]*):\s*(.*)$/);
-    if (match) {
-      metadata[match[1]] = match[2].trim();
-    }
-  }
-
-  return { metadata, bodyStart: 0 };
-}
-
 /** Status keyword to ItemStatus mapping */
 const STATUS_MAP: Record<string, ItemStatus> = {
   unstarted: "todo",

package/server/index.ts

@@ -78,12 +78,6 @@ export class KanboardServer {
 
   /** Start the server with port allocation */
   async start(): Promise<{ port: number; url: string }> {
-    // Check for existing instance
-    const existing = this.checkExistingInstance();
-    if (existing) {
-      // Removed console.log — existing instance detection is silent.
-    }
-
     this.server = http.createServer((req, res) => this.handleRequest(req, res));
 
     const port = await this.allocatePort();
@@ -267,12 +261,6 @@ export async function startServer(
   registerMilestoneRoutes(server, docsRoot);
   registerWorkflowRoutes(server, docsRoot);
 
-  server.route("POST", "/api/docs/:type/:file/items/:line", async (req, res) => {
-    // Placeholder — will be implemented with actual file updating
-    res.writeHead(200, { "Content-Type": "application/json" });
-    res.end(JSON.stringify({ ok: true }));
-  });
-
   const { port, url } = await server.start();
   return { server, port, url };
 }

package/parser/remaining.ts

@@ -1,386 +0,0 @@
-/**
- * @pi-unipi/kanboard — Remaining Parsers
- *
- * Parsers for quick-work, debug, fix, chore, and review document types.
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { DocParser, ParsedDoc, ParsedItem } from "../types.js";
-
-/** Parse frontmatter from markdown file */
-function parseFrontmatter(content: string): {
-  metadata: Record<string, string>;
-  bodyStart: number;
-} {
-  const metadata: Record<string, string> = {};
-  const lines = content.split("\n");
-
-  if (lines[0]?.trim() !== "---") return { metadata, bodyStart: 0 };
-
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (line.trim() === "---") {
-      return { metadata, bodyStart: i + 1 };
-    }
-    const match = line.match(/^(\w[\w-]*):\s*(.*)$/);
-    if (match) {
-      metadata[match[1]] = match[2].trim();
-    }
-  }
-
-  return { metadata, bodyStart: 0 };
-}
-
-/** Quick-work parser — extracts summary and checklist items */
-export class QuickWorkParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/quick-work\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    // Extract checklist items if present
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1;
-
-      const checkboxMatch = line.match(/^\s*-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[1].toLowerCase() === "x";
-        const text = checkboxMatch[2].trim();
-        if (text) {
-          items.push({
-            text,
-            status: checked ? "done" : "todo",
-            lineNumber: lineNum,
-            sourceFile: fileName,
-            command: `/unipi:quick-work`,
-          });
-        }
-      }
-    }
-
-    return {
-      type: "quick-work",
-      title: metadata.title ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata,
-      warnings,
-    };
-  }
-
-  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
-    return {
-      type: "quick-work",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}
-
-/** Debug parser — extracts bug description and status */
-export class DebugParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/debug\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    // Extract sections as items
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1;
-
-      // Match ## headers as items
-      const headerMatch = line.match(/^##\s+(.+)$/);
-      if (headerMatch) {
-        const text = headerMatch[1].trim();
-        items.push({
-          text,
-          status: "todo",
-          lineNumber: lineNum,
-          sourceFile: fileName,
-          command: `/unipi:fix debug:${fileName}`,
-        });
-      }
-
-      // Match checklist items
-      const checkboxMatch = line.match(/^\s*-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[1].toLowerCase() === "x";
-        const text = checkboxMatch[2].trim();
-        if (text) {
-          items.push({
-            text,
-            status: checked ? "done" : "todo",
-            lineNumber: lineNum,
-            sourceFile: fileName,
-            command: `/unipi:fix debug:${fileName}`,
-          });
-        }
-      }
-    }
-
-    return {
-      type: "debug",
-      title: metadata.title ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata,
-      warnings,
-    };
-  }
-
-  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
-    return {
-      type: "debug",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}
-
-/** Fix parser — extracts what was fixed */
-export class FixParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/fix\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    // Extract sections and checklist items
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1;
-
-      const headerMatch = line.match(/^##\s+(.+)$/);
-      if (headerMatch) {
-        items.push({
-          text: headerMatch[1].trim(),
-          status: "done",
-          lineNumber: lineNum,
-          sourceFile: fileName,
-          command: `/unipi:fix`,
-        });
-      }
-
-      const checkboxMatch = line.match(/^\s*-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[1].toLowerCase() === "x";
-        const text = checkboxMatch[2].trim();
-        if (text) {
-          items.push({
-            text,
-            status: checked ? "done" : "todo",
-            lineNumber: lineNum,
-            sourceFile: fileName,
-            command: `/unipi:fix`,
-          });
-        }
-      }
-    }
-
-    // Extract related debug reference
-    const related = metadata.related_debug ?? metadata.debug ?? "";
-
-    return {
-      type: "fix",
-      title: metadata.title ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata: { ...metadata, related_debug: related },
-      warnings,
-    };
-  }
-
-  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
-    return {
-      type: "fix",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}
-
-/** Chore parser — extracts chore name and steps */
-export class ChoreParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/chore\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    // Extract checklist items as steps
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1;
-
-      const checkboxMatch = line.match(/^\s*-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[1].toLowerCase() === "x";
-        const text = checkboxMatch[2].trim();
-        if (text) {
-          items.push({
-            text,
-            status: checked ? "done" : "todo",
-            lineNumber: lineNum,
-            sourceFile: fileName,
-            command: `/unipi:chore-execute chore:${fileName}`,
-          });
-        }
-      }
-    }
-
-    return {
-      type: "chore",
-      title: metadata.title ?? metadata.name ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata,
-      warnings,
-    };
-  }
-
-  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
-    return {
-      type: "chore",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}
-
-/** Review parser — extracts review remarks and status */
-export class ReviewParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/reviews\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    // Extract checklist items (remarks)
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1;
-
-      const checkboxMatch = line.match(/^\s*-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[1].toLowerCase() === "x";
-        const text = checkboxMatch[2].trim();
-        if (text) {
-          items.push({
-            text,
-            status: checked ? "done" : "todo",
-            lineNumber: lineNum,
-            sourceFile: fileName,
-            command: `/unipi:review-work`,
-          });
-        }
-      }
-    }
-
-    return {
-      type: "review",
-      title: metadata.title ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata,
-      warnings,
-    };
-  }
-
-  private emptyDoc(filePath: string, warnings: string[]): ParsedDoc {
-    return {
-      type: "review",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}

package/parser/specs.ts

@@ -1,105 +0,0 @@
-/**
- * @pi-unipi/kanboard — Spec Parser
- *
- * Parses brainstorm specs for `- [ ]` / `- [x]` checklist items.
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { DocParser, ParsedDoc, ParsedItem } from "../types.js";
-
-/** Parse frontmatter from markdown file */
-function parseFrontmatter(content: string): {
-  metadata: Record<string, string>;
-  bodyStart: number;
-} {
-  const metadata: Record<string, string> = {};
-  const lines = content.split("\n");
-
-  if (lines[0]?.trim() !== "---") return { metadata, bodyStart: 0 };
-
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (line.trim() === "---") {
-      return { metadata, bodyStart: i + 1 };
-    }
-    const match = line.match(/^(\w[\w-]*):\s*(.*)$/);
-    if (match) {
-      metadata[match[1]] = match[2].trim();
-    }
-  }
-
-  return { metadata, bodyStart: 0 };
-}
-
-/** Spec parser — extracts checklist items from brainstorm specs */
-export class SpecParser implements DocParser {
-  canParse(filePath: string): boolean {
-    return /\/specs\//.test(filePath) && filePath.endsWith(".md");
-  }
-
-  parse(filePath: string): ParsedDoc {
-    const warnings: string[] = [];
-    const items: ParsedItem[] = [];
-    let content: string;
-
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch (err: unknown) {
-      warnings.push(`Could not read file: ${err instanceof Error ? err.message : String(err)}`);
-      return this.emptyDoc(filePath, warnings);
-    }
-
-    const { metadata, bodyStart } = parseFrontmatter(content);
-    const lines = content.split("\n");
-    const fileName = path.basename(filePath);
-
-    for (let i = bodyStart; i < lines.length; i++) {
-      const line = lines[i];
-      const lineNum = i + 1; // 1-indexed
-
-      // Match `- [ ]` and `- [x]` patterns
-      const checkboxMatch = line.match(/^(\s*)-\s*\[([ xX])\]\s*(.*)$/);
-      if (checkboxMatch) {
-        const checked = checkboxMatch[2].toLowerCase() === "x";
-        const text = checkboxMatch[3].trim();
-
-        if (!text) {
-          warnings.push(`Line ${lineNum}: Empty checkbox text`);
-          continue;
-        }
-
-        items.push({
-          text,
-          status: checked ? "done" : "todo",
-          lineNumber: lineNum,
-          sourceFile: fileName,
-          command: `/unipi:plan specs:${fileName}`,
-        });
-      }
-    }
-
-    return {
-      type: "spec",
-      title: metadata.title ?? fileName.replace(/\.md$/, ""),
-      filePath,
-      items,
-      metadata,
-      warnings,
-    };
-  }
-
-  private emptyDoc(
-    filePath: string,
-    warnings: string[],
-  ): ParsedDoc {
-    return {
-      type: "spec",
-      title: path.basename(filePath).replace(/\.md$/, ""),
-      filePath,
-      items: [],
-      metadata: {},
-      warnings,
-    };
-  }
-}