@applica-software-guru/sdd-core 0.1.0

package/dist/parser/story-parser.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverStoryFiles = discoverStoryFiles;
+exports.parseStoryFile = parseStoryFile;
+exports.parseAllStoryFiles = parseAllStoryFiles;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const glob_1 = require("glob");
+const node_crypto_1 = require("node:crypto");
+const frontmatter_js_1 = require("./frontmatter.js");
+const section_extractor_js_1 = require("./section-extractor.js");
+const ref_extractor_js_1 = require("./ref-extractor.js");
+async function discoverStoryFiles(root) {
+    const patterns = ['product/**/*.md', 'system/**/*.md'];
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, { cwd: root, absolute: true });
+        files.push(...matches);
+    }
+    return files.sort();
+}
+async function parseStoryFile(root, absolutePath) {
+    const content = await (0, promises_1.readFile)(absolutePath, 'utf-8');
+    const relPath = (0, node_path_1.relative)(root, absolutePath);
+    const { frontmatter, body } = (0, frontmatter_js_1.parseFrontmatter)(relPath, content);
+    const hash = (0, node_crypto_1.createHash)('sha256').update(content).digest('hex');
+    return {
+        relativePath: relPath,
+        frontmatter,
+        body,
+        pendingItems: (0, section_extractor_js_1.extractPendingItems)(body),
+        agentNotes: (0, section_extractor_js_1.extractAgentNotes)(body),
+        crossRefs: (0, ref_extractor_js_1.extractCrossRefs)(body),
+        hash,
+    };
+}
+async function parseAllStoryFiles(root) {
+    const paths = await discoverStoryFiles(root);
+    return Promise.all(paths.map((p) => parseStoryFile(root, p)));
+}
+//# sourceMappingURL=story-parser.js.map

package/dist/parser/story-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-parser.js","sourceRoot":"","sources":["../../src/parser/story-parser.ts"],"names":[],"mappings":";;AASA,gDAQC;AAED,wCAeC;AAED,gDAGC;AAvCD,+CAA4C;AAC5C,yCAA8C;AAC9C,+BAA4B;AAC5B,6CAAyC;AAEzC,qDAAoD;AACpD,iEAAgF;AAChF,yDAAsD;AAE/C,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,QAAQ,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,YAAoB;IACrE,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAA,oBAAQ,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,IAAA,iCAAgB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhE,OAAO;QACL,YAAY,EAAE,OAAO;QACrB,WAAW;QACX,IAAI;QACJ,YAAY,EAAE,IAAA,0CAAmB,EAAC,IAAI,CAAC;QACvC,UAAU,EAAE,IAAA,wCAAiB,EAAC,IAAI,CAAC;QACnC,SAAS,EAAE,IAAA,mCAAgB,EAAC,IAAI,CAAC;QACjC,IAAI;KACL,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/prompt/prompt-generator.d.ts

@@ -0,0 +1,3 @@
+import type { StoryFile } from '../types.js';
+export declare function generatePrompt(files: StoryFile[], root?: string): string;
+//# sourceMappingURL=prompt-generator.d.ts.map

package/dist/prompt/prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CA6CxE"}

package/dist/prompt/prompt-generator.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePrompt = generatePrompt;
+const git_js_1 = require("../git/git.js");
+function generatePrompt(files, root) {
+    const sections = [];
+    sections.push('# SDD Sync Prompt\n\nThis project uses Story Driven Development. Implement the changes described below.');
+    if (files.length === 0) {
+        sections.push('Nothing to do — all files are synced.');
+        return sections.join('\n\n');
+    }
+    const lines = [`## Files to process (${files.length})\n`];
+    for (const f of files) {
+        lines.push(`- \`${f.relativePath}\` — **${f.frontmatter.status}**`);
+    }
+    lines.push('');
+    lines.push('Read each file listed above before implementing.');
+    sections.push(lines.join('\n'));
+    // Show git diff for changed files so the agent knows what was modified
+    if (root) {
+        const changed = files.filter((f) => f.frontmatter.status === 'changed');
+        for (const f of changed) {
+            const diff = (0, git_js_1.getFileDiff)(root, f.relativePath);
+            if (diff) {
+                sections.push(`## Changes in \`${f.relativePath}\`\n\n\`\`\`diff\n${diff}\n\`\`\``);
+            }
+        }
+    }
+    const deleted = files.filter((f) => f.frontmatter.status === 'deleted');
+    if (deleted.length > 0) {
+        const delLines = ['## Files to remove\n'];
+        for (const f of deleted) {
+            delLines.push(`- \`${f.relativePath}\` — remove all related code in \`code/\``);
+        }
+        sections.push(delLines.join('\n'));
+    }
+    sections.push(`## Instructions\n\n1. Read each file listed above\n2. For **new** files: implement what the documentation describes\n3. For **changed** files: update the code to match the updated documentation (see diff above)\n4. For **deleted** files: remove the related code from \`code/\`\n5. If a file has a \`## Agent Notes\` section, respect those constraints\n6. All code goes inside \`code/\`\n7. After implementing each file, run \`sdd mark-synced <file>\`\n8. **Immediately after mark-synced, commit**: \`git add -A && git commit -m "sdd sync: <description>"\`\n9. When done with all files, list every file you created or modified`);
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=prompt-generator.js.map

package/dist/prompt/prompt-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.js","sourceRoot":"","sources":["../../src/prompt/prompt-generator.ts"],"names":[],"mappings":";;AAGA,wCA6CC;AA/CD,0CAA4C;AAE5C,SAAgB,cAAc,CAAC,KAAkB,EAAE,IAAa;IAC9D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CACX,yGAAyG,CAC1G,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,wBAAwB,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,UAAU,CAAC,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhC,uEAAuE;IACvE,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAA,oBAAW,EAAC,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,YAAY,qBAAqB,IAAI,UAAU,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,2CAA2C,CAAC,CAAC;QAClF,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,mnBAAmnB,CACpnB,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/scaffold/init.d.ts

@@ -0,0 +1,3 @@
+import { type ProjectInfo } from './templates.js';
+export declare function initProject(root: string, info?: ProjectInfo): Promise<string[]>;
+//# sourceMappingURL=init.d.ts.map

package/dist/scaffold/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/scaffold/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKrE,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8DrF"}

package/dist/scaffold/init.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProject = initProject;
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const templates_js_1 = require("./templates.js");
+const config_manager_js_1 = require("../config/config-manager.js");
+const git_js_1 = require("../git/git.js");
+async function initProject(root, info) {
+    const createdFiles = [];
+    const sddDir = (0, config_manager_js_1.sddDirPath)(root);
+    // Ensure git repo
+    if (!(0, git_js_1.isGitRepo)(root)) {
+        (0, git_js_1.gitInit)(root);
+        createdFiles.push('.git');
+    }
+    // Create .sdd directory
+    if (!(0, node_fs_1.existsSync)(sddDir)) {
+        await (0, promises_1.mkdir)(sddDir, { recursive: true });
+    }
+    // Write config
+    const config = {
+        description: info?.description ?? '',
+    };
+    await (0, config_manager_js_1.writeConfig)(root, config);
+    createdFiles.push('.sdd/config.yaml');
+    // Create directory structure
+    const dirs = ['product', 'product/features', 'system', 'code', 'change-requests'];
+    for (const dir of dirs) {
+        const absDir = (0, node_path_1.resolve)(root, dir);
+        if (!(0, node_fs_1.existsSync)(absDir)) {
+            await (0, promises_1.mkdir)(absDir, { recursive: true });
+        }
+    }
+    // Create agent instructions
+    const instructionsPath = (0, node_path_1.resolve)(root, 'INSTRUCTIONS.md');
+    if (!(0, node_fs_1.existsSync)(instructionsPath)) {
+        await (0, promises_1.writeFile)(instructionsPath, templates_js_1.AGENT_MD_TEMPLATE, 'utf-8');
+        createdFiles.push('INSTRUCTIONS.md');
+    }
+    // Create agent instruction pointers
+    const POINTER = 'Read INSTRUCTIONS.md in the project root for all instructions.\n';
+    const agentFiles = [
+        { path: '.claude/CLAUDE.md', dir: '.claude' },
+        { path: '.github/copilot-instructions.md', dir: '.github' },
+        { path: '.cursorrules' },
+    ];
+    for (const entry of agentFiles) {
+        const absPath = (0, node_path_1.resolve)(root, entry.path);
+        if ((0, node_fs_1.existsSync)(absPath))
+            continue;
+        if (entry.dir) {
+            const absDir = (0, node_path_1.resolve)(root, entry.dir);
+            if (!(0, node_fs_1.existsSync)(absDir)) {
+                await (0, promises_1.mkdir)(absDir, { recursive: true });
+            }
+        }
+        await (0, promises_1.writeFile)(absPath, POINTER, 'utf-8');
+        createdFiles.push(entry.path);
+    }
+    return createdFiles;
+}
+//# sourceMappingURL=init.js.map

package/dist/scaffold/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/scaffold/init.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/templates.d.ts

@@ -0,0 +1,6 @@
+export interface ProjectInfo {
+    description: string;
+}
+export declare const AGENT_MD_TEMPLATE = "# SDD Project\n\nThis project uses **Story Driven Development (SDD)**.\nDocumentation drives implementation: read the docs first, then write code.\n\n## Workflow\n\n1. Run `sdd cr pending` \u2014 check if there are change requests to process first\n2. If there are pending CRs, apply them to the docs, then run `sdd mark-cr-applied`\n3. Run `sdd sync` to see what needs to be implemented\n4. Read the documentation files listed in the sync output\n5. Implement what each file describes, writing code inside `code/`\n6. After implementing, mark files as synced:\n\n```\nsdd mark-synced product/features/auth.md\n```\n\nOr mark all pending files at once:\n\n```\nsdd mark-synced\n```\n\n7. **Commit immediately after mark-synced** \u2014 this is mandatory:\n\n```\ngit add -A && git commit -m \"sdd sync: <brief description of what was implemented>\"\n```\n\nDo NOT skip this step. Every mark-synced must be followed by a git commit.\n\n### Removing a feature\n\nIf a documentation file has `status: deleted`, it means that feature should be removed.\nDelete the related code in `code/`, then run `sdd mark-synced <file>` (the doc file will be removed automatically), then commit.\n\n## Available commands\n\n- `sdd status` \u2014 See all documentation files and their state (new/changed/deleted/synced)\n- `sdd diff` \u2014 See what changed since last sync\n- `sdd sync` \u2014 Get the sync prompt for pending files (new/changed/deleted)\n- `sdd validate` \u2014 Check for broken references and issues\n- `sdd mark-synced [files...]` \u2014 Mark specific files (or all) as synced\n- `sdd cr list` \u2014 List all change requests with their status\n- `sdd cr pending` \u2014 Show draft change requests to process\n- `sdd mark-cr-applied [files...]` \u2014 Mark change requests as applied\n\n## Rules\n\n1. **Always commit after mark-synced** \u2014 run `git add -A && git commit -m \"sdd sync: ...\"` immediately after `sdd mark-synced`. Never leave synced files uncommitted.\n2. Before running `sdd sync`, check for pending change requests with `sdd cr pending`\n3. If there are pending CRs, apply them to the docs first, then mark them with `sdd mark-cr-applied`\n4. Only implement what the sync prompt asks for\n5. All generated code goes inside `code/`\n6. Respect all constraints in `## Agent Notes` sections (if present)\n7. Do not edit files inside `.sdd/` manually\n\n## File format\n\nEvery `.md` file in `product/` and `system/` must start with this YAML frontmatter:\n\n```yaml\n---\ntitle: \"File title\"\nstatus: new\nauthor: \"\"\nlast-modified: \"2025-01-01T00:00:00.000Z\"\nversion: \"1.0\"\n---\n```\n\n- **status**: one of:\n  - `new` \u2014 new file, needs to be implemented\n  - `changed` \u2014 modified since last sync, code needs updating\n  - `deleted` \u2014 feature to be removed, agent should delete related code\n  - `synced` \u2014 already implemented, up to date\n- **version**: patch-bump on each edit (1.0 \u2192 1.1 \u2192 1.2)\n- **last-modified**: ISO 8601 datetime, updated on each edit\n\n## Change Requests\n\nChange Requests (CRs) are markdown files in `change-requests/` that describe modifications to the documentation.\n\n### CR format\n\n```yaml\n---\ntitle: \"Add authentication feature\"\nstatus: draft\nauthor: \"user\"\ncreated-at: \"2025-01-01T00:00:00.000Z\"\n---\n```\n\n- **status**: `draft` (pending) or `applied` (already processed)\n\n### CR workflow\n\n1. Check for pending CRs: `sdd cr pending`\n2. Read each pending CR and apply the described changes to the documentation files (marking them as `new`, `changed`, or `deleted`)\n3. After applying a CR to the docs, mark it: `sdd mark-cr-applied change-requests/CR-001.md`\n4. Then run `sdd sync` to implement the code changes\n\n### CR commands\n\n- `sdd cr list` \u2014 See all change requests and their status\n- `sdd cr pending` \u2014 Show only draft CRs to process\n- `sdd mark-cr-applied [files...]` \u2014 Mark CRs as applied after updating the docs\n\n## UX and screenshots\n\nWhen a feature has UX mockups or screenshots, place them next to the feature doc:\n\n- **Simple feature** (no screenshots): `product/features/auth.md`\n- **Feature with screenshots**: use a folder with `index.md`:\n\n```\nproduct/features/auth/\n  index.md          \u2190 feature doc\n  login.png         \u2190 screenshot\n  register.png      \u2190 screenshot\n```\n\nReference images in the markdown with relative paths:\n\n```markdown\n## UX\n\n![Login screen](login.png)\n![Register screen](register.png)\n```\n\nBoth formats work \u2014 use a folder only when you have screenshots or multiple files for a feature.\n\n## Project structure\n\n- `product/` \u2014 What to build (vision, users, features)\n- `system/` \u2014 How to build it (entities, architecture, tech stack, interfaces)\n- `code/` \u2014 All generated source code goes here\n- `change-requests/` \u2014 Change requests to the documentation\n- `.sdd/` \u2014 Project config and sync state (do not edit)\n";
+export declare const EMPTY_LOCK_TEMPLATE: () => string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/scaffold/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,02JA8I7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,cAE/B,CAAC"}

package/dist/scaffold/templates.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_LOCK_TEMPLATE = exports.AGENT_MD_TEMPLATE = void 0;
+const now = () => new Date().toISOString();
+function mdTemplate(title, content) {
+    return `---
+title: "${title}"
+status: new
+author: ""
+last-modified: "${now()}"
+version: "1.0"
+---
+
+${content}
+`;
+}
+exports.AGENT_MD_TEMPLATE = `# SDD Project
+
+This project uses **Story Driven Development (SDD)**.
+Documentation drives implementation: read the docs first, then write code.
+
+## Workflow
+
+1. Run \`sdd cr pending\` — check if there are change requests to process first
+2. If there are pending CRs, apply them to the docs, then run \`sdd mark-cr-applied\`
+3. Run \`sdd sync\` to see what needs to be implemented
+4. Read the documentation files listed in the sync output
+5. Implement what each file describes, writing code inside \`code/\`
+6. After implementing, mark files as synced:
+
+\`\`\`
+sdd mark-synced product/features/auth.md
+\`\`\`
+
+Or mark all pending files at once:
+
+\`\`\`
+sdd mark-synced
+\`\`\`
+
+7. **Commit immediately after mark-synced** — this is mandatory:
+
+\`\`\`
+git add -A && git commit -m "sdd sync: <brief description of what was implemented>"
+\`\`\`
+
+Do NOT skip this step. Every mark-synced must be followed by a git commit.
+
+### Removing a feature
+
+If a documentation file has \`status: deleted\`, it means that feature should be removed.
+Delete the related code in \`code/\`, then run \`sdd mark-synced <file>\` (the doc file will be removed automatically), then commit.
+
+## Available commands
+
+- \`sdd status\` — See all documentation files and their state (new/changed/deleted/synced)
+- \`sdd diff\` — See what changed since last sync
+- \`sdd sync\` — Get the sync prompt for pending files (new/changed/deleted)
+- \`sdd validate\` — Check for broken references and issues
+- \`sdd mark-synced [files...]\` — Mark specific files (or all) as synced
+- \`sdd cr list\` — List all change requests with their status
+- \`sdd cr pending\` — Show draft change requests to process
+- \`sdd mark-cr-applied [files...]\` — Mark change requests as applied
+
+## Rules
+
+1. **Always commit after mark-synced** — run \`git add -A && git commit -m "sdd sync: ..."\` immediately after \`sdd mark-synced\`. Never leave synced files uncommitted.
+2. Before running \`sdd sync\`, check for pending change requests with \`sdd cr pending\`
+3. If there are pending CRs, apply them to the docs first, then mark them with \`sdd mark-cr-applied\`
+4. Only implement what the sync prompt asks for
+5. All generated code goes inside \`code/\`
+6. Respect all constraints in \`## Agent Notes\` sections (if present)
+7. Do not edit files inside \`.sdd/\` manually
+
+## File format
+
+Every \`.md\` file in \`product/\` and \`system/\` must start with this YAML frontmatter:
+
+\`\`\`yaml
+---
+title: "File title"
+status: new
+author: ""
+last-modified: "2025-01-01T00:00:00.000Z"
+version: "1.0"
+---
+\`\`\`
+
+- **status**: one of:
+  - \`new\` — new file, needs to be implemented
+  - \`changed\` — modified since last sync, code needs updating
+  - \`deleted\` — feature to be removed, agent should delete related code
+  - \`synced\` — already implemented, up to date
+- **version**: patch-bump on each edit (1.0 → 1.1 → 1.2)
+- **last-modified**: ISO 8601 datetime, updated on each edit
+
+## Change Requests
+
+Change Requests (CRs) are markdown files in \`change-requests/\` that describe modifications to the documentation.
+
+### CR format
+
+\`\`\`yaml
+---
+title: "Add authentication feature"
+status: draft
+author: "user"
+created-at: "2025-01-01T00:00:00.000Z"
+---
+\`\`\`
+
+- **status**: \`draft\` (pending) or \`applied\` (already processed)
+
+### CR workflow
+
+1. Check for pending CRs: \`sdd cr pending\`
+2. Read each pending CR and apply the described changes to the documentation files (marking them as \`new\`, \`changed\`, or \`deleted\`)
+3. After applying a CR to the docs, mark it: \`sdd mark-cr-applied change-requests/CR-001.md\`
+4. Then run \`sdd sync\` to implement the code changes
+
+### CR commands
+
+- \`sdd cr list\` — See all change requests and their status
+- \`sdd cr pending\` — Show only draft CRs to process
+- \`sdd mark-cr-applied [files...]\` — Mark CRs as applied after updating the docs
+
+## UX and screenshots
+
+When a feature has UX mockups or screenshots, place them next to the feature doc:
+
+- **Simple feature** (no screenshots): \`product/features/auth.md\`
+- **Feature with screenshots**: use a folder with \`index.md\`:
+
+\`\`\`
+product/features/auth/
+  index.md          ← feature doc
+  login.png         ← screenshot
+  register.png      ← screenshot
+\`\`\`
+
+Reference images in the markdown with relative paths:
+
+\`\`\`markdown
+## UX
+
+![Login screen](login.png)
+![Register screen](register.png)
+\`\`\`
+
+Both formats work — use a folder only when you have screenshots or multiple files for a feature.
+
+## Project structure
+
+- \`product/\` — What to build (vision, users, features)
+- \`system/\` — How to build it (entities, architecture, tech stack, interfaces)
+- \`code/\` — All generated source code goes here
+- \`change-requests/\` — Change requests to the documentation
+- \`.sdd/\` — Project config and sync state (do not edit)
+`;
+const EMPTY_LOCK_TEMPLATE = () => `synced-at: "${new Date().toISOString()}"
+files: {}
+`;
+exports.EMPTY_LOCK_TEMPLATE = EMPTY_LOCK_TEMPLATE;
+//# sourceMappingURL=templates.js.map

package/dist/scaffold/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":";;;AAAA,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAE3C,SAAS,UAAU,CAAC,KAAa,EAAE,OAAe;IAChD,OAAO;UACC,KAAK;;;kBAGG,GAAG,EAAE;;;;EAIrB,OAAO;CACR,CAAC;AACF,CAAC;AAMY,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8IhC,CAAC;AAEK,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;CAE/E,CAAC;AAFW,QAAA,mBAAmB,uBAE9B"}

package/dist/sdd.d.ts

@@ -0,0 +1,20 @@
+import type { StoryStatus, ValidationResult, SDDConfig, ChangeRequest } from './types.js';
+import type { ProjectInfo } from './scaffold/templates.js';
+export declare class SDD {
+    private root;
+    constructor(options: {
+        root: string;
+    });
+    init(info?: ProjectInfo): Promise<string[]>;
+    config(): Promise<SDDConfig>;
+    status(): Promise<StoryStatus>;
+    pending(): Promise<import('./types.js').StoryFile[]>;
+    sync(): Promise<string>;
+    validate(): Promise<ValidationResult>;
+    markSynced(paths?: string[]): Promise<string[]>;
+    changeRequests(): Promise<ChangeRequest[]>;
+    pendingChangeRequests(): Promise<ChangeRequest[]>;
+    markCRApplied(paths?: string[]): Promise<string[]>;
+    private ensureInitialized;
+}
+//# sourceMappingURL=sdd.d.ts.map

package/dist/sdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd.d.ts","sourceRoot":"","sources":["../src/sdd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBAAa,GAAG;IACd,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAI/B,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAK5B,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAc9B,OAAO,IAAI,OAAO,CAAC,OAAO,YAAY,EAAE,SAAS,EAAE,CAAC;IAMpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMrC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6B/C,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAK1C,qBAAqB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKjD,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBxD,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/sdd.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDD = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const errors_js_1 = require("./errors.js");
+const story_parser_js_1 = require("./parser/story-parser.js");
+const prompt_generator_js_1 = require("./prompt/prompt-generator.js");
+const validator_js_1 = require("./validate/validator.js");
+const init_js_1 = require("./scaffold/init.js");
+const config_manager_js_1 = require("./config/config-manager.js");
+const cr_parser_js_1 = require("./parser/cr-parser.js");
+class SDD {
+    root;
+    constructor(options) {
+        this.root = options.root;
+    }
+    async init(info) {
+        return (0, init_js_1.initProject)(this.root, info);
+    }
+    async config() {
+        this.ensureInitialized();
+        return (0, config_manager_js_1.readConfig)(this.root);
+    }
+    async status() {
+        this.ensureInitialized();
+        const files = await (0, story_parser_js_1.parseAllStoryFiles)(this.root);
+        return {
+            files: files.map((f) => ({
+                relativePath: f.relativePath,
+                status: f.frontmatter.status,
+                version: f.frontmatter.version,
+                lastModified: f.frontmatter['last-modified'],
+            })),
+        };
+    }
+    async pending() {
+        this.ensureInitialized();
+        const files = await (0, story_parser_js_1.parseAllStoryFiles)(this.root);
+        return files.filter((f) => f.frontmatter.status !== 'synced');
+    }
+    async sync() {
+        const pending = await this.pending();
+        return (0, prompt_generator_js_1.generatePrompt)(pending, this.root);
+    }
+    async validate() {
+        this.ensureInitialized();
+        const files = await (0, story_parser_js_1.parseAllStoryFiles)(this.root);
+        return (0, validator_js_1.validate)(files);
+    }
+    async markSynced(paths) {
+        this.ensureInitialized();
+        const files = await (0, story_parser_js_1.parseAllStoryFiles)(this.root);
+        const marked = [];
+        for (const file of files) {
+            const { status } = file.frontmatter;
+            if (status === 'synced')
+                continue;
+            if (paths && paths.length > 0 && !paths.includes(file.relativePath))
+                continue;
+            const absPath = (0, node_path_1.resolve)(this.root, file.relativePath);
+            if (status === 'deleted') {
+                // File marked for deletion — remove it
+                const { unlink } = await import('node:fs/promises');
+                await unlink(absPath);
+                marked.push(`${file.relativePath} (removed)`);
+            }
+            else {
+                // new or changed → synced
+                const content = await (0, promises_1.readFile)(absPath, 'utf-8');
+                const updated = content.replace(/^status:\s*(new|changed)/m, 'status: synced');
+                await (0, promises_1.writeFile)(absPath, updated, 'utf-8');
+                marked.push(file.relativePath);
+            }
+        }
+        return marked;
+    }
+    async changeRequests() {
+        this.ensureInitialized();
+        return (0, cr_parser_js_1.parseAllCRFiles)(this.root);
+    }
+    async pendingChangeRequests() {
+        const all = await this.changeRequests();
+        return all.filter((cr) => cr.frontmatter.status === 'draft');
+    }
+    async markCRApplied(paths) {
+        this.ensureInitialized();
+        const all = await this.changeRequests();
+        const marked = [];
+        for (const cr of all) {
+            if (cr.frontmatter.status === 'applied')
+                continue;
+            if (paths && paths.length > 0 && !paths.includes(cr.relativePath))
+                continue;
+            const absPath = (0, node_path_1.resolve)(this.root, cr.relativePath);
+            const content = await (0, promises_1.readFile)(absPath, 'utf-8');
+            const updated = content.replace(/^status:\s*draft/m, 'status: applied');
+            await (0, promises_1.writeFile)(absPath, updated, 'utf-8');
+            marked.push(cr.relativePath);
+        }
+        return marked;
+    }
+    ensureInitialized() {
+        if (!(0, config_manager_js_1.isSDDProject)(this.root)) {
+            throw new errors_js_1.ProjectNotInitializedError(this.root);
+        }
+    }
+}
+exports.SDD = SDD;
+//# sourceMappingURL=sdd.js.map

package/dist/sdd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd.js","sourceRoot":"","sources":["../src/sdd.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type StoryFileStatus = 'new' | 'changed' | 'deleted' | 'synced';
+export interface StoryFrontmatter {
+    title: string;
+    status: StoryFileStatus;
+    author: string;
+    'last-modified': string;
+    version: string;
+}
+export interface StoryFile {
+    relativePath: string;
+    frontmatter: StoryFrontmatter;
+    body: string;
+    pendingItems: PendingItem[];
+    agentNotes: string | null;
+    crossRefs: string[];
+    hash: string;
+}
+export interface PendingItem {
+    text: string;
+    checked: boolean;
+}
+export interface Delta {
+    hasChanges: boolean;
+    files: DeltaFile[];
+    diff: string;
+}
+export interface DeltaFile {
+    relativePath: string;
+    status: 'modified' | 'new' | 'deleted';
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+export interface ValidationIssue {
+    severity: 'error' | 'warning';
+    filePath: string;
+    message: string;
+    rule: string;
+}
+export interface StoryStatus {
+    files: Array<{
+        relativePath: string;
+        status: 'new' | 'changed' | 'deleted' | 'synced';
+        version: string;
+        lastModified: string;
+    }>;
+}
+export interface SDDConfig {
+    description: string;
+    'last-sync-commit'?: string;
+}
+export type ChangeRequestStatus = 'draft' | 'applied';
+export interface ChangeRequestFrontmatter {
+    title: string;
+    status: ChangeRequestStatus;
+    author: string;
+    'created-at': string;
+}
+export interface ChangeRequest {
+    relativePath: string;
+    frontmatter: ChangeRequestFrontmatter;
+    body: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QACjD,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,wBAAwB,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validate/validator.d.ts

@@ -0,0 +1,3 @@
+import type { StoryFile, ValidationResult } from '../types.js';
+export declare function validate(files: StoryFile[]): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validate/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validate/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAEhF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,gBAAgB,CA2C7D"}

package/dist/validate/validator.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+function validate(files) {
+    const issues = [];
+    // Collect known entity names from system/entities.md
+    const entityNames = new Set();
+    const entitiesFile = files.find((f) => f.relativePath.endsWith('entities.md'));
+    if (entitiesFile) {
+        // Extract ### headings as entity names
+        const headingRe = /^### (.+)$/gm;
+        let match;
+        while ((match = headingRe.exec(entitiesFile.body)) !== null) {
+            entityNames.add(match[1].trim());
+        }
+    }
+    for (const file of files) {
+        // Check broken cross-references
+        for (const ref of file.crossRefs) {
+            if (entityNames.size > 0 && !entityNames.has(ref)) {
+                issues.push({
+                    severity: 'warning',
+                    filePath: file.relativePath,
+                    message: `Broken reference [[${ref}]] — not found in system/entities.md`,
+                    rule: 'broken-ref',
+                });
+            }
+        }
+        // Check frontmatter has required fields
+        if (!file.frontmatter.title) {
+            issues.push({
+                severity: 'warning',
+                filePath: file.relativePath,
+                message: 'Missing "title" in frontmatter',
+                rule: 'missing-frontmatter',
+            });
+        }
+    }
+    return {
+        valid: issues.filter((i) => i.severity === 'error').length === 0,
+        issues,
+    };
+}
+//# sourceMappingURL=validator.js.map