@grainulation/wheat 1.0.3 → 1.0.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Aid Idrizovic
+Copyright (c) 2026 grainulation contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -3,7 +3,8 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@grainulation/wheat"><img src="https://img.shields.io/npm/v/@grainulation/wheat" alt="npm version"></a> <a href="https://www.npmjs.com/package/@grainulation/wheat"><img src="https://img.shields.io/npm/dm/@grainulation/wheat" alt="npm downloads"></a> <a href="https://github.com/grainulation/wheat/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@grainulation/wheat" alt="license"></a> <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/@grainulation/wheat" alt="node"></a> <a href="https://github.com/grainulation/wheat/actions"><img src="https://github.com/grainulation/wheat/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@grainulation/wheat"><img src="https://img.shields.io/npm/v/@grainulation/wheat" alt="npm version"></a> <a href="https://www.npmjs.com/package/@grainulation/wheat"><img src="https://img.shields.io/npm/dm/@grainulation/wheat" alt="npm downloads"></a> <a href="https://github.com/grainulation/wheat/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/wheat" alt="node"></a> <a href="https://github.com/grainulation/wheat/actions"><img src="https://github.com/grainulation/wheat/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://deepwiki.com/grainulation/wheat"><img src="https://deepwiki.com/badge.svg" alt="Explore on DeepWiki"></a>
 </p>
 
 <p align="center"><strong>CI/CD for technical decisions.</strong></p>
@@ -76,26 +77,26 @@ The compiler catches conflicts, warns about weak evidence, and blocks the build
 
 ## Commands
 
-| Command | What it does |
-|---------|-------------|
-| `/init` | Bootstrap a new research sprint |
-| `/research <topic>` | Deep dive on a topic, creates claims |
-| `/prototype` | Build something testable |
-| `/challenge <id>` | Adversarial stress-test of a claim |
-| `/witness <id> <url>` | External corroboration |
-| `/blind-spot` | Find gaps in your investigation |
-| `/status` | Sprint dashboard |
-| `/brief` | Compile the decision document |
-| `/present` | Generate a stakeholder presentation |
-| `/feedback` | Incorporate stakeholder input |
-| `/resolve` | Adjudicate conflicts between claims |
-| `/replay` | Time-travel through sprint history |
-| `/calibrate` | Score predictions against actual outcomes |
-| `/handoff` | Package sprint for knowledge transfer |
-| `/merge <path>` | Combine findings across sprints |
-| `/connect <type>` | Link external tools (Jira, docs, etc.) |
-| `/evaluate` | Test claims against reality, resolve conflicts |
-| `/next` | Route next steps through Farmer (mobile feedback) |
+| Command               | What it does                                      |
+| --------------------- | ------------------------------------------------- |
+| `/init`               | Bootstrap a new research sprint                   |
+| `/research <topic>`   | Deep dive on a topic, creates claims              |
+| `/prototype`          | Build something testable                          |
+| `/challenge <id>`     | Adversarial stress-test of a claim                |
+| `/witness <id> <url>` | External corroboration                            |
+| `/blind-spot`         | Find gaps in your investigation                   |
+| `/status`             | Sprint dashboard                                  |
+| `/brief`              | Compile the decision document                     |
+| `/present`            | Generate a stakeholder presentation               |
+| `/feedback`           | Incorporate stakeholder input                     |
+| `/resolve`            | Adjudicate conflicts between claims               |
+| `/replay`             | Time-travel through sprint history                |
+| `/calibrate`          | Score predictions against actual outcomes         |
+| `/handoff`            | Package sprint for knowledge transfer             |
+| `/merge <path>`       | Combine findings across sprints                   |
+| `/connect <type>`     | Link external tools (Jira, docs, etc.)            |
+| `/evaluate`           | Test claims against reality, resolve conflicts    |
+| `/next`               | Route next steps through Farmer (mobile feedback) |
 
 ## Guard rails
 
@@ -116,16 +117,16 @@ Node built-in modules only. No npm install waterfall. No supply chain anxiety.
 
 ## Part of the grainulation ecosystem
 
-| Tool | Role |
-|------|------|
-| **wheat** | Research engine -- grow structured evidence |
-| [farmer](https://github.com/grainulation/farmer) | Permission dashboard -- approve AI actions in real time (admin + viewer roles) |
-| [barn](https://github.com/grainulation/barn) | Shared tools -- templates, validators, sprint detection |
-| [mill](https://github.com/grainulation/mill) | Format conversion -- export to PDF, CSV, slides, 24 formats |
-| [silo](https://github.com/grainulation/silo) | Knowledge storage -- reusable claim libraries and packs |
-| [harvest](https://github.com/grainulation/harvest) | Analytics -- cross-sprint patterns and prediction scoring |
-| [orchard](https://github.com/grainulation/orchard) | Orchestration -- multi-sprint coordination and dependencies |
-| [grainulation](https://github.com/grainulation/grainulation) | Unified CLI -- single entry point to the ecosystem |
+| Tool                                                         | Role                                                                           |
+| ------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| **wheat**                                                    | Research engine -- grow structured evidence                                    |
+| [farmer](https://github.com/grainulation/farmer)             | Permission dashboard -- approve AI actions in real time (admin + viewer roles) |
+| [barn](https://github.com/grainulation/barn)                 | Shared tools -- templates, validators, sprint detection                        |
+| [mill](https://github.com/grainulation/mill)                 | Format conversion -- export to PDF, CSV, slides, 24 formats                    |
+| [silo](https://github.com/grainulation/silo)                 | Knowledge storage -- reusable claim libraries and packs                        |
+| [harvest](https://github.com/grainulation/harvest)           | Analytics -- cross-sprint patterns and prediction scoring                      |
+| [orchard](https://github.com/grainulation/orchard)           | Orchestration -- multi-sprint coordination and dependencies                    |
+| [grainulation](https://github.com/grainulation/grainulation) | Unified CLI -- single entry point to the ecosystem                             |
 
 ## License
 

package/bin/wheat.js

@@ -19,34 +19,40 @@
  * Zero npm dependencies.
  */
 
-import path from 'path';
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { track as trackInstall, maybePrompt as installPrompt } from '../lib/install-prompt.js';
+import path from "path";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import {
+  track as trackInstall,
+  maybePrompt as installPrompt,
+} from "../lib/install-prompt.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-const VERSION = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')).version;
+const VERSION = JSON.parse(
+  readFileSync(path.join(__dirname, "..", "package.json"), "utf8")
+).version;
 
 // ─── Parse arguments ─────────────────────────────────────────────────────────
 
-const verbose = process.argv.includes('--verbose');
+const verbose = process.argv.includes("--verbose");
 function vlog(...a) {
   if (!verbose) return;
   const ts = new Date().toISOString();
-  process.stderr.write(`[${ts}] wheat: ${a.join(' ')}\n`);
+  process.stderr.write(`[${ts}] wheat: ${a.join(" ")}\n`);
 }
 export { vlog, verbose };
 
 const args = process.argv.slice(2);
 const subcommand = args[0];
 
-vlog('startup', `subcommand=${subcommand || '(none)'}`, `cwd=${process.cwd()}`);
+vlog("startup", `subcommand=${subcommand || "(none)"}`, `cwd=${process.cwd()}`);
 
 // Extract --dir or --root flag (applies to all subcommands)
 let targetDir = process.cwd();
-const dirIdx = args.indexOf('--dir') !== -1 ? args.indexOf('--dir') : args.indexOf('--root');
+const dirIdx =
+  args.indexOf("--dir") !== -1 ? args.indexOf("--dir") : args.indexOf("--root");
 if (dirIdx !== -1 && args[dirIdx + 1]) {
   targetDir = path.resolve(args[dirIdx + 1]);
   args.splice(dirIdx, 2);
@@ -57,11 +63,12 @@ const subArgs = args.slice(1);
 
 // ─── Help / Version ──────────────────────────────────────────────────────────
 
-if (!subcommand || subcommand === '--help' || subcommand === '-h') {
+if (!subcommand || subcommand === "--help" || subcommand === "-h") {
   console.log(`wheat v${VERSION} — Research-driven development framework
 
 Usage:
-  wheat <command> [options]
+  wheat "your question"          Start a sprint instantly (recommended)
+  wheat <command> [options]      Run a specific command
 
 Commands:
   init       Bootstrap a new research sprint in this repo
@@ -84,17 +91,15 @@ Global options:
   --help         Show this help
 
 Examples:
-  npx @grainulation/wheat quickstart
+  npx @grainulation/wheat "Should we migrate to Postgres?"
   npx @grainulation/wheat init
   npx @grainulation/wheat compile --summary
-  npx @grainulation/wheat init --question "Should we migrate to Postgres?"
-  npx @grainulation/wheat init --non-interactive --question "..." --audience "..." --done "..."
 
 Documentation: https://github.com/grainulation/wheat`);
   process.exit(0);
 }
 
-if (subcommand === '--version' || subcommand === '-v') {
+if (subcommand === "--version" || subcommand === "-v") {
   console.log(`wheat v${VERSION}`);
   process.exit(0);
 }
@@ -109,28 +114,27 @@ installPrompt(subcommand);
 // ─── Dispatch ────────────────────────────────────────────────────────────────
 
 const commands = {
-  init:       '../lib/init.js',
-  quickstart: '../lib/quickstart.js',
-  compile:    '../lib/compiler.js',
-  guard:   '../lib/guard.js',
-  status:  '../lib/status.js',
-  stats:   '../lib/stats.js',
-  update:  '../lib/update.js',
-  serve:   '../lib/server.js',
-  mcp:     '../lib/serve-mcp.js',
+  init: "../lib/init.js",
+  quickstart: "../lib/quickstart.js",
+  compile: "../lib/compiler.js",
+  guard: "../lib/guard.js",
+  status: "../lib/status.js",
+  stats: "../lib/stats.js",
+  update: "../lib/update.js",
+  serve: "../lib/server.js",
+  mcp: "../lib/serve-mcp.js",
 };
 
 // ─── wheat migrate (not yet implemented) ────────────────────────────────────
-if (subcommand === 'migrate') {
-  console.error('wheat migrate is not yet available');
+if (subcommand === "migrate") {
+  console.error("wheat migrate is not yet available");
   process.exit(1);
 }
 
-
 // Handle "wheat connect <target>" as a compound subcommand
-if (subcommand === 'connect') {
+if (subcommand === "connect") {
   const target = subArgs[0];
-  if (!target || target === '--help' || target === '-h') {
+  if (!target || target === "--help" || target === "-h") {
     console.log(`wheat connect — Link external tools
 
 Usage:
@@ -139,9 +143,11 @@ Usage:
 Run "wheat connect farmer --help" for options.`);
     process.exit(0);
   }
-  if (target === 'farmer') {
-    const connectModule = await import(new URL('../lib/connect.js', import.meta.url).href);
-    await connectModule.run(targetDir, subArgs.slice(1)).catch(err => {
+  if (target === "farmer") {
+    const connectModule = await import(
+      new URL("../lib/connect.js", import.meta.url).href
+    );
+    await connectModule.run(targetDir, subArgs.slice(1)).catch((err) => {
       console.error(`\nwheat connect farmer failed:`, err.message);
       if (process.env.WHEAT_DEBUG) console.error(err.stack);
       process.exit(1);
@@ -153,9 +159,9 @@ Run "wheat connect farmer --help" for options.`);
 }
 
 // Handle "wheat disconnect <target>" as a compound subcommand
-if (subcommand === 'disconnect') {
+if (subcommand === "disconnect") {
   const target = subArgs[0];
-  if (!target || target === '--help' || target === '-h') {
+  if (!target || target === "--help" || target === "-h") {
     console.log(`wheat disconnect — Remove external tool hooks
 
 Usage:
@@ -164,30 +170,47 @@ Usage:
 Run "wheat disconnect farmer --help" for options.`);
     process.exit(0);
   }
-  if (target === 'farmer') {
-    const disconnectModule = await import(new URL('../lib/disconnect.js', import.meta.url).href);
-    await disconnectModule.run(targetDir, subArgs.slice(1)).catch(err => {
+  if (target === "farmer") {
+    const disconnectModule = await import(
+      new URL("../lib/disconnect.js", import.meta.url).href
+    );
+    await disconnectModule.run(targetDir, subArgs.slice(1)).catch((err) => {
       console.error(`\nwheat disconnect farmer failed:`, err.message);
       if (process.env.WHEAT_DEBUG) console.error(err.stack);
       process.exit(1);
     });
     process.exit(0);
   }
-  console.error(`wheat: unknown disconnect target: ${target}\nAvailable: farmer`);
+  console.error(
+    `wheat: unknown disconnect target: ${target}\nAvailable: farmer`
+  );
   process.exit(1);
 }
 
 if (!commands[subcommand]) {
+  // Verb-less mode: wheat "my question" → dispatch to init with auto defaults
+  const compoundCmds = ["connect", "disconnect", "migrate"];
+  if (subcommand && !subcommand.startsWith("-") && !compoundCmds.includes(subcommand)) {
+    vlog("dispatch", `verb-less mode: treating "${subcommand}" as question`);
+    const initPath = new URL(commands.init, import.meta.url).href;
+    const initHandler = await import(initPath);
+    await initHandler.run(targetDir, ["--question", subcommand, "--auto"]).catch((err) => {
+      console.error(`\nwheat failed:`, err.message);
+      if (process.env.WHEAT_DEBUG) console.error(err.stack);
+      process.exit(1);
+    });
+    process.exit(0);
+  }
   console.error(`wheat: unknown command: ${subcommand}\n`);
   console.error('Run "wheat --help" for available commands.');
   process.exit(1);
 }
 
 // Load and run the subcommand module
-vlog('dispatch', `loading module for "${subcommand}"`);
+vlog("dispatch", `loading module for "${subcommand}"`);
 const modulePath = new URL(commands[subcommand], import.meta.url).href;
 const handler = await import(modulePath);
-handler.run(targetDir, subArgs).catch(err => {
+handler.run(targetDir, subArgs).catch((err) => {
   console.error(`\nwheat ${subcommand} failed:`, err.message);
   if (process.env.WHEAT_DEBUG) console.error(err.stack);
   process.exit(1);