@codewalla_india/openspec 1.3.1 → 1.3.2

package/dist/core/completions/command-registry.js

@@ -22,6 +22,18 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
                 values: ['core', 'custom'],
             },
+            {
+                name: 'no-animation',
+                description: 'Show a static welcome screen instead of the animated one',
+            },
+            {
+                name: 'copilot-cloud',
+                description: 'Generate GitHub Copilot cloud coding-agent files (opt-in; default: prompt)',
+            },
+            {
+                name: 'no-copilot-cloud',
+                description: 'Skip generating GitHub Copilot cloud coding-agent files',
+            },
         ],
     },
     {
@@ -62,7 +74,9 @@ export const COMMAND_REGISTRY = [
     {
         name: 'view',
         description: 'Display an interactive dashboard of specs and changes',
-        flags: [],
+        flags: [
+            COMMON_FLAGS.store,
+        ],
     },
     {
         name: 'validate',
@@ -177,7 +191,7 @@ export const COMMAND_REGISTRY = [
     },
     {
         name: 'instructions',
-        description: 'Output enriched instructions for creating an artifact or applying tasks',
+        description: 'Output enriched instructions for artifacts, apply, or archive',
         acceptsPositional: true,
         positionals: [{ name: 'artifact', optional: true }],
         flags: [
@@ -191,45 +205,6 @@ export const COMMAND_REGISTRY = [
                 description: 'Schema override',
                 takesValue: true,
             },
-            {
-                name: 'record-comprehension-pass',
-                description: 'Record a successful comprehension quiz pass (use with instructions apply)',
-            },
-            {
-                name: 'score',
-                description: 'Quiz score 0-100 (required with --record-comprehension-pass)',
-                takesValue: true,
-            },
-            {
-                name: 'attempt',
-                description: 'Quiz attempt number',
-                takesValue: true,
-            },
-            {
-                name: 'question-count',
-                description: 'Number of quiz questions taken',
-                takesValue: true,
-            },
-            {
-                name: 'artifact',
-                description: 'Source artifact to modify (use with: instructions modify)',
-                takesValue: true,
-            },
-            {
-                name: 'workflow-input',
-                description: 'User modify request for telemetry (use with: instructions modify)',
-                takesValue: true,
-            },
-            {
-                name: 'workflow-input-file',
-                description: 'Read modify request from a file (use with: instructions modify)',
-                takesValue: true,
-            },
-            {
-                name: 'editor',
-                description: 'AI editor used (cursor, windsurf, claude)',
-                takesValue: true,
-            },
             COMMON_FLAGS.json,
             COMMON_FLAGS.store,
         ],
@@ -279,26 +254,6 @@ export const COMMAND_REGISTRY = [
                         description: 'Workflow schema to use',
                         takesValue: true,
                     },
-                    {
-                        name: 'entry-point',
-                        description: 'Workflow entry point (propose, new, ff, manual)',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'workflow-input',
-                        description: 'User workflow intent for telemetry',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'workflow-input-file',
-                        description: 'Read workflow intent from a file for telemetry',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'editor',
-                        description: 'AI editor used (cursor, windsurf, claude)',
-                        takesValue: true,
-                    },
                     COMMON_FLAGS.json,
                     COMMON_FLAGS.store,
                 ],

package/dist/core/completions/generators/bash-generator.js

@@ -25,47 +25,47 @@ export class BashGenerator {
         // Dynamic completion helpers from template
         const helpers = BASH_DYNAMIC_HELPERS;
         // Assemble final script with template literal
-        return `# Bash completion script for OpenSpec CLI
-# Auto-generated - do not edit manually
-
-_openspec_completion() {
-  local cur prev words cword
-
-  # Use _init_completion if available (from bash-completion package)
-  # The -n : option prevents colons from being treated as word separators
-  # (important for spec/change IDs that may contain colons)
-  # Otherwise, fall back to manual initialization
-  if declare -F _init_completion >/dev/null 2>&1; then
-    _init_completion -n : || return
-  else
-    # Manual fallback when bash-completion is not installed
-    COMPREPLY=()
-    cur="\${COMP_WORDS[COMP_CWORD]}"
-    prev="\${COMP_WORDS[COMP_CWORD-1]}"
-    words=("\${COMP_WORDS[@]}")
-    cword=$COMP_CWORD
-  fi
-
-  local cmd="\${words[1]}"
-  local subcmd="\${words[2]}"
-
-  # Top-level commands
-  if [[ $cword -eq 1 ]]; then
-    local commands="${commandList}"
-    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
-    return 0
-  fi
-
-  # Command-specific completion
-  case "$cmd" in
-${commandCases}
-  esac
-
-  return 0
-}
-
-${helpers}
-complete -F _openspec_completion openspec
+        return `# Bash completion script for OpenSpec CLI
+# Auto-generated - do not edit manually
+
+_openspec_completion() {
+  local cur prev words cword
+
+  # Use _init_completion if available (from bash-completion package)
+  # The -n : option prevents colons from being treated as word separators
+  # (important for spec/change IDs that may contain colons)
+  # Otherwise, fall back to manual initialization
+  if declare -F _init_completion >/dev/null 2>&1; then
+    _init_completion -n : || return
+  else
+    # Manual fallback when bash-completion is not installed
+    COMPREPLY=()
+    cur="\${COMP_WORDS[COMP_CWORD]}"
+    prev="\${COMP_WORDS[COMP_CWORD-1]}"
+    words=("\${COMP_WORDS[@]}")
+    cword=$COMP_CWORD
+  fi
+
+  local cmd="\${words[1]}"
+  local subcmd="\${words[2]}"
+
+  # Top-level commands
+  if [[ $cword -eq 1 ]]; then
+    local commands="${commandList}"
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+    return 0
+  fi
+
+  # Command-specific completion
+  case "$cmd" in
+${commandCases}
+  esac
+
+  return 0
+}
+
+${helpers}
+complete -F _openspec_completion openspec
 `;
     }
     /**

package/dist/core/completions/generators/fish-generator.js

@@ -31,13 +31,13 @@ export class FishGenerator {
         // Dynamic completion helpers from template
         const dynamicHelpers = FISH_DYNAMIC_HELPERS;
         // Assemble final script with template literal
-        return `# Fish completion script for OpenSpec CLI
-# Auto-generated - do not edit manually
-
-${helperFunctions}
-${dynamicHelpers}
-${topLevelCommands}
-
+        return `# Fish completion script for OpenSpec CLI
+# Auto-generated - do not edit manually
+
+${helperFunctions}
+${dynamicHelpers}
+${topLevelCommands}
+
 ${commandCompletions}`;
     }
     /**

package/dist/core/completions/generators/powershell-generator.js

@@ -35,35 +35,35 @@ export class PowerShellGenerator {
         // Dynamic completion helpers from template
         const helpers = POWERSHELL_DYNAMIC_HELPERS;
         // Assemble final script with template literal
-        return `# PowerShell completion script for OpenSpec CLI
-# Auto-generated - do not edit manually
-
-${helpers}
-$openspecCompleter = {
-    param($wordToComplete, $commandAst, $cursorPosition)
-
-    $tokens = $commandAst.ToString() -split "\\s+"
-    $commandCount = ($tokens | Measure-Object).Count
-
-    # Top-level commands
-    if ($commandCount -eq 1 -or ($commandCount -eq 2 -and $wordToComplete)) {
-        $commands = @(
-${topLevelCommands}
-        )
-        $commands | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
-            [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterValue", $_.Description)
-        }
-        return
-    }
-
-    $command = $tokens[1]
-
-    switch ($command) {
-${commandCases}
-    }
-}
-
-Register-ArgumentCompleter -CommandName openspec -ScriptBlock $openspecCompleter
+        return `# PowerShell completion script for OpenSpec CLI
+# Auto-generated - do not edit manually
+
+${helpers}
+$openspecCompleter = {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $tokens = $commandAst.ToString() -split "\\s+"
+    $commandCount = ($tokens | Measure-Object).Count
+
+    # Top-level commands
+    if ($commandCount -eq 1 -or ($commandCount -eq 2 -and $wordToComplete)) {
+        $commands = @(
+${topLevelCommands}
+        )
+        $commands | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_.Name, $_.Name, "ParameterValue", $_.Description)
+        }
+        return
+    }
+
+    $command = $tokens[1]
+
+    switch ($command) {
+${commandCases}
+    }
+}
+
+Register-ArgumentCompleter -CommandName openspec -ScriptBlock $openspecCompleter
 `;
     }
     /**
@@ -164,6 +164,20 @@ Register-ArgumentCompleter -CommandName openspec -ScriptBlock $openspecCompleter
         return lines;
     }
     generateIndexedPositionalCompletion(positionals, flags, firstPositionalTokenIndex, indent) {
+        const caseLines = [];
+        for (const [index, positional] of positionals.entries()) {
+            const completion = this.generatePositionalCompletion(positional.type, indent + '    ');
+            if (completion.length === 0)
+                continue;
+            caseLines.push(`${indent}    ${index} {`);
+            caseLines.push(...completion);
+            caseLines.push(`${indent}    }`);
+        }
+        // A switch with no clauses is a PowerShell parse error, so when no
+        // positional produces completions skip the whole block (it would only
+        // feed the empty switch anyway).
+        if (caseLines.length === 0)
+            return [];
         const lines = [];
         const valueFlags = this.generateValueFlags(flags);
         if (valueFlags.length > 0) {
@@ -192,14 +206,7 @@ Register-ArgumentCompleter -CommandName openspec -ScriptBlock $openspecCompleter
         lines.push(`${indent}}`);
         lines.push('');
         lines.push(`${indent}switch ($positionalIndex) {`);
-        for (const [index, positional] of positionals.entries()) {
-            const completion = this.generatePositionalCompletion(positional.type, indent + '    ');
-            if (completion.length === 0)
-                continue;
-            lines.push(`${indent}    ${index} {`);
-            lines.push(...completion);
-            lines.push(`${indent}    }`);
-        }
+        lines.push(...caseLines);
         lines.push(`${indent}}`);
         return lines;
     }

package/dist/core/completions/generators/zsh-generator.js

@@ -37,39 +37,39 @@ export class ZshGenerator {
         // Dynamic completion helpers from template
         const helpers = ZSH_DYNAMIC_HELPERS;
         // Assemble final script with template literal
-        return `#compdef openspec
-
-# Zsh completion script for OpenSpec CLI
-# Auto-generated - do not edit manually
-
-_openspec() {
-  local context state line
-  typeset -A opt_args
-
-  local -a commands
-  commands=(
-${commandList}
-  )
-
-  _arguments -C \\
-    "1: :->command" \\
-    "*::arg:->args"
-
-  case $state in
-    command)
-      _describe "openspec command" commands
-      ;;
-    args)
-      case $words[1] in
-${commandCases}
-      esac
-      ;;
-  esac
-}
-
-${commandFunctions}
-${helpers}
-compdef _openspec openspec
+        return `#compdef openspec
+
+# Zsh completion script for OpenSpec CLI
+# Auto-generated - do not edit manually
+
+_openspec() {
+  local context state line
+  typeset -A opt_args
+
+  local -a commands
+  commands=(
+${commandList}
+  )
+
+  _arguments -C \\
+    "1: :->command" \\
+    "*::arg:->args"
+
+  case $state in
+    command)
+      _describe "openspec command" commands
+      ;;
+    args)
+      case $words[1] in
+${commandCases}
+      esac
+      ;;
+  esac
+}
+
+${commandFunctions}
+${helpers}
+compdef _openspec openspec
 `;
     }
     /**

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

@@ -16,6 +16,15 @@ export declare class ZshInstaller {
      * @returns true if Oh My Zsh is detected via $ZSH env var or directory exists
      */
     isOhMyZshInstalled(): Promise<boolean>;
+    /**
+     * Oh My Zsh exports its root as $ZSH; honor a custom location, or the
+     * completion lands in a ~/.oh-my-zsh tree that nothing ever loads.
+     */
+    private ohMyZshRoot;
+    /**
+     * The custom dir is separately relocatable via $ZSH_CUSTOM.
+     */
+    private ohMyZshCustomDir;
     /**
      * Get the appropriate installation path for the completion script
      *

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

@@ -29,15 +29,27 @@ export class ZshInstaller {
             return true;
         }
         // Fall back to checking for ~/.oh-my-zsh directory
-        const ohMyZshPath = path.join(this.homeDir, '.oh-my-zsh');
         try {
-            const stat = await fs.stat(ohMyZshPath);
+            const stat = await fs.stat(this.ohMyZshRoot());
             return stat.isDirectory();
         }
         catch {
             return false;
         }
     }
+    /**
+     * Oh My Zsh exports its root as $ZSH; honor a custom location, or the
+     * completion lands in a ~/.oh-my-zsh tree that nothing ever loads.
+     */
+    ohMyZshRoot() {
+        return process.env.ZSH || path.join(this.homeDir, '.oh-my-zsh');
+    }
+    /**
+     * The custom dir is separately relocatable via $ZSH_CUSTOM.
+     */
+    ohMyZshCustomDir() {
+        return process.env.ZSH_CUSTOM || path.join(this.ohMyZshRoot(), 'custom');
+    }
     /**
      * Get the appropriate installation path for the completion script
      *
@@ -48,7 +60,7 @@ export class ZshInstaller {
         if (isOhMyZsh) {
             // Oh My Zsh custom completions directory
             return {
-                path: path.join(this.homeDir, '.oh-my-zsh', 'custom', 'completions', '_openspec'),
+                path: path.join(this.ohMyZshCustomDir(), 'completions', '_openspec'),
                 isOhMyZsh: true,
             };
         }
@@ -292,10 +304,14 @@ export class ZshInstaller {
      * @returns Array of guidance strings, or undefined if not needed
      */
     generateOhMyZshFpathGuidance(completionsDir) {
+        // One fpath entry per line, matched as a literal: a relocated $ZSH_CUSTOM
+        // need not contain "custom/completions", and the path may hold characters
+        // grep would otherwise read as a pattern. Single-quoted for the shell.
+        const quotedDir = `'${completionsDir.replace(/'/g, `'\\''`)}'`;
         return [
             'Note: Oh My Zsh typically auto-loads completions from custom/completions.',
             `Verify that ${completionsDir} is in your fpath by running:`,
-            '  echo $fpath | grep "custom/completions"',
+            `  printf '%s\\n' $fpath | grep -F ${quotedDir}`,
             '',
             'If not found, completions may not work. Restart your shell to ensure changes take effect.',
         ];

package/dist/core/completions/templates/bash-templates.js

@@ -2,29 +2,29 @@
  * Static template strings for Bash completion scripts.
  * These are Bash-specific helper functions that never change.
  */
-export const BASH_DYNAMIC_HELPERS = `# Dynamic completion helpers
-
-_openspec_complete_changes() {
-  local changes
-  changes=$(openspec __complete changes 2>/dev/null | cut -f1)
-  COMPREPLY=($(compgen -W "$changes" -- "$cur"))
-}
-
-_openspec_complete_specs() {
-  local specs
-  specs=$(openspec __complete specs 2>/dev/null | cut -f1)
-  COMPREPLY=($(compgen -W "$specs" -- "$cur"))
-}
-
-_openspec_complete_items() {
-  local items
-  items=$(openspec __complete changes 2>/dev/null | cut -f1; openspec __complete specs 2>/dev/null | cut -f1)
-  COMPREPLY=($(compgen -W "$items" -- "$cur"))
-}
-
-_openspec_complete_schemas() {
-  local schemas
-  schemas=$(openspec __complete schemas 2>/dev/null | cut -f1)
-  COMPREPLY=($(compgen -W "$schemas" -- "$cur"))
+export const BASH_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+_openspec_complete_changes() {
+  local changes
+  changes=$(openspec __complete changes 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$changes" -- "$cur"))
+}
+
+_openspec_complete_specs() {
+  local specs
+  specs=$(openspec __complete specs 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$specs" -- "$cur"))
+}
+
+_openspec_complete_items() {
+  local items
+  items=$(openspec __complete changes 2>/dev/null | cut -f1; openspec __complete specs 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$items" -- "$cur"))
+}
+
+_openspec_complete_schemas() {
+  local schemas
+  schemas=$(openspec __complete schemas 2>/dev/null | cut -f1)
+  COMPREPLY=($(compgen -W "$schemas" -- "$cur"))
 }`;
 //# sourceMappingURL=bash-templates.js.map

package/dist/core/completions/templates/fish-templates.js

@@ -2,44 +2,44 @@
  * Static template strings for Fish completion scripts.
  * These are Fish-specific helper functions that never change.
  */
-export const FISH_STATIC_HELPERS = `# Helper function to check if a subcommand is present
-function __fish_openspec_using_subcommand
-    set -l cmd (commandline -opc)
-    set -e cmd[1]
-    for i in $argv
-        if contains -- $i $cmd
-            return 0
-        end
-    end
-    return 1
-end
-
-function __fish_openspec_no_subcommand
-    set -l cmd (commandline -opc)
-    test (count $cmd) -eq 1
+export const FISH_STATIC_HELPERS = `# Helper function to check if a subcommand is present
+function __fish_openspec_using_subcommand
+    set -l cmd (commandline -opc)
+    set -e cmd[1]
+    for i in $argv
+        if contains -- $i $cmd
+            return 0
+        end
+    end
+    return 1
+end
+
+function __fish_openspec_no_subcommand
+    set -l cmd (commandline -opc)
+    test (count $cmd) -eq 1
 end`;
-export const FISH_DYNAMIC_HELPERS = `# Dynamic completion helpers
-
-function __fish_openspec_changes
-    openspec __complete changes 2>/dev/null | while read -l id desc
-        printf '%s\\t%s\\n' "$id" "$desc"
-    end
-end
-
-function __fish_openspec_specs
-    openspec __complete specs 2>/dev/null | while read -l id desc
-        printf '%s\\t%s\\n' "$id" "$desc"
-    end
-end
-
-function __fish_openspec_items
-    __fish_openspec_changes
-    __fish_openspec_specs
-end
-
-function __fish_openspec_schemas
-    openspec __complete schemas 2>/dev/null | while read -l id desc
-        printf '%s\\t%s\\n' "$id" "$desc"
-    end
+export const FISH_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+function __fish_openspec_changes
+    openspec __complete changes 2>/dev/null | while read -l id desc
+        printf '%s\\t%s\\n' "$id" "$desc"
+    end
+end
+
+function __fish_openspec_specs
+    openspec __complete specs 2>/dev/null | while read -l id desc
+        printf '%s\\t%s\\n' "$id" "$desc"
+    end
+end
+
+function __fish_openspec_items
+    __fish_openspec_changes
+    __fish_openspec_specs
+end
+
+function __fish_openspec_schemas
+    openspec __complete schemas 2>/dev/null | while read -l id desc
+        printf '%s\\t%s\\n' "$id" "$desc"
+    end
 end`;
 //# sourceMappingURL=fish-templates.js.map

package/dist/core/completions/templates/powershell-templates.js

@@ -2,33 +2,33 @@
  * Static template strings for PowerShell completion scripts.
  * These are PowerShell-specific helper functions that never change.
  */
-export const POWERSHELL_DYNAMIC_HELPERS = `# Dynamic completion helpers
-
-function Get-OpenSpecChanges {
-    $output = openspec __complete changes 2>$null
-    if ($output) {
-        $output | ForEach-Object {
-            ($_ -split "\\t")[0]
-        }
-    }
-}
-
-function Get-OpenSpecSpecs {
-    $output = openspec __complete specs 2>$null
-    if ($output) {
-        $output | ForEach-Object {
-            ($_ -split "\\t")[0]
-        }
-    }
-}
-
-function Get-OpenSpecSchemas {
-    $output = openspec __complete schemas 2>$null
-    if ($output) {
-        $output | ForEach-Object {
-            ($_ -split "\\t")[0]
-        }
-    }
-}
+export const POWERSHELL_DYNAMIC_HELPERS = `# Dynamic completion helpers
+
+function Get-OpenSpecChanges {
+    $output = openspec __complete changes 2>$null
+    if ($output) {
+        $output | ForEach-Object {
+            ($_ -split "\\t")[0]
+        }
+    }
+}
+
+function Get-OpenSpecSpecs {
+    $output = openspec __complete specs 2>$null
+    if ($output) {
+        $output | ForEach-Object {
+            ($_ -split "\\t")[0]
+        }
+    }
+}
+
+function Get-OpenSpecSchemas {
+    $output = openspec __complete schemas 2>$null
+    if ($output) {
+        $output | ForEach-Object {
+            ($_ -split "\\t")[0]
+        }
+    }
+}
 `;
 //# sourceMappingURL=powershell-templates.js.map