sdd-cli 0.1.6 → 0.1.8

package/dist/commands/doctor.js

@@ -67,11 +67,6 @@ function runDoctor(projectName, reqId) {
         ];
         root = candidates.find((candidate) => fs_1.default.existsSync(candidate)) ?? root;
     }
-    const jsonFiles = collectJsonFiles(root);
-    if (jsonFiles.length === 0) {
-        console.log("No JSON artifacts found in workspace.");
-        return;
-    }
     let failures = 0;
     const promptResult = (0, validate_prompt_packs_1.validatePromptPacks)();
     if (!promptResult.valid) {
@@ -85,6 +80,10 @@ function runDoctor(projectName, reqId) {
         console.log("Template validation failed:");
         templateResult.errors.forEach((error) => console.log(`- ${error}`));
     }
+    const jsonFiles = collectJsonFiles(root);
+    if (jsonFiles.length === 0) {
+        console.log("No JSON artifacts found in workspace.");
+    }
     for (const filePath of jsonFiles) {
         const schema = inferSchema(filePath);
         if (!schema) {
@@ -101,9 +100,12 @@ function runDoctor(projectName, reqId) {
             console.log(`Valid: ${filePath}`);
         }
     }
-    if (failures === 0) {
+    if (failures === 0 && jsonFiles.length > 0) {
         console.log("All JSON artifacts are valid.");
     }
+    else if (failures === 0) {
+        console.log("Prompt packs and templates are valid.");
+    }
     else {
         console.log(`Validation failed for ${failures} artifact(s).`);
     }

package/dist/commands/hello.js

@@ -9,6 +9,62 @@ const prompt_map_1 = require("../router/prompt-map");
 const req_create_1 = require("./req-create");
 const flags_1 = require("../context/flags");
 const route_1 = require("./route");
+function buildAutopilotDraft(input, flow, domain) {
+    const cleanInput = input.trim();
+    const objective = cleanInput.length > 0 ? cleanInput : "Deliver a clear first requirement draft.";
+    const scopeByFlow = {
+        BUG_FIX: "Reproduce issue, isolate root cause, define fix",
+        PR_REVIEW: "Review feedback, plan responses, track actions",
+        SOFTWARE_FEATURE: "Core feature behavior and acceptance flow",
+        DATA_SCIENCE: "Dataset, modeling approach, and evaluation plan",
+        DESIGN: "Core design goals, accessibility, and deliverables",
+        HUMANITIES: "Research question, sources, and analytical lens",
+        BUSINESS: "Business objective, model assumptions, and constraints",
+        LEGAL: "Applicable legal constraints and compliance requirements",
+        LEARN: "Learning objective, structure, and practice outputs",
+        GENERIC: "Core user need and initial delivery scope"
+    };
+    const outByFlow = {
+        BUG_FIX: "Unrelated refactors not needed for this fix",
+        PR_REVIEW: "Changes outside current PR scope",
+        SOFTWARE_FEATURE: "Future enhancements after MVP",
+        DATA_SCIENCE: "Production hardening beyond first iteration",
+        DESIGN: "Full rebrand outside stated objective",
+        HUMANITIES: "Unrelated historical periods or disciplines",
+        BUSINESS: "Additional markets not in initial launch",
+        LEGAL: "Jurisdictions outside selected compliance scope",
+        LEARN: "Advanced topics outside current learning target",
+        GENERIC: "Additional ideas to evaluate in next iteration"
+    };
+    const actorByDomain = {
+        bug_fix: "developer, qa",
+        pr_review: "reviewer, contributor",
+        software: "end user, product owner, developer",
+        data_science: "analyst, data scientist, stakeholder",
+        design: "designer, end user, stakeholder",
+        humanities: "researcher, reader",
+        business: "customer, business owner, operator",
+        legal: "legal team, compliance owner",
+        learning: "learner, mentor",
+        generic: "user, stakeholder"
+    };
+    const safeFlow = scopeByFlow[flow] ? flow : "GENERIC";
+    const safeDomain = actorByDomain[domain] ? domain : "generic";
+    return {
+        domain: safeDomain === "generic" ? "software" : safeDomain,
+        actors: actorByDomain[safeDomain],
+        objective,
+        scope_in: scopeByFlow[safeFlow],
+        scope_out: outByFlow[safeFlow],
+        acceptance_criteria: "A baseline requirement is generated and ready for refinement with stakeholders",
+        nfr_security: "Follow secure defaults and data handling best practices",
+        nfr_performance: "Set practical baseline targets for first delivery",
+        nfr_availability: "Keep workflow usable and stable for normal usage",
+        constraints: "Timebox first iteration, keep implementation simple",
+        risks: "Ambiguity in requirements, underestimated scope",
+        links: ""
+    };
+}
 async function runHello(input, runQuestions) {
     function loadWorkspace() {
         const workspace = (0, index_1.getWorkspaceInfo)();
@@ -67,6 +123,7 @@ 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) {
         (0, route_1.runRoute)(text);
@@ -75,6 +132,7 @@ async function runHello(input, runQuestions) {
         console.log("Next: run `sdd-cli route <your input>` to view details.");
     }
     const shouldRunQuestions = runQuestions ?? (await (0, prompt_1.confirm)("Run prompt questions now? (y/n) "));
+    console.log("Step 2/3: Requirement setup.");
     if (shouldRunQuestions) {
         const packs = (0, prompt_packs_1.loadPromptPacks)();
         const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
@@ -99,13 +157,30 @@ async function runHello(input, runQuestions) {
             console.log(JSON.stringify(mapped, null, 2));
             const ok = await (0, prompt_1.confirm)("Generate requirement draft now? (y/n) ");
             if (ok) {
-                await (0, req_create_1.runReqCreate)(mapped);
+                const created = await (0, req_create_1.runReqCreate)(mapped, { autofill: true });
+                if (created) {
+                    console.log(`Step 3/3: Draft created (${created.reqId}).`);
+                    console.log("Next suggested command: sdd-cli req refine");
+                }
             }
         }
     }
     else {
-        console.log("\nNext steps:");
-        console.log("- Run `sdd-cli route \"<your input>\"` to review the flow.");
-        console.log("- Run `sdd-cli req create` to draft a requirement.");
+        const auto = await (0, prompt_1.confirm)("Create a first requirement draft automatically now? (y/n) ");
+        if (auto) {
+            const draft = buildAutopilotDraft(text, intent.flow, intent.domain);
+            const created = await (0, req_create_1.runReqCreate)(draft, { autofill: true });
+            if (created) {
+                console.log(`Step 3/3: Draft created (${created.reqId}).`);
+                console.log("Next suggested commands:");
+                console.log("- sdd-cli req refine");
+                console.log("- sdd-cli req plan");
+            }
+        }
+        else {
+            console.log("\nNext steps:");
+            console.log("- Run `sdd-cli route \"<your input>\"` to review the flow.");
+            console.log("- Run `sdd-cli req create` to draft a requirement.");
+        }
     }
 }

package/dist/commands/req-create.d.ts

@@ -1,4 +1,7 @@
 export type RequirementDraft = {
+    project_name?: string;
+    domain?: string;
+    actors?: string;
     objective?: string;
     scope_in?: string;
     scope_out?: string;
@@ -6,5 +9,16 @@ export type RequirementDraft = {
     nfr_security?: string;
     nfr_performance?: string;
     nfr_availability?: string;
+    constraints?: string;
+    risks?: string;
+    links?: string;
 };
-export declare function runReqCreate(draft?: RequirementDraft): Promise<void>;
+export type ReqCreateOptions = {
+    autofill?: boolean;
+};
+export type ReqCreateResult = {
+    reqId: string;
+    requirementDir: string;
+    projectRoot: string;
+};
+export declare function runReqCreate(draft?: RequirementDraft, options?: ReqCreateOptions): Promise<ReqCreateResult | null>;

package/dist/commands/req-create.js

@@ -17,20 +17,26 @@ function generateId() {
     const stamp = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}${String(now.getHours()).padStart(2, "0")}${String(now.getMinutes()).padStart(2, "0")}`;
     return `REQ-${stamp}`;
 }
-async function runReqCreate(draft) {
-    const projectName = await (0, prompt_1.askProjectName)();
-    const domain = await (0, prompt_1.ask)("Domain (software, legal, design, learning, etc): ");
-    const actors = await (0, prompt_1.ask)("Actors - comma separated: ");
-    let objective = draft?.objective ?? (await (0, prompt_1.ask)("Objective: "));
-    let scopeIn = draft?.scope_in ?? (await (0, prompt_1.ask)("Scope (in) - comma separated: "));
-    let scopeOut = draft?.scope_out ?? (await (0, prompt_1.ask)("Scope (out) - comma separated: "));
-    let acceptance = draft?.acceptance_criteria ?? (await (0, prompt_1.ask)("Acceptance criteria - comma separated: "));
-    let nfrSecurity = draft?.nfr_security ?? (await (0, prompt_1.ask)("NFR security: "));
-    let nfrPerformance = draft?.nfr_performance ?? (await (0, prompt_1.ask)("NFR performance: "));
-    let nfrAvailability = draft?.nfr_availability ?? (await (0, prompt_1.ask)("NFR availability: "));
-    const constraints = await (0, prompt_1.ask)("Constraints - comma separated: ");
-    const risks = await (0, prompt_1.ask)("Risks - comma separated: ");
-    const links = await (0, prompt_1.ask)("Links - comma separated: ");
+async function runReqCreate(draft, options) {
+    const auto = Boolean(options?.autofill);
+    const projectName = draft?.project_name?.trim() || (await (0, prompt_1.askProjectName)());
+    if (!projectName) {
+        console.log("Project name is required.");
+        return null;
+    }
+    const domain = draft?.domain ?? (auto ? "software" : await (0, prompt_1.ask)("Domain (software, legal, design, learning, etc): "));
+    const actors = draft?.actors ?? (auto ? "user, stakeholder" : await (0, prompt_1.ask)("Actors - comma separated: "));
+    let objective = draft?.objective ?? (auto ? "Initial requirement draft from user intent." : await (0, prompt_1.ask)("Objective: "));
+    let scopeIn = draft?.scope_in ?? (auto ? "core workflow" : await (0, prompt_1.ask)("Scope (in) - comma separated: "));
+    let scopeOut = draft?.scope_out ?? (auto ? "out-of-scope details to refine later" : await (0, prompt_1.ask)("Scope (out) - comma separated: "));
+    let acceptance = draft?.acceptance_criteria ??
+        (auto ? "A first working draft is generated and reviewable by stakeholders" : await (0, prompt_1.ask)("Acceptance criteria - comma separated: "));
+    let nfrSecurity = draft?.nfr_security ?? (auto ? "Apply baseline secure defaults" : await (0, prompt_1.ask)("NFR security: "));
+    let nfrPerformance = draft?.nfr_performance ?? (auto ? "Reasonable default performance budget" : await (0, prompt_1.ask)("NFR performance: "));
+    let nfrAvailability = draft?.nfr_availability ?? (auto ? "Service remains available during normal usage" : await (0, prompt_1.ask)("NFR availability: "));
+    const constraints = draft?.constraints ?? (auto ? "" : await (0, prompt_1.ask)("Constraints - comma separated: "));
+    const risks = draft?.risks ?? (auto ? "" : await (0, prompt_1.ask)("Risks - comma separated: "));
+    const links = draft?.links ?? (auto ? "" : await (0, prompt_1.ask)("Links - comma separated: "));
     const workspace = (0, index_1.getWorkspaceInfo)();
     let project;
     try {
@@ -38,7 +44,7 @@ async function runReqCreate(draft) {
     }
     catch (error) {
         console.log(error.message);
-        return;
+        return null;
     }
     const metadata = (0, index_1.createProject)(workspace, project.name, domain || "software");
     const reqId = generateId();
@@ -67,21 +73,40 @@ async function runReqCreate(draft) {
     let gates = (0, gates_1.checkRequirementGates)(requirementJson);
     if (!gates.ok) {
         console.log("Requirement gates failed. Please provide missing fields:");
-        for (const field of gates.missing) {
-            if (field === "objective")
-                objective = await (0, prompt_1.ask)("Objective: ");
-            if (field === "scope.in")
-                scopeIn = await (0, prompt_1.ask)("Scope (in) - comma separated: ");
-            if (field === "scope.out")
-                scopeOut = await (0, prompt_1.ask)("Scope (out) - comma separated: ");
-            if (field === "acceptanceCriteria")
-                acceptance = await (0, prompt_1.ask)("Acceptance criteria - comma separated: ");
-            if (field === "nfrs.security")
-                nfrSecurity = await (0, prompt_1.ask)("NFR security: ");
-            if (field === "nfrs.performance")
-                nfrPerformance = await (0, prompt_1.ask)("NFR performance: ");
-            if (field === "nfrs.availability")
-                nfrAvailability = await (0, prompt_1.ask)("NFR availability: ");
+        if (auto) {
+            if (gates.missing.includes("objective"))
+                objective = "Initial requirement draft from user intent.";
+            if (gates.missing.includes("scope.in"))
+                scopeIn = "core workflow";
+            if (gates.missing.includes("scope.out"))
+                scopeOut = "out-of-scope details to refine later";
+            if (gates.missing.includes("acceptanceCriteria")) {
+                acceptance = "A first working draft is generated and reviewable by stakeholders";
+            }
+            if (gates.missing.includes("nfrs.security"))
+                nfrSecurity = "Apply baseline secure defaults";
+            if (gates.missing.includes("nfrs.performance"))
+                nfrPerformance = "Reasonable default performance budget";
+            if (gates.missing.includes("nfrs.availability"))
+                nfrAvailability = "Service remains available during normal usage";
+        }
+        else {
+            for (const field of gates.missing) {
+                if (field === "objective")
+                    objective = await (0, prompt_1.ask)("Objective: ");
+                if (field === "scope.in")
+                    scopeIn = await (0, prompt_1.ask)("Scope (in) - comma separated: ");
+                if (field === "scope.out")
+                    scopeOut = await (0, prompt_1.ask)("Scope (out) - comma separated: ");
+                if (field === "acceptanceCriteria")
+                    acceptance = await (0, prompt_1.ask)("Acceptance criteria - comma separated: ");
+                if (field === "nfrs.security")
+                    nfrSecurity = await (0, prompt_1.ask)("NFR security: ");
+                if (field === "nfrs.performance")
+                    nfrPerformance = await (0, prompt_1.ask)("NFR performance: ");
+                if (field === "nfrs.availability")
+                    nfrAvailability = await (0, prompt_1.ask)("NFR availability: ");
+            }
         }
         requirementJson = {
             ...requirementJson,
@@ -102,14 +127,14 @@ async function runReqCreate(draft) {
         if (!gates.ok) {
             console.log("Requirement gates still failing. Missing:");
             gates.missing.forEach((field) => console.log(`- ${field}`));
-            return;
+            return null;
         }
     }
     const validation = (0, validate_1.validateJson)("requirement.schema.json", requirementJson);
     if (!validation.valid) {
         console.log("Requirement validation failed:");
         validation.errors.forEach((error) => console.log(`- ${error}`));
-        return;
+        return null;
     }
     const requirementDir = path_1.default.join(project.root, "requirements", "backlog", reqId);
     fs_1.default.mkdirSync(requirementDir, { recursive: true });
@@ -148,4 +173,5 @@ async function runReqCreate(draft) {
     console.log(`Created requirement in ${requirementDir}`);
     console.log(`Project metadata stored in ${path_1.default.join(project.root, "metadata.json")}`);
     console.log(`Project status: ${metadata.status}`);
+    return { reqId, requirementDir, projectRoot: project.root };
 }

package/dist/commands/req-export.js

@@ -37,7 +37,11 @@ async function runReqExport() {
     for (const entry of fs_1.default.readdirSync(sourceDir)) {
         const srcPath = path_1.default.join(sourceDir, entry);
         const destPath = path_1.default.join(targetDir, entry);
-        if (fs_1.default.statSync(srcPath).isFile()) {
+        const stat = fs_1.default.statSync(srcPath);
+        if (stat.isDirectory()) {
+            fs_1.default.cpSync(srcPath, destPath, { recursive: true });
+        }
+        else if (stat.isFile()) {
             fs_1.default.copyFileSync(srcPath, destPath);
         }
     }

package/dist/commands/req-finish.js

@@ -64,17 +64,6 @@ async function runReqFinish() {
             return;
         }
     }
-    const doneDir = path_1.default.join(project.root, "requirements", "done", reqId);
-    fs_1.default.mkdirSync(path_1.default.dirname(doneDir), { recursive: true });
-    fs_1.default.renameSync(requirementDir, doneDir);
-    (0, index_1.updateProjectStatus)(workspace, project.name, "done");
-    const requirementJsonPath = path_1.default.join(doneDir, "requirement.json");
-    if (fs_1.default.existsSync(requirementJsonPath)) {
-        const requirementJson = JSON.parse(fs_1.default.readFileSync(requirementJsonPath, "utf-8"));
-        requirementJson.status = "done";
-        requirementJson.updatedAt = new Date().toISOString();
-        fs_1.default.writeFileSync(requirementJsonPath, JSON.stringify(requirementJson, null, 2), "utf-8");
-    }
     const overview = await (0, prompt_1.ask)("Project overview (for README): ");
     const howToRun = await (0, prompt_1.ask)("How to run (for README): ");
     const archSummary = await (0, prompt_1.ask)("Architecture summary (for README): ");
@@ -110,26 +99,55 @@ async function runReqFinish() {
         readmeValidation.errors.forEach((error) => console.log(`- ${error}`));
         return;
     }
+    const sourceDir = requirementDir;
+    const sourceStatus = path_1.default.basename(path_1.default.dirname(sourceDir));
+    const doneDir = path_1.default.join(project.root, "requirements", "done", reqId);
     const projectRoot = project.root;
-    fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.md"), readmeRendered, "utf-8");
-    fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.json"), JSON.stringify(readmeJson, null, 2), "utf-8");
-    const decisionLog = path_1.default.join(doneDir, "decision-log");
-    if (fs_1.default.existsSync(decisionLog)) {
-        const archiveRoot = path_1.default.join(projectRoot, "decision-log", reqId);
-        fs_1.default.mkdirSync(path_1.default.dirname(archiveRoot), { recursive: true });
-        fs_1.default.renameSync(decisionLog, archiveRoot);
-    }
-    const progressLog = path_1.default.join(doneDir, "progress-log.md");
-    if (!fs_1.default.existsSync(progressLog)) {
-        fs_1.default.writeFileSync(progressLog, "# Progress Log\n\n", "utf-8");
+    let moved = false;
+    try {
+        if (sourceDir !== doneDir) {
+            fs_1.default.mkdirSync(path_1.default.dirname(doneDir), { recursive: true });
+            fs_1.default.renameSync(sourceDir, doneDir);
+            moved = true;
+        }
+        (0, index_1.updateProjectStatus)(workspace, project.name, "done");
+        const requirementJsonPath = path_1.default.join(doneDir, "requirement.json");
+        if (fs_1.default.existsSync(requirementJsonPath)) {
+            const requirementJson = JSON.parse(fs_1.default.readFileSync(requirementJsonPath, "utf-8"));
+            requirementJson.status = "done";
+            requirementJson.updatedAt = new Date().toISOString();
+            fs_1.default.writeFileSync(requirementJsonPath, JSON.stringify(requirementJson, null, 2), "utf-8");
+        }
+        fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.md"), readmeRendered, "utf-8");
+        fs_1.default.writeFileSync(path_1.default.join(projectRoot, "project-readme.json"), JSON.stringify(readmeJson, null, 2), "utf-8");
+        const decisionLog = path_1.default.join(doneDir, "decision-log");
+        if (fs_1.default.existsSync(decisionLog)) {
+            const archiveRoot = path_1.default.join(projectRoot, "decision-log", reqId);
+            fs_1.default.mkdirSync(path_1.default.dirname(archiveRoot), { recursive: true });
+            fs_1.default.renameSync(decisionLog, archiveRoot);
+        }
+        const progressLog = path_1.default.join(doneDir, "progress-log.md");
+        if (!fs_1.default.existsSync(progressLog)) {
+            fs_1.default.writeFileSync(progressLog, "# Progress Log\n\n", "utf-8");
+        }
+        const logEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
+        fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
+        const changelog = path_1.default.join(doneDir, "changelog.md");
+        if (!fs_1.default.existsSync(changelog)) {
+            fs_1.default.writeFileSync(changelog, "# Changelog\n\n", "utf-8");
+        }
+        const changeEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
+        fs_1.default.appendFileSync(changelog, changeEntry, "utf-8");
     }
-    const logEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
-    fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
-    const changelog = path_1.default.join(doneDir, "changelog.md");
-    if (!fs_1.default.existsSync(changelog)) {
-        fs_1.default.writeFileSync(changelog, "# Changelog\n\n", "utf-8");
+    catch (error) {
+        if (moved && fs_1.default.existsSync(doneDir) && !fs_1.default.existsSync(sourceDir)) {
+            fs_1.default.renameSync(doneDir, sourceDir);
+        }
+        if (sourceStatus && sourceStatus !== "done") {
+            (0, index_1.updateProjectStatus)(workspace, project.name, sourceStatus);
+        }
+        console.log(`Failed to finish requirement: ${error.message}`);
+        return;
     }
-    const changeEntry = `\n- ${new Date().toISOString()} finished requirement ${reqId}\n`;
-    fs_1.default.appendFileSync(changelog, changeEntry, "utf-8");
     console.log(`Moved requirement to ${doneDir}`);
 }

package/dist/commands/req-refine.js

@@ -143,6 +143,9 @@ async function runReqRefine() {
     const mdPath = reqPath.replace("requirement.json", "requirement.md");
     fs_1.default.writeFileSync(mdPath, rendered, "utf-8");
     const changelogPath = path_1.default.join(path_1.default.dirname(reqPath), "changelog.md");
+    if (!fs_1.default.existsSync(changelogPath)) {
+        fs_1.default.writeFileSync(changelogPath, "# Changelog\n\n", "utf-8");
+    }
     const logEntry = `\n- ${new Date().toISOString()} refined requirement ${updated.id}\n`;
     fs_1.default.appendFileSync(changelogPath, logEntry, "utf-8");
     if (flags.improve) {

package/dist/commands/req-report.js

@@ -14,8 +14,7 @@ const REQUIRED_FILES = [
     "technical-spec.json",
     "architecture.json",
     "test-plan.json",
-    "quality.json",
-    "project-readme.json"
+    "quality.json"
 ];
 async function runReqReport() {
     const projectName = await (0, prompt_1.askProjectName)();
@@ -48,5 +47,11 @@ async function runReqReport() {
         if (!exists)
             missing += 1;
     }
+    const projectReadmePath = path_1.default.join(project.root, "project-readme.json");
+    const projectReadmeExists = fs_1.default.existsSync(projectReadmePath);
+    console.log(`${projectReadmeExists ? "OK" : "MISSING"}: ../project-readme.json`);
+    if (!projectReadmeExists) {
+        missing += 1;
+    }
     console.log(`Missing files: ${missing}`);
 }

package/dist/context/flags.js

@@ -10,11 +10,21 @@ const flags = {
     output: undefined
 };
 function setFlags(next) {
-    flags.approve = Boolean(next.approve);
-    flags.improve = Boolean(next.improve);
-    flags.parallel = Boolean(next.parallel);
-    flags.project = typeof next.project === "string" ? next.project : undefined;
-    flags.output = typeof next.output === "string" ? next.output : undefined;
+    if ("approve" in next) {
+        flags.approve = Boolean(next.approve);
+    }
+    if ("improve" in next) {
+        flags.improve = Boolean(next.improve);
+    }
+    if ("parallel" in next) {
+        flags.parallel = Boolean(next.parallel);
+    }
+    if ("project" in next) {
+        flags.project = typeof next.project === "string" ? next.project : undefined;
+    }
+    if ("output" in next) {
+        flags.output = typeof next.output === "string" ? next.output : undefined;
+    }
 }
 function getFlags() {
     return { ...flags };

package/dist/templates/render.js

@@ -12,7 +12,10 @@ function loadTemplate(name) {
     const root = (0, paths_1.getRepoRoot)();
     const mdPath = path_1.default.join(root, "templates", `${name}.md`);
     const ymlPath = path_1.default.join(root, "templates", `${name}.yml`);
-    const filePath = fs_1.default.existsSync(mdPath) ? mdPath : ymlPath;
+    const filePath = fs_1.default.existsSync(mdPath) ? mdPath : fs_1.default.existsSync(ymlPath) ? ymlPath : null;
+    if (!filePath) {
+        throw new Error(`Template not found: ${name} (.md or .yml)`);
+    }
     return fs_1.default.readFileSync(filePath, "utf-8");
 }
 function renderTemplate(template, data) {

package/dist/ui/prompt.js

@@ -12,14 +12,26 @@ const readline_1 = __importDefault(require("readline"));
 const flags_1 = require("../context/flags");
 let queuedAnswers = null;
 let rl = null;
+function shouldUseQueuedAnswers() {
+    if (process.env.SDD_STDIN === "1") {
+        return true;
+    }
+    return !process.stdin.isTTY && !process.stdout.isTTY;
+}
 function getQueuedAnswers() {
     if (queuedAnswers) {
         return queuedAnswers;
     }
-    if (!process.stdin.isTTY) {
-        const raw = fs_1.default.readFileSync(0, "utf-8");
-        queuedAnswers = raw.split(/\r?\n/).filter((line) => line.length > 0);
-        return queuedAnswers;
+    if (shouldUseQueuedAnswers()) {
+        try {
+            const raw = fs_1.default.readFileSync(0, "utf-8");
+            queuedAnswers = raw.split(/\r?\n/).filter((line) => line.length > 0);
+            return queuedAnswers;
+        }
+        catch {
+            queuedAnswers = [];
+            return queuedAnswers;
+        }
     }
     queuedAnswers = [];
     return queuedAnswers;
@@ -43,7 +55,7 @@ function closePrompt() {
 }
 process.on("exit", () => closePrompt());
 function ask(question) {
-    if (!process.stdin.isTTY) {
+    if (shouldUseQueuedAnswers()) {
         const queue = getQueuedAnswers();
         const answer = queue.shift() ?? "";
         return Promise.resolve(answer.trim());

package/dist/workspace/index.js

@@ -15,6 +15,22 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const flags_1 = require("../context/flags");
+function readJsonFile(filePath) {
+    try {
+        const raw = fs_1.default.readFileSync(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function readWorkspaceIndex(workspace) {
+    const parsed = readJsonFile(workspace.indexPath);
+    if (!parsed || !Array.isArray(parsed.projects)) {
+        return { projects: [] };
+    }
+    return { projects: parsed.projects };
+}
 function getWorkspaceInfo() {
     const flags = (0, flags_1.getFlags)();
     const root = flags.output
@@ -61,9 +77,8 @@ function listProjects(workspace) {
     if (!fs_1.default.existsSync(workspace.indexPath)) {
         return [];
     }
-    const raw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const parsed = JSON.parse(raw);
-    return (parsed.projects ?? []).map((project) => ({
+    const parsed = readJsonFile(workspace.indexPath);
+    return (parsed?.projects ?? []).map((project) => ({
         name: project.name ?? "unknown",
         status: project.status ?? "unknown"
     }));
@@ -80,7 +95,20 @@ function ensureProject(workspace, name, domain) {
     const metadataPath = path_1.default.join(projectRoot, "metadata.json");
     let metadata;
     if (fs_1.default.existsSync(metadataPath)) {
-        metadata = JSON.parse(fs_1.default.readFileSync(metadataPath, "utf-8"));
+        const parsed = readJsonFile(metadataPath);
+        if (parsed) {
+            metadata = parsed;
+        }
+        else {
+            const now = new Date().toISOString();
+            metadata = {
+                name: project.name,
+                status: "backlog",
+                domain,
+                createdAt: now,
+                updatedAt: now
+            };
+        }
     }
     else {
         const now = new Date().toISOString();
@@ -93,8 +121,7 @@ function ensureProject(workspace, name, domain) {
         };
         fs_1.default.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
     }
-    const indexRaw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const index = JSON.parse(indexRaw);
+    const index = readWorkspaceIndex(workspace);
     index.projects = index.projects ?? [];
     const existing = index.projects.find((entry) => entry.name === project.name);
     if (existing) {
@@ -112,8 +139,7 @@ function createProject(workspace, name, domain) {
 function updateProjectStatus(workspace, name, status) {
     ensureWorkspace(workspace);
     const project = getProjectInfo(workspace, name);
-    const indexRaw = fs_1.default.readFileSync(workspace.indexPath, "utf-8");
-    const index = JSON.parse(indexRaw);
+    const index = readWorkspaceIndex(workspace);
     index.projects = index.projects ?? [];
     const existing = index.projects.find((entry) => entry.name === project.name);
     if (existing) {
@@ -125,8 +151,8 @@ function updateProjectStatus(workspace, name, status) {
     fs_1.default.writeFileSync(workspace.indexPath, JSON.stringify(index, null, 2), "utf-8");
     const projectRoot = project.root;
     const metadataPath = path_1.default.join(projectRoot, "metadata.json");
-    if (fs_1.default.existsSync(metadataPath)) {
-        const metadata = JSON.parse(fs_1.default.readFileSync(metadataPath, "utf-8"));
+    const metadata = fs_1.default.existsSync(metadataPath) ? readJsonFile(metadataPath) : null;
+    if (metadata) {
         metadata.status = status;
         metadata.updatedAt = new Date().toISOString();
         fs_1.default.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");

package/package.json

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