sdd-cli 0.1.0

package/dist/commands/gen-project-readme.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenProjectReadme = runGenProjectReadme;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const render_1 = require("../templates/render");
+const validate_1 = require("../validation/validate");
+const gen_utils_1 = require("./gen-utils");
+const flags_1 = require("../context/flags");
+async function runGenProjectReadme() {
+    const projectName = await (0, prompt_1.ask)("Project name: ");
+    const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
+    if (!projectName || !reqId) {
+        console.log("Project name and requirement ID are required.");
+        return;
+    }
+    const requirementDir = (0, gen_utils_1.findRequirementDir)(projectName, reqId);
+    if (!requirementDir) {
+        console.log("Requirement not found.");
+        return;
+    }
+    const overview = await (0, prompt_1.ask)("Project overview: ");
+    const howToRun = await (0, prompt_1.ask)("How to run: ");
+    const architectureSummary = await (0, prompt_1.ask)("Architecture summary: ");
+    const requirementsLink = await (0, prompt_1.ask)("Requirements link/path: ");
+    const functionalSpecLink = await (0, prompt_1.ask)("Functional spec link/path: ");
+    const technicalSpecLink = await (0, prompt_1.ask)("Technical spec link/path: ");
+    const architectureLink = await (0, prompt_1.ask)("Architecture link/path: ");
+    const testingNotes = await (0, prompt_1.ask)("Testing notes: ");
+    const flags = (0, flags_1.getFlags)();
+    const improveNote = flags.improve ? await (0, prompt_1.ask)("Improve focus (optional): ") : "";
+    const projectReadmeJson = {
+        projectName,
+        overview: overview || "N/A",
+        howToRun: howToRun || "N/A",
+        architectureSummary: architectureSummary || "N/A",
+        specs: {
+            requirements: requirementsLink || "requirements/requirement.md",
+            functionalSpec: functionalSpecLink || "requirements/functional-spec.md",
+            technicalSpec: technicalSpecLink || "requirements/technical-spec.md",
+            architecture: architectureLink || "requirements/architecture.md"
+        },
+        testingNotes: testingNotes || "N/A"
+    };
+    const validation = (0, validate_1.validateJson)("project-readme.schema.json", projectReadmeJson);
+    if (!validation.valid) {
+        console.log("Project README validation failed:");
+        validation.errors.forEach((error) => console.log(`- ${error}`));
+        return;
+    }
+    const template = (0, render_1.loadTemplate)("project-readme");
+    const rendered = (0, render_1.renderTemplate)(template, {
+        project_name: projectName,
+        overview: projectReadmeJson.overview,
+        how_to_run: projectReadmeJson.howToRun,
+        architecture_summary: projectReadmeJson.architectureSummary,
+        requirements_link: projectReadmeJson.specs.requirements,
+        functional_spec_link: projectReadmeJson.specs.functionalSpec,
+        technical_spec_link: projectReadmeJson.specs.technicalSpec,
+        architecture_link: projectReadmeJson.specs.architecture,
+        testing_notes: projectReadmeJson.testingNotes
+    });
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "project-readme.md"), rendered, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "project-readme.json"), JSON.stringify(projectReadmeJson, null, 2), "utf-8");
+    (0, gen_utils_1.appendProgress)(requirementDir, `generated project readme for ${reqId}`);
+    (0, gen_utils_1.appendImprove)(requirementDir, improveNote);
+    console.log(`Project README generated in ${requirementDir}`);
+}

package/dist/commands/gen-requirements.d.ts

@@ -0,0 +1 @@
+export declare function runGenRequirements(): Promise<void>;

package/dist/commands/gen-requirements.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenRequirements = runGenRequirements;
+const req_create_1 = require("./req-create");
+async function runGenRequirements() {
+    await (0, req_create_1.runReqCreate)();
+}

package/dist/commands/gen-technical-spec.d.ts

@@ -0,0 +1 @@
+export declare function runGenTechnicalSpec(): Promise<void>;

package/dist/commands/gen-technical-spec.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenTechnicalSpec = runGenTechnicalSpec;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const render_1 = require("../templates/render");
+const list_1 = require("../utils/list");
+const validate_1 = require("../validation/validate");
+const gen_utils_1 = require("./gen-utils");
+const flags_1 = require("../context/flags");
+async function runGenTechnicalSpec() {
+    const projectName = await (0, prompt_1.ask)("Project name: ");
+    const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
+    if (!projectName || !reqId) {
+        console.log("Project name and requirement ID are required.");
+        return;
+    }
+    const requirementDir = (0, gen_utils_1.findRequirementDir)(projectName, reqId);
+    if (!requirementDir) {
+        console.log("Requirement not found.");
+        return;
+    }
+    const stack = await (0, prompt_1.ask)("Tech stack - comma separated: ");
+    const interfaces = await (0, prompt_1.ask)("Interfaces - comma separated: ");
+    const dataModel = await (0, prompt_1.ask)("Data model - comma separated: ");
+    const security = await (0, prompt_1.ask)("Security - comma separated: ");
+    const errors = await (0, prompt_1.ask)("Error handling - comma separated: ");
+    const performance = await (0, prompt_1.ask)("Performance - comma separated: ");
+    const observability = await (0, prompt_1.ask)("Observability - comma separated: ");
+    const flags = (0, flags_1.getFlags)();
+    const improveNote = flags.improve ? await (0, prompt_1.ask)("Improve focus (optional): ") : "";
+    const technicalJson = {
+        stack: (0, list_1.parseList)(stack),
+        interfaces: (0, list_1.parseList)(interfaces),
+        dataModel: (0, list_1.parseList)(dataModel),
+        security: (0, list_1.parseList)(security),
+        errors: (0, list_1.parseList)(errors),
+        performance: (0, list_1.parseList)(performance),
+        observability: (0, list_1.parseList)(observability)
+    };
+    const validation = (0, validate_1.validateJson)("technical-spec.schema.json", technicalJson);
+    if (!validation.valid) {
+        console.log("Technical spec validation failed:");
+        validation.errors.forEach((error) => console.log(`- ${error}`));
+        return;
+    }
+    const template = (0, render_1.loadTemplate)("technical-spec");
+    const rendered = (0, render_1.renderTemplate)(template, {
+        title: projectName,
+        stack: (0, list_1.formatList)(stack),
+        interfaces: (0, list_1.formatList)(interfaces),
+        data_model: (0, list_1.formatList)(dataModel),
+        security: (0, list_1.formatList)(security),
+        errors: (0, list_1.formatList)(errors),
+        performance: (0, list_1.formatList)(performance),
+        observability: (0, list_1.formatList)(observability)
+    });
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "technical-spec.md"), rendered, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "technical-spec.json"), JSON.stringify(technicalJson, null, 2), "utf-8");
+    (0, gen_utils_1.appendProgress)(requirementDir, `generated technical spec for ${reqId}`);
+    (0, gen_utils_1.appendImprove)(requirementDir, improveNote);
+    console.log(`Technical spec generated in ${requirementDir}`);
+}

package/dist/commands/gen-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function findRequirementDir(projectName: string, reqId: string): string | null;
+export declare function ensureProgressLog(dir: string): void;
+export declare function appendProgress(dir: string, message: string): void;
+export declare function appendImprove(dir: string, note?: string): void;

package/dist/commands/gen-utils.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findRequirementDir = findRequirementDir;
+exports.ensureProgressLog = ensureProgressLog;
+exports.appendProgress = appendProgress;
+exports.appendImprove = appendImprove;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../workspace/index");
+const flags_1 = require("../context/flags");
+function findRequirementDir(projectName, reqId) {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    const base = path_1.default.join(workspace.root, projectName, "requirements");
+    const statuses = ["backlog", "wip", "in-progress", "done", "archived"];
+    for (const status of statuses) {
+        const candidate = path_1.default.join(base, status, reqId);
+        if (fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function ensureProgressLog(dir) {
+    const progressLog = path_1.default.join(dir, "progress-log.md");
+    if (!fs_1.default.existsSync(progressLog)) {
+        fs_1.default.writeFileSync(progressLog, "# Progress Log\n\n", "utf-8");
+    }
+}
+function appendProgress(dir, message) {
+    ensureProgressLog(dir);
+    const logEntry = `\n- ${new Date().toISOString()} ${message}\n`;
+    fs_1.default.appendFileSync(path_1.default.join(dir, "progress-log.md"), logEntry, "utf-8");
+}
+function appendImprove(dir, note) {
+    const flags = (0, flags_1.getFlags)();
+    if (!flags.improve) {
+        return;
+    }
+    const message = note && note.trim().length > 0 ? `improve: ${note.trim()}` : "improve: refinement requested";
+    appendProgress(dir, message);
+}

package/dist/commands/hello.d.ts

@@ -0,0 +1 @@
+export declare function runHello(input: string, runQuestions?: boolean): Promise<void>;

package/dist/commands/hello.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHello = runHello;
+const intent_1 = require("../router/intent");
+const index_1 = require("../workspace/index");
+const prompt_1 = require("../ui/prompt");
+const prompt_packs_1 = require("../router/prompt-packs");
+const prompt_map_1 = require("../router/prompt-map");
+const req_create_1 = require("./req-create");
+async function runHello(input, runQuestions) {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    (0, index_1.ensureWorkspace)(workspace);
+    const projects = (0, index_1.listProjects)(workspace);
+    console.log("Hello from sdd-tool.");
+    console.log(`Workspace: ${workspace.root}`);
+    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) ");
+        console.log(`Selected: ${choice || "new"}`);
+    }
+    else {
+        console.log("No active projects found.");
+    }
+    const text = input || (await (0, prompt_1.ask)("Describe what you want to do: "));
+    if (!text) {
+        console.log("No input provided. Try again with a short description.");
+        return;
+    }
+    const intent = (0, intent_1.classifyIntent)(text);
+    console.log(`Detected intent: ${intent.intent} -> ${intent.flow}`);
+    console.log("Next: run `sdd-tool route <your input>` to view details.");
+    if (runQuestions) {
+        const packs = (0, prompt_packs_1.loadPromptPacks)();
+        const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
+        const answers = {};
+        for (const packId of packIds) {
+            const pack = (0, prompt_packs_1.getPromptPackById)(packs, packId);
+            if (!pack)
+                continue;
+            console.log(`\n[${pack.id}]`);
+            for (const question of pack.questions) {
+                const response = await (0, prompt_1.ask)(`${question} `);
+                answers[question] = response;
+            }
+        }
+        console.log("\nCaptured answers:");
+        Object.entries(answers).forEach(([question, response]) => {
+            console.log(`- ${question} -> ${response}`);
+        });
+        if (runQuestions && Object.keys(answers).length > 0) {
+            const mapped = (0, prompt_map_1.mapAnswersToRequirement)(answers);
+            console.log("\nDraft requirement fields:");
+            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);
+            }
+        }
+    }
+}

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const index_1 = require("../workspace/index");
+function runInit() {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    (0, index_1.ensureWorkspace)(workspace);
+    console.log(`Workspace initialized at: ${workspace.root}`);
+}

package/dist/commands/learn-deliver.d.ts

@@ -0,0 +1 @@
+export declare function runLearnDeliver(): Promise<void>;

package/dist/commands/learn-deliver.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLearnDeliver = runLearnDeliver;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const list_1 = require("../utils/list");
+const learn_utils_1 = require("./learn-utils");
+async function runLearnDeliver() {
+    const projectName = await (0, prompt_1.ask)("Project name: ");
+    if (!projectName) {
+        console.log("Project name is required.");
+        return;
+    }
+    const sessions = (0, learn_utils_1.listLearnSessions)(projectName);
+    if (sessions.length > 0) {
+        console.log("Available sessions:");
+        sessions.forEach((session) => console.log(`- ${session}`));
+    }
+    const sessionId = await (0, prompt_1.ask)("Session ID: ");
+    if (!sessionId) {
+        console.log("Session ID is required.");
+        return;
+    }
+    const loaded = (0, learn_utils_1.loadLearnSession)(projectName, sessionId);
+    if (!loaded) {
+        console.log("Learning session not found.");
+        return;
+    }
+    const brief = await (0, prompt_1.ask)("Brief summary: ");
+    const deepDive = await (0, prompt_1.ask)("Deep dive notes: ");
+    const readingList = await (0, prompt_1.ask)("Reading list - comma separated: ");
+    const questions = await (0, prompt_1.ask)("Questions - comma separated: ");
+    const answers = await (0, prompt_1.ask)("Answers - comma separated (aligned by order): ");
+    const qList = (0, list_1.parseList)(questions);
+    const aList = (0, list_1.parseList)(answers);
+    const qaItems = qList.map((question, index) => {
+        const answer = aList[index] ?? "TBD";
+        return `- Q: ${question}\n  A: ${answer}`;
+    });
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "brief.md"), `# Brief: ${loaded.session.topic}\n\n${brief || "N/A"}\n`, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "deep-dive.md"), `# Deep Dive: ${loaded.session.topic}\n\n${deepDive || "N/A"}\n`, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "reading-list.md"), `# Reading List: ${loaded.session.topic}\n\n${(0, list_1.formatList)(readingList)}\n`, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "qa.md"), `# Q&A: ${loaded.session.topic}\n\n${qaItems.join("\n")}\n`, "utf-8");
+    const progressLog = path_1.default.join(loaded.dir, "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()} delivered learning outputs for ${loaded.session.id}\n`;
+    fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
+    console.log(`Learning outputs written to ${loaded.dir}`);
+}

package/dist/commands/learn-refine.d.ts

@@ -0,0 +1 @@
+export declare function runLearnRefine(): Promise<void>;

package/dist/commands/learn-refine.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLearnRefine = runLearnRefine;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const list_1 = require("../utils/list");
+const learn_utils_1 = require("./learn-utils");
+async function runLearnRefine() {
+    const projectName = await (0, prompt_1.ask)("Project name: ");
+    if (!projectName) {
+        console.log("Project name is required.");
+        return;
+    }
+    const sessions = (0, learn_utils_1.listLearnSessions)(projectName);
+    if (sessions.length > 0) {
+        console.log("Available sessions:");
+        sessions.forEach((session) => console.log(`- ${session}`));
+    }
+    const sessionId = await (0, prompt_1.ask)("Session ID: ");
+    if (!sessionId) {
+        console.log("Session ID is required.");
+        return;
+    }
+    const loaded = (0, learn_utils_1.loadLearnSession)(projectName, sessionId);
+    if (!loaded) {
+        console.log("Learning session not found.");
+        return;
+    }
+    const purpose = await (0, prompt_1.ask)(`Purpose (${loaded.session.purpose}): `);
+    const depth = await (0, prompt_1.ask)(`Depth (${loaded.session.depth}): `);
+    const format = await (0, prompt_1.ask)(`Format (${loaded.session.format}): `);
+    const focusAreas = await (0, prompt_1.ask)("Focus areas - comma separated: ");
+    const timeAvailable = await (0, prompt_1.ask)(`Time available (${loaded.session.timeAvailable}): `);
+    const constraints = await (0, prompt_1.ask)("Constraints - comma separated: ");
+    const updated = (0, learn_utils_1.updateLearnSession)(projectName, sessionId, {
+        purpose: purpose || loaded.session.purpose,
+        depth: depth || loaded.session.depth,
+        format: format || loaded.session.format,
+        focusAreas: focusAreas ? (0, list_1.parseList)(focusAreas) : loaded.session.focusAreas,
+        timeAvailable: timeAvailable || loaded.session.timeAvailable,
+        constraints: constraints ? (0, list_1.parseList)(constraints) : loaded.session.constraints
+    });
+    if (!updated) {
+        console.log("Failed to update session.");
+        return;
+    }
+    const sessionMd = [
+        `# Learning Session: ${updated.topic}`,
+        "",
+        `- Purpose: ${updated.purpose}`,
+        `- Depth: ${updated.depth}`,
+        `- Format: ${updated.format}`,
+        `- Focus areas:`,
+        `${(0, list_1.formatList)(updated.focusAreas.join(", "))}`,
+        `- Time available: ${updated.timeAvailable}`,
+        `- Constraints:`,
+        `${(0, list_1.formatList)(updated.constraints.join(", "))}`
+    ].join("\n");
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "session.md"), sessionMd, "utf-8");
+    const progressLog = path_1.default.join(loaded.dir, "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()} refined learning session ${updated.id}\n`;
+    fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
+    console.log(`Learning session updated at ${loaded.dir}`);
+}

package/dist/commands/learn-start.d.ts

@@ -0,0 +1 @@
+export declare function runLearnStart(): Promise<void>;

package/dist/commands/learn-start.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLearnStart = runLearnStart;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const list_1 = require("../utils/list");
+const learn_utils_1 = require("./learn-utils");
+async function runLearnStart() {
+    const projectName = await (0, prompt_1.ask)("Project name: ");
+    const topic = await (0, prompt_1.ask)("Topic to learn: ");
+    if (!projectName || !topic) {
+        console.log("Project name and topic are required.");
+        return;
+    }
+    const purpose = await (0, prompt_1.ask)("Why do you want to learn this? ");
+    const depth = await (0, prompt_1.ask)("Depth (overview/academic/expert): ");
+    const format = await (0, prompt_1.ask)("Preferred format (summary/syllabus/report/Q&A): ");
+    const focusAreas = await (0, prompt_1.ask)("Focus areas - comma separated: ");
+    const timeAvailable = await (0, prompt_1.ask)("Time available: ");
+    const constraints = await (0, prompt_1.ask)("Constraints - comma separated: ");
+    const created = (0, learn_utils_1.createLearnSession)(projectName, topic, "learning");
+    (0, learn_utils_1.updateLearnSession)(projectName, created.session.id, {
+        purpose: purpose || "N/A",
+        depth: depth || "N/A",
+        format: format || "N/A",
+        focusAreas: (0, list_1.parseList)(focusAreas),
+        timeAvailable: timeAvailable || "N/A",
+        constraints: (0, list_1.parseList)(constraints)
+    });
+    const sessionDir = created.dir;
+    const brief = `# Brief: ${topic}\n\n${purpose || "N/A"}\n`;
+    const deepDive = `# Deep Dive: ${topic}\n\nDepth: ${depth || "N/A"}\n\nFocus areas:\n${(0, list_1.formatList)(focusAreas)}\n`;
+    const readingList = `# Reading List: ${topic}\n\n${(0, list_1.formatList)("TBD")}\n`;
+    const qa = `# Q&A: ${topic}\n\n${(0, list_1.formatList)("TBD")}\n`;
+    const sessionMd = [
+        `# Learning Session: ${topic}`,
+        "",
+        `- Purpose: ${purpose || "N/A"}`,
+        `- Depth: ${depth || "N/A"}`,
+        `- Format: ${format || "N/A"}`,
+        `- Focus areas:`,
+        `${(0, list_1.formatList)(focusAreas)}`,
+        `- Time available: ${timeAvailable || "N/A"}`,
+        `- Constraints:`,
+        `${(0, list_1.formatList)(constraints)}`
+    ].join("\n");
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "brief.md"), brief, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "deep-dive.md"), deepDive, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "reading-list.md"), readingList, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "qa.md"), qa, "utf-8");
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "session.md"), sessionMd, "utf-8");
+    const progressLog = path_1.default.join(sessionDir, "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()} started learning session ${created.session.id}\n`;
+    fs_1.default.appendFileSync(progressLog, logEntry, "utf-8");
+    console.log(`Learning session created at ${sessionDir}`);
+}

package/dist/commands/learn-utils.d.ts

@@ -0,0 +1,22 @@
+export type LearnSession = {
+    id: string;
+    topic: string;
+    purpose: string;
+    depth: string;
+    format: string;
+    focusAreas: string[];
+    timeAvailable: string;
+    constraints: string[];
+    createdAt: string;
+    updatedAt: string;
+};
+export declare function createLearnSession(projectName: string, topic: string, domain?: string): {
+    session: LearnSession;
+    dir: string;
+};
+export declare function loadLearnSession(projectName: string, sessionId: string): {
+    session: LearnSession;
+    dir: string;
+} | null;
+export declare function listLearnSessions(projectName: string): string[];
+export declare function updateLearnSession(projectName: string, sessionId: string, next: Partial<LearnSession>): LearnSession | null;

package/dist/commands/learn-utils.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLearnSession = createLearnSession;
+exports.loadLearnSession = loadLearnSession;
+exports.listLearnSessions = listLearnSessions;
+exports.updateLearnSession = updateLearnSession;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../workspace/index");
+function sanitizeId(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function createLearnSession(projectName, topic, domain = "learning") {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    (0, index_1.ensureProject)(workspace, projectName, domain);
+    const stamp = new Date().toISOString().replace(/[:.]/g, "").slice(0, 13);
+    const id = `LEARN-${sanitizeId(topic)}-${stamp}`;
+    const now = new Date().toISOString();
+    const session = {
+        id,
+        topic,
+        purpose: "N/A",
+        depth: "N/A",
+        format: "N/A",
+        focusAreas: [],
+        timeAvailable: "N/A",
+        constraints: [],
+        createdAt: now,
+        updatedAt: now
+    };
+    const sessionDir = path_1.default.join(workspace.root, projectName, "learning", id);
+    fs_1.default.mkdirSync(sessionDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(sessionDir, "session.json"), JSON.stringify(session, null, 2), "utf-8");
+    return { session, dir: sessionDir };
+}
+function loadLearnSession(projectName, sessionId) {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    const sessionDir = path_1.default.join(workspace.root, projectName, "learning", sessionId);
+    const sessionPath = path_1.default.join(sessionDir, "session.json");
+    if (!fs_1.default.existsSync(sessionPath)) {
+        return null;
+    }
+    const session = JSON.parse(fs_1.default.readFileSync(sessionPath, "utf-8"));
+    return { session, dir: sessionDir };
+}
+function listLearnSessions(projectName) {
+    const workspace = (0, index_1.getWorkspaceInfo)();
+    const root = path_1.default.join(workspace.root, projectName, "learning");
+    if (!fs_1.default.existsSync(root)) {
+        return [];
+    }
+    return fs_1.default
+        .readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+function updateLearnSession(projectName, sessionId, next) {
+    const loaded = loadLearnSession(projectName, sessionId);
+    if (!loaded) {
+        return null;
+    }
+    const updated = {
+        ...loaded.session,
+        ...next,
+        updatedAt: new Date().toISOString()
+    };
+    fs_1.default.writeFileSync(path_1.default.join(loaded.dir, "session.json"), JSON.stringify(updated, null, 2), "utf-8");
+    return updated;
+}

package/dist/commands/list.d.ts

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