lean-spec 0.2.9 → 0.2.15-dev.21022397862

package/templates/standard/AGENTS.md

@@ -12,132 +12,103 @@
 
 > **Why?** Skipping discovery creates duplicate work. Manual file creation breaks LeanSpec tooling.
 
-## 🔧 How to Manage Specs
-
-### Primary Method: MCP Tools (Recommended)
-
-If you have LeanSpec MCP tools available, **ALWAYS use them**:
-
-| Action | MCP Tool | Description |
-|--------|----------|-------------|
-| See project status | `board` | Kanban view + project health metrics |
-| List all specs | `list` | Filterable list with metadata |
-| Search specs | `search` | Semantic search across all content |
-| View a spec | `view` | Full content with formatting |
-| Create new spec | `create` | Auto-sequences, proper structure |
-| Update spec | `update` | Validates transitions, timestamps |
-| Link specs | `link` | Add dependencies (depends_on) |
-| Unlink specs | `unlink` | Remove dependencies |
-| Check dependencies | `deps` | Visual dependency graph |
-
-**Why MCP over CLI?**
-- ✅ Direct tool integration (no shell execution needed)
-- ✅ Structured responses (better for AI reasoning)
-- ✅ Real-time validation (immediate feedback)
-- ✅ Context-aware (understands project state)
-
-### Fallback: CLI Commands
-
-If MCP tools are not available, use CLI commands:
-
-```bash
-lean-spec board              # Project overview
-lean-spec list               # See all specs
-lean-spec search "query"     # Find relevant specs
-lean-spec create <name>      # Create new spec
-lean-spec update <spec> --status <status>  # Update status
-lean-spec link <spec> --depends-on <other>   # Add dependencies
-lean-spec unlink <spec> --depends-on <other> # Remove dependencies
-lean-spec deps <spec>        # Show dependencies
-```
-
-**Tip:** Check if you have LeanSpec MCP tools available before using CLI.
-
-## ⚠️ SDD Workflow Checkpoints
-
-### Before Starting ANY Task
-
-1. 📋 **Run `board`** - What's the current project state?
-2. 🔍 **Run `search`** - Are there related specs already?
-3. 📝 **Check existing specs** - Is there one for this work?
-
-### During Implementation
-
-4. 📊 **Update status to `in-progress`** BEFORE coding
-5. 📝 **Document decisions** in the spec as you work
-6. 🔗 **Link dependencies** if you discover blocking relationships
-
-### After Completing Work
-
-7. ✅ **Update status to `complete`** when done
-8. 📄 **Document what you learned** in the spec
-9. 🤔 **Create follow-up specs** if needed
-
-### 🚫 Common Mistakes to Avoid
+## 🔧 Managing Specs
+
+### MCP Tools (Preferred) with CLI Fallback
+
+| Action | MCP Tool | CLI Fallback |
+|--------|----------|--------------|
+| Project status | `board` | `lean-spec board` |
+| List specs | `list` | `lean-spec list` |
+| Search specs | `search` | `lean-spec search "query"` |
+| View spec | `view` | `lean-spec view <spec>` |
+| Create spec | `create` | `lean-spec create <name>` |
+| Update spec | `update` | `lean-spec update <spec> --status <status>` |
+| Link specs | `link` | `lean-spec link <spec> --depends-on <other>` |
+| Unlink specs | `unlink` | `lean-spec unlink <spec> --depends-on <other>` |
+| Dependencies | `deps` | `lean-spec deps <spec>` |
+| Token count | `tokens` | `lean-spec tokens <spec>` |
+| Validate specs | `validate` | `lean-spec validate` |
+
+## ⚠️ Core Rules
+
+| Rule | Details |
+|------|---------|
+| **NEVER edit frontmatter manually** | Use `update`, `link`, `unlink` for: `status`, `priority`, `tags`, `assignee`, `transitions`, timestamps, `depends_on` |
+| **ALWAYS link spec references** | Content mentions another spec → `lean-spec link <spec> --depends-on <other>` |
+| **Track status transitions** | `planned` → `in-progress` (before coding) → `complete` (after done) |
+| **Keep specs current** | Document progress, decisions, and learnings as work happens. Obsolete specs mislead both humans and AI |
+| **No nested code blocks** | Use indentation instead |
+
+### 🚫 Common Mistakes
 
 | ❌ Don't | ✅ Do Instead |
 |----------|---------------|
 | Create spec files manually | Use `create` tool |
-| Skip discovery before new work | Run `board` and `search` first |
-| Leave status as "planned" after starting | Update to `in-progress` immediately |
-| Finish work without updating spec | Document decisions, update status |
+| Skip discovery | Run `board` and `search` first |
+| Leave status as "planned" | Update to `in-progress` before coding |
 | Edit frontmatter manually | Use `update` tool |
-| Forget about specs mid-conversation | Check spec status periodically |
-
-## Core Rules
-
-1. **Read README.md first** - Understand project context
-2. **Check specs/** - Review existing specs before starting
-3. **Use MCP tools** - Prefer MCP over CLI when available
-4. **Follow LeanSpec principles** - Clarity over documentation
-5. **Keep it minimal** - If it doesn't add clarity, cut it
-6. **NEVER manually edit frontmatter** - Use `update`, `link`, `unlink` tools
-7. **Track progress in specs** - Update status and document decisions
+| Complete spec without documentation | Document progress, prompts, learnings first |
 
-## When to Use Specs
+## 📋 SDD Workflow
 
-**Write a spec for:**
-- Features affecting multiple parts of the system
-- Breaking changes or significant refactors
-- Design decisions needing team alignment
+```
+BEFORE: board → search → check existing specs
+DURING: update status to in-progress → code → document decisions → link dependencies
+AFTER:  document completion → update status to complete
+```
 
-**Skip specs for:**
-- Bug fixes
-- Trivial changes
-- Self-explanatory refactors
+**Status tracks implementation, NOT spec writing.**
 
 ## Spec Dependencies
 
-### `depends_on` - Blocking Dependency
-Directional dependency - this spec cannot start until dependencies are complete.
-**Use when:** True blocking dependency, work order matters, one spec builds on another.
+Use `depends_on` to express blocking relationships between specs:
+- **`depends_on`** = True blocker, work order matters, directional (A depends on B)
 
+Link dependencies when one spec builds on another:
 ```bash
 lean-spec link <spec> --depends-on <other-spec>
 ```
 
-**Note:** Only use `depends_on` for actual blocking dependencies. Don't link specs just because they're "related" - link them when one truly blocks the other.
-
-## Quality Standards
+## When to Use Specs
 
-- **Status tracking is mandatory:**
-  - `planned` → after creation
-  - `in-progress` → BEFORE starting implementation
-  - `complete` → AFTER finishing implementation
-- Specs stay in sync with implementation
-- Never leave specs with stale status
+| ✅ Write spec | ❌ Skip spec |
+|---------------|--------------|
+| Multi-part features | Bug fixes |
+| Breaking changes | Trivial changes |
+| Design decisions | Self-explanatory refactors |
 
-## Spec Complexity Guidelines
+## Token Thresholds
 
 | Tokens | Status |
 |--------|--------|
 | <2,000 | ✅ Optimal |
 | 2,000-3,500 | ✅ Good |
 | 3,500-5,000 | ⚠️ Consider splitting |
-| >5,000 | 🔴 Should split |
+| >5,000 | 🔴 Must split |
+
+## Quality Validation
+
+Before completing work, validate spec quality:
+```bash
+lean-spec validate              # Check structure and quality
+lean-spec validate --check-deps # Verify dependency alignment
+```
+
+Validation checks:
+- Missing required sections
+- Excessive length (>400 lines)
+- Content/frontmatter dependency misalignment
+- Invalid frontmatter fields
+
+## First Principles (Priority Order)
 
-Use `tokens` tool to check spec size.
+1. **Context Economy** - <2,000 tokens optimal, >3,500 needs splitting
+2. **Signal-to-Noise** - Every word must inform a decision
+3. **Intent Over Implementation** - Capture why, let how emerge
+4. **Bridge the Gap** - Both human and AI must understand
+5. **Progressive Disclosure** - Add complexity only when pain is felt
 
 ---
 
-**Remember:** LeanSpec tracks what you're building. Keep specs in sync with your work!
+**Remember:** LeanSpec tracks what you're building. Keep specs in sync with your work!

package/dist/backfill-WYW47B42.js

@@ -1,5 +0,0 @@
-export { backfillCommand, backfillTimestamps } from './chunk-SZNMHOHN.js';
-import './chunk-K4VTB6BF.js';
-import './chunk-ENX5NYTE.js';
-//# sourceMappingURL=backfill-WYW47B42.js.map
-//# sourceMappingURL=backfill-WYW47B42.js.map

package/dist/backfill-WYW47B42.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"backfill-WYW47B42.js"}

package/dist/chunk-ENX5NYTE.js

@@ -1,297 +0,0 @@
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import matter from 'gray-matter';
-import yaml from 'js-yaml';
-import dayjs from 'dayjs';
-
-// src/frontmatter.ts
-function normalizeDateFields(data) {
-  const dateFields = ["created", "completed", "updated", "due"];
-  for (const field of dateFields) {
-    if (data[field] instanceof Date) {
-      data[field] = data[field].toISOString().split("T")[0];
-    }
-  }
-}
-function enrichWithTimestamps(data, previousData) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  if (!data.created_at) {
-    data.created_at = now;
-  }
-  if (previousData) {
-    data.updated_at = now;
-  }
-  if (data.status === "complete" && previousData?.status !== "complete" && !data.completed_at) {
-    data.completed_at = now;
-    if (!data.completed) {
-      data.completed = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    }
-  }
-  if (previousData && data.status !== previousData.status) {
-    if (!Array.isArray(data.transitions)) {
-      data.transitions = [];
-    }
-    data.transitions.push({
-      status: data.status,
-      at: now
-    });
-  }
-}
-function normalizeTagsField(data) {
-  if (data.tags && typeof data.tags === "string") {
-    try {
-      const parsed = JSON.parse(data.tags);
-      if (Array.isArray(parsed)) {
-        data.tags = parsed;
-      }
-    } catch {
-      data.tags = data.tags.split(",").map((t) => t.trim());
-    }
-  }
-}
-function validateCustomField(value, expectedType) {
-  switch (expectedType) {
-    case "string":
-      if (typeof value === "string") {
-        return { valid: true, coerced: value };
-      }
-      return { valid: true, coerced: String(value) };
-    case "number":
-      if (typeof value === "number") {
-        return { valid: true, coerced: value };
-      }
-      const num = Number(value);
-      if (!isNaN(num)) {
-        return { valid: true, coerced: num };
-      }
-      return { valid: false, error: `Cannot convert '${value}' to number` };
-    case "boolean":
-      if (typeof value === "boolean") {
-        return { valid: true, coerced: value };
-      }
-      if (value === "true" || value === "yes" || value === "1") {
-        return { valid: true, coerced: true };
-      }
-      if (value === "false" || value === "no" || value === "0") {
-        return { valid: true, coerced: false };
-      }
-      return { valid: false, error: `Cannot convert '${value}' to boolean` };
-    case "array":
-      if (Array.isArray(value)) {
-        return { valid: true, coerced: value };
-      }
-      return { valid: false, error: `Expected array but got ${typeof value}` };
-    default:
-      return { valid: false, error: `Unknown type: ${expectedType}` };
-  }
-}
-function validateCustomFields(frontmatter, config) {
-  if (!config?.frontmatter?.custom) {
-    return frontmatter;
-  }
-  const result = { ...frontmatter };
-  for (const [fieldName, expectedType] of Object.entries(config.frontmatter.custom)) {
-    if (fieldName in result) {
-      const validation = validateCustomField(result[fieldName], expectedType);
-      if (validation.valid) {
-        result[fieldName] = validation.coerced;
-      } else {
-        console.warn(`Warning: Invalid custom field '${fieldName}': ${validation.error}`);
-      }
-    }
-  }
-  return result;
-}
-async function parseFrontmatter(filePath, config) {
-  try {
-    const content = await fs.readFile(filePath, "utf-8");
-    const parsed = matter(content, {
-      engines: {
-        yaml: (str) => yaml.load(str, { schema: yaml.FAILSAFE_SCHEMA })
-      }
-    });
-    if (!parsed.data || Object.keys(parsed.data).length === 0) {
-      return parseFallbackFields(content);
-    }
-    if (!parsed.data.status) {
-      console.warn(`Warning: Missing required field 'status' in ${filePath}`);
-      return null;
-    }
-    if (!parsed.data.created) {
-      console.warn(`Warning: Missing required field 'created' in ${filePath}`);
-      return null;
-    }
-    const validStatuses = ["planned", "in-progress", "complete", "archived"];
-    if (!validStatuses.includes(parsed.data.status)) {
-      console.warn(`Warning: Invalid status '${parsed.data.status}' in ${filePath}. Valid values: ${validStatuses.join(", ")}`);
-    }
-    if (parsed.data.priority) {
-      const validPriorities = ["low", "medium", "high", "critical"];
-      if (!validPriorities.includes(parsed.data.priority)) {
-        console.warn(`Warning: Invalid priority '${parsed.data.priority}' in ${filePath}. Valid values: ${validPriorities.join(", ")}`);
-      }
-    }
-    normalizeTagsField(parsed.data);
-    const knownFields = [
-      "status",
-      "created",
-      "tags",
-      "priority",
-      "depends_on",
-      "updated",
-      "completed",
-      "assignee",
-      "reviewer",
-      "issue",
-      "pr",
-      "epic",
-      "breaking",
-      "due",
-      "created_at",
-      "updated_at",
-      "completed_at",
-      "transitions"
-    ];
-    const customFields = config?.frontmatter?.custom ? Object.keys(config.frontmatter.custom) : [];
-    const allKnownFields = [...knownFields, ...customFields];
-    const unknownFields = Object.keys(parsed.data).filter((k) => !allKnownFields.includes(k));
-    if (unknownFields.length > 0) {
-      console.warn(`Info: Unknown fields in ${filePath}: ${unknownFields.join(", ")}`);
-    }
-    const validatedData = validateCustomFields(parsed.data, config);
-    return validatedData;
-  } catch (error) {
-    console.error(`Error parsing frontmatter from ${filePath}:`, error);
-    return null;
-  }
-}
-function parseFallbackFields(content) {
-  const statusMatch = content.match(/\*\*Status\*\*:\s*(?:📅\s*)?(\w+(?:-\w+)?)/i);
-  const createdMatch = content.match(/\*\*Created\*\*:\s*(\d{4}-\d{2}-\d{2})/);
-  if (statusMatch && createdMatch) {
-    const status = statusMatch[1].toLowerCase().replace(/\s+/g, "-");
-    const created = createdMatch[1];
-    return {
-      status,
-      created
-    };
-  }
-  return null;
-}
-async function updateFrontmatter(filePath, updates) {
-  const content = await fs.readFile(filePath, "utf-8");
-  const parsed = matter(content, {
-    engines: {
-      yaml: (str) => yaml.load(str, { schema: yaml.FAILSAFE_SCHEMA })
-    }
-  });
-  const previousData = { ...parsed.data };
-  const newData = { ...parsed.data, ...updates };
-  normalizeDateFields(newData);
-  enrichWithTimestamps(newData, previousData);
-  if (updates.status === "complete" && !newData.completed) {
-    newData.completed = dayjs().format("YYYY-MM-DD");
-  }
-  if ("updated" in parsed.data) {
-    newData.updated = dayjs().format("YYYY-MM-DD");
-  }
-  let updatedContent = parsed.content;
-  updatedContent = updateVisualMetadata(updatedContent, newData);
-  const newContent = matter.stringify(updatedContent, newData);
-  await fs.writeFile(filePath, newContent, "utf-8");
-}
-function updateVisualMetadata(content, frontmatter) {
-  const statusEmoji = getStatusEmojiPlain(frontmatter.status);
-  const statusLabel = frontmatter.status.charAt(0).toUpperCase() + frontmatter.status.slice(1).replace("-", " ");
-  const created = dayjs(frontmatter.created).format("YYYY-MM-DD");
-  let metadataLine = `> **Status**: ${statusEmoji} ${statusLabel}`;
-  if (frontmatter.priority) {
-    const priorityLabel = frontmatter.priority.charAt(0).toUpperCase() + frontmatter.priority.slice(1);
-    metadataLine += ` \xB7 **Priority**: ${priorityLabel}`;
-  }
-  metadataLine += ` \xB7 **Created**: ${created}`;
-  if (frontmatter.tags && frontmatter.tags.length > 0) {
-    metadataLine += ` \xB7 **Tags**: ${frontmatter.tags.join(", ")}`;
-  }
-  let secondLine = "";
-  if (frontmatter.assignee || frontmatter.reviewer) {
-    const assignee = frontmatter.assignee || "TBD";
-    const reviewer = frontmatter.reviewer || "TBD";
-    secondLine = `
-> **Assignee**: ${assignee} \xB7 **Reviewer**: ${reviewer}`;
-  }
-  const metadataPattern = /^>\s+\*\*Status\*\*:.*(?:\n>\s+\*\*Assignee\*\*:.*)?/m;
-  if (metadataPattern.test(content)) {
-    return content.replace(metadataPattern, metadataLine + secondLine);
-  } else {
-    const titleMatch = content.match(/^#\s+.+$/m);
-    if (titleMatch) {
-      const insertPos = titleMatch.index + titleMatch[0].length;
-      return content.slice(0, insertPos) + "\n\n" + metadataLine + secondLine + "\n" + content.slice(insertPos);
-    }
-  }
-  return content;
-}
-function getStatusEmojiPlain(status) {
-  switch (status) {
-    case "planned":
-      return "\u{1F5D3}\uFE0F";
-    case "in-progress":
-      return "\u23F3";
-    case "complete":
-      return "\u2705";
-    case "archived":
-      return "\u{1F4E6}";
-    default:
-      return "\u{1F4C4}";
-  }
-}
-async function getSpecFile(specDir, defaultFile = "README.md") {
-  const specFile = path.join(specDir, defaultFile);
-  try {
-    await fs.access(specFile);
-    return specFile;
-  } catch {
-    return null;
-  }
-}
-function matchesFilter(frontmatter, filter) {
-  if (filter.status) {
-    const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
-    if (!statuses.includes(frontmatter.status)) {
-      return false;
-    }
-  }
-  if (filter.tags && filter.tags.length > 0) {
-    if (!frontmatter.tags || frontmatter.tags.length === 0) {
-      return false;
-    }
-    const hasAllTags = filter.tags.every((tag) => frontmatter.tags.includes(tag));
-    if (!hasAllTags) {
-      return false;
-    }
-  }
-  if (filter.priority) {
-    const priorities = Array.isArray(filter.priority) ? filter.priority : [filter.priority];
-    if (!frontmatter.priority || !priorities.includes(frontmatter.priority)) {
-      return false;
-    }
-  }
-  if (filter.assignee) {
-    if (frontmatter.assignee !== filter.assignee) {
-      return false;
-    }
-  }
-  if (filter.customFields) {
-    for (const [key, value] of Object.entries(filter.customFields)) {
-      if (frontmatter[key] !== value) {
-        return false;
-      }
-    }
-  }
-  return true;
-}
-
-export { enrichWithTimestamps, getSpecFile, matchesFilter, normalizeDateFields, normalizeTagsField, parseFrontmatter, updateFrontmatter, validateCustomField, validateCustomFields };
-//# sourceMappingURL=chunk-ENX5NYTE.js.map
-//# sourceMappingURL=chunk-ENX5NYTE.js.map

package/dist/chunk-ENX5NYTE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/frontmatter.ts"],"names":[],"mappings":";;;;;;;AAuDO,SAAS,oBAAoB,IAAA,EAAqC;AACvE,EAAA,MAAM,UAAA,GAAa,CAAC,SAAA,EAAW,WAAA,EAAa,WAAW,KAAK,CAAA;AAE5D,EAAA,KAAA,MAAW,SAAS,UAAA,EAAY;AAC9B,IAAA,IAAI,IAAA,CAAK,KAAK,CAAA,YAAa,IAAA,EAAM;AAC/B,MAAA,IAAA,CAAK,KAAK,CAAA,GAAK,IAAA,CAAK,KAAK,CAAA,CAAW,aAAY,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA;AAAA,IAChE;AAAA,EACF;AACF;AAMO,SAAS,oBAAA,CACd,MACA,YAAA,EACM;AACN,EAAA,MAAM,GAAA,GAAA,iBAAM,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAInC,EAAA,IAAI,CAAC,KAAK,UAAA,EAAY;AACpB,IAAA,IAAA,CAAK,UAAA,GAAa,GAAA;AAAA,EACpB;AAGA,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,IAAA,CAAK,UAAA,GAAa,GAAA;AAAA,EACpB;AAGA,EAAA,IACE,IAAA,CAAK,WAAW,UAAA,IAChB,YAAA,EAAc,WAAW,UAAA,IACzB,CAAC,KAAK,YAAA,EACN;AACA,IAAA,IAAA,CAAK,YAAA,GAAe,GAAA;AAEpB,IAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AACnB,MAAA,IAAA,CAAK,SAAA,GAAA,qBAAgB,IAAA,EAAK,EAAE,aAAY,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA;AAAA,IACxD;AAAA,EACF;AAGA,EAAA,IAAI,YAAA,IAAgB,IAAA,CAAK,MAAA,KAAW,YAAA,CAAa,MAAA,EAAQ;AACvD,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,WAAW,CAAA,EAAG;AACpC,MAAA,IAAA,CAAK,cAAc,EAAC;AAAA,IACtB;AACA,IAAC,IAAA,CAAK,YAAmC,IAAA,CAAK;AAAA,MAC5C,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,EAAA,EAAI;AAAA,KACL,CAAA;AAAA,EACH;AACF;AAMO,SAAS,mBAAmB,IAAA,EAAqC;AACtE,EAAA,IAAI,IAAA,CAAK,IAAA,IAAQ,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AAC9C,IAAA,IAAI;AAEF,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,IAAc,CAAA;AAC7C,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AACzB,QAAA,IAAA,CAAK,IAAA,GAAO,MAAA;AAAA,MACd;AAAA,IACF,CAAA,CAAA,MAAQ;AAEN,MAAA,IAAA,CAAK,IAAA,GAAQ,IAAA,CAAK,IAAA,CAAgB,KAAA,CAAM,GAAG,EAAE,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,IAAA,EAAM,CAAA;AAAA,IAChE;AAAA,EACF;AACF;AAKO,SAAS,mBAAA,CACd,OACA,YAAA,EACuD;AACvD,EAAA,QAAQ,YAAA;AAAc,IACpB,KAAK,QAAA;AACH,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AAEA,MAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,MAAA,CAAO,KAAK,CAAA,EAAE;AAAA,IAE/C,KAAK,QAAA;AACH,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AAEA,MAAA,MAAM,GAAA,GAAM,OAAO,KAAK,CAAA;AACxB,MAAA,IAAI,CAAC,KAAA,CAAM,GAAG,CAAA,EAAG;AACf,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,GAAA,EAAI;AAAA,MACrC;AACA,MAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,CAAA,gBAAA,EAAmB,KAAK,CAAA,WAAA,CAAA,EAAc;AAAA,IAEtE,KAAK,SAAA;AACH,MAAA,IAAI,OAAO,UAAU,SAAA,EAAW;AAC9B,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AAEA,MAAA,IAAI,KAAA,KAAU,MAAA,IAAU,KAAA,KAAU,KAAA,IAAS,UAAU,GAAA,EAAK;AACxD,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,IAAA,EAAK;AAAA,MACtC;AACA,MAAA,IAAI,KAAA,KAAU,OAAA,IAAW,KAAA,KAAU,IAAA,IAAQ,UAAU,GAAA,EAAK;AACxD,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AACA,MAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,CAAA,gBAAA,EAAmB,KAAK,CAAA,YAAA,CAAA,EAAe;AAAA,IAEvE,KAAK,OAAA;AACH,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,QAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AACA,MAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,OAAO,CAAA,uBAAA,EAA0B,OAAO,KAAK,CAAA,CAAA,EAAG;AAAA,IAEzE;AACE,MAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,CAAA,cAAA,EAAiB,YAAY,CAAA,CAAA,EAAG;AAAA;AAEpE;AAKO,SAAS,oBAAA,CACd,aACA,MAAA,EACyB;AACzB,EAAA,IAAI,CAAC,MAAA,EAAQ,WAAA,EAAa,MAAA,EAAQ;AAChC,IAAA,OAAO,WAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,WAAA,EAAY;AAEhC,EAAA,KAAA,MAAW,CAAC,WAAW,YAAY,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,WAAA,CAAY,MAAM,CAAA,EAAG;AACjF,IAAA,IAAI,aAAa,MAAA,EAAQ;AACvB,MAAA,MAAM,UAAA,GAAa,mBAAA,CAAoB,MAAA,CAAO,SAAS,GAAG,YAAY,CAAA;AACtE,MAAA,IAAI,WAAW,KAAA,EAAO;AACpB,QAAA,MAAA,CAAO,SAAS,IAAI,UAAA,CAAW,OAAA;AAAA,MACjC,CAAA,MAAO;AACL,QAAA,OAAA,CAAQ,KAAK,CAAA,+BAAA,EAAkC,SAAS,CAAA,GAAA,EAAM,UAAA,CAAW,KAAK,CAAA,CAAE,CAAA;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,gBAAA,CACpB,UACA,MAAA,EACiC;AACjC,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAS,EAAA,CAAA,QAAA,CAAS,QAAA,EAAU,OAAO,CAAA;AACnD,IAAA,MAAM,MAAA,GAAS,OAAO,OAAA,EAAS;AAAA,MAC7B,OAAA,EAAS;AAAA,QACP,IAAA,EAAM,CAAC,GAAA,KAAQ,IAAA,CAAK,IAAA,CAAK,KAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,eAAA,EAAiB;AAAA;AAChE,KACD,CAAA;AAED,IAAA,IAAI,CAAC,OAAO,IAAA,IAAQ,MAAA,CAAO,KAAK,MAAA,CAAO,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,EAAG;AAEzD,MAAA,OAAO,oBAAoB,OAAO,CAAA;AAAA,IACpC;AAGA,IAAA,IAAI,CAAC,MAAA,CAAO,IAAA,CAAK,MAAA,EAAQ;AACvB,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,4CAAA,EAA+C,QAAQ,CAAA,CAAE,CAAA;AACtE,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,IAAI,CAAC,MAAA,CAAO,IAAA,CAAK,OAAA,EAAS;AACxB,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,6CAAA,EAAgD,QAAQ,CAAA,CAAE,CAAA;AACvE,MAAA,OAAO,IAAA;AAAA,IACT;AAGA,IAAA,MAAM,aAAA,GAA8B,CAAC,SAAA,EAAW,aAAA,EAAe,YAAY,UAAU,CAAA;AACrF,IAAA,IAAI,CAAC,aAAA,CAAc,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AAC/C,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,yBAAA,EAA4B,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,KAAA,EAAQ,QAAQ,CAAA,gBAAA,EAAmB,aAAA,CAAc,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,IAC1H;AAGA,IAAA,IAAI,MAAA,CAAO,KAAK,QAAA,EAAU;AACxB,MAAA,MAAM,eAAA,GAAkC,CAAC,KAAA,EAAO,QAAA,EAAU,QAAQ,UAAU,CAAA;AAC5E,MAAA,IAAI,CAAC,eAAA,CAAgB,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,EAAG;AACnD,QAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,2BAAA,EAA8B,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,KAAA,EAAQ,QAAQ,CAAA,gBAAA,EAAmB,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,MAChI;AAAA,IACF;AAGA,IAAA,kBAAA,CAAmB,OAAO,IAAI,CAAA;AAG9B,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,QAAA;AAAA,MAAU,SAAA;AAAA,MAAW,MAAA;AAAA,MAAQ,UAAA;AAAA,MAAY,YAAA;AAAA,MACzC,SAAA;AAAA,MAAW,WAAA;AAAA,MAAa,UAAA;AAAA,MAAY,UAAA;AAAA,MAAY,OAAA;AAAA,MAAS,IAAA;AAAA,MAAM,MAAA;AAAA,MAAQ,UAAA;AAAA,MAAY,KAAA;AAAA,MACnF,YAAA;AAAA,MAAc,YAAA;AAAA,MAAc,cAAA;AAAA,MAAgB;AAAA,KAC9C;AAGA,IAAA,MAAM,YAAA,GAAe,MAAA,EAAQ,WAAA,EAAa,MAAA,GAAS,MAAA,CAAO,KAAK,MAAA,CAAO,WAAA,CAAY,MAAM,CAAA,GAAI,EAAC;AAC7F,IAAA,MAAM,cAAA,GAAiB,CAAC,GAAG,WAAA,EAAa,GAAG,YAAY,CAAA;AAEvD,IAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,MAAA,CAAO,CAAA,CAAA,KAAK,CAAC,cAAA,CAAe,QAAA,CAAS,CAAC,CAAC,CAAA;AACtF,IAAA,IAAI,aAAA,CAAc,SAAS,CAAA,EAAG;AAC5B,MAAA,OAAA,CAAQ,IAAA,CAAK,2BAA2B,QAAQ,CAAA,EAAA,EAAK,cAAc,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,IACjF;AAGA,IAAA,MAAM,aAAA,GAAgB,oBAAA,CAAqB,MAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAE9D,IAAA,OAAO,aAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,+BAAA,EAAkC,QAAQ,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAClE,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAGA,SAAS,oBAAoB,OAAA,EAAyC;AACpE,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,KAAA,CAAM,6CAA6C,CAAA;AAC/E,EAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,KAAA,CAAM,wCAAwC,CAAA;AAE3E,EAAA,IAAI,eAAe,YAAA,EAAc;AAC/B,IAAA,MAAM,MAAA,GAAS,YAAY,CAAC,CAAA,CAAE,aAAY,CAAE,OAAA,CAAQ,QAAQ,GAAG,CAAA;AAC/D,IAAA,MAAM,OAAA,GAAU,aAAa,CAAC,CAAA;AAE9B,IAAA,OAAO;AAAA,MACL,MAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAGA,eAAsB,iBAAA,CACpB,UACA,OAAA,EACe;AACf,EAAA,MAAM,OAAA,GAAU,MAAS,EAAA,CAAA,QAAA,CAAS,QAAA,EAAU,OAAO,CAAA;AACnD,EAAA,MAAM,MAAA,GAAS,OAAO,OAAA,EAAS;AAAA,IAC7B,OAAA,EAAS;AAAA,MACP,IAAA,EAAM,CAAC,GAAA,KAAQ,IAAA,CAAK,IAAA,CAAK,KAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,eAAA,EAAiB;AAAA;AAChE,GACD,CAAA;AAGD,EAAA,MAAM,YAAA,GAAe,EAAE,GAAG,MAAA,CAAO,IAAA,EAAK;AAGtC,EAAA,MAAM,UAAU,EAAE,GAAG,MAAA,CAAO,IAAA,EAAM,GAAG,OAAA,EAAQ;AAG7C,EAAA,mBAAA,CAAoB,OAAO,CAAA;AAG3B,EAAA,oBAAA,CAAqB,SAAS,YAAY,CAAA;AAG1C,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,UAAA,IAAc,CAAC,QAAQ,SAAA,EAAW;AACvD,IAAA,OAAA,CAAQ,SAAA,GAAY,KAAA,EAAM,CAAE,MAAA,CAAO,YAAY,CAAA;AAAA,EACjD;AAEA,EAAA,IAAI,SAAA,IAAa,OAAO,IAAA,EAAM;AAC5B,IAAA,OAAA,CAAQ,OAAA,GAAU,KAAA,EAAM,CAAE,MAAA,CAAO,YAAY,CAAA;AAAA,EAC/C;AAGA,EAAA,IAAI,iBAAiB,MAAA,CAAO,OAAA;AAC5B,EAAA,cAAA,GAAiB,oBAAA,CAAqB,gBAAgB,OAA0B,CAAA;AAGhF,EAAA,MAAM,UAAA,GAAa,MAAA,CAAO,SAAA,CAAU,cAAA,EAAgB,OAAO,CAAA;AAC3D,EAAA,MAAS,EAAA,CAAA,SAAA,CAAU,QAAA,EAAU,UAAA,EAAY,OAAO,CAAA;AAClD;AAGA,SAAS,oBAAA,CAAqB,SAAiB,WAAA,EAAsC;AACnF,EAAA,MAAM,WAAA,GAAc,mBAAA,CAAoB,WAAA,CAAY,MAAM,CAAA;AAC1D,EAAA,MAAM,WAAA,GAAc,WAAA,CAAY,MAAA,CAAO,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,EAAY,GAAI,WAAA,CAAY,OAAO,KAAA,CAAM,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAK,GAAG,CAAA;AAG7G,EAAA,MAAM,UAAU,KAAA,CAAM,WAAA,CAAY,OAAO,CAAA,CAAE,OAAO,YAAY,CAAA;AAG9D,EAAA,IAAI,YAAA,GAAe,CAAA,cAAA,EAAiB,WAAW,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA;AAE9D,EAAA,IAAI,YAAY,QAAA,EAAU;AACxB,IAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,EAAY,GAAI,WAAA,CAAY,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA;AACjG,IAAA,YAAA,IAAgB,uBAAoB,aAAa,CAAA,CAAA;AAAA,EACnD;AAEA,EAAA,YAAA,IAAgB,sBAAmB,OAAO,CAAA,CAAA;AAE1C,EAAA,IAAI,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA,EAAG;AACnD,IAAA,YAAA,IAAgB,CAAA,gBAAA,EAAgB,WAAA,CAAY,IAAA,CAAK,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,EAC7D;AAGA,EAAA,IAAI,UAAA,GAAa,EAAA;AACjB,EAAA,IAAI,WAAA,CAAY,QAAA,IAAY,WAAA,CAAY,QAAA,EAAU;AAChD,IAAA,MAAM,QAAA,GAAW,YAAY,QAAA,IAAY,KAAA;AACzC,IAAA,MAAM,QAAA,GAAW,YAAY,QAAA,IAAY,KAAA;AACzC,IAAA,UAAA,GAAa;AAAA,gBAAA,EAAqB,QAAQ,uBAAoB,QAAQ,CAAA,CAAA;AAAA,EACxE;AAGA,EAAA,MAAM,eAAA,GAAkB,uDAAA;AAExB,EAAA,IAAI,eAAA,CAAgB,IAAA,CAAK,OAAO,CAAA,EAAG;AAEjC,IAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,eAAA,EAAiB,YAAA,GAAe,UAAU,CAAA;AAAA,EACnE,CAAA,MAAO;AAEL,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,KAAA,CAAM,WAAW,CAAA;AAC5C,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,SAAA,GAAY,UAAA,CAAW,KAAA,GAAS,UAAA,CAAW,CAAC,CAAA,CAAE,MAAA;AACpD,MAAA,OAAO,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,GAAI,MAAA,GAAS,YAAA,GAAe,UAAA,GAAa,IAAA,GAAO,OAAA,CAAQ,KAAA,CAAM,SAAS,CAAA;AAAA,IAC1G;AAAA,EACF;AAEA,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,oBAAoB,MAAA,EAAwB;AACnD,EAAA,QAAQ,MAAA;AAAQ,IACd,KAAK,SAAA;AAAW,MAAA,OAAO,iBAAA;AAAA,IACvB,KAAK,aAAA;AAAe,MAAA,OAAO,QAAA;AAAA,IAC3B,KAAK,UAAA;AAAY,MAAA,OAAO,QAAA;AAAA,IACxB,KAAK,UAAA;AAAY,MAAA,OAAO,WAAA;AAAA,IACxB;AAAS,MAAA,OAAO,WAAA;AAAA;AAEpB;AAGA,eAAsB,WAAA,CAAY,OAAA,EAAiB,WAAA,GAAsB,WAAA,EAAqC;AAC5G,EAAA,MAAM,QAAA,GAAgB,IAAA,CAAA,IAAA,CAAK,OAAA,EAAS,WAAW,CAAA;AAE/C,EAAA,IAAI;AACF,IAAA,MAAS,UAAO,QAAQ,CAAA;AACxB,IAAA,OAAO,QAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAWO,SAAS,aAAA,CAAc,aAA8B,MAAA,EAAoC;AAE9F,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,MAAM,QAAA,GAAW,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,MAAA,CAAO,MAAA,GAAS,CAAC,MAAA,CAAO,MAAM,CAAA;AAC9E,IAAA,IAAI,CAAC,QAAA,CAAS,QAAA,CAAS,WAAA,CAAY,MAAM,CAAA,EAAG;AAC1C,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,MAAA,CAAO,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA,EAAG;AACzC,IAAA,IAAI,CAAC,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,CAAK,WAAW,CAAA,EAAG;AACtD,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,MAAM,UAAA,GAAa,OAAO,IAAA,CAAK,KAAA,CAAM,SAAO,WAAA,CAAY,IAAA,CAAM,QAAA,CAAS,GAAG,CAAC,CAAA;AAC3E,IAAA,IAAI,CAAC,UAAA,EAAY;AACf,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,MAAM,UAAA,GAAa,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,QAAQ,IAAI,MAAA,CAAO,QAAA,GAAW,CAAC,MAAA,CAAO,QAAQ,CAAA;AACtF,IAAA,IAAI,CAAC,YAAY,QAAA,IAAY,CAAC,WAAW,QAAA,CAAS,WAAA,CAAY,QAAQ,CAAA,EAAG;AACvE,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,IAAI,WAAA,CAAY,QAAA,KAAa,MAAA,CAAO,QAAA,EAAU;AAC5C,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,YAAA,EAAc;AACvB,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,YAAY,CAAA,EAAG;AAC9D,MAAA,IAAI,WAAA,CAAY,GAAG,CAAA,KAAM,KAAA,EAAO;AAC9B,QAAA,OAAO,KAAA;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT","file":"chunk-ENX5NYTE.js","sourcesContent":["import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport matter from 'gray-matter';\nimport yaml from 'js-yaml';\nimport dayjs from 'dayjs';\nimport type { LeanSpecConfig } from './config.js';\n\n// Valid status values\nexport type SpecStatus = 'planned' | 'in-progress' | 'complete' | 'archived';\n\n// Valid priority values\nexport type SpecPriority = 'low' | 'medium' | 'high' | 'critical';\n\n// Status transition record\nexport interface StatusTransition {\n  status: SpecStatus;\n  at: string; // ISO 8601 timestamp\n}\n\n// Core frontmatter fields\nexport interface SpecFrontmatter {\n  // Required fields\n  status: SpecStatus;\n  created: string; // YYYY-MM-DD format\n\n  // Recommended fields\n  tags?: string[];\n  priority?: SpecPriority;\n\n  // Power user fields\n  depends_on?: string[];\n  updated?: string;\n  completed?: string;\n  assignee?: string;\n  reviewer?: string;\n  issue?: string;\n  pr?: string;\n  epic?: string;\n  breaking?: boolean;\n  due?: string; // YYYY-MM-DD format\n\n  // Timestamp fields (for velocity tracking)\n  created_at?: string; // ISO 8601 timestamp\n  updated_at?: string; // ISO 8601 timestamp\n  completed_at?: string; // ISO 8601 timestamp\n  transitions?: StatusTransition[]; // Status change history\n\n  // Allow any additional fields (for extensibility)\n  [key: string]: unknown;\n}\n\n/**\n * Convert Date objects to YYYY-MM-DD string format\n * (gray-matter auto-parses YYYY-MM-DD strings as Date objects)\n */\nexport function normalizeDateFields(data: Record<string, unknown>): void {\n  const dateFields = ['created', 'completed', 'updated', 'due'];\n  \n  for (const field of dateFields) {\n    if (data[field] instanceof Date) {\n      data[field] = (data[field] as Date).toISOString().split('T')[0];\n    }\n  }\n}\n\n/**\n * Enrich frontmatter with timestamps for velocity tracking\n * Auto-generates timestamps when missing and tracks status transitions\n */\nexport function enrichWithTimestamps(\n  data: Record<string, unknown>,\n  previousData?: Record<string, unknown>\n): void {\n  const now = new Date().toISOString();\n\n  // Set created_at if missing - always use current timestamp\n  // Do NOT infer from created date field since that's just YYYY-MM-DD without time\n  if (!data.created_at) {\n    data.created_at = now;\n  }\n\n  // Update updated_at on any change (if previousData exists)\n  if (previousData) {\n    data.updated_at = now;\n  }\n\n  // Set completed_at when status changes to complete\n  if (\n    data.status === 'complete' &&\n    previousData?.status !== 'complete' &&\n    !data.completed_at\n  ) {\n    data.completed_at = now;\n    // Also set the completed date field\n    if (!data.completed) {\n      data.completed = new Date().toISOString().split('T')[0];\n    }\n  }\n\n  // Track status transition (optional)\n  if (previousData && data.status !== previousData.status) {\n    if (!Array.isArray(data.transitions)) {\n      data.transitions = [];\n    }\n    (data.transitions as StatusTransition[]).push({\n      status: data.status as SpecStatus,\n      at: now,\n    });\n  }\n}\n\n/**\n * Normalize tags field - parse JSON strings into arrays\n * Handles cases where AI accidentally creates tags as '[\"..\",\"..\"]' strings\n */\nexport function normalizeTagsField(data: Record<string, unknown>): void {\n  if (data.tags && typeof data.tags === 'string') {\n    try {\n      // Try to parse as JSON array\n      const parsed = JSON.parse(data.tags as string);\n      if (Array.isArray(parsed)) {\n        data.tags = parsed;\n      }\n    } catch {\n      // If not valid JSON, treat as comma-separated string\n      data.tags = (data.tags as string).split(',').map(t => t.trim());\n    }\n  }\n}\n\n/**\n * Validate and coerce custom field types\n */\nexport function validateCustomField(\n  value: unknown,\n  expectedType: 'string' | 'number' | 'boolean' | 'array'\n): { valid: boolean; coerced?: unknown; error?: string } {\n  switch (expectedType) {\n    case 'string':\n      if (typeof value === 'string') {\n        return { valid: true, coerced: value };\n      }\n      // Coerce to string\n      return { valid: true, coerced: String(value) };\n    \n    case 'number':\n      if (typeof value === 'number') {\n        return { valid: true, coerced: value };\n      }\n      // Try to coerce to number\n      const num = Number(value);\n      if (!isNaN(num)) {\n        return { valid: true, coerced: num };\n      }\n      return { valid: false, error: `Cannot convert '${value}' to number` };\n    \n    case 'boolean':\n      if (typeof value === 'boolean') {\n        return { valid: true, coerced: value };\n      }\n      // Coerce string to boolean\n      if (value === 'true' || value === 'yes' || value === '1') {\n        return { valid: true, coerced: true };\n      }\n      if (value === 'false' || value === 'no' || value === '0') {\n        return { valid: true, coerced: false };\n      }\n      return { valid: false, error: `Cannot convert '${value}' to boolean` };\n    \n    case 'array':\n      if (Array.isArray(value)) {\n        return { valid: true, coerced: value };\n      }\n      return { valid: false, error: `Expected array but got ${typeof value}` };\n    \n    default:\n      return { valid: false, error: `Unknown type: ${expectedType}` };\n  }\n}\n\n/**\n * Validate custom fields according to config\n */\nexport function validateCustomFields(\n  frontmatter: Record<string, unknown>,\n  config?: LeanSpecConfig\n): Record<string, unknown> {\n  if (!config?.frontmatter?.custom) {\n    return frontmatter;\n  }\n  \n  const result = { ...frontmatter };\n  \n  for (const [fieldName, expectedType] of Object.entries(config.frontmatter.custom)) {\n    if (fieldName in result) {\n      const validation = validateCustomField(result[fieldName], expectedType);\n      if (validation.valid) {\n        result[fieldName] = validation.coerced;\n      } else {\n        console.warn(`Warning: Invalid custom field '${fieldName}': ${validation.error}`);\n      }\n    }\n  }\n  \n  return result;\n}\n\n// Parse frontmatter from a spec file\nexport async function parseFrontmatter(\n  filePath: string,\n  config?: LeanSpecConfig\n): Promise<SpecFrontmatter | null> {\n  try {\n    const content = await fs.readFile(filePath, 'utf-8');\n    const parsed = matter(content, {\n      engines: {\n        yaml: (str) => yaml.load(str, { schema: yaml.FAILSAFE_SCHEMA }) as Record<string, unknown>\n      }\n    });\n\n    if (!parsed.data || Object.keys(parsed.data).length === 0) {\n      // No frontmatter found, try fallback to inline fields\n      return parseFallbackFields(content);\n    }\n\n    // Validate required fields\n    if (!parsed.data.status) {\n      console.warn(`Warning: Missing required field 'status' in ${filePath}`);\n      return null;\n    }\n\n    if (!parsed.data.created) {\n      console.warn(`Warning: Missing required field 'created' in ${filePath}`);\n      return null;\n    }\n\n    // Validate status enum\n    const validStatuses: SpecStatus[] = ['planned', 'in-progress', 'complete', 'archived'];\n    if (!validStatuses.includes(parsed.data.status)) {\n      console.warn(`Warning: Invalid status '${parsed.data.status}' in ${filePath}. Valid values: ${validStatuses.join(', ')}`);\n    }\n\n    // Validate priority enum if present\n    if (parsed.data.priority) {\n      const validPriorities: SpecPriority[] = ['low', 'medium', 'high', 'critical'];\n      if (!validPriorities.includes(parsed.data.priority)) {\n        console.warn(`Warning: Invalid priority '${parsed.data.priority}' in ${filePath}. Valid values: ${validPriorities.join(', ')}`);\n      }\n    }\n\n    // Normalize tags field (parse JSON strings to arrays)\n    normalizeTagsField(parsed.data);\n    \n    // Warn about unknown fields (informational only)\n    const knownFields = [\n      'status', 'created', 'tags', 'priority', 'depends_on',\n      'updated', 'completed', 'assignee', 'reviewer', 'issue', 'pr', 'epic', 'breaking', 'due',\n      'created_at', 'updated_at', 'completed_at', 'transitions'\n    ];\n    \n    // Add custom fields from config to known fields\n    const customFields = config?.frontmatter?.custom ? Object.keys(config.frontmatter.custom) : [];\n    const allKnownFields = [...knownFields, ...customFields];\n    \n    const unknownFields = Object.keys(parsed.data).filter(k => !allKnownFields.includes(k));\n    if (unknownFields.length > 0) {\n      console.warn(`Info: Unknown fields in ${filePath}: ${unknownFields.join(', ')}`);\n    }\n    \n    // Validate and coerce custom fields\n    const validatedData = validateCustomFields(parsed.data, config);\n\n    return validatedData as SpecFrontmatter;\n  } catch (error) {\n    console.error(`Error parsing frontmatter from ${filePath}:`, error);\n    return null;\n  }\n}\n\n// Fallback: Parse inline fields from older specs\nfunction parseFallbackFields(content: string): SpecFrontmatter | null {\n  const statusMatch = content.match(/\\*\\*Status\\*\\*:\\s*(?:📅\\s*)?(\\w+(?:-\\w+)?)/i);\n  const createdMatch = content.match(/\\*\\*Created\\*\\*:\\s*(\\d{4}-\\d{2}-\\d{2})/);\n\n  if (statusMatch && createdMatch) {\n    const status = statusMatch[1].toLowerCase().replace(/\\s+/g, '-') as SpecStatus;\n    const created = createdMatch[1];\n\n    return {\n      status,\n      created,\n    };\n  }\n\n  return null;\n}\n\n// Update frontmatter in a spec file\nexport async function updateFrontmatter(\n  filePath: string,\n  updates: Partial<SpecFrontmatter>\n): Promise<void> {\n  const content = await fs.readFile(filePath, 'utf-8');\n  const parsed = matter(content, {\n    engines: {\n      yaml: (str) => yaml.load(str, { schema: yaml.FAILSAFE_SCHEMA }) as Record<string, unknown>\n    }\n  });\n\n  // Store previous data for timestamp enrichment\n  const previousData = { ...parsed.data };\n\n  // Merge updates with existing data\n  const newData = { ...parsed.data, ...updates };\n\n  // Ensure date fields remain as strings (gray-matter auto-parses YYYY-MM-DD as Date objects)\n  normalizeDateFields(newData);\n\n  // Enrich with timestamps\n  enrichWithTimestamps(newData, previousData);\n\n  // Auto-update timestamps if fields exist (legacy behavior)\n  if (updates.status === 'complete' && !newData.completed) {\n    newData.completed = dayjs().format('YYYY-MM-DD');\n  }\n\n  if ('updated' in parsed.data) {\n    newData.updated = dayjs().format('YYYY-MM-DD');\n  }\n\n  // Update visual metadata badges in content\n  let updatedContent = parsed.content;\n  updatedContent = updateVisualMetadata(updatedContent, newData as SpecFrontmatter);\n\n  // Stringify back to file\n  const newContent = matter.stringify(updatedContent, newData);\n  await fs.writeFile(filePath, newContent, 'utf-8');\n}\n\n// Update visual metadata badges in content\nfunction updateVisualMetadata(content: string, frontmatter: SpecFrontmatter): string {\n  const statusEmoji = getStatusEmojiPlain(frontmatter.status);\n  const statusLabel = frontmatter.status.charAt(0).toUpperCase() + frontmatter.status.slice(1).replace('-', ' ');\n  \n  // Parse created date with dayjs - handles all formats consistently\n  const created = dayjs(frontmatter.created).format('YYYY-MM-DD');\n  \n  // Build metadata line\n  let metadataLine = `> **Status**: ${statusEmoji} ${statusLabel}`;\n  \n  if (frontmatter.priority) {\n    const priorityLabel = frontmatter.priority.charAt(0).toUpperCase() + frontmatter.priority.slice(1);\n    metadataLine += ` · **Priority**: ${priorityLabel}`;\n  }\n  \n  metadataLine += ` · **Created**: ${created}`;\n  \n  if (frontmatter.tags && frontmatter.tags.length > 0) {\n    metadataLine += ` · **Tags**: ${frontmatter.tags.join(', ')}`;\n  }\n  \n  // For enterprise template with assignee/reviewer\n  let secondLine = '';\n  if (frontmatter.assignee || frontmatter.reviewer) {\n    const assignee = frontmatter.assignee || 'TBD';\n    const reviewer = frontmatter.reviewer || 'TBD';\n    secondLine = `\\n> **Assignee**: ${assignee} · **Reviewer**: ${reviewer}`;\n  }\n  \n  // Replace existing metadata block or add after title\n  const metadataPattern = /^>\\s+\\*\\*Status\\*\\*:.*(?:\\n>\\s+\\*\\*Assignee\\*\\*:.*)?/m;\n  \n  if (metadataPattern.test(content)) {\n    // Replace existing metadata\n    return content.replace(metadataPattern, metadataLine + secondLine);\n  } else {\n    // Add after title (# title)\n    const titleMatch = content.match(/^#\\s+.+$/m);\n    if (titleMatch) {\n      const insertPos = titleMatch.index! + titleMatch[0].length;\n      return content.slice(0, insertPos) + '\\n\\n' + metadataLine + secondLine + '\\n' + content.slice(insertPos);\n    }\n  }\n  \n  return content;\n}\n\nfunction getStatusEmojiPlain(status: string): string {\n  switch (status) {\n    case 'planned': return '🗓️';\n    case 'in-progress': return '⏳';\n    case 'complete': return '✅';\n    case 'archived': return '📦';\n    default: return '📄';\n  }\n}\n\n// Get spec file path from spec directory\nexport async function getSpecFile(specDir: string, defaultFile: string = 'README.md'): Promise<string | null> {\n  const specFile = path.join(specDir, defaultFile);\n  \n  try {\n    await fs.access(specFile);\n    return specFile;\n  } catch {\n    return null;\n  }\n}\n\n// Filter specs by criteria\nexport interface SpecFilterOptions {\n  status?: SpecStatus | SpecStatus[];\n  tags?: string[];\n  priority?: SpecPriority | SpecPriority[];\n  assignee?: string;\n  customFields?: Record<string, unknown>;\n}\n\nexport function matchesFilter(frontmatter: SpecFrontmatter, filter: SpecFilterOptions): boolean {\n  // Status filter\n  if (filter.status) {\n    const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];\n    if (!statuses.includes(frontmatter.status)) {\n      return false;\n    }\n  }\n\n  // Tags filter (spec must have ALL specified tags)\n  if (filter.tags && filter.tags.length > 0) {\n    if (!frontmatter.tags || frontmatter.tags.length === 0) {\n      return false;\n    }\n    const hasAllTags = filter.tags.every(tag => frontmatter.tags!.includes(tag));\n    if (!hasAllTags) {\n      return false;\n    }\n  }\n\n  // Priority filter\n  if (filter.priority) {\n    const priorities = Array.isArray(filter.priority) ? filter.priority : [filter.priority];\n    if (!frontmatter.priority || !priorities.includes(frontmatter.priority)) {\n      return false;\n    }\n  }\n\n  // Assignee filter\n  if (filter.assignee) {\n    if (frontmatter.assignee !== filter.assignee) {\n      return false;\n    }\n  }\n  \n  // Custom fields filter\n  if (filter.customFields) {\n    for (const [key, value] of Object.entries(filter.customFields)) {\n      if (frontmatter[key] !== value) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n"]}