@grainulation/barn 1.0.0 → 1.0.1

package/tools/detect-sprints.js

@@ -22,10 +22,10 @@
  * Zero npm dependencies (Node built-in only).
  */
 
-import { readFileSync, existsSync, readdirSync } from 'node:fs';
-import { join, basename } from 'node:path';
-import { execFileSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { join, basename } from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
 
@@ -36,7 +36,7 @@ let ROOT = process.cwd();
 /** Parse CLI args — only called when this file is the entry point. */
 function parseCLIArgs() {
   const args = process.argv.slice(2);
-  const i = args.indexOf('--root');
+  const i = args.indexOf("--root");
   if (i !== -1 && args[i + 1]) ROOT = args[i + 1];
   return args;
 }
@@ -46,7 +46,7 @@ function parseCLIArgs() {
 /** Safely parse JSON from a file path; returns null on failure. */
 function loadJSON(filePath) {
   try {
-    return JSON.parse(readFileSync(filePath, 'utf8'));
+    return JSON.parse(readFileSync(filePath, "utf8"));
   } catch {
     return null;
   }
@@ -58,9 +58,11 @@ function loadJSON(filePath) {
  */
 function lastGitCommitDate(filePath) {
   try {
-    const result = execFileSync('git', [
-      'log', '-1', '--format=%aI', '--', filePath
-    ], { cwd: ROOT, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'] });
+    const result = execFileSync(
+      "git",
+      ["log", "-1", "--format=%aI", "--", filePath],
+      { cwd: ROOT, timeout: 5000, stdio: ["ignore", "pipe", "pipe"] },
+    );
     const dateStr = result.toString().trim();
     return dateStr || null;
   } catch {
@@ -73,9 +75,11 @@ function lastGitCommitDate(filePath) {
  */
 function gitCommitCount(filePath) {
   try {
-    const result = execFileSync('git', [
-      'rev-list', '--count', 'HEAD', '--', filePath
-    ], { cwd: ROOT, timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'] });
+    const result = execFileSync(
+      "git",
+      ["rev-list", "--count", "HEAD", "--", filePath],
+      { cwd: ROOT, timeout: 5000, stdio: ["ignore", "pipe", "pipe"] },
+    );
     return parseInt(result.toString().trim(), 10) || 0;
   } catch {
     return 0;
@@ -86,18 +90,18 @@ function gitCommitCount(filePath) {
  * Derive a slug from the sprint's path or question.
  */
 function deriveName(sprintPath, meta) {
-  if (sprintPath !== '.') {
+  if (sprintPath !== ".") {
     return basename(sprintPath);
   }
   if (meta?.question) {
     return meta.question
       .toLowerCase()
-      .replace(/[^a-z0-9\s]/g, '')
+      .replace(/[^a-z0-9\s]/g, "")
       .split(/\s+/)
       .slice(0, 4)
-      .join('-');
+      .join("-");
   }
-  return 'current';
+  return "current";
 }
 
 // ─── Scanner ─────────────────────────────────────────────────────────────────
@@ -106,25 +110,27 @@ function deriveName(sprintPath, meta) {
 function findSprintRoots() {
   const roots = [];
 
-  const rootClaims = join(ROOT, 'claims.json');
+  const rootClaims = join(ROOT, "claims.json");
   if (existsSync(rootClaims)) {
-    roots.push({ claimsPath: rootClaims, sprintPath: '.' });
+    roots.push({ claimsPath: rootClaims, sprintPath: "." });
   }
 
-  const examplesDir = join(ROOT, 'examples');
+  const examplesDir = join(ROOT, "examples");
   if (existsSync(examplesDir)) {
     try {
       for (const entry of readdirSync(examplesDir, { withFileTypes: true })) {
         if (!entry.isDirectory()) continue;
-        const claimsPath = join(examplesDir, entry.name, 'claims.json');
+        const claimsPath = join(examplesDir, entry.name, "claims.json");
         if (existsSync(claimsPath)) {
           roots.push({
             claimsPath,
-            sprintPath: join('examples', entry.name),
+            sprintPath: join("examples", entry.name),
           });
         }
       }
-    } catch { /* skip if unreadable */ }
+    } catch {
+      /* skip if unreadable */
+    }
   }
 
   return roots;
@@ -142,29 +148,31 @@ function analyzeSprint(root) {
   const lastCommit = lastGitCommitDate(root.claimsPath);
   const commitCount = gitCommitCount(root.claimsPath);
 
-  const phase = meta.phase || 'unknown';
-  const isArchived = phase === 'archived' || phase === 'complete';
-  const isExample = root.sprintPath.startsWith('examples/') || root.sprintPath.startsWith('examples\\');
+  const phase = meta.phase || "unknown";
+  const isArchived = phase === "archived" || phase === "complete";
+  const isExample =
+    root.sprintPath.startsWith("examples/") ||
+    root.sprintPath.startsWith("examples\\");
 
   let status;
   if (isArchived) {
-    status = 'archived';
+    status = "archived";
   } else if (isExample) {
-    status = 'example';
+    status = "example";
   } else {
-    status = 'candidate';
+    status = "candidate";
   }
 
   return {
     name: deriveName(root.sprintPath, meta),
     path: root.sprintPath,
-    question: meta.question || '',
+    question: meta.question || "",
     phase,
     initiated: meta.initiated || null,
     last_git_activity: lastCommit,
     git_commit_count: commitCount,
     claims_count: claimsList.length,
-    active_claims: claimsList.filter(c => c.status === 'active').length,
+    active_claims: claimsList.filter((c) => c.status === "active").length,
     status,
   };
 }
@@ -183,12 +191,16 @@ export function detectSprints(rootDir) {
   const roots = findSprintRoots();
   const sprints = roots.map(analyzeSprint).filter(Boolean);
 
-  const candidates = sprints.filter(s => s.status === 'candidate');
-  const others = sprints.filter(s => s.status !== 'candidate');
+  const candidates = sprints.filter((s) => s.status === "candidate");
+  const others = sprints.filter((s) => s.status !== "candidate");
 
   candidates.sort((a, b) => {
-    const dateA = a.last_git_activity ? new Date(a.last_git_activity).getTime() : 0;
-    const dateB = b.last_git_activity ? new Date(b.last_git_activity).getTime() : 0;
+    const dateA = a.last_git_activity
+      ? new Date(a.last_git_activity).getTime()
+      : 0;
+    const dateB = b.last_git_activity
+      ? new Date(b.last_git_activity).getTime()
+      : 0;
     if (dateB !== dateA) return dateB - dateA;
 
     const initA = a.initiated ? new Date(a.initiated).getTime() : 0;
@@ -200,28 +212,36 @@ export function detectSprints(rootDir) {
 
   let active = null;
   if (candidates.length > 0) {
-    candidates[0].status = 'active';
+    candidates[0].status = "active";
     active = candidates[0];
   }
 
   if (!active && others.length > 0) {
-    const nonArchived = others.filter(s => s.status !== 'archived');
+    const nonArchived = others.filter((s) => s.status !== "archived");
     if (nonArchived.length > 0) {
       nonArchived.sort((a, b) => {
-        const dateA = a.last_git_activity ? new Date(a.last_git_activity).getTime() : 0;
-        const dateB = b.last_git_activity ? new Date(b.last_git_activity).getTime() : 0;
+        const dateA = a.last_git_activity
+          ? new Date(a.last_git_activity).getTime()
+          : 0;
+        const dateB = b.last_git_activity
+          ? new Date(b.last_git_activity).getTime()
+          : 0;
         return dateB - dateA;
       });
-      nonArchived[0].status = 'active';
+      nonArchived[0].status = "active";
       active = nonArchived[0];
     }
   }
 
   const allSprints = [...candidates, ...others].sort((a, b) => {
-    if (a.status === 'active' && b.status !== 'active') return -1;
-    if (b.status === 'active' && a.status !== 'active') return 1;
-    const dateA = a.last_git_activity ? new Date(a.last_git_activity).getTime() : 0;
-    const dateB = b.last_git_activity ? new Date(b.last_git_activity).getTime() : 0;
+    if (a.status === "active" && b.status !== "active") return -1;
+    if (b.status === "active" && a.status !== "active") return 1;
+    const dateA = a.last_git_activity
+      ? new Date(a.last_git_activity).getTime()
+      : 0;
+    const dateB = b.last_git_activity
+      ? new Date(b.last_git_activity).getTime()
+      : 0;
     return dateB - dateA;
   });
 
@@ -232,7 +252,7 @@ export function detectSprints(rootDir) {
 
 if (process.argv[1] === __filename) {
   const args = parseCLIArgs();
-  if (args.includes('--help') || args.includes('-h')) {
+  if (args.includes("--help") || args.includes("-h")) {
     console.log(`detect-sprints — git-based sprint detection (no config required)
 
 Usage:
@@ -250,16 +270,16 @@ sprint using git commit history and metadata — no config pointer needed.`);
   const result = detectSprints();
   const elapsed = (performance.now() - t0).toFixed(1);
 
-  if (args.includes('--json')) {
+  if (args.includes("--json")) {
     console.log(JSON.stringify(result, null, 2));
     process.exit(0);
   }
 
-  if (args.includes('--active')) {
+  if (args.includes("--active")) {
     if (result.active) {
       console.log(result.active.path);
     } else {
-      console.error('No active sprint detected.');
+      console.error("No active sprint detected.");
       process.exit(1);
     }
     process.exit(0);
@@ -267,26 +287,30 @@ sprint using git commit history and metadata — no config pointer needed.`);
 
   // Human-readable output
   console.log(`Sprint Detection (${elapsed}ms)`);
-  console.log('='.repeat(50));
+  console.log("=".repeat(50));
   console.log(`Found ${result.sprints.length} sprint(s)\n`);
 
   for (const sprint of result.sprints) {
-    const icon = sprint.status === 'active' ? '>>>' : '   ';
+    const icon = sprint.status === "active" ? ">>>" : "   ";
     const statusTag = sprint.status.toUpperCase().padEnd(8);
     console.log(`${icon} [${statusTag}] ${sprint.name}`);
     console.log(`    Path:     ${sprint.path}`);
     console.log(`    Phase:    ${sprint.phase}`);
-    console.log(`    Claims:   ${sprint.claims_count} total, ${sprint.active_claims} active`);
-    console.log(`    Initiated: ${sprint.initiated || 'unknown'}`);
-    console.log(`    Last git:  ${sprint.last_git_activity || 'untracked'}`);
+    console.log(
+      `    Claims:   ${sprint.claims_count} total, ${sprint.active_claims} active`,
+    );
+    console.log(`    Initiated: ${sprint.initiated || "unknown"}`);
+    console.log(`    Last git:  ${sprint.last_git_activity || "untracked"}`);
     console.log(`    Commits:   ${sprint.git_commit_count}`);
-    console.log(`    Question:  ${sprint.question.slice(0, 80)}${sprint.question.length > 80 ? '...' : ''}`);
+    console.log(
+      `    Question:  ${sprint.question.slice(0, 80)}${sprint.question.length > 80 ? "..." : ""}`,
+    );
     console.log();
   }
 
   if (result.active) {
     console.log(`Active sprint: ${result.active.path} (${result.active.name})`);
   } else {
-    console.log('No active sprint detected.');
+    console.log("No active sprint detected.");
   }
 }

package/tools/generate-manifest.js

@@ -11,11 +11,17 @@
  *   barn generate-manifest --out custom-name.json  # Custom output path
  */
 
-import { readFileSync, writeFileSync, readdirSync, statSync, existsSync } from 'node:fs';
-import { join, relative, resolve, basename, sep } from 'node:path';
-import { execFileSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { detectSprints } from './detect-sprints.js';
+import {
+  readFileSync,
+  writeFileSync,
+  readdirSync,
+  statSync,
+  existsSync,
+} from "node:fs";
+import { join, relative, resolve, basename, sep } from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { detectSprints } from "./detect-sprints.js";
 
 // ─── CLI args ────────────────────────────────────────────────────────────────
 
@@ -26,14 +32,14 @@ function arg(name, fallback) {
   return i !== -1 && args[i + 1] ? args[i + 1] : fallback;
 }
 
-const ROOT = arg('root', process.cwd());
-const OUT_PATH = join(ROOT, arg('out', 'wheat-manifest.json'));
+const ROOT = arg("root", process.cwd());
+const OUT_PATH = join(ROOT, arg("out", "wheat-manifest.json"));
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
 function loadJSON(path) {
   try {
-    return JSON.parse(readFileSync(path, 'utf8'));
+    return JSON.parse(readFileSync(path, "utf8"));
   } catch {
     return null;
   }
@@ -47,10 +53,10 @@ function walk(dir, filter, rootDir) {
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
     const full = join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
       results.push(...walk(full, filter, base));
     } else {
-      const rel = relative(base, full).split(sep).join('/');
+      const rel = relative(base, full).split(sep).join("/");
       if (!filter || filter(rel, entry.name)) results.push(rel);
     }
   }
@@ -59,23 +65,23 @@ function walk(dir, filter, rootDir) {
 
 /** Determine file type from its path. */
 function classifyFile(relPath) {
-  if (relPath.startsWith('prototypes/')) return 'prototype';
-  if (relPath.startsWith('research/')) return 'research';
-  if (relPath.startsWith('output/')) return 'output';
-  if (relPath.startsWith('evidence/')) return 'evidence';
-  if (relPath.startsWith('templates/')) return 'template';
-  if (relPath.startsWith('examples/')) return 'example';
-  if (relPath.startsWith('test/')) return 'test';
-  if (relPath.startsWith('docs/')) return 'docs';
-  if (relPath.endsWith('.json')) return 'config';
-  if (relPath.endsWith('.js') || relPath.endsWith('.mjs')) return 'script';
-  if (relPath.endsWith('.md')) return 'docs';
-  return 'other';
+  if (relPath.startsWith("prototypes/")) return "prototype";
+  if (relPath.startsWith("research/")) return "research";
+  if (relPath.startsWith("output/")) return "output";
+  if (relPath.startsWith("evidence/")) return "evidence";
+  if (relPath.startsWith("templates/")) return "template";
+  if (relPath.startsWith("examples/")) return "example";
+  if (relPath.startsWith("test/")) return "test";
+  if (relPath.startsWith("docs/")) return "docs";
+  if (relPath.endsWith(".json")) return "config";
+  if (relPath.endsWith(".js") || relPath.endsWith(".mjs")) return "script";
+  if (relPath.endsWith(".md")) return "docs";
+  return "other";
 }
 
 /** Compute highest evidence tier from a list of claims. */
 function highestEvidence(claims) {
-  const tiers = ['stated', 'web', 'documented', 'tested', 'production'];
+  const tiers = ["stated", "web", "documented", "tested", "production"];
   let max = 0;
   for (const c of claims) {
     const idx = tiers.indexOf(c.evidence);
@@ -95,13 +101,13 @@ function highestEvidence(claims) {
  * @returns {object} — the manifest object (not written to disk)
  */
 export function generateManifest(claimsPath, opts = {}) {
-  const root = opts.root || join(claimsPath, '..');
+  const root = opts.root || join(claimsPath, "..");
   const claims = loadJSON(claimsPath);
   if (!claims) {
     throw new Error(`claims.json not found or invalid at ${claimsPath}`);
   }
 
-  const compilationPath = join(root, 'compilation.json');
+  const compilationPath = join(root, "compilation.json");
   const compilation = loadJSON(compilationPath);
 
   // 1. Build topic map from claims
@@ -109,18 +115,31 @@ export function generateManifest(claimsPath, opts = {}) {
   for (const claim of claims.claims) {
     const topic = claim.topic;
     if (!topicMap[topic]) {
-      topicMap[topic] = { claims: [], files: new Set(), sprint: 'current', evidence_level: 'stated' };
+      topicMap[topic] = {
+        claims: [],
+        files: new Set(),
+        sprint: "current",
+        evidence_level: "stated",
+      };
     }
     topicMap[topic].claims.push(claim.id);
   }
 
   for (const topic of Object.keys(topicMap)) {
-    const topicClaims = claims.claims.filter(c => c.topic === topic);
+    const topicClaims = claims.claims.filter((c) => c.topic === topic);
     topicMap[topic].evidence_level = highestEvidence(topicClaims);
   }
 
   // 2. Scan directories for files
-  const scanDirs = ['research', 'prototypes', 'output', 'evidence', 'templates', 'test', 'docs'];
+  const scanDirs = [
+    "research",
+    "prototypes",
+    "output",
+    "evidence",
+    "templates",
+    "test",
+    "docs",
+  ];
   const allFiles = {};
 
   for (const dir of scanDirs) {
@@ -133,23 +152,35 @@ export function generateManifest(claimsPath, opts = {}) {
   // Root-level scripts/configs
   try {
     for (const entry of readdirSync(root)) {
-      if (entry.startsWith('.') || entry === 'node_modules') continue;
+      if (entry.startsWith(".") || entry === "node_modules") continue;
       const full = join(root, entry);
       try {
         if (statSync(full).isFile()) {
           const type = classifyFile(entry);
-          if (type !== 'other') {
+          if (type !== "other") {
             allFiles[entry] = { topics: [], type };
           }
         }
-      } catch { /* skip */ }
+      } catch {
+        /* skip */
+      }
     }
-  } catch { /* skip */ }
+  } catch {
+    /* skip */
+  }
 
   // 3. Map files to topics via claim artifacts
   for (const [filePath, fileInfo] of Object.entries(allFiles)) {
     for (const claim of claims.claims) {
-      if (claim.source?.artifact && filePath.includes(claim.source.artifact.replace(/^.*[/\\]prototypes[/\\]/, 'prototypes/'))) {
+      if (
+        claim.source?.artifact &&
+        filePath.includes(
+          claim.source.artifact.replace(
+            /^.*[/\\]prototypes[/\\]/,
+            "prototypes/",
+          ),
+        )
+      ) {
         if (!fileInfo.topics.includes(claim.topic)) {
           fileInfo.topics.push(claim.topic);
         }
@@ -171,10 +202,10 @@ export function generateManifest(claimsPath, opts = {}) {
   // 5. Detect sprints
   const sprintResult = detectSprints(root);
   const sprints = {};
-  for (const s of (sprintResult.sprints || [])) {
+  for (const s of sprintResult.sprints || []) {
     sprints[s.name] = {
-      question: s.question || '',
-      phase: s.phase || 'unknown',
+      question: s.question || "",
+      phase: s.phase || "unknown",
       claims_count: s.claims_count || 0,
       active_claims: s.active_claims || 0,
       path: s.path,
@@ -193,9 +224,9 @@ export function generateManifest(claimsPath, opts = {}) {
   }
 
   return {
-    schema_version: '1.0',
+    schema_version: "1.0",
     generated: new Date().toISOString(),
-    generator: '@grainulation/barn generate-manifest',
+    generator: "@grainulation/barn generate-manifest",
     claims_hash: compilation?.claims_hash || null,
     topics: topicMap,
     sprints,
@@ -206,9 +237,11 @@ export function generateManifest(claimsPath, opts = {}) {
 // ─── CLI ─────────────────────────────────────────────────────────────────────
 
 // Only run CLI logic when executed directly (not imported)
-const isMain = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+const isMain =
+  process.argv[1] &&
+  resolve(process.argv[1]) === fileURLToPath(import.meta.url);
 if (isMain) {
-  if (args.includes('--help') || args.includes('-h')) {
+  if (args.includes("--help") || args.includes("-h")) {
     console.log(`generate-manifest — build wheat-manifest.json topic map
 
 Usage:
@@ -222,9 +255,9 @@ that gives AI tools a single file describing the sprint state.`);
   }
 
   const t0 = performance.now();
-  const manifest = generateManifest(join(ROOT, 'claims.json'), { root: ROOT });
+  const manifest = generateManifest(join(ROOT, "claims.json"), { root: ROOT });
 
-  writeFileSync(OUT_PATH, JSON.stringify(manifest, null, 2) + '\n');
+  writeFileSync(OUT_PATH, JSON.stringify(manifest, null, 2) + "\n");
   const elapsed = (performance.now() - t0).toFixed(1);
 
   const topicCount = Object.keys(manifest.topics).length;
@@ -233,5 +266,7 @@ that gives AI tools a single file describing the sprint state.`);
   const sizeBytes = Buffer.byteLength(JSON.stringify(manifest, null, 2));
 
   console.log(`wheat-manifest.json generated in ${elapsed}ms`);
-  console.log(`  Topics: ${topicCount}  |  Files: ${fileCount}  |  Sprints: ${sprintCount}  |  Size: ${(sizeBytes / 1024).toFixed(1)}KB`);
+  console.log(
+    `  Topics: ${topicCount}  |  Files: ${fileCount}  |  Sprints: ${sprintCount}  |  Size: ${(sizeBytes / 1024).toFixed(1)}KB`,
+  );
 }