@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

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

@@ -1,6 +1,6 @@
 import { FISH_STATIC_HELPERS, FISH_DYNAMIC_HELPERS } from '../templates/fish-templates.js';
 /**
- * Generates Fish completion scripts for the OpenSpec CLI.
+ * Generates Fish completion scripts for the CodeSDD CLI.
  * Follows Fish completion conventions using the complete command.
  */
 export class FishGenerator {
@@ -16,7 +16,7 @@ export class FishGenerator {
         const topLevelLines = [];
         for (const cmd of commands) {
             topLevelLines.push(`# ${cmd.name} command`);
-            topLevelLines.push(`complete -c opensdd -n '__fish_openspec_no_subcommand' -a '${cmd.name}' -d '${this.escapeDescription(cmd.description)}'`);
+            topLevelLines.push(`complete -c codesdd -n '__fish_codesdd_no_subcommand' -a '${cmd.name}' -d '${this.escapeDescription(cmd.description)}'`);
         }
         const topLevelCommands = topLevelLines.join('\n');
         // Build command-specific completions using push() for loop clarity
@@ -31,7 +31,7 @@ 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
+        return `# Fish completion script for CodeSDD CLI
 # Auto-generated - do not edit manually
 
 ${helperFunctions}
@@ -44,43 +44,54 @@ ${commandCompletions}`;
      * Generate completions for a specific command
      */
     generateCommandCompletions(cmd) {
+        return this.generateNodeCompletions(cmd, [cmd.name]);
+    }
+    /**
+     * Generate completions for a command path at any depth.
+     */
+    generateNodeCompletions(cmd, path) {
         const lines = [];
+        const pathCondition = this.generatePathCondition(path);
         // If command has subcommands
         if (cmd.subcommands && cmd.subcommands.length > 0) {
             // Add subcommand completions
+            const childExclusion = cmd.subcommands
+                .map((subcmd) => `not __fish_codesdd_using_subcommand ${subcmd.name}`)
+                .join('; and ');
+            const subcommandCondition = `${pathCondition}; and ${childExclusion}`;
             for (const subcmd of cmd.subcommands) {
-                lines.push(`complete -c opensdd -n '__fish_openspec_using_subcommand ${cmd.name}; and not __fish_openspec_using_subcommand ${subcmd.name}' -a '${subcmd.name}' -d '${this.escapeDescription(subcmd.description)}'`);
+                lines.push(`complete -c codesdd -n '${subcommandCondition}' -a '${subcmd.name}' -d '${this.escapeDescription(subcmd.description)}'`);
             }
             lines.push('');
             // Add flags for parent command
             for (const flag of cmd.flags) {
-                lines.push(...this.generateFlagCompletion(flag, `__fish_openspec_using_subcommand ${cmd.name}`));
+                lines.push(...this.generateFlagCompletion(flag, pathCondition));
             }
             // Add completions for each subcommand
             for (const subcmd of cmd.subcommands) {
-                lines.push(`# ${cmd.name} ${subcmd.name} flags`);
-                for (const flag of subcmd.flags) {
-                    lines.push(...this.generateFlagCompletion(flag, `__fish_openspec_using_subcommand ${cmd.name}; and __fish_openspec_using_subcommand ${subcmd.name}`));
-                }
-                // Add positional completions for subcommand
-                if (subcmd.acceptsPositional) {
-                    lines.push(...this.generatePositionalCompletion(subcmd.positionalType, `__fish_openspec_using_subcommand ${cmd.name}; and __fish_openspec_using_subcommand ${subcmd.name}`));
-                }
+                lines.push(`# ${[...path, subcmd.name].join(' ')} completions`);
+                lines.push(...this.generateNodeCompletions(subcmd, [...path, subcmd.name]));
             }
         }
         else {
             // Command without subcommands
             lines.push(`# ${cmd.name} flags`);
             for (const flag of cmd.flags) {
-                lines.push(...this.generateFlagCompletion(flag, `__fish_openspec_using_subcommand ${cmd.name}`));
+                lines.push(...this.generateFlagCompletion(flag, pathCondition));
             }
             // Add positional completions
             if (cmd.acceptsPositional) {
-                lines.push(...this.generatePositionalCompletion(cmd.positionalType, `__fish_openspec_using_subcommand ${cmd.name}`));
+                lines.push(...this.generatePositionalCompletion(cmd.positionalType, pathCondition));
             }
         }
         return lines;
     }
+    /**
+     * Generate a Fish condition that checks every command segment in a path.
+     */
+    generatePathCondition(path) {
+        return path.map((segment) => `__fish_codesdd_using_subcommand ${segment}`).join('; and ');
+    }
     /**
      * Generate flag completion
      */
@@ -92,29 +103,29 @@ ${commandCompletions}`;
             // Flag with enum values
             for (const value of flag.values) {
                 if (shortFlag) {
-                    lines.push(`complete -c opensdd -n '${condition}' -s ${flag.short} -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`);
+                    lines.push(`complete -c codesdd -n '${condition}' -s ${flag.short} -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`);
                 }
                 else {
-                    lines.push(`complete -c opensdd -n '${condition}' -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`);
+                    lines.push(`complete -c codesdd -n '${condition}' -l ${flag.name} -a '${value}' -d '${this.escapeDescription(flag.description)}'`);
                 }
             }
         }
         else if (flag.takesValue) {
             // Flag that takes a value but no specific values defined
             if (shortFlag) {
-                lines.push(`complete -c opensdd -n '${condition}' -s ${flag.short} -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`);
+                lines.push(`complete -c codesdd -n '${condition}' -s ${flag.short} -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`);
             }
             else {
-                lines.push(`complete -c opensdd -n '${condition}' -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`);
+                lines.push(`complete -c codesdd -n '${condition}' -l ${flag.name} -r -d '${this.escapeDescription(flag.description)}'`);
             }
         }
         else {
             // Boolean flag
             if (shortFlag) {
-                lines.push(`complete -c opensdd -n '${condition}' -s ${flag.short} -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`);
+                lines.push(`complete -c codesdd -n '${condition}' -s ${flag.short} -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`);
             }
             else {
-                lines.push(`complete -c opensdd -n '${condition}' -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`);
+                lines.push(`complete -c codesdd -n '${condition}' -l ${flag.name} -d '${this.escapeDescription(flag.description)}'`);
             }
         }
         return lines;
@@ -126,20 +137,23 @@ ${commandCompletions}`;
         const lines = [];
         switch (positionalType) {
             case 'change-id':
-                lines.push(`complete -c opensdd -n '${condition}' -a '(__fish_openspec_changes)' -f`);
+                lines.push(`complete -c codesdd -n '${condition}' -a '(__fish_codesdd_changes)' -f`);
                 break;
             case 'spec-id':
-                lines.push(`complete -c opensdd -n '${condition}' -a '(__fish_openspec_specs)' -f`);
+                lines.push(`complete -c codesdd -n '${condition}' -a '(__fish_codesdd_specs)' -f`);
                 break;
             case 'change-or-spec-id':
-                lines.push(`complete -c opensdd -n '${condition}' -a '(__fish_openspec_items)' -f`);
+                lines.push(`complete -c codesdd -n '${condition}' -a '(__fish_codesdd_items)' -f`);
                 break;
             case 'shell':
-                lines.push(`complete -c opensdd -n '${condition}' -a 'zsh bash fish powershell' -f`);
+                lines.push(`complete -c codesdd -n '${condition}' -a 'zsh bash fish powershell' -f`);
                 break;
             case 'path':
                 // Fish automatically completes files, no need to specify
                 break;
+            case 'schema-name':
+                lines.push(`complete -c codesdd -n '${condition}' -a '(__fish_codesdd_schemas)' -f`);
+                break;
         }
         return lines;
     }

package/dist/core/completions/generators/powershell-generator.d.ts

@@ -1,6 +1,6 @@
 import { CompletionGenerator, CommandDefinition } from '../types.js';
 /**
- * Generates PowerShell completion scripts for the OpenSpec CLI.
+ * Generates PowerShell completion scripts for the CodeSDD CLI.
  * Uses Register-ArgumentCompleter for command completion.
  */
 export declare class PowerShellGenerator implements CompletionGenerator {

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

@@ -1,6 +1,6 @@
 import { POWERSHELL_DYNAMIC_HELPERS } from '../templates/powershell-templates.js';
 /**
- * Generates PowerShell completion scripts for the OpenSpec CLI.
+ * Generates PowerShell completion scripts for the CodeSDD CLI.
  * Uses Register-ArgumentCompleter for command completion.
  */
 export class PowerShellGenerator {
@@ -35,11 +35,11 @@ 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
+        return `# PowerShell completion script for CodeSDD CLI
 # Auto-generated - do not edit manually
 
 ${helpers}
-$openspecCompleter = {
+$codesddCompleter = {
     param($wordToComplete, $commandAst, $cursorPosition)
 
     $tokens = $commandAst.ToString() -split "\\s+"
@@ -63,13 +63,13 @@ ${commandCases}
     }
 }
 
-Register-ArgumentCompleter -CommandName opensdd -ScriptBlock $openspecCompleter
+Register-ArgumentCompleter -CommandName codesdd -ScriptBlock $codesddCompleter
 `;
     }
     /**
      * Generate completion case for a command
      */
-    generateCommandCase(cmd, indent) {
+    generateCommandCase(cmd, indent, depth = 2) {
         const lines = [];
         if (cmd.subcommands && cmd.subcommands.length > 0) {
             // First, check if user is typing a flag for the parent command
@@ -97,7 +97,7 @@ Register-ArgumentCompleter -CommandName opensdd -ScriptBlock $openspecCompleter
                 lines.push('');
             }
             // Handle subcommands
-            lines.push(`${indent}if ($commandCount -eq 2 -or ($commandCount -eq 3 -and $wordToComplete)) {`);
+            lines.push(`${indent}if ($commandCount -eq ${depth} -or ($commandCount -eq ${depth + 1} -and $wordToComplete)) {`);
             lines.push(`${indent}    $subcommands = @(`);
             for (const subcmd of cmd.subcommands) {
                 lines.push(`${indent}        @{Name="${subcmd.name}"; Description="${this.escapeDescription(subcmd.description)}"},`);
@@ -110,11 +110,16 @@ Register-ArgumentCompleter -CommandName opensdd -ScriptBlock $openspecCompleter
             lines.push(`${indent}    return`);
             lines.push(`${indent}}`);
             lines.push('');
-            lines.push(`${indent}$subcommand = if ($commandCount -gt 2) { $tokens[2] } else { "" }`);
+            lines.push(`${indent}$subcommand = if ($commandCount -gt ${depth}) { $tokens[${depth}] } else { "" }`);
             lines.push(`${indent}switch ($subcommand) {`);
             for (const subcmd of cmd.subcommands) {
                 lines.push(`${indent}    "${subcmd.name}" {`);
-                lines.push(...this.generateArgumentCompletion(subcmd, indent + '        '));
+                if (subcmd.subcommands && subcmd.subcommands.length > 0) {
+                    lines.push(...this.generateCommandCase(subcmd, indent + '        ', depth + 1));
+                }
+                else {
+                    lines.push(...this.generateArgumentCompletion(subcmd, indent + '        '));
+                }
                 lines.push(`${indent}    }`);
             }
             lines.push(`${indent}}`);
@@ -167,17 +172,17 @@ Register-ArgumentCompleter -CommandName opensdd -ScriptBlock $openspecCompleter
         const lines = [];
         switch (positionalType) {
             case 'change-id':
-                lines.push(`${indent}Get-OpenSpecChanges | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
+                lines.push(`${indent}Get-CodeSDDChanges | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
                 lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Change: $_")`);
                 lines.push(`${indent}}`);
                 break;
             case 'spec-id':
-                lines.push(`${indent}Get-OpenSpecSpecs | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
+                lines.push(`${indent}Get-CodeSDDSpecs | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
                 lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Spec: $_")`);
                 lines.push(`${indent}}`);
                 break;
             case 'change-or-spec-id':
-                lines.push(`${indent}$items = @(Get-OpenSpecChanges) + @(Get-OpenSpecSpecs)`);
+                lines.push(`${indent}$items = @(Get-CodeSDDChanges) + @(Get-CodeSDDSpecs)`);
                 lines.push(`${indent}$items | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
                 lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)`);
                 lines.push(`${indent}}`);
@@ -191,6 +196,11 @@ Register-ArgumentCompleter -CommandName opensdd -ScriptBlock $openspecCompleter
             case 'path':
                 // PowerShell handles file path completion automatically
                 break;
+            case 'schema-name':
+                lines.push(`${indent}Get-CodeSDDSchemas | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {`);
+                lines.push(`${indent}    [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", "Schema: $_")`);
+                lines.push(`${indent}}`);
+                break;
         }
         return lines;
     }

package/dist/core/completions/generators/zsh-generator.d.ts

@@ -1,7 +1,7 @@
 import { CompletionGenerator, CommandDefinition } from '../types.js';
 /**
- * Generates Zsh completion scripts for the OpenSpec CLI.
- * Follows Zsh completion system conventions using the _openspec function.
+ * Generates Zsh completion scripts for the CodeSDD CLI.
+ * Follows Zsh completion system conventions using the _codesdd function.
  */
 export declare class ZshGenerator implements CompletionGenerator {
     readonly shell: "zsh";
@@ -16,10 +16,6 @@ export declare class ZshGenerator implements CompletionGenerator {
      * Generate completion function for a specific command
      */
     private generateCommandFunction;
-    /**
-     * Generate completion function for a subcommand
-     */
-    private generateSubcommandFunction;
     /**
      * Generate flag specification for _arguments
      */
@@ -40,5 +36,6 @@ export declare class ZshGenerator implements CompletionGenerator {
      * Sanitize command names for use in function names
      */
     private sanitizeFunctionName;
+    private functionNameForPath;
 }
 //# sourceMappingURL=zsh-generator.d.ts.map

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

@@ -1,7 +1,7 @@
 import { ZSH_DYNAMIC_HELPERS } from '../templates/zsh-templates.js';
 /**
- * Generates Zsh completion scripts for the OpenSpec CLI.
- * Follows Zsh completion system conventions using the _openspec function.
+ * Generates Zsh completion scripts for the CodeSDD CLI.
+ * Follows Zsh completion system conventions using the _codesdd function.
  */
 export class ZshGenerator {
     shell = 'zsh';
@@ -23,26 +23,26 @@ export class ZshGenerator {
         const commandCaseLines = [];
         for (const cmd of commands) {
             commandCaseLines.push(`        ${cmd.name})`);
-            commandCaseLines.push(`          _openspec_${this.sanitizeFunctionName(cmd.name)}`);
+            commandCaseLines.push(`          _codesdd_${this.sanitizeFunctionName(cmd.name)}`);
             commandCaseLines.push('          ;;');
         }
         const commandCases = commandCaseLines.join('\n');
         // Build command functions using push() for loop clarity
         const commandFunctionLines = [];
         for (const cmd of commands) {
-            commandFunctionLines.push(...this.generateCommandFunction(cmd));
+            commandFunctionLines.push(...this.generateCommandFunction(cmd, [cmd.name]));
             commandFunctionLines.push('');
         }
         const commandFunctions = commandFunctionLines.join('\n');
         // Dynamic completion helpers from template
         const helpers = ZSH_DYNAMIC_HELPERS;
         // Assemble final script with template literal
-        return `#compdef openspec
+        return `#compdef codesdd
 
-# Zsh completion script for OpenSpec CLI
+# Zsh completion script for CodeSDD CLI
 # Auto-generated - do not edit manually
 
-_openspec() {
+_codesdd() {
   local context state line
   typeset -A opt_args
 
@@ -57,7 +57,7 @@ ${commandList}
 
   case $state in
     command)
-      _describe "openspec command" commands
+      _describe "codesdd command" commands
       ;;
     args)
       case $words[1] in
@@ -69,14 +69,14 @@ ${commandCases}
 
 ${commandFunctions}
 ${helpers}
-compdef _openspec opensdd
+compdef _codesdd codesdd
 `;
     }
     /**
      * Generate completion function for a specific command
      */
-    generateCommandFunction(cmd) {
-        const funcName = `_openspec_${this.sanitizeFunctionName(cmd.name)}`;
+    generateCommandFunction(cmd, path) {
+        const funcName = this.functionNameForPath(path);
         const lines = [];
         lines.push(`${funcName}() {`);
         // If command has subcommands, handle them
@@ -108,7 +108,7 @@ compdef _openspec opensdd
             lines.push('      case $words[1] in');
             for (const subcmd of cmd.subcommands) {
                 lines.push(`        ${subcmd.name})`);
-                lines.push(`          _openspec_${this.sanitizeFunctionName(cmd.name)}_${this.sanitizeFunctionName(subcmd.name)}`);
+                lines.push(`          ${this.functionNameForPath([...path, subcmd.name])}`);
                 lines.push('          ;;');
             }
             lines.push('      esac');
@@ -139,37 +139,11 @@ compdef _openspec opensdd
         if (cmd.subcommands) {
             for (const subcmd of cmd.subcommands) {
                 lines.push('');
-                lines.push(...this.generateSubcommandFunction(cmd.name, subcmd));
+                lines.push(...this.generateCommandFunction(subcmd, [...path, subcmd.name]));
             }
         }
         return lines;
     }
-    /**
-     * Generate completion function for a subcommand
-     */
-    generateSubcommandFunction(parentName, subcmd) {
-        const funcName = `_openspec_${this.sanitizeFunctionName(parentName)}_${this.sanitizeFunctionName(subcmd.name)}`;
-        const lines = [];
-        lines.push(`${funcName}() {`);
-        lines.push('  _arguments \\');
-        // Add flags
-        for (const flag of subcmd.flags) {
-            lines.push('    ' + this.generateFlagSpec(flag) + ' \\');
-        }
-        // Add positional argument completion
-        if (subcmd.acceptsPositional) {
-            const positionalSpec = this.generatePositionalSpec(subcmd.positionalType);
-            lines.push('    ' + positionalSpec);
-        }
-        else {
-            // Remove trailing backslash from last flag
-            if (lines[lines.length - 1].endsWith(' \\')) {
-                lines[lines.length - 1] = lines[lines.length - 1].slice(0, -2);
-            }
-        }
-        lines.push('}');
-        return lines;
-    }
     /**
      * Generate flag specification for _arguments
      */
@@ -207,15 +181,17 @@ compdef _openspec opensdd
     generatePositionalSpec(positionalType) {
         switch (positionalType) {
             case 'change-id':
-                return "'*: :_openspec_complete_changes'";
+                return "'*: :_codesdd_complete_changes'";
             case 'spec-id':
-                return "'*: :_openspec_complete_specs'";
+                return "'*: :_codesdd_complete_specs'";
             case 'change-or-spec-id':
-                return "'*: :_openspec_complete_items'";
+                return "'*: :_codesdd_complete_items'";
             case 'path':
                 return "'*:path:_files'";
             case 'shell':
                 return "'*:shell:(zsh bash fish powershell)'";
+            case 'schema-name':
+                return "'*: :_codesdd_complete_schemas'";
             default:
                 return "'*: :_default'";
         }
@@ -246,5 +222,8 @@ compdef _openspec opensdd
     sanitizeFunctionName(name) {
         return name.replace(/-/g, '_');
     }
+    functionNameForPath(path) {
+        return `_codesdd_${path.map((segment) => this.sanitizeFunctionName(segment)).join('_')}`;
+    }
 }
 //# sourceMappingURL=zsh-generator.js.map

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

@@ -12,8 +12,8 @@ export class BashInstaller {
      * Markers for .bashrc configuration management
      */
     BASHRC_MARKERS = {
-        start: '# OPENSPEC:START',
-        end: '# OPENSPEC:END',
+        start: '# CODESDD:START',
+        end: '# CODESDD:END',
     };
     constructor(homeDir = os.homedir()) {
         this.homeDir = homeDir;
@@ -53,7 +53,7 @@ export class BashInstaller {
         // Try user-local bash-completion directory first
         const localCompletionDir = path.join(this.homeDir, '.local', 'share', 'bash-completion', 'completions');
         // For user installation, use local directory
-        return path.join(localCompletionDir, 'openspec');
+        return path.join(localCompletionDir, 'codesdd');
     }
     /**
      * Backup an existing completion file if it exists
@@ -91,7 +91,7 @@ export class BashInstaller {
      */
     generateBashrcConfig(completionsDir) {
         return [
-            '# OpenSpec shell completions configuration',
+            '# CodeSDD shell completions configuration',
             `if [ -d "${completionsDir}" ]; then`,
             `  for f in "${completionsDir}"/*; do`,
             '    [ -f "$f" ] && . "$f"',
@@ -107,7 +107,7 @@ export class BashInstaller {
      */
     async configureBashrc(completionsDir) {
         // Check if auto-configuration is disabled
-        if (process.env.OPENSPEC_NO_AUTO_CONFIG === '1') {
+        if (process.env.CODESDD_NO_AUTO_CONFIG === '1') {
             return false;
         }
         try {
@@ -268,7 +268,7 @@ export class BashInstaller {
             '',
             'To enable completions, add the following to your ~/.bashrc file:',
             '',
-            `  # Source OpenSpec completions`,
+            `  # Source CodeSDD completions`,
             `  if [ -d "${completionsDir}" ]; then`,
             `    for f in "${completionsDir}"/*; do`,
             '      [ -f "$f" ] && . "$f"',

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

@@ -16,7 +16,7 @@ export class FishInstaller {
      * @returns Installation path
      */
     getInstallationPath() {
-        return path.join(this.homeDir, '.config', 'fish', 'completions', 'opensdd.fish');
+        return path.join(this.homeDir, '.config', 'fish', 'completions', 'codesdd.fish');
     }
     /**
      * Backup an existing completion file if it exists

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

@@ -11,8 +11,8 @@ export class PowerShellInstaller {
      * Markers for PowerShell profile configuration management
      */
     PROFILE_MARKERS = {
-        start: '# OPENSPEC:START',
-        end: '# OPENSPEC:END',
+        start: '# CODESDD:START',
+        end: '# CODESDD:END',
     };
     constructor(homeDir = os.homedir()) {
         this.homeDir = homeDir;
@@ -69,7 +69,7 @@ export class PowerShellInstaller {
     getInstallationPath() {
         const profilePath = this.getProfilePath();
         const profileDir = path.dirname(profilePath);
-        return path.join(profileDir, 'OpenSpecCompletion.ps1');
+        return path.join(profileDir, 'CodeSDDCompletion.ps1');
     }
     /**
      * Backup an existing completion file if it exists
@@ -99,7 +99,7 @@ export class PowerShellInstaller {
      */
     generateProfileConfig(scriptPath) {
         return [
-            '# OpenSpec shell completions configuration',
+            '# CodeSDD shell completions configuration',
             `if (Test-Path "${scriptPath}") {`,
             `    . "${scriptPath}"`,
             '}',
@@ -131,15 +131,15 @@ export class PowerShellInstaller {
                 if (profileContent.includes(scriptLine)) {
                     continue; // Already configured, skip
                 }
-                // Add OpenSpec completion configuration with markers
-                const openspecBlock = [
+                // Add CodeSDD completion configuration with markers
+                const codesddBlock = [
                     '',
-                    '# OPENSPEC:START - OpenSpec completion (managed block, do not edit manually)',
+                    '# CODESDD:START - CodeSDD completion (managed block, do not edit manually)',
                     scriptLine,
-                    '# OPENSPEC:END',
+                    '# CODESDD:END',
                     '',
                 ].join('\n');
-                const newContent = profileContent + openspecBlock;
+                const newContent = profileContent + codesddBlock;
                 await fs.writeFile(profilePath, newContent, 'utf-8');
                 anyConfigured = true;
             }
@@ -169,12 +169,12 @@ export class PowerShellInstaller {
                 catch {
                     continue; // Profile doesn't exist, nothing to remove
                 }
-                // Remove OPENSPEC:START -> OPENSPEC:END block
-                const startMarker = '# OPENSPEC:START';
-                const endMarker = '# OPENSPEC:END';
+                // Remove CODESDD:START -> CODESDD:END block
+                const startMarker = '# CODESDD:START';
+                const endMarker = '# CODESDD:END';
                 const startIndex = profileContent.indexOf(startMarker);
                 if (startIndex === -1) {
-                    continue; // No OpenSpec block found
+                    continue; // No CodeSDD block found
                 }
                 const endIndex = profileContent.indexOf(endMarker, startIndex);
                 if (endIndex === -1) {
@@ -279,7 +279,7 @@ export class PowerShellInstaller {
             '',
             `To enable completions, add the following to your PowerShell profile (${profilePath}):`,
             '',
-            '  # Source OpenSpec completions',
+            '  # Source CodeSDD completions',
             `  if (Test-Path "${installedPath}") {`,
             `      . "${installedPath}"`,
             '  }',

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

@@ -9,6 +9,7 @@ export declare class ZshInstaller {
      * Markers for .zshrc configuration management
      */
     private readonly ZSHRC_MARKERS;
+    private readonly ENV_SOURCE_MARKERS;
     constructor(homeDir?: string);
     /**
      * Check if Oh My Zsh is installed
@@ -54,7 +55,12 @@ export declare class ZshInstaller {
      */
     configureZshrc(completionsDir: string): Promise<boolean>;
     /**
-     * Check if .zshrc has OpenSpec configuration markers
+     * Ensure ~/.zshrc sources ~/.codesdd/env.zsh through an idempotent marker block.
+     * This block contains only non-secret shell wiring.
+     */
+    ensureCodesddEnvSource(envFilePath?: string): Promise<boolean>;
+    /**
+     * Check if .zshrc has CodeSDD configuration markers
      *
      * @returns true if .zshrc exists and has markers
      */