@grainulation/wheat 1.0.4 → 1.0.5

package/bin/wheat.js

@@ -67,7 +67,8 @@ 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
@@ -90,11 +91,9 @@ 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);
@@ -189,6 +188,19 @@ Run "wheat disconnect farmer --help" for options.`);
 }
 
 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);

package/lib/defaults.js

@@ -0,0 +1,32 @@
+/**
+ * Smart defaults and environment detection for wheat CLI.
+ * Zero dependencies — Node built-ins only.
+ */
+
+export const DEFAULTS = {
+  audience: ["engineers"],
+  constraints: [],
+  doneCriteria: "Decision-ready brief with evidence",
+};
+
+export function isTTY() {
+  return Boolean(process.stdout.isTTY) && !isCI();
+}
+
+export function isCI() {
+  return Boolean(
+    process.env.CI ||
+      process.env.GITHUB_ACTIONS ||
+      process.env.GITLAB_CI ||
+      process.env.CIRCLECI ||
+      process.env.JENKINS_URL ||
+      process.env.BUILDKITE,
+  );
+}
+
+export function outputMode() {
+  if (process.argv.includes("--quiet")) return "quiet";
+  if (process.argv.includes("--json")) return "json";
+  if (!isTTY()) return "json";
+  return "tty";
+}

package/lib/init.js

@@ -20,6 +20,7 @@ import path from "path";
 import readline from "readline";
 import { execFileSync } from "child_process";
 import { fileURLToPath } from "url";
+import { DEFAULTS, outputMode } from "./defaults.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -357,7 +358,26 @@ export async function run(dir, args) {
 
   let meta;
 
-  if (flags.headless || flags["non-interactive"]) {
+  if (flags.auto) {
+    // ── Auto mode — question only, smart defaults for everything else ──
+    if (!flags.question) {
+      console.error("  wheat: no question provided");
+      process.exit(1);
+    }
+    meta = {
+      question: flags.question,
+      audience: flags.audience
+        ? flags.audience.split(",").map((s) => s.trim())
+        : DEFAULTS.audience,
+      constraints: flags.constraints
+        ? flags.constraints
+            .split(";")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : DEFAULTS.constraints,
+      doneCriteria: flags.done || DEFAULTS.doneCriteria,
+    };
+  } else if (flags.headless || flags["non-interactive"]) {
     // ── Headless mode — all flags required ──
     const missing = [];
     if (!flags.question) missing.push("--question");
@@ -518,6 +538,29 @@ export async function run(dir, args) {
   }
 
   console.log();
+  // Auto mode: compact output, no tutorial
+  if (flags.auto) {
+    const mode = outputMode();
+    if (mode === "quiet") {
+      return;
+    } else if (mode === "json") {
+      console.log(JSON.stringify({
+        question: meta.question,
+        audience: meta.audience,
+        claims: claims.claims.length,
+        dir,
+      }));
+      return;
+    } else {
+      console.log();
+      console.log(`  \x1b[1m\x1b[33mwheat\x1b[0m — sprint created`);
+      console.log(`  ${meta.question}`);
+      console.log(`  ${claims.claims.length} constraint(s) seeded`);
+      console.log();
+      return;
+    }
+  }
+
   console.log("  ─────────────────────────────────────────");
   console.log(`  \x1b[1m\x1b[33mSprint ready.\x1b[0m`);
   console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainulation/wheat",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Research-driven development framework — structured claims, compiled evidence, deterministic output",
   "license": "MIT",
   "author": "grainulation contributors",