sdd-cli 0.1.19 → 0.1.21

package/dist/commands/req-lint.js

@@ -9,11 +9,12 @@ const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const index_1 = require("../workspace/index");
 const validate_1 = require("../validation/validate");
+const errors_1 = require("../errors");
 async function runReqLint() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1247", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -22,7 +23,7 @@ async function runReqLint() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1248", error.message);
         return;
     }
     const base = path_1.default.join(project.root, "requirements");
@@ -31,7 +32,7 @@ async function runReqLint() {
         .map((status) => path_1.default.join(base, status, reqId))
         .find((candidate) => fs_1.default.existsSync(candidate));
     if (!dir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1249", "Requirement not found.");
         return;
     }
     const schemaMap = {
@@ -49,12 +50,21 @@ async function runReqLint() {
         if (!fs_1.default.existsSync(filePath)) {
             continue;
         }
-        const data = JSON.parse(fs_1.default.readFileSync(filePath, "utf-8"));
+        let data;
+        try {
+            data = JSON.parse(fs_1.default.readFileSync(filePath, "utf-8"));
+        }
+        catch (error) {
+            failures += 1;
+            (0, errors_1.printError)("SDD-1250", `Invalid JSON: ${file}`);
+            (0, errors_1.printError)("SDD-1250", error.message);
+            continue;
+        }
         const result = (0, validate_1.validateJson)(schema, data);
         if (!result.valid) {
             failures += 1;
-            console.log(`Invalid: ${file}`);
-            result.errors.forEach((error) => console.log(`- ${error}`));
+            (0, errors_1.printError)("SDD-1250", `Invalid: ${file}`);
+            result.errors.forEach((error) => (0, errors_1.printError)("SDD-1250", error));
         }
         else {
             console.log(`Valid: ${file}`);

package/dist/commands/req-list.js

@@ -8,11 +8,12 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 const STATUSES = ["backlog", "wip", "in-progress", "done", "archived"];
 async function runReqList(statusFilter) {
     const projectName = await (0, prompt_1.askProjectName)();
     if (!projectName) {
-        console.log("Project name is required.");
+        (0, errors_1.printError)("SDD-1251", "Project name is required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -21,12 +22,12 @@ async function runReqList(statusFilter) {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1252", error.message);
         return;
     }
     const base = path_1.default.join(project.root, "requirements");
     if (!fs_1.default.existsSync(base)) {
-        console.log("No requirements found for this project.");
+        (0, errors_1.printError)("SDD-1253", "No requirements found for this project.");
         return;
     }
     const statuses = statusFilter ? STATUSES.filter((status) => status === statusFilter) : STATUSES;

package/dist/commands/req-plan.js

@@ -13,6 +13,7 @@ const render_1 = require("../templates/render");
 const list_1 = require("../utils/list");
 const gates_1 = require("../validation/gates");
 const validate_1 = require("../validation/validate");
+const errors_1 = require("../errors");
 function findRequirementDir(projectRoot, reqId) {
     const backlog = path_1.default.join(projectRoot, "requirements", "backlog", reqId);
     const wip = path_1.default.join(projectRoot, "requirements", "wip", reqId);
@@ -31,7 +32,7 @@ async function runReqPlan(options) {
     const projectName = options?.projectName ?? (await (0, prompt_1.askProjectName)());
     const reqId = options?.reqId ?? (await (0, prompt_1.ask)("Requirement ID (REQ-...): "));
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1211", "Project name and requirement ID are required.");
         return null;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -40,31 +41,31 @@ async function runReqPlan(options) {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1212", error.message);
         return null;
     }
     let requirementDir = findRequirementDir(project.root, reqId);
     if (!requirementDir) {
-        console.log("Requirement not found in backlog or wip.");
+        (0, errors_1.printError)("SDD-1213", "Requirement not found in backlog or wip.");
         return null;
     }
     const requirementJsonPath = path_1.default.join(requirementDir, "requirement.json");
     if (!fs_1.default.existsSync(requirementJsonPath)) {
-        console.log("Missing requirement.json. Run `req create` first.");
+        (0, errors_1.printError)("SDD-1214", "Missing requirement.json. Run `req create` first.");
         return null;
     }
     const requirementJson = JSON.parse(fs_1.default.readFileSync(requirementJsonPath, "utf-8"));
     let gates = (0, gates_1.checkRequirementGates)(requirementJson);
     if (!gates.ok) {
-        console.log("Requirement gates failed. Please update the requirement first:");
-        gates.missing.forEach((field) => console.log(`- ${field}`));
-        console.log("Run `sdd-cli req refine` to complete missing fields.");
+        (0, errors_1.printError)("SDD-1217", "Requirement gates failed. Please update the requirement first.");
+        gates.missing.forEach((field) => (0, errors_1.printError)("SDD-1217", field));
+        (0, errors_1.printError)("SDD-1217", "Run `sdd-cli req refine` to complete missing fields.");
         return null;
     }
     const requirementValidation = (0, validate_1.validateJson)("requirement.schema.json", requirementJson);
     if (!requirementValidation.valid) {
-        console.log("Requirement validation failed:");
-        requirementValidation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1215", "Requirement validation failed.");
+        requirementValidation.errors.forEach((error) => (0, errors_1.printError)("SDD-1215", error));
         return null;
     }
     const wipDir = path_1.default.join(project.root, "requirements", "wip", reqId);
@@ -147,8 +148,8 @@ async function runReqPlan(options) {
     ];
     const failures = validations.flatMap((result) => result.errors);
     if (failures.length > 0) {
-        console.log("Spec validation failed:");
-        failures.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1216", "Spec validation failed.");
+        failures.forEach((error) => (0, errors_1.printError)("SDD-1216", error));
         return null;
     }
     const functionalTemplate = (0, render_1.loadTemplate)("functional-spec");

package/dist/commands/req-refine.js

@@ -13,6 +13,7 @@ const render_1 = require("../templates/render");
 const list_1 = require("../utils/list");
 const gates_1 = require("../validation/gates");
 const validate_1 = require("../validation/validate");
+const errors_1 = require("../errors");
 function findRequirementFile(projectRoot, reqId) {
     const base = path_1.default.join(projectRoot, "requirements");
     const candidates = [
@@ -27,7 +28,7 @@ async function runReqRefine() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1261", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -36,12 +37,12 @@ async function runReqRefine() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1262", error.message);
         return;
     }
     const reqPath = findRequirementFile(project.root, reqId);
     if (!reqPath) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1263", "Requirement not found.");
         return;
     }
     const raw = JSON.parse(fs_1.default.readFileSync(reqPath, "utf-8"));
@@ -79,7 +80,7 @@ async function runReqRefine() {
     };
     let gates = (0, gates_1.checkRequirementGates)(updated);
     if (!gates.ok) {
-        console.log("Requirement gates failed. Please provide missing fields:");
+        (0, errors_1.printError)("SDD-1264", "Requirement gates failed. Please provide missing fields.");
         for (const field of gates.missing) {
             if (field === "objective") {
                 updated.objective = await (0, prompt_1.ask)(`Objective (${updated.objective}): `);
@@ -112,15 +113,15 @@ async function runReqRefine() {
         updated.updatedAt = new Date().toISOString();
         gates = (0, gates_1.checkRequirementGates)(updated);
         if (!gates.ok) {
-            console.log("Requirement gates still failing. Missing:");
-            gates.missing.forEach((field) => console.log(`- ${field}`));
+            (0, errors_1.printError)("SDD-1265", "Requirement gates still failing.");
+            gates.missing.forEach((field) => (0, errors_1.printError)("SDD-1265", field));
             return;
         }
     }
     const validation = (0, validate_1.validateJson)("requirement.schema.json", updated);
     if (!validation.valid) {
-        console.log("Requirement validation failed:");
-        validation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1266", "Requirement validation failed.");
+        validation.errors.forEach((error) => (0, errors_1.printError)("SDD-1266", error));
         return;
     }
     fs_1.default.writeFileSync(reqPath, JSON.stringify(updated, null, 2), "utf-8");

package/dist/commands/req-report.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 const REQUIRED_FILES = [
     "requirement.json",
     "functional-spec.json",
@@ -20,7 +21,7 @@ async function runReqReport() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1257", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -29,29 +30,29 @@ async function runReqReport() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1258", error.message);
         return;
     }
     const base = path_1.default.join(project.root, "requirements");
     const statuses = ["backlog", "wip", "in-progress", "done", "archived"];
     const dir = statuses.map((status) => path_1.default.join(base, status, reqId)).find((candidate) => fs_1.default.existsSync(candidate));
     if (!dir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1259", "Requirement not found.");
         return;
     }
     console.log(`Requirement report: ${reqId}`);
-    let missing = 0;
+    let absentCount = 0;
     for (const file of REQUIRED_FILES) {
         const exists = fs_1.default.existsSync(path_1.default.join(dir, file));
-        console.log(`${exists ? "OK" : "MISSING"}: ${file}`);
+        console.log(`${exists ? "OK" : "ABSENT"}: ${file}`);
         if (!exists)
-            missing += 1;
+            absentCount += 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`);
+    console.log(`${projectReadmeExists ? "OK" : "ABSENT"}: ../project-readme.json`);
     if (!projectReadmeExists) {
-        missing += 1;
+        absentCount += 1;
     }
-    console.log(`Missing files: ${missing}`);
+    console.log(`Absent files: ${absentCount}`);
 }

package/dist/commands/req-start.js

@@ -12,6 +12,7 @@ const index_1 = require("../workspace/index");
 const render_1 = require("../templates/render");
 const list_1 = require("../utils/list");
 const validate_1 = require("../validation/validate");
+const errors_1 = require("../errors");
 function findRequirementDir(projectRoot, reqId) {
     const backlog = path_1.default.join(projectRoot, "requirements", "backlog", reqId);
     const wip = path_1.default.join(projectRoot, "requirements", "wip", reqId);
@@ -33,7 +34,7 @@ async function runReqStart(options) {
     const projectName = options?.projectName ?? (await (0, prompt_1.askProjectName)());
     const reqId = options?.reqId ?? (await (0, prompt_1.ask)("Requirement ID (REQ-...): "));
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1221", "Project name and requirement ID are required.");
         return null;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -42,12 +43,12 @@ async function runReqStart(options) {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1222", error.message);
         return null;
     }
     let requirementDir = findRequirementDir(project.root, reqId);
     if (!requirementDir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1223", "Requirement not found.");
         return null;
     }
     const requirementPath = requirementDir;
@@ -59,16 +60,16 @@ async function runReqStart(options) {
     ];
     const missing = requiredSpecs.filter((spec) => !fs_1.default.existsSync(path_1.default.join(requirementPath, spec.file)));
     if (missing.length > 0) {
-        console.log("Cannot start. Missing specs:");
-        missing.forEach((spec) => console.log(`- ${spec.file}`));
+        (0, errors_1.printError)("SDD-1224", "Cannot start. Missing specs.");
+        missing.forEach((spec) => (0, errors_1.printError)("SDD-1224", spec.file));
         return null;
     }
     for (const spec of requiredSpecs) {
         const data = JSON.parse(fs_1.default.readFileSync(path_1.default.join(requirementPath, spec.file), "utf-8"));
         const result = (0, validate_1.validateJson)(spec.schema, data);
         if (!result.valid) {
-            console.log(`Spec validation failed for ${spec.file}:`);
-            result.errors.forEach((error) => console.log(`- ${error}`));
+            (0, errors_1.printError)("SDD-1225", `Spec validation failed for ${spec.file}.`);
+            result.errors.forEach((error) => (0, errors_1.printError)("SDD-1225", error));
             return null;
         }
     }
@@ -114,8 +115,8 @@ async function runReqStart(options) {
     };
     const validation = (0, validate_1.validateJson)("quality.schema.json", qualityJson);
     if (!validation.valid) {
-        console.log("Quality validation failed:");
-        validation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1226", "Quality validation failed.");
+        validation.errors.forEach((error) => (0, errors_1.printError)("SDD-1226", error));
         return null;
     }
     fs_1.default.writeFileSync(path_1.default.join(targetDir, "implementation-plan.md"), rendered, "utf-8");

package/dist/commands/req-status.js

@@ -8,11 +8,12 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 async function runReqStatus() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1254", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -21,7 +22,7 @@ async function runReqStatus() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1255", error.message);
         return;
     }
     const base = path_1.default.join(project.root, "requirements");
@@ -33,5 +34,5 @@ async function runReqStatus() {
             return;
         }
     }
-    console.log("Requirement not found.");
+    (0, errors_1.printError)("SDD-1256", "Requirement not found.");
 }

package/dist/commands/route.js

@@ -4,10 +4,25 @@ exports.runRoute = runRoute;
 const intent_1 = require("../router/intent");
 const flow_1 = require("../router/flow");
 const prompt_packs_1 = require("../router/prompt-packs");
+const errors_1 = require("../errors");
 function runRoute(input) {
-    const intent = (0, intent_1.classifyIntent)(input);
-    const flow = (0, flow_1.loadFlow)(intent.flow);
-    const packs = (0, prompt_packs_1.loadPromptPacks)();
+    const text = input.trim();
+    if (!text) {
+        (0, errors_1.printError)("SDD-1423", "Route input is required.");
+        return;
+    }
+    let intent;
+    let flow;
+    let packs;
+    try {
+        intent = (0, intent_1.classifyIntent)(text);
+        flow = (0, flow_1.loadFlow)(intent.flow);
+        packs = (0, prompt_packs_1.loadPromptPacks)();
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1424", `Unable to load route context: ${error.message}`);
+        return;
+    }
     const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
     console.log(JSON.stringify(intent, null, 2));
     if (flow) {
@@ -15,7 +30,7 @@ function runRoute(input) {
         console.log(flow);
     }
     else {
-        console.log("\nNo flow script found.");
+        (0, errors_1.printError)("SDD-1425", `No flow script found for ${intent.flow}.`);
     }
     if (packIds.length > 0) {
         console.log("\n--- Prompt packs ---\n");

package/dist/commands/scope-list.d.ts

@@ -0,0 +1 @@
+export declare function runScopeList(): void;

package/dist/commands/scope-list.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScopeList = runScopeList;
+const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
+function runScopeList() {
+    const baseRoot = (0, index_1.getWorkspaceBaseRoot)();
+    const scopes = (0, index_1.listScopes)(baseRoot);
+    if (scopes.length === 0) {
+        (0, errors_1.printError)("SDD-1412", "No scopes available in workspace.");
+        return;
+    }
+    console.log(`Workspace base: ${baseRoot}`);
+    console.log("Scopes:");
+    scopes.forEach((scope) => console.log(`- ${scope}`));
+}

package/dist/commands/scope-status.d.ts

@@ -0,0 +1 @@
+export declare function runScopeStatus(scopeInput?: string): void;

package/dist/commands/scope-status.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScopeStatus = runScopeStatus;
+const flags_1 = require("../context/flags");
+const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
+function runScopeStatus(scopeInput) {
+    const flags = (0, flags_1.getFlags)();
+    const scope = scopeInput?.trim() || flags.scope || "";
+    if (!scope) {
+        (0, errors_1.printError)("SDD-1411", "Scope is required. Use: sdd-cli scope status <scope-name>");
+        return;
+    }
+    const workspace = (0, index_1.getWorkspaceInfoForScope)(scope);
+    (0, index_1.ensureWorkspace)(workspace);
+    const projects = (0, index_1.listProjects)(workspace);
+    console.log(`Scope: ${scope}`);
+    console.log(`Workspace: ${workspace.root}`);
+    if (projects.length === 0) {
+        console.log("No projects found for scope.");
+        return;
+    }
+    const byStatus = projects.reduce((acc, project) => {
+        acc[project.status] = (acc[project.status] || 0) + 1;
+        return acc;
+    }, {});
+    console.log(`Projects: ${projects.length}`);
+    Object.keys(byStatus)
+        .sort()
+        .forEach((status) => {
+        console.log(`- ${status}: ${byStatus[status]}`);
+    });
+}

package/dist/commands/status.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const flags_1 = require("../context/flags");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 const REQUIREMENT_STATUSES = ["backlog", "wip", "in-progress", "done", "archived"];
 function listRequirementIds(projectRoot, status) {
     const dir = path_1.default.join(projectRoot, "requirements", status);
@@ -26,23 +27,28 @@ function latestId(ids) {
     }
     return ids[ids.length - 1];
 }
+function scopePrefix() {
+    const flags = (0, flags_1.getFlags)();
+    return flags.scope && flags.scope.trim().length > 0 ? `--scope "${flags.scope.trim()}" ` : "";
+}
 function recommendNext(projectName, counts, ids) {
+    const prefix = scopePrefix();
     const nextInProgress = latestId(ids["in-progress"]);
     if (nextInProgress) {
-        return `sdd-cli --project "${projectName}" req finish  # then enter ${nextInProgress} when prompted`;
+        return `sdd-cli ${prefix}--project "${projectName}" req finish  # then enter ${nextInProgress} when prompted`;
     }
     const nextWip = latestId(ids.wip);
     if (nextWip) {
-        return `sdd-cli --project "${projectName}" req start  # then enter ${nextWip} when prompted`;
+        return `sdd-cli ${prefix}--project "${projectName}" req start  # then enter ${nextWip} when prompted`;
     }
     const nextBacklog = latestId(ids.backlog);
     if (nextBacklog) {
-        return `sdd-cli --project "${projectName}" req plan  # then enter ${nextBacklog} when prompted`;
+        return `sdd-cli ${prefix}--project "${projectName}" req plan  # then enter ${nextBacklog} when prompted`;
     }
     if (counts.done > 0 && counts.archived === 0) {
-        return `sdd-cli --project "${projectName}" hello "start next requirement"`;
+        return `sdd-cli ${prefix}--project "${projectName}" hello "start next requirement"`;
     }
-    return `sdd-cli --project "${projectName}" hello "continue"`;
+    return `sdd-cli ${prefix}--project "${projectName}" hello "continue"`;
 }
 function runStatus(showNext) {
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -62,11 +68,11 @@ function runStatus(showNext) {
         project = (0, index_1.getProjectInfo)(workspace, selectedName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1401", error.message);
         return;
     }
     if (!fs_1.default.existsSync(project.root)) {
-        console.log("No projects found.");
+        (0, errors_1.printError)("SDD-1402", `Selected project not found in workspace: ${project.name}`);
         if (showNext) {
             console.log('Next command: sdd-cli quickstart --example saas');
         }
@@ -86,6 +92,9 @@ function runStatus(showNext) {
         done: ids.done.length,
         archived: ids.archived.length
     };
+    if (flags.scope && flags.scope.trim().length > 0) {
+        console.log(`Scope: ${flags.scope.trim()}`);
+    }
     console.log(`Project: ${project.name}`);
     REQUIREMENT_STATUSES.forEach((status) => {
         console.log(`- ${status}: ${counts[status]}`);

package/dist/commands/test-plan.js

@@ -12,6 +12,7 @@ const render_1 = require("../templates/render");
 const list_1 = require("../utils/list");
 const validate_1 = require("../validation/validate");
 const flags_1 = require("../context/flags");
+const errors_1 = require("../errors");
 function findRequirementDir(projectRoot, reqId) {
     const base = path_1.default.join(projectRoot, "requirements");
     const statuses = ["backlog", "wip", "in-progress", "done", "archived"];
@@ -32,7 +33,7 @@ async function runTestPlan(options) {
     const projectName = options?.projectName ?? (await (0, prompt_1.askProjectName)());
     const reqId = options?.reqId ?? (await (0, prompt_1.ask)("Requirement ID (REQ-...): "));
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1271", "Project name and requirement ID are required.");
         return null;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -41,12 +42,12 @@ async function runTestPlan(options) {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1272", error.message);
         return null;
     }
     const requirementDir = findRequirementDir(project.root, reqId);
     if (!requirementDir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1273", "Requirement not found.");
         return null;
     }
     const seed = defaultSeed(options?.seedText);
@@ -66,8 +67,8 @@ async function runTestPlan(options) {
     };
     const validation = (0, validate_1.validateJson)("test-plan.schema.json", testPlanJson);
     if (!validation.valid) {
-        console.log("Test plan validation failed:");
-        validation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1274", "Test plan validation failed.");
+        validation.errors.forEach((error) => (0, errors_1.printError)("SDD-1274", error));
         return null;
     }
     const template = (0, render_1.loadTemplate)("test-plan");

package/dist/context/flags.d.ts

@@ -8,6 +8,8 @@ export type RuntimeFlags = {
     fromStep?: string;
     project?: string;
     output?: string;
+    scope?: string;
+    metricsLocal?: boolean;
 };
 export declare function setFlags(next: Partial<RuntimeFlags>): void;
 export declare function getFlags(): RuntimeFlags;

package/dist/context/flags.js

@@ -11,7 +11,9 @@ const flags = {
     beginner: false,
     fromStep: undefined,
     project: undefined,
-    output: undefined
+    output: undefined,
+    scope: undefined,
+    metricsLocal: false
 };
 function setFlags(next) {
     if ("approve" in next) {
@@ -41,6 +43,12 @@ function setFlags(next) {
     if ("output" in next) {
         flags.output = typeof next.output === "string" ? next.output : undefined;
     }
+    if ("scope" in next) {
+        flags.scope = typeof next.scope === "string" ? next.scope : undefined;
+    }
+    if ("metricsLocal" in next) {
+        flags.metricsLocal = Boolean(next.metricsLocal);
+    }
 }
 function getFlags() {
     return { ...flags };

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function formatError(code: string, message: string): string;
+export declare function printError(code: string, message: string): void;

package/dist/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatError = formatError;
+exports.printError = printError;
+function formatError(code, message) {
+    return `[${code}] ${message}`;
+}
+function printError(code, message) {
+    console.log(formatError(code, message));
+}

package/dist/paths.js

@@ -6,5 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRepoRoot = getRepoRoot;
 const path_1 = __importDefault(require("path"));
 function getRepoRoot() {
+    const override = process.env.SDD_REPO_ROOT?.trim();
+    if (override) {
+        return path_1.default.resolve(override);
+    }
     return path_1.default.resolve(__dirname, "..");
 }

package/dist/telemetry/local-metrics.d.ts

@@ -0,0 +1,2 @@
+export declare function recordCommandMetric(command: string): void;
+export declare function recordActivationMetric(type: "started" | "completed", data?: Record<string, string | number | boolean>): void;