sdd-cli 0.1.10 → 0.1.12

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,8 @@ 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("--from-step <step>", "Resume or start autopilot from step: create|plan|start|test|finish")
     .option("--project <name>", "Select or name the project")
     .option("--output <path>", "Override workspace output root");
 program.hook("preAction", (thisCommand, actionCommand) => {
@@ -73,6 +75,8 @@ program.hook("preAction", (thisCommand, actionCommand) => {
         approve: Boolean(opts.approve),
         improve: Boolean(opts.improve),
         parallel: Boolean(opts.parallel),
+        nonInteractive: Boolean(opts.nonInteractive),
+        fromStep: typeof opts.fromStep === "string" ? opts.fromStep : undefined,
         project: typeof opts.project === "string" ? opts.project : undefined,
         output: typeof opts.output === "string" ? opts.output : undefined
     });

package/dist/commands/autopilot-checkpoint.d.ts

@@ -0,0 +1,16 @@
+export declare const AUTOPILOT_STEPS: readonly ["create", "plan", "start", "test", "finish"];
+export type AutopilotStep = (typeof AUTOPILOT_STEPS)[number];
+export type AutopilotCheckpoint = {
+    project: string;
+    reqId: string;
+    seedText: string;
+    flow: string;
+    domain: string;
+    lastCompleted: AutopilotStep;
+    updatedAt: string;
+};
+export declare function normalizeStep(step?: string): AutopilotStep | null;
+export declare function loadCheckpoint(projectName: string): AutopilotCheckpoint | null;
+export declare function saveCheckpoint(projectName: string, checkpoint: AutopilotCheckpoint): void;
+export declare function clearCheckpoint(projectName: string): void;
+export declare function nextStep(step: AutopilotStep): AutopilotStep | null;

package/dist/commands/autopilot-checkpoint.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTOPILOT_STEPS = void 0;
+exports.normalizeStep = normalizeStep;
+exports.loadCheckpoint = loadCheckpoint;
+exports.saveCheckpoint = saveCheckpoint;
+exports.clearCheckpoint = clearCheckpoint;
+exports.nextStep = nextStep;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../workspace/index");
+exports.AUTOPILOT_STEPS = ["create", "plan", "start", "test", "finish"];
+function checkpointPath(projectName) {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    const project = (0, index_1.getProjectInfo)(workspace, projectName);
+    return path_1.default.join(project.root, ".autopilot-checkpoint.json");
+}
+function normalizeStep(step) {
+    if (!step)
+        return null;
+    const raw = step.trim().toLowerCase();
+    const map = {
+        create: "create",
+        plan: "plan",
+        start: "start",
+        test: "test",
+        "test-plan": "test",
+        finish: "finish"
+    };
+    return map[raw] ?? null;
+}
+function loadCheckpoint(projectName) {
+    const file = checkpointPath(projectName);
+    if (!fs_1.default.existsSync(file)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs_1.default.readFileSync(file, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveCheckpoint(projectName, checkpoint) {
+    const file = checkpointPath(projectName);
+    fs_1.default.mkdirSync(path_1.default.dirname(file), { recursive: true });
+    fs_1.default.writeFileSync(file, JSON.stringify(checkpoint, null, 2), "utf-8");
+}
+function clearCheckpoint(projectName) {
+    const file = checkpointPath(projectName);
+    if (fs_1.default.existsSync(file)) {
+        fs_1.default.rmSync(file, { force: true });
+    }
+}
+function nextStep(step) {
+    const idx = exports.AUTOPILOT_STEPS.indexOf(step);
+    if (idx < 0 || idx + 1 >= exports.AUTOPILOT_STEPS.length) {
+        return null;
+    }
+    return exports.AUTOPILOT_STEPS[idx + 1];
+}

package/dist/commands/hello.js

@@ -13,6 +13,7 @@ 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");
+const autopilot_checkpoint_1 = require("./autopilot-checkpoint");
 function printStep(step, description) {
     console.log(`${step}: ${description}`);
 }
@@ -113,7 +114,7 @@ async function runHello(input, runQuestions) {
         projects = reloaded.projects;
         console.log(`Workspace updated: ${workspace.root}`);
     }
-    const flags = (0, flags_1.getFlags)();
+    const runtimeFlags = (0, flags_1.getFlags)();
     if (projects.length > 0) {
         console.log("Active projects:");
         projects.forEach((project) => {
@@ -122,7 +123,7 @@ async function runHello(input, runQuestions) {
         const choice = await (0, prompt_1.ask)("Start new or continue? (new/continue) ");
         const normalized = choice.trim().toLowerCase();
         if (normalized === "continue") {
-            const selected = flags.project || (await (0, prompt_1.ask)("Project to continue: "));
+            const selected = runtimeFlags.project || (await (0, prompt_1.ask)("Project to continue: "));
             if (!selected) {
                 console.log("No project selected. Continuing with new flow.");
             }
@@ -141,7 +142,23 @@ async function runHello(input, runQuestions) {
     else {
         console.log("No active projects found.");
     }
-    const text = input || (await (0, prompt_1.ask)("Describe what you want to do: "));
+    let text = input || (await (0, prompt_1.ask)("Describe what you want to do: "));
+    const shouldRunQuestions = runQuestions === true;
+    let checkpoint = null;
+    let fromStep = (0, autopilot_checkpoint_1.normalizeStep)(runtimeFlags.fromStep);
+    let activeProjectForCheckpoint = runtimeFlags.project;
+    if (!shouldRunQuestions && activeProjectForCheckpoint) {
+        checkpoint = (0, autopilot_checkpoint_1.loadCheckpoint)(activeProjectForCheckpoint);
+        if (!text && checkpoint?.seedText) {
+            text = checkpoint.seedText;
+        }
+        if (!fromStep && checkpoint?.lastCompleted) {
+            const candidate = (0, autopilot_checkpoint_1.nextStep)(checkpoint.lastCompleted);
+            if (candidate) {
+                fromStep = candidate;
+            }
+        }
+    }
     if (!text) {
         console.log("No input provided. Try again with a short description.");
         return;
@@ -157,7 +174,6 @@ async function runHello(input, runQuestions) {
     else {
         console.log("Next: run `sdd-cli route <your input>` to view details.");
     }
-    const shouldRunQuestions = runQuestions === true;
     printStep("Step 2/7", "Requirement setup");
     printWhy("I will gather enough context to generate a valid first draft.");
     if (shouldRunQuestions) {
@@ -204,64 +220,110 @@ async function runHello(input, runQuestions) {
         }
         printWhy(`Using project: ${activeProject}`);
         (0, flags_1.setFlags)({ project: activeProject });
-        const draft = buildAutopilotDraft(text, intent.flow, intent.domain);
-        draft.project_name = activeProject;
-        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;
+        checkpoint = (0, autopilot_checkpoint_1.loadCheckpoint)(activeProject);
+        if (checkpoint && !fromStep) {
+            const candidate = (0, autopilot_checkpoint_1.nextStep)(checkpoint.lastCompleted);
+            if (candidate) {
+                fromStep = candidate;
+            }
         }
-        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,
-            autofill: true,
-            seedText: text
-        });
-        if (!planned) {
-            console.log("Autopilot stopped at planning.");
+        if (fromStep && !autopilot_checkpoint_1.AUTOPILOT_STEPS.includes(fromStep)) {
+            console.log(`Invalid --from-step value. Use one of: ${autopilot_checkpoint_1.AUTOPILOT_STEPS.join(", ")}`);
             return;
         }
-        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,
-            autofill: true,
-            seedText: text
-        });
-        if (!started) {
-            console.log("Autopilot stopped at start phase.");
+        const draft = buildAutopilotDraft(text, intent.flow, intent.domain);
+        draft.project_name = activeProject;
+        let reqId = checkpoint?.reqId ?? "";
+        const startStep = fromStep ?? "create";
+        if (startStep !== "create" && !reqId) {
+            console.log("No checkpoint found for resume. Run full autopilot first or use --from-step create.");
             return;
         }
-        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,
-            autofill: true,
-            seedText: text
-        });
-        if (!tested) {
-            console.log("Autopilot stopped at test planning.");
-            return;
+        if (fromStep) {
+            printWhy(`Resuming autopilot from step: ${fromStep}`);
         }
-        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,
-            autofill: true,
-            seedText: text
-        });
-        if (!finished) {
-            console.log("Autopilot stopped at finish phase.");
-            return;
+        const stepIndex = autopilot_checkpoint_1.AUTOPILOT_STEPS.indexOf(startStep);
+        for (let i = stepIndex; i < autopilot_checkpoint_1.AUTOPILOT_STEPS.length; i += 1) {
+            const step = autopilot_checkpoint_1.AUTOPILOT_STEPS[i];
+            if (step === "create") {
+                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;
+                }
+                reqId = created.reqId;
+            }
+            if (step === "plan") {
+                printStep("Step 4/7", `Planning requirement ${reqId}`);
+                printWhy("I am generating functional, technical, architecture, and test artifacts.");
+                const planned = await (0, req_plan_1.runReqPlan)({
+                    projectName: activeProject,
+                    reqId,
+                    autofill: true,
+                    seedText: text
+                });
+                if (!planned) {
+                    console.log("Autopilot stopped at planning.");
+                    return;
+                }
+            }
+            if (step === "start") {
+                printStep("Step 5/7", `Preparing implementation plan for ${reqId}`);
+                printWhy("This stage defines milestones, tasks, quality thresholds, and decisions.");
+                const started = await (0, req_start_1.runReqStart)({
+                    projectName: activeProject,
+                    reqId,
+                    autofill: true,
+                    seedText: text
+                });
+                if (!started) {
+                    console.log("Autopilot stopped at start phase.");
+                    return;
+                }
+            }
+            if (step === "test") {
+                printStep("Step 6/7", `Updating test plan for ${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,
+                    autofill: true,
+                    seedText: text
+                });
+                if (!tested) {
+                    console.log("Autopilot stopped at test planning.");
+                    return;
+                }
+            }
+            if (step === "finish") {
+                printStep("Step 7/7", `Finalizing requirement ${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,
+                    autofill: true,
+                    seedText: text
+                });
+                if (!finished) {
+                    console.log("Autopilot stopped at finish phase.");
+                    return;
+                }
+                (0, autopilot_checkpoint_1.clearCheckpoint)(activeProject);
+                console.log(`Autopilot completed successfully for ${reqId}.`);
+                console.log(`Artifacts finalized at: ${finished.doneDir}`);
+                return;
+            }
+            (0, autopilot_checkpoint_1.saveCheckpoint)(activeProject, {
+                project: activeProject,
+                reqId,
+                seedText: text,
+                flow: intent.flow,
+                domain: intent.domain,
+                lastCompleted: step,
+                updatedAt: new Date().toISOString()
+            });
         }
-        console.log(`Autopilot completed successfully for ${created.reqId}.`);
-        console.log(`Artifacts finalized at: ${finished.doneDir}`);
     }
 }

package/dist/context/flags.d.ts

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

package/dist/context/flags.js

@@ -6,6 +6,8 @@ const flags = {
     approve: false,
     improve: false,
     parallel: false,
+    nonInteractive: false,
+    fromStep: undefined,
     project: undefined,
     output: undefined
 };
@@ -19,6 +21,12 @@ function setFlags(next) {
     if ("parallel" in next) {
         flags.parallel = Boolean(next.parallel);
     }
+    if ("nonInteractive" in next) {
+        flags.nonInteractive = Boolean(next.nonInteractive);
+    }
+    if ("fromStep" in next) {
+        flags.fromStep = typeof next.fromStep === "string" ? next.fromStep : undefined;
+    }
     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.10",
+  "version": "0.1.12",
   "description": "SDD-first, AI-native CLI for end-to-end delivery.",
   "homepage": "https://github.com/jdsalasca/sdd-tool#readme",
   "repository": {