@grainulation/grainulation 1.0.0 → 1.0.1

package/lib/server.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+
 /**
  * grainulation serve — local HTTP server for the ecosystem control center
  *
@@ -10,12 +11,21 @@
  *   grainulation serve [--port 9098]
  */
 
-import { createServer } from 'node:http';
-import { readFileSync, existsSync, readdirSync, statSync, mkdirSync, writeFileSync, renameSync, watchFile } from 'node:fs';
-import { join, resolve, extname, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  statSync,
+  watchFile,
+  writeFileSync,
+} from 'node:fs';
+import { createServer } from 'node:http';
 import { createRequire } from 'node:module';
+import { dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
@@ -72,19 +82,75 @@ const ROUTES = [
 // ── Tool registry ─────────────────────────────────────────────────────────────
 
 const TOOLS = [
-  { name: 'wheat',       pkg: '@grainulation/wheat',       port: 9091, accent: '#fbbf24', role: 'Research sprint engine', category: 'core' },
-  { name: 'farmer',      pkg: '@grainulation/farmer',      port: 9090, accent: '#3b82f6', role: 'Permission dashboard', category: 'core' },
-  { name: 'barn',        pkg: '@grainulation/barn',        port: 9093, accent: '#f43f5e', role: 'Design system & templates', category: 'foundation' },
-  { name: 'mill',        pkg: '@grainulation/mill',        port: 9094, accent: '#a78bfa', role: 'Export & publish engine', category: 'output' },
-  { name: 'silo',        pkg: '@grainulation/silo',        port: 9095, accent: '#6ee7b7', role: 'Reusable claim libraries', category: 'storage' },
-  { name: 'harvest',     pkg: '@grainulation/harvest',     port: 9096, accent: '#fb923c', role: 'Analytics & retrospectives', category: 'analytics' },
-  { name: 'orchard',     pkg: '@grainulation/orchard',     port: 9097, accent: '#14b8a6', role: 'Multi-sprint orchestrator', category: 'orchestration' },
-  { name: 'grainulation', pkg: '@grainulation/grainulation', port: 9098, accent: '#9ca3af', role: 'Ecosystem entry point', category: 'meta' },
+  {
+    name: 'wheat',
+    pkg: '@grainulation/wheat',
+    port: 9091,
+    accent: '#fbbf24',
+    role: 'Research sprint engine',
+    category: 'core',
+  },
+  {
+    name: 'farmer',
+    pkg: '@grainulation/farmer',
+    port: 9090,
+    accent: '#3b82f6',
+    role: 'Permission dashboard',
+    category: 'core',
+  },
+  {
+    name: 'barn',
+    pkg: '@grainulation/barn',
+    port: 9093,
+    accent: '#f43f5e',
+    role: 'Design system & templates',
+    category: 'foundation',
+  },
+  {
+    name: 'mill',
+    pkg: '@grainulation/mill',
+    port: 9094,
+    accent: '#a78bfa',
+    role: 'Export & publish engine',
+    category: 'output',
+  },
+  {
+    name: 'silo',
+    pkg: '@grainulation/silo',
+    port: 9095,
+    accent: '#6ee7b7',
+    role: 'Reusable claim libraries',
+    category: 'storage',
+  },
+  {
+    name: 'harvest',
+    pkg: '@grainulation/harvest',
+    port: 9096,
+    accent: '#fb923c',
+    role: 'Analytics & retrospectives',
+    category: 'analytics',
+  },
+  {
+    name: 'orchard',
+    pkg: '@grainulation/orchard',
+    port: 9097,
+    accent: '#14b8a6',
+    role: 'Multi-sprint orchestrator',
+    category: 'orchestration',
+  },
+  {
+    name: 'grainulation',
+    pkg: '@grainulation/grainulation',
+    port: 9098,
+    accent: '#9ca3af',
+    role: 'Ecosystem entry point',
+    category: 'meta',
+  },
 ];
 
 // ── State ─────────────────────────────────────────────────────────────────────
 
-let state = {
+const state = {
   ecosystem: [],
   doctorResults: null,
   lastCheck: null,
@@ -95,7 +161,11 @@ const sseClients = new Set();
 function broadcast(event) {
   const data = `data: ${JSON.stringify(event)}\n\n`;
   for (const res of sseClients) {
-    try { res.write(data); } catch { sseClients.delete(res); }
+    try {
+      res.write(data);
+    } catch {
+      sseClients.delete(res);
+    }
   }
 }
 
@@ -118,7 +188,9 @@ function detectTool(pkg) {
     const out = execSync(`npm list -g ${pkg} --depth=0 2>/dev/null`, { stdio: 'pipe', encoding: 'utf-8' });
     const match = out.match(new RegExp(escapeRegex(pkg) + '@(\\S+)'));
     if (match) return { installed: true, version: match[1], method: 'global' };
-  } catch { /* not found */ }
+  } catch {
+    /* not found */
+  }
 
   // 2. npx cache
   try {
@@ -139,7 +211,9 @@ function detectTool(pkg) {
         }
       }
     }
-  } catch { /* not found */ }
+  } catch {
+    /* not found */
+  }
 
   // 3. Local node_modules
   const localPkg = join(process.cwd(), 'node_modules', pkg, 'package.json');
@@ -147,7 +221,9 @@ function detectTool(pkg) {
     try {
       const p = JSON.parse(readFileSync(localPkg, 'utf8'));
       return { installed: true, version: p.version || 'installed', method: 'local' };
-    } catch { /* ignore */ }
+    } catch {
+      /* ignore */
+    }
   }
 
   // 4. Sibling source directory
@@ -159,7 +235,9 @@ function detectTool(pkg) {
       if (p.name === pkg) {
         return { installed: true, version: p.version || 'source', method: 'source' };
       }
-    } catch { /* ignore */ }
+    } catch {
+      /* ignore */
+    }
   }
 
   return { installed: false, version: null, method: null };
@@ -174,7 +252,9 @@ function runDoctor() {
   let npmVersion = 'unknown';
   try {
     npmVersion = execSync('npm --version', { stdio: 'pipe', encoding: 'utf-8' }).trim();
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
 
   const checks = [];
 
@@ -197,7 +277,7 @@ function runDoctor() {
   const toolStatuses = [];
   for (const tool of TOOLS) {
     const result = detectTool(tool.pkg);
-    const status = result.installed ? 'pass' : (tool.category === 'core' ? 'warning' : 'info');
+    const status = result.installed ? 'pass' : tool.category === 'core' ? 'warning' : 'info';
 
     checks.push({
       name: tool.name,
@@ -214,9 +294,9 @@ function runDoctor() {
     });
   }
 
-  const passCount = checks.filter(c => c.status === 'pass').length;
-  const warnCount = checks.filter(c => c.status === 'warning').length;
-  const failCount = checks.filter(c => c.status === 'fail').length;
+  const passCount = checks.filter((c) => c.status === 'pass').length;
+  const warnCount = checks.filter((c) => c.status === 'warning').length;
+  const failCount = checks.filter((c) => c.status === 'fail').length;
 
   return {
     checks,
@@ -231,7 +311,7 @@ function runDoctor() {
 // ── Ecosystem — aggregate status ──────────────────────────────────────────────
 
 function getEcosystem() {
-  return TOOLS.map(tool => {
+  return TOOLS.map((tool) => {
     const result = detectTool(tool.pkg);
     return {
       ...tool,
@@ -254,24 +334,37 @@ function scaffold(targetDir, options = {}) {
   mkdirSync(dir, { recursive: true });
 
   // claims.json (atomic write-then-rename)
-  const claimsData = JSON.stringify({
-    claims: [],
-    meta: { created: new Date().toISOString(), tool: 'grainulation' }
-  }, null, 2) + '\n';
+  const claimsData =
+    JSON.stringify(
+      {
+        claims: [],
+        meta: { created: new Date().toISOString(), tool: 'grainulation' },
+      },
+      null,
+      2,
+    ) + '\n';
   const tmpClaims = join(dir, 'claims.json.tmp.' + process.pid);
   writeFileSync(tmpClaims, claimsData);
   renameSync(tmpClaims, join(dir, 'claims.json'));
 
   // CLAUDE.md
   const question = options.question || 'What should we build?';
-  writeFileSync(join(dir, 'CLAUDE.md'), `# Sprint\n\n**Question:** ${question}\n\n**Constraints:**\n- (add constraints here)\n\n**Done looks like:** (describe the output)\n`);
+  writeFileSync(
+    join(dir, 'CLAUDE.md'),
+    `# Sprint\n\n**Question:** ${question}\n\n**Constraints:**\n- (add constraints here)\n\n**Done looks like:** (describe the output)\n`,
+  );
 
   // orchard.json (if multi-sprint, atomic write-then-rename)
   if (options.includeOrchard) {
-    const orchardData = JSON.stringify({
-      sprints: [],
-      settings: { sync_interval: 'manual' }
-    }, null, 2) + '\n';
+    const orchardData =
+      JSON.stringify(
+        {
+          sprints: [],
+          settings: { sync_interval: 'manual' },
+        },
+        null,
+        2,
+      ) + '\n';
     const tmpOrchard = join(dir, 'orchard.json.tmp.' + process.pid);
     writeFileSync(tmpOrchard, orchardData);
     renameSync(tmpOrchard, join(dir, 'orchard.json'));
@@ -310,10 +403,13 @@ function json(res, data, status = 200) {
 function readBody(req) {
   return new Promise((resolve, reject) => {
     const chunks = [];
-    req.on('data', c => chunks.push(c));
+    req.on('data', (c) => chunks.push(c));
     req.on('end', () => {
-      try { resolve(JSON.parse(Buffer.concat(chunks).toString())); }
-      catch { resolve({}); }
+      try {
+        resolve(JSON.parse(Buffer.concat(chunks).toString()));
+      } catch {
+        resolve({});
+      }
     });
     req.on('error', reject);
   });
@@ -347,7 +443,7 @@ table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1
 th{color:#9ca3af}code{background:#1e293b;padding:2px 6px;border-radius:4px;font-size:13px}</style></head>
 <body><h1>grainulation API</h1><p>${ROUTES.length} endpoints</p>
 <table><tr><th>Method</th><th>Path</th><th>Description</th></tr>
-${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</code></td><td>'+r.description+'</td></tr>').join('')}
+${ROUTES.map((r) => '<tr><td><code>' + r.method + '</code></td><td><code>' + r.path + '</code></td><td>' + r.description + '</td></tr>').join('')}
 </table></body></html>`;
     res.writeHead(200, { 'Content-Type': 'text/html' });
     res.end(html);
@@ -359,15 +455,23 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
     res.writeHead(200, {
       'Content-Type': 'text/event-stream',
       'Cache-Control': 'no-cache',
-      'Connection': 'keep-alive',
+      Connection: 'keep-alive',
     });
     res.write(`data: ${JSON.stringify({ type: 'state', data: state })}\n\n`);
     const heartbeat = setInterval(() => {
-      try { res.write(': heartbeat\n\n'); } catch { clearInterval(heartbeat); }
+      try {
+        res.write(': heartbeat\n\n');
+      } catch {
+        clearInterval(heartbeat);
+      }
     }, 15000);
     sseClients.add(res);
     vlog('sse', `client connected (${sseClients.size} total)`);
-    req.on('close', () => { clearInterval(heartbeat); sseClients.delete(res); vlog('sse', `client disconnected (${sseClients.size} total)`); });
+    req.on('close', () => {
+      clearInterval(heartbeat);
+      sseClients.delete(res);
+      vlog('sse', `client disconnected (${sseClients.size} total)`);
+    });
     return;
   }
 
@@ -388,7 +492,7 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
   // ── API: tool detail ──
   if (req.method === 'GET' && url.pathname.startsWith('/api/tools/')) {
     const name = url.pathname.split('/').pop();
-    const tool = state.ecosystem.find(t => t.name === name);
+    const tool = state.ecosystem.find((t) => t.name === name);
     if (!tool) {
       json(res, { error: 'Tool not found' }, 404);
       return;
@@ -401,9 +505,12 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
   if (req.method === 'POST' && url.pathname === '/api/pm/start') {
     const body = await readBody(req);
     const toolName = body.tool;
-    if (!toolName) { json(res, { error: 'Missing tool name' }, 400); return; }
+    if (!toolName) {
+      json(res, { error: 'Missing tool name' }, 400);
+      return;
+    }
     try {
-      const rootArgs = (body.root || SPRINT_ROOT) ? ['--root', resolve(body.root || SPRINT_ROOT)] : [];
+      const rootArgs = body.root || SPRINT_ROOT ? ['--root', resolve(body.root || SPRINT_ROOT)] : [];
       const result = pm.startTool(toolName, rootArgs);
       json(res, { ok: true, ...result });
       setTimeout(refreshState, 1500);
@@ -417,7 +524,10 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
   if (req.method === 'POST' && url.pathname === '/api/pm/stop') {
     const body = await readBody(req);
     const toolName = body.tool;
-    if (!toolName) { json(res, { error: 'Missing tool name' }, 400); return; }
+    if (!toolName) {
+      json(res, { error: 'Missing tool name' }, 400);
+      return;
+    }
     try {
       const result = pm.stopTool(toolName);
       json(res, { ok: true, ...result });
@@ -477,7 +587,7 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
   }
 
   // ── Static files ──
-  let filePath = url.pathname === '/' ? '/index.html' : url.pathname;
+  const filePath = url.pathname === '/' ? '/index.html' : url.pathname;
   const resolved = resolve(PUBLIC_DIR, '.' + filePath);
 
   if (!resolved.startsWith(PUBLIC_DIR)) {
@@ -488,7 +598,7 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
 
   if (existsSync(resolved) && statSync(resolved).isFile()) {
     const ext = extname(resolved);
-    let content = readFileSync(resolved);
+    const content = readFileSync(resolved);
     res.writeHead(200, { 'Content-Type': MIME[ext] || 'application/octet-stream' });
     res.end(content);
     return;
@@ -501,7 +611,11 @@ ${ROUTES.map(r => '<tr><td><code>'+r.method+'</code></td><td><code>'+r.path+'</c
 // ── Graceful shutdown ─────────────────────────────────────────────────────────
 const shutdown = (signal) => {
   console.log(`\ngrainulation: ${signal} received, shutting down...`);
-  for (const res of sseClients) { try { res.end(); } catch {} }
+  for (const res of sseClients) {
+    try {
+      res.end();
+    } catch {}
+  }
   sseClients.clear();
   server.close(() => process.exit(0));
   setTimeout(() => process.exit(1), 5000);
@@ -515,8 +629,10 @@ refreshState();
 
 server.listen(PORT, '127.0.0.1', () => {
   vlog('listen', `port=${PORT}`);
-  const installed = state.ecosystem.filter(t => t.installed).length;
+  const installed = state.ecosystem.filter((t) => t.installed).length;
   console.log(`grainulation: serving on http://localhost:${PORT}`);
   console.log(`  tools: ${installed}/${TOOLS.length} installed`);
-  console.log(`  doctor: ${state.doctorResults.summary.pass} pass, ${state.doctorResults.summary.warning} warn, ${state.doctorResults.summary.fail} fail`);
+  console.log(
+    `  doctor: ${state.doctorResults.summary.pass} pass, ${state.doctorResults.summary.warning} warn, ${state.doctorResults.summary.fail} fail`,
+  );
 });

package/lib/setup.js

@@ -1,9 +1,7 @@
-'use strict';
-
-const readline = require('node:readline');
-const { execSync } = require('node:child_process');
-const { getInstallable, getCategories } = require('./ecosystem');
-const { getVersion } = require('./doctor');
+const readline = require("node:readline");
+const { execSync } = require("node:child_process");
+const { getInstallable, getCategories } = require("./ecosystem");
+const { getVersion } = require("./doctor");
 
 /**
  * Interactive setup wizard.
@@ -14,24 +12,24 @@ const { getVersion } = require('./doctor');
 
 const ROLES = [
   {
-    name: 'Researcher',
-    description: 'Run research sprints, grow evidence, write briefs',
-    tools: ['wheat'],
+    name: "Researcher",
+    description: "Run research sprints, grow evidence, write briefs",
+    tools: ["wheat"],
   },
   {
-    name: 'Researcher + Dashboard',
-    description: 'Research sprints with real-time permission dashboard',
-    tools: ['wheat', 'farmer'],
+    name: "Researcher + Dashboard",
+    description: "Research sprints with real-time permission dashboard",
+    tools: ["wheat", "farmer"],
   },
   {
-    name: 'Team Lead',
-    description: 'Coordinate multiple sprints, review analytics',
-    tools: ['wheat', 'farmer', 'orchard', 'harvest'],
+    name: "Team Lead",
+    description: "Coordinate multiple sprints, review analytics",
+    tools: ["wheat", "farmer", "orchard", "harvest"],
   },
   {
-    name: 'Full Ecosystem',
-    description: 'Everything. All 7 tools.',
-    tools: ['wheat', 'farmer', 'barn', 'mill', 'silo', 'harvest', 'orchard'],
+    name: "Full Ecosystem",
+    description: "Everything. All 7 tools.",
+    tools: ["wheat", "farmer", "barn", "mill", "silo", "harvest", "orchard"],
   },
 ];
 
@@ -47,24 +45,24 @@ async function run() {
     output: process.stdout,
   });
 
-  console.log('');
-  console.log('  \x1b[1;33mgrainulation setup\x1b[0m');
-  console.log('  What are you trying to do?');
-  console.log('');
+  console.log("");
+  console.log("  \x1b[1;33mgrainulation setup\x1b[0m");
+  console.log("  What are you trying to do?");
+  console.log("");
 
   for (let i = 0; i < ROLES.length; i++) {
     const role = ROLES[i];
     console.log(`    \x1b[1m${i + 1}.\x1b[0m ${role.name}`);
     console.log(`       \x1b[2m${role.description}\x1b[0m`);
-    console.log(`       Tools: ${role.tools.join(', ')}`);
-    console.log('');
+    console.log(`       Tools: ${role.tools.join(", ")}`);
+    console.log("");
   }
 
-  const answer = await ask(rl, '  Choose (1-4): ');
+  const answer = await ask(rl, "  Choose (1-4): ");
   const choice = parseInt(answer, 10);
 
   if (choice < 1 || choice > ROLES.length || isNaN(choice)) {
-    console.log('\n  \x1b[31mInvalid choice.\x1b[0m\n');
+    console.log("\n  \x1b[31mInvalid choice.\x1b[0m\n");
     rl.close();
     return;
   }
@@ -72,9 +70,9 @@ async function run() {
   const role = ROLES[choice - 1];
   const toInstall = [];
 
-  console.log('');
+  console.log("");
   console.log(`  \x1b[1mSetting up: ${role.name}\x1b[0m`);
-  console.log('');
+  console.log("");
 
   for (const toolName of role.tools) {
     const tool = getInstallable().find((t) => t.name === toolName);
@@ -82,7 +80,9 @@ async function run() {
 
     const version = getVersion(tool.package);
     if (version) {
-      console.log(`    \x1b[32m\u2713\x1b[0m ${tool.name} already installed (${version})`);
+      console.log(
+        `    \x1b[32m\u2713\x1b[0m ${tool.name} already installed (${version})`,
+      );
     } else {
       toInstall.push(tool);
       console.log(`    \x1b[33m+\x1b[0m ${tool.name} will be installed`);
@@ -90,40 +90,44 @@ async function run() {
   }
 
   if (toInstall.length === 0) {
-    console.log('');
-    console.log('  \x1b[32mEverything is already installed.\x1b[0m');
-    console.log('  Run \x1b[1mnpx @grainulation/wheat init\x1b[0m to start a research sprint.');
+    console.log("");
+    console.log("  \x1b[32mEverything is already installed.\x1b[0m");
+    console.log(
+      "  Run \x1b[1mnpx @grainulation/wheat init\x1b[0m to start a research sprint.",
+    );
     rl.close();
     return;
   }
 
-  console.log('');
+  console.log("");
   const confirm = await ask(
     rl,
-    `  Install ${toInstall.length} package(s)? (y/N): `
+    `  Install ${toInstall.length} package(s)? (y/N): `,
   );
 
-  if (confirm.toLowerCase() !== 'y') {
-    console.log('\n  \x1b[2mAborted.\x1b[0m\n');
+  if (confirm.toLowerCase() !== "y") {
+    console.log("\n  \x1b[2mAborted.\x1b[0m\n");
     rl.close();
     return;
   }
 
-  console.log('');
+  console.log("");
   for (const tool of toInstall) {
     console.log(`  Installing ${tool.package}...`);
     try {
-      execSync(`npm install -g ${tool.package}`, { stdio: 'pipe' });
+      execSync(`npm install -g ${tool.package}`, { stdio: "pipe" });
       console.log(`    \x1b[32m\u2713\x1b[0m ${tool.name} installed`);
     } catch (err) {
-      console.log(`    \x1b[31m\u2717\x1b[0m ${tool.name} failed: ${err.message}`);
+      console.log(
+        `    \x1b[31m\u2717\x1b[0m ${tool.name} failed: ${err.message}`,
+      );
     }
   }
 
-  console.log('');
-  console.log('  \x1b[32mSetup complete.\x1b[0m');
-  console.log('  Start with: npx @grainulation/wheat init');
-  console.log('');
+  console.log("");
+  console.log("  \x1b[32mSetup complete.\x1b[0m");
+  console.log("  Start with: npx @grainulation/wheat init");
+  console.log("");
   rl.close();
 }
 

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@grainulation/grainulation",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Structured research for decisions that satisfice",
   "license": "MIT",
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
   "bin": {
     "grainulation": "bin/grainulation.js"
   },
@@ -20,7 +24,10 @@
   ],
   "scripts": {
     "test": "node test/basic.test.js",
-    "start": "node bin/grainulation.js"
+    "lint": "biome ci .",
+    "format": "biome check --write .",
+    "start": "node bin/grainulation.js",
+    "postinstall": "git config core.hooksPath .githooks || true"
   },
   "keywords": [
     "research",
@@ -38,7 +45,11 @@
   },
   "homepage": "https://grainulation.com",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
-  "author": "grainulation contributors"
+  "packageManager": "pnpm@10.30.0",
+  "author": "grainulation contributors",
+  "devDependencies": {
+    "@biomejs/biome": "2.4.8"
+  }
 }