@fission-ai/openspec 0.21.0 → 0.23.0

package/dist/cli/index.js

@@ -16,6 +16,7 @@ import { CompletionCommand } from '../commands/completion.js';
 import { FeedbackCommand } from '../commands/feedback.js';
 import { registerConfigCommand } from '../commands/config.js';
 import { registerArtifactWorkflowCommands } from '../commands/artifact-workflow.js';
+import { registerSchemaCommand } from '../commands/schema.js';
 import { maybeShowTelemetryNotice, trackCommand, shutdown } from '../telemetry/index.js';
 const program = new Command();
 const require = createRequire(import.meta.url);
@@ -230,6 +231,7 @@ program
 });
 registerSpecCommand(program);
 registerConfigCommand(program);
+registerSchemaCommand(program);
 // Top-level validate command
 program
     .command('validate [item-name]')

package/dist/commands/artifact-workflow.js

@@ -14,8 +14,9 @@ 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, getVerifyChangeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxVerifyCommandTemplate } from '../core/templates/skill-templates.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.
@@ -97,11 +98,14 @@ async function validateChangeExists(changeName, projectRoot) {
 }
 /**
  * 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) {
-    const schemaDir = getSchemaDir(schemaName);
+function validateSchemaExists(schemaName, projectRoot) {
+    const schemaDir = getSchemaDir(schemaName, projectRoot);
     if (!schemaDir) {
-        const availableSchemas = listSchemas();
+        const availableSchemas = listSchemas(projectRoot);
         throw new Error(`Schema '${schemaName}' not found. Available schemas:\n  ${availableSchemas.join('\n  ')}`);
     }
     return schemaName;
@@ -113,7 +117,7 @@ async function statusCommand(options) {
         const changeName = await validateChangeExists(options.change, projectRoot);
         // Validate schema if explicitly provided
         if (options.schema) {
-            validateSchemaExists(options.schema);
+            validateSchemaExists(options.schema, projectRoot);
         }
         // loadChangeContext will auto-detect schema from metadata if not provided
         const context = loadChangeContext(projectRoot, changeName, options.schema);
@@ -158,7 +162,7 @@ async function instructionsCommand(artifactId, options) {
         const changeName = await validateChangeExists(options.change, projectRoot);
         // Validate schema if explicitly provided
         if (options.schema) {
-            validateSchemaExists(options.schema);
+            validateSchemaExists(options.schema, projectRoot);
         }
         // loadChangeContext will auto-detect schema from metadata if not provided
         const context = loadChangeContext(projectRoot, changeName, options.schema);
@@ -173,7 +177,7 @@ async function instructionsCommand(artifactId, options) {
             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);
+        const instructions = generateInstructions(context, artifactId, projectRoot);
         const isBlocked = instructions.dependencies.some((d) => !d.done);
         spinner.stop();
         if (options.json) {
@@ -433,7 +437,7 @@ async function applyInstructionsCommand(options) {
         const changeName = await validateChangeExists(options.change, projectRoot);
         // Validate schema if explicitly provided
         if (options.schema) {
-            validateSchemaExists(options.schema);
+            validateSchemaExists(options.schema, projectRoot);
         }
         // generateApplyInstructions uses loadChangeContext which auto-detects schema
         const instructions = await generateApplyInstructions(projectRoot, changeName, options.schema);
@@ -498,18 +502,29 @@ function printApplyInstructionsText(instructions) {
 async function templatesCommand(options) {
     const spinner = ora('Loading templates...').start();
     try {
-        const schemaName = validateSchemaExists(options.schema ?? DEFAULT_SCHEMA);
-        const schema = resolveSchema(schemaName);
+        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);
-        // Determine if this is a user override or package built-in
-        const { getUserSchemasDir } = await import('../core/artifact-graph/resolver.js');
+        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();
-        const isUserOverride = schemaDir.startsWith(userSchemasDir);
+        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: isUserOverride ? 'user' : 'package',
+            source,
         }));
         spinner.stop();
         if (options.json) {
@@ -521,7 +536,7 @@ async function templatesCommand(options) {
             return;
         }
         console.log(`Schema: ${schemaName}`);
-        console.log(`Source: ${isUserOverride ? 'user override' : 'package built-in'}`);
+        console.log(`Source: ${source}`);
         console.log();
         for (const t of templates) {
             console.log(`${t.artifactId}:`);
@@ -541,15 +556,15 @@ async function newChangeCommand(name, options) {
     if (!validation.valid) {
         throw new Error(validation.error);
     }
+    const projectRoot = process.cwd();
     // Validate schema if provided
     if (options.schema) {
-        validateSchemaExists(options.schema);
+        validateSchemaExists(options.schema, projectRoot);
     }
     const schemaDisplay = options.schema ? ` with schema '${options.schema}'` : '';
     const spinner = ora(`Creating change '${name}'${schemaDisplay}...`).start();
     try {
-        const projectRoot = process.cwd();
-        await createChange(projectRoot, name, { schema: options.schema });
+        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');
@@ -557,8 +572,7 @@ async function newChangeCommand(name, options) {
             const readmePath = path.join(changeDir, 'README.md');
             await fs.writeFile(readmePath, `# ${name}\n\n${options.description}\n`, 'utf-8');
         }
-        const schemaUsed = options.schema ?? DEFAULT_SCHEMA;
-        spinner.succeed(`Created change '${name}' at openspec/changes/${name}/ (schema: ${schemaUsed})`);
+        spinner.succeed(`Created change '${name}' at openspec/changes/${name}/ (schema: ${result.schema})`);
     }
     catch (error) {
         spinner.fail(`Failed to create change '${name}'`);
@@ -587,6 +601,7 @@ async function artifactExperimentalSetupCommand() {
         const ffChangeSkill = getFfChangeSkillTemplate();
         const syncSpecsSkill = getSyncSpecsSkillTemplate();
         const archiveChangeSkill = getArchiveChangeSkillTemplate();
+        const bulkArchiveChangeSkill = getBulkArchiveChangeSkillTemplate();
         const verifyChangeSkill = getVerifyChangeSkillTemplate();
         // Get command templates
         const exploreCommand = getOpsxExploreCommandTemplate();
@@ -596,6 +611,7 @@ async function artifactExperimentalSetupCommand() {
         const ffCommand = getOpsxFfCommandTemplate();
         const syncCommand = getOpsxSyncCommandTemplate();
         const archiveCommand = getOpsxArchiveCommandTemplate();
+        const bulkArchiveCommand = getOpsxBulkArchiveCommandTemplate();
         const verifyCommand = getOpsxVerifyCommandTemplate();
         // Create skill directories and SKILL.md files
         const skills = [
@@ -606,6 +622,7 @@ async function artifactExperimentalSetupCommand() {
             { 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 = [];
@@ -633,6 +650,7 @@ ${template.instructions}
             { 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 = [];
@@ -667,6 +685,68 @@ ${template.content}
             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:');
@@ -699,7 +779,8 @@ ${template.content}
     }
 }
 async function schemasCommand(options) {
-    const schemas = listSchemasWithInfo();
+    const projectRoot = process.cwd();
+    const schemas = listSchemasWithInfo(projectRoot);
     if (options.json) {
         console.log(JSON.stringify(schemas, null, 2));
         return;
@@ -707,7 +788,13 @@ async function schemasCommand(options) {
     console.log('Available schemas:');
     console.log();
     for (const schema of schemas) {
-        const sourceLabel = schema.source === 'user' ? chalk.dim(' (user override)') : '';
+        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(' → ')}`);

package/dist/commands/schema.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Register the schema command and all its subcommands.
+ */
+export declare function registerSchemaCommand(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map