speckeeper 0.3.0 → 0.4.0

package/dist/cli.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import chalk4 from 'chalk';
+import { readFileSync, existsSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
 import { dirname, join, resolve } from 'path';
-import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { fileURLToPath } from 'url';
+import chalk4 from 'chalk';
 import { parse } from 'yaml';
 import 'crypto';
 import 'glob';
 import { z } from 'zod';
-import { fileURLToPath } from 'url';
 
 var defaultConfig = {
   srcDir: "src",
@@ -123,40 +123,38 @@ var RelationSchema = z.object({
 z.array(RelationSchema).optional();
 
 // src/core/model.ts
-var specStore = /* @__PURE__ */ new Map();
-function getSpecStore() {
-  return specStore;
-}
 var modelRegistry = /* @__PURE__ */ new Map();
-function registerModel(model) {
-  modelRegistry.set(model.id, model);
-}
 function getAllModels() {
   return Array.from(modelRegistry.values());
 }
-function registerModelsFromConfig(models) {
-  for (const model of models) {
-    if (model && typeof model === "object" && "id" in model && "schema" in model) {
-      registerModel(model);
+function buildRegistryFromConfig(specs) {
+  const registry = {};
+  if (!specs) return registry;
+  for (const entry of specs) {
+    if (!registry[entry.model.id]) {
+      registry[entry.model.id] = /* @__PURE__ */ new Map();
+    }
+    const map = registry[entry.model.id];
+    for (const spec of entry.data) {
+      map.set(spec.id, spec);
     }
   }
+  return registry;
 }
-function getSpecs(modelId) {
-  const map = specStore.get(modelId);
-  if (!map) return [];
-  return Array.from(map.values());
-}
-function findModelTypeBySpecId(specId) {
-  for (const [modelId, map] of specStore) {
-    if (map.has(specId)) return modelId;
-  }
-  return null;
+function getSpecsFromConfig(specs, modelId) {
+  if (!specs) return [];
+  return specs.filter((e) => e.model.id === modelId).flatMap((e) => e.data);
 }
-function registerSpecsFromConfig(specs) {
-  if (!specs) return;
+function findModelTypeFromConfig(specs, specId) {
+  if (!specs) return null;
   for (const entry of specs) {
-    entry.model.register(entry.data);
+    for (const spec of entry.data) {
+      if (spec.id === specId) {
+        return entry.model.id;
+      }
+    }
   }
+  return null;
 }
 
 // src/cli/build.ts
@@ -170,14 +168,11 @@ async function buildCommand(options) {
   console.log(chalk4.gray(`  Specs:   ${config.specsDir}/`));
   console.log("");
   try {
-    console.log(chalk4.blue("  Loading models..."));
-    registerModelsFromConfig(config.models || []);
-    registerSpecsFromConfig(config.specs);
-    console.log("");
+    const models = config.models || [];
+    const specs = config.specs;
     ensureDir(join(cwd, config.docsDir));
     ensureDir(join(cwd, config.specsDir));
     const files = [];
-    const models = getAllModels();
     if (models.length === 0) {
       console.log(chalk4.yellow("  No models registered. Add models to speckeeper.config.ts."));
       return;
@@ -191,8 +186,8 @@ async function buildCommand(options) {
         }
         continue;
       }
-      const specs = getSpecs(model.id);
-      if (specs.length === 0) {
+      const modelSpecs = getSpecsFromConfig(specs, model.id);
+      if (modelSpecs.length === 0) {
         if (options.verbose) {
           console.log(chalk4.gray(`    ${model.name}: no specs found`));
         }
@@ -202,7 +197,7 @@ async function buildCommand(options) {
         const outputDir = exporter.outputDir ? join(cwd, config.docsDir, exporter.outputDir) : join(cwd, config.docsDir);
         ensureDir(outputDir);
         if (exporter.single) {
-          for (const spec of specs) {
+          for (const spec of modelSpecs) {
             const content = exporter.single(spec);
             const filename = model.getFilename(spec, exporter.format) || spec.id;
             files.push({
@@ -212,7 +207,7 @@ async function buildCommand(options) {
           }
         }
         if (exporter.index) {
-          const indexContent = exporter.index(specs);
+          const indexContent = exporter.index(modelSpecs);
           files.push({
             path: join(outputDir, "index.md"),
             content: indexContent
@@ -248,14 +243,12 @@ async function lintCommand(options) {
   }
   console.log("");
   try {
-    console.log(chalk4.blue("  Loading models..."));
-    registerModelsFromConfig(config.models || []);
-    registerSpecsFromConfig(config.specs);
-    const models = getAllModels();
+    const models = config.models || [];
+    const specs = config.specs;
     console.log(chalk4.gray(`  Loaded: ${models.length} models`));
     console.log("");
     console.log(chalk4.blue("  Running lint checks..."));
-    const result = runModelLint(options);
+    const result = runModelLint(models, specs, options);
     console.log("");
     outputLintResults(result, options);
     if (result.errors > 0) {
@@ -266,13 +259,12 @@ async function lintCommand(options) {
     process.exit(1);
   }
 }
-function runModelLint(options) {
+function runModelLint(models, specs, options) {
   const issues = [];
-  const models = getAllModels();
   for (const model of models) {
-    const specs = getSpecs(model.id);
-    if (specs.length === 0) continue;
-    const lintResults = model.lintAll(specs);
+    const modelSpecs = getSpecsFromConfig(specs, model.id);
+    if (modelSpecs.length === 0) continue;
+    const lintResults = model.lintAll(modelSpecs);
     for (const result of lintResults) {
       issues.push({
         rule: result.ruleId,
@@ -331,19 +323,17 @@ async function driftCommand(options) {
   console.log(chalk4.gray(`  Docs:   ${config.docsDir}/`));
   console.log("");
   try {
-    console.log(chalk4.blue("  Loading models..."));
-    registerModelsFromConfig(config.models || []);
-    registerSpecsFromConfig(config.specs);
+    const models = config.models || [];
+    const specs = config.specs;
     const results = [];
-    const models = getAllModels();
     for (const model of models) {
-      const specs = getSpecs(model.id);
-      if (specs.length === 0) continue;
+      const modelSpecs = getSpecsFromConfig(specs, model.id);
+      if (modelSpecs.length === 0) continue;
       for (const exporter of model.getExporters()) {
         if (exporter.format !== "markdown") continue;
         const outputDir = exporter.outputDir ? join(cwd, config.docsDir, exporter.outputDir) : join(cwd, config.docsDir);
         if (exporter.single) {
-          for (const spec of specs) {
+          for (const spec of modelSpecs) {
             const filename = model.getFilename(spec, "markdown") || spec.id;
             const filePath = join(outputDir, `${filename}.md`);
             if (!existsSync(filePath)) {
@@ -364,7 +354,7 @@ async function driftCommand(options) {
           if (!existsSync(indexPath)) {
             results.push({ file: indexPath, status: "missing" });
           } else {
-            const expected = exporter.index(specs);
+            const expected = exporter.index(modelSpecs);
             const actual = readFileSync(indexPath, "utf-8");
             if (normalizeContent(expected) !== normalizeContent(actual)) {
               results.push({ file: indexPath, status: "drifted" });
@@ -423,18 +413,16 @@ async function checkCommand(type, options) {
   console.log(chalk4.gray(`  Type:   ${checkType}`));
   console.log("");
   try {
-    console.log(chalk4.blue("  Loading models..."));
-    registerModelsFromConfig(config.models || []);
-    registerSpecsFromConfig(config.specs);
-    const results = [];
-    const models = getAllModels();
+    const models = config.models || [];
+    const specs = config.specs;
     if (options.verbose) {
       console.log(chalk4.gray(`  Registered models: ${models.map((m) => m.id).join(", ")}`));
     }
+    const results = [];
     for (const model of models) {
-      const specs = getSpecs(model.id);
-      if (specs.length === 0) continue;
-      for (const spec of specs) {
+      const modelSpecs = getSpecsFromConfig(specs, model.id);
+      if (modelSpecs.length === 0) continue;
+      for (const spec of modelSpecs) {
         const sourcePath = model.getExternalSourcePath(spec);
         if (!sourcePath) continue;
         const fullPath = join(cwd, sourcePath);
@@ -468,7 +456,7 @@ async function checkCommand(type, options) {
     if (options.coverage) {
       console.log("");
       console.log(chalk4.blue("  Coverage checks..."));
-      const coverageResults = runAllCoverageChecks();
+      const coverageResults = runAllCoverageChecks(models, specs);
       if (coverageResults.length > 0) {
         outputAllCoverageResults(coverageResults);
         for (const check of coverageResults) {
@@ -476,7 +464,6 @@ async function checkCommand(type, options) {
             results.push({
               type: `coverage-${check.modelId}`,
               success: check.result.coveragePercent >= 80,
-              // fail if below 80%
               issues: check.result.uncoveredItems.slice(0, 10).map((item) => ({
                 severity: "warning",
                 message: `[${check.modelName}\u2192${check.targetModel}] '${item.id}'${item.sourceId ? ` (${item.sourceId})` : ""} not covered`,
@@ -538,15 +525,14 @@ function outputCheckResults(results) {
   console.log("");
   console.log(chalk4.gray(`  Summary: ${totalErrors} errors, ${totalWarnings} warnings`));
 }
-function runAllCoverageChecks() {
-  const models = getAllModels();
+function runAllCoverageChecks(models, specs) {
   const results = [];
-  const registry = Object.fromEntries(getSpecStore());
+  const registry = buildRegistryFromConfig(specs);
   for (const model of models) {
     const checker = model.getCoverageChecker();
     if (checker) {
-      const specs = getSpecs(model.id);
-      const result = model.checkCoverage(specs, registry);
+      const modelSpecs = getSpecsFromConfig(specs, model.id);
+      const result = model.checkCoverage(modelSpecs, registry);
       if (result) {
         results.push({
           modelId: model.id,
@@ -662,29 +648,27 @@ async function impactCommand(targetId, options) {
   console.log(chalk4.gray(`  Depth:  ${maxDepth}`));
   console.log("");
   try {
-    console.log(chalk4.blue("  Loading models..."));
-    registerModelsFromConfig(config.models || []);
-    registerSpecsFromConfig(config.specs);
-    const store = getSpecStore();
-    const targetType = findModelTypeBySpecId(targetId);
+    const specs = config.specs;
+    const registry = buildRegistryFromConfig(specs);
+    const targetType = findModelTypeFromConfig(specs, targetId);
     if (!targetType) {
       console.error(chalk4.red(`  Error: Target '${targetId}' not found`));
       process.exit(1);
     }
     console.log(chalk4.blue("  Analyzing impact..."));
-    const result = analyzeImpact(store, targetId, targetType, maxDepth);
+    const result = analyzeImpact(registry, targetId, targetType, maxDepth);
     outputImpactResults(result, options);
   } catch (error) {
     console.error(chalk4.red("Impact analysis failed:"), error);
     process.exit(1);
   }
 }
-function analyzeImpact(store, targetId, targetType, maxDepth) {
+function analyzeImpact(registry, targetId, targetType, maxDepth) {
   const impactedNodes = [];
   const visited = /* @__PURE__ */ new Set([targetId]);
   function findReferences(id, depth) {
     if (depth > maxDepth) return;
-    for (const [type, map] of store) {
+    for (const [type, map] of Object.entries(registry)) {
       for (const [itemId, item] of map) {
         if (visited.has(itemId)) continue;
         const itemStr = JSON.stringify(item);
@@ -2542,8 +2526,17 @@ function printDiagnostics(diagnostics) {
 }
 
 // src/cli/index.ts
+function getVersion() {
+  try {
+    const __dirname2 = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(__dirname2, "..", "package.json"), "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
 var program = new Command();
-program.name("speckeeper").description("Requirements and design management framework with TypeScript DSL").version("0.1.0");
+program.name("speckeeper").description("Requirements and design management framework with TypeScript DSL").version(getVersion());
 program.command("build").description("Generate docs/ and specs/ from TypeScript models").option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Base output directory path", ".").option("-f, --format <format>", "Output format: markdown, json, both", "both").option("-w, --watch", "Watch for changes and auto-regenerate").option("-v, --verbose", "Show detailed output").action(buildCommand);
 program.command("lint").description("Check design integrity (ID duplicates, references, layer violations, etc.)").option("-c, --config <path>", "Path to config file").option("-p, --phase <phase>", "Phase gate to check against (REQ, HLD, LLD, OPS)").option("-s, --strict", "Treat warnings as errors").option("--fix", "Attempt to fix auto-fixable issues").option("-f, --format <format>", "Output format: text, json, github", "text").action(lintCommand);
 program.command("drift").description("Check if generated files have been manually edited").option("-c, --config <path>", "Path to config file").option("-u, --update", "Auto-update if differences are found").option("-f, --format <format>", "Output format: text, json, diff", "text").action(driftCommand);