@grainulation/grainulation 1.0.1 → 1.1.0

package/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@grainulation/grainulation"><img src="https://img.shields.io/npm/v/@grainulation/grainulation" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@grainulation/grainulation"><img src="https://img.shields.io/npm/v/@grainulation/grainulation?label=%40grainulation%2Fgrainulation" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/@grainulation/grainulation"><img src="https://img.shields.io/npm/dm/@grainulation/grainulation" alt="npm downloads"></a>
   <a href="https://github.com/grainulation/grainulation/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/@grainulation/grainulation" alt="node"></a>

package/bin/grainulation.js

@@ -14,38 +14,37 @@
  *   grainulation <tool> [args]    Delegate to a grainulation tool
  */
 
-const verbose =
-  process.argv.includes("--verbose") || process.argv.includes("-v");
-const jsonMode = process.argv.includes("--json");
+const verbose = process.argv.includes('--verbose') || process.argv.includes('-v');
+const jsonMode = process.argv.includes('--json');
 function vlog(...a) {
   if (!verbose) return;
   const ts = new Date().toISOString();
-  process.stderr.write(`[${ts}] grainulation: ${a.join(" ")}\n`);
+  process.stderr.write(`[${ts}] grainulation: ${a.join(' ')}\n`);
 }
 
 const command = process.argv[2];
-vlog("startup", `command=${command || "(none)"}`, `cwd=${process.cwd()}`);
+vlog('startup', `command=${command || '(none)'}`, `cwd=${process.cwd()}`);
 
 // Serve command — start the HTTP server (ESM module)
-if (command === "serve") {
-  const path = require("node:path");
-  const { spawn } = require("node:child_process");
-  const serverPath = path.join(__dirname, "..", "lib", "server.mjs");
+if (command === 'serve') {
+  const path = require('node:path');
+  const { spawn } = require('node:child_process');
+  const serverPath = path.join(__dirname, '..', 'lib', 'server.mjs');
 
   // Forward remaining args to the server
   const serverArgs = process.argv.slice(3);
   const child = spawn(process.execPath, [serverPath, ...serverArgs], {
-    stdio: "inherit",
+    stdio: 'inherit',
   });
 
-  child.on("close", (code) => process.exit(code ?? 0));
-  child.on("error", (err) => {
+  child.on('close', (code) => process.exit(code ?? 0));
+  child.on('error', (err) => {
     console.error(`grainulation: failed to start server: ${err.message}`);
     process.exit(1);
   });
 } else {
-  const { route } = require("../lib/router");
+  const { route } = require('../lib/router');
   // Strip --json from args before routing (it's handled as a mode flag)
-  const args = process.argv.slice(2).filter((a) => a !== "--json");
+  const args = process.argv.slice(2).filter((a) => a !== '--json');
   route(args, { json: jsonMode });
 }

package/lib/doctor.js

@@ -1,7 +1,7 @@
-const { execSync } = require("node:child_process");
-const { existsSync } = require("node:fs");
-const path = require("node:path");
-const { getInstallable } = require("./ecosystem");
+const { execSync } = require('node:child_process');
+const { existsSync } = require('node:fs');
+const path = require('node:path');
+const { getInstallable } = require('./ecosystem');
 
 /**
  * Health check.
@@ -18,12 +18,12 @@ const { getInstallable } = require("./ecosystem");
 function checkGlobal(packageName) {
   try {
     const out = execSync(`npm list -g ${packageName} --depth=0 2>/dev/null`, {
-      stdio: "pipe",
-      encoding: "utf-8",
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     });
     const match = out.match(new RegExp(`${escapeRegex(packageName)}@(\\S+)`));
-    return match ? { version: match[1], method: "global" } : null;
+    return match ? { version: match[1], method: 'global' } : null;
   } catch {
     return null;
   }
@@ -35,34 +35,26 @@ function checkGlobal(packageName) {
  */
 function checkNpxCache(packageName) {
   try {
-    const prefix = execSync("npm config get cache", {
-      stdio: "pipe",
-      encoding: "utf-8",
+    const prefix = execSync('npm config get cache', {
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     }).trim();
-    const npxDir = path.join(prefix, "_npx");
+    const npxDir = path.join(prefix, '_npx');
     if (!existsSync(npxDir)) return null;
 
     // npx cache has hash-named directories, each with node_modules
-    const { readdirSync } = require("node:fs");
+    const { readdirSync } = require('node:fs');
     const entries = readdirSync(npxDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      const pkgJson = path.join(
-        npxDir,
-        entry.name,
-        "node_modules",
-        packageName,
-        "package.json",
-      );
+      const pkgJson = path.join(npxDir, entry.name, 'node_modules', packageName, 'package.json');
       if (existsSync(pkgJson)) {
         try {
-          const pkg = JSON.parse(
-            require("node:fs").readFileSync(pkgJson, "utf-8"),
-          );
-          return { version: pkg.version || "installed", method: "npx cache" };
+          const pkg = JSON.parse(require('node:fs').readFileSync(pkgJson, 'utf-8'));
+          return { version: pkg.version || 'installed', method: 'npx cache' };
         } catch {
-          return { version: "installed", method: "npx cache" };
+          return { version: 'installed', method: 'npx cache' };
         }
       }
     }
@@ -78,15 +70,10 @@ function checkNpxCache(packageName) {
  */
 function checkLocal(packageName) {
   try {
-    const pkgJson = path.join(
-      process.cwd(),
-      "node_modules",
-      packageName,
-      "package.json",
-    );
+    const pkgJson = path.join(process.cwd(), 'node_modules', packageName, 'package.json');
     if (existsSync(pkgJson)) {
-      const pkg = JSON.parse(require("node:fs").readFileSync(pkgJson, "utf-8"));
-      return { version: pkg.version || "installed", method: "local" };
+      const pkg = JSON.parse(require('node:fs').readFileSync(pkgJson, 'utf-8'));
+      return { version: pkg.version || 'installed', method: 'local' };
     }
     return null;
   } catch {
@@ -102,27 +89,18 @@ function checkLocal(packageName) {
 function checkSource(packageName) {
   const candidates = [
     // Sibling directory (monorepo or co-located checkouts)
-    path.join(process.cwd(), "..", packageName.replace(/^@[^/]+\//, "")),
-    path.join(
-      process.cwd(),
-      "..",
-      packageName.replace(/^@[^/]+\//, ""),
-      "package.json",
-    ),
+    path.join(process.cwd(), '..', packageName.replace(/^@[^/]+\//, '')),
+    path.join(process.cwd(), '..', packageName.replace(/^@[^/]+\//, ''), 'package.json'),
     // Packages dir (monorepo)
-    path.join(process.cwd(), "packages", packageName.replace(/^@[^/]+\//, "")),
+    path.join(process.cwd(), 'packages', packageName.replace(/^@[^/]+\//, '')),
   ];
   for (const candidate of candidates) {
-    const pkgJson = candidate.endsWith("package.json")
-      ? candidate
-      : path.join(candidate, "package.json");
+    const pkgJson = candidate.endsWith('package.json') ? candidate : path.join(candidate, 'package.json');
     if (existsSync(pkgJson)) {
       try {
-        const pkg = JSON.parse(
-          require("node:fs").readFileSync(pkgJson, "utf-8"),
-        );
+        const pkg = JSON.parse(require('node:fs').readFileSync(pkgJson, 'utf-8'));
         if (pkg.name === packageName) {
-          return { version: pkg.version || "installed", method: "source" };
+          return { version: pkg.version || 'installed', method: 'source' };
         }
       } catch {
         // not a match, continue
@@ -139,24 +117,21 @@ function checkSource(packageName) {
  */
 function checkNpxNoInstall(packageName) {
   try {
-    const out = execSync(
-      `npx --no-install ${packageName} --version 2>/dev/null`,
-      {
-        stdio: "pipe",
-        encoding: "utf-8",
-        timeout: 5000,
-      },
-    ).trim();
+    const out = execSync(`npx --no-install ${packageName} --version 2>/dev/null`, {
+      stdio: 'pipe',
+      encoding: 'utf-8',
+      timeout: 5000,
+    }).trim();
     // Expect a version-like string
     const match = out.match(/v?(\d+\.\d+\.\d+\S*)/);
-    return match ? { version: match[1], method: "npx" } : null;
+    return match ? { version: match[1], method: 'npx' } : null;
   } catch {
     return null;
   }
 }
 
 function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
 /**
@@ -188,21 +163,21 @@ function getNodeVersion() {
 
 function getNpmVersion() {
   try {
-    return execSync("npm --version", {
-      stdio: "pipe",
-      encoding: "utf-8",
+    return execSync('npm --version', {
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     }).trim();
   } catch {
-    return "not found";
+    return 'not found';
   }
 }
 
 function getPnpmVersion() {
   try {
-    return execSync("pnpm --version", {
-      stdio: "pipe",
-      encoding: "utf-8",
+    return execSync('pnpm --version', {
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     }).trim();
   } catch {
@@ -212,9 +187,9 @@ function getPnpmVersion() {
 
 function getBiomeVersion() {
   try {
-    const out = execSync("npx biome --version", {
-      stdio: "pipe",
-      encoding: "utf-8",
+    const out = execSync('npx biome --version', {
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     }).trim();
     const match = out.match(/(\d+\.\d+\.\d+\S*)/);
@@ -226,9 +201,9 @@ function getBiomeVersion() {
 
 function getHooksPath() {
   try {
-    return execSync("git config core.hooksPath", {
-      stdio: "pipe",
-      encoding: "utf-8",
+    return execSync('git config core.hooksPath', {
+      stdio: 'pipe',
+      encoding: 'utf-8',
       timeout: 5000,
     }).trim();
   } catch {
@@ -237,7 +212,7 @@ function getHooksPath() {
 }
 
 function run(opts) {
-  const json = opts && opts.json;
+  const json = opts?.json;
   const tools = getInstallable();
 
   const pnpmVersion = getPnpmVersion();
@@ -276,76 +251,64 @@ function run(opts) {
   let installed = 0;
   let missing = 0;
 
-  console.log("");
-  console.log("  \x1b[1;33mgrainulation doctor\x1b[0m");
-  console.log("  Checking ecosystem health...");
-  console.log("");
+  console.log('');
+  console.log('  \x1b[1;33mgrainulation doctor\x1b[0m');
+  console.log('  Checking ecosystem health...');
+  console.log('');
 
   // Environment
-  console.log("  \x1b[2mEnvironment:\x1b[0m");
+  console.log('  \x1b[2mEnvironment:\x1b[0m');
   console.log(`    Node     ${getNodeVersion()}`);
   console.log(`    npm      v${getNpmVersion()}`);
   if (pnpmVersion) {
     console.log(`    pnpm     v${pnpmVersion}`);
   } else {
-    console.log("    pnpm     \x1b[2mnot found\x1b[0m");
+    console.log('    pnpm     \x1b[2mnot found\x1b[0m');
   }
-  console.log("");
+  console.log('');
 
   // DX tooling
-  console.log("  \x1b[2mDX tooling:\x1b[0m");
+  console.log('  \x1b[2mDX tooling:\x1b[0m');
   if (biomeVersion) {
     console.log(`    \x1b[32m\u2713\x1b[0m Biome     v${biomeVersion}`);
   } else {
-    console.log(
-      "    \x1b[2m\u2717 Biome     not found (pnpm install to set up)\x1b[0m",
-    );
+    console.log('    \x1b[2m\u2717 Biome     not found (pnpm install to set up)\x1b[0m');
   }
   if (hooksPath) {
     console.log(`    \x1b[32m\u2713\x1b[0m Git hooks  ${hooksPath}`);
   } else {
-    console.log(
-      "    \x1b[2m\u2717 Git hooks  not configured (run: git config core.hooksPath .githooks)\x1b[0m",
-    );
+    console.log('    \x1b[2m\u2717 Git hooks  not configured (run: git config core.hooksPath .githooks)\x1b[0m');
   }
-  console.log("");
+  console.log('');
 
   // Tools
-  console.log("  \x1b[2mTools:\x1b[0m");
+  console.log('  \x1b[2mTools:\x1b[0m');
   for (const tool of tools) {
     const result = detect(tool.package);
     if (result) {
       installed++;
       const ver = `v${result.version}`.padEnd(10);
-      console.log(
-        `    \x1b[32m\u2713\x1b[0m ${tool.name.padEnd(12)} ${ver} \x1b[2m(${result.method})\x1b[0m`,
-      );
+      console.log(`    \x1b[32m\u2713\x1b[0m ${tool.name.padEnd(12)} ${ver} \x1b[2m(${result.method})\x1b[0m`);
     } else {
       missing++;
-      console.log(
-        `    \x1b[2m\u2717 ${tool.name.padEnd(12)} --          (not found)\x1b[0m`,
-      );
+      console.log(`    \x1b[2m\u2717 ${tool.name.padEnd(12)} --          (not found)\x1b[0m`);
     }
   }
 
-  console.log("");
+  console.log('');
 
   // Summary
   if (missing === tools.length) {
-    console.log("  \x1b[33mNo grainulation tools found.\x1b[0m");
-    console.log("  Start with: npx @grainulation/wheat init");
+    console.log('  \x1b[33mNo grainulation tools found.\x1b[0m');
+    console.log('  Start with: npx @grainulation/wheat init');
   } else if (missing > 0) {
-    console.log(
-      `  \x1b[32m${installed} found\x1b[0m, \x1b[2m${missing} not found\x1b[0m`,
-    );
-    console.log(
-      "  Run \x1b[1mgrainulation setup\x1b[0m to install what you need.",
-    );
+    console.log(`  \x1b[32m${installed} found\x1b[0m, \x1b[2m${missing} not found\x1b[0m`);
+    console.log('  Run \x1b[1mgrainulation setup\x1b[0m to install what you need.');
   } else {
-    console.log("  \x1b[32mAll tools found. Full ecosystem ready.\x1b[0m");
+    console.log('  \x1b[32mAll tools found. Full ecosystem ready.\x1b[0m');
   }
 
-  console.log("");
+  console.log('');
 }
 
 module.exports = {

package/lib/ecosystem.js

@@ -7,99 +7,91 @@
 
 const TOOLS = [
   {
-    name: "wheat",
-    package: "@grainulation/wheat",
-    icon: "W",
-    role: "Grows evidence",
-    description:
-      "Research sprint engine. Ask a question, grow claims, compile a brief.",
-    category: "core",
+    name: 'wheat',
+    package: '@grainulation/wheat',
+    icon: 'W',
+    role: 'Grows evidence',
+    description: 'Research sprint engine. Ask a question, grow claims, compile a brief.',
+    category: 'core',
     port: 9091,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: true,
   },
   {
-    name: "farmer",
-    package: "@grainulation/farmer",
-    icon: "F",
-    role: "Permission dashboard",
-    description:
-      "Permission dashboard. Approve tool calls, review AI actions in real time.",
-    category: "core",
+    name: 'farmer',
+    package: '@grainulation/farmer',
+    icon: 'F',
+    role: 'Permission dashboard',
+    description: 'Permission dashboard. Approve tool calls, review AI actions in real time.',
+    category: 'core',
     port: 9090,
-    serveCmd: ["start"],
+    serveCmd: ['start'],
     entryPoint: false,
   },
   {
-    name: "barn",
-    package: "@grainulation/barn",
-    icon: "B",
-    role: "Shared tools",
-    description:
-      "Public utilities. Claim schemas, HTML templates, shared validators.",
-    category: "foundation",
+    name: 'barn',
+    package: '@grainulation/barn',
+    icon: 'B',
+    role: 'Shared tools',
+    description: 'Public utilities. Claim schemas, HTML templates, shared validators.',
+    category: 'foundation',
     port: 9093,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
   {
-    name: "mill",
-    package: "@grainulation/mill",
-    icon: "M",
-    role: "Processes output",
-    description:
-      "Export and publish. Turn compiled research into PDFs, slides, wikis.",
-    category: "output",
+    name: 'mill',
+    package: '@grainulation/mill',
+    icon: 'M',
+    role: 'Processes output',
+    description: 'Export and publish. Turn compiled research into PDFs, slides, wikis.',
+    category: 'output',
     port: 9094,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
   {
-    name: "silo",
-    package: "@grainulation/silo",
-    icon: "S",
-    role: "Stores knowledge",
-    description:
-      "Reusable claim libraries. Share vetted claims across sprints and teams.",
-    category: "storage",
+    name: 'silo',
+    package: '@grainulation/silo',
+    icon: 'S',
+    role: 'Stores knowledge',
+    description: 'Reusable claim libraries. Share vetted claims across sprints and teams.',
+    category: 'storage',
     port: 9095,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
   {
-    name: "harvest",
-    package: "@grainulation/harvest",
-    icon: "H",
-    role: "Analytics & retrospectives",
-    description:
-      "Cross-sprint learning. Track prediction accuracy, find blind spots over time.",
-    category: "analytics",
+    name: 'harvest',
+    package: '@grainulation/harvest',
+    icon: 'H',
+    role: 'Analytics & retrospectives',
+    description: 'Cross-sprint learning. Track prediction accuracy, find blind spots over time.',
+    category: 'analytics',
     port: 9096,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
   {
-    name: "orchard",
-    package: "@grainulation/orchard",
-    icon: "O",
-    role: "Orchestration",
-    description:
-      "Multi-sprint coordination. Run parallel research tracks, merge results.",
-    category: "orchestration",
+    name: 'orchard',
+    package: '@grainulation/orchard',
+    icon: 'O',
+    role: 'Orchestration',
+    description: 'Multi-sprint coordination. Run parallel research tracks, merge results.',
+    category: 'orchestration',
     port: 9097,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
   {
-    name: "grainulation",
-    package: "@grainulation/grainulation",
-    icon: "G",
-    role: "The machine",
-    description:
-      "Process manager and ecosystem hub. Start, stop, and monitor all tools.",
-    category: "meta",
+    name: 'grainulation',
+    package: '@grainulation/grainulation',
+    icon: 'G',
+    role: 'The machine',
+    description: 'Process manager and ecosystem hub. Start, stop, and monitor all tools.',
+    category: 'meta',
     port: 9098,
-    serveCmd: ["serve"],
+    serveCmd: ['serve'],
     entryPoint: false,
   },
 ];
@@ -113,7 +105,7 @@ function getByName(name) {
 }
 
 function getInstallable() {
-  return TOOLS.filter((t) => t.name !== "grainulation");
+  return TOOLS.filter((t) => t.name !== 'grainulation');
 }
 
 function getCategories() {