@fission-ai/openspec 1.9.0 → 1.10.0

package/dist/core/completions/installers/bash-installer.js

@@ -55,6 +55,21 @@ export class BashInstaller {
         // For user installation, use local directory
         return path.join(localCompletionDir, 'openspec');
     }
+    /**
+     * Check if a completion script is currently installed.
+     * Mirrors ZshInstaller.isInstalled so callers can ask any installer.
+     *
+     * @returns true if the completion script exists
+     */
+    async isInstalled() {
+        try {
+            // stat, not access: a directory at the install path is not a script.
+            return (await fs.stat(await this.getInstallationPath())).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Backup an existing completion file if it exists
      *

package/dist/core/completions/installers/fish-installer.d.ts

@@ -12,6 +12,13 @@ export declare class FishInstaller {
      * @returns Installation path
      */
     getInstallationPath(): string;
+    /**
+     * Check if a completion script is currently installed.
+     * Mirrors ZshInstaller.isInstalled so callers can ask any installer.
+     *
+     * @returns true if the completion script exists
+     */
+    isInstalled(): Promise<boolean>;
     /**
      * Backup an existing completion file if it exists
      *

package/dist/core/completions/installers/fish-installer.js

@@ -19,6 +19,21 @@ export class FishInstaller {
     getInstallationPath() {
         return path.join(this.homeDir, '.config', 'fish', 'completions', 'openspec.fish');
     }
+    /**
+     * Check if a completion script is currently installed.
+     * Mirrors ZshInstaller.isInstalled so callers can ask any installer.
+     *
+     * @returns true if the completion script exists
+     */
+    async isInstalled() {
+        try {
+            // stat, not access: a directory at the install path is not a script.
+            return (await fs.stat(this.getInstallationPath())).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Backup an existing completion file if it exists
      *

package/dist/core/completions/installers/powershell-installer.d.ts

@@ -43,6 +43,13 @@ export declare class PowerShellInstaller {
      * @returns Installation path
      */
     getInstallationPath(): string;
+    /**
+     * Check if a completion script is currently installed.
+     * Mirrors ZshInstaller.isInstalled so callers can ask any installer.
+     *
+     * @returns true if the completion script exists
+     */
+    isInstalled(): Promise<boolean>;
     /**
      * Backup an existing completion file if it exists
      *

package/dist/core/completions/installers/powershell-installer.js

@@ -110,6 +110,21 @@ export class PowerShellInstaller {
         const profileDir = path.dirname(profilePath);
         return path.join(profileDir, 'OpenSpecCompletion.ps1');
     }
+    /**
+     * Check if a completion script is currently installed.
+     * Mirrors ZshInstaller.isInstalled so callers can ask any installer.
+     *
+     * @returns true if the completion script exists
+     */
+    async isInstalled() {
+        try {
+            // stat, not access: a directory at the install path is not a script.
+            return (await fs.stat(this.getInstallationPath())).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Backup an existing completion file if it exists
      *

package/dist/core/config-prompts.js

@@ -9,16 +9,25 @@ export function serializeConfig(config) {
     // Schema (required)
     lines.push(`schema: ${config.schema}`);
     lines.push('');
-    // Context section with comments
-    lines.push('# Project context (optional)');
-    lines.push('# This is shown to AI when creating artifacts.');
-    lines.push('# Add your tech stack, conventions, style guides, domain knowledge, etc.');
-    lines.push('# Example:');
-    lines.push('#   context: |');
-    lines.push('#     Tech stack: TypeScript, React, Node.js');
-    lines.push('#     We use conventional commits');
-    lines.push('#     Domain: e-commerce platform');
-    lines.push('');
+    if (config.context !== undefined) {
+        lines.push('context: |');
+        for (const line of config.context.split('\n')) {
+            lines.push(`  ${line}`);
+        }
+        lines.push('');
+    }
+    else {
+        // Context section with comments
+        lines.push('# Project context (optional)');
+        lines.push('# This is shown to AI when creating artifacts.');
+        lines.push('# Add your tech stack, conventions, style guides, domain knowledge, etc.');
+        lines.push('# Example:');
+        lines.push('#   context: |');
+        lines.push('#     Tech stack: TypeScript, React, Node.js');
+        lines.push('#     We use conventional commits');
+        lines.push('#     Domain: e-commerce platform');
+        lines.push('');
+    }
     // Rules section with comments
     lines.push('# Per-artifact rules (optional)');
     lines.push('# Add custom rules for specific artifacts.');

package/dist/core/config-schema.d.ts

@@ -19,6 +19,7 @@ export declare const GlobalConfigSchema: z.ZodObject<{
     telemetry: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
+    completionTipSeen: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export type GlobalConfigType = z.infer<typeof GlobalConfigSchema>;
 /**

package/dist/core/config-schema.js

@@ -32,6 +32,8 @@ export const GlobalConfigSchema = z
     })
         .passthrough()
         .optional(),
+    // Runtime-managed (like telemetry.noticeSeen); not user-settable via CLI set.
+    completionTipSeen: z.boolean().optional(),
 })
     .passthrough();
 /**

package/dist/core/config.js

@@ -54,6 +54,7 @@ export const AI_TOOLS = [
     { name: 'Rovo Dev CLI', value: 'rovodev', available: true, successLabel: 'Rovo Dev CLI', skillsDir: '.rovodev', detectionPaths: ['.rovodev/skills', '.rovodev'] },
     { name: 'Zoo Code', value: 'roocode', available: true, successLabel: 'Zoo Code', skillsDir: '.roo', requiresIdeRestart: true },
     { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae', requiresIdeRestart: true },
+    { name: 'Zed Agent', value: 'zed', available: true, successLabel: 'Zed Agent', skillsDir: '.agents', detectionPaths: ['.zed', '.agents/skills'] },
     { name: 'ZCode', value: 'zcode', available: true, successLabel: 'ZCode', skillsDir: '.zcode' },
     // Vendor-neutral target for assistants that read the shared `.agents` root.
     // Detection keys off `.agents/skills` rather than the bare root: frameworks use

package/dist/core/global-config.d.ts

@@ -26,6 +26,8 @@ export interface GlobalConfig {
     openers?: unknown;
     /** Anonymous usage analytics settings and identity. */
     telemetry?: TelemetryConfig;
+    /** Whether the first-run shell-completions tip has been shown. */
+    completionTipSeen?: boolean;
 }
 /**
  * Gets the global configuration directory path following XDG Base Directory Specification.

package/dist/core/init.d.ts

@@ -6,6 +6,7 @@
  */
 type InitCommandOptions = {
     tools?: string;
+    language?: string;
     force?: boolean;
     interactive?: boolean;
     profile?: string;
@@ -20,6 +21,7 @@ type InitCommandOptions = {
 };
 export declare class InitCommand {
     private readonly toolsArg?;
+    private readonly language?;
     private readonly force;
     private readonly interactiveOption?;
     private readonly profileOverride?;
@@ -85,6 +87,9 @@ export declare class InitCommand {
      * @returns Created, refreshed, and failed tools plus removed artifact counts
      */
     private generateSkillsAndCommands;
+    private normalizeLanguage;
+    private languageContext;
+    private assertLanguageCanBeApplied;
     private createConfig;
     private displaySuccessMessage;
     private startSpinner;

package/dist/core/init.js

@@ -10,7 +10,7 @@ import ora from 'ora';
 import * as fs from 'fs';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
-import { classifyOpenSpecDir, storePointerProblem } from './project-config.js';
+import { classifyOpenSpecDir, MAX_CONTEXT_SIZE, readProjectConfig, storePointerProblem, } from './project-config.js';
 import { findRepoPlanningRootSync } from './planning-home.js';
 import { getSkillReferenceTransformer, getTransformerForTool, usesNaturalLanguageSkillReferences } from '../utils/command-references.js';
 import { AI_TOOLS, OPENSPEC_DIR_NAME, resolveToolIdAlias, } from './config.js';
@@ -33,6 +33,13 @@ const { version: OPENSPEC_VERSION } = require('../../package.json');
 // Constants
 // -----------------------------------------------------------------------------
 const DEFAULT_SCHEMA = 'spec-driven';
+function formatLanguageContext(language) {
+    return [
+        `Language: ${language}`,
+        `All artifacts must be written in ${language}.`,
+        'Keep OpenSpec structural headings and SHALL/MUST keywords in English.',
+    ].join('\n');
+}
 const PROGRESS_SPINNER = {
     interval: 80,
     frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
@@ -56,6 +63,7 @@ const WORKFLOW_TO_SKILL_DIR = {
 // -----------------------------------------------------------------------------
 export class InitCommand {
     toolsArg;
+    language;
     force;
     interactiveOption;
     profileOverride;
@@ -63,6 +71,7 @@ export class InitCommand {
     copilotCloudOption;
     constructor(options = {}) {
         this.toolsArg = options.tools;
+        this.language = this.normalizeLanguage(options.language);
         this.force = options.force ?? false;
         this.interactiveOption = options.interactive;
         this.profileOverride = options.profile;
@@ -97,6 +106,7 @@ export class InitCommand {
                 }
             }
         }
+        await this.assertLanguageCanBeApplied(projectPath, openspecPath);
         // Check for legacy artifacts and handle cleanup
         const deferredLegacyCleanup = await this.handleLegacyCleanup(projectPath, extendMode);
         // Migrate OpenSpec-managed skills left in renamed tool directories
@@ -517,11 +527,31 @@ export class InitCommand {
     }
     validateTools(toolIds, toolStates, projectPath) {
         const validatedTools = [];
-        const reconciledToolIds = toolIds.includes('codex') && toolIds.includes('agents')
-            ? toolIds.filter((toolId) => toolId !== 'agents')
+        const sharedAgentsTargets = ['codex', 'zed', 'agents'];
+        const selectedSharedTargets = sharedAgentsTargets.filter((toolId) => toolIds.includes(toolId));
+        // A Codex-rendered tree already serves Zed. Keep it when Zed is added later
+        // so Codex users do not lose the `$openspec-*` references they require.
+        const preserveConfiguredCodex = selectedSharedTargets.includes('zed') &&
+            toolStates.get('codex')?.configured;
+        const sharedTargetCandidates = preserveConfiguredCodex
+            ? [...new Set([...selectedSharedTargets, 'codex'])]
+            : selectedSharedTargets;
+        const sharedTargetOwner = sharedTargetCandidates.includes('codex')
+            ? 'codex'
+            : selectedSharedTargets.includes('zed')
+                ? 'zed'
+                : selectedSharedTargets[0];
+        const firstSharedIndex = toolIds.findIndex((id) => sharedAgentsTargets.includes(id));
+        const reconciledToolIds = sharedTargetCandidates.length > 1
+            ? toolIds.flatMap((toolId, index) => {
+                if (!sharedAgentsTargets.includes(toolId))
+                    return [toolId];
+                return index === firstSharedIndex && sharedTargetOwner ? [sharedTargetOwner] : [];
+            })
             : toolIds;
-        if (reconciledToolIds.length !== toolIds.length) {
-            console.log(chalk.dim('Codex and agents share .agents/skills; writing one tree with Codex and generic skill references.'));
+        if (reconciledToolIds.length !== toolIds.length ||
+            reconciledToolIds.some((toolId, index) => toolId !== toolIds[index])) {
+            console.log(chalk.dim(`Codex, Zed, and agents share .agents/skills; writing one tree for ${sharedTargetOwner}.`));
         }
         for (const toolId of reconciledToolIds) {
             const tool = AI_TOOLS.find((t) => t.value === toolId);
@@ -699,6 +729,53 @@ export class InitCommand {
     // ═══════════════════════════════════════════════════════════
     // CONFIG FILE
     // ═══════════════════════════════════════════════════════════
+    normalizeLanguage(language) {
+        if (language === undefined)
+            return undefined;
+        const normalized = language.trim();
+        if (!normalized) {
+            throw new Error('The --language option requires a non-empty value.');
+        }
+        if (/\p{Cc}|\p{Bidi_Control}|[\u200B\u2028\u2029\uFEFF]/u.test(normalized)) {
+            throw new Error('The --language option must be a single line without control or invisible formatting characters.');
+        }
+        const serializedContext = `${formatLanguageContext(normalized)}\n`;
+        if (Buffer.byteLength(serializedContext, 'utf8') > MAX_CONTEXT_SIZE) {
+            throw new Error(`The --language option is too long for OpenSpec's ${MAX_CONTEXT_SIZE / 1024}KB project context limit.`);
+        }
+        return normalized;
+    }
+    languageContext() {
+        if (!this.language)
+            return undefined;
+        return formatLanguageContext(this.language);
+    }
+    async assertLanguageCanBeApplied(projectPath, openspecPath) {
+        const languageContext = this.languageContext();
+        if (!languageContext)
+            return;
+        const configPath = path.join(openspecPath, 'config.yaml');
+        const hasConfig = fs.existsSync(configPath) ||
+            fs.existsSync(path.join(openspecPath, 'config.yml'));
+        if (!hasConfig) {
+            try {
+                FileSystemUtils.assertProjectArtifactPath(projectPath, configPath);
+            }
+            catch (error) {
+                const reason = error instanceof Error ? `: ${error.message}` : '';
+                throw new Error(`Cannot create openspec/config.yaml for --language${reason}`);
+            }
+            if (!(await FileSystemUtils.canWriteFile(configPath))) {
+                throw new Error('Cannot create openspec/config.yaml for --language: the destination is not writable.');
+            }
+            return;
+        }
+        const existingContext = readProjectConfig(projectPath)?.context;
+        if (existingContext?.includes(languageContext))
+            return;
+        throw new Error('--language does not overwrite an existing OpenSpec config. ' +
+            'Add the language instruction to its context field instead.');
+    }
     async createConfig(openspecPath, extendMode) {
         const configPath = path.join(openspecPath, 'config.yaml');
         const configYmlPath = path.join(openspecPath, 'config.yml');
@@ -708,12 +785,19 @@ export class InitCommand {
             return 'exists';
         }
         try {
-            const yamlContent = serializeConfig({ schema: DEFAULT_SCHEMA });
+            const yamlContent = serializeConfig({
+                schema: DEFAULT_SCHEMA,
+                context: this.languageContext(),
+            });
             FileSystemUtils.assertProjectArtifactPath(path.dirname(openspecPath), configPath);
             await FileSystemUtils.writeFile(configPath, yamlContent);
             return 'created';
         }
-        catch {
+        catch (error) {
+            if (this.language) {
+                const reason = error instanceof Error ? `: ${error.message}` : '';
+                throw new Error(`Failed to create openspec/config.yaml for --language${reason}`);
+            }
             return 'skipped';
         }
     }

package/dist/core/profiles.d.ts

@@ -20,7 +20,7 @@ export type CoreWorkflowId = (typeof CORE_WORKFLOWS)[number];
  * Resolves which workflows should be active for a given profile configuration.
  *
  * - 'core' profile always returns CORE_WORKFLOWS
- * - 'custom' profile returns the provided customWorkflows, or empty array if not provided
+ * - 'custom' profile returns the provided customWorkflows and required dependencies
  */
 export declare function getProfileWorkflows(profile: Profile, customWorkflows?: string[]): readonly string[];
 //# sourceMappingURL=profiles.d.ts.map

package/dist/core/profiles.js

@@ -30,11 +30,20 @@ export const ALL_WORKFLOWS = [
  * Resolves which workflows should be active for a given profile configuration.
  *
  * - 'core' profile always returns CORE_WORKFLOWS
- * - 'custom' profile returns the provided customWorkflows, or empty array if not provided
+ * - 'custom' profile returns the provided customWorkflows and required dependencies
  */
 export function getProfileWorkflows(profile, customWorkflows) {
     if (profile === 'custom') {
-        return customWorkflows ?? [];
+        const workflows = customWorkflows ?? [];
+        const syncDependentIndex = workflows.findIndex((workflow) => workflow === 'archive' || workflow === 'bulk-archive');
+        if (syncDependentIndex !== -1 && !workflows.includes('sync')) {
+            return [
+                ...workflows.slice(0, syncDependentIndex),
+                'sync',
+                ...workflows.slice(syncDependentIndex),
+            ];
+        }
+        return workflows;
     }
     return CORE_WORKFLOWS;
 }

package/dist/core/templates/workflows/feedback.js

@@ -39,6 +39,7 @@ export function getFeedbackSkillTemplate() {
 5. **Submit on confirmation**
    - Use the \`openspec feedback\` command to submit
    - Format: \`openspec feedback "title" --body "body content"\`
+   - The command preserves the title text in the issue body and shortens long GitHub issue titles
    - The command will automatically add metadata (version, platform, timestamp)
 
 **Example Draft**

package/dist/core/templates/workflows/onboard.js

@@ -374,12 +374,12 @@ Here are the implementation tasks:
 
 ## 1. [Category or file]
 
-- [ ] 1.1 [Specific task]
-- [ ] 1.2 [Specific task]
+- [ ] 1.1 [Specific task] — verify: [test, command, observable behavior, or delivered artifact]
+- [ ] 1.2 [Specific task] — verify: [test, command, observable behavior, or delivered artifact]
 
-## 2. Verify
+## 2. Integration Verification
 
-- [ ] 2.1 [Verification step]
+- [ ] 2.1 Verify [broader integration or system behavior] with [end-to-end test or observable result]
 
 ---
 

package/dist/core/update.js

@@ -135,7 +135,7 @@ export class UpdateCommand {
             // Still check for new tool directories and extra workflows
             this.detectNewTools(resolvedProjectPath, configuredTools);
             this.displayExtraWorkflowsNote(resolvedProjectPath, configuredTools, desiredWorkflows);
-            this.displayMissingCoreWorkflowsNote(profile, globalConfig.workflows);
+            this.displayMissingCoreWorkflowsNote(profile, desiredWorkflows);
             this.displaySetupNotes(configuredTools);
             return;
         }
@@ -155,6 +155,7 @@ export class UpdateCommand {
         // 10. Update tools (all if force, otherwise only those needing update)
         const toolsToUpdate = this.force ? configuredTools : [...toolsToUpdateSet];
         const updatedTools = [];
+        const updatedToolIds = [];
         const failedTools = [];
         const skillsInvocableCommandSkips = [];
         const zeroArtifactTools = [];
@@ -223,6 +224,7 @@ export class UpdateCommand {
                 }
                 spinner.succeed(`Updated ${tool.name}`);
                 updatedTools.push(tool.name);
+                updatedToolIds.push(tool.value);
                 for (const migration of migrateLegacyToolDirs(resolvedProjectPath, [tool.value], 'after-generation')) {
                     if (hasMovableContent(migration)) {
                         console.log(chalk.dim(`Migrated ${describeLegacyMigration(migration)}: ${migration.from} → ${migration.to}`));
@@ -310,7 +312,7 @@ export class UpdateCommand {
         this.detectNewTools(resolvedProjectPath, configuredAndNewTools);
         // 14. Display note about extra workflows not in profile
         this.displayExtraWorkflowsNote(resolvedProjectPath, configuredAndNewTools, desiredWorkflows);
-        this.displayMissingCoreWorkflowsNote(profile, globalConfig.workflows);
+        this.displayMissingCoreWorkflowsNote(profile, desiredWorkflows);
         this.displaySetupNotes(configuredAndNewTools);
         // 15. List affected tools
         if (updatedTools.length > 0) {
@@ -318,7 +320,16 @@ export class UpdateCommand {
             console.log(chalk.dim(`Tools: ${toolDisplayNames.join(', ')}`));
         }
         console.log();
-        console.log(chalk.dim('Restart your IDE for changes to take effect.'));
+        const affectedToolIds = [...new Set([...newlyConfiguredTools, ...updatedToolIds])];
+        const shouldRestartIde = affectedToolIds.some((toolId) => {
+            const tool = AI_TOOLS.find((candidate) => candidate.value === toolId);
+            return Boolean(tool?.requiresIdeRestart &&
+                (shouldGenerateCommandsForTool(toolId, delivery) ||
+                    shouldGenerateSkillsForTool(toolId, delivery)));
+        });
+        if (shouldRestartIde) {
+            console.log(chalk.dim('Restart your IDE for changes to take effect.'));
+        }
         if (failedTools.length > 0) {
             throw new Error(`OpenSpec update failed for: ${failedTools.map((tool) => tool.name).join(', ')}`);
         }
@@ -787,7 +798,7 @@ export class UpdateCommand {
                 return { newlyConfiguredTools: [], workflowOverrides: {} };
             }
         }
-        const inferredCodexWorkflows = getLegacyWorkflowIdsForTool(detection, 'codex');
+        const inferredCodexWorkflows = getProfileWorkflows('custom', getLegacyWorkflowIdsForTool(detection, 'codex')).filter((workflow) => ALL_WORKFLOWS.includes(workflow));
         // Create skills/commands for selected tools using effective profile+delivery.
         const newlyConfigured = [];
         const skippedSharedSkillTools = [];

package/dist/telemetry/index.js

@@ -174,8 +174,9 @@ export async function maybeShowTelemetryNotice(options = {}) {
         if (options.silent) {
             return;
         }
-        // Display notice
-        console.log('Note: OpenSpec collects anonymous usage stats. Opt out: OPENSPEC_TELEMETRY=0 or openspec config set telemetry.enabled false');
+        // Display notice on stderr, not stdout: stdout is reserved for command
+        // output (raw passthrough text, JSON, etc.) and must stay parser/pipe-safe.
+        console.error('Note: OpenSpec collects anonymous usage stats. Opt out: OPENSPEC_TELEMETRY=0 or openspec config set telemetry.enabled false');
         // Mark as seen
         await updateTelemetryConfig({ noticeSeen: true });
     }

package/dist/utils/change-metadata.js

@@ -179,6 +179,18 @@ export function readRetireCapabilitiesMarker(changeDir) {
  * name. One body rather than two, so a marker can never drift into honoring
  * metadata the other rejects - the whole point of the contract described above.
  */
+/**
+ * A marker that cannot be honored, with its reason made safe to print.
+ *
+ * Every reason quotes something the author wrote - a schema name, a parser
+ * message carrying one, a filesystem error carrying a path - and callers print
+ * it straight to a terminal (`openspec archive`, `openspec validate`). A raw CR
+ * could forge a line of its own and an ESC could redraw the screen, so control
+ * characters never leave this function.
+ */
+function unhonorable(reason) {
+    return { declared: false, invalidReason: reason.replace(/[\u0000-\u001f\u007f]/g, '?') };
+}
 function readBooleanMarker(changeDir, key) {
     let raw;
     try {
@@ -193,10 +205,7 @@ function readBooleanMarker(changeDir, key) {
         // set cannot be determined - fail closed rather than let archive treat
         // the change as unmarked while every metadata-reading surface errors.
         const message = err instanceof Error ? err.message : String(err);
-        return {
-            declared: false,
-            invalidReason: `the metadata file cannot be read (${message})`,
-        };
+        return unhonorable(`the metadata file cannot be read (${message})`);
     }
     let parsed;
     try {
@@ -206,9 +215,7 @@ function readBooleanMarker(changeDir, key) {
         // Anchored so a comment like "# maybe add skip_specs later" does not
         // claim the marker was set.
         const mentioned = new RegExp(`^\\s*(['"]?)${key}\\1\\s*:`, 'm').test(raw);
-        return mentioned
-            ? { declared: false, invalidReason: 'the file is not valid YAML' }
-            : { declared: false };
+        return mentioned ? unhonorable('the file is not valid YAML') : { declared: false };
     }
     const result = ChangeMetadataSchema.safeParse(parsed);
     if (result.success) {
@@ -225,16 +232,13 @@ function readBooleanMarker(changeDir, key) {
         try {
             const projectRoot = path.resolve(changeDir, '../../..');
             if (!listSchemas(projectRoot).includes(result.data.schema)) {
-                return {
-                    declared: false,
-                    invalidReason: `schema: unknown schema '${result.data.schema}'`,
-                };
+                return unhonorable(`schema: unknown schema '${result.data.schema}'`);
             }
             resolveSchema(result.data.schema, projectRoot);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            return { declared: false, invalidReason: message };
+            return unhonorable(message);
         }
         return { declared: true };
     }
@@ -250,7 +254,7 @@ function readBooleanMarker(changeDir, key) {
     if (markerMentioned) {
         const first = result.error.issues[0];
         const where = first.path.length > 0 ? `${first.path.join('.')}: ` : '';
-        return { declared: false, invalidReason: `${where}${first.message}` };
+        return unhonorable(`${where}${first.message}`);
     }
     return { declared: false };
 }

package/dist/utils/change-utils.js

@@ -4,6 +4,8 @@ import { writeChangeMetadata, validateSchemaName } from './change-metadata.js';
 import { formatLocalDate } from './date.js';
 import { readProjectConfig } from '../core/project-config.js';
 import { isKebabId } from '../core/id.js';
+import { resolveSchema } from '../core/artifact-graph/resolver.js';
+import { isSpecsArtifactPath } from '../core/artifact-graph/outputs.js';
 const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Validates that a change name follows kebab-case conventions.
@@ -117,6 +119,8 @@ export async function createChange(projectRoot, name, options = {}) {
     if (await FileSystemUtils.directoryExists(changeDir)) {
         throw new Error(`Change '${name}' already exists at ${changeDir}`);
     }
+    const schema = resolveSchema(schemaName, projectRoot);
+    const skipsSpecs = !schema.artifacts.some(artifact => isSpecsArtifactPath(artifact.generates));
     // Creating a change may scaffold or complete the root itself (an
     // implicit root, or a config-only/incomplete clone). Never leave a
     // half-root behind that doctor immediately calls unhealthy: ensure
@@ -138,6 +142,7 @@ export async function createChange(projectRoot, name, options = {}) {
     writeChangeMetadata(changeDir, {
         schema: schemaName,
         created: formatLocalDate(),
+        ...(skipsSpecs ? { skip_specs: true } : {}),
         ...options.metadata,
     }, projectRoot);
     return { schema: schemaName, changeDir };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -33,7 +33,6 @@
     "dist",
     "bin",
     "schemas",
-    "scripts/postinstall.js",
     "!dist/**/*.test.js",
     "!dist/**/__tests__",
     "!dist/**/*.map"
@@ -53,8 +52,8 @@
     "vitest": "^3.2.6"
   },
   "dependencies": {
-    "@inquirer/core": "^10.3.2",
-    "@inquirer/prompts": "^7.10.1",
+    "@inquirer/core": "^11.2.1",
+    "@inquirer/prompts": "^8.5.2",
     "chalk": "^5.6.2",
     "commander": "^14.0.0",
     "cross-spawn": "7.0.6",
@@ -74,8 +73,6 @@
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --coverage",
-    "test:postinstall": "node scripts/postinstall.js",
-    "postinstall": "node scripts/postinstall.js",
     "check:pack-version": "node scripts/pack-version-check.mjs",
     "release": "pnpm run release:ci",
     "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",