@fission-ai/openspec 0.23.0 → 1.0.1

package/dist/commands/artifact-workflow.js

@@ -1,915 +0,0 @@
-/**
- * Artifact Workflow CLI Commands (Experimental)
- *
- * This file contains all artifact workflow commands in isolation for easy removal.
- * Commands expose the ArtifactGraph and InstructionLoader APIs to users and agents.
- *
- * To remove this feature:
- * 1. Delete this file
- * 2. Remove the registerArtifactWorkflowCommands() call from src/cli/index.ts
- */
-import ora from 'ora';
-import chalk from 'chalk';
-import path from 'path';
-import * as fs from 'fs';
-import { loadChangeContext, formatChangeStatus, generateInstructions, listSchemas, listSchemasWithInfo, getSchemaDir, resolveSchema, ArtifactGraph, } from '../core/artifact-graph/index.js';
-import { createChange, validateChangeName } from '../utils/change-utils.js';
-import { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate } from '../core/templates/skill-templates.js';
-import { FileSystemUtils } from '../utils/file-system.js';
-import { serializeConfig } from '../core/config-prompts.js';
-const DEFAULT_SCHEMA = 'spec-driven';
-/**
- * Checks if color output is disabled via NO_COLOR env or --no-color flag.
- */
-function isColorDisabled() {
-    return process.env.NO_COLOR === '1' || process.env.NO_COLOR === 'true';
-}
-/**
- * Gets the color function based on status.
- */
-function getStatusColor(status) {
-    if (isColorDisabled()) {
-        return (text) => text;
-    }
-    switch (status) {
-        case 'done':
-            return chalk.green;
-        case 'ready':
-            return chalk.yellow;
-        case 'blocked':
-            return chalk.red;
-    }
-}
-/**
- * Gets the status indicator for an artifact.
- */
-function getStatusIndicator(status) {
-    const color = getStatusColor(status);
-    switch (status) {
-        case 'done':
-            return color('[x]');
-        case 'ready':
-            return color('[ ]');
-        case 'blocked':
-            return color('[-]');
-    }
-}
-/**
- * Validates that a change exists and returns available changes if not.
- * Checks directory existence directly to support scaffolded changes (without proposal.md).
- */
-async function validateChangeExists(changeName, projectRoot) {
-    const changesPath = path.join(projectRoot, 'openspec', 'changes');
-    // Get all change directories (not just those with proposal.md)
-    const getAvailableChanges = async () => {
-        try {
-            const entries = await fs.promises.readdir(changesPath, { withFileTypes: true });
-            return entries
-                .filter((e) => e.isDirectory() && e.name !== 'archive' && !e.name.startsWith('.'))
-                .map((e) => e.name);
-        }
-        catch {
-            return [];
-        }
-    };
-    if (!changeName) {
-        const available = await getAvailableChanges();
-        if (available.length === 0) {
-            throw new Error('No changes found. Create one with: openspec new change <name>');
-        }
-        throw new Error(`Missing required option --change. Available changes:\n  ${available.join('\n  ')}`);
-    }
-    // Validate change name format to prevent path traversal
-    const nameValidation = validateChangeName(changeName);
-    if (!nameValidation.valid) {
-        throw new Error(`Invalid change name '${changeName}': ${nameValidation.error}`);
-    }
-    // Check directory existence directly
-    const changePath = path.join(changesPath, changeName);
-    const exists = fs.existsSync(changePath) && fs.statSync(changePath).isDirectory();
-    if (!exists) {
-        const available = await getAvailableChanges();
-        if (available.length === 0) {
-            throw new Error(`Change '${changeName}' not found. No changes exist. Create one with: openspec new change <name>`);
-        }
-        throw new Error(`Change '${changeName}' not found. Available changes:\n  ${available.join('\n  ')}`);
-    }
-    return changeName;
-}
-/**
- * Validates that a schema exists and returns available schemas if not.
- *
- * @param schemaName - The schema name to validate
- * @param projectRoot - Optional project root for project-local schema resolution
- */
-function validateSchemaExists(schemaName, projectRoot) {
-    const schemaDir = getSchemaDir(schemaName, projectRoot);
-    if (!schemaDir) {
-        const availableSchemas = listSchemas(projectRoot);
-        throw new Error(`Schema '${schemaName}' not found. Available schemas:\n  ${availableSchemas.join('\n  ')}`);
-    }
-    return schemaName;
-}
-async function statusCommand(options) {
-    const spinner = ora('Loading change status...').start();
-    try {
-        const projectRoot = process.cwd();
-        const changeName = await validateChangeExists(options.change, projectRoot);
-        // Validate schema if explicitly provided
-        if (options.schema) {
-            validateSchemaExists(options.schema, projectRoot);
-        }
-        // loadChangeContext will auto-detect schema from metadata if not provided
-        const context = loadChangeContext(projectRoot, changeName, options.schema);
-        const status = formatChangeStatus(context);
-        spinner.stop();
-        if (options.json) {
-            console.log(JSON.stringify(status, null, 2));
-            return;
-        }
-        printStatusText(status);
-    }
-    catch (error) {
-        spinner.stop();
-        throw error;
-    }
-}
-function printStatusText(status) {
-    const doneCount = status.artifacts.filter((a) => a.status === 'done').length;
-    const total = status.artifacts.length;
-    console.log(`Change: ${status.changeName}`);
-    console.log(`Schema: ${status.schemaName}`);
-    console.log(`Progress: ${doneCount}/${total} artifacts complete`);
-    console.log();
-    for (const artifact of status.artifacts) {
-        const indicator = getStatusIndicator(artifact.status);
-        const color = getStatusColor(artifact.status);
-        let line = `${indicator} ${artifact.id}`;
-        if (artifact.status === 'blocked' && artifact.missingDeps && artifact.missingDeps.length > 0) {
-            line += color(` (blocked by: ${artifact.missingDeps.join(', ')})`);
-        }
-        console.log(line);
-    }
-    if (status.isComplete) {
-        console.log();
-        console.log(chalk.green('All artifacts complete!'));
-    }
-}
-async function instructionsCommand(artifactId, options) {
-    const spinner = ora('Generating instructions...').start();
-    try {
-        const projectRoot = process.cwd();
-        const changeName = await validateChangeExists(options.change, projectRoot);
-        // Validate schema if explicitly provided
-        if (options.schema) {
-            validateSchemaExists(options.schema, projectRoot);
-        }
-        // loadChangeContext will auto-detect schema from metadata if not provided
-        const context = loadChangeContext(projectRoot, changeName, options.schema);
-        if (!artifactId) {
-            spinner.stop();
-            const validIds = context.graph.getAllArtifacts().map((a) => a.id);
-            throw new Error(`Missing required argument <artifact>. Valid artifacts:\n  ${validIds.join('\n  ')}`);
-        }
-        const artifact = context.graph.getArtifact(artifactId);
-        if (!artifact) {
-            spinner.stop();
-            const validIds = context.graph.getAllArtifacts().map((a) => a.id);
-            throw new Error(`Artifact '${artifactId}' not found in schema '${context.schemaName}'. Valid artifacts:\n  ${validIds.join('\n  ')}`);
-        }
-        const instructions = generateInstructions(context, artifactId, projectRoot);
-        const isBlocked = instructions.dependencies.some((d) => !d.done);
-        spinner.stop();
-        if (options.json) {
-            console.log(JSON.stringify(instructions, null, 2));
-            return;
-        }
-        printInstructionsText(instructions, isBlocked);
-    }
-    catch (error) {
-        spinner.stop();
-        throw error;
-    }
-}
-function printInstructionsText(instructions, isBlocked) {
-    const { artifactId, changeName, schemaName, changeDir, outputPath, description, instruction, template, dependencies, unlocks, } = instructions;
-    // Opening tag
-    console.log(`<artifact id="${artifactId}" change="${changeName}" schema="${schemaName}">`);
-    console.log();
-    // Warning for blocked artifacts
-    if (isBlocked) {
-        const missing = dependencies.filter((d) => !d.done).map((d) => d.id);
-        console.log('<warning>');
-        console.log('This artifact has unmet dependencies. Complete them first or proceed with caution.');
-        console.log(`Missing: ${missing.join(', ')}`);
-        console.log('</warning>');
-        console.log();
-    }
-    // Task directive
-    console.log('<task>');
-    console.log(`Create the ${artifactId} artifact for change "${changeName}".`);
-    console.log(description);
-    console.log('</task>');
-    console.log();
-    // Context (dependencies)
-    if (dependencies.length > 0) {
-        console.log('<context>');
-        console.log('Read these files for context before creating this artifact:');
-        console.log();
-        for (const dep of dependencies) {
-            const status = dep.done ? 'done' : 'missing';
-            const fullPath = path.join(changeDir, dep.path);
-            console.log(`<dependency id="${dep.id}" status="${status}">`);
-            console.log(`  <path>${fullPath}</path>`);
-            console.log(`  <description>${dep.description}</description>`);
-            console.log('</dependency>');
-        }
-        console.log('</context>');
-        console.log();
-    }
-    // Output location
-    console.log('<output>');
-    console.log(`Write to: ${path.join(changeDir, outputPath)}`);
-    console.log('</output>');
-    console.log();
-    // Instruction (guidance)
-    if (instruction) {
-        console.log('<instruction>');
-        console.log(instruction.trim());
-        console.log('</instruction>');
-        console.log();
-    }
-    // Template
-    console.log('<template>');
-    console.log(template.trim());
-    console.log('</template>');
-    console.log();
-    // Success criteria placeholder
-    console.log('<success_criteria>');
-    console.log('<!-- To be defined in schema validation rules -->');
-    console.log('</success_criteria>');
-    console.log();
-    // Unlocks
-    if (unlocks.length > 0) {
-        console.log('<unlocks>');
-        console.log(`Completing this artifact enables: ${unlocks.join(', ')}`);
-        console.log('</unlocks>');
-        console.log();
-    }
-    // Closing tag
-    console.log('</artifact>');
-}
-/**
- * Parses tasks.md content and extracts task items with their completion status.
- */
-function parseTasksFile(content) {
-    const tasks = [];
-    const lines = content.split('\n');
-    let taskIndex = 0;
-    for (const line of lines) {
-        // Match checkbox patterns: - [ ] or - [x] or - [X]
-        const checkboxMatch = line.match(/^[-*]\s*\[([ xX])\]\s*(.+)$/);
-        if (checkboxMatch) {
-            taskIndex++;
-            const done = checkboxMatch[1].toLowerCase() === 'x';
-            const description = checkboxMatch[2].trim();
-            tasks.push({
-                id: `${taskIndex}`,
-                description,
-                done,
-            });
-        }
-    }
-    return tasks;
-}
-/**
- * Checks if an artifact output exists in the change directory.
- * Supports glob patterns (e.g., "specs/*.md") by verifying at least one matching file exists.
- */
-function artifactOutputExists(changeDir, generates) {
-    // Normalize the generates path to use platform-specific separators
-    const normalizedGenerates = generates.split('/').join(path.sep);
-    const fullPath = path.join(changeDir, normalizedGenerates);
-    // If it's a glob pattern (contains ** or *), check for matching files
-    if (generates.includes('*')) {
-        // Extract the directory part before the glob pattern
-        const parts = normalizedGenerates.split(path.sep);
-        const dirParts = [];
-        let patternPart = '';
-        for (const part of parts) {
-            if (part.includes('*')) {
-                patternPart = part;
-                break;
-            }
-            dirParts.push(part);
-        }
-        const dirPath = path.join(changeDir, ...dirParts);
-        // Check if directory exists
-        if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
-            return false;
-        }
-        // Extract expected extension from pattern (e.g., "*.md" -> ".md")
-        const extMatch = patternPart.match(/\*(\.[a-zA-Z0-9]+)$/);
-        const expectedExt = extMatch ? extMatch[1] : null;
-        // Recursively check for matching files
-        const hasMatchingFiles = (dir) => {
-            try {
-                const entries = fs.readdirSync(dir, { withFileTypes: true });
-                for (const entry of entries) {
-                    if (entry.isDirectory()) {
-                        // For ** patterns, recurse into subdirectories
-                        if (generates.includes('**') && hasMatchingFiles(path.join(dir, entry.name))) {
-                            return true;
-                        }
-                    }
-                    else if (entry.isFile()) {
-                        // Check if file matches expected extension (or any file if no extension specified)
-                        if (!expectedExt || entry.name.endsWith(expectedExt)) {
-                            return true;
-                        }
-                    }
-                }
-            }
-            catch {
-                return false;
-            }
-            return false;
-        };
-        return hasMatchingFiles(dirPath);
-    }
-    return fs.existsSync(fullPath);
-}
-/**
- * Generates apply instructions for implementing tasks from a change.
- * Schema-aware: reads apply phase configuration from schema to determine
- * required artifacts, tracking file, and instruction.
- */
-async function generateApplyInstructions(projectRoot, changeName, schemaName) {
-    // loadChangeContext will auto-detect schema from metadata if not provided
-    const context = loadChangeContext(projectRoot, changeName, schemaName);
-    const changeDir = path.join(projectRoot, 'openspec', 'changes', changeName);
-    // Get the full schema to access the apply phase configuration
-    const schema = resolveSchema(context.schemaName);
-    const applyConfig = schema.apply;
-    // Determine required artifacts and tracking file from schema
-    // Fallback: if no apply block, require all artifacts
-    const requiredArtifactIds = applyConfig?.requires ?? schema.artifacts.map((a) => a.id);
-    const tracksFile = applyConfig?.tracks ?? null;
-    const schemaInstruction = applyConfig?.instruction ?? null;
-    // Check which required artifacts are missing
-    const missingArtifacts = [];
-    for (const artifactId of requiredArtifactIds) {
-        const artifact = schema.artifacts.find((a) => a.id === artifactId);
-        if (artifact && !artifactOutputExists(changeDir, artifact.generates)) {
-            missingArtifacts.push(artifactId);
-        }
-    }
-    // Build context files from all existing artifacts in schema
-    const contextFiles = {};
-    for (const artifact of schema.artifacts) {
-        if (artifactOutputExists(changeDir, artifact.generates)) {
-            contextFiles[artifact.id] = path.join(changeDir, artifact.generates);
-        }
-    }
-    // Parse tasks if tracking file exists
-    let tasks = [];
-    let tracksFileExists = false;
-    if (tracksFile) {
-        const tracksPath = path.join(changeDir, tracksFile);
-        tracksFileExists = fs.existsSync(tracksPath);
-        if (tracksFileExists) {
-            const tasksContent = await fs.promises.readFile(tracksPath, 'utf-8');
-            tasks = parseTasksFile(tasksContent);
-        }
-    }
-    // Calculate progress
-    const total = tasks.length;
-    const complete = tasks.filter((t) => t.done).length;
-    const remaining = total - complete;
-    // Determine state and instruction
-    let state;
-    let instruction;
-    if (missingArtifacts.length > 0) {
-        state = 'blocked';
-        instruction = `Cannot apply this change yet. Missing artifacts: ${missingArtifacts.join(', ')}.\nUse the openspec-continue-change skill to create the missing artifacts first.`;
-    }
-    else if (tracksFile && !tracksFileExists) {
-        // Tracking file configured but doesn't exist yet
-        const tracksFilename = path.basename(tracksFile);
-        state = 'blocked';
-        instruction = `The ${tracksFilename} file is missing and must be created.\nUse openspec-continue-change to generate the tracking file.`;
-    }
-    else if (tracksFile && tracksFileExists && total === 0) {
-        // Tracking file exists but contains no tasks
-        const tracksFilename = path.basename(tracksFile);
-        state = 'blocked';
-        instruction = `The ${tracksFilename} file exists but contains no tasks.\nAdd tasks to ${tracksFilename} or regenerate it with openspec-continue-change.`;
-    }
-    else if (tracksFile && remaining === 0 && total > 0) {
-        state = 'all_done';
-        instruction = 'All tasks are complete! This change is ready to be archived.\nConsider running tests and reviewing the changes before archiving.';
-    }
-    else if (!tracksFile) {
-        // No tracking file (e.g., TDD schema) - ready to apply
-        state = 'ready';
-        instruction = schemaInstruction?.trim() ?? 'All required artifacts complete. Proceed with implementation.';
-    }
-    else {
-        state = 'ready';
-        instruction = schemaInstruction?.trim() ?? 'Read context files, work through pending tasks, mark complete as you go.\nPause if you hit blockers or need clarification.';
-    }
-    return {
-        changeName,
-        changeDir,
-        schemaName: context.schemaName,
-        contextFiles,
-        progress: { total, complete, remaining },
-        tasks,
-        state,
-        missingArtifacts: missingArtifacts.length > 0 ? missingArtifacts : undefined,
-        instruction,
-    };
-}
-async function applyInstructionsCommand(options) {
-    const spinner = ora('Generating apply instructions...').start();
-    try {
-        const projectRoot = process.cwd();
-        const changeName = await validateChangeExists(options.change, projectRoot);
-        // Validate schema if explicitly provided
-        if (options.schema) {
-            validateSchemaExists(options.schema, projectRoot);
-        }
-        // generateApplyInstructions uses loadChangeContext which auto-detects schema
-        const instructions = await generateApplyInstructions(projectRoot, changeName, options.schema);
-        spinner.stop();
-        if (options.json) {
-            console.log(JSON.stringify(instructions, null, 2));
-            return;
-        }
-        printApplyInstructionsText(instructions);
-    }
-    catch (error) {
-        spinner.stop();
-        throw error;
-    }
-}
-function printApplyInstructionsText(instructions) {
-    const { changeName, schemaName, contextFiles, progress, tasks, state, missingArtifacts, instruction } = instructions;
-    console.log(`## Apply: ${changeName}`);
-    console.log(`Schema: ${schemaName}`);
-    console.log();
-    // Warning for blocked state
-    if (state === 'blocked' && missingArtifacts) {
-        console.log('### ⚠️ Blocked');
-        console.log();
-        console.log(`Missing artifacts: ${missingArtifacts.join(', ')}`);
-        console.log('Use the openspec-continue-change skill to create these first.');
-        console.log();
-    }
-    // Context files (dynamically from schema)
-    const contextFileEntries = Object.entries(contextFiles);
-    if (contextFileEntries.length > 0) {
-        console.log('### Context Files');
-        for (const [artifactId, filePath] of contextFileEntries) {
-            console.log(`- ${artifactId}: ${filePath}`);
-        }
-        console.log();
-    }
-    // Progress (only show if we have tracking)
-    if (progress.total > 0 || tasks.length > 0) {
-        console.log('### Progress');
-        if (state === 'all_done') {
-            console.log(`${progress.complete}/${progress.total} complete ✓`);
-        }
-        else {
-            console.log(`${progress.complete}/${progress.total} complete`);
-        }
-        console.log();
-    }
-    // Tasks
-    if (tasks.length > 0) {
-        console.log('### Tasks');
-        for (const task of tasks) {
-            const checkbox = task.done ? '[x]' : '[ ]';
-            console.log(`- ${checkbox} ${task.description}`);
-        }
-        console.log();
-    }
-    // Instruction
-    console.log('### Instruction');
-    console.log(instruction);
-}
-async function templatesCommand(options) {
-    const spinner = ora('Loading templates...').start();
-    try {
-        const projectRoot = process.cwd();
-        const schemaName = validateSchemaExists(options.schema ?? DEFAULT_SCHEMA, projectRoot);
-        const schema = resolveSchema(schemaName, projectRoot);
-        const graph = ArtifactGraph.fromSchema(schema);
-        const schemaDir = getSchemaDir(schemaName, projectRoot);
-        // Determine the source (project, user, or package)
-        const { getUserSchemasDir, getProjectSchemasDir, } = await import('../core/artifact-graph/resolver.js');
-        const projectSchemasDir = getProjectSchemasDir(projectRoot);
-        const userSchemasDir = getUserSchemasDir();
-        let source;
-        if (schemaDir.startsWith(projectSchemasDir)) {
-            source = 'project';
-        }
-        else if (schemaDir.startsWith(userSchemasDir)) {
-            source = 'user';
-        }
-        else {
-            source = 'package';
-        }
-        const templates = graph.getAllArtifacts().map((artifact) => ({
-            artifactId: artifact.id,
-            templatePath: path.join(schemaDir, 'templates', artifact.template),
-            source,
-        }));
-        spinner.stop();
-        if (options.json) {
-            const output = {};
-            for (const t of templates) {
-                output[t.artifactId] = { path: t.templatePath, source: t.source };
-            }
-            console.log(JSON.stringify(output, null, 2));
-            return;
-        }
-        console.log(`Schema: ${schemaName}`);
-        console.log(`Source: ${source}`);
-        console.log();
-        for (const t of templates) {
-            console.log(`${t.artifactId}:`);
-            console.log(`  ${t.templatePath}`);
-        }
-    }
-    catch (error) {
-        spinner.stop();
-        throw error;
-    }
-}
-async function newChangeCommand(name, options) {
-    if (!name) {
-        throw new Error('Missing required argument <name>');
-    }
-    const validation = validateChangeName(name);
-    if (!validation.valid) {
-        throw new Error(validation.error);
-    }
-    const projectRoot = process.cwd();
-    // Validate schema if provided
-    if (options.schema) {
-        validateSchemaExists(options.schema, projectRoot);
-    }
-    const schemaDisplay = options.schema ? ` with schema '${options.schema}'` : '';
-    const spinner = ora(`Creating change '${name}'${schemaDisplay}...`).start();
-    try {
-        const result = await createChange(projectRoot, name, { schema: options.schema });
-        // If description provided, create README.md with description
-        if (options.description) {
-            const { promises: fs } = await import('fs');
-            const changeDir = path.join(projectRoot, 'openspec', 'changes', name);
-            const readmePath = path.join(changeDir, 'README.md');
-            await fs.writeFile(readmePath, `# ${name}\n\n${options.description}\n`, 'utf-8');
-        }
-        spinner.succeed(`Created change '${name}' at openspec/changes/${name}/ (schema: ${result.schema})`);
-    }
-    catch (error) {
-        spinner.fail(`Failed to create change '${name}'`);
-        throw error;
-    }
-}
-// -----------------------------------------------------------------------------
-// Artifact Experimental Setup Command
-// -----------------------------------------------------------------------------
-/**
- * Generates Agent Skills and slash commands for the experimental artifact workflow.
- * Creates .claude/skills/ directory with SKILL.md files following Agent Skills spec.
- * Creates .claude/commands/opsx/ directory with slash command files.
- */
-async function artifactExperimentalSetupCommand() {
-    const spinner = ora('Setting up experimental artifact workflow...').start();
-    try {
-        const projectRoot = process.cwd();
-        const skillsDir = path.join(projectRoot, '.claude', 'skills');
-        const commandsDir = path.join(projectRoot, '.claude', 'commands', 'opsx');
-        // Get skill templates
-        const exploreSkill = getExploreSkillTemplate();
-        const newChangeSkill = getNewChangeSkillTemplate();
-        const continueChangeSkill = getContinueChangeSkillTemplate();
-        const applyChangeSkill = getApplyChangeSkillTemplate();
-        const ffChangeSkill = getFfChangeSkillTemplate();
-        const syncSpecsSkill = getSyncSpecsSkillTemplate();
-        const archiveChangeSkill = getArchiveChangeSkillTemplate();
-        const bulkArchiveChangeSkill = getBulkArchiveChangeSkillTemplate();
-        const verifyChangeSkill = getVerifyChangeSkillTemplate();
-        // Get command templates
-        const exploreCommand = getOpsxExploreCommandTemplate();
-        const newCommand = getOpsxNewCommandTemplate();
-        const continueCommand = getOpsxContinueCommandTemplate();
-        const applyCommand = getOpsxApplyCommandTemplate();
-        const ffCommand = getOpsxFfCommandTemplate();
-        const syncCommand = getOpsxSyncCommandTemplate();
-        const archiveCommand = getOpsxArchiveCommandTemplate();
-        const bulkArchiveCommand = getOpsxBulkArchiveCommandTemplate();
-        const verifyCommand = getOpsxVerifyCommandTemplate();
-        // Create skill directories and SKILL.md files
-        const skills = [
-            { template: exploreSkill, dirName: 'openspec-explore' },
-            { template: newChangeSkill, dirName: 'openspec-new-change' },
-            { template: continueChangeSkill, dirName: 'openspec-continue-change' },
-            { template: applyChangeSkill, dirName: 'openspec-apply-change' },
-            { template: ffChangeSkill, dirName: 'openspec-ff-change' },
-            { template: syncSpecsSkill, dirName: 'openspec-sync-specs' },
-            { template: archiveChangeSkill, dirName: 'openspec-archive-change' },
-            { template: bulkArchiveChangeSkill, dirName: 'openspec-bulk-archive-change' },
-            { template: verifyChangeSkill, dirName: 'openspec-verify-change' },
-        ];
-        const createdSkillFiles = [];
-        for (const { template, dirName } of skills) {
-            const skillDir = path.join(skillsDir, dirName);
-            const skillFile = path.join(skillDir, 'SKILL.md');
-            // Generate SKILL.md content with YAML frontmatter
-            const skillContent = `---
-name: ${template.name}
-description: ${template.description}
----
-
-${template.instructions}
-`;
-            // Write the skill file
-            await FileSystemUtils.writeFile(skillFile, skillContent);
-            createdSkillFiles.push(path.relative(projectRoot, skillFile));
-        }
-        // Create slash command files
-        const commands = [
-            { template: exploreCommand, fileName: 'explore.md' },
-            { template: newCommand, fileName: 'new.md' },
-            { template: continueCommand, fileName: 'continue.md' },
-            { template: applyCommand, fileName: 'apply.md' },
-            { template: ffCommand, fileName: 'ff.md' },
-            { template: syncCommand, fileName: 'sync.md' },
-            { template: archiveCommand, fileName: 'archive.md' },
-            { template: bulkArchiveCommand, fileName: 'bulk-archive.md' },
-            { template: verifyCommand, fileName: 'verify.md' },
-        ];
-        const createdCommandFiles = [];
-        for (const { template, fileName } of commands) {
-            const commandFile = path.join(commandsDir, fileName);
-            // Generate command content with YAML frontmatter
-            const commandContent = `---
-name: ${template.name}
-description: ${template.description}
-category: ${template.category}
-tags: [${template.tags.join(', ')}]
----
-
-${template.content}
-`;
-            // Write the command file
-            await FileSystemUtils.writeFile(commandFile, commandContent);
-            createdCommandFiles.push(path.relative(projectRoot, commandFile));
-        }
-        spinner.succeed('Experimental artifact workflow setup complete!');
-        // Print success message
-        console.log();
-        console.log(chalk.bold('🧪 Experimental Artifact Workflow Setup Complete'));
-        console.log();
-        console.log(chalk.bold('Skills Created:'));
-        for (const file of createdSkillFiles) {
-            console.log(chalk.green('  ✓ ' + file));
-        }
-        console.log();
-        console.log(chalk.bold('Slash Commands Created:'));
-        for (const file of createdCommandFiles) {
-            console.log(chalk.green('  ✓ ' + file));
-        }
-        console.log();
-        // Config creation section
-        console.log('━'.repeat(70));
-        console.log();
-        console.log(chalk.bold('📋 Project Configuration (Optional)'));
-        console.log();
-        console.log('Configure project defaults for OpenSpec workflows.');
-        console.log();
-        // Check if config already exists
-        const configPath = path.join(projectRoot, 'openspec', 'config.yaml');
-        const configYmlPath = path.join(projectRoot, 'openspec', 'config.yml');
-        const configExists = fs.existsSync(configPath) || fs.existsSync(configYmlPath);
-        if (configExists) {
-            // Config already exists, skip creation
-            console.log(chalk.blue('ℹ️  openspec/config.yaml already exists. Skipping config creation.'));
-            console.log();
-            console.log('   To update config, edit openspec/config.yaml manually or:');
-            console.log('   1. Delete openspec/config.yaml');
-            console.log('   2. Run openspec artifact-experimental-setup again');
-            console.log();
-        }
-        else if (!process.stdin.isTTY) {
-            // Non-interactive mode (CI, automation, piped input)
-            console.log(chalk.blue('ℹ️  Skipping config prompts (non-interactive mode)'));
-            console.log();
-            console.log('   To create config manually, add openspec/config.yaml with:');
-            console.log(chalk.dim('   schema: spec-driven'));
-            console.log();
-        }
-        else {
-            // Create config with default schema
-            const yamlContent = serializeConfig({ schema: DEFAULT_SCHEMA });
-            try {
-                await FileSystemUtils.writeFile(configPath, yamlContent);
-                console.log();
-                console.log(chalk.green('✓ Created openspec/config.yaml'));
-                console.log();
-                console.log(`   Default schema: ${chalk.cyan(DEFAULT_SCHEMA)}`);
-                console.log();
-                console.log(chalk.dim('   Edit the file to add project context and per-artifact rules.'));
-                console.log();
-                // Git commit suggestion
-                console.log(chalk.bold('To share with team:'));
-                console.log(chalk.dim('  git add openspec/config.yaml .claude/'));
-                console.log(chalk.dim('  git commit -m "Setup OpenSpec experimental workflow"'));
-                console.log();
-            }
-            catch (writeError) {
-                // Handle file write errors
-                console.error();
-                console.error(chalk.red('✗ Failed to write openspec/config.yaml'));
-                console.error(chalk.dim(`  ${writeError.message}`));
-                console.error();
-                console.error('Fallback: Create config manually:');
-                console.error(chalk.dim('  1. Create openspec/config.yaml'));
-                console.error(chalk.dim('  2. Copy the following content:'));
-                console.error();
-                console.error(chalk.dim(yamlContent));
-                console.error();
-            }
-        }
-        console.log('━'.repeat(70));
-        console.log();
-        console.log(chalk.bold('📖 Usage:'));
-        console.log();
-        console.log('  ' + chalk.cyan('Skills') + ' work automatically in compatible editors:');
-        console.log('  • Claude Code - Auto-detected, ready to use');
-        console.log('  • Cursor - Enable in Settings → Rules → Import Settings');
-        console.log('  • Windsurf - Auto-imports from .claude directory');
-        console.log();
-        console.log('  Ask Claude naturally:');
-        console.log('  • "I want to start a new OpenSpec change to add <feature>"');
-        console.log('  • "Continue working on this change"');
-        console.log('  • "Implement the tasks for this change"');
-        console.log();
-        console.log('  ' + chalk.cyan('Slash Commands') + ' for explicit invocation:');
-        console.log('  • /opsx:explore - Think through ideas, investigate problems');
-        console.log('  • /opsx:new - Start a new change');
-        console.log('  • /opsx:continue - Create the next artifact');
-        console.log('  • /opsx:apply - Implement tasks');
-        console.log('  • /opsx:ff - Fast-forward: create all artifacts at once');
-        console.log('  • /opsx:sync - Sync delta specs to main specs');
-        console.log('  • /opsx:verify - Verify implementation matches artifacts');
-        console.log('  • /opsx:archive - Archive a completed change');
-        console.log();
-        console.log(chalk.yellow('💡 This is an experimental feature.'));
-        console.log('   Feedback welcome at: https://github.com/Fission-AI/OpenSpec/issues');
-        console.log();
-    }
-    catch (error) {
-        spinner.fail('Failed to setup experimental artifact workflow');
-        throw error;
-    }
-}
-async function schemasCommand(options) {
-    const projectRoot = process.cwd();
-    const schemas = listSchemasWithInfo(projectRoot);
-    if (options.json) {
-        console.log(JSON.stringify(schemas, null, 2));
-        return;
-    }
-    console.log('Available schemas:');
-    console.log();
-    for (const schema of schemas) {
-        let sourceLabel = '';
-        if (schema.source === 'project') {
-            sourceLabel = chalk.cyan(' (project)');
-        }
-        else if (schema.source === 'user') {
-            sourceLabel = chalk.dim(' (user override)');
-        }
-        console.log(`  ${chalk.bold(schema.name)}${sourceLabel}`);
-        console.log(`    ${schema.description}`);
-        console.log(`    Artifacts: ${schema.artifacts.join(' → ')}`);
-        console.log();
-    }
-}
-// -----------------------------------------------------------------------------
-// Command Registration
-// -----------------------------------------------------------------------------
-/**
- * Registers all artifact workflow commands on the given program.
- * All commands are marked as experimental in their help text.
- */
-export function registerArtifactWorkflowCommands(program) {
-    // Status command
-    program
-        .command('status')
-        .description('[Experimental] Display artifact completion status for a change')
-        .option('--change <id>', 'Change name to show status for')
-        .option('--schema <name>', 'Schema override (auto-detected from .openspec.yaml)')
-        .option('--json', 'Output as JSON')
-        .action(async (options) => {
-        try {
-            await statusCommand(options);
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-    // Instructions command
-    program
-        .command('instructions [artifact]')
-        .description('[Experimental] Output enriched instructions for creating an artifact or applying tasks')
-        .option('--change <id>', 'Change name')
-        .option('--schema <name>', 'Schema override (auto-detected from .openspec.yaml)')
-        .option('--json', 'Output as JSON')
-        .action(async (artifactId, options) => {
-        try {
-            // Special case: "apply" is not an artifact, but a command to get apply instructions
-            if (artifactId === 'apply') {
-                await applyInstructionsCommand(options);
-            }
-            else {
-                await instructionsCommand(artifactId, options);
-            }
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-    // Templates command
-    program
-        .command('templates')
-        .description('[Experimental] Show resolved template paths for all artifacts in a schema')
-        .option('--schema <name>', `Schema to use (default: ${DEFAULT_SCHEMA})`)
-        .option('--json', 'Output as JSON mapping artifact IDs to template paths')
-        .action(async (options) => {
-        try {
-            await templatesCommand(options);
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-    // Schemas command
-    program
-        .command('schemas')
-        .description('[Experimental] List available workflow schemas with descriptions')
-        .option('--json', 'Output as JSON (for agent use)')
-        .action(async (options) => {
-        try {
-            await schemasCommand(options);
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-    // New command group with change subcommand
-    const newCmd = program.command('new').description('[Experimental] Create new items');
-    newCmd
-        .command('change <name>')
-        .description('[Experimental] Create a new change directory')
-        .option('--description <text>', 'Description to add to README.md')
-        .option('--schema <name>', `Workflow schema to use (default: ${DEFAULT_SCHEMA})`)
-        .action(async (name, options) => {
-        try {
-            await newChangeCommand(name, options);
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-    // Artifact experimental setup command
-    program
-        .command('artifact-experimental-setup')
-        .description('[Experimental] Setup Agent Skills for the experimental artifact workflow')
-        .action(async () => {
-        try {
-            await artifactExperimentalSetupCommand();
-        }
-        catch (error) {
-            console.log();
-            ora().fail(`Error: ${error.message}`);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=artifact-workflow.js.map