lean-spec 0.2.6-dev.20251126062137 → 0.2.6-dev.20251126063304

package/dist/{chunk-YPVK4J5Z.js → chunk-KJ2FT3JZ.js}

@@ -648,10 +648,144 @@ function parseCustomFieldOptions(fieldOptions) {
   }
   return customFields;
 }
+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)");
+      process.exit(1);
+    }
+    await linkSpec(specPath, options);
+  });
+}
+async function linkSpec(specPath, options) {
+  await autoCheckIfEnabled();
+  const config = await loadConfig();
+  const cwd = process.cwd();
+  const specsDir = path15.join(cwd, config.specsDir);
+  const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
+  if (!resolvedPath) {
+    throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
+  }
+  const specFile = await getSpecFile(resolvedPath, config.structure.defaultFile);
+  if (!specFile) {
+    throw new Error(`No spec file found in: ${sanitizeUserInput(specPath)}`);
+  }
+  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 = path15.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 relResolvedPath = await resolveSpecPath(relSpec, cwd, specsDir);
+    if (!relResolvedPath) {
+      throw new Error(`Spec not found: ${sanitizeUserInput(relSpec)}`);
+    }
+    if (relResolvedPath === resolvedPath) {
+      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(relSpec)}`);
+    }
+    const relSpecName = path15.basename(relResolvedPath);
+    resolvedRelationships.set(relSpec, relSpecName);
+  }
+  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.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(chalk19.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(chalk19.gray(`  Updated: ${sanitizeUserInput(relSpecName)} (bidirectional)`));
+          }
+        }
+      }
+    }
+    if (added === 0) {
+      console.log(chalk19.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(chalk19.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
+    }
+  }
+  await updateFrontmatter(specFile, updates);
+  const updatedFields = [];
+  if (dependsOnSpecs.length > 0) {
+    updatedFields.push(`depends_on: ${dependsOnSpecs.join(", ")}`);
+  }
+  if (relatedSpecs.length > 0) {
+    updatedFields.push(`related: ${relatedSpecs.join(", ")}`);
+  }
+  console.log(chalk19.green(`\u2713 Added relationships: ${updatedFields.join(", ")}`));
+  console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(path15.relative(cwd, resolvedPath))}`));
+}
+function detectCycles(startSpec, dependsOn, specMap, visited = /* @__PURE__ */ new Set(), path31 = []) {
+  if (visited.has(startSpec)) {
+    const cycleStart = path31.indexOf(startSpec);
+    if (cycleStart !== -1) {
+      return [...path31.slice(cycleStart), startSpec];
+    }
+    return [];
+  }
+  visited.add(startSpec);
+  path31.push(startSpec);
+  for (const dep of dependsOn) {
+    const depSpec = specMap.get(dep);
+    if (depSpec && depSpec.frontmatter.depends_on) {
+      const cycle = detectCycles(dep, depSpec.frontmatter.depends_on, specMap, new Set(visited), [...path31]);
+      if (cycle.length > 0) {
+        return cycle;
+      }
+    }
+  }
+  return [];
+}
 
 // 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").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)").option("--related <specs>", "Add related specs (comma-separated spec numbers or names)").action(async (name, options) => {
     const customFields = parseCustomFieldOptions(options.field);
     const createOptions = {
       title: options.title,
@@ -661,7 +795,9 @@ function createCommand() {
       assignee: options.assignee,
       template: options.template,
       customFields: Object.keys(customFields).length > 0 ? customFields : void 0,
-      noPrefix: options.prefix === false
+      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
     };
     await createSpec(name, createOptions);
   });
@@ -804,6 +940,18 @@ ${options.description}`
     console.log(chalk19.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
     console.log(chalk19.gray(`  Edit: ${sanitizeUserInput(specFile)}`));
   }
+  const hasRelationships = options.dependsOn && options.dependsOn.length > 0 || options.related && options.related.length > 0;
+  if (hasRelationships) {
+    const newSpecName = path15.basename(specDir);
+    try {
+      await linkSpec(newSpecName, {
+        dependsOn: options.dependsOn?.join(","),
+        related: options.related?.join(",")
+      });
+    } catch (error) {
+      console.log(chalk19.yellow(`\u26A0\uFE0F  Warning: Failed to add relationships: ${error.message}`));
+    }
+  }
   await autoCheckIfEnabled();
 }
 function archiveCommand() {
@@ -1162,140 +1310,6 @@ async function updateSpec(specPath, updates, options = {}) {
   }
   console.log(chalk19.gray(`  Fields: ${updatedFields.join(", ")}`));
 }
-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)");
-      process.exit(1);
-    }
-    await linkSpec(specPath, options);
-  });
-}
-async function linkSpec(specPath, options) {
-  await autoCheckIfEnabled();
-  const config = await loadConfig();
-  const cwd = process.cwd();
-  const specsDir = path15.join(cwd, config.specsDir);
-  const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
-  if (!resolvedPath) {
-    throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
-  }
-  const specFile = await getSpecFile(resolvedPath, config.structure.defaultFile);
-  if (!specFile) {
-    throw new Error(`No spec file found in: ${sanitizeUserInput(specPath)}`);
-  }
-  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 = path15.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 relResolvedPath = await resolveSpecPath(relSpec, cwd, specsDir);
-    if (!relResolvedPath) {
-      throw new Error(`Spec not found: ${sanitizeUserInput(relSpec)}`);
-    }
-    if (relResolvedPath === resolvedPath) {
-      throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(relSpec)}`);
-    }
-    const relSpecName = path15.basename(relResolvedPath);
-    resolvedRelationships.set(relSpec, relSpecName);
-  }
-  const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.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(chalk19.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(chalk19.gray(`  Updated: ${sanitizeUserInput(relSpecName)} (bidirectional)`));
-          }
-        }
-      }
-    }
-    if (added === 0) {
-      console.log(chalk19.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(chalk19.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
-    }
-  }
-  await updateFrontmatter(specFile, updates);
-  const updatedFields = [];
-  if (dependsOnSpecs.length > 0) {
-    updatedFields.push(`depends_on: ${dependsOnSpecs.join(", ")}`);
-  }
-  if (relatedSpecs.length > 0) {
-    updatedFields.push(`related: ${relatedSpecs.join(", ")}`);
-  }
-  console.log(chalk19.green(`\u2713 Added relationships: ${updatedFields.join(", ")}`));
-  console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(path15.relative(cwd, resolvedPath))}`));
-}
-function detectCycles(startSpec, dependsOn, specMap, visited = /* @__PURE__ */ new Set(), path31 = []) {
-  if (visited.has(startSpec)) {
-    const cycleStart = path31.indexOf(startSpec);
-    if (cycleStart !== -1) {
-      return [...path31.slice(cycleStart), startSpec];
-    }
-    return [];
-  }
-  visited.add(startSpec);
-  path31.push(startSpec);
-  for (const dep of dependsOn) {
-    const depSpec = specMap.get(dep);
-    if (depSpec && depSpec.frontmatter.depends_on) {
-      const cycle = detectCycles(dep, depSpec.frontmatter.depends_on, specMap, new Set(visited), [...path31]);
-      if (cycle.length > 0) {
-        return cycle;
-      }
-    }
-  }
-  return [];
-}
 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) {
@@ -8323,7 +8337,9 @@ function createTool() {
         tags: z.array(z.string()).optional().describe('Tags to categorize the spec (e.g., ["api", "frontend", "v2.0"]).'),
         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.')
+        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.')
       },
       outputSchema: {
         success: z.boolean(),
@@ -8345,7 +8361,9 @@ function createTool() {
           tags: input.tags,
           priority: input.priority,
           assignee: input.assignee,
-          template: input.template
+          template: input.template,
+          dependsOn: input.dependsOn,
+          related: input.related
         });
         const output = {
           success: true,
@@ -8704,11 +8722,24 @@ function searchTool() {
     "search",
     {
       title: "Search Specs",
-      description: "Intelligent relevance-ranked search across all specification content. Uses field-weighted scoring (title > tags > description > content) to return the most relevant specs. Returns matching specs with relevance scores, highlighted excerpts, and metadata.",
+      description: `Intelligent relevance-ranked search across all specification content. Uses field-weighted scoring (title > tags > description > content) to return the most relevant specs.
+
+**Query Formulation Tips:**
+- Use 2-4 specific terms for best results (e.g., "search ranking" not "AI agent integration coding agent orchestration")
+- All terms must appear in the SAME field/line to match - keep queries focused
+- Prefer nouns and technical terms over common words
+- Use filters (status, tags, priority) to narrow scope instead of adding more search terms
+
+**Examples:**
+- Good: "search ranking" or "token validation"
+- Good: "api" with tags filter ["integration"]  
+- Poor: "AI agent integration coding agent orchestration" (too many terms, unlikely all in one line)
+
+Returns matching specs with relevance scores, highlighted excerpts, and metadata.`,
       inputSchema: {
-        query: z.string().describe("Search term or phrase to find in spec content. Multiple terms are combined with AND logic. Searches across titles, tags, descriptions, and body text with intelligent relevance ranking."),
+        query: z.string().describe("Search term or phrase. Use 2-4 specific terms. All terms must appear in the same field/line to match. For broad concepts, use fewer terms + filters instead of long queries."),
         status: z.enum(["planned", "in-progress", "complete", "archived"]).optional().describe("Limit search to specs with this status."),
-        tags: z.array(z.string()).optional().describe("Limit search to specs with these tags."),
+        tags: z.array(z.string()).optional().describe("Limit search to specs with these tags. Use this to narrow scope instead of adding more search terms."),
         priority: z.enum(["low", "medium", "high", "critical"]).optional().describe("Limit search to specs with this priority.")
       },
       outputSchema: {
@@ -9557,5 +9588,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 }
 
 export { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand };
-//# sourceMappingURL=chunk-YPVK4J5Z.js.map
-//# sourceMappingURL=chunk-YPVK4J5Z.js.map
+//# sourceMappingURL=chunk-KJ2FT3JZ.js.map
+//# sourceMappingURL=chunk-KJ2FT3JZ.js.map