@pixel613/spec 1.0.1

package/dist/src/parsers/plan.js

@@ -0,0 +1,117 @@
+/**
+ * Parse a plan markdown file into structured tasks.
+ */
+export function parsePlan(content) {
+    const result = {
+        name: '',
+        type: 'feat',
+        branch: '',
+        totalTasks: 0,
+        tasks: [],
+        raw: content,
+    };
+    const lines = content.split('\n');
+    // Extract metadata from blockquotes at top
+    for (const line of lines) {
+        const typeMatch = line.match(/^>\s*type:\s*(.+)/);
+        if (typeMatch) {
+            result.type = typeMatch[1].trim();
+        }
+        const branchMatch = line.match(/^>\s*branch:\s*(.+)/);
+        if (branchMatch) {
+            result.branch = branchMatch[1].trim();
+        }
+        const totalMatch = line.match(/^>\s*total_tasks:\s*(\d+)/);
+        if (totalMatch) {
+            result.totalTasks = parseInt(totalMatch[1], 10);
+        }
+        const titleMatch = line.match(/^#\s+Implementation Plan:\s*(.+)/);
+        if (titleMatch) {
+            result.name = titleMatch[1].trim();
+        }
+    }
+    // Split into task sections by H2
+    const taskRegex = /^##\s+Task\s+(\d+):\s*(.+)/;
+    let currentTask = null;
+    const taskLines = [];
+    for (const line of lines) {
+        const taskMatch = line.match(taskRegex);
+        if (taskMatch) {
+            if (currentTask) {
+                currentTask.raw = taskLines.join('\n').trim();
+                parseTaskFields(currentTask, taskLines);
+                result.tasks.push(currentTask);
+            }
+            currentTask = {
+                number: parseInt(taskMatch[1], 10),
+                title: taskMatch[2].trim(),
+                files: [],
+                description: '',
+                dependsOn: 'None',
+                complexity: 'Medium',
+                acceptance: '',
+                raw: '',
+            };
+            taskLines.length = 0;
+        }
+        else if (currentTask) {
+            taskLines.push(line);
+        }
+    }
+    // Flush last task
+    if (currentTask) {
+        currentTask.raw = taskLines.join('\n').trim();
+        parseTaskFields(currentTask, taskLines);
+        result.tasks.push(currentTask);
+    }
+    if (result.totalTasks === 0) {
+        result.totalTasks = result.tasks.length;
+    }
+    return result;
+}
+function parseTaskFields(task, lines) {
+    let currentField = '';
+    const fieldLines = [];
+    for (const line of lines) {
+        const fieldMatch = line.match(/^-\s+\*\*(\w[\w\s]*)\*\*:\s*(.*)/);
+        if (fieldMatch) {
+            flushField(task, currentField, fieldLines);
+            currentField = fieldMatch[1].trim();
+            fieldLines.length = 0;
+            const value = fieldMatch[2].trim();
+            if (value)
+                fieldLines.push(value);
+        }
+        else if (currentField && line.match(/^\s+-\s+/)) {
+            // Sub-list items (like file paths)
+            fieldLines.push(line.replace(/^\s+-\s+/, '').trim());
+        }
+        else if (currentField && line.trim()) {
+            fieldLines.push(line.trim());
+        }
+    }
+    flushField(task, currentField, fieldLines);
+}
+function flushField(task, field, lines) {
+    if (!field)
+        return;
+    const value = lines.join('\n').trim();
+    switch (field.toLowerCase()) {
+        case 'files':
+            task.files = lines.map((l) => l.replace(/`/g, '').replace(/\s*\(.*\)$/, '').trim());
+            break;
+        case 'description':
+            task.description = value;
+            break;
+        case 'depends on':
+            task.dependsOn = value || 'None';
+            break;
+        case 'complexity':
+            task.complexity = value;
+            break;
+        case 'acceptance':
+            task.acceptance = value;
+            break;
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/src/parsers/plan.js.map

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

package/dist/src/parsers/spec.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedSpec {
+    title: string;
+    source?: string;
+    sections: Record<string, string>;
+    raw: string;
+}
+/**
+ * Parse a spec markdown file into structured sections.
+ */
+export declare function parseSpec(content: string): ParsedSpec;

package/dist/src/parsers/spec.js

@@ -0,0 +1,46 @@
+/**
+ * Parse a spec markdown file into structured sections.
+ */
+export function parseSpec(content) {
+    const lines = content.split('\n');
+    const result = {
+        title: '',
+        sections: {},
+        raw: content,
+    };
+    let currentSection = '';
+    const sectionLines = [];
+    for (const line of lines) {
+        // Extract title from first H1
+        const h1Match = line.match(/^#\s+(?:Feature:\s*)?(.+)/);
+        if (h1Match && !result.title) {
+            result.title = h1Match[1].trim();
+            continue;
+        }
+        // Extract source from blockquote
+        const sourceMatch = line.match(/^>\s*source:\s*(.+)/);
+        if (sourceMatch) {
+            result.source = sourceMatch[1].trim();
+            continue;
+        }
+        // Detect H2 sections
+        const h2Match = line.match(/^##\s+(.+)/);
+        if (h2Match) {
+            if (currentSection && sectionLines.length > 0) {
+                result.sections[currentSection] = sectionLines.join('\n').trim();
+            }
+            currentSection = h2Match[1].trim();
+            sectionLines.length = 0;
+            continue;
+        }
+        if (currentSection) {
+            sectionLines.push(line);
+        }
+    }
+    // Flush last section
+    if (currentSection && sectionLines.length > 0) {
+        result.sections[currentSection] = sectionLines.join('\n').trim();
+    }
+    return result;
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/parsers/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../src/parsers/spec.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAe;QACzB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,GAAG,EAAE,OAAO;KACb,CAAC;IAEF,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8BAA8B;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACtD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,qBAAqB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,cAAc,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACnE,CAAC;YACD,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,cAAc,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/state/manager.d.ts

@@ -0,0 +1,24 @@
+import { type WorkflowState, type FeatureState, type ProjectConfig } from './types.js';
+export declare class StateManager {
+    private cwd;
+    private workflowDir;
+    constructor(cwd?: string);
+    get statePath(): string;
+    get configPath(): string;
+    workflowExists(): boolean;
+    ensureWorkflow(): void;
+    readState(): WorkflowState;
+    writeState(state: WorkflowState): void;
+    getFeature(name: string): FeatureState | undefined;
+    upsertFeature(feature: FeatureState): void;
+    checkPhaseGuard(command: string, featureName: string): void;
+    readConfig(): ProjectConfig;
+    specsDir(): string;
+    plansDir(): string;
+    reviewsDir(): string;
+    promptsDir(): string;
+    templatesDir(): string;
+    specPath(name: string): string;
+    planPath(name: string): string;
+    reviewPath(name: string, taskN: number): string;
+}

package/dist/src/state/manager.js

@@ -0,0 +1,103 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { PHASE_GUARDS, } from './types.js';
+const WORKFLOW_DIR = '.workflow';
+const STATE_FILE = 'state.yaml';
+const CONFIG_FILE = 'config.yaml';
+export class StateManager {
+    cwd;
+    workflowDir;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+        this.workflowDir = path.join(cwd, WORKFLOW_DIR);
+    }
+    get statePath() {
+        return path.join(this.workflowDir, STATE_FILE);
+    }
+    get configPath() {
+        return path.join(this.workflowDir, CONFIG_FILE);
+    }
+    workflowExists() {
+        return fs.existsSync(this.workflowDir);
+    }
+    ensureWorkflow() {
+        if (!this.workflowExists()) {
+            throw new Error('Workflow not initialized. Run `pxs init` first.');
+        }
+    }
+    readState() {
+        if (!fs.existsSync(this.statePath)) {
+            return { features: [] };
+        }
+        const content = fs.readFileSync(this.statePath, 'utf-8');
+        const data = yaml.load(content);
+        return data ?? { features: [] };
+    }
+    writeState(state) {
+        this.ensureWorkflow();
+        const content = yaml.dump(state, { lineWidth: -1, noRefs: true });
+        fs.writeFileSync(this.statePath, content, 'utf-8');
+    }
+    getFeature(name) {
+        const state = this.readState();
+        return state.features.find((f) => f.feature === name);
+    }
+    upsertFeature(feature) {
+        const state = this.readState();
+        const idx = state.features.findIndex((f) => f.feature === feature.feature);
+        if (idx >= 0) {
+            state.features[idx] = feature;
+        }
+        else {
+            state.features.push(feature);
+        }
+        this.writeState(state);
+    }
+    checkPhaseGuard(command, featureName) {
+        const allowedPhases = PHASE_GUARDS[command];
+        if (!allowedPhases || allowedPhases.length === 0)
+            return; // any phase allowed
+        const feature = this.getFeature(featureName);
+        if (!feature) {
+            throw new Error(`Feature "${featureName}" not found in state. Run \`pxs new ${featureName}\` first.`);
+        }
+        if (!allowedPhases.includes(feature.phase)) {
+            throw new Error(`Command "pxs ${command}" cannot run in phase "${feature.phase}". ` +
+                `Allowed phases: ${allowedPhases.join(', ')}`);
+        }
+    }
+    readConfig() {
+        if (!fs.existsSync(this.configPath)) {
+            throw new Error('Config not found. Run `pxs init` first.');
+        }
+        const content = fs.readFileSync(this.configPath, 'utf-8');
+        return yaml.load(content);
+    }
+    // Helper paths
+    specsDir() {
+        return path.join(this.workflowDir, 'specs');
+    }
+    plansDir() {
+        return path.join(this.workflowDir, 'plans');
+    }
+    reviewsDir() {
+        return path.join(this.workflowDir, 'reviews');
+    }
+    promptsDir() {
+        return path.join(this.workflowDir, 'prompts');
+    }
+    templatesDir() {
+        return path.join(this.workflowDir, 'templates');
+    }
+    specPath(name) {
+        return path.join(this.specsDir(), `${name}.md`);
+    }
+    planPath(name) {
+        return path.join(this.plansDir(), `${name}.md`);
+    }
+    reviewPath(name, taskN) {
+        return path.join(this.reviewsDir(), `${name}-task-${taskN}.md`);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/state/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/state/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAKL,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,MAAM,OAAO,YAAY;IAGH;IAFZ,WAAW,CAAS;IAE5B,YAAoB,MAAc,OAAO,CAAC,GAAG,EAAE;QAA3B,QAAG,GAAH,GAAG,CAAwB;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAyB,CAAC;QACxD,OAAO,IAAI,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,aAAa,CAAC,OAAqB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3E,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,eAAe,CAAC,OAAe,EAAE,WAAmB;QAClD,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,oBAAoB;QAE9E,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,uCAAuC,WAAW,WAAW,CAAC,CAAC;QACxG,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,gBAAgB,OAAO,0BAA0B,OAAO,CAAC,KAAK,KAAK;gBACnE,mBAAmB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,CAAC;IAC7C,CAAC;IAED,eAAe;IACf,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,KAAa;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,IAAI,SAAS,KAAK,KAAK,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/src/state/types.d.ts

@@ -0,0 +1,47 @@
+export type Phase = 'spec_created' | 'clarifying' | 'spec_approved' | 'plan_pending_approval' | 'ready_to_implement' | 'implementing' | 'completed' | 'merged';
+export type TaskStatus = 'pending' | 'in_progress' | 'review_pending' | 'complete' | 'skipped';
+export type FeatureType = 'feat' | 'fix' | 'refactor' | 'docs' | 'chore';
+export type TestStrategy = 'tdd' | 'after' | 'none';
+export type TestType = 'unit' | 'intg' | 'both';
+export interface TaskState {
+    name: string;
+    status: TaskStatus;
+}
+export interface SessionInfo {
+    backend: string;
+    id: string;
+}
+export interface FeatureState {
+    feature: string;
+    type: FeatureType;
+    branch: string;
+    phase: Phase;
+    total_tasks: number;
+    current_task: number;
+    session?: SessionInfo;
+    tasks: TaskState[];
+}
+export interface WorkflowState {
+    features: FeatureState[];
+}
+export interface ProjectConfig {
+    project: {
+        name: string;
+        language: string;
+        framework: string;
+        architecture: string;
+        lang_framework: string;
+    };
+    git: {
+        convention: string;
+    };
+    backend: {
+        default: string;
+    };
+    test: {
+        strategy: TestStrategy;
+        type: TestType;
+    };
+}
+export declare const PHASE_GUARDS: Record<string, Phase[]>;
+export declare const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;

package/dist/src/state/types.js

@@ -0,0 +1,21 @@
+// Phase guard: which phases each command is allowed in
+export const PHASE_GUARDS = {
+    new: [], // any phase (creates new feature)
+    refine: ['spec_created', 'clarifying'],
+    clarify: ['spec_created', 'spec_approved', 'plan_pending_approval'],
+    implement: ['ready_to_implement', 'implementing'],
+    review: ['implementing', 'completed'],
+    status: [], // any phase
+    mcp: [], // any phase
+    agent: [], // any phase
+    skill: [], // any phase
+};
+// Valid task status transitions
+export const TASK_TRANSITIONS = {
+    pending: ['in_progress', 'skipped'],
+    in_progress: ['review_pending'],
+    review_pending: ['complete', 'in_progress'], // in_progress = request-change
+    complete: [],
+    skipped: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/src/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/state/types.ts"],"names":[],"mappings":"AA8DA,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,GAAG,EAAE,EAAE,EAAE,kCAAkC;IAC3C,MAAM,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,OAAO,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,uBAAuB,CAAC;IACnE,SAAS,EAAE,CAAC,oBAAoB,EAAE,cAAc,CAAC;IACjD,MAAM,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,MAAM,EAAE,EAAE,EAAE,YAAY;IACxB,GAAG,EAAE,EAAE,EAAE,YAAY;IACrB,KAAK,EAAE,EAAE,EAAE,YAAY;IACvB,KAAK,EAAE,EAAE,EAAE,YAAY;CACxB,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;IACnC,WAAW,EAAE,CAAC,gBAAgB,CAAC;IAC/B,cAAc,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,+BAA+B;IAC5E,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;CACZ,CAAC"}

package/dist/src/utils/display.d.ts

@@ -0,0 +1,7 @@
+export declare function heading(text: string): void;
+export declare function success(text: string): void;
+export declare function error(text: string): void;
+export declare function warn(text: string): void;
+export declare function info(text: string): void;
+export declare function taskIcon(status: string): string;
+export declare function table(headers: string[], rows: string[][]): void;

package/dist/src/utils/display.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+export function heading(text) {
+    console.log(chalk.bold.cyan(`\n━━━ ${text} ━━━\n`));
+}
+export function success(text) {
+    console.log(chalk.green(`  ✓ ${text}`));
+}
+export function error(text) {
+    console.log(chalk.red(`  ✗ ${text}`));
+}
+export function warn(text) {
+    console.log(chalk.yellow(`  ⚠ ${text}`));
+}
+export function info(text) {
+    console.log(chalk.gray(`  ℹ ${text}`));
+}
+export function taskIcon(status) {
+    switch (status) {
+        case 'complete': return '✅';
+        case 'in_progress': return '⏳';
+        case 'skipped': return '⏭️';
+        case 'review_pending': return '🔍';
+        case 'pending':
+        default: return '⬜';
+    }
+}
+export function table(headers, rows) {
+    // Calculate column widths
+    const widths = headers.map((h, i) => {
+        const colValues = [h, ...rows.map((r) => r[i] ?? '')];
+        return Math.max(...colValues.map((v) => v.length));
+    });
+    // Print header
+    const headerLine = headers.map((h, i) => h.padEnd(widths[i])).join('  ');
+    console.log(chalk.bold(headerLine));
+    // Print rows
+    for (const row of rows) {
+        const line = row.map((cell, i) => (cell ?? '').padEnd(widths[i])).join('  ');
+        console.log(line);
+    }
+}
+//# sourceMappingURL=display.js.map

package/dist/src/utils/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../src/utils/display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC;QAC5B,KAAK,aAAa,CAAC,CAAC,OAAO,GAAG,CAAC;QAC/B,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC;QAC5B,KAAK,gBAAgB,CAAC,CAAC,OAAO,IAAI,CAAC;QACnC,KAAK,SAAS,CAAC;QACf,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAiB,EAAE,IAAgB;IACvD,0BAA0B;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpC,aAAa;IACb,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/src/utils/prompt.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Load a prompt template from .workflow/prompts/<name>.md
+ */
+export declare function loadPrompt(name: string, cwd?: string): string;
+/**
+ * Substitute template variables in a prompt string.
+ * Variables use {varName} syntax.
+ */
+export declare function renderPrompt(template: string, vars: Record<string, string>): string;
+/**
+ * Build the agent/skill instruction block for prompt injection.
+ */
+export declare function buildAgentSkillBlock(agents: string[], skills: string[]): string;
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+/**
+ * Load architecture constraints from .workflow/architecture.md if it exists.
+ */
+export declare function loadArchitectureConstraint(cwd?: string): string;
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+export declare function assemblePrompt(opts: {
+    templateName: string;
+    vars: Record<string, string>;
+    agents?: string[];
+    skills?: string[];
+    extraText?: string;
+    cwd?: string;
+}): string;

package/dist/src/utils/prompt.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const WORKFLOW_DIR = '.workflow';
+/**
+ * Load a prompt template from .workflow/prompts/<name>.md
+ */
+export function loadPrompt(name, cwd = process.cwd()) {
+    const promptPath = path.join(cwd, WORKFLOW_DIR, 'prompts', `${name}.md`);
+    if (!fs.existsSync(promptPath)) {
+        throw new Error(`Prompt template "${name}" not found at ${promptPath}`);
+    }
+    return fs.readFileSync(promptPath, 'utf-8');
+}
+/**
+ * Substitute template variables in a prompt string.
+ * Variables use {varName} syntax.
+ */
+export function renderPrompt(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{${key}}`, value);
+    }
+    return result;
+}
+/**
+ * Build the agent/skill instruction block for prompt injection.
+ */
+export function buildAgentSkillBlock(agents, skills) {
+    const parts = [];
+    if (agents.length > 0) {
+        parts.push(`\n## Agent Instructions\nInvolve the following agents in analysis: ${agents.map(a => `@${a}`).join(', ')}`);
+    }
+    if (skills.length > 0) {
+        parts.push(`\n## Skill/MCP Instructions\nUse the following skills/MCPs to assist: ${skills.map(s => `/${s}`).join(', ')}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+/**
+ * Load architecture constraints from .workflow/architecture.md if it exists.
+ */
+export function loadArchitectureConstraint(cwd = process.cwd()) {
+    const archPath = path.join(cwd, WORKFLOW_DIR, 'architecture.md');
+    if (!fs.existsSync(archPath))
+        return '';
+    const content = fs.readFileSync(archPath, 'utf-8');
+    return `\n## Architecture Constraint
+This project follows the architecture specification below. All implementations must comply:
+${content}
+
+<HARD-GATE>
+- New files must be placed in the correct directory as defined by the architecture
+- Dependency direction must not be violated (e.g., domain must not reference infrastructure)
+- Follow the architecture's naming conventions and file naming rules
+- If requirements cross layers, use Port/Adapter or the corresponding architectural pattern
+- NestJS projects: new features must create independent Modules; do not stuff logic into unrelated Modules
+</HARD-GATE>`;
+}
+/**
+ * Assemble a full prompt from template name + variables + agents/skills + extra text.
+ */
+export function assemblePrompt(opts) {
+    const template = loadPrompt(opts.templateName, opts.cwd);
+    let prompt = renderPrompt(template, opts.vars);
+    // Auto-append architecture constraints when architecture.md exists
+    const archConstraint = loadArchitectureConstraint(opts.cwd);
+    if (archConstraint) {
+        prompt += archConstraint;
+    }
+    const agentSkillBlock = buildAgentSkillBlock(opts.agents ?? [], opts.skills ?? []);
+    if (agentSkillBlock) {
+        prompt += '\n' + agentSkillBlock;
+    }
+    if (opts.extraText) {
+        prompt += `\n\n## Additional Instructions\n${opts.extraText}`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,kBAAkB,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAA4B;IACzE,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgB,EAAE,MAAgB;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,sEAAsE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1H,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,yEAAyE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7H,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO;;EAEP,OAAO;;;;;;;;aAQI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAO9B;IACC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/C,mEAAmE;IACnE,MAAM,cAAc,GAAG,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,IAAI,cAAc,CAAC;IAC3B,CAAC;IAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACnF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,IAAI,IAAI,GAAG,eAAe,CAAC;IACnC,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,mCAAmC,IAAI,CAAC,SAAS,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pixel613/spec",
+  "version": "1.0.1",
+  "description": "Lightweight spec-driven development CLI",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "spec-driven",
+    "claude-code",
+    "ai",
+    "cli",
+    "workflow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pixel613/spec-cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "pxs": "./dist/bin/pxs.js"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "dev": "tsx watch bin/pxs.ts",
+    "test": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "inquirer": "^12.6.0",
+    "js-yaml": "^4.1.0"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}

package/templates/agents-md-snippet.md

@@ -0,0 +1,20 @@
+## SF Spec-Driven Workflow
+
+This project uses sf for spec-driven development.
+
+### Workflow State
+- Read `.workflow/state.yaml` for current progress
+- Read `.workflow/plans/<feature>.md` for implementation plan
+
+### Rules
+- Implement tasks in the order specified in the plan; do not skip
+- After completing each task, run `git add -A && git commit`
+- Commit messages follow conventional commits or the project's custom convention
+- Do not implement beyond task spec scope
+- After each task completion, wait for user confirmation before continuing
+
+### Prompt Templates
+- Implementation guide: `.workflow/prompts/implement.md`
+- TDD guide: `.workflow/prompts/implement-tdd.md`
+- Review guide: `.workflow/prompts/review.md`
+- Test guide: `.workflow/prompts/test.md`