@grainulation/wheat 1.0.0

package/lib/status.js

@@ -0,0 +1,135 @@
+/**
+ * wheat status — Quick sprint status check
+ *
+ * Runs the compiler in summary mode against the target directory.
+ * Provides a fast terminal snapshot of sprint health.
+ *
+ * Zero npm dependencies.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { compile } from '../compiler/wheat-compiler.js';
+
+export async function run(dir, args) {
+  const jsonMode = args.includes('--json');
+  const claimsPath = path.join(dir, 'claims.json');
+
+  if (!fs.existsSync(claimsPath)) {
+    if (jsonMode) {
+      console.log(JSON.stringify({ error: 'no_sprint', message: 'No sprint found in this directory.' }));
+      process.exit(0);
+    }
+    console.log();
+    console.log('  No sprint found in this directory.');
+    console.log('  Run "wheat init" to start a research sprint.');
+    console.log();
+    process.exit(0);
+  }
+
+  const claimsData = JSON.parse(fs.readFileSync(claimsPath, 'utf8'));
+  const compilationPath = path.join(dir, 'compilation.json');
+  const compilation = compile(claimsPath, compilationPath, dir);
+
+  const meta = claimsData.meta || {};
+  const claims = claimsData.claims || [];
+  const active = claims.filter(c => c.status === 'active');
+  const superseded = claims.filter(c => c.status === 'superseded');
+
+  if (jsonMode) {
+    const tiers = {};
+    for (const c of active) {
+      tiers[c.evidence] = (tiers[c.evidence] || 0) + 1;
+    }
+    const result = {
+      question: meta.question || null,
+      phase: meta.phase || 'unknown',
+      status: compilation.status,
+      claims: { total: claims.length, active: active.length, superseded: superseded.length },
+      evidence: tiers,
+    };
+    if (compilation.conflicts) {
+      result.conflicts = {
+        resolved: compilation.conflicts.resolved.length,
+        unresolved: compilation.conflicts.unresolved.length,
+      };
+    }
+    if (compilation.coverage) {
+      result.topics = Object.keys(compilation.coverage);
+    }
+    if (meta.initiated) {
+      const days = Math.floor((Date.now() - new Date(meta.initiated).getTime()) / 86400000);
+      result.age = { days, initiated: meta.initiated };
+    }
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(0);
+  }
+
+  const icon = compilation.status === 'ready' ? '\x1b[32m●\x1b[0m' : '\x1b[31m●\x1b[0m';
+
+  console.log();
+  console.log(`  ${icon} \x1b[1m${meta.question || 'No question set'}\x1b[0m`);
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  Phase:       ${meta.phase || 'unknown'}`);
+  console.log(`  Status:      ${compilation.status}`);
+  console.log(`  Claims:      ${claims.length} total, ${active.length} active, ${superseded.length} superseded`);
+
+  // Evidence breakdown
+  const tiers = {};
+  for (const c of active) {
+    tiers[c.evidence] = (tiers[c.evidence] || 0) + 1;
+  }
+  const tierStr = Object.entries(tiers).map(([k, v]) => `${k}:${v}`).join('  ');
+  if (tierStr) {
+    console.log(`  Evidence:    ${tierStr}`);
+  }
+
+  // Conflicts
+  if (compilation.conflicts) {
+    const { resolved, unresolved } = compilation.conflicts;
+    if (resolved.length > 0 || unresolved.length > 0) {
+      console.log(`  Conflicts:   ${resolved.length} resolved, ${unresolved.length} unresolved`);
+    }
+  }
+
+  // Topics
+  if (compilation.coverage) {
+    const topics = Object.keys(compilation.coverage);
+    console.log(`  Topics:      ${topics.length} (${topics.join(', ')})`);
+  }
+
+  // Initiated
+  if (meta.initiated) {
+    const days = Math.floor((Date.now() - new Date(meta.initiated).getTime()) / 86400000);
+    console.log(`  Age:         ${days} days (since ${meta.initiated})`);
+  }
+
+  console.log();
+
+  // Suggest next steps based on state
+  console.log('  Next steps:');
+
+  if (compilation.conflicts?.unresolved?.length > 0) {
+    console.log('    /resolve         — resolve unresolved conflicts');
+  }
+
+  const weakTopics = Object.entries(compilation.coverage || {})
+    .filter(([, d]) => d.max_evidence === 'stated' || d.max_evidence === 'web')
+    .map(([t]) => t);
+
+  if (weakTopics.length > 0) {
+    console.log(`    /research        — strengthen weak topics: ${weakTopics.join(', ')}`);
+  }
+
+  if (meta.phase === 'define') {
+    console.log('    /research <topic> — start investigating');
+  } else if (meta.phase === 'research') {
+    console.log('    /prototype       — test your findings');
+  } else if (meta.phase === 'prototype' || meta.phase === 'evaluate') {
+    if (compilation.status === 'ready') {
+      console.log('    /brief           — compile the decision document');
+    }
+  }
+
+  console.log();
+}

package/lib/update.js

@@ -0,0 +1,71 @@
+/**
+ * wheat update — Copy/update slash commands to .claude/commands/
+ *
+ * Copies command templates from the installed package into the user's
+ * .claude/commands/ directory. Existing files can be overwritten with --force.
+ *
+ * Zero npm dependencies.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function packageRoot() {
+  return path.resolve(__dirname, '..');
+}
+
+export async function run(dir, args) {
+  const force = args.includes('--force');
+  const srcDir = path.join(packageRoot(), 'templates', 'commands');
+  const destDir = path.join(dir, '.claude', 'commands');
+
+  fs.mkdirSync(destDir, { recursive: true });
+
+  let files;
+  try {
+    files = fs.readdirSync(srcDir).filter(f => f.endsWith('.md'));
+  } catch (err) {
+    console.error(`Cannot read command templates: ${err.message}`);
+    process.exit(1);
+  }
+
+  console.log();
+  console.log(`  Updating .claude/commands/ (${files.length} commands)`);
+  console.log();
+
+  let updated = 0;
+  let skipped = 0;
+
+  for (const file of files) {
+    const src = path.join(srcDir, file);
+    const dest = path.join(destDir, file);
+
+    if (fs.existsSync(dest) && !force) {
+      // Check if content differs
+      const srcContent = fs.readFileSync(src, 'utf8');
+      const destContent = fs.readFileSync(dest, 'utf8');
+      if (srcContent !== destContent) {
+        console.log(`  \x1b[33m~\x1b[0m ${file} (differs, use --force to overwrite)`);
+        skipped++;
+      } else {
+        console.log(`  \x1b[2m= ${file} (up to date)\x1b[0m`);
+      }
+      continue;
+    }
+
+    fs.copyFileSync(src, dest);
+    console.log(`  \x1b[32m+\x1b[0m ${file}`);
+    updated++;
+  }
+
+  console.log();
+  console.log(`  ${updated} updated, ${skipped} skipped`);
+  if (skipped > 0 && !force) {
+    console.log('  Run "wheat update --force" to overwrite all');
+  }
+  console.log();
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@grainulation/wheat",
+  "version": "1.0.0",
+  "description": "Research-driven development framework — structured claims, compiled evidence, deterministic output",
+  "license": "MIT",
+  "author": "grainulation contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grainulation/wheat.git"
+  },
+  "homepage": "https://wheat.grainulation.com",
+  "bugs": {
+    "url": "https://github.com/grainulation/wheat/issues"
+  },
+  "keywords": [
+    "wheat-framework",
+    "research-sprint",
+    "claims-compiler",
+    "claude-code",
+    "structured-research",
+    "evidence-graded",
+    "decision-framework",
+    "research-driven-development",
+    "developer-research",
+    "technical-decision-making"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./compiler": "./lib/compiler.js",
+    "./server": "./lib/server.js",
+    "./guard": "./lib/guard.js",
+    "./connect": "./lib/connect.js",
+    "./mcp": "./lib/serve-mcp.js"
+  },
+  "bin": {
+    "wheat": "bin/wheat.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "public/",
+    "compiler/",
+    "templates/"
+  ],
+  "scripts": {
+    "test": "node --test test/cli.test.js test/compiler.test.js test/guard.test.js test/init.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}