sdd-cli 0.1.5 → 0.1.6

package/README.md

@@ -12,6 +12,12 @@ Build the foundation once, then lift everything else. The tool provides a durabl
 
 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`.
+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`
@@ -55,6 +61,10 @@ Examples and templates:
 - `examples/schemas/`
 - `examples/diagrams/`
 - `examples/packs/`
+- `examples/README.md`
+- `templates/README.md`
+- `schemas/README.md`
+- `flows/README.md`
 - `templates/`
 - `schemas/`
 

package/dist/cli.js

@@ -46,6 +46,7 @@ const route_1 = require("./commands/route");
 const doctor_1 = require("./commands/doctor");
 const paths_1 = require("./paths");
 const flags_1 = require("./context/flags");
+const prompt_1 = require("./ui/prompt");
 const program = new commander_1.Command();
 function getVersion() {
     try {
@@ -76,6 +77,9 @@ program.hook("preAction", (thisCommand, actionCommand) => {
         output: typeof opts.output === "string" ? opts.output : undefined
     });
 });
+program.hook("postAction", () => {
+    (0, prompt_1.closePrompt)();
+});
 program
     .command("hello")
     .description("Start an interactive session and route intent")

package/dist/commands/hello.js

@@ -8,12 +8,30 @@ const prompt_packs_1 = require("../router/prompt-packs");
 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");
 async function runHello(input, runQuestions) {
-    const workspace = (0, index_1.getWorkspaceInfo)();
-    (0, index_1.ensureWorkspace)(workspace);
-    const projects = (0, index_1.listProjects)(workspace);
+    function loadWorkspace() {
+        const workspace = (0, index_1.getWorkspaceInfo)();
+        (0, index_1.ensureWorkspace)(workspace);
+        const projects = (0, index_1.listProjects)(workspace);
+        return { workspace, projects };
+    }
+    let { workspace, projects } = loadWorkspace();
     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;
+        }
+        (0, flags_1.setFlags)({ output: nextPath });
+        const reloaded = loadWorkspace();
+        workspace = reloaded.workspace;
+        projects = reloaded.projects;
+        console.log(`Workspace updated: ${workspace.root}`);
+    }
     const flags = (0, flags_1.getFlags)();
     if (projects.length > 0) {
         console.log("Active projects:");
@@ -49,8 +67,15 @@ async function runHello(input, runQuestions) {
     }
     const intent = (0, intent_1.classifyIntent)(text);
     console.log(`Detected intent: ${intent.intent} -> ${intent.flow}`);
-    console.log("Next: run `sdd-cli route <your input>` to view details.");
-    if (runQuestions) {
+    const showRoute = await (0, prompt_1.confirm)("View route details now? (y/n) ");
+    if (showRoute) {
+        (0, route_1.runRoute)(text);
+    }
+    else {
+        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) "));
+    if (shouldRunQuestions) {
         const packs = (0, prompt_packs_1.loadPromptPacks)();
         const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
         const answers = {};
@@ -78,4 +103,9 @@ async function runHello(input, runQuestions) {
             }
         }
     }
+    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/ui/prompt.d.ts

@@ -1,3 +1,4 @@
+export declare function closePrompt(): void;
 export declare function ask(question: string): Promise<string>;
 export declare function askProjectName(prompt?: string): Promise<string>;
 export declare function confirm(question: string): Promise<boolean>;

package/dist/ui/prompt.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.closePrompt = closePrompt;
 exports.ask = ask;
 exports.askProjectName = askProjectName;
 exports.confirm = confirm;
@@ -10,6 +11,7 @@ const fs_1 = __importDefault(require("fs"));
 const readline_1 = __importDefault(require("readline"));
 const flags_1 = require("../context/flags");
 let queuedAnswers = null;
+let rl = null;
 function getQueuedAnswers() {
     if (queuedAnswers) {
         return queuedAnswers;
@@ -22,11 +24,24 @@ function getQueuedAnswers() {
     queuedAnswers = [];
     return queuedAnswers;
 }
-const rl = readline_1.default.createInterface({
-    input: process.stdin,
-    output: process.stdout
-});
-process.on("exit", () => rl.close());
+function getInterface() {
+    if (rl) {
+        return rl;
+    }
+    rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return rl;
+}
+function closePrompt() {
+    if (!rl) {
+        return;
+    }
+    rl.close();
+    rl = null;
+}
+process.on("exit", () => closePrompt());
 function ask(question) {
     if (!process.stdin.isTTY) {
         const queue = getQueuedAnswers();
@@ -34,7 +49,8 @@ function ask(question) {
         return Promise.resolve(answer.trim());
     }
     return new Promise((resolve) => {
-        rl.question(question, (answer) => {
+        const prompt = getInterface();
+        prompt.question(question, (answer) => {
             resolve(answer.trim());
         });
     });

package/flows/README.md

@@ -1,29 +1,3 @@
-# Flows (domain playbooks)
-
-These flows show how the tool should guide real users from discovery to completion.
-
-- `LAWYER.md`
-- `TEACHER.md`
-- `ADMISSIONS_ADMIN.md`
-- `STATE_ADMIN.md`
-- `TAXES_ADMIN.md`
-- `STUDENT_UNIVERSITY.md`
-- `DATA_SCIENTIST.md`
-- `PROGRAMMER.md`
-- `BUG_FIX.md`
-- `ECOMMERCE.md`
-- `RETAIL_STORE.md`
-- `COURT_SYSTEM.md`
-- `GRAPHIC_DESIGN.md`
-- `ART.md`
-- `HISTORY.md`
-- `SOCIOLOGY.md`
-- `ECONOMICS.md`
-- `PR_REVIEW.md`
-
-Each flow includes:
-- Discovery questions
-- Required artifacts
-- Risk and compliance notes
-- Acceptance criteria examples
-- Recommended outputs and handoff steps
+# Flows
+
+Domain playbooks used by the router and discovery flows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "SDD-first, AI-native CLI for end-to-end delivery.",
   "homepage": "https://github.com/jdsalasca/sdd-tool#readme",
   "repository": {
@@ -27,6 +27,7 @@
     "build": "tsc -p tsconfig.json",
     "start": "node dist/cli.js",
     "dev": "ts-node src/cli.ts",
+    "preinstall": "node scripts/preinstall.js",
     "pretest": "npm run build",
     "test": "node --test tests/*.test.js"
   },

package/router/README.md

@@ -1,23 +1,25 @@
-# Router scripts
-
-These scripts define intent detection and the step-by-step conversation for each flow.
-
-Each script includes:
-- Entry signals
-- Required questions
-- Required outputs
-- Gate checks
-- Suggested agent roles
-- Scripted Q/A tree with optional branches
-
-Available flows:
-- BUG_FIX
-- LEARN
-- SOFTWARE_FEATURE
-- DATA_SCIENCE
-- DESIGN
-- HUMANITIES
-- BUSINESS
-- LEGAL
-- PR_REVIEW
-- GENERIC
+# Router scripts
+
+These scripts define intent detection and the step-by-step conversation for each flow.
+
+See `flows/README.md` for the domain playbooks.
+
+Each script includes:
+- Entry signals
+- Required questions
+- Required outputs
+- Gate checks
+- Suggested agent roles
+- Scripted Q/A tree with optional branches
+
+Available flows:
+- BUG_FIX
+- LEARN
+- SOFTWARE_FEATURE
+- DATA_SCIENCE
+- DESIGN
+- HUMANITIES
+- BUSINESS
+- LEGAL
+- PR_REVIEW
+- GENERIC

package/schemas/README.md

@@ -0,0 +1,7 @@
+# Schemas
+
+JSON schemas for artifacts and workspace state.
+
+## Usage
+- Used by `sdd-cli doctor` and validators.
+- Keep schema filenames consistent with artifact names.

package/templates/README.md

@@ -0,0 +1,12 @@
+# Templates
+
+Markdown and YAML templates used to generate SDD artifacts.
+
+## Index
+- `templates/template-index.json` lists all templates and placeholders.
+- `templates/gate-index.json` lists gate prompt templates.
+- `templates/prompt-pack-index.json` lists prompt packs.
+
+## Rules
+- Keep placeholders aligned with `templates/validate` rules.
+- Use lowercase file names with dashes (`functional-spec.md`).