@edupia-tutor/spec-driven-docs 0.14.0

package/bin/build.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+
+/**
+ * build.js — Assembles templates → .md files
+ *
+ * Processes:
+ *   commands/*.tmpl       → commands/*.md
+ *   skills/**\/SKILL.tmpl → skills/**\/SKILL.md
+ *
+ * Replaces {{include:steps/gate.md}}, {{include:steps/context-loader.md}},
+ * and {{include:steps/report-footer.md}} with the actual file contents.
+ *
+ * Usage: node bin/build.js
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const COMMANDS_DIR = path.join(ROOT, 'commands');
+const SKILLS_DIR = path.join(ROOT, 'skills');
+
+// Cache for step file contents
+const stepCache = {};
+
+/**
+ * Load a step file by name, caching the result.
+ * @param {string} stepPath - e.g. "steps/gate.md"
+ * @returns {string} file contents
+ */
+function loadStep(stepPath) {
+  if (stepCache[stepPath]) return stepCache[stepPath];
+
+  const fullPath = path.join(ROOT, stepPath);
+  if (!fs.existsSync(fullPath)) {
+    throw new Error(`Step file not found: ${fullPath}`);
+  }
+  const content = fs.readFileSync(fullPath, 'utf8');
+  stepCache[stepPath] = content;
+  return content;
+}
+
+/**
+ * Process a single .tmpl file: resolve all {{include:...}} markers
+ * and write the output as a .md file (replacing .tmpl extension with .md).
+ *
+ * @param {string} tmplFile - full path to the .tmpl file
+ * @param {string} label    - display label for logging (e.g. "generate-code")
+ * @returns {{ label: string, success: boolean, error?: string }}
+ */
+function buildTemplate(tmplFile, label) {
+  const outFile = tmplFile.replace(/\.tmpl$/, '.md');
+
+  try {
+    let content = fs.readFileSync(tmplFile, 'utf8');
+
+    // Replace all {{include:...}} markers
+    content = content.replace(/\{\{include:([^}]+)\}\}/g, (match, includePath) => {
+      const trimmed = includePath.trim();
+      return loadStep(trimmed);
+    });
+
+    fs.writeFileSync(outFile, content, 'utf8');
+    return { label, success: true };
+  } catch (err) {
+    return { label, success: false, error: err.message };
+  }
+}
+
+/**
+ * Recursively find all files matching a predicate under a directory.
+ * @param {string} dir
+ * @param {(filename: string) => boolean} predicate
+ * @returns {string[]} absolute paths
+ */
+function findFiles(dir, predicate) {
+  if (!fs.existsSync(dir)) return [];
+  const results = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...findFiles(fullPath, predicate));
+    } else if (predicate(entry.name)) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+let allSucceeded = 0;
+let allFailed = 0;
+
+// ── 1. Build commands/*.tmpl → commands/*.md ──────────────────────────────────
+
+console.log('');
+console.log('Building commands from templates...');
+console.log('');
+
+const commandTmplFiles = fs.readdirSync(COMMANDS_DIR)
+  .filter(f => f.endsWith('.tmpl'))
+  .map(f => path.join(COMMANDS_DIR, f));
+
+if (commandTmplFiles.length === 0) {
+  console.log('  (no .tmpl files found in commands/)');
+} else {
+  const commandResults = commandTmplFiles.map(f => {
+    const basename = path.basename(f, '.tmpl');
+    return buildTemplate(f, basename);
+  });
+
+  for (const r of commandResults) {
+    if (r.success) {
+      console.log(`  ✅ ${r.label}.tmpl → ${r.label}.md`);
+      allSucceeded++;
+    } else {
+      console.log(`  ❌ ${r.label}.tmpl → FAILED: ${r.error}`);
+      allFailed++;
+    }
+  }
+}
+
+// ── 2. Build skills/**/SKILL.tmpl → skills/**/SKILL.md ───────────────────────
+
+console.log('');
+console.log('Building skills from templates...');
+console.log('');
+
+const skillTmplFiles = findFiles(SKILLS_DIR, name => name === 'SKILL.tmpl');
+
+if (skillTmplFiles.length === 0) {
+  console.log('  (no SKILL.tmpl files found in skills/)');
+} else {
+  const skillResults = skillTmplFiles.map(f => {
+    // Use the parent directory name as the label (e.g., "code", "debug")
+    const skillName = path.basename(path.dirname(f));
+    return buildTemplate(f, `skills/${skillName}/SKILL`);
+  });
+
+  for (const r of skillResults) {
+    if (r.success) {
+      console.log(`  ✅ ${r.label}.tmpl → ${r.label}.md`);
+      allSucceeded++;
+    } else {
+      console.log(`  ❌ ${r.label}.tmpl → FAILED: ${r.error}`);
+      allFailed++;
+    }
+  }
+}
+
+// ── 3. Populate core/ directory (distributable) ──────────────────────────────
+//
+// core/ mirrors what gets installed into .agent/ in consumer projects.
+// It is gitignored but included in the npm package (via "files" whitelist).
+
+const CORE_DIR = path.join(ROOT, 'core');
+const pkg      = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+const VERSION  = pkg.version;
+
+console.log('');
+console.log('Populating core/ (distributable) ...');
+console.log('');
+
+// Clean and recreate core/
+if (fs.existsSync(CORE_DIR)) {
+  fs.rmSync(CORE_DIR, { recursive: true });
+}
+fs.mkdirSync(CORE_DIR, { recursive: true });
+
+/**
+ * Recursively copy src → dest, optionally filtering files by name.
+ * @param {string} src
+ * @param {string} dest
+ * @param {((name: string) => boolean) | null} fileFilter  null = copy all files
+ */
+function copyDirToCore(src, dest, fileFilter) {
+  if (!fs.existsSync(src)) return;
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath  = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirToCore(srcPath, destPath, fileFilter);
+    } else if (!fileFilter || fileFilter(entry.name)) {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+const coreMappings = [
+  // Built command .md files (not .tmpl sources)
+  { src: COMMANDS_DIR,              dest: path.join(CORE_DIR, 'commands'),  filter: f => f.endsWith('.md') },
+  // Step files (gate, context-loader, spawn-agent, report-footer)
+  { src: path.join(ROOT, 'steps'),  dest: path.join(CORE_DIR, 'steps'),    filter: null },
+  // Hook scripts
+  { src: path.join(ROOT, 'hooks'),  dest: path.join(CORE_DIR, 'hooks'),    filter: null },
+  // Data-protection and workflow rules
+  { src: path.join(ROOT, 'rules'),  dest: path.join(CORE_DIR, 'rules'),    filter: null },
+  // PRD / architecture templates
+  { src: path.join(ROOT, 'templates'), dest: path.join(CORE_DIR, 'templates'), filter: null },
+  // Stack module profiles
+  { src: path.join(ROOT, 'modules'),   dest: path.join(CORE_DIR, 'modules'),   filter: null },
+  // Built skill .md files (not .tmpl sources)
+  { src: SKILLS_DIR,                dest: path.join(CORE_DIR, 'skills'),   filter: f => !f.endsWith('.tmpl') },
+];
+
+for (const { src, dest, filter } of coreMappings) {
+  copyDirToCore(src, dest, filter);
+  const rel = path.relative(ROOT, dest);
+  console.log(`  ✅ ${rel}/`);
+}
+
+// Write FRAMEWORK_VERSION so upgrade.sh can compare installed vs latest
+fs.writeFileSync(path.join(CORE_DIR, 'FRAMEWORK_VERSION'), VERSION + '\n', 'utf8');
+console.log(`  ✅ core/FRAMEWORK_VERSION  (v${VERSION})`);
+
+// ── Summary ───────────────────────────────────────────────────────────────────
+
+const total = allSucceeded + allFailed;
+console.log('');
+
+if (allFailed === 0) {
+  console.log(`Build complete: ${allSucceeded}/${total} templates assembled.`);
+} else {
+  console.log(`Build finished with errors: ${allSucceeded}/${total} succeeded.`);
+  process.exit(1);
+}
+
+console.log('');