@pixel613/spec 1.0.1

package/dist/src/commands/implement.js

@@ -0,0 +1,244 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import inquirer from 'inquirer';
+import { StateManager } from '../state/manager.js';
+import { createBackend } from '../backends/factory.js';
+import { parsePlan } from '../parsers/plan.js';
+import { assemblePrompt } from '../utils/prompt.js';
+import { gitBranch, gitCommit, gitDiff, gitDiffBranch, gitCheckout, gitMerge } from '../git/operations.js';
+import * as display from '../utils/display.js';
+export async function implementCommand(name, args, options) {
+    const state = new StateManager();
+    state.ensureWorkflow();
+    state.checkPhaseGuard('implement', name);
+    const feature = state.getFeature(name);
+    const config = state.readConfig();
+    const backendName = options.backend ?? config.backend.default;
+    const backend = createBackend(backendName);
+    if (!(await backend.isAvailable())) {
+        display.error(`Backend "${backendName}" not available.`);
+        return;
+    }
+    // Read plan
+    const planPath = state.planPath(name);
+    if (!fs.existsSync(planPath)) {
+        display.error(`Plan not found. Run \`pxs refine ${name}\` first.`);
+        return;
+    }
+    const planContent = fs.readFileSync(planPath, 'utf-8');
+    const plan = parsePlan(planContent);
+    // Pre-flight: create branch if first run
+    if (feature.phase === 'ready_to_implement') {
+        const branchName = feature.branch || `${feature.type}/${name}`;
+        display.info(`Creating branch: ${branchName}`);
+        try {
+            gitBranch(branchName);
+        }
+        catch {
+            display.warn(`Branch ${branchName} may already exist, checking out...`);
+            gitCheckout(branchName);
+        }
+        feature.phase = 'implementing';
+        feature.branch = branchName;
+        state.upsertFeature(feature);
+    }
+    // Determine test strategy
+    const testConfig = parseTestOptions(options.test);
+    let sessionId = feature.session?.id ?? '';
+    // Execute tasks
+    for (let i = 0; i < feature.tasks.length; i++) {
+        const task = feature.tasks[i];
+        if (task.status === 'complete' || task.status === 'skipped')
+            continue;
+        const taskSpec = plan.tasks[i];
+        if (!taskSpec)
+            continue;
+        display.heading(`Task ${i + 1}: ${task.name}`);
+        // Update status
+        task.status = 'in_progress';
+        feature.current_task = i + 1;
+        state.upsertFeature(feature);
+        // Build prompt
+        const templateName = testConfig.tdd ? 'implement-tdd' : 'implement';
+        const previousDiff = i > 0 ? getDiffSummary() : '';
+        const prompt = assemblePrompt({
+            templateName,
+            vars: {
+                task_content: taskSpec.raw,
+                previous_diff: previousDiff,
+            },
+            agents: args.agents,
+            skills: args.skills,
+            extraText: args.text,
+        });
+        // Execute
+        const result = sessionId
+            ? await backend.resume(sessionId, prompt)
+            : await backend.execute(prompt);
+        sessionId = result.sessionId;
+        feature.session = { backend: backendName, id: sessionId };
+        // Commit implementation
+        try {
+            gitCommit(`${feature.type}(${name}): task-${i + 1} ${task.name}`);
+        }
+        catch {
+            display.warn('Nothing to commit or commit failed.');
+        }
+        // Post-hoc tests (if not TDD)
+        if (testConfig.postHoc) {
+            display.info('Generating tests...');
+            const diff = getDiffSummary();
+            const testType = testConfig.intg ? 'integration' : 'unit';
+            const testPrompt = assemblePrompt({
+                templateName: 'test',
+                vars: {
+                    test_type: testType,
+                    git_diff: diff,
+                    task_content: taskSpec.raw,
+                },
+            });
+            await backend.resume(sessionId, testPrompt);
+            try {
+                gitCommit(`test(${name}): task-${i + 1} ${task.name}`);
+            }
+            catch {
+                display.warn('No test changes to commit.');
+            }
+        }
+        // AI Review
+        display.info('Running AI review...');
+        const diff = getDiffSummary();
+        const reviewPrompt = assemblePrompt({
+            templateName: 'review',
+            vars: {
+                git_diff: diff,
+                task_content: taskSpec.raw,
+            },
+            agents: args.agents,
+            skills: args.skills,
+        });
+        const reviewResult = await backend.resume(sessionId, reviewPrompt);
+        sessionId = reviewResult.sessionId;
+        // Save review
+        fs.mkdirSync(state.reviewsDir(), { recursive: true });
+        fs.writeFileSync(state.reviewPath(name, i + 1), reviewResult.output, 'utf-8');
+        task.status = 'review_pending';
+        state.upsertFeature(feature);
+        // Present to user
+        console.log('\n' + reviewResult.output + '\n');
+        const { choice } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'choice',
+                message: `Task ${i + 1} review:`,
+                choices: ['approve', 'request-change', 'add-test', 'skip'],
+            },
+        ]);
+        switch (choice) {
+            case 'approve':
+                task.status = 'complete';
+                state.upsertFeature(feature);
+                display.success(`Task ${i + 1} approved.`);
+                break;
+            case 'skip':
+                task.status = 'skipped';
+                state.upsertFeature(feature);
+                display.info(`Task ${i + 1} skipped.`);
+                break;
+            case 'request-change':
+                task.status = 'in_progress';
+                state.upsertFeature(feature);
+                display.info('Re-run `pxs implement` to retry this task.');
+                return;
+            case 'add-test':
+                display.info('Generating additional tests...');
+                task.status = 'complete';
+                state.upsertFeature(feature);
+                break;
+        }
+    }
+    // All tasks complete
+    const allDone = feature.tasks.every((t) => t.status === 'complete' || t.status === 'skipped');
+    if (allDone) {
+        feature.phase = 'completed';
+        state.upsertFeature(feature);
+        display.heading('All Tasks Complete');
+        for (const t of feature.tasks) {
+            console.log(`  ${display.taskIcon(t.status)} ${t.name}`);
+        }
+        // Final branch code review
+        if (!options.skipReview) {
+            display.info('Running final branch code review...');
+            try {
+                const branchDiff = gitDiffBranch('main');
+                const specContent = fs.existsSync(state.specPath(name))
+                    ? fs.readFileSync(state.specPath(name), 'utf-8')
+                    : '(spec not found)';
+                const finalReviewPrompt = assemblePrompt({
+                    templateName: 'final-review',
+                    vars: {
+                        branch_diff: branchDiff,
+                        spec_content: specContent,
+                        plan_content: planContent,
+                    },
+                    agents: args.agents,
+                    skills: args.skills,
+                    extraText: args.text,
+                });
+                const finalReviewResult = await backend.resume(sessionId, finalReviewPrompt);
+                sessionId = finalReviewResult.sessionId;
+                // Save final review
+                fs.mkdirSync(state.reviewsDir(), { recursive: true });
+                const finalReviewPath = path.join(state.reviewsDir(), `${name}-final.md`);
+                fs.writeFileSync(finalReviewPath, finalReviewResult.output, 'utf-8');
+                display.heading('Final Code Review');
+                console.log('\n' + finalReviewResult.output + '\n');
+            }
+            catch (err) {
+                display.warn(`Final review failed: ${err instanceof Error ? err.message : err}`);
+            }
+        }
+        const { merge } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'merge',
+                message: 'What would you like to do?',
+                choices: ['merge', 'squash-merge', 'keep-branch'],
+            },
+        ]);
+        if (merge === 'merge' || merge === 'squash-merge') {
+            const originalBranch = 'main'; // TODO: detect original branch
+            gitCheckout(originalBranch);
+            gitMerge(feature.branch, merge === 'squash-merge');
+            feature.phase = 'merged';
+            state.upsertFeature(feature);
+            display.success(`Merged ${feature.branch} into ${originalBranch}.`);
+        }
+        else {
+            display.info(`Branch ${feature.branch} kept. Merge manually when ready.`);
+        }
+    }
+}
+function getDiffSummary() {
+    try {
+        return gitDiff('HEAD~1');
+    }
+    catch {
+        return '(no previous diff available)';
+    }
+}
+function parseTestOptions(test) {
+    if (test === undefined || test === false) {
+        return { tdd: false, intg: false, postHoc: false };
+    }
+    if (test === true || (Array.isArray(test) && test.length === 0)) {
+        return { tdd: false, intg: false, postHoc: true };
+    }
+    const arr = test;
+    return {
+        tdd: arr.includes('tdd'),
+        intg: arr.includes('intg'),
+        postHoc: !arr.includes('tdd'),
+    };
+}
+//# sourceMappingURL=implement.js.map

package/dist/src/commands/implement.js.map

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

package/dist/src/commands/init.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveLangFramework(lang: string): string;
+export declare function initCommand(options: {
+    force?: boolean;
+    arch?: string;
+    lang?: string;
+}): Promise<void>;

package/dist/src/commands/init.js

@@ -0,0 +1,177 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { detectProject } from '../discovery/project.js';
+import * as display from '../utils/display.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Walk up from __dirname to find the project root containing templates/
+function findTemplatesDir() {
+    let dir = __dirname;
+    for (let i = 0; i < 5; i++) {
+        const candidate = path.join(dir, 'templates');
+        if (fs.existsSync(candidate))
+            return candidate;
+        dir = path.dirname(dir);
+    }
+    // Fallback: 3 levels up from dist/src/commands/ to package root
+    return path.resolve(__dirname, '..', '..', '..', 'templates');
+}
+const TEMPLATES_DIR = findTemplatesDir();
+// Resolve shorthand --lang values to full lang_framework IDs
+const LANG_SHORTHANDS = {
+    go: 'go-std',
+    typescript: 'typescript-express',
+    ts: 'typescript-express',
+    nestjs: 'typescript-nestjs',
+    express: 'typescript-express',
+    csharp: 'csharp-aspnet',
+    'c#': 'csharp-aspnet',
+    dotnet: 'csharp-aspnet',
+    python: 'python-fastapi',
+    fastapi: 'python-fastapi',
+    django: 'python-django',
+    gin: 'go-gin',
+    chi: 'go-chi',
+};
+export function resolveLangFramework(lang) {
+    return LANG_SHORTHANDS[lang.toLowerCase()] ?? lang;
+}
+export async function initCommand(options) {
+    const cwd = process.cwd();
+    const workflowDir = path.join(cwd, '.workflow');
+    if (fs.existsSync(workflowDir) && !options.force) {
+        display.error('.workflow/ already exists. Use --force to overwrite.');
+        return;
+    }
+    display.heading('Initializing pxs workflow');
+    // Detect project
+    const project = detectProject(cwd);
+    display.info(`Detected: ${project.language || 'unknown'} / ${project.framework || 'unknown'}`);
+    // Create .workflow directories
+    const dirs = [
+        '.workflow/prompts',
+        '.workflow/templates',
+        '.workflow/specs',
+        '.workflow/plans',
+        '.workflow/reviews',
+        '.claude/commands',
+    ];
+    for (const dir of dirs) {
+        fs.mkdirSync(path.join(cwd, dir), { recursive: true });
+    }
+    // Copy workflow templates
+    copyDir(path.join(TEMPLATES_DIR, 'workflow'), workflowDir);
+    // Resolve architecture and lang_framework
+    const architecture = options.arch ?? 'none';
+    const langFramework = options.lang
+        ? resolveLangFramework(options.lang)
+        : project.lang_framework;
+    // Handle --arch: copy architecture template to .workflow/architecture.md
+    if (options.arch) {
+        const archMdPath = path.join(workflowDir, 'architecture.md');
+        if (options.arch === 'custom') {
+            // For custom, the next positional arg would be a path — but Commander captures it as the arch value.
+            // Actually, `--arch custom` means the user provides a separate file. We check process.argv for a path after 'custom'.
+            const customPath = findCustomArchPath();
+            if (customPath && fs.existsSync(customPath)) {
+                fs.copyFileSync(customPath, archMdPath);
+                display.success(`Copied custom architecture from ${customPath}`);
+            }
+            else {
+                display.error('Custom architecture file not found. Usage: pxs init --arch custom <path>');
+            }
+        }
+        else {
+            // Look up template: templates/architectures/<arch>/<lang_framework>.md
+            const templatePath = path.join(TEMPLATES_DIR, 'architectures', options.arch, `${langFramework}.md`);
+            if (fs.existsSync(templatePath)) {
+                fs.copyFileSync(templatePath, archMdPath);
+                display.success(`Architecture: ${options.arch} (${langFramework})`);
+            }
+            else {
+                display.error(`Architecture template not found: ${options.arch}/${langFramework}.md — skipping architecture.md`);
+                const archDir = path.join(TEMPLATES_DIR, 'architectures', options.arch);
+                if (fs.existsSync(archDir)) {
+                    const available = fs.readdirSync(archDir).filter(f => f.endsWith('.md')).map(f => f.replace('.md', ''));
+                    if (available.length > 0) {
+                        display.info(`Available: ${available.join(', ')}`);
+                    }
+                }
+            }
+        }
+    }
+    // Substitute project info in config.yaml
+    const configPath = path.join(workflowDir, 'config.yaml');
+    if (fs.existsSync(configPath)) {
+        let config = fs.readFileSync(configPath, 'utf-8');
+        config = config.replace(/name: ""/, `name: "${project.name}"`);
+        config = config.replace(/language: ""/, `language: "${project.language}"`);
+        config = config.replace(/framework: ""/, `framework: "${project.framework}"`);
+        config = config.replace(/architecture: none/, `architecture: ${architecture}`);
+        config = config.replace(/lang_framework: ""/, `lang_framework: "${langFramework}"`);
+        fs.writeFileSync(configPath, config, 'utf-8');
+    }
+    // Copy claude commands (rename sf.* to pxs.*)
+    const claudeCommandsDir = path.join(TEMPLATES_DIR, 'claude-commands');
+    const targetCommandsDir = path.join(cwd, '.claude', 'commands');
+    if (fs.existsSync(claudeCommandsDir)) {
+        const files = fs.readdirSync(claudeCommandsDir);
+        for (const file of files) {
+            const targetName = file.replace(/^sf\./, 'pxs.');
+            fs.copyFileSync(path.join(claudeCommandsDir, file), path.join(targetCommandsDir, targetName));
+        }
+    }
+    // Append to AGENTS.md
+    const agentsSnippetPath = path.join(TEMPLATES_DIR, 'agents-md-snippet.md');
+    if (fs.existsSync(agentsSnippetPath)) {
+        const snippet = fs.readFileSync(agentsSnippetPath, 'utf-8');
+        const agentsPath = path.join(cwd, 'AGENTS.md');
+        if (fs.existsSync(agentsPath)) {
+            const existing = fs.readFileSync(agentsPath, 'utf-8');
+            if (!existing.includes('SF Spec-Driven Workflow')) {
+                fs.appendFileSync(agentsPath, '\n\n' + snippet, 'utf-8');
+            }
+        }
+        else {
+            fs.writeFileSync(agentsPath, snippet, 'utf-8');
+        }
+    }
+    display.success('Created .workflow/ directory structure');
+    display.success('Created .claude/commands/pxs.*.md slash commands');
+    display.success('Created AGENTS.md');
+    display.info('Run `pxs new <name>` to create your first spec.');
+}
+/**
+ * Find the custom architecture file path from process.argv.
+ * When user runs: pxs init --arch custom ./my-arch.md
+ * Commander captures "custom" as --arch value, but the file path remains in argv.
+ */
+function findCustomArchPath() {
+    const argv = process.argv;
+    const archIdx = argv.findIndex((a) => a === '--arch');
+    // The path should be 2 positions after --arch (--arch custom <path>)
+    if (archIdx >= 0 && archIdx + 2 < argv.length) {
+        const candidate = argv[archIdx + 2];
+        if (candidate && !candidate.startsWith('-')) {
+            return path.resolve(candidate);
+        }
+    }
+    return undefined;
+}
+function copyDir(src, dest) {
+    if (!fs.existsSync(src))
+        return;
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

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

package/dist/src/commands/new.d.ts

@@ -0,0 +1,5 @@
+export declare function newCommand(name: string, options: {
+    desc?: string;
+    jira?: string[];
+    interactive?: boolean;
+}): Promise<void>;

package/dist/src/commands/new.js

@@ -0,0 +1,143 @@
+import fs from 'node:fs';
+import inquirer from 'inquirer';
+import { StateManager } from '../state/manager.js';
+import { createBackend } from '../backends/factory.js';
+import * as display from '../utils/display.js';
+export async function newCommand(name, options) {
+    const state = new StateManager();
+    state.ensureWorkflow();
+    const specPath = state.specPath(name);
+    // Check if spec already exists
+    if (fs.existsSync(specPath)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: `Spec "${name}" already exists. Overwrite?`,
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            display.info('Aborted.');
+            return;
+        }
+    }
+    // Ensure specs dir exists
+    fs.mkdirSync(state.specsDir(), { recursive: true });
+    if (options.jira && options.jira.length > 0) {
+        await createFromJira(name, options.jira, state);
+    }
+    else if (options.desc) {
+        await createFromDesc(name, options.desc, state);
+    }
+    else if (options.interactive) {
+        await createInteractive(name, state);
+    }
+    else {
+        createBlank(name, state);
+    }
+    // Update state
+    state.upsertFeature({
+        feature: name,
+        type: 'feat',
+        branch: '',
+        phase: 'spec_created',
+        total_tasks: 0,
+        current_task: 0,
+        tasks: [],
+    });
+    display.success(`Spec created: ${state.specPath(name)}`);
+    display.info(`Edit the spec, then run \`pxs refine ${name}\``);
+}
+function createBlank(name, state) {
+    const templatePath = state.templatesDir() + '/spec-template.md';
+    let template;
+    if (fs.existsSync(templatePath)) {
+        template = fs.readFileSync(templatePath, 'utf-8');
+        template = template.replace('<name>', name);
+    }
+    else {
+        template = `# Feature: ${name}
+
+## Context
+<!-- 2-3 sentences of project background -->
+
+## Requirements
+<!-- Numbered list with acceptance criteria -->
+
+## Constraints
+<!-- Technical limitations, compatibility requirements -->
+
+## Notes
+<!-- Additional notes -->
+`;
+    }
+    fs.writeFileSync(state.specPath(name), template, 'utf-8');
+}
+async function createFromDesc(name, desc, state) {
+    display.info('Generating spec from description...');
+    try {
+        const config = state.readConfig();
+        const backend = createBackend(config.backend.default);
+        if (!(await backend.isAvailable())) {
+            display.error(`Backend "${config.backend.default}" is not available. Install claude or codex.`);
+            createBlank(name, state);
+            display.warn('Created blank spec instead.');
+            return;
+        }
+        const prompt = `Create a detailed feature spec in markdown format for the following feature:
+
+Name: ${name}
+Description: ${desc}
+
+Output format:
+# Feature: ${name}
+
+## Context
+(2-3 sentences of background)
+
+## Requirements
+(Numbered list with acceptance criteria)
+
+## Constraints
+(Technical limitations)
+
+## Notes
+(Additional notes)`;
+        const result = await backend.execute(prompt);
+        fs.writeFileSync(state.specPath(name), result.output, 'utf-8');
+    }
+    catch (err) {
+        display.warn(`AI generation failed: ${err}. Creating blank spec.`);
+        createBlank(name, state);
+    }
+}
+async function createFromJira(name, tickets, state) {
+    display.error('Jira MCP integration requires an MCP connection. Please ensure Jira MCP is configured.');
+    display.info('Creating blank spec instead. Add Jira content manually.');
+    createBlank(name, state);
+}
+async function createInteractive(name, state) {
+    const answers = await inquirer.prompt([
+        { type: 'input', name: 'context', message: 'Project context (2-3 sentences):' },
+        { type: 'editor', name: 'requirements', message: 'Requirements (one per line):' },
+        { type: 'input', name: 'constraints', message: 'Constraints:' },
+        { type: 'input', name: 'notes', message: 'Additional notes:' },
+    ]);
+    const spec = `# Feature: ${name}
+
+## Context
+${answers.context}
+
+## Requirements
+${answers.requirements}
+
+## Constraints
+${answers.constraints}
+
+## Notes
+${answers.notes}
+`;
+    fs.writeFileSync(state.specPath(name), spec, 'utf-8');
+}
+//# sourceMappingURL=new.js.map

package/dist/src/commands/new.js.map

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

package/dist/src/commands/refine.d.ts

@@ -0,0 +1,8 @@
+export declare function refineCommand(name: string, args: {
+    agents: string[];
+    skills: string[];
+    text: string;
+}, options: {
+    skipClarify?: boolean;
+    clarify?: number;
+}): Promise<void>;