lean-spec 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] - 2025-11-10
+
+### Changed
+
+**BREAKING: Command and directory naming migration**
+- **Command name**: `lspec` → `lean-spec` (full name for clarity and consistency)
+- **Config directory**: `.lspec/` → `.lean-spec/` (matches package and command name)
+- **Binary**: Only `lean-spec` command available (removed `lspec` alias)
+
+**Benefits:**
+- ✅ Consistency: Package name, command, and config directory all use `lean-spec`
+- ✅ Clarity: `npx lean-spec` works immediately (matches npm package name)
+- ✅ Simplicity: Single command to remember, no abbreviations
+
+**Migration Guide for Existing Users:**
+
+1. **Uninstall old version:**
+   ```bash
+   npm uninstall -g lean-spec
+   ```
+
+2. **Install new version:**
+   ```bash
+   npm install -g lean-spec
+   ```
+
+3. **Update existing projects:**
+   ```bash
+   # Rename config directory
+   mv .lspec .lean-spec
+   ```
+
+4. **Update commands:**
+   - Old: `lspec init` → New: `lean-spec init`
+   - Old: `lspec board` → New: `lean-spec board`
+   - Old: `npx lspec` → New: `npx lean-spec`
+
+**All documentation, examples, and specs updated to reflect new naming.**
+
 ## [0.1.1] - 2025-11-07
 
 ### Changed
@@ -88,5 +127,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Gray-matter for frontmatter parsing
 - Dayjs for date handling
 
+[0.1.2]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.2
 [0.1.1]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.1
 [0.1.0]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.0

package/README.md

@@ -31,7 +31,7 @@ Specs under 300 lines. Intent-focused. Machine-readable. Adapts to your workflow
 <p align="center">
   <a href="#quick-start-5-minutes"><strong>Quick Start (5 Minutes) →</strong></a> •
   <a href="https://www.lean-spec.dev"><strong>Documentation</strong></a> •
-  <a href="https://www.lean-spec.dev/docs/examples"><strong>Examples</strong></a>
+  <a href="https://www.lean-spec.dev/docs/guide/ai-executable-patterns"><strong>Examples</strong></a>
 </p>
 
 ---
@@ -98,7 +98,7 @@ priority: high
 # Unified Dashboard
 
 ## Overview
-Combine `lspec board` and `lspec stats` into a single, comprehensive
+Combine `lean-spec board` and `lean-spec stats` into a single, comprehensive
 project health view. Give users instant insight into project status,
 bottlenecks, and team velocity.
 
@@ -136,9 +136,10 @@ LeanSpec isn't arbitrary rules—it's derived from fundamental constraints of wo
 ### 🧠 Context Economy
 **Specs <300 lines → Fit in working memory**
 
-- **Physics**: AI context windows are bounded (~20K effective tokens)
-- **Biology**: Human working memory is limited (7±2 items)
+- **Physics**: AI performance degrades with longer context (quality drops beyond 50K tokens despite 200K limits)
+- **Biology**: Human working memory is limited (7±2 items, 5-10 min attention)
 - **Economics**: Large contexts cost more time and money
+- **Reality**: Attention is the scarce resource, not storage
 - **Result**: Keep specs under 300 lines, split complex features
 
 ### ✂️ Signal-to-Noise Maximization
@@ -177,7 +178,7 @@ LeanSpec isn't arbitrary rules—it's derived from fundamental constraints of wo
 
 **These aren't preferences—they're constraints.** Physics (context windows), biology (working memory), and economics (token costs) dictate what works.
 
-📖 [Deep dive: First Principles Guide →](https://www.lean-spec.dev/docs/guide/first-principles)
+📖 [Deep dive: First Principles Guide →](https://www.lean-spec.dev/docs/guide/understanding#the-five-first-principles)
 
 ---
 
@@ -199,7 +200,7 @@ MCP-native specs. Works with any tool that supports Model Context Protocol.
 Track progress without leaving the terminal:
 
 ```bash
-$ lspec board
+$ lean-spec board
 
 📋 Spec Kanban Board
 
@@ -219,7 +220,7 @@ $ lspec board
 ```
 
 ```bash
-$ lspec stats
+$ lean-spec stats
 
 📊 Project Stats
 
@@ -271,7 +272,7 @@ Custom fields fully supported. Adapts to your workflow as you grow.
 ```bash
 npm install -g lean-spec
 cd your-project
-lspec init
+lean-spec init
 ```
 
 ### 2. Work with Your AI Tool
@@ -281,7 +282,7 @@ lspec init
 ```
 👤 You: "Create a spec for user authentication with OAuth2."
 
-🤖 AI: [runs lspec create user-authentication]
+🤖 AI: [runs lean-spec create user-authentication]
       "I've created specs/001-user-authentication/README.md.
       Here's the spec..."
 
@@ -295,19 +296,19 @@ lspec init
 
 ```bash
 # Check project status
-lspec board
+lean-spec board
 
 # View spec with AI-friendly output
-lspec view user-authentication --json
+lean-spec view user-authentication --json
 
 # Update status as you progress
-lspec update user-authentication --status in-progress
+lean-spec update user-authentication --status in-progress
 ```
 
 **The workflow:**
-1. ✅ Ask AI to create spec (it uses `lspec create`)
+1. ✅ Ask AI to create spec (it uses `lean-spec create`)
 2. ✅ AI reads spec and implements (spec fits in context)
-3. ✅ Track with `lspec board` / `lspec stats`
+3. ✅ Track with `lean-spec board` / `lean-spec stats`
 4. ✅ Update status as work progresses
 
 **Why this works:**
@@ -317,9 +318,9 @@ lspec update user-authentication --status in-progress
 - You drive, AI executes
 
 **Next steps:**
-- 📘 [Full CLI Reference](https://www.lean-spec.dev/docs/cli-reference) - All commands
-- 🎨 [Choose a Template](https://www.lean-spec.dev/docs/templates) - Minimal, standard, or enterprise
-- 🤖 [AI Agent Setup](AGENTS.md) - Configure Cursor, Claude, Aider
+- 📘 [Full CLI Reference](https://www.lean-spec.dev/docs/reference/cli) - All commands
+- 🎨 [Choose a Template](https://www.lean-spec.dev/docs/guide/templates) - Minimal, standard, or enterprise
+- 🤖 [AI Agent Setup](AGENTS.md) - Configure AI coding tools
 
 ---
 
@@ -387,24 +388,24 @@ We dogfood our own methodology. Specs that fit in AI context enable the velocity
 ## Learn More
 
 ### 📚 Documentation
-- [Getting Started Guide](https://www.lean-spec.dev/docs/getting-started) - Complete setup walkthrough
-- [First Principles](https://www.lean-spec.dev/docs/guide/first-principles) - The philosophy behind LeanSpec
-- [CLI Reference](https://www.lean-spec.dev/docs/cli-reference) - All commands with examples
+- [Getting Started Guide](https://www.lean-spec.dev/docs/guide/getting-started) - Complete setup walkthrough
+- [First Principles](https://www.lean-spec.dev/docs/guide/understanding#the-five-first-principles) - The philosophy behind LeanSpec
+- [CLI Reference](https://www.lean-spec.dev/docs/reference/cli) - All commands with examples
 
 ### 🛠️ Integrations
 - [AI Agent Configuration](AGENTS.md) - Cursor, Copilot, Aider setup
 - [MCP Server](docs/MCP-SERVER.md) - Claude Desktop integration
-- [VS Code Extension](https://www.lean-spec.dev/docs/tools/vscode) - Enhanced editor support
+- [VS Code Extension](https://www.lean-spec.dev/docs/roadmap#vs-code-extension) - Enhanced editor support (planned)
 
 ### 🎓 Guides
 - [Custom Fields](https://www.lean-spec.dev/docs/guide/custom-fields) - Adapt to your workflow
-- [Sub-Specs](https://www.lean-spec.dev/docs/guide/sub-specs) - Manage complex features
-- [Folder Structure](https://www.lean-spec.dev/docs/guide/folder-structure) - Organize your specs
+- [Templates](https://www.lean-spec.dev/docs/guide/templates) - Choose the right structure
+- [Frontmatter](https://www.lean-spec.dev/docs/guide/frontmatter) - Metadata and organization
 
 ### 🤝 Community
 - [GitHub Issues](https://github.com/codervisor/lean-spec/issues) - Report bugs or request features
 - [Contributing Guide](CONTRIBUTING.md) - Join the project
-- [Examples](https://www.lean-spec.dev/docs/examples) - Real-world usage patterns
+- [AI-Executable Patterns](https://www.lean-spec.dev/docs/guide/ai-executable-patterns) - Real-world usage patterns
 
 ---
 

package/dist/{chunk-GLXYUS7F.js → chunk-OXTU3PN4.js}

@@ -39,7 +39,7 @@ var DEFAULT_CONFIG = {
   }
 };
 async function loadConfig(cwd = process.cwd()) {
-  const configPath = path.join(cwd, ".lspec", "config.json");
+  const configPath = path.join(cwd, ".lean-spec", "config.json");
   try {
     const content = await fs.readFile(configPath, "utf-8");
     const userConfig = JSON.parse(content);
@@ -51,7 +51,7 @@ async function loadConfig(cwd = process.cwd()) {
   }
 }
 async function saveConfig(config, cwd = process.cwd()) {
-  const configDir = path.join(cwd, ".lspec");
+  const configDir = path.join(cwd, ".lean-spec");
   const configPath = path.join(configDir, "config.json");
   await fs.mkdir(configDir, { recursive: true });
   await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
@@ -616,14 +616,14 @@ async function checkSpecs(options = {}) {
         console.log("");
       }
       console.log(chalk3.cyan("Tip: Use date prefix to prevent conflicts:"));
-      console.log(chalk3.gray('  Edit .lspec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
+      console.log(chalk3.gray('  Edit .lean-spec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
       console.log("");
       console.log(chalk3.cyan("Or rename folders manually to resolve."));
       console.log("");
     } else {
       console.log("");
       console.log(chalk3.yellow(`\u26A0\uFE0F  Conflict warning: ${conflicts.length} sequence conflict(s) detected`));
-      console.log(chalk3.gray("Run: lspec check"));
+      console.log(chalk3.gray("Run: lean-spec check"));
       console.log("");
     }
   }
@@ -677,7 +677,7 @@ async function createSpec(name, options = {}) {
     }
   }
   await fs5.mkdir(specDir, { recursive: true });
-  const templatesDir = path6.join(cwd, ".lspec", "templates");
+  const templatesDir = path6.join(cwd, ".lean-spec", "templates");
   let templateName;
   if (options.template) {
     if (config.templates?.[options.template]) {
@@ -1351,7 +1351,7 @@ import * as path11 from "path";
 import chalk9 from "chalk";
 async function listTemplates(cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   console.log("");
   console.log(chalk9.green("=== Project Templates ==="));
   console.log("");
@@ -1397,7 +1397,7 @@ async function showTemplate(templateName, cwd = process.cwd()) {
     console.error(chalk9.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
     process.exit(1);
   }
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   const templateFile = config.templates[templateName];
   const templatePath = path11.join(templatesDir, templateFile);
   try {
@@ -1415,7 +1415,7 @@ async function showTemplate(templateName, cwd = process.cwd()) {
 }
 async function addTemplate(name, file, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   const templatePath = path11.join(templatesDir, file);
   try {
     await fs8.access(templatePath);
@@ -1453,11 +1453,11 @@ async function removeTemplate(name, cwd = process.cwd()) {
   delete config.templates[name];
   await saveConfig(config, cwd);
   console.log(chalk9.green(`\u2713 Removed template: ${name}`));
-  console.log(chalk9.gray(`  Note: Template file ${file} still exists in .lspec/templates/`));
+  console.log(chalk9.gray(`  Note: Template file ${file} still exists in .lean-spec/templates/`));
 }
 async function copyTemplate(source, target, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   let sourceFile;
   if (config.templates?.[source]) {
     sourceFile = config.templates[source];
@@ -1523,7 +1523,56 @@ async function handleExistingFiles(action, existingFiles, templateDir, cwd, vari
     } catch {
       continue;
     }
-    if (action === "merge" && file === "AGENTS.md") {
+    if (action === "merge-ai" && file === "AGENTS.md") {
+      const existing = await fs9.readFile(filePath, "utf-8");
+      let template = await fs9.readFile(templateFilePath, "utf-8");
+      for (const [key, value] of Object.entries(variables)) {
+        template = template.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+      }
+      const promptPath = path12.join(cwd, ".lean-spec", "MERGE-AGENTS-PROMPT.md");
+      const aiPrompt = `# AI Prompt: Consolidate AGENTS.md
+
+## Task
+Consolidate the existing AGENTS.md with LeanSpec instructions into a single, coherent document.
+
+## Instructions
+1. Read both documents below
+2. Merge them intelligently:
+   - Preserve ALL existing project-specific information (workflows, SOPs, architecture, conventions)
+   - Integrate LeanSpec sections where they fit naturally
+   - Remove redundancy and ensure coherent flow
+   - Keep the tone and style consistent
+3. Replace the existing AGENTS.md with the consolidated version
+
+## Existing AGENTS.md
+\`\`\`markdown
+${existing}
+\`\`\`
+
+## LeanSpec Instructions to Integrate
+\`\`\`markdown
+${template}
+\`\`\`
+
+## Output
+Create a single consolidated AGENTS.md that:
+- Keeps all existing project context and workflows
+- Adds LeanSpec commands and principles where appropriate
+- Maintains clear structure and readability
+- Removes any duplicate or conflicting guidance
+`;
+      await fs9.mkdir(path12.dirname(promptPath), { recursive: true });
+      await fs9.writeFile(promptPath, aiPrompt, "utf-8");
+      console.log(chalk10.green(`\u2713 Created AI consolidation prompt`));
+      console.log(chalk10.cyan(`  \u2192 ${promptPath}`));
+      console.log("");
+      console.log(chalk10.yellow("\u{1F4DD} Next steps:"));
+      console.log(chalk10.gray("  1. Open .lean-spec/MERGE-AGENTS-PROMPT.md"));
+      console.log(chalk10.gray("  2. Send it to your AI coding assistant (GitHub Copilot, Cursor, etc.)"));
+      console.log(chalk10.gray("  3. Let AI create the consolidated AGENTS.md"));
+      console.log(chalk10.gray("  4. Review and commit the result"));
+      console.log("");
+    } else if (action === "merge-append" && file === "AGENTS.md") {
       const existing = await fs9.readFile(filePath, "utf-8");
       let template = await fs9.readFile(templateFilePath, "utf-8");
       for (const [key, value] of Object.entries(variables)) {
@@ -1537,8 +1586,9 @@ async function handleExistingFiles(action, existingFiles, templateDir, cwd, vari
 
 ${template.split("\n").slice(1).join("\n")}`;
       await fs9.writeFile(filePath, merged, "utf-8");
-      console.log(chalk10.green(`\u2713 Merged LeanSpec section into ${file}`));
-    } else if (action === "backup") {
+      console.log(chalk10.green(`\u2713 Appended LeanSpec section to ${file}`));
+      console.log(chalk10.yellow("  \u26A0 Note: May be verbose. Consider consolidating later."));
+    } else if (action === "overwrite") {
       const backupPath = `${filePath}.backup`;
       await fs9.rename(filePath, backupPath);
       console.log(chalk10.yellow(`\u2713 Backed up ${file} \u2192 ${file}.backup`));
@@ -1548,6 +1598,7 @@ ${template.split("\n").slice(1).join("\n")}`;
       }
       await fs9.writeFile(filePath, content, "utf-8");
       console.log(chalk10.green(`\u2713 Created new ${file}`));
+      console.log(chalk10.gray(`  \u{1F4A1} Your original content is preserved in ${file}.backup`));
     }
   }
 }
@@ -1594,9 +1645,9 @@ var TEMPLATES_DIR = path13.join(__dirname2, "..", "templates");
 async function initProject() {
   const cwd = process.cwd();
   try {
-    await fs10.access(path13.join(cwd, ".lspec", "config.json"));
-    console.log(chalk11.yellow("LeanSpec already initialized in this directory."));
-    console.log(chalk11.gray("To reinitialize, delete .lspec/ directory first."));
+    await fs10.access(path13.join(cwd, ".lean-spec", "config.json"));
+    console.log(chalk11.yellow("\u26A0 LeanSpec already initialized in this directory."));
+    console.log(chalk11.gray("To reinitialize, delete .lean-spec/ directory first."));
     return;
   } catch {
   }
@@ -1615,12 +1666,13 @@ async function initProject() {
         name: "Choose template",
         value: "template",
         description: "Pick from: minimal, standard, enterprise"
-      },
-      {
-        name: "Customize everything",
-        value: "custom",
-        description: "Full control over structure and settings"
       }
+      // TODO: Re-enable when custom setup mode is implemented
+      // {
+      //   name: 'Customize everything',
+      //   value: 'custom',
+      //   description: 'Full control over structure and settings',
+      // },
     ]
   });
   let templateName = "standard";
@@ -1637,8 +1689,6 @@ async function initProject() {
         }
       ]
     });
-  } else if (setupMode === "custom") {
-    console.log(chalk11.yellow("Full customization coming soon. Using standard for now."));
   }
   const templateDir = path13.join(TEMPLATES_DIR, templateName);
   const templateConfigPath = path13.join(templateDir, "config.json");
@@ -1650,31 +1700,34 @@ async function initProject() {
     console.error(chalk11.red(`Error: Template not found: ${templateName}`));
     process.exit(1);
   }
-  const patternChoice = await select({
-    message: "Select folder pattern:",
-    choices: [
-      {
-        name: "Simple: 001-my-spec/",
-        value: "simple",
-        description: "Global sequential numbering (recommended)"
-      },
-      {
-        name: "Date-grouped: 20251105/001-my-spec/",
-        value: "date-grouped",
-        description: "Group specs by creation date (good for teams)"
-      },
-      {
-        name: "Flat with date: 20251105-001-my-spec/",
-        value: "date-prefix",
-        description: "Date prefix with global numbering"
-      },
-      {
-        name: "Custom pattern",
-        value: "custom",
-        description: "Enter your own pattern"
-      }
-    ]
-  });
+  let patternChoice = "simple";
+  if (setupMode !== "quick") {
+    patternChoice = await select({
+      message: "Select folder pattern:",
+      choices: [
+        {
+          name: "Simple: 001-my-spec/",
+          value: "simple",
+          description: "Global sequential numbering (recommended)"
+        },
+        {
+          name: "Date-grouped: 20251105/001-my-spec/",
+          value: "date-grouped",
+          description: "Group specs by creation date (good for teams)"
+        },
+        {
+          name: "Flat with date: 20251105-001-my-spec/",
+          value: "date-prefix",
+          description: "Date prefix with global numbering"
+        },
+        {
+          name: "Custom pattern",
+          value: "custom",
+          description: "Enter your own pattern"
+        }
+      ]
+    });
+  }
   if (patternChoice === "simple") {
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
@@ -1688,13 +1741,13 @@ async function initProject() {
   } else if (patternChoice === "custom") {
     console.log("");
     console.log(chalk11.yellow("\u26A0 Custom pattern input is not yet implemented."));
-    console.log(chalk11.gray("  You can manually edit .lspec/config.json after initialization."));
+    console.log(chalk11.gray("  You can manually edit .lean-spec/config.json after initialization."));
     console.log(chalk11.gray("  Using simple pattern for now."));
     console.log("");
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
   }
-  const templatesDir = path13.join(cwd, ".lspec", "templates");
+  const templatesDir = path13.join(cwd, ".lean-spec", "templates");
   try {
     await fs10.mkdir(templatesDir, { recursive: true });
   } catch (error) {
@@ -1705,7 +1758,7 @@ async function initProject() {
   const targetSpecPath = path13.join(templatesDir, "spec-template.md");
   try {
     await fs10.copyFile(templateSpecPath, targetSpecPath);
-    console.log(chalk11.green("\u2713 Created .lspec/templates/spec-template.md"));
+    console.log(chalk11.green("\u2713 Created .lean-spec/templates/spec-template.md"));
   } catch (error) {
     console.error(chalk11.red("Error copying template:"), error);
     process.exit(1);
@@ -1715,29 +1768,34 @@ async function initProject() {
     default: "spec-template.md"
   };
   await saveConfig(templateConfig, cwd);
-  console.log(chalk11.green("\u2713 Created .lspec/config.json"));
+  console.log(chalk11.green("\u2713 Created .lean-spec/config.json"));
   const existingFiles = await detectExistingSystemPrompts(cwd);
   let skipFiles = [];
   if (existingFiles.length > 0) {
     console.log("");
     console.log(chalk11.yellow(`Found existing: ${existingFiles.join(", ")}`));
     const action = await select({
-      message: "How would you like to proceed?",
+      message: "How would you like to handle existing AGENTS.md?",
       choices: [
         {
-          name: "Merge - Add LeanSpec section to existing files",
-          value: "merge",
-          description: "Appends LeanSpec guidance to your existing AGENTS.md"
+          name: "AI-Assisted Merge (recommended)",
+          value: "merge-ai",
+          description: "Creates prompt for AI to intelligently consolidate both files"
         },
         {
-          name: "Backup - Save existing and create new",
-          value: "backup",
-          description: "Renames existing files to .backup and creates fresh ones"
+          name: "Simple Append",
+          value: "merge-append",
+          description: "Quickly appends LeanSpec section (may be verbose)"
         },
         {
-          name: "Skip - Keep existing files as-is",
+          name: "Replace with LeanSpec",
+          value: "overwrite",
+          description: "Backs up existing, creates fresh AGENTS.md from template"
+        },
+        {
+          name: "Keep Existing Only",
           value: "skip",
-          description: "Only adds .lspec config and specs/ directory"
+          description: "Skips AGENTS.md, only adds .lean-spec config and specs/"
         }
       ]
     });
@@ -3035,7 +3093,7 @@ function renderColumn(title, emoji, specs, expanded, colorFn) {
     }
     console.log("");
   } else if (!expanded && specs.length > 0) {
-    console.log(`  ${chalk15.dim("(collapsed, use --show-complete to expand)")}`);
+    console.log(`  ${chalk15.dim("(collapsed, use --complete to expand)")}`);
     console.log("");
   } else {
     console.log(`  ${chalk15.dim("(empty)")}`);
@@ -3701,26 +3759,28 @@ async function depsCommand(specPath, options) {
   console.log("");
   console.log(chalk18.green(`\u{1F4E6} Dependencies for ${chalk18.cyan(sanitizeUserInput(spec.path))}`));
   console.log("");
-  console.log(chalk18.bold("Depends On:"));
+  const hasAnyRelationships = dependsOn.length > 0 || blocks.length > 0 || relatedSpecs.length > 0;
+  if (!hasAnyRelationships) {
+    console.log(chalk18.gray("  No dependencies or relationships"));
+    console.log("");
+    return;
+  }
   if (dependsOn.length > 0) {
+    console.log(chalk18.bold("Depends On:"));
     for (const dep of dependsOn) {
       const status = getStatusIndicator(dep.frontmatter.status);
       console.log(`  \u2192 ${sanitizeUserInput(dep.path)} ${status}`);
     }
-  } else {
-    console.log(chalk18.gray("  (none)"));
+    console.log("");
   }
-  console.log("");
-  console.log(chalk18.bold("Blocks:"));
   if (blocks.length > 0) {
+    console.log(chalk18.bold("Required By:"));
     for (const blocked of blocks) {
       const status = getStatusIndicator(blocked.frontmatter.status);
       console.log(`  \u2190 ${sanitizeUserInput(blocked.path)} ${status}`);
     }
-  } else {
-    console.log(chalk18.gray("  (none)"));
+    console.log("");
   }
-  console.log("");
   if (relatedSpecs.length > 0) {
     console.log(chalk18.bold("Related Specs:"));
     for (const rel of relatedSpecs) {
@@ -3744,8 +3804,8 @@ function findDependencies(spec, specMap) {
     if (dep) {
       deps.push(dep);
     } else {
-      for (const [path20, s] of specMap.entries()) {
-        if (path20.includes(depPath)) {
+      for (const [path19, s] of specMap.entries()) {
+        if (path19.includes(depPath)) {
           deps.push(s);
           break;
         }
@@ -3777,8 +3837,8 @@ function findRelated(spec, specMap) {
     if (rel) {
       related.push(rel);
     } else {
-      for (const [path20, s] of specMap.entries()) {
-        if (path20.includes(relPath)) {
+      for (const [path19, s] of specMap.entries()) {
+        if (path19.includes(relPath)) {
           related.push(s);
           break;
         }
@@ -4432,7 +4492,6 @@ async function mcpCommand() {
 }
 
 // src/mcp-server.ts
-import * as path19 from "path";
 function formatErrorMessage(prefix, error) {
   const errorMsg = error instanceof Error ? error.message : String(error);
   return `${prefix}: ${errorMsg}`;
@@ -4496,20 +4555,22 @@ async function searchSpecsData(query, options) {
   return results;
 }
 async function readSpecData(specPath) {
-  const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path19.join(cwd, config.specsDir);
-  const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
-  if (!resolvedPath) {
-    throw new Error(`Spec not found: ${specPath}`);
-  }
-  const specInfo = await getSpec(resolvedPath);
-  if (!specInfo) {
+  const specContent = await readSpecContent(specPath, cwd);
+  if (!specContent) {
     throw new Error(`Spec not found: ${specPath}`);
   }
   return {
-    spec: specToData(specInfo),
-    content: specInfo.content || ""
+    spec: {
+      name: specContent.name,
+      path: specContent.path,
+      status: specContent.frontmatter.status,
+      created: String(specContent.frontmatter.created),
+      priority: specContent.frontmatter.priority,
+      tags: specContent.frontmatter.tags,
+      assignee: specContent.frontmatter.assignee
+    },
+    content: specContent.content
   };
 }
 async function getStatsData() {
@@ -4665,7 +4726,7 @@ async function createMcpServer() {
       title: "View Spec",
       description: "Read the complete content of a specification. Use this to understand spec details, review design decisions, or check implementation status. Returns metadata and full content.",
       inputSchema: {
-        specPath: z.string().describe('The spec to view. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
+        specPath: z.string().describe('The spec to view. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), full folder name (e.g., "045-unified-dashboard"), or sub-spec file (e.g., "045/DESIGN.md" or "unified-dashboard/TESTING.md").'),
         raw: z.boolean().optional().describe("Output raw markdown instead of formatted"),
         json: z.boolean().optional().describe("Output as JSON instead of formatted")
       },
@@ -5365,4 +5426,4 @@ export {
   createMcpServer,
   mcpCommand
 };
-//# sourceMappingURL=chunk-GLXYUS7F.js.map
+//# sourceMappingURL=chunk-OXTU3PN4.js.map