@grainulation/grainulation 1.0.0 → 1.0.1

package/lib/ecosystem.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * The grainulation ecosystem registry.
  *
@@ -9,91 +7,99 @@
 
 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,
   },
 ];
@@ -107,7 +113,7 @@ function getByName(name) {
 }
 
 function getInstallable() {
-  return TOOLS.filter((t) => t.name !== 'grainulation');
+  return TOOLS.filter((t) => t.name !== "grainulation");
 }
 
 function getCategories() {

package/lib/pm.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Process Manager — start, stop, and monitor grainulation tools.
  *
@@ -7,19 +5,28 @@
  * This module spawns/kills them and probes ports for health.
  */
 
-const { spawn, execSync } = require('node:child_process');
-const { existsSync, readFileSync, writeFileSync, mkdirSync } = require('node:fs');
-const { join } = require('node:path');
-const http = require('node:http');
-const { getAll, getByName, getInstallable } = require('./ecosystem');
+const { spawn, execSync } = require("node:child_process");
+const {
+  existsSync,
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+} = require("node:fs");
+const { join } = require("node:path");
+const http = require("node:http");
+const { getAll, getByName, getInstallable } = require("./ecosystem");
 
 // PID tracking directory
-const PM_DIR = join(require('node:os').homedir(), '.grainulation');
-const PID_DIR = join(PM_DIR, 'pids');
-const CONFIG_FILE = join(PM_DIR, 'config.json');
+const PM_DIR = join(require("node:os").homedir(), ".grainulation");
+const PID_DIR = join(PM_DIR, "pids");
+const CONFIG_FILE = join(PM_DIR, "config.json");
 
 function loadConfig() {
-  try { return JSON.parse(readFileSync(CONFIG_FILE, 'utf8')); } catch { return {}; }
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+  } catch {
+    return {};
+  }
 }
 
 function ensureDirs() {
@@ -35,7 +42,7 @@ function readPid(toolName) {
   const f = pidFile(toolName);
   if (!existsSync(f)) return null;
   try {
-    const pid = parseInt(readFileSync(f, 'utf8').trim(), 10);
+    const pid = parseInt(readFileSync(f, "utf8").trim(), 10);
     if (isNaN(pid)) return null;
     // Check if process is alive
     process.kill(pid, 0);
@@ -52,7 +59,9 @@ function writePid(toolName, pid) {
 
 function removePid(toolName) {
   const f = pidFile(toolName);
-  try { require('node:fs').unlinkSync(f); } catch {}
+  try {
+    require("node:fs").unlinkSync(f);
+  } catch {}
 }
 
 /**
@@ -62,14 +71,20 @@ function removePid(toolName) {
 function probe(port, timeoutMs = 2000) {
   return new Promise((resolve) => {
     const start = Date.now();
-    const req = http.get({ hostname: '127.0.0.1', port, path: '/health', timeout: timeoutMs }, (res) => {
-      const latencyMs = Date.now() - start;
-      // Consume body
-      res.resume();
-      resolve({ alive: true, statusCode: res.statusCode, latencyMs });
+    const req = http.get(
+      { hostname: "127.0.0.1", port, path: "/health", timeout: timeoutMs },
+      (res) => {
+        const latencyMs = Date.now() - start;
+        // Consume body
+        res.resume();
+        resolve({ alive: true, statusCode: res.statusCode, latencyMs });
+      },
+    );
+    req.on("error", () => resolve({ alive: false }));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve({ alive: false });
     });
-    req.on('error', () => resolve({ alive: false }));
-    req.on('timeout', () => { req.destroy(); resolve({ alive: false }); });
   });
 }
 
@@ -77,27 +92,29 @@ function probe(port, timeoutMs = 2000) {
  * Find the bin path for a tool — prefers source checkout, falls back to npx.
  */
 function findBin(tool) {
-  const shortName = tool.package.replace(/^@[^/]+\//, '');
+  const shortName = tool.package.replace(/^@[^/]+\//, "");
   const candidates = [
-    join(__dirname, '..', '..', shortName),
-    join(process.cwd(), '..', shortName),
+    join(__dirname, "..", "..", shortName),
+    join(process.cwd(), "..", shortName),
   ];
   for (const dir of candidates) {
     try {
-      const pkgPath = join(dir, 'package.json');
+      const pkgPath = join(dir, "package.json");
       if (!existsSync(pkgPath)) continue;
-      const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
       if (pkg.name !== tool.package) continue;
       if (pkg.bin) {
-        const binFile = typeof pkg.bin === 'string' ? pkg.bin : Object.values(pkg.bin)[0];
+        const binFile =
+          typeof pkg.bin === "string" ? pkg.bin : Object.values(pkg.bin)[0];
         if (binFile) {
-          const binPath = require('node:path').resolve(dir, binFile);
-          if (existsSync(binPath)) return { cmd: process.execPath, args: [binPath] };
+          const binPath = require("node:path").resolve(dir, binFile);
+          if (existsSync(binPath))
+            return { cmd: process.execPath, args: [binPath] };
         }
       }
     } catch {}
   }
-  return { cmd: 'npx', args: [tool.package], shell: true };
+  return { cmd: "npx", args: [tool.package], shell: true };
 }
 
 /**
@@ -106,7 +123,8 @@ function findBin(tool) {
 function startTool(toolName, extraArgs = []) {
   const tool = getByName(toolName);
   if (!tool) throw new Error(`Unknown tool: ${toolName}`);
-  if (toolName === 'grainulation') throw new Error('Use "grainulation serve" directly');
+  if (toolName === "grainulation")
+    throw new Error('Use "grainulation serve" directly');
 
   // Check if already running
   const existing = readPid(toolName);
@@ -115,18 +133,26 @@ function startTool(toolName, extraArgs = []) {
   }
 
   // Auto-inject --root and --dir from config if not explicitly provided
-  const hasRoot = extraArgs.includes('--root') || extraArgs.includes('--dir');
+  const hasRoot = extraArgs.includes("--root") || extraArgs.includes("--dir");
   let rootArgs = [];
   if (!hasRoot) {
     const cfg = loadConfig();
-    if (cfg.sprintRoot) rootArgs = ['--root', cfg.sprintRoot, '--dir', cfg.sprintRoot];
+    if (cfg.sprintRoot)
+      rootArgs = ["--root", cfg.sprintRoot, "--dir", cfg.sprintRoot];
   }
 
   const bin = findBin(tool);
-  const args = [...bin.args, ...tool.serveCmd, '--port', String(tool.port), ...rootArgs, ...extraArgs];
+  const args = [
+    ...bin.args,
+    ...tool.serveCmd,
+    "--port",
+    String(tool.port),
+    ...rootArgs,
+    ...extraArgs,
+  ];
 
   const child = spawn(bin.cmd, args, {
-    stdio: 'ignore',
+    stdio: "ignore",
     detached: true,
     shell: bin.shell || false,
   });
@@ -143,10 +169,18 @@ function startTool(toolName, extraArgs = []) {
  */
 function findPidByPort(port) {
   try {
-    const out = execSync(`lsof -ti :${port}`, { timeout: 3000, stdio: ['ignore', 'pipe', 'pipe'] });
-    const pids = out.toString().trim().split('\n').map(s => parseInt(s, 10)).filter(n => !isNaN(n) && n > 0);
+    const out = execSync(`lsof -ti :${port}`, {
+      timeout: 3000,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    const pids = out
+      .toString()
+      .trim()
+      .split("\n")
+      .map((s) => parseInt(s, 10))
+      .filter((n) => !isNaN(n) && n > 0);
     // Return the first PID that isn't our own process
-    return pids.find(p => p !== process.pid) || null;
+    return pids.find((p) => p !== process.pid) || null;
   } catch {
     return null;
   }
@@ -163,16 +197,16 @@ function stopTool(toolName) {
   if (!pid) {
     const tool = getByName(toolName);
     if (tool) pid = findPidByPort(tool.port);
-    if (!pid) return { stopped: false, reason: 'not running' };
+    if (!pid) return { stopped: false, reason: "not running" };
   }
 
   try {
-    process.kill(pid, 'SIGTERM');
+    process.kill(pid, "SIGTERM");
     removePid(toolName);
     return { stopped: true, pid };
   } catch {
     removePid(toolName);
-    return { stopped: false, reason: 'process already dead' };
+    return { stopped: false, reason: "process already dead" };
   }
 }
 
@@ -181,19 +215,21 @@ function stopTool(toolName) {
  */
 async function ps() {
   const tools = getInstallable();
-  const results = await Promise.all(tools.map(async (tool) => {
-    const pid = readPid(tool.name);
-    const health = await probe(tool.port);
-    return {
-      name: tool.name,
-      port: tool.port,
-      role: tool.role,
-      pid: pid || null,
-      alive: health.alive,
-      latencyMs: health.latencyMs || null,
-      statusCode: health.statusCode || null,
-    };
-  }));
+  const results = await Promise.all(
+    tools.map(async (tool) => {
+      const pid = readPid(tool.name);
+      const health = await probe(tool.port);
+      return {
+        name: tool.name,
+        port: tool.port,
+        role: tool.role,
+        pid: pid || null,
+        alive: health.alive,
+        latencyMs: health.latencyMs || null,
+        statusCode: health.statusCode || null,
+      };
+    }),
+  );
   return results;
 }
 
@@ -202,9 +238,13 @@ async function ps() {
  * 'all' starts everything except grainulation itself.
  */
 function up(toolNames, extraArgs = []) {
-  const defaults = ['farmer', 'wheat'];
-  const names = (!toolNames || toolNames.length === 0) ? defaults :
-    (toolNames[0] === 'all' ? getInstallable().map(t => t.name) : toolNames);
+  const defaults = ["farmer", "wheat"];
+  const names =
+    !toolNames || toolNames.length === 0
+      ? defaults
+      : toolNames[0] === "all"
+        ? getInstallable().map((t) => t.name)
+        : toolNames;
 
   const results = [];
   for (const name of names) {
@@ -222,9 +262,10 @@ function up(toolNames, extraArgs = []) {
  * Stop multiple tools. Default: stop all running.
  */
 function down(toolNames) {
-  const names = (!toolNames || toolNames.length === 0)
-    ? getInstallable().map(t => t.name)
-    : toolNames;
+  const names =
+    !toolNames || toolNames.length === 0
+      ? getInstallable().map((t) => t.name)
+      : toolNames;
 
   const results = [];
   for (const name of names) {