sdd-cli 0.1.23 → 0.1.24

package/README.md

@@ -2,60 +2,22 @@
 
 Specification-driven delivery CLI that turns requirements into specs, architecture, tests, and traceable docs.
 
-## Repository overview
-
-This repo hosts the CLI implementation, domain flows, templates, schemas, and structured documentation for the SDD workflow.
+## Repository overview
+
+This repo hosts the CLI implementation, domain flows, templates, schemas, and structured documentation for the SDD workflow.
 
 ## Vision (think pyramids)
 
 Build the foundation once, then lift everything else. The tool provides a durable structure: requirements, architecture, technical specs, quality gates, test plans, and decision logs. AI gets "wings" by being guided, constrained, and accountable at every step.
 
-Mission and vision live in `docs/MISSION.md` and `docs/VISION.md`.
-
-Start with `docs/INDEX.md` for a full documentation map and `docs/STYLE.md` for formatting guidance.
-Contributing guidelines live in `docs/CONTRIBUTING.md`.
-Contributor quickstart lives in `docs/CONTRIBUTOR_QUICKSTART.md`.
-Issue triage taxonomy lives in `docs/ISSUE_TRIAGE_PLAYBOOK.md`.
-Use the PR template in `.github/PULL_REQUEST_TEMPLATE.md`.
-Maintenance guidance lives in `docs/MAINTENANCE.md`.
-Install troubleshooting lives in `docs/TROUBLESHOOTING.md`.
-
-Deep process, commands, interactions, and diagrams live in:
-- `docs/PROCESS.md`
-- `docs/COMMANDS.md`
-- `docs/INTERACTIONS.md`
-- `docs/DIAGRAMS.md`
-- `docs/ARCHITECTURE.md`
-- `docs/SDD_CHECKLIST.md`
-- `docs/GLOSSARY.md`
-- `docs/VALIDATION_CHECKLIST.md`
-- `docs/FLOW_TEMPLATE_MAP.md`
-- `docs/GATE_PROMPT_MATRIX.md`
-- `docs/TEMPLATE_LINT_RULES.md`
-- `docs/FLOW_GATE_MAP.md`
-- `docs/FLOW_COMPLIANCE_CHECKLIST.md`
-- `docs/RELEASE_READINESS_CHECKLIST.md`
-- `docs/AUTOMATION_OUTLINE.md`
-- `docs/GATE_SCHEMA_MAP.md`
-- `docs/GATE_TEMPLATE_MAP.md`
-- `docs/KNOWLEDGE_MODE_CHECKLIST.md`
-- `docs/DOMAIN_COMPLETENESS_CHECKLIST.md`
-- `docs/IMPLEMENTATION_PLAN.md`
-- `docs/CLEAN_ARCHITECTURE_CHECKLIST.md`
-- `docs/REQUIREMENTS_ALIGNMENT.md`
-- `docs/GITFLOW.md`
-- `docs/RELEASE_PROCESS.md`
-
-Reports live in:
-- `docs/reports/E2E_REPORT.md`
-- `docs/reports/FLOW_COVERAGE.md`
-- `docs/reports/GATE_COVERAGE_REPORT.md`
-- `docs/reports/GATE_TEMPLATE_COVERAGE_REPORT.md`
-- `docs/reports/PACK_COVERAGE_REPORT.md`
-- `docs/reports/PROMPT_AUDIT_REPORT.md`
-- `docs/reports/PROMPT_COVERAGE_REPORT.md`
-- `docs/reports/QUALITY_SCORE_RUBRIC.md`
-- `docs/reports/SPEC_COMPLETENESS_REPORT.md`
+Documentation entry points:
+- `docs/INDEX.md` (full docs map)
+- `docs/COMMANDS.md` (CLI command reference)
+- `docs/INTERACTIONS.md` (orchestration model and provider contract)
+- `docs/ERROR_CODES.md` (machine-readable remediation map)
+- `docs/TROUBLESHOOTING.md` (install/runtime issues)
+- `docs/RELEASE_PROCESS.md` (versioning and publish flow)
+- `docs/CHANGELOG.md` and `docs/releases/` (release history)
 
 Examples and templates:
 - `examples/transcripts/`
@@ -123,15 +85,15 @@ 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.  
-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 `hello` command is the entry point: it loads workspace context, lists active projects, routes intent, and runs the guided autopilot flow.  
+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)
 
-1) **Start**  
-   `sdd-cli hello` connects to AI, shows active projects, and asks if you want to start new or continue.
+1) **Start**  
+   `sdd-cli hello` loads workspace state, shows active projects, and asks if you want to start new or continue.
 
 2) **Autopilot Discovery**  
    Creates a requirement draft in backlog with validated defaults.
@@ -145,24 +107,32 @@ Use `--questions` when you want the manual question-by-question flow.
 5) **Autopilot Verify**  
    Updates/validates test-plan artifacts.
 
-6) **Autopilot Finish**  
-   Finalizes requirement, writes project-level README artifacts, and moves requirement to `done`.
-
-7) **Manual Detail (optional)**  
-   Run `sdd-cli hello --questions` when you prefer detailed prompt packs before drafting.
-
-## Commands (proposed)
-
-### Core
-- `sdd-cli hello` -- interactive session, project picker, full guided flow
-- `sdd-cli quickstart` -- one-command demo flow with built-in examples
+6) **Autopilot Finish**  
+   Finalizes requirement, writes project-level README artifacts, and moves requirement to `done`.
+
+7) **App Lifecycle Orchestration**  
+   Generates code scaffold in `generated-app`, runs quality checks (when scripts exist), prepares local deploy artifacts, initializes git, and attempts GitHub publish when `gh` is authenticated.
+
+8) **Manual Detail (optional)**  
+   Run `sdd-cli hello --questions` when you prefer detailed prompt packs before drafting.
+
+## Commands (proposed)
+
+### Core
+- `sdd-cli hello` -- interactive session, project picker, full guided flow
+- `sdd-cli suite "<goal>"` -- continuous orchestration mode; asks only blocking decisions and executes full delivery end-to-end
+- `sdd-cli quickstart` -- one-command demo flow with built-in examples
 - `sdd-cli init` -- create SDD workspace and config
 - `sdd-cli list` -- list flows, router flows, templates, prompt packs, and projects
 - `sdd-cli status --next` -- show current project state and exact next command
 - `sdd-cli scope list` -- list monorepo workspace scopes
 - `sdd-cli scope status <scope>` -- show status summary for one scope
-- `sdd-cli doctor` -- validate completeness and consistency
-  - `sdd-cli doctor --fix` -- apply safe remediations for missing requirement ops files
+- `sdd-cli doctor` -- validate completeness and consistency
+  - `sdd-cli doctor --fix` -- apply safe remediations for missing requirement ops files
+- `sdd-cli config show` -- show active config and config file path
+- `sdd-cli config init` -- create default config file
+- `sdd-cli config set <key> <value>` -- update config (`workspace.default_root|ai.preferred_cli|ai.model|mode.default|git.publish_enabled`)
+  - include `git.publish_enabled` (`true|false`) to control GitHub publish attempts
 
 ### Router
 - `sdd-cli route` -- classify user intent and route to the right flow
@@ -211,8 +181,10 @@ Use `--questions` when you want the manual question-by-question flow.
 - `--improve` -- re-open and enhance existing docs
 - `--output <path>` -- override workspace output
 - `--scope <name>` -- isolate artifacts by monorepo scope namespace
-- `--metrics-local` -- record local opt-in telemetry snapshots in `workspace/metrics`
-- `--project <name>` -- set project name
+- `--metrics-local` -- record local opt-in telemetry snapshots in `workspace/metrics`
+- `--provider <name>` -- select AI provider (`gemini|codex|auto`), default `gemini`
+- `--gemini` -- shortcut for `--provider gemini`
+- `--project <name>` -- set project name
 - `--parallel` -- generate in parallel
 - `--questions` -- use manual question-driven discovery flow
 - `--non-interactive` -- run without confirmations (script/CI friendly)
@@ -259,13 +231,24 @@ For a full onboarding walkthrough, see:
 - Error codes and remediation guide: `docs/ERROR_CODES.md`
 - Integration adapters roadmap and contract: `docs/INTEGRATION_ADAPTERS.md`
 
-## Where files are stored (clean repos)
-
-By default, the tool writes to a dedicated workspace, not into your repo:
-
-- Default (global workspace):  
-  - Windows: `%APPDATA%/sdd-cli/workspaces/<project>`  
-  - macOS/Linux: `~/.config/sdd-cli/workspaces/<project>`
+## Where files are stored (clean repos)
+
+By default, the tool writes to a dedicated workspace, not into your repo:
+
+- Default (config-driven workspace):  
+  - Windows/macOS/Linux default: `~/Documents/sdd-tool-projects/<project>`
+  - Example on this machine: `C:\Users\jdsal\Documents\sdd-tool-projects\<project>`
+
+Config file:
+- Windows: `%APPDATA%/sdd-cli/config.yml`
+- macOS/Linux: `~/.config/sdd-cli/config.yml`
+
+Default config values:
+- `workspace.default_root`: `{{home}}/Documents/sdd-tool-projects`
+- `ai.preferred_cli`: `gemini`
+- `ai.model`: `gemini-2.5-flash-lite`
+- `mode.default`: `guided`
+- `git.publish_enabled`: `false`
 
 Optional:
 - `--output ./docs/sdd` to keep SDD next to the repo
@@ -559,7 +542,7 @@ Implementation readiness:
 ## Interactive session (hello) design
 
 ### Steps
-1) **Connect** to AI and load local workspace index.
+1) **Load** local workspace index and runtime flags.
 2) **List active projects** with status (backlog, wip, done).
 3) **Choose**: start new or continue.
 4) **Context**: ask domain and persona to load the right flow.
@@ -624,14 +607,17 @@ The tool can generate C4-style diagrams using templates:
 
 These are exported as text (Mermaid/PlantUML) to keep them versionable.
 
-## Provider abstraction (AI)
-
-The CLI is provider-agnostic:
-- Local model
-- Remote model
-- Codex-compatible
-
-The router selects agent roles, while the provider is configurable.
+## Provider abstraction (AI)
+
+The CLI is provider-agnostic:
+- Local model
+- Remote model
+- Codex-compatible
+
+The router selects agent roles, while the provider is configurable.
+Current implementation status:
+- `hello` remains local-first autopilot and now includes optional provider-assisted draft/code generation with fallback-safe defaults.
+- Direct provider checks/execution are also available through `sdd-cli ai status` and `sdd-cli ai exec`.
 
 ## Privacy and approvals
 

package/dist/cli.js

@@ -46,6 +46,7 @@ const route_1 = require("./commands/route");
 const doctor_1 = require("./commands/doctor");
 const quickstart_1 = require("./commands/quickstart");
 const status_1 = require("./commands/status");
+const suite_1 = require("./commands/suite");
 const import_issue_1 = require("./commands/import-issue");
 const import_jira_1 = require("./commands/import-jira");
 const import_linear_1 = require("./commands/import-linear");
@@ -54,6 +55,8 @@ const paths_1 = require("./paths");
 const flags_1 = require("./context/flags");
 const prompt_1 = require("./ui/prompt");
 const local_metrics_1 = require("./telemetry/local-metrics");
+const providers_1 = require("./providers");
+const config_1 = require("./config");
 const program = new commander_1.Command();
 function getVersion() {
     try {
@@ -79,22 +82,36 @@ program
     .option("--project <name>", "Select or name the project")
     .option("--output <path>", "Override workspace output root")
     .option("--scope <name>", "Target a monorepo scope namespace inside the workspace")
-    .option("--metrics-local", "Enable local opt-in telemetry snapshots in workspace/metrics");
+    .option("--metrics-local", "Enable local opt-in telemetry snapshots in workspace/metrics")
+    .option("--provider <name>", "AI provider: gemini|codex|auto", (0, providers_1.defaultProviderPreference)())
+    .option("--model <name>", "AI model id (for providers that support model override)")
+    .option("--gemini", "Shortcut for --provider gemini");
 program.hook("preAction", (thisCommand, actionCommand) => {
+    const config = (0, config_1.ensureConfig)();
     const opts = typeof actionCommand.optsWithGlobals === "function" ? actionCommand.optsWithGlobals() : thisCommand.opts();
+    const defaultMode = config.mode.default;
+    const nonInteractive = Boolean(opts.nonInteractive) || defaultMode === "non-interactive";
+    const beginner = Boolean(opts.beginner) || defaultMode === "beginner";
     (0, flags_1.setFlags)({
         approve: Boolean(opts.approve),
         improve: Boolean(opts.improve),
         parallel: Boolean(opts.parallel),
-        nonInteractive: Boolean(opts.nonInteractive),
+        nonInteractive,
         dryRun: Boolean(opts.dryRun),
-        beginner: Boolean(opts.beginner),
+        beginner,
         fromStep: typeof opts.fromStep === "string" ? opts.fromStep : undefined,
         project: typeof opts.project === "string" ? opts.project : undefined,
         output: typeof opts.output === "string" ? opts.output : undefined,
         scope: typeof opts.scope === "string" ? opts.scope : undefined,
-        metricsLocal: Boolean(opts.metricsLocal)
+        metricsLocal: Boolean(opts.metricsLocal),
+        provider: Boolean(opts.gemini)
+            ? "gemini"
+            : typeof opts.provider === "string"
+                ? opts.provider
+                : config.ai.preferred_cli,
+        model: typeof opts.model === "string" ? opts.model : config.ai.model
     });
+    process.env.SDD_GEMINI_MODEL = typeof opts.model === "string" ? opts.model : config.ai.model;
     const commandPath = typeof actionCommand.name === "function"
         ? `${thisCommand.name()} ${actionCommand.name()}`.trim()
         : thisCommand.name();
@@ -120,6 +137,11 @@ program
     .option("--example <name>", "Example prompt: saas|bugfix|api|ecommerce|mobile")
     .option("--list-examples", "List available example prompts")
     .action((options) => (0, quickstart_1.runQuickstart)(options.example, options.listExamples));
+program
+    .command("suite")
+    .description("Run continuous SDD orchestration mode (asks only blocking decisions)")
+    .argument("[input...]", "Optional initial goal")
+    .action((input) => (0, suite_1.runSuite)(input.join(" ").trim()));
 program
     .command("list")
     .description("List flows, templates, and projects")
@@ -369,17 +391,48 @@ program
     .argument("[requirementId]", "Optional requirement ID to validate")
     .option("--fix", "Apply safe remediations (missing changelog/progress-log)")
     .action((project, requirementId, options) => (0, doctor_1.runDoctor)(project, requirementId, Boolean(options.fix)));
-const ai = program.command("ai").description("Codex provider commands");
+const configCmd = program.command("config").description("Configuration commands");
+configCmd
+    .command("show")
+    .description("Show effective config and config file path")
+    .action(() => {
+    const config = (0, config_1.ensureConfig)();
+    console.log(`Config file: ${(0, config_1.configPath)()}`);
+    console.log(JSON.stringify(config, null, 2));
+});
+configCmd
+    .command("init")
+    .description("Create config file with defaults if missing")
+    .action(() => {
+    const config = (0, config_1.ensureConfig)();
+    console.log(`Config ready: ${(0, config_1.configPath)()}`);
+    console.log(`Workspace default root: ${config.workspace.default_root}`);
+});
+configCmd
+    .command("set")
+    .description("Set config value by key")
+    .argument("<key>", "Key: workspace.default_root | ai.preferred_cli | ai.model | mode.default | git.publish_enabled")
+    .argument("<value>", "Value for key")
+    .action((key, value) => {
+    const updated = (0, config_1.updateConfigValue)(key, value);
+    if (!updated) {
+        console.log("[SDD-1506] Invalid config key. Use workspace.default_root, ai.preferred_cli, ai.model, mode.default, git.publish_enabled.");
+        return;
+    }
+    console.log(`Config updated: ${(0, config_1.configPath)()}`);
+    console.log(JSON.stringify(updated, null, 2));
+});
+const ai = program.command("ai").description("AI provider commands");
 ai
     .command("status")
-    .description("Check Codex CLI availability")
+    .description("Check AI provider CLI availability")
     .action(async () => {
     const { runAiStatus } = await Promise.resolve().then(() => __importStar(require("./commands/ai-status")));
     runAiStatus();
 });
 ai
     .command("exec")
-    .description("Run Codex non-interactively")
+    .description("Run configured AI provider non-interactively")
     .argument("[prompt...]", "Prompt to execute")
     .action(async (prompt) => {
     const { runAiExec } = await Promise.resolve().then(() => __importStar(require("./commands/ai-exec")));
@@ -414,4 +467,51 @@ importCmd
     .action(async (workItem) => {
     await (0, import_azure_1.runImportAzure)(workItem);
 });
-program.parse(process.argv);
+const knownTopLevel = new Set([
+    "hello",
+    "init",
+    "quickstart",
+    "suite",
+    "list",
+    "status",
+    "scope",
+    "req",
+    "pr",
+    "test",
+    "gen",
+    "learn",
+    "route",
+    "doctor",
+    "config",
+    "ai",
+    "import"
+]);
+function normalizeArgv(argv) {
+    const passthrough = argv.slice(0, 2);
+    const args = argv.slice(2);
+    if (args.length === 0) {
+        return argv;
+    }
+    const valueFlags = new Set(["--from-step", "--project", "--output", "--scope", "--provider", "--model"]);
+    let positionalIndex = -1;
+    for (let i = 0; i < args.length; i += 1) {
+        const token = args[i];
+        if (!token.startsWith("-")) {
+            positionalIndex = i;
+            break;
+        }
+        if (valueFlags.has(token)) {
+            i += 1;
+        }
+    }
+    if (positionalIndex < 0) {
+        return argv;
+    }
+    const firstPositional = args[positionalIndex];
+    if (knownTopLevel.has(firstPositional)) {
+        return argv;
+    }
+    // Supports one-command UX: sdd-tool "create a calculator"
+    return [...passthrough, ...args.slice(0, positionalIndex), "hello", ...args.slice(positionalIndex)];
+}
+program.parse(normalizeArgv(process.argv));

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

@@ -0,0 +1,19 @@
+import { RequirementDraft } from "./req-create";
+export declare function resetToFunctionalBaseline(appDir: string, projectName: string, intent: string): number;
+export declare function enrichDraftWithAI(input: string, flow: string, domain: string, baseDraft: RequirementDraft, providerRequested?: string): RequirementDraft;
+export type CodeBootstrapResult = {
+    attempted: boolean;
+    provider?: string;
+    generated: boolean;
+    outputDir: string;
+    fileCount: number;
+    reason?: string;
+};
+export type ImproveAppResult = {
+    attempted: boolean;
+    applied: boolean;
+    fileCount: number;
+    reason?: string;
+};
+export declare function bootstrapProjectCode(projectRoot: string, projectName: string, intent: string, providerRequested?: string): CodeBootstrapResult;
+export declare function improveGeneratedApp(appDir: string, intent: string, providerRequested?: string, qualityDiagnostics?: string[]): ImproveAppResult;