@specsafe/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Engineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,282 @@
+# @specsafe/core
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/@specsafe/core.svg" alt="npm version">
+  <img src="https://img.shields.io/npm/l/@specsafe/core.svg" alt="license">
+</p>
+
+Core workflow engine, types, and utilities for the SpecSafe spec-driven development framework.
+
+## Installation
+
+```bash
+npm install @specsafe/core
+```
+
+## What It Provides
+
+- **Workflow Engine** - Manage spec lifecycle from creation to archive
+- **ProjectTracker** - Track project state and spec metadata
+- **TypeScript Types** - Full type definitions for specs, requirements, and reports
+- **Validation Utilities** - Schema validation and ID validation
+
+## API Reference
+
+### Workflow Class
+
+The main class for managing spec workflows.
+
+```typescript
+import { Workflow } from '@specsafe/core';
+
+const workflow = new Workflow({
+  specsDir: './specs',
+  projectName: 'My Project'
+});
+```
+
+#### `createSpec(specId: string, content: string): Promise<Spec>`
+
+Create a new specification.
+
+```typescript
+const spec = await workflow.createSpec('user-auth', `# User Authentication
+
+## Requirements
+
+### REQ-001: Login
+**Given** a registered user
+**When** they enter valid credentials
+**Then** they should be logged in
+`);
+```
+
+#### `moveToTest(specId: string): Promise<Spec>`
+
+Move a spec to the "test" phase.
+
+```typescript
+const spec = await workflow.moveToTest('user-auth');
+```
+
+#### `moveToCode(specId: string): Promise<Spec>`
+
+Move a spec to the "code" phase.
+
+```typescript
+const spec = await workflow.moveToCode('user-auth');
+```
+
+#### `moveToQA(specId: string, report?: QAReport): Promise<Spec>`
+
+Transition a spec into QA review or mark QA as complete. Optionally accepts a QAReport to record results.
+
+```typescript
+const spec = await workflow.moveToQA('user-auth', {
+  passed: true,
+  notes: 'All tests passing'
+});
+```
+
+#### `complete(specId: string): Promise<Spec>`
+
+Mark a spec as complete.
+
+```typescript
+const spec = await workflow.complete('user-auth');
+```
+
+#### `archive(specId: string): Promise<Spec>`
+
+Archive a completed spec.
+
+```typescript
+const spec = await workflow.archive('user-auth');
+```
+
+#### `getSpec(specId: string): Promise<Spec | null>`
+
+Get a spec by ID.
+
+```typescript
+const spec = await workflow.getSpec('user-auth');
+```
+
+#### `listSpecs(phase?: Phase): Promise<Spec[]>`
+
+List all specs or filter by phase.
+
+```typescript
+// All specs
+const allSpecs = await workflow.listSpecs();
+
+// Only active specs
+const activeSpecs = await workflow.listSpecs('active');
+```
+
+---
+
+### ProjectTracker Class
+
+Track project-level state and metadata.
+
+```typescript
+import { ProjectTracker } from '@specsafe/core';
+
+const tracker = new ProjectTracker('./specs');
+```
+
+#### `getProjectState(): Promise<ProjectState>`
+
+Get the current project state.
+
+```typescript
+const state = await tracker.getProjectState();
+console.log(state.activeSpecs.length);
+console.log(state.completedSpecs.length);
+```
+
+#### `updateSpecStatus(specId: string, status: SpecStatus): Promise<void>`
+
+Update the status of a spec.
+
+```typescript
+await tracker.updateSpecStatus('user-auth', 'in-progress');
+```
+
+---
+
+### Validation Utilities
+
+#### `validateSpecId(specId: string): boolean`
+
+Validate a spec ID format.
+
+```typescript
+import { validateSpecId } from '@specsafe/core';
+
+validateSpecId('user-auth');     // true
+validateSpecId('user_auth');     // false (underscores not allowed)
+validateSpecId('user-auth-123'); // true
+```
+
+---
+
+## TypeScript Types
+
+### Spec
+
+```typescript
+interface Spec {
+  id: string;
+  title: string;
+  description: string;
+  phase: Phase;
+  status: SpecStatus;
+  requirements: Requirement[];
+  acceptanceCriteria: string[];
+  technicalNotes?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  completedAt?: Date;
+  qaReport?: QAReport;
+}
+```
+
+### Requirement
+
+```typescript
+interface Requirement {
+  id: string;
+  title: string;
+  given: string;
+  when: string;
+  then: string;
+}
+```
+
+### QAReport
+
+```typescript
+interface QAReport {
+  passed: boolean;
+  notes?: string;
+  testedAt: Date;
+  testedBy?: string;
+}
+```
+
+### Phase
+
+```typescript
+type Phase = 'draft' | 'active' | 'test' | 'code' | 'qa' | 'completed' | 'archived';
+```
+
+### SpecStatus
+
+```typescript
+type SpecStatus = 'pending' | 'in-progress' | 'blocked' | 'completed';
+```
+
+---
+
+## Usage Examples
+
+### Basic Workflow
+
+```typescript
+import { Workflow } from '@specsafe/core';
+
+async function main() {
+  const workflow = new Workflow({
+    specsDir: './specs',
+    projectName: 'My App'
+  });
+
+  // Create a spec
+  await workflow.createSpec('email-validation', `
+# Email Validation
+
+## Requirements
+
+### REQ-001: Valid Email Format
+**Given** an email input field
+**When** the user enters "user@example.com"
+**Then** the email should be marked as valid
+
+### REQ-002: Invalid Email Format
+**Given** an email input field
+**When** the user enters "invalid-email"
+**Then** an error message should be shown
+`);
+
+  // Move through phases
+  await workflow.moveToTest('email-validation');
+  await workflow.moveToCode('email-validation');
+  await workflow.moveToQA('email-validation', { passed: true });
+  await workflow.complete('email-validation');
+}
+
+main();
+```
+
+### Project Statistics
+
+```typescript
+import { ProjectTracker } from '@specsafe/core';
+
+async function printStats() {
+  const tracker = new ProjectTracker('./specs');
+  const state = await tracker.getProjectState();
+
+  console.log(`Active specs: ${state.activeSpecs.length}`);
+  console.log(`Completed: ${state.completedSpecs.length}`);
+  console.log(`Archived: ${state.archivedSpecs.length}`);
+}
+```
+
+---
+
+## License
+
+MIT © Agentic Engineering

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SpecSafe Core - Workflow Engine and Types
+ *
+ * This package provides the core types and workflow engine for the SpecSafe
+ * Test-Driven Development framework.
+ *
+ * @example
+ * ```typescript
+ * import { Workflow, ProjectTracker } from '@specsafe/core';
+ *
+ * const workflow = new Workflow();
+ * const spec = workflow.createSpec('auth-001', 'User Authentication', '...', 'dev', 'myapp');
+ *
+ * workflow.moveToTest(spec.id);
+ * workflow.moveToCode(spec.id);
+ * workflow.moveToQA(spec.id);
+ *
+ * // After QA passes
+ * workflow.moveToComplete(spec.id, qaReport);
+ * ```
+ */
+export type { Spec, SpecStage, Requirement, Scenario, QAReport, TestResult, CoverageReport, Issue, ProjectState, SpecSummary, ProjectMetrics } from './types.js';
+export { Workflow } from './workflow.js';
+export { ProjectTracker } from './tracker.js';
+export { validateSpecId } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EACV,IAAI,EACJ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,KAAK,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * SpecSafe Core - Workflow Engine and Types
+ *
+ * This package provides the core types and workflow engine for the SpecSafe
+ * Test-Driven Development framework.
+ *
+ * @example
+ * ```typescript
+ * import { Workflow, ProjectTracker } from '@specsafe/core';
+ *
+ * const workflow = new Workflow();
+ * const spec = workflow.createSpec('auth-001', 'User Authentication', '...', 'dev', 'myapp');
+ *
+ * workflow.moveToTest(spec.id);
+ * workflow.moveToCode(spec.id);
+ * workflow.moveToQA(spec.id);
+ *
+ * // After QA passes
+ * workflow.moveToComplete(spec.id, qaReport);
+ * ```
+ */
+// Workflow engine
+export { Workflow } from './workflow.js';
+// Project tracker
+export { ProjectTracker } from './tracker.js';
+// Validation utilities
+export { validateSpecId } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAiBH,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tracker.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SpecSafe Project State Tracker
+ * Manages PROJECT_STATE.md for tracking all specs
+ */
+import type { Spec, ProjectState } from './types.js';
+import type { Workflow } from './workflow.js';
+export declare class ProjectTracker {
+    private projectPath;
+    private stateFile;
+    constructor(projectPath: string);
+    /**
+     * Initialize a new PROJECT_STATE.md
+     */
+    initialize(projectName: string): Promise<void>;
+    /**
+     * Read current project state
+     */
+    readState(): Promise<ProjectState | null>;
+    /**
+     * Update PROJECT_STATE.md with new spec
+     */
+    addSpec(spec: Spec): Promise<void>;
+    /**
+     * Write state to PROJECT_STATE.md
+     */
+    private writeState;
+    /**
+     * Generate markdown content
+     */
+    private generateMarkdown;
+    private generateSpecsTable;
+    private getPercentage;
+    private calculateProgress;
+    private calculateMetrics;
+    private parseMarkdown;
+    /**
+     * Load all specs from PROJECT_STATE.md into a Workflow instance
+     */
+    loadSpecsIntoWorkflow(workflow: Workflow): Promise<void>;
+    private createDefaultState;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAA0C,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiB/C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxC;;OAEG;YACW,UAAU;IAKxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAsCxB,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAwChD,kBAAkB;CAcjC"}

package/dist/tracker.js

@@ -0,0 +1,287 @@
+/**
+ * SpecSafe Project State Tracker
+ * Manages PROJECT_STATE.md for tracking all specs
+ */
+import { writeFile, readFile, access } from 'fs/promises';
+import { join } from 'path';
+export class ProjectTracker {
+    projectPath;
+    stateFile;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.stateFile = join(projectPath, 'PROJECT_STATE.md');
+    }
+    /**
+     * Initialize a new PROJECT_STATE.md
+     */
+    async initialize(projectName) {
+        const state = {
+            projectName,
+            version: '1.0.0',
+            lastUpdated: new Date(),
+            specs: [],
+            metrics: {
+                totalSpecs: 0,
+                byStage: {
+                    spec: 0,
+                    test: 0,
+                    code: 0,
+                    qa: 0,
+                    complete: 0,
+                    archived: 0
+                },
+                completionRate: 0,
+                averageCycleTime: 0
+            }
+        };
+        await this.writeState(state);
+    }
+    /**
+     * Read current project state
+     */
+    async readState() {
+        try {
+            await access(this.stateFile);
+            const content = await readFile(this.stateFile, 'utf-8');
+            const parsed = this.parseMarkdown(content);
+            if (parsed === null && content.length > 0) {
+                throw new Error('Failed to parse PROJECT_STATE.md - file exists but is malformed');
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update PROJECT_STATE.md with new spec
+     */
+    async addSpec(spec) {
+        const state = await this.readState() || await this.createDefaultState();
+        const summary = {
+            id: spec.id,
+            name: spec.name,
+            stage: spec.stage,
+            progress: this.calculateProgress(spec),
+            lastUpdated: spec.updatedAt,
+            createdAt: spec.createdAt,
+            completedAt: spec.completedAt
+        };
+        // Update or add spec
+        const existingIndex = state.specs.findIndex(s => s.id === spec.id);
+        if (existingIndex >= 0) {
+            // Preserve createdAt from existing summary if not set
+            if (!summary.createdAt && state.specs[existingIndex].createdAt) {
+                summary.createdAt = state.specs[existingIndex].createdAt;
+            }
+            state.specs[existingIndex] = summary;
+        }
+        else {
+            state.specs.push(summary);
+        }
+        state.lastUpdated = new Date();
+        state.metrics = this.calculateMetrics(state.specs);
+        await this.writeState(state);
+    }
+    /**
+     * Write state to PROJECT_STATE.md
+     */
+    async writeState(state) {
+        const markdown = this.generateMarkdown(state);
+        await writeFile(this.stateFile, markdown, 'utf-8');
+    }
+    /**
+     * Generate markdown content
+     */
+    generateMarkdown(state) {
+        const date = state.lastUpdated.toISOString().split('T')[0];
+        return `# ${state.projectName} - Project State
+
+**Version:** ${state.version}  
+**Last Updated:** ${date}
+
+---
+
+## 📊 Metrics
+
+| Metric | Value |
+|--------|-------|
+| Total Specs | ${state.metrics.totalSpecs} |
+| Completion Rate | ${(state.metrics.completionRate * 100).toFixed(1)}% |
+| Avg Cycle Time | ${state.metrics.averageCycleTime.toFixed(1)} days |
+
+### By Stage
+
+| Stage | Count | Percentage |
+|-------|-------|------------|
+| SPEC | ${state.metrics.byStage.spec} | ${this.getPercentage(state.metrics.byStage.spec, state.metrics.totalSpecs)}% |
+| TEST | ${state.metrics.byStage.test} | ${this.getPercentage(state.metrics.byStage.test, state.metrics.totalSpecs)}% |
+| CODE | ${state.metrics.byStage.code} | ${this.getPercentage(state.metrics.byStage.code, state.metrics.totalSpecs)}% |
+| QA | ${state.metrics.byStage.qa} | ${this.getPercentage(state.metrics.byStage.qa, state.metrics.totalSpecs)}% |
+| COMPLETE | ${state.metrics.byStage.complete} | ${this.getPercentage(state.metrics.byStage.complete, state.metrics.totalSpecs)}% |
+| ARCHIVED | ${state.metrics.byStage.archived} | ${this.getPercentage(state.metrics.byStage.archived, state.metrics.totalSpecs)}% |
+
+---
+
+## 📋 Active Specs
+
+${this.generateSpecsTable(state.specs)}
+
+---
+
+*This file is auto-generated by SpecSafe*
+`;
+    }
+    generateSpecsTable(specs) {
+        if (specs.length === 0)
+            return 'No specs yet.';
+        const rows = specs
+            .sort((a, b) => b.lastUpdated.getTime() - a.lastUpdated.getTime())
+            .map(s => `| ${s.id} | ${s.name} | ${s.stage.toUpperCase()} | ${s.progress}% | ${s.lastUpdated.toISOString().split('T')[0]} |`)
+            .join('\n');
+        return `| ID | Name | Stage | Progress | Last Updated |
+|----|------|-------|----------|--------------|
+${rows}`;
+    }
+    getPercentage(count, total) {
+        if (total === 0)
+            return '0.0';
+        return ((count / total) * 100).toFixed(1);
+    }
+    calculateProgress(spec) {
+        const stageWeights = {
+            spec: 20,
+            test: 40,
+            code: 60,
+            qa: 80,
+            complete: 100,
+            archived: 100
+        };
+        return stageWeights[spec.stage] || 0;
+    }
+    calculateMetrics(specs) {
+        const total = specs.length;
+        const byStage = {
+            spec: specs.filter(s => s.stage === 'spec').length,
+            test: specs.filter(s => s.stage === 'test').length,
+            code: specs.filter(s => s.stage === 'code').length,
+            qa: specs.filter(s => s.stage === 'qa').length,
+            complete: specs.filter(s => s.stage === 'complete').length,
+            archived: specs.filter(s => s.stage === 'archived').length
+        };
+        const completionRate = total > 0 ? byStage.complete / total : 0;
+        // Calculate average cycle time for completed specs (in days)
+        let totalCycleTime = 0;
+        let completedCount = 0;
+        for (const spec of specs) {
+            const isCompleted = spec.stage === 'complete' || spec.stage === 'archived';
+            if (isCompleted && spec.completedAt && spec.createdAt) {
+                const cycleTime = spec.completedAt.getTime() - spec.createdAt.getTime();
+                totalCycleTime += cycleTime;
+                completedCount++;
+            }
+        }
+        const averageCycleTime = completedCount > 0
+            ? totalCycleTime / completedCount / (1000 * 60 * 60 * 24)
+            : 0;
+        return {
+            totalSpecs: total,
+            byStage,
+            completionRate,
+            averageCycleTime
+        };
+    }
+    parseMarkdown(content) {
+        try {
+            // Extract project name from header
+            const nameMatch = content.match(/^#\s+(.+?)\s+-\s+Project\s+State/m);
+            const projectName = nameMatch ? nameMatch[1] : 'Untitled Project';
+            // Extract version
+            const versionMatch = content.match(/\*\*Version:\*\*\s*(.+)/m);
+            const version = versionMatch ? versionMatch[1].trim() : '1.0.0';
+            // Extract specs from table
+            const specs = [];
+            const tableRegex = /\|\s*(SPEC-\d+-\d+)\s*\|\s*([^|]+)\|\s*(SPEC|TEST|CODE|QA|COMPLETE|ARCHIVED)\s*\|\s*(\d+)%?\s*\|\s*(\d{4}-\d{2}-\d{2})\s*\|/gi;
+            let match;
+            while ((match = tableRegex.exec(content)) !== null) {
+                specs.push({
+                    id: match[1].trim(),
+                    name: match[2].trim(),
+                    stage: match[3].toLowerCase(),
+                    progress: parseInt(match[4], 10),
+                    lastUpdated: new Date(match[5])
+                });
+            }
+            // Calculate metrics
+            const metrics = this.calculateMetrics(specs);
+            return {
+                projectName,
+                version,
+                lastUpdated: new Date(),
+                specs,
+                metrics
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load all specs from PROJECT_STATE.md into a Workflow instance
+     */
+    async loadSpecsIntoWorkflow(workflow) {
+        const state = await this.readState();
+        if (!state)
+            return;
+        for (const summary of state.specs) {
+            // Try to read the actual spec file for full details
+            const dir = summary.stage === 'complete' || summary.stage === 'archived' ? 'completed' : 'active';
+            const specPath = join(this.projectPath, 'specs', dir, `${summary.id}.md`);
+            // Create spec object from summary data
+            const spec = {
+                id: summary.id,
+                name: summary.name,
+                description: '',
+                stage: summary.stage,
+                createdAt: summary.createdAt || summary.lastUpdated,
+                updatedAt: summary.lastUpdated,
+                completedAt: summary.completedAt,
+                requirements: [],
+                testFiles: [],
+                implementationFiles: [],
+                metadata: {
+                    author: '',
+                    project: '',
+                    tags: []
+                }
+            };
+            // Try to read actual spec file for richer data
+            try {
+                await access(specPath);
+                // File exists — we could parse more details here in the future
+            }
+            catch {
+                // Spec file not found, still load the summary-based spec
+            }
+            workflow.loadSpec(spec);
+        }
+    }
+    async createDefaultState() {
+        return {
+            projectName: 'Untitled Project',
+            version: '1.0.0',
+            lastUpdated: new Date(),
+            specs: [],
+            metrics: {
+                totalSpecs: 0,
+                byStage: { spec: 0, test: 0, code: 0, qa: 0, complete: 0, archived: 0 },
+                completionRate: 0,
+                averageCycleTime: 0
+            }
+        };
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SpecSafe Core Types
+ * Defines the data structures for the SPEC → TEST → CODE → QA → COMPLETE workflow
+ */
+export type SpecStage = 'spec' | 'test' | 'code' | 'qa' | 'complete' | 'archived';
+export interface Requirement {
+    id: string;
+    text: string;
+    priority: 'P0' | 'P1' | 'P2';
+    scenarios: Scenario[];
+}
+export interface Scenario {
+    id: string;
+    given: string;
+    when: string;
+    then: string;
+}
+export interface Spec {
+    id: string;
+    name: string;
+    description: string;
+    stage: SpecStage;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    requirements: Requirement[];
+    testFiles: string[];
+    implementationFiles: string[];
+    qaReport?: QAReport;
+    metadata: {
+        author: string;
+        project: string;
+        tags: string[];
+    };
+}
+export interface QAReport {
+    id: string;
+    specId: string;
+    timestamp: Date;
+    testResults: TestResult[];
+    coverage: CoverageReport;
+    recommendation: 'GO' | 'NO-GO';
+    issues: Issue[];
+    notes: string;
+}
+export interface TestResult {
+    file: string;
+    passed: number;
+    failed: number;
+    skipped: number;
+    duration: number;
+}
+export interface CoverageReport {
+    statements: number;
+    branches: number;
+    functions: number;
+    lines: number;
+}
+export interface Issue {
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    description: string;
+    file?: string;
+    line?: number;
+}
+export interface ProjectState {
+    projectName: string;
+    version: string;
+    lastUpdated: Date;
+    specs: SpecSummary[];
+    metrics: ProjectMetrics;
+}
+export interface SpecSummary {
+    id: string;
+    name: string;
+    stage: SpecStage;
+    progress: number;
+    lastUpdated: Date;
+    createdAt?: Date;
+    completedAt?: Date;
+}
+export interface ProjectMetrics {
+    totalSpecs: number;
+    byStage: Record<SpecStage, number>;
+    completionRate: number;
+    averageCycleTime: number;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * SpecSafe Core Types
+ * Defines the data structures for the SPEC → TEST → CODE → QA → COMPLETE workflow
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validation utilities for SpecSafe
+ */
+/**
+ * Validates that a spec ID matches the required format: SPEC-YYYYMMDD-NNN
+ * @param id - The spec ID to validate
+ * @throws Error if the ID is invalid
+ */
+export declare function validateSpecId(id: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAiB/C"}

package/dist/validation.js

@@ -0,0 +1,27 @@
+/**
+ * Validation utilities for SpecSafe
+ */
+const SPEC_ID_REGEX = /^SPEC-\d{8}-\d{3}$/;
+/**
+ * Validates that a spec ID matches the required format: SPEC-YYYYMMDD-NNN
+ * @param id - The spec ID to validate
+ * @throws Error if the ID is invalid
+ */
+export function validateSpecId(id) {
+    if (!id || typeof id !== 'string') {
+        throw new Error('Spec ID is required and must be a string');
+    }
+    if (!SPEC_ID_REGEX.test(id)) {
+        throw new Error(`Invalid spec ID format: "${id}". Expected format: SPEC-YYYYMMDD-NNN (e.g., SPEC-20250211-001)`);
+    }
+    // Validate the date portion is a real date
+    const dateStr = id.substring(5, 13); // YYYYMMDD
+    const year = parseInt(dateStr.substring(0, 4), 10);
+    const month = parseInt(dateStr.substring(4, 6), 10);
+    const day = parseInt(dateStr.substring(6, 8), 10);
+    const date = new Date(year, month - 1, day);
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        throw new Error(`Invalid spec ID "${id}": contains invalid date ${dateStr}. Expected format: SPEC-YYYYMMDD-NNN`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,iEAAiE,CAAC,CAAC;IACnH,CAAC;IAED,2CAA2C;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,4BAA4B,OAAO,sCAAsC,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,67 @@
+/**
+ * SpecSafe Workflow Engine
+ * Manages the 5-stage development cycle: SPEC → TEST → CODE → QA → COMPLETE
+ */
+import type { Spec, SpecStage, QAReport } from './types.js';
+export declare class Workflow {
+    private specs;
+    /**
+     * Create a new spec in the SPEC stage
+     */
+    createSpec(id: string, name: string, description: string, author: string, project: string): Spec;
+    /**
+     * Get a spec by ID
+     */
+    getSpec(id: string): Spec | undefined;
+    /**
+     * Load an existing spec into the workflow (for hydration from disk)
+     */
+    loadSpec(spec: Spec): void;
+    /**
+     * Get all specs
+     */
+    getAllSpecs(): Spec[];
+    /**
+     * Get specs by stage
+     */
+    getSpecsByStage(stage: SpecStage): Spec[];
+    /**
+     * Transition spec to TEST stage
+     * Requirements must be defined
+     */
+    moveToTest(specId: string): Spec;
+    /**
+     * Transition spec to CODE stage
+     * Tests must be generated
+     */
+    moveToCode(specId: string): Spec;
+    /**
+     * Transition spec to QA stage
+     * Implementation must be complete
+     */
+    moveToQA(specId: string): Spec;
+    /**
+     * Transition spec to COMPLETE stage
+     * QA report must be provided with GO recommendation
+     */
+    moveToComplete(specId: string, qaReport: QAReport): Spec;
+    /**
+     * Archive a completed spec
+     */
+    archiveSpec(specId: string): Spec;
+    /**
+     * Get workflow status summary
+     */
+    getStatus(): {
+        stage: SpecStage;
+        count: number;
+    }[];
+    /**
+     * Validate stage transition
+     */
+    canTransition(specId: string, toStage: SpecStage): {
+        valid: boolean;
+        reason?: string;
+    };
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAgC;IAE7C;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA0BhG;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE;IAIzC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAehC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAehC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAe9B;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAqBxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYjC;;OAEG;IACH,SAAS,IAAI;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE;IAQlD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAgCvF"}

package/dist/workflow.js

@@ -0,0 +1,193 @@
+/**
+ * SpecSafe Workflow Engine
+ * Manages the 5-stage development cycle: SPEC → TEST → CODE → QA → COMPLETE
+ */
+export class Workflow {
+    specs = new Map();
+    /**
+     * Create a new spec in the SPEC stage
+     */
+    createSpec(id, name, description, author, project) {
+        // Check if spec already exists to prevent overwriting
+        if (this.specs.has(id)) {
+            throw new Error(`Spec with ID ${id} already exists. Use a different name or delete the existing spec first.`);
+        }
+        const spec = {
+            id,
+            name,
+            description,
+            stage: 'spec',
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            requirements: [],
+            testFiles: [],
+            implementationFiles: [],
+            metadata: {
+                author,
+                project,
+                tags: []
+            }
+        };
+        this.specs.set(id, spec);
+        return spec;
+    }
+    /**
+     * Get a spec by ID
+     */
+    getSpec(id) {
+        return this.specs.get(id);
+    }
+    /**
+     * Load an existing spec into the workflow (for hydration from disk)
+     */
+    loadSpec(spec) {
+        this.specs.set(spec.id, spec);
+    }
+    /**
+     * Get all specs
+     */
+    getAllSpecs() {
+        return Array.from(this.specs.values());
+    }
+    /**
+     * Get specs by stage
+     */
+    getSpecsByStage(stage) {
+        return this.getAllSpecs().filter(s => s.stage === stage);
+    }
+    /**
+     * Transition spec to TEST stage
+     * Requirements must be defined
+     */
+    moveToTest(specId) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            throw new Error(`Spec ${specId} not found`);
+        if (spec.stage !== 'spec') {
+            throw new Error(`Cannot move to TEST from ${spec.stage}. Must be in SPEC stage.`);
+        }
+        if (spec.requirements.length === 0) {
+            throw new Error('Cannot move to TEST: No requirements defined');
+        }
+        spec.stage = 'test';
+        spec.updatedAt = new Date();
+        return spec;
+    }
+    /**
+     * Transition spec to CODE stage
+     * Tests must be generated
+     */
+    moveToCode(specId) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            throw new Error(`Spec ${specId} not found`);
+        if (spec.stage !== 'test') {
+            throw new Error(`Cannot move to CODE from ${spec.stage}. Must be in TEST stage.`);
+        }
+        if (spec.testFiles.length === 0) {
+            throw new Error('Cannot move to CODE: No test files generated');
+        }
+        spec.stage = 'code';
+        spec.updatedAt = new Date();
+        return spec;
+    }
+    /**
+     * Transition spec to QA stage
+     * Implementation must be complete
+     */
+    moveToQA(specId) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            throw new Error(`Spec ${specId} not found`);
+        if (spec.stage !== 'code') {
+            throw new Error(`Cannot move to QA from ${spec.stage}. Must be in CODE stage.`);
+        }
+        if (spec.implementationFiles.length === 0) {
+            throw new Error('Cannot move to QA: No implementation files');
+        }
+        spec.stage = 'qa';
+        spec.updatedAt = new Date();
+        return spec;
+    }
+    /**
+     * Transition spec to COMPLETE stage
+     * QA report must be provided with GO recommendation
+     */
+    moveToComplete(specId, qaReport) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            throw new Error(`Spec ${specId} not found`);
+        if (spec.stage !== 'qa') {
+            throw new Error(`Cannot move to COMPLETE from ${spec.stage}. Must be in QA stage.`);
+        }
+        // Validate QA report belongs to target spec
+        if (qaReport.specId !== specId) {
+            throw new Error(`QA report spec ID (${qaReport.specId}) does not match target spec (${specId})`);
+        }
+        if (qaReport.recommendation !== 'GO') {
+            throw new Error('Cannot complete: QA report recommends NO-GO. Address issues first.');
+        }
+        spec.stage = 'complete';
+        spec.qaReport = qaReport;
+        spec.completedAt = new Date();
+        spec.updatedAt = new Date();
+        return spec;
+    }
+    /**
+     * Archive a completed spec
+     */
+    archiveSpec(specId) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            throw new Error(`Spec ${specId} not found`);
+        if (spec.stage !== 'complete') {
+            throw new Error(`Cannot archive spec in ${spec.stage} stage. Must be COMPLETE.`);
+        }
+        spec.stage = 'archived';
+        spec.updatedAt = new Date();
+        return spec;
+    }
+    /**
+     * Get workflow status summary
+     */
+    getStatus() {
+        const stages = ['spec', 'test', 'code', 'qa', 'complete', 'archived'];
+        return stages.map(stage => ({
+            stage,
+            count: this.getSpecsByStage(stage).length
+        }));
+    }
+    /**
+     * Validate stage transition
+     */
+    canTransition(specId, toStage) {
+        const spec = this.getSpec(specId);
+        if (!spec)
+            return { valid: false, reason: 'Spec not found' };
+        const transitions = {
+            spec: ['test'],
+            test: ['code'],
+            code: ['qa'],
+            qa: ['complete'],
+            complete: ['archived'],
+            archived: []
+        };
+        if (!transitions[spec.stage].includes(toStage)) {
+            return { valid: false, reason: `Cannot transition from ${spec.stage} to ${toStage}` };
+        }
+        // Validate prerequisites based on target stage
+        if (toStage === 'test' && spec.requirements.length === 0) {
+            return { valid: false, reason: 'Cannot move to TEST: No requirements defined' };
+        }
+        if (toStage === 'code' && spec.testFiles.length === 0) {
+            return { valid: false, reason: 'Cannot move to CODE: No test files generated' };
+        }
+        if (toStage === 'qa' && spec.implementationFiles.length === 0) {
+            return { valid: false, reason: 'Cannot move to QA: No implementation files' };
+        }
+        // Note: 'complete' transition requires a QA report, but that's validated in moveToComplete()
+        // since canTransition() doesn't have access to the QAReport parameter
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@specsafe/core",
+  "version": "0.1.0",
+  "description": "Core types and workflow engine for SpecSafe",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}