@applica-software-guru/sdd-core 0.1.0

package/tests/integration.test.ts

@@ -0,0 +1,132 @@
+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();
+}
+
+const VISION_MD = `---
+title: "Product Vision"
+status: new
+author: ""
+last-modified: "2024-01-01T00:00:00.000Z"
+version: "1.0"
+---
+
+# Product Vision
+
+A test project.
+`;
+
+describe('SDD integration', () => {
+  let tempDir: string;
+
+  beforeEach(async () => {
+    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 () => {
+    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 config = await sdd.config();
+    expect(config.description).toBe('A test app');
+  });
+
+  it('full workflow: init → add doc → status → sync → mark-synced', async () => {
+    const sdd = new SDD({ root: tempDir });
+    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');
+
+    // Status — file should be "new"
+    const status = await sdd.status();
+    expect(status.files.length).toBe(1);
+    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**');
+
+    // 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');
+
+    // Agent commits after mark-synced
+    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');
+  });
+
+  it('mark-synced with changed status', async () => {
+    const sdd = new SDD({ root: tempDir });
+    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 marked = await sdd.markSynced();
+    expect(marked).toContain('product/vision.md');
+
+    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 () => {
+    const sdd = new SDD({ root: tempDir });
+    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 marked = await sdd.markSynced();
+    expect(marked[0]).toContain('removed');
+    expect(existsSync(join(tempDir, 'product/vision.md'))).toBe(false);
+  });
+
+  it('throws when project not initialized', async () => {
+    const sdd = new SDD({ root: tempDir });
+    await expect(sdd.status()).rejects.toThrow('No SDD project found');
+  });
+
+  it('init is idempotent for INSTRUCTIONS.md', 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');
+  });
+});

package/tests/parser.test.ts

@@ -0,0 +1,92 @@
+import { describe, it, expect } from 'vitest';
+import { parseFrontmatter } from '../src/parser/frontmatter.js';
+import { extractPendingItems, extractAgentNotes } from '../src/parser/section-extractor.js';
+import { extractCrossRefs } from '../src/parser/ref-extractor.js';
+
+describe('parseFrontmatter', () => {
+  it('parses valid frontmatter', () => {
+    const content = `---
+title: "Auth Feature"
+status: draft
+author: "test@example.com"
+last-modified: "2024-01-01"
+version: "1.2"
+---
+
+# Content here`;
+
+    const result = parseFrontmatter('test.md', content);
+    expect(result.frontmatter.title).toBe('Auth Feature');
+    expect(result.frontmatter.status).toBe('draft');
+    expect(result.frontmatter.version).toBe('1.2');
+    expect(result.body).toContain('# Content here');
+  });
+
+  it('provides defaults for missing fields', () => {
+    const content = `---
+title: "Test"
+---
+
+Body`;
+
+    const result = parseFrontmatter('test.md', content);
+    expect(result.frontmatter.status).toBe('draft');
+    expect(result.frontmatter.version).toBe('1.0');
+  });
+});
+
+describe('extractPendingItems', () => {
+  it('extracts unchecked and checked items', () => {
+    const body = `# Feature
+
+## Pending Changes
+- [ ] Add validation
+- [x] Create model
+- [ ] Write tests
+
+## Other`;
+
+    const items = extractPendingItems(body);
+    expect(items).toHaveLength(3);
+    expect(items[0]).toEqual({ text: 'Add validation', checked: false });
+    expect(items[1]).toEqual({ text: 'Create model', checked: true });
+    expect(items[2]).toEqual({ text: 'Write tests', checked: false });
+  });
+
+  it('returns empty array when section is missing', () => {
+    const items = extractPendingItems('# Just a doc\n\nSome content.');
+    expect(items).toEqual([]);
+  });
+});
+
+describe('extractAgentNotes', () => {
+  it('extracts agent notes section', () => {
+    const body = `# Feature
+
+## Agent Notes
+Do not modify existing auth logic.
+Follow adapter interface.
+
+## Other`;
+
+    const notes = extractAgentNotes(body);
+    expect(notes).toContain('Do not modify existing auth logic.');
+    expect(notes).toContain('Follow adapter interface.');
+  });
+
+  it('returns null when section is missing', () => {
+    expect(extractAgentNotes('# No notes here')).toBeNull();
+  });
+});
+
+describe('extractCrossRefs', () => {
+  it('extracts unique cross-references', () => {
+    const body = 'Use [[User]] model and [[Session]] entity. Also reference [[User]] again.';
+    const refs = extractCrossRefs(body);
+    expect(refs).toEqual(['User', 'Session']);
+  });
+
+  it('returns empty array with no refs', () => {
+    expect(extractCrossRefs('No references here.')).toEqual([]);
+  });
+});

package/tests/prompt.test.ts

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest';
+import { generatePrompt } from '../src/prompt/prompt-generator.js';
+import type { StoryFile } from '../src/types.js';
+
+function makeFile(overrides: Partial<StoryFile> = {}): StoryFile {
+  return {
+    relativePath: 'product/features/auth.md',
+    frontmatter: {
+      title: 'Auth',
+      status: 'new',
+      author: 'test',
+      'last-modified': '2024-01-01T00:00:00.000Z',
+      version: '1.0',
+    },
+    body: '# Auth Feature',
+    pendingItems: [],
+    agentNotes: null,
+    crossRefs: [],
+    hash: 'abc',
+    ...overrides,
+  };
+}
+
+describe('generatePrompt', () => {
+  it('generates prompt with new files', () => {
+    const files = [makeFile()];
+    const prompt = generatePrompt(files, '/tmp');
+    expect(prompt).toContain('# SDD Sync Prompt');
+    expect(prompt).toContain('product/features/auth.md');
+    expect(prompt).toContain('**new**');
+    expect(prompt).toContain('Read each file listed above');
+  });
+
+  it('generates prompt with deleted files', () => {
+    const files = [makeFile({
+      frontmatter: { ...makeFile().frontmatter, status: 'deleted' },
+    })];
+    const prompt = generatePrompt(files, '/tmp');
+    expect(prompt).toContain('**deleted**');
+    expect(prompt).toContain('Files to remove');
+    expect(prompt).toContain('remove all related code');
+  });
+
+  it('generates prompt with changed files', () => {
+    const files = [makeFile({
+      frontmatter: { ...makeFile().frontmatter, status: 'changed' },
+    })];
+    const prompt = generatePrompt(files, '/tmp');
+    expect(prompt).toContain('**changed**');
+  });
+
+  it('generates empty prompt when no pending files', () => {
+    const prompt = generatePrompt([]);
+    expect(prompt).toContain('# SDD Sync Prompt');
+    expect(prompt).toContain('Nothing to do');
+  });
+});

package/tests/validator.test.ts

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { validate } from '../src/validate/validator.js';
+import type { StoryFile } from '../src/types.js';
+
+function makeFile(overrides: Partial<StoryFile> = {}): StoryFile {
+  return {
+    relativePath: 'product/vision.md',
+    frontmatter: {
+      title: 'Vision',
+      status: 'draft',
+      author: 'test',
+      'last-modified': '2024-01-01',
+      version: '1.0',
+    },
+    body: '# Vision',
+    pendingItems: [],
+    agentNotes: null,
+    crossRefs: [],
+    hash: 'abc',
+    ...overrides,
+  };
+}
+
+describe('validate', () => {
+  it('returns valid when no issues', () => {
+    const result = validate([makeFile()]);
+    expect(result.valid).toBe(true);
+    expect(result.issues).toHaveLength(0);
+  });
+
+  it('warns on broken cross-references', () => {
+    const entities = makeFile({
+      relativePath: 'system/entities.md',
+      body: '# Entities\n\n### User\n\nA user.',
+    });
+    const feature = makeFile({
+      relativePath: 'product/features/auth.md',
+      crossRefs: ['User', 'NonExistent'],
+    });
+    const result = validate([entities, feature]);
+    expect(result.issues).toHaveLength(1);
+    expect(result.issues[0].rule).toBe('broken-ref');
+    expect(result.issues[0].message).toContain('NonExistent');
+  });
+
+  it('warns on missing title', () => {
+    const file = makeFile({
+      frontmatter: { ...makeFile().frontmatter, title: '' },
+    });
+    const result = validate([file]);
+    expect(result.issues).toHaveLength(1);
+    expect(result.issues[0].rule).toBe('missing-frontmatter');
+  });
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}