@applica-software-guru/sdd-core 1.0.0 → 1.3.3

package/tests/integration.test.ts

@@ -1,13 +1,17 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { mkdtemp, rm, writeFile, readFile, mkdir } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { execSync } from 'node:child_process';
-import { SDD } from '../src/sdd.js';
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, writeFile, readFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { SDD } from "../src/sdd.js";
 
 function git(cmd: string, cwd: string): string {
-  return execSync(`git ${cmd}`, { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+  return execSync(`git ${cmd}`, {
+    cwd,
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"],
+  }).trim();
 }
 
 const VISION_MD = `---
@@ -23,110 +27,149 @@ version: "1.0"
 A test project.
 `;
 
-describe('SDD integration', () => {
+describe("SDD integration", () => {
   let tempDir: string;
 
   beforeEach(async () => {
-    tempDir = await mkdtemp(join(tmpdir(), 'sdd-integration-'));
+    tempDir = await mkdtemp(join(tmpdir(), "sdd-integration-"));
   });
 
   afterEach(async () => {
     await rm(tempDir, { recursive: true });
   });
 
-  it('init creates .sdd directory with config and git repo', async () => {
+  it("init creates .sdd directory with config and git repo", async () => {
     const sdd = new SDD({ root: tempDir });
 
-    const created = await sdd.init({ description: 'A test app' });
-    expect(created).toContain('.sdd/config.yaml');
-    expect(created).toContain('INSTRUCTIONS.md');
-    expect(existsSync(join(tempDir, '.sdd'))).toBe(true);
-    expect(existsSync(join(tempDir, '.git'))).toBe(true);
-    expect(existsSync(join(tempDir, 'product'))).toBe(true);
-    expect(existsSync(join(tempDir, 'system'))).toBe(true);
-    expect(existsSync(join(tempDir, 'code'))).toBe(true);
+    const created = await sdd.init({ description: "A test app" });
+    expect(created).toContain(".sdd/config.yaml");
+    expect(created).toContain(".sdd/skill/sdd/SKILL.md");
+    expect(created).toContain(".claude/skills/sdd/SKILL.md");
+    expect(existsSync(join(tempDir, ".sdd"))).toBe(true);
+    expect(existsSync(join(tempDir, ".git"))).toBe(true);
+    expect(existsSync(join(tempDir, "product"))).toBe(true);
+    expect(existsSync(join(tempDir, "system"))).toBe(true);
+    expect(existsSync(join(tempDir, "code"))).toBe(true);
+    expect(existsSync(join(tempDir, ".sdd/skill/sdd/SKILL.md"))).toBe(true);
+    expect(
+      existsSync(join(tempDir, ".sdd/skill/sdd/references/file-format.md")),
+    ).toBe(true);
+    expect(
+      existsSync(join(tempDir, ".sdd/skill/sdd/references/change-requests.md")),
+    ).toBe(true);
+    expect(existsSync(join(tempDir, ".sdd/skill/sdd/references/bugs.md"))).toBe(
+      true,
+    );
+    expect(existsSync(join(tempDir, ".claude/skills/sdd/SKILL.md"))).toBe(true);
+    expect(
+      existsSync(join(tempDir, ".claude/skills/sdd/references/file-format.md")),
+    ).toBe(true);
+    expect(
+      existsSync(
+        join(tempDir, ".claude/skills/sdd/references/change-requests.md"),
+      ),
+    ).toBe(true);
+    expect(
+      existsSync(join(tempDir, ".claude/skills/sdd/references/bugs.md")),
+    ).toBe(true);
 
     const config = await sdd.config();
-    expect(config.description).toBe('A test app');
+    expect(config.description).toBe("A test app");
   });
 
-  it('full workflow: init → add doc → status → sync → mark-synced', async () => {
+  it("full workflow: init → add doc → status → sync → mark-synced", async () => {
     const sdd = new SDD({ root: tempDir });
-    await sdd.init({ description: 'test' });
+    await sdd.init({ description: "test" });
     git('config user.email "test@test.com"', tempDir);
     git('config user.name "Test"', tempDir);
 
     // Simulate user creating a doc file
-    await writeFile(join(tempDir, 'product/vision.md'), VISION_MD, 'utf-8');
+    await writeFile(join(tempDir, "product/vision.md"), VISION_MD, "utf-8");
 
     // Status — file should be "new"
     const status = await sdd.status();
     expect(status.files.length).toBe(1);
-    expect(status.files[0].status).toBe('new');
+    expect(status.files[0].status).toBe("new");
 
     // Sync — prompt should list the new file
     const prompt = await sdd.sync();
-    expect(prompt).toContain('# SDD Sync Prompt');
-    expect(prompt).toContain('product/vision.md');
-    expect(prompt).toContain('**new**');
+    expect(prompt).toContain("# SDD Sync Prompt");
+    expect(prompt).toContain("product/vision.md");
+    expect(prompt).toContain("**new**");
 
     // Validate
     const validation = await sdd.validate();
     expect(validation.valid).toBe(true);
 
     // Mark synced — single file
-    const marked = await sdd.markSynced(['product/vision.md']);
-    expect(marked).toContain('product/vision.md');
+    const marked = await sdd.markSynced(["product/vision.md"]);
+    expect(marked).toContain("product/vision.md");
 
     // Agent commits after mark-synced
-    git('add .', tempDir);
+    git("add .", tempDir);
     git('commit -m "sync: vision"', tempDir);
 
     // After commit, status should be synced
     const statusAfter = await sdd.status();
-    expect(statusAfter.files[0].status).toBe('synced');
+    expect(statusAfter.files[0].status).toBe("synced");
   });
 
-  it('mark-synced with changed status', async () => {
+  it("mark-synced with changed status", async () => {
     const sdd = new SDD({ root: tempDir });
-    await sdd.init({ description: 'test' });
+    await sdd.init({ description: "test" });
     git('config user.email "test@test.com"', tempDir);
     git('config user.name "Test"', tempDir);
 
-    const changedMd = VISION_MD.replace('status: new', 'status: changed');
-    await writeFile(join(tempDir, 'product/vision.md'), changedMd, 'utf-8');
+    const changedMd = VISION_MD.replace("status: new", "status: changed");
+    await writeFile(join(tempDir, "product/vision.md"), changedMd, "utf-8");
 
     const marked = await sdd.markSynced();
-    expect(marked).toContain('product/vision.md');
+    expect(marked).toContain("product/vision.md");
 
-    const content = await readFile(join(tempDir, 'product/vision.md'), 'utf-8');
-    expect(content).toContain('status: synced');
+    const content = await readFile(join(tempDir, "product/vision.md"), "utf-8");
+    expect(content).toContain("status: synced");
   });
 
-  it('mark-synced with deleted status removes the file', async () => {
+  it("mark-synced with deleted status removes the file", async () => {
     const sdd = new SDD({ root: tempDir });
-    await sdd.init({ description: 'test' });
+    await sdd.init({ description: "test" });
     git('config user.email "test@test.com"', tempDir);
     git('config user.name "Test"', tempDir);
 
-    const deletedMd = VISION_MD.replace('status: new', 'status: deleted');
-    await writeFile(join(tempDir, 'product/vision.md'), deletedMd, 'utf-8');
+    const deletedMd = VISION_MD.replace("status: new", "status: deleted");
+    await writeFile(join(tempDir, "product/vision.md"), deletedMd, "utf-8");
 
     const marked = await sdd.markSynced();
-    expect(marked[0]).toContain('removed');
-    expect(existsSync(join(tempDir, 'product/vision.md'))).toBe(false);
+    expect(marked[0]).toContain("removed");
+    expect(existsSync(join(tempDir, "product/vision.md"))).toBe(false);
   });
 
-  it('throws when project not initialized', async () => {
+  it("throws when project not initialized", async () => {
     const sdd = new SDD({ root: tempDir });
-    await expect(sdd.status()).rejects.toThrow('No SDD project found');
+    await expect(sdd.status()).rejects.toThrow("No SDD project found");
   });
 
-  it('init is idempotent for INSTRUCTIONS.md', async () => {
+  it("init is idempotent for canonical and adapter skill files", async () => {
     const sdd = new SDD({ root: tempDir });
-    const first = await sdd.init({ description: 'test' });
-    const second = await sdd.init({ description: 'test' });
-    expect(first).toContain('INSTRUCTIONS.md');
-    expect(second).not.toContain('INSTRUCTIONS.md');
+    const first = await sdd.init({ description: "test" });
+    const second = await sdd.init({ description: "test" });
+    expect(first).toContain(".sdd/skill/sdd/SKILL.md");
+    expect(first).toContain(".claude/skills/sdd/SKILL.md");
+    expect(second).not.toContain(".sdd/skill/sdd/SKILL.md");
+    expect(second).not.toContain(".claude/skills/sdd/SKILL.md");
+  });
+
+  it("syncAdapters supports dry-run and selective adapters", async () => {
+    const sdd = new SDD({ root: tempDir });
+    await sdd.init({ description: "test" });
+
+    const dryRun = await sdd.syncAdapters({ agents: ["claude"], dryRun: true });
+    expect(dryRun.selectedAgents).toEqual(["claude"]);
+    expect(
+      dryRun.adapters.some((c) => c.path === ".claude/skills/sdd/SKILL.md"),
+    ).toBe(true);
+
+    await sdd.syncAdapters({ agents: ["claude"] });
+    expect(existsSync(join(tempDir, ".claude/skills/sdd/SKILL.md"))).toBe(true);
   });
 });

package/dist/delta/hasher.d.ts

@@ -1,2 +0,0 @@
-export declare function sha256(content: string): string;
-//# sourceMappingURL=hasher.d.ts.map

package/dist/delta/hasher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/delta/hasher.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/delta/hasher.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sha256 = sha256;
-const node_crypto_1 = require("node:crypto");
-function sha256(content) {
-    return (0, node_crypto_1.createHash)('sha256').update(content).digest('hex');
-}
-//# sourceMappingURL=hasher.js.map

package/dist/delta/hasher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/delta/hasher.ts"],"names":[],"mappings":";;AAEA,wBAEC;AAJD,6CAAyC;AAEzC,SAAgB,MAAM,CAAC,OAAe;IACpC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/lock/lock-manager.d.ts

@@ -1,6 +0,0 @@
-import type { LockFile } from '../types.js';
-export declare function lockFilePath(root: string): string;
-export declare function readLockFile(root: string): Promise<LockFile>;
-export declare function writeLockFile(root: string, lock: LockFile): Promise<void>;
-export declare function createEmptyLock(): LockFile;
-//# sourceMappingURL=lock-manager.d.ts.map

package/dist/lock/lock-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/lock/lock-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQlE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAK1C"}

package/dist/lock/lock-manager.js

@@ -1,39 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.lockFilePath = lockFilePath;
-exports.readLockFile = readLockFile;
-exports.writeLockFile = writeLockFile;
-exports.createEmptyLock = createEmptyLock;
-const promises_1 = require("node:fs/promises");
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const js_yaml_1 = __importDefault(require("js-yaml"));
-const config_manager_js_1 = require("../config/config-manager.js");
-const LOCK_FILENAME = 'lock.yaml';
-function lockFilePath(root) {
-    return (0, node_path_1.resolve)(root, config_manager_js_1.SDD_DIR, LOCK_FILENAME);
-}
-async function readLockFile(root) {
-    const path = lockFilePath(root);
-    if (!(0, node_fs_1.existsSync)(path)) {
-        return createEmptyLock();
-    }
-    const content = await (0, promises_1.readFile)(path, 'utf-8');
-    const parsed = js_yaml_1.default.load(content);
-    return parsed ?? createEmptyLock();
-}
-async function writeLockFile(root, lock) {
-    const path = lockFilePath(root);
-    const content = js_yaml_1.default.dump(lock, { sortKeys: true, lineWidth: -1 });
-    await (0, promises_1.writeFile)(path, content, 'utf-8');
-}
-function createEmptyLock() {
-    return {
-        'synced-at': new Date().toISOString(),
-        files: {},
-    };
-}
-//# sourceMappingURL=lock-manager.js.map

package/dist/lock/lock-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock-manager.js","sourceRoot":"","sources":["../../src/lock/lock-manager.ts"],"names":[],"mappings":";;;;;AASA,oCAEC;AAED,oCAQC;AAED,sCAIC;AAED,0CAKC;AAlCD,+CAAuD;AACvD,qCAAqC;AACrC,yCAAoC;AACpC,sDAA2B;AAE3B,mEAAsD;AAEtD,MAAM,aAAa,GAAG,WAAW,CAAC;AAElC,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,IAAA,mBAAO,EAAC,IAAI,EAAE,2BAAO,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,iBAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,CAAC;IACrD,OAAO,MAAM,IAAI,eAAe,EAAE,CAAC;AACrC,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAc;IAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,iBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,IAAA,oBAAS,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,eAAe;IAC7B,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC"}