lean-spec 0.2.8 → 0.2.9-dev.20251205030455

package/dist/backfill-446GBTBC.js

@@ -0,0 +1,5 @@
+export { backfillCommand, backfillTimestamps } from './chunk-H5MCUMBK.js';
+import './chunk-RF5PKL6L.js';
+import './chunk-VN5BUHTV.js';
+//# sourceMappingURL=backfill-446GBTBC.js.map
+//# sourceMappingURL=backfill-446GBTBC.js.map

package/dist/{backfill-QIQLXSUG.js.map → backfill-446GBTBC.js.map}

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

package/dist/{chunk-EBSQ7FUR.js → chunk-BJHJ6IUO.js}

@@ -1,7 +1,7 @@
-import { backfillTimestamps, resolveSpecPath, createSpecDirPattern, getGlobalNextSeq } from './chunk-A6JDTXPV.js';
-import { TokenCounter, validateSpecs, sanitizeUserInput, getStatusIndicator, SpecDependencyGraph, countTokens, advancedSearchSpecs, withSpinner, getStatusEmoji, getPriorityEmoji, STATUS_CONFIG, PRIORITY_CONFIG, getSearchSyntaxHelp, analyzeMarkdownStructure, extractLines, countLines, parseFrontmatterFromString, createUpdatedFrontmatter, removeLines } from './chunk-FUIUCGUV.js';
-import { loadConfig, getSpec, loadAllSpecs, resolvePrefix, extractGroup, loadSubFiles, saveConfig } from './chunk-LXOJW2FE.js';
-import { getSpecFile, updateFrontmatter, normalizeDateFields, parseFrontmatter } from './chunk-LVD7ZAVZ.js';
+import { backfillTimestamps, resolveSpecPath, createSpecDirPattern, getGlobalNextSeq } from './chunk-H5MCUMBK.js';
+import { TokenCounter, validateSpecs, sanitizeUserInput, getStatusIndicator, SpecDependencyGraph, countTokens, advancedSearchSpecs, withSpinner, getStatusEmoji, getPriorityEmoji, STATUS_CONFIG, PRIORITY_CONFIG, getSearchSyntaxHelp, analyzeMarkdownStructure, extractLines, countLines, parseFrontmatterFromString, createUpdatedFrontmatter, removeLines } from './chunk-CJMVV46H.js';
+import { loadConfig, getSpec, loadAllSpecs, resolvePrefix, extractGroup, loadSubFiles, saveConfig } from './chunk-RF5PKL6L.js';
+import { getSpecFile, updateFrontmatter, normalizeDateFields, parseFrontmatter } from './chunk-VN5BUHTV.js';
 import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { readFileSync, existsSync } from 'fs';
@@ -995,9 +995,9 @@ async function buildVariableContext(config, options = {}) {
   return context;
 }
 function linkCommand() {
-  return new Command("link").description("Add relationships between specs (depends_on, related)").argument("<spec>", "Spec to update").option("--depends-on <specs>", "Add dependencies (comma-separated spec numbers or names)").option("--related <specs>", "Add related specs (comma-separated spec numbers or names)").action(async (specPath, options) => {
-    if (!options.dependsOn && !options.related) {
-      console.error("Error: At least one relationship type required (--depends-on or --related)");
+  return new Command("link").description("Add dependencies between specs").argument("<spec>", "Spec to update").option("--depends-on <specs>", "Add dependencies (comma-separated spec numbers or names)").action(async (specPath, options) => {
+    if (!options.dependsOn) {
+      console.error("Error: --depends-on is required");
       process.exit(1);
     }
     await linkSpec(specPath, options);
@@ -1019,92 +1019,44 @@ async function linkSpec(specPath, options) {
   const allSpecs = await loadAllSpecs({ includeArchived: true });
   const specMap = new Map(allSpecs.map((s) => [s.path, s]));
   const dependsOnSpecs = options.dependsOn ? options.dependsOn.split(",").map((s) => s.trim()) : [];
-  const relatedSpecs = options.related ? options.related.split(",").map((s) => s.trim()) : [];
   const targetSpecName = path12.basename(resolvedPath);
-  const allRelationshipSpecs = [...dependsOnSpecs, ...relatedSpecs];
-  const resolvedRelationships = /* @__PURE__ */ new Map();
-  for (const relSpec of allRelationshipSpecs) {
-    if (relSpec === targetSpecName || relSpec === specPath) {
-      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(relSpec)}`);
+  const resolvedDependencies = /* @__PURE__ */ new Map();
+  for (const depSpec of dependsOnSpecs) {
+    if (depSpec === targetSpecName || depSpec === specPath) {
+      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(depSpec)}`);
     }
-    const relResolvedPath = await resolveSpecPath(relSpec, cwd, specsDir);
-    if (!relResolvedPath) {
-      throw new Error(`Spec not found: ${sanitizeUserInput(relSpec)}`);
+    const depResolvedPath = await resolveSpecPath(depSpec, cwd, specsDir);
+    if (!depResolvedPath) {
+      throw new Error(`Spec not found: ${sanitizeUserInput(depSpec)}`);
     }
-    if (relResolvedPath === resolvedPath) {
-      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(relSpec)}`);
+    if (depResolvedPath === resolvedPath) {
+      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(depSpec)}`);
     }
-    const relSpecName = path12.basename(relResolvedPath);
-    resolvedRelationships.set(relSpec, relSpecName);
+    const depSpecName = path12.basename(depResolvedPath);
+    resolvedDependencies.set(depSpec, depSpecName);
   }
-  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.js');
+  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-6ZBAGOEU.js');
   const currentFrontmatter = await parseFrontmatter2(specFile);
   const currentDependsOn = currentFrontmatter?.depends_on || [];
-  const currentRelated = currentFrontmatter?.related || [];
-  const updates = {};
-  if (dependsOnSpecs.length > 0) {
-    const newDependsOn = [...currentDependsOn];
-    let added = 0;
-    for (const spec of dependsOnSpecs) {
-      const resolvedName = resolvedRelationships.get(spec);
-      if (resolvedName && !newDependsOn.includes(resolvedName)) {
-        newDependsOn.push(resolvedName);
-        added++;
-      }
-    }
-    updates.depends_on = newDependsOn;
-    if (added === 0) {
-      console.log(chalk15.gray(`\u2139 Dependencies already exist, no changes made`));
-    }
-  }
-  if (relatedSpecs.length > 0) {
-    const newRelated = [...currentRelated];
-    let added = 0;
-    const bidirectionalUpdates = [];
-    for (const spec of relatedSpecs) {
-      const resolvedName = resolvedRelationships.get(spec);
-      if (resolvedName && !newRelated.includes(resolvedName)) {
-        newRelated.push(resolvedName);
-        added++;
-        bidirectionalUpdates.push(resolvedName);
-      }
-    }
-    updates.related = newRelated;
-    for (const relSpecName of bidirectionalUpdates) {
-      const relSpecPath = await resolveSpecPath(relSpecName, cwd, specsDir);
-      if (relSpecPath) {
-        const relSpecFile = await getSpecFile(relSpecPath, config.structure.defaultFile);
-        if (relSpecFile) {
-          const relFrontmatter = await parseFrontmatter2(relSpecFile);
-          const relCurrentRelated = relFrontmatter?.related || [];
-          if (!relCurrentRelated.includes(targetSpecName)) {
-            await updateFrontmatter(relSpecFile, {
-              related: [...relCurrentRelated, targetSpecName]
-            });
-            console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(relSpecName)} (bidirectional)`));
-          }
-        }
-      }
-    }
-    if (added === 0) {
-      console.log(chalk15.gray(`\u2139 Related specs already exist, no changes made`));
-    }
-  }
-  if (updates.depends_on && updates.depends_on.length > 0) {
-    const cycles = detectCycles(targetSpecName, updates.depends_on, specMap);
-    if (cycles.length > 0) {
-      console.log(chalk15.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
+  const newDependsOn = [...currentDependsOn];
+  let added = 0;
+  for (const spec of dependsOnSpecs) {
+    const resolvedName = resolvedDependencies.get(spec);
+    if (resolvedName && !newDependsOn.includes(resolvedName)) {
+      newDependsOn.push(resolvedName);
+      added++;
     }
   }
-  await updateFrontmatter(specFile, updates);
-  const updatedFields = [];
-  if (dependsOnSpecs.length > 0) {
-    updatedFields.push(`depends_on: ${dependsOnSpecs.join(", ")}`);
+  if (added === 0) {
+    console.log(chalk15.gray(`\u2139 Dependencies already exist, no changes made`));
+    return;
   }
-  if (relatedSpecs.length > 0) {
-    updatedFields.push(`related: ${relatedSpecs.join(", ")}`);
+  const cycles = detectCycles(targetSpecName, newDependsOn, specMap);
+  if (cycles.length > 0) {
+    console.log(chalk15.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
   }
-  console.log(chalk15.green(`\u2713 Added relationships: ${updatedFields.join(", ")}`));
+  await updateFrontmatter(specFile, { depends_on: newDependsOn });
+  console.log(chalk15.green(`\u2713 Added dependencies: ${dependsOnSpecs.join(", ")}`));
   console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(path12.relative(cwd, resolvedPath))}`));
 }
 function detectCycles(startSpec, dependsOn, specMap, visited = /* @__PURE__ */ new Set(), path25 = []) {
@@ -1131,7 +1083,7 @@ function detectCycles(startSpec, dependsOn, specMap, visited = /* @__PURE__ */ n
 
 // src/commands/create.ts
 function createCommand() {
-  return new Command("create").description("Create new spec in folder structure").argument("<name>", "Name of the spec").option("--title <title>", "Set custom title").option("--description <desc>", "Set initial description").option("--tags <tags>", "Set tags (comma-separated)").option("--priority <priority>", "Set priority (low, medium, high, critical)").option("--assignee <name>", "Set assignee").option("--template <template>", "Use a specific template").option("--field <name=value...>", "Set custom field (can specify multiple)").option("--no-prefix", "Skip date prefix even if configured").option("--depends-on <specs>", "Add dependencies (comma-separated spec numbers or names)").option("--related <specs>", "Add related specs (comma-separated spec numbers or names)").action(async (name, options) => {
+  return new Command("create").description("Create new spec in folder structure").argument("<name>", "Name of the spec").option("--title <title>", "Set custom title").option("--description <desc>", "Set initial description").option("--tags <tags>", "Set tags (comma-separated)").option("--priority <priority>", "Set priority (low, medium, high, critical)").option("--assignee <name>", "Set assignee").option("--template <template>", "Use a specific template").option("--field <name=value...>", "Set custom field (can specify multiple)").option("--no-prefix", "Skip date prefix even if configured").option("--depends-on <specs>", "Add dependencies (comma-separated spec numbers or names)").action(async (name, options) => {
     const customFields = parseCustomFieldOptions(options.field);
     const createOptions = {
       title: options.title,
@@ -1142,8 +1094,7 @@ function createCommand() {
       template: options.template,
       customFields: Object.keys(customFields).length > 0 ? customFields : void 0,
       noPrefix: options.prefix === false,
-      dependsOn: options.dependsOn ? options.dependsOn.split(",").map((s) => s.trim()) : void 0,
-      related: options.related ? options.related.split(",").map((s) => s.trim()) : void 0
+      dependsOn: options.dependsOn ? options.dependsOn.split(",").map((s) => s.trim()) : void 0
     };
     await createSpec(name, createOptions);
   });
@@ -1254,7 +1205,7 @@ async function createSpec(name, options = {}) {
       frontmatter: parsed.data
     };
     parsed.content = resolveVariables(parsed.content, contextWithFrontmatter);
-    const { enrichWithTimestamps } = await import('./frontmatter-R2DANL5X.js');
+    const { enrichWithTimestamps } = await import('./frontmatter-6ZBAGOEU.js');
     enrichWithTimestamps(parsed.data);
     content = matter.stringify(parsed.content, parsed.data);
     if (options.description) {
@@ -1295,13 +1246,11 @@ ${options.description}`
     console.log(chalk15.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
     console.log(chalk15.gray(`  Edit: ${sanitizeUserInput(specFile)}`));
   }
-  const hasRelationships = options.dependsOn && options.dependsOn.length > 0 || options.related && options.related.length > 0;
-  if (hasRelationships) {
+  if (options.dependsOn && options.dependsOn.length > 0) {
     const newSpecName = path12.basename(specDir);
     try {
       await linkSpec(newSpecName, {
-        dependsOn: options.dependsOn?.join(","),
-        related: options.related?.join(",")
+        dependsOn: options.dependsOn.join(",")
       });
     } catch (error) {
       console.log(chalk15.yellow(`\u26A0\uFE0F  Warning: Failed to add relationships: ${error.message}`));
@@ -1546,9 +1495,9 @@ function renderGroupedList(specs, groupExtractor) {
   }
 }
 function unlinkCommand() {
-  return new Command("unlink").description("Remove relationships between specs (depends_on, related)").argument("<spec>", "Spec to update").option("--depends-on [specs]", "Remove dependencies (comma-separated spec numbers or names, or use with --all)").option("--related [specs]", "Remove related specs (comma-separated spec numbers or names, or use with --all)").option("--all", "Remove all relationships of the specified type(s)").action(async (specPath, options) => {
-    if (!options.dependsOn && !options.related) {
-      console.error("Error: At least one relationship type required (--depends-on or --related)");
+  return new Command("unlink").description("Remove dependencies between specs").argument("<spec>", "Spec to update").option("--depends-on [specs]", "Remove dependencies (comma-separated spec numbers or names, or use with --all)").option("--all", "Remove all dependencies").action(async (specPath, options) => {
+    if (!options.dependsOn) {
+      console.error("Error: --depends-on is required");
       process.exit(1);
     }
     await unlinkSpec(specPath, options);
@@ -1567,97 +1516,35 @@ async function unlinkSpec(specPath, options) {
   if (!specFile) {
     throw new Error(`No spec file found in: ${sanitizeUserInput(specPath)}`);
   }
-  const targetSpecName = path12.basename(resolvedPath);
-  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.js');
+  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-6ZBAGOEU.js');
   const currentFrontmatter = await parseFrontmatter2(specFile);
   const currentDependsOn = currentFrontmatter?.depends_on || [];
-  const currentRelated = currentFrontmatter?.related || [];
-  const updates = {};
+  let newDependsOn;
   let removedCount = 0;
-  if (options.dependsOn !== void 0) {
-    if (options.all || options.dependsOn === true) {
-      updates.depends_on = [];
-      removedCount += currentDependsOn.length;
-    } else {
-      const toRemove = options.dependsOn.split(",").map((s) => s.trim());
-      const resolvedToRemove = /* @__PURE__ */ new Set();
-      for (const spec of toRemove) {
-        const resolvedSpecPath = await resolveSpecPath(spec, cwd, specsDir);
-        if (resolvedSpecPath) {
-          resolvedToRemove.add(path12.basename(resolvedSpecPath));
-        } else {
-          resolvedToRemove.add(spec);
-        }
-      }
-      const newDependsOn = currentDependsOn.filter((dep) => !resolvedToRemove.has(dep));
-      removedCount += currentDependsOn.length - newDependsOn.length;
-      updates.depends_on = newDependsOn;
-    }
-  }
-  if (options.related !== void 0) {
-    if (options.all || options.related === true) {
-      for (const relSpec of currentRelated) {
-        const relSpecPath = await resolveSpecPath(relSpec, cwd, specsDir);
-        if (relSpecPath) {
-          const relSpecFile = await getSpecFile(relSpecPath, config.structure.defaultFile);
-          if (relSpecFile) {
-            const relFrontmatter = await parseFrontmatter2(relSpecFile);
-            const relCurrentRelated = relFrontmatter?.related || [];
-            const relNewRelated = relCurrentRelated.filter((r) => r !== targetSpecName);
-            if (relNewRelated.length !== relCurrentRelated.length) {
-              await updateFrontmatter(relSpecFile, {
-                related: relNewRelated
-              });
-              console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(relSpec)} (bidirectional)`));
-            }
-          }
-        }
-      }
-      removedCount += currentRelated.length;
-      updates.related = [];
-    } else {
-      const toRemove = options.related.split(",").map((s) => s.trim());
-      const resolvedToRemove = /* @__PURE__ */ new Set();
-      for (const spec of toRemove) {
-        const resolvedSpecPath = await resolveSpecPath(spec, cwd, specsDir);
-        if (resolvedSpecPath) {
-          const specName = path12.basename(resolvedSpecPath);
-          resolvedToRemove.add(specName);
-          const relSpecFile = await getSpecFile(resolvedSpecPath, config.structure.defaultFile);
-          if (relSpecFile) {
-            const relFrontmatter = await parseFrontmatter2(relSpecFile);
-            const relCurrentRelated = relFrontmatter?.related || [];
-            const relNewRelated = relCurrentRelated.filter((r) => r !== targetSpecName);
-            if (relNewRelated.length !== relCurrentRelated.length) {
-              await updateFrontmatter(relSpecFile, {
-                related: relNewRelated
-              });
-              console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(specName)} (bidirectional)`));
-            }
-          }
-        } else {
-          resolvedToRemove.add(spec);
-        }
+  if (options.all || options.dependsOn === true) {
+    newDependsOn = [];
+    removedCount = currentDependsOn.length;
+  } else {
+    const toRemove = options.dependsOn.split(",").map((s) => s.trim());
+    const resolvedToRemove = /* @__PURE__ */ new Set();
+    for (const spec of toRemove) {
+      const resolvedSpecPath = await resolveSpecPath(spec, cwd, specsDir);
+      if (resolvedSpecPath) {
+        resolvedToRemove.add(path12.basename(resolvedSpecPath));
+      } else {
+        resolvedToRemove.add(spec);
       }
-      const newRelated = currentRelated.filter((rel) => !resolvedToRemove.has(rel));
-      removedCount += currentRelated.length - newRelated.length;
-      updates.related = newRelated;
     }
+    newDependsOn = currentDependsOn.filter((dep) => !resolvedToRemove.has(dep));
+    removedCount = currentDependsOn.length - newDependsOn.length;
   }
-  await updateFrontmatter(specFile, updates);
   if (removedCount === 0) {
-    console.log(chalk15.gray(`\u2139 No matching relationships found to remove`));
-  } else {
-    const updatedFields = [];
-    if (options.dependsOn !== void 0) {
-      updatedFields.push(`depends_on`);
-    }
-    if (options.related !== void 0) {
-      updatedFields.push(`related`);
-    }
-    console.log(chalk15.green(`\u2713 Removed relationships: ${updatedFields.join(", ")} (${removedCount} total)`));
-    console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(path12.relative(cwd, resolvedPath))}`));
+    console.log(chalk15.gray(`\u2139 No matching dependencies found to remove`));
+    return;
   }
+  await updateFrontmatter(specFile, { depends_on: newDependsOn });
+  console.log(chalk15.green(`\u2713 Removed ${removedCount} dependencies`));
+  console.log(chalk15.gray(`  Updated: ${sanitizeUserInput(path12.relative(cwd, resolvedPath))}`));
 }
 function templatesCommand() {
   const cmd = new Command("templates").description("Manage spec templates");
@@ -3490,7 +3377,7 @@ async function migrateAuto(inputPath, documents, format, config, options) {
   if ((options.backfill || options.auto) && !options.dryRun) {
     console.log("\x1B[36mRunning backfill...\x1B[0m");
     try {
-      const { backfillCommand: backfillCommand2 } = await import('./backfill-QIQLXSUG.js');
+      const { backfillCommand: backfillCommand2 } = await import('./backfill-446GBTBC.js');
       const cmd = backfillCommand2();
       await cmd.parseAsync(["node", "lean-spec", "--all", "--assignee"], { from: "user" });
       console.log("\x1B[32m\u2713\x1B[0m Backfill complete\n");
@@ -3501,7 +3388,7 @@ async function migrateAuto(inputPath, documents, format, config, options) {
   if (!options.skipValidation && !options.dryRun) {
     console.log("\x1B[36mValidating...\x1B[0m");
     try {
-      const { validateSpecs: validateSpecs2 } = await import('./validate-PT6GAS57.js');
+      const { validateSpecs: validateSpecs2 } = await import('./validate-DIWYTDEF.js');
       await validateSpecs2({});
       console.log("\x1B[32m\u2713\x1B[0m Validation complete\n");
     } catch {
@@ -3594,7 +3481,7 @@ async function outputManualInstructions(inputPath, documents, config, format) {
   console.log("\x1B[1mImportant Rules:\x1B[0m");
   console.log("- Preserve decision rationale and context");
   console.log("- Map status appropriately to LeanSpec states");
-  console.log("- Link related specs using `related` field (manual frontmatter edit)");
+  console.log("- Link dependencies using `lean-spec link --depends-on`");
   console.log("- Follow LeanSpec first principles: clarity over completeness");
   console.log("- Keep specs under 400 lines (split if needed)");
   console.log();
@@ -4719,7 +4606,7 @@ function depsCommand(specPath, options = {}) {
   if (typeof specPath === "string") {
     return showDeps(specPath, options);
   }
-  return new Command("deps").description("Show dependency graph for a spec. Related specs (\u27F7) are shown bidirectionally, depends_on (\u2192) are directional.").argument("<spec>", "Spec to show dependencies for").option("--depth <n>", "Show N levels deep (default: 3)", parseInt).option("--graph", "ASCII graph visualization").option("--json", "Output as JSON").option("--complete", "Show complete graph (default: all relationships)").option("--upstream", "Show only upstream dependencies").option("--downstream", "Show only downstream dependents").option("--impact", "Show impact radius (all affected specs)").action(async (target, opts) => {
+  return new Command("deps").description("Show dependency graph for a spec. Shows upstream dependencies (\u2192) and downstream dependents (\u2190).").argument("<spec>", "Spec to show dependencies for").option("--depth <n>", "Show N levels deep (default: 3)", parseInt).option("--graph", "ASCII graph visualization").option("--json", "Output as JSON").option("--complete", "Show complete graph (default: all relationships)").option("--upstream", "Show only upstream dependencies").option("--downstream", "Show only downstream dependents").option("--impact", "Show impact radius (all affected specs)").action(async (target, opts) => {
     await showDeps(target, opts);
   });
 }
@@ -4754,12 +4641,10 @@ async function showDeps(specPath, options = {}) {
   }
   let dependsOn = [];
   let requiredBy = [];
-  let related = [];
   if (mode === "complete") {
     const completeGraph = graph.getCompleteGraph(spec.path);
     dependsOn = completeGraph.dependsOn;
     requiredBy = completeGraph.requiredBy;
-    related = completeGraph.related;
   } else if (mode === "upstream") {
     dependsOn = graph.getUpstream(spec.path, options.depth || 3);
   } else if (mode === "downstream") {
@@ -4768,7 +4653,6 @@ async function showDeps(specPath, options = {}) {
     const impact = graph.getImpactRadius(spec.path, options.depth || 3);
     dependsOn = impact.upstream;
     requiredBy = impact.downstream;
-    related = impact.related;
   }
   if (options.json) {
     const data = {
@@ -4781,9 +4665,6 @@ async function showDeps(specPath, options = {}) {
     if (mode === "complete" || mode === "downstream" || mode === "impact") {
       data.requiredBy = requiredBy.map((s) => ({ path: s.path, status: s.frontmatter.status }));
     }
-    if (mode === "complete" || mode === "impact") {
-      data.related = related.map((s) => ({ path: s.path, status: s.frontmatter.status }));
-    }
     if (mode === "complete" && (options.graph || dependsOn.length > 0)) {
       data.chain = buildDependencyChain(spec, specMap, options.depth || 3);
     }
@@ -4793,9 +4674,9 @@ async function showDeps(specPath, options = {}) {
   console.log("");
   console.log(chalk15.green(`\u{1F4E6} Dependencies for ${chalk15.cyan(sanitizeUserInput(spec.path))}`));
   console.log("");
-  const hasAnyRelationships = dependsOn.length > 0 || requiredBy.length > 0 || related.length > 0;
-  if (!hasAnyRelationships) {
-    console.log(chalk15.gray("  No dependencies or relationships"));
+  const hasAnyDependencies = dependsOn.length > 0 || requiredBy.length > 0;
+  if (!hasAnyDependencies) {
+    console.log(chalk15.gray("  No dependencies"));
     console.log("");
     return;
   }
@@ -4817,14 +4698,6 @@ async function showDeps(specPath, options = {}) {
     }
     console.log("");
   }
-  if ((mode === "complete" || mode === "impact") && related.length > 0) {
-    console.log(chalk15.bold("Related Specs:"));
-    for (const rel of related) {
-      const status = getStatusIndicator(rel.frontmatter.status);
-      console.log(`  \u27F7 ${sanitizeUserInput(rel.path)} ${status}`);
-    }
-    console.log("");
-  }
   if (mode === "complete" && (options.graph || dependsOn.length > 0)) {
     console.log(chalk15.bold("Dependency Chain:"));
     const chain = buildDependencyChain(spec, specMap, options.depth || 3);
@@ -4832,10 +4705,10 @@ async function showDeps(specPath, options = {}) {
     console.log("");
   }
   if (mode === "impact") {
-    const total = dependsOn.length + requiredBy.length + related.length;
+    const total = dependsOn.length + requiredBy.length;
     console.log(chalk15.bold(`Impact Summary:`));
     console.log(`  Changing this spec affects ${chalk15.yellow(total)} specs total`);
-    console.log(`    Upstream: ${dependsOn.length} | Downstream: ${requiredBy.length} | Related: ${related.length}`);
+    console.log(`    Upstream: ${dependsOn.length} | Downstream: ${requiredBy.length}`);
     console.log("");
   }
 }
@@ -6663,8 +6536,7 @@ function createTool() {
         priority: z.enum(["low", "medium", "high", "critical"]).optional().describe('Priority level for the spec. Defaults to "medium" if not specified.'),
         assignee: z.string().optional().describe("Person responsible for this spec."),
         template: z.string().optional().describe('Template name to use (e.g., "minimal", "enterprise"). Uses default template if omitted.'),
-        dependsOn: z.array(z.string()).optional().describe('Specs this depends on (e.g., ["045-api-design", "046-database"]). Creates upstream dependencies.'),
-        related: z.array(z.string()).optional().describe('Related specs (e.g., ["047-frontend"]). Creates bidirectional relationships.')
+        dependsOn: z.array(z.string()).optional().describe('Specs this depends on (e.g., ["045-api-design", "046-database"]). Creates upstream dependencies.')
       },
       outputSchema: {
         success: z.boolean(),
@@ -6687,8 +6559,7 @@ function createTool() {
           priority: input.priority,
           assignee: input.assignee,
           template: input.template,
-          dependsOn: input.dependsOn,
-          related: input.related
+          dependsOn: input.dependsOn
         });
         const output = {
           success: true,
@@ -6726,7 +6597,7 @@ async function getDepsData(specPath, mode = "complete") {
   }
   const allSpecs = await loadAllSpecs({ includeArchived: true });
   const graph = new SpecDependencyGraph(allSpecs);
-  const spec = allSpecs.find((s) => s.path === resolvedPath);
+  const spec = allSpecs.find((s) => s.fullPath === resolvedPath || s.path === resolvedPath);
   if (!spec) {
     throw new Error(`Spec not found: ${specPath}`);
   }
@@ -6747,11 +6618,6 @@ async function getDepsData(specPath, mode = "complete") {
         path: s.path,
         status: s.frontmatter.status,
         priority: s.frontmatter.priority
-      })),
-      related: completeGraph.related.map((s) => ({
-        path: s.path,
-        status: s.frontmatter.status,
-        priority: s.frontmatter.priority
       }))
     };
   } else if (mode === "upstream") {
@@ -6800,12 +6666,7 @@ async function getDepsData(specPath, mode = "complete") {
         status: s.frontmatter.status,
         priority: s.frontmatter.priority
       })),
-      related: impact.related.map((s) => ({
-        path: s.path,
-        status: s.frontmatter.status,
-        priority: s.frontmatter.priority
-      })),
-      total: impact.upstream.length + impact.downstream.length + impact.related.length
+      total: impact.upstream.length + impact.downstream.length
     };
   }
   return getDepsData(specPath, "complete");
@@ -6815,7 +6676,7 @@ function depsTool() {
     "deps",
     {
       title: "Get Dependencies",
-      description: "Analyze complete spec dependency graph (upstream, downstream, bidirectional). Shows which specs this depends on (dependsOn), which depend on this spec (requiredBy), and related work (related). Use this to understand impact of changes and work order.",
+      description: "Analyze spec dependency graph (upstream and downstream). Shows which specs this depends on (dependsOn) and which depend on this spec (requiredBy). Use this to understand impact of changes and work order.",
       inputSchema: {
         specPath: z.string().describe('The spec to analyze. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
         mode: z.enum(["complete", "upstream", "downstream", "impact"]).optional().describe("View mode: complete (all relationships), upstream (dependencies only), downstream (dependents only), impact (full impact radius with summary). Defaults to complete.")
@@ -6897,11 +6758,10 @@ function linkTool() {
     "link",
     {
       title: "Link Specs",
-      description: "Add relationships between specs (depends_on for dependencies, related for bidirectional links). Use this after creating a spec to connect it to related specs, or to add relationships to existing specs.",
+      description: "Add dependency relationships between specs. Use this after creating a spec to connect it to specs it depends on, or to add dependencies to existing specs.",
       inputSchema: {
-        specPath: z.string().describe('The spec to add relationships to. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
-        dependsOn: z.string().optional().describe('Comma-separated specs this depends on (e.g., "045,046" or "api-design,database"). Creates upstream dependencies.'),
-        related: z.string().optional().describe('Comma-separated related specs (e.g., "047,frontend"). Creates bidirectional relationships - both specs will reference each other.')
+        specPath: z.string().describe('The spec to add dependencies to. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
+        dependsOn: z.string().describe('Comma-separated specs this depends on (e.g., "045,046" or "api-design,database"). Creates upstream dependencies.')
       },
       outputSchema: {
         success: z.boolean(),
@@ -6912,10 +6772,10 @@ function linkTool() {
     async (input, _extra) => {
       const originalLog = console.log;
       try {
-        if (!input.dependsOn && !input.related) {
+        if (!input.dependsOn) {
           const output2 = {
             success: false,
-            message: "At least one relationship type required (dependsOn or related)"
+            message: "dependsOn is required"
           };
           return {
             content: [{ type: "text", text: JSON.stringify(output2, null, 2) }],
@@ -6933,8 +6793,7 @@ function linkTool() {
           }
         };
         await linkSpec(input.specPath, {
-          dependsOn: input.dependsOn,
-          related: input.related
+          dependsOn: input.dependsOn
         });
         const output = {
           success: true,
@@ -7337,12 +7196,11 @@ function unlinkTool() {
     "unlink",
     {
       title: "Unlink Specs",
-      description: "Remove relationships between specs. Can remove specific relationships or all relationships of a type. Related links are removed bidirectionally (from both specs).",
+      description: "Remove dependency relationships between specs. Can remove specific dependencies or all dependencies.",
       inputSchema: {
-        specPath: z.string().describe('The spec to remove relationships from. 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 remove dependencies from. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
         dependsOn: z.string().optional().describe('Comma-separated dependencies to remove (e.g., "045,046"). Leave empty with removeAll=true to remove all dependencies.'),
-        related: z.string().optional().describe('Comma-separated related specs to remove (e.g., "047,frontend"). Removes bidirectionally. Leave empty with removeAll=true to remove all.'),
-        removeAll: z.boolean().optional().describe("When true, removes ALL relationships of the specified type(s). Use with dependsOn or related to clear all of that type.")
+        removeAll: z.boolean().optional().describe("When true, removes ALL dependencies. Use with dependsOn to clear all.")
       },
       outputSchema: {
         success: z.boolean(),
@@ -7354,10 +7212,10 @@ function unlinkTool() {
     async (input, _extra) => {
       const originalLog = console.log;
       try {
-        if (!input.dependsOn && !input.related && !input.removeAll) {
+        if (!input.dependsOn && !input.removeAll) {
           const output2 = {
             success: false,
-            message: "At least one relationship type required (dependsOn or related)"
+            message: "Either dependsOn or removeAll is required"
           };
           return {
             content: [{ type: "text", text: JSON.stringify(output2, null, 2) }],
@@ -7385,9 +7243,7 @@ function unlinkTool() {
         if (input.dependsOn !== void 0) {
           options.dependsOn = input.dependsOn || true;
         } else if (input.removeAll) {
-        }
-        if (input.related !== void 0) {
-          options.related = input.related || true;
+          options.dependsOn = true;
         }
         await unlinkSpec(input.specPath, options);
         const output = {
@@ -7493,7 +7349,7 @@ function validateTool() {
       inputSchema: {
         specs: z.array(z.string()).optional().describe("Specific specs to validate. If omitted, validates all specs in the project."),
         maxLines: z.number().optional().describe("Custom line limit for complexity checks (default: 400 lines)."),
-        checkDeps: z.boolean().optional().describe("Check for content/frontmatter dependency alignment. Detects when spec content references other specs but those references are not in frontmatter depends_on/related fields.")
+        checkDeps: z.boolean().optional().describe("Check for content/frontmatter dependency alignment. Detects when spec content references other specs but those references are not in frontmatter depends_on fields.")
       },
       outputSchema: {
         passed: z.boolean(),
@@ -7815,7 +7671,7 @@ function planProjectRoadmapPrompt() {
 3. **Identify Tasks**: List key tasks and work items for each phase
 4. **Map Dependencies**: Establish dependencies between tasks (what must be done first)
 5. **Create Specs**: Create specification documents for major work items using the \`create\` tool
-6. **Set Relationships**: Use \`link\` tool to establish \`depends_on\` and \`related\` relationships
+6. **Set Dependencies**: Use \`link\` tool to establish \`depends_on\` relationships between specs
 7. **Timeline Estimation**: Provide realistic timeline based on task complexity and project velocity
 8. **Risk Analysis**: Identify risks, unknowns, and mitigation strategies
 
@@ -7910,7 +7766,7 @@ For the work you're currently doing:
 For any specs you've worked on:
 1. Update status if changed (\`planned\` \u2192 \`in-progress\` \u2192 \`complete\`)
 2. Document key decisions or changes in the spec content
-3. Link related specs if you discovered connections
+3. Link dependencies if you discover blocking relationships
 
 ### Step 4: Validate (Before Completing)
 Before marking any spec as complete, run validation:
@@ -7981,12 +7837,12 @@ create {
 \`\`\`
 
 ### Step 3: Link Dependencies (CRITICAL)
-After creating, **immediately** link any referenced specs:
+After creating, **immediately** link any specs this depends on:
 
-For each spec mentioned in content:
-- "Depends on spec 045" \u2192 \`link { "spec": "your-spec", "dependsOn": ["045"] }\`
-- "Related to spec 072" \u2192 \`link { "spec": "your-spec", "related": ["072"] }\`
-- "See spec 110" \u2192 \`link { "spec": "your-spec", "related": ["110"] }\`
+For each dependency mentioned in content:
+- "Depends on spec 045" \u2192 \`link { "spec": "your-spec", "dependsOn": "045" }\`
+- "Blocked by spec 072" \u2192 \`link { "spec": "your-spec", "dependsOn": "072" }\`
+- "Requires spec 110" \u2192 \`link { "spec": "your-spec", "dependsOn": "110" }\`
 
 ### Step 4: Verify
 Use \`deps\` to verify all links are in place:
@@ -8007,9 +7863,8 @@ validate { "specs": ["your-spec"], "checkDeps": true }
 | Content Pattern | Link Type |
 |----------------|-----------|
 | "depends on", "blocked by", "requires" | dependsOn |
-| "related to", "see also", "similar to" | related |
-| "builds on" | dependsOn (if blocking) or related |
-| "## Related Specs" section | related (link each one) |
+| "builds on", "extends" | dependsOn |
+| "after spec X is complete" | dependsOn |
 
 **Remember:** Content and frontmatter must stay aligned!`
           }
@@ -8086,5 +7941,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 }
 
 export { agentCommand, analyzeCommand, archiveCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, viewCommand };
-//# sourceMappingURL=chunk-EBSQ7FUR.js.map
-//# sourceMappingURL=chunk-EBSQ7FUR.js.map
+//# sourceMappingURL=chunk-BJHJ6IUO.js.map
+//# sourceMappingURL=chunk-BJHJ6IUO.js.map