sdd-cli 0.1.9 → 0.1.11

package/README.md

@@ -117,31 +117,32 @@ Package name on npm is `sdd-cli` (CLI commands remain `sdd-cli` and `sdd`).
 
 Project names must use letters, numbers, spaces, `-` or `_`, and cannot include path separators.
 
-The `hello` command is the entry point: it connects to AI, lists active projects, and offers to create a new one or continue. It then runs a guided, happy-path sequence from discovery to completion.
+The `hello` command is the entry point: it connects to AI, lists active projects, and offers to create a new one or continue.  
+Default behavior is now a guided autopilot from discovery to completion with minimal prompts.  
+Use `--questions` when you want the manual question-by-question flow.
 
 ## The happy path (end-to-end flow)
 
 1) **Start**  
    `sdd-cli hello` connects to AI, shows active projects, and asks if you want to start new or continue.
-   It also asks for project name, domain, output location, language profile, and quality level.
 
-2) **Discover**  
-   Guided prompts produce `requirements/backlog/REQ-0001/requirement.md`.
+2) **Autopilot Discovery**  
+   Creates a requirement draft in backlog with validated defaults.
 
-3) **Refine**  
-   `sdd-cli req refine` resolves ambiguity, missing metrics, and risks.
+3) **Autopilot Planning**  
+   Generates functional spec, technical spec, architecture, and test plan drafts.
 
-4) **Plan (WIP)**  
-   `sdd-cli req plan` creates functional spec, tech spec, and architecture drafts.
+4) **Autopilot Start**  
+   Creates implementation plan and quality artifacts; moves requirement to `in-progress`.
 
-5) **Implement**  
-   `sdd-cli req start` generates the implementation plan and activates quality gates.
+5) **Autopilot Verify**  
+   Updates/validates test-plan artifacts.
 
-6) **Verify**  
-   `sdd-cli test plan` defines scenarios and coverage targets.
+6) **Autopilot Finish**  
+   Finalizes requirement, writes project-level README artifacts, and moves requirement to `done`.
 
-7) **Finish**  
-   `sdd-cli req finish` seals the requirement, versioned docs, and decision logs.
+7) **Manual Detail (optional)**  
+   Run `sdd-cli hello --questions` when you prefer detailed prompt packs before drafting.
 
 ## Commands (proposed)
 
@@ -183,8 +184,25 @@ The `hello` command is the entry point: it connects to AI, lists active projects
 - `--output <path>` -- override workspace output
 - `--project <name>` -- set project name
 - `--parallel` -- generate in parallel
+- `--questions` -- use manual question-driven discovery flow
+- `--non-interactive` -- run without confirmations (script/CI friendly)
 - `--alias sdd` -- optional alias to run as `sdd`
 
+## Beginner quickstart
+
+1) Install:
+```
+npm install -g sdd-cli
+```
+2) Run:
+```
+sdd-cli hello "I want a simple booking system for appointments"
+```
+3) Follow minimal prompts (workspace/project confirmation).  
+4) Let autopilot complete the full flow.  
+5) Check output in:
+`<workspace>/<project>/requirements/done/<REQ-ID>/`
+
 ## Where files are stored (clean repos)
 
 By default, the tool writes to a dedicated workspace, not into your repo:

package/dist/cli.js

@@ -65,6 +65,7 @@ program
     .option("--approve", "Skip confirmations if gates pass")
     .option("--improve", "Trigger self-audit and regenerate")
     .option("--parallel", "Generate in parallel when supported")
+    .option("--non-interactive", "Run with defaults and without prompt confirmations")
     .option("--project <name>", "Select or name the project")
     .option("--output <path>", "Override workspace output root");
 program.hook("preAction", (thisCommand, actionCommand) => {
@@ -73,6 +74,7 @@ program.hook("preAction", (thisCommand, actionCommand) => {
         approve: Boolean(opts.approve),
         improve: Boolean(opts.improve),
         parallel: Boolean(opts.parallel),
+        nonInteractive: Boolean(opts.nonInteractive),
         project: typeof opts.project === "string" ? opts.project : undefined,
         output: typeof opts.output === "string" ? opts.output : undefined
     });

package/dist/commands/hello.js

@@ -13,6 +13,27 @@ const req_start_1 = require("./req-start");
 const req_finish_1 = require("./req-finish");
 const route_1 = require("./route");
 const test_plan_1 = require("./test-plan");
+function printStep(step, description) {
+    console.log(`${step}: ${description}`);
+}
+function printWhy(message) {
+    console.log(`  -> ${message}`);
+}
+function deriveProjectName(input, flow) {
+    const seed = input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9 _-]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .split(" ")
+        .filter((token) => token.length > 0)
+        .slice(0, 4)
+        .join("-");
+    const date = new Date().toISOString().slice(0, 10).replace(/-/g, "");
+    const base = seed.length > 0 ? seed : flow.toLowerCase();
+    return `autopilot-${base}-${date}`;
+}
 function buildAutopilotDraft(input, flow, domain) {
     const cleanInput = input.trim();
     const objective = cleanInput.length > 0 ? cleanInput : "Deliver a clear first requirement draft.";
@@ -127,16 +148,18 @@ async function runHello(input, runQuestions) {
     }
     const intent = (0, intent_1.classifyIntent)(text);
     console.log(`Detected intent: ${intent.intent} -> ${intent.flow}`);
-    console.log("Step 1/3: Intent detected.");
-    const showRoute = await (0, prompt_1.confirm)("View route details now? (y/n) ");
-    if (showRoute) {
+    printStep("Step 1/7", "Intent detected");
+    printWhy("I classified your goal and selected the best starting flow.");
+    const showRoute = runQuestions === true ? await (0, prompt_1.confirm)("View route details now? (y/n) ") : false;
+    if (showRoute && runQuestions === true) {
         (0, route_1.runRoute)(text);
     }
     else {
         console.log("Next: run `sdd-cli route <your input>` to view details.");
     }
     const shouldRunQuestions = runQuestions === true;
-    console.log("Step 2/3: Requirement setup.");
+    printStep("Step 2/7", "Requirement setup");
+    printWhy("I will gather enough context to generate a valid first draft.");
     if (shouldRunQuestions) {
         const packs = (0, prompt_packs_1.loadPromptPacks)();
         const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
@@ -163,28 +186,35 @@ async function runHello(input, runQuestions) {
             if (ok) {
                 const created = await (0, req_create_1.runReqCreate)(mapped, { autofill: true });
                 if (created) {
-                    console.log(`Step 3/3: Draft created (${created.reqId}).`);
+                    printStep("Step 3/7", `Draft created (${created.reqId})`);
                     console.log("Next suggested command: sdd-cli req refine");
                 }
             }
         }
     }
     else {
-        const activeProject = (0, flags_1.getFlags)().project || (await (0, prompt_1.askProjectName)());
+        let activeProject = (0, flags_1.getFlags)().project;
+        if (!activeProject) {
+            const quickProject = await (0, prompt_1.ask)("Project name (optional, press Enter to auto-generate): ");
+            activeProject = quickProject || deriveProjectName(text, intent.flow);
+        }
         if (!activeProject) {
             console.log("Project name is required to run autopilot.");
             return;
         }
+        printWhy(`Using project: ${activeProject}`);
         (0, flags_1.setFlags)({ project: activeProject });
         const draft = buildAutopilotDraft(text, intent.flow, intent.domain);
         draft.project_name = activeProject;
-        console.log("Step 3/7: Creating requirement draft automatically...");
+        printStep("Step 3/7", "Creating requirement draft automatically");
+        printWhy("This creates your baseline scope, acceptance criteria, and NFRs.");
         const created = await (0, req_create_1.runReqCreate)(draft, { autofill: true });
         if (!created) {
             console.log("Autopilot stopped at requirement creation.");
             return;
         }
-        console.log(`Step 4/7: Planning requirement ${created.reqId}...`);
+        printStep("Step 4/7", `Planning requirement ${created.reqId}`);
+        printWhy("I am generating functional, technical, architecture, and test artifacts.");
         const planned = await (0, req_plan_1.runReqPlan)({
             projectName: activeProject,
             reqId: created.reqId,
@@ -195,7 +225,8 @@ async function runHello(input, runQuestions) {
             console.log("Autopilot stopped at planning.");
             return;
         }
-        console.log(`Step 5/7: Starting implementation plan for ${created.reqId}...`);
+        printStep("Step 5/7", `Preparing implementation plan for ${created.reqId}`);
+        printWhy("This stage defines milestones, tasks, quality thresholds, and decisions.");
         const started = await (0, req_start_1.runReqStart)({
             projectName: activeProject,
             reqId: created.reqId,
@@ -206,7 +237,8 @@ async function runHello(input, runQuestions) {
             console.log("Autopilot stopped at start phase.");
             return;
         }
-        console.log(`Step 6/7: Updating test plan for ${created.reqId}...`);
+        printStep("Step 6/7", `Updating test plan for ${created.reqId}`);
+        printWhy("I am ensuring critical paths, edge cases, and regression tests are documented.");
         const tested = await (0, test_plan_1.runTestPlan)({
             projectName: activeProject,
             reqId: created.reqId,
@@ -217,7 +249,8 @@ async function runHello(input, runQuestions) {
             console.log("Autopilot stopped at test planning.");
             return;
         }
-        console.log(`Step 7/7: Finalizing requirement ${created.reqId}...`);
+        printStep("Step 7/7", `Finalizing requirement ${created.reqId}`);
+        printWhy("I will move artifacts to done state and generate project-level summary files.");
         const finished = await (0, req_finish_1.runReqFinish)({
             projectName: activeProject,
             reqId: created.reqId,

package/dist/context/flags.d.ts

@@ -2,6 +2,7 @@ export type RuntimeFlags = {
     approve: boolean;
     improve: boolean;
     parallel: boolean;
+    nonInteractive: boolean;
     project?: string;
     output?: string;
 };

package/dist/context/flags.js

@@ -6,6 +6,7 @@ const flags = {
     approve: false,
     improve: false,
     parallel: false,
+    nonInteractive: false,
     project: undefined,
     output: undefined
 };
@@ -19,6 +20,9 @@ function setFlags(next) {
     if ("parallel" in next) {
         flags.parallel = Boolean(next.parallel);
     }
+    if ("nonInteractive" in next) {
+        flags.nonInteractive = Boolean(next.nonInteractive);
+    }
     if ("project" in next) {
         flags.project = typeof next.project === "string" ? next.project : undefined;
     }

package/dist/ui/prompt.js

@@ -13,6 +13,10 @@ const flags_1 = require("../context/flags");
 let queuedAnswers = null;
 let rl = null;
 function shouldUseQueuedAnswers() {
+    const flags = (0, flags_1.getFlags)();
+    if (flags.nonInteractive || process.env.SDD_NON_INTERACTIVE === "1") {
+        return true;
+    }
     if (process.env.SDD_STDIN === "1") {
         return true;
     }
@@ -55,6 +59,10 @@ function closePrompt() {
 }
 process.on("exit", () => closePrompt());
 function ask(question) {
+    const flags = (0, flags_1.getFlags)();
+    if (flags.nonInteractive || process.env.SDD_NON_INTERACTIVE === "1") {
+        return Promise.resolve("");
+    }
     if (shouldUseQueuedAnswers()) {
         const queue = getQueuedAnswers();
         const answer = queue.shift() ?? "";
@@ -76,7 +84,7 @@ async function askProjectName(prompt = "Project name: ") {
 }
 async function confirm(question) {
     const flags = (0, flags_1.getFlags)();
-    if (flags.approve) {
+    if (flags.approve || flags.nonInteractive || process.env.SDD_NON_INTERACTIVE === "1") {
         return true;
     }
     const response = await ask(question);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "SDD-first, AI-native CLI for end-to-end delivery.",
   "homepage": "https://github.com/jdsalasca/sdd-tool#readme",
   "repository": {