sdd-cli 0.1.12 → 0.1.14

package/README.md

@@ -119,6 +119,7 @@ Project names must use letters, numbers, spaces, `-` or `_`, and cannot include
 
 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.  
+When you pass direct intent text (`sdd-cli hello "..."`), hello uses auto-guided defaults and minimizes confirmations.  
 Use `--questions` when you want the manual question-by-question flow.
 
 ## The happy path (end-to-end flow)
@@ -203,6 +204,17 @@ sdd-cli hello "I want a simple booking system for appointments"
 5) Check output in:
 `<workspace>/<project>/requirements/done/<REQ-ID>/`
 
+## Recovery quick commands
+
+- Continue an existing project:
+`sdd-cli --project <project-name> hello "continue"`
+- Resume from a specific stage:
+`sdd-cli --project <project-name> --from-step test hello "resume"`
+- Script-safe full default run:
+`sdd-cli --non-interactive hello "<your intent>"`
+- Preview autopilot steps without writing files:
+`sdd-cli --dry-run hello "<your intent>"`
+
 ## Where files are stored (clean repos)
 
 By default, the tool writes to a dedicated workspace, not into your repo:

package/dist/cli.js

@@ -66,6 +66,7 @@ program
     .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("--dry-run", "Preview autopilot steps without writing artifacts")
     .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");
@@ -76,6 +77,7 @@ program.hook("preAction", (thisCommand, actionCommand) => {
         improve: Boolean(opts.improve),
         parallel: Boolean(opts.parallel),
         nonInteractive: Boolean(opts.nonInteractive),
+        dryRun: Boolean(opts.dryRun),
         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/hello.js

@@ -20,6 +20,9 @@ function printStep(step, description) {
 function printWhy(message) {
     console.log(`  -> ${message}`);
 }
+function printRecoveryNext(project, step, hint) {
+    console.log(`Next command: sdd-cli --project "${project}" --from-step ${step} hello "${hint}"`);
+}
 function deriveProjectName(input, flow) {
     const seed = input
         .trim()
@@ -99,35 +102,39 @@ async function runHello(input, runQuestions) {
         return { workspace, projects };
     }
     let { workspace, projects } = loadWorkspace();
+    const runtimeFlags = (0, flags_1.getFlags)();
+    const hasDirectIntent = input.trim().length > 0;
+    const shouldRunQuestions = runQuestions === true;
+    const autoGuidedMode = !shouldRunQuestions && (runtimeFlags.nonInteractive || hasDirectIntent);
+    const dryRun = runtimeFlags.dryRun;
     console.log("Hello from sdd-cli.");
     console.log(`Workspace: ${workspace.root}`);
-    const useWorkspace = await (0, prompt_1.confirm)("Use this workspace path? (y/n) ");
-    if (!useWorkspace) {
-        const nextPath = await (0, prompt_1.ask)("Workspace path to use (blank to exit): ");
-        if (!nextPath) {
-            console.log("Run again from the desired folder or pass --output <path>.");
-            return;
+    if (autoGuidedMode) {
+        printWhy("Auto-guided mode active: using current workspace defaults.");
+    }
+    else {
+        const useWorkspace = await (0, prompt_1.confirm)("Use this workspace path? (y/n) ");
+        if (!useWorkspace) {
+            const nextPath = await (0, prompt_1.ask)("Workspace path to use (blank to exit): ");
+            if (!nextPath) {
+                console.log("Run again from the desired folder or pass --output <path>.");
+                return;
+            }
+            (0, flags_1.setFlags)({ output: nextPath });
+            const reloaded = loadWorkspace();
+            workspace = reloaded.workspace;
+            projects = reloaded.projects;
+            console.log(`Workspace updated: ${workspace.root}`);
         }
-        (0, flags_1.setFlags)({ output: nextPath });
-        const reloaded = loadWorkspace();
-        workspace = reloaded.workspace;
-        projects = reloaded.projects;
-        console.log(`Workspace updated: ${workspace.root}`);
     }
-    const runtimeFlags = (0, flags_1.getFlags)();
     if (projects.length > 0) {
         console.log("Active projects:");
         projects.forEach((project) => {
             console.log(`- ${project.name} (${project.status})`);
         });
-        const choice = await (0, prompt_1.ask)("Start new or continue? (new/continue) ");
-        const normalized = choice.trim().toLowerCase();
-        if (normalized === "continue") {
-            const selected = runtimeFlags.project || (await (0, prompt_1.ask)("Project to continue: "));
-            if (!selected) {
-                console.log("No project selected. Continuing with new flow.");
-            }
-            else if (!projects.find((project) => project.name === selected)) {
+        if (runtimeFlags.project) {
+            const selected = runtimeFlags.project.trim();
+            if (!projects.find((project) => project.name === selected)) {
                 console.log(`Project not found: ${selected}. Continuing with new flow.`);
             }
             else {
@@ -135,15 +142,34 @@ async function runHello(input, runQuestions) {
                 console.log(`Continuing: ${selected}`);
             }
         }
+        else if (!autoGuidedMode) {
+            const choice = await (0, prompt_1.ask)("Start new or continue? (new/continue) ");
+            const normalized = choice.trim().toLowerCase();
+            if (normalized === "continue") {
+                const selected = await (0, prompt_1.ask)("Project to continue: ");
+                if (!selected) {
+                    console.log("No project selected. Continuing with new flow.");
+                }
+                else if (!projects.find((project) => project.name === selected)) {
+                    console.log(`Project not found: ${selected}. Continuing with new flow.`);
+                }
+                else {
+                    (0, flags_1.setFlags)({ project: selected });
+                    console.log(`Continuing: ${selected}`);
+                }
+            }
+            else {
+                console.log(`Selected: ${choice || "new"}`);
+            }
+        }
         else {
-            console.log(`Selected: ${choice || "new"}`);
+            console.log("Auto-selected: new flow.");
         }
     }
     else {
         console.log("No active projects found.");
     }
     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;
@@ -211,8 +237,13 @@ async function runHello(input, runQuestions) {
     else {
         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 (autoGuidedMode) {
+                activeProject = deriveProjectName(text, intent.flow);
+            }
+            else {
+                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.");
@@ -237,12 +268,22 @@ async function runHello(input, runQuestions) {
         const startStep = fromStep ?? "create";
         if (startStep !== "create" && !reqId) {
             console.log("No checkpoint found for resume. Run full autopilot first or use --from-step create.");
+            printRecoveryNext(activeProject, "create", text);
             return;
         }
         if (fromStep) {
             printWhy(`Resuming autopilot from step: ${fromStep}`);
         }
         const stepIndex = autopilot_checkpoint_1.AUTOPILOT_STEPS.indexOf(startStep);
+        if (dryRun) {
+            printWhy("Dry run active: previewing autopilot plan without writing files.");
+            for (let i = stepIndex; i < autopilot_checkpoint_1.AUTOPILOT_STEPS.length; i += 1) {
+                const step = autopilot_checkpoint_1.AUTOPILOT_STEPS[i];
+                console.log(`Would run step: ${step}`);
+            }
+            console.log(`To execute for real: sdd-cli --project "${activeProject}" hello "${text}"`);
+            return;
+        }
         for (let i = stepIndex; i < autopilot_checkpoint_1.AUTOPILOT_STEPS.length; i += 1) {
             const step = autopilot_checkpoint_1.AUTOPILOT_STEPS[i];
             if (step === "create") {
@@ -251,6 +292,7 @@ async function runHello(input, runQuestions) {
                 const created = await (0, req_create_1.runReqCreate)(draft, { autofill: true });
                 if (!created) {
                     console.log("Autopilot stopped at requirement creation.");
+                    printRecoveryNext(activeProject, "create", text);
                     return;
                 }
                 reqId = created.reqId;
@@ -266,6 +308,7 @@ async function runHello(input, runQuestions) {
                 });
                 if (!planned) {
                     console.log("Autopilot stopped at planning.");
+                    printRecoveryNext(activeProject, "plan", text);
                     return;
                 }
             }
@@ -280,6 +323,7 @@ async function runHello(input, runQuestions) {
                 });
                 if (!started) {
                     console.log("Autopilot stopped at start phase.");
+                    printRecoveryNext(activeProject, "start", text);
                     return;
                 }
             }
@@ -294,6 +338,7 @@ async function runHello(input, runQuestions) {
                 });
                 if (!tested) {
                     console.log("Autopilot stopped at test planning.");
+                    printRecoveryNext(activeProject, "test", text);
                     return;
                 }
             }
@@ -308,6 +353,7 @@ async function runHello(input, runQuestions) {
                 });
                 if (!finished) {
                     console.log("Autopilot stopped at finish phase.");
+                    printRecoveryNext(activeProject, "finish", text);
                     return;
                 }
                 (0, autopilot_checkpoint_1.clearCheckpoint)(activeProject);

package/dist/context/flags.d.ts

@@ -3,6 +3,7 @@ export type RuntimeFlags = {
     improve: boolean;
     parallel: boolean;
     nonInteractive: boolean;
+    dryRun: boolean;
     fromStep?: string;
     project?: string;
     output?: string;

package/dist/context/flags.js

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

package/package.json

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