thachvd-kit 1.0.38 → 1.0.39

package/bin/spec.js

@@ -7,6 +7,7 @@ const nativeSkills = require('./native-skills');
 const specState = require('./spec-state');
 const userConfig = require('./config');
 const specDoctor = require('./spec-doctor');
+const specSite = require('./spec-site');
 
 const MANIFEST_RELATIVE_PATH = path.join('.thachvd', 'system.json');
 const DEFAULT_SPEC_ROOT = 'system-specs';
@@ -563,6 +564,8 @@ Usage:
   thachvd-kit spec verify [CAPABILITY]
   thachvd-kit spec check [--strict]
   thachvd-kit spec doctor [--strict]
+  thachvd-kit spec build [--output PATH] [--remote-mermaid]
+  thachvd-kit spec serve [--output PATH] [--host HOST] [--port PORT] [--no-build] [--remote-mermaid]
   thachvd-kit spec link [--dry-run] [--allow-unverified]
   thachvd-kit spec status
 
@@ -583,6 +586,10 @@ Commands:
                 --strict exits non-zero when stale/unknown capabilities exist.
   doctor        Read-only health report for repos, tools, skills, progress, verification, drift, and links.
                 --strict exits non-zero when any WARN/ERROR remains.
+  build         Generate a static HTML system explorer from Markdown + JSON specs. No AI call.
+                Default output: <spec_root>/_site. --remote-mermaid explicitly allows CDN JavaScript.
+  serve         Build (unless --no-build) and serve the generated explorer locally.
+                Defaults: 127.0.0.1:4173.
   link          Add/update the managed system-spec block in each repository's AGENTS.md.
                 Requires all capabilities independently verified unless --allow-unverified is explicit.
   status        Show configured repositories, reverse progress, and verification state.
@@ -591,7 +598,7 @@ Commands:
 Recommended order:
   init -> index -> discover -> /system-discovery -> human review
   -> reverse -> /system-reverse-engineer -> verify -> /system-spec-review
-  -> check -> link
+  -> check -> build/serve -> link
 `);
 }
 
@@ -766,6 +773,41 @@ function runSpecCommand(args, options = {}) {
             return 0;
         }
 
+        if (command === 'build') {
+            const commandArgs = args.slice(1);
+            const manifest = readManifest(workspaceRoot);
+            const result = specSite.buildSite(workspaceRoot, manifest, {
+                output: parseSingleOption(commandArgs, '--output'),
+                remoteMermaid: hasFlag(commandArgs, '--remote-mermaid')
+            });
+            console.log(`Built ${result.pages} HTML page(s) for ${result.model.counts.capabilities} capability(s).`);
+            console.log(`Output: ${toPortablePath(path.relative(workspaceRoot, result.outputRoot))}`);
+            console.log(`Open: ${toPortablePath(path.join(path.relative(workspaceRoot, result.outputRoot), 'index.html'))}`);
+            return 0;
+        }
+
+        if (command === 'serve') {
+            const commandArgs = args.slice(1);
+            const manifest = readManifest(workspaceRoot);
+            const outputOption = parseSingleOption(commandArgs, '--output');
+            let outputRoot = specSite.resolveOutputRoot(workspaceRoot, manifest, outputOption);
+            if (!hasFlag(commandArgs, '--no-build')) {
+                const result = specSite.buildSite(workspaceRoot, manifest, {
+                    output: outputOption,
+                    remoteMermaid: hasFlag(commandArgs, '--remote-mermaid')
+                });
+                outputRoot = result.outputRoot;
+                console.log(`Built ${result.pages} HTML page(s) before serving.`);
+            } else if (!fs.existsSync(path.join(outputRoot, 'index.html'))) {
+                throw new Error('Generated site not found. Run thachvd-kit spec build first or omit --no-build.');
+            }
+            specSite.serveSite(outputRoot, {
+                host: parseSingleOption(commandArgs, '--host', specSite.DEFAULT_HOST),
+                port: parseSingleOption(commandArgs, '--port', String(specSite.DEFAULT_PORT))
+            });
+            return 0;
+        }
+
         if (command === 'link') {
             const commandArgs = args.slice(1);
             const manifest = readManifest(workspaceRoot);