@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/dist/core/legacy-cleanup.js

@@ -1,14 +1,18 @@
 /**
- * Legacy cleanup module for detecting and removing OpenSpec artifacts
+ * Legacy cleanup module for detecting and removing CodeSDD artifacts
  * from previous init versions during the migration to the skill-based workflow.
  */
 import { promises as fs } from 'fs';
 import chalk from 'chalk';
 import { FileSystemUtils, removeMarkerBlock as removeMarkerBlockUtil } from '../utils/file-system.js';
-import { OPENSPEC_MARKERS } from './config.js';
+import { CODESDD_MARKERS, LEGACY_SPEC_DIR_NAME } from './config.js';
+const DEPRECATED_LEGACY_SPEC_DIR_NAMES = ['codesdd'];
+function legacySpecRootNames() {
+    return [LEGACY_SPEC_DIR_NAME, ...DEPRECATED_LEGACY_SPEC_DIR_NAMES];
+}
 /**
  * Legacy config file names from the old ToolRegistry.
- * These were config files created at project root with OpenSpec markers.
+ * These were config files created at project root with CodeSDD markers.
  */
 export const LEGACY_CONFIG_FILES = [
     'CLAUDE.md',
@@ -17,7 +21,7 @@ export const LEGACY_CONFIG_FILES = [
     'COSTRICT.md',
     'QODER.md',
     'IFLOW.md',
-    'AGENTS.md', // root AGENTS.md (not openspec/AGENTS.md)
+    'AGENTS.md', // root AGENTS.md (not legacy-spec/AGENTS.md)
     'QWEN.md',
 ];
 /**
@@ -26,33 +30,33 @@ export const LEGACY_CONFIG_FILES = [
  * Some tools used a directory structure, others used individual files.
  */
 export const LEGACY_SLASH_COMMAND_PATHS = {
-    // Directory-based: .tooldir/commands/openspec/ or .tooldir/commands/openspec/*.md
-    'claude': { type: 'directory', path: '.claude/commands/openspec' },
-    'codebuddy': { type: 'directory', path: '.codebuddy/commands/openspec' },
-    'qoder': { type: 'directory', path: '.qoder/commands/openspec' },
-    'crush': { type: 'directory', path: '.crush/commands/openspec' },
-    'gemini': { type: 'directory', path: '.gemini/commands/openspec' },
-    'costrict': { type: 'directory', path: '.cospec/openspec/commands' },
-    // File-based: individual openspec-*.md files in a commands/workflows/prompts folder
-    'cursor': { type: 'files', pattern: '.cursor/commands/openspec-*.md' },
-    'windsurf': { type: 'files', pattern: '.windsurf/workflows/openspec-*.md' },
-    'kilocode': { type: 'files', pattern: '.kilocode/workflows/openspec-*.md' },
-    'kiro': { type: 'files', pattern: '.kiro/prompts/openspec-*.prompt.md' },
-    'github-copilot': { type: 'files', pattern: '.github/prompts/openspec-*.prompt.md' },
-    'amazon-q': { type: 'files', pattern: '.amazonq/prompts/openspec-*.md' },
-    'cline': { type: 'files', pattern: '.clinerules/workflows/openspec-*.md' },
-    'roocode': { type: 'files', pattern: '.roo/commands/openspec-*.md' },
-    'auggie': { type: 'files', pattern: '.augment/commands/openspec-*.md' },
-    'factory': { type: 'files', pattern: '.factory/commands/openspec-*.md' },
-    'opencode': { type: 'files', pattern: ['.opencode/command/opsx-*.md', '.opencode/command/openspec-*.md'] },
-    'continue': { type: 'files', pattern: '.continue/prompts/openspec-*.prompt' },
-    'antigravity': { type: 'files', pattern: '.agent/workflows/openspec-*.md' },
-    'iflow': { type: 'files', pattern: '.iflow/commands/openspec-*.md' },
-    'qwen': { type: 'files', pattern: '.qwen/commands/openspec-*.toml' },
-    'codex': { type: 'files', pattern: '.codex/prompts/openspec-*.md' },
+    // Directory-based: .tooldir/commands/legacy-spec/ or .tooldir/commands/legacy-spec/*.md
+    'claude': { type: 'directory', path: '.claude/commands/codesdd' },
+    'codebuddy': { type: 'directory', path: '.codebuddy/commands/codesdd' },
+    'qoder': { type: 'directory', path: '.qoder/commands/codesdd' },
+    'crush': { type: 'directory', path: '.crush/commands/codesdd' },
+    'gemini': { type: 'directory', path: '.gemini/commands/codesdd' },
+    'costrict': { type: 'directory', path: '.cospec/legacy-spec/commands' },
+    // File-based: individual codesdd-*.md files in a commands/workflows/prompts folder
+    'cursor': { type: 'files', pattern: '.cursor/commands/codesdd-*.md' },
+    'windsurf': { type: 'files', pattern: '.windsurf/workflows/codesdd-*.md' },
+    'kilocode': { type: 'files', pattern: '.kilocode/workflows/codesdd-*.md' },
+    'kiro': { type: 'files', pattern: '.kiro/prompts/codesdd-*.prompt.md' },
+    'github-copilot': { type: 'files', pattern: '.github/prompts/codesdd-*.prompt.md' },
+    'amazon-q': { type: 'files', pattern: '.amazonq/prompts/codesdd-*.md' },
+    'cline': { type: 'files', pattern: '.clinerules/workflows/codesdd-*.md' },
+    'roocode': { type: 'files', pattern: '.roo/commands/codesdd-*.md' },
+    'auggie': { type: 'files', pattern: '.augment/commands/codesdd-*.md' },
+    'factory': { type: 'files', pattern: '.factory/commands/codesdd-*.md' },
+    'opencode': { type: 'files', pattern: ['.opencode/command/opsx-*.md', '.opencode/command/codesdd-*.md'] },
+    'continue': { type: 'files', pattern: '.continue/prompts/codesdd-*.prompt' },
+    'antigravity': { type: 'files', pattern: '.agent/workflows/codesdd-*.md' },
+    'iflow': { type: 'files', pattern: '.iflow/commands/codesdd-*.md' },
+    'qwen': { type: 'files', pattern: '.qwen/commands/codesdd-*.toml' },
+    'codex': { type: 'files', pattern: '.codex/prompts/codesdd-*.md' },
 };
 /**
- * Detects all legacy OpenSpec artifacts in a project.
+ * Detects all legacy CodeSDD artifacts in a project.
  *
  * @param projectPath - The root path of the project
  * @returns Detection result with all found legacy artifacts
@@ -92,7 +96,7 @@ export async function detectLegacyArtifacts(projectPath) {
     return result;
 }
 /**
- * Detects legacy config files with OpenSpec markers.
+ * Detects legacy config files with CodeSDD markers.
  * All config files with markers are candidates for update (marker removal only).
  * Config files are NEVER deleted - they belong to the user's project root.
  *
@@ -106,7 +110,7 @@ export async function detectLegacyConfigFiles(projectPath) {
         const filePath = FileSystemUtils.joinPath(projectPath, fileName);
         if (await FileSystemUtils.fileExists(filePath)) {
             const content = await FileSystemUtils.readFile(filePath);
-            if (hasOpenSpecMarkers(content)) {
+            if (hasCodeSDDMarkers(content)) {
                 allFiles.push(fileName);
                 filesToUpdate.push(fileName); // Always update, never delete config files
             }
@@ -145,7 +149,7 @@ export async function detectLegacySlashCommands(projectPath) {
  * Finds legacy slash command files matching a glob pattern.
  *
  * @param projectPath - The root path of the project
- * @param pattern - Glob pattern like '.cursor/commands/openspec-*.md'
+ * @param pattern - Glob pattern like '.cursor/commands/codesdd-*.md'
  * @returns Array of matching file paths relative to projectPath
  */
 async function findLegacySlashCommandFiles(projectPath, pattern) {
@@ -164,9 +168,9 @@ async function findLegacySlashCommandFiles(projectPath, pattern) {
     try {
         const entries = await fs.readdir(dirPath);
         // Convert glob pattern to regex
-        // openspec-*.md -> /^openspec-.*\.md$/
-        // openspec-*.prompt.md -> /^openspec-.*\.prompt\.md$/
-        // openspec-*.toml -> /^openspec-.*\.toml$/
+        // codesdd-*.md -> /^codesdd-.*\.md$/
+        // codesdd-*.prompt.md -> /^codesdd-.*\.prompt\.md$/
+        // codesdd-*.toml -> /^codesdd-.*\.toml$/
         const regexPattern = filePart
             .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape regex special chars except *
             .replace(/\*/g, '.*'); // Replace * with .*
@@ -185,7 +189,7 @@ async function findLegacySlashCommandFiles(projectPath, pattern) {
     return foundFiles;
 }
 /**
- * Detects legacy OpenSpec structure files (AGENTS.md and project.md).
+ * Detects legacy CodeSDD structure files (AGENTS.md and project.md).
  *
  * @param projectPath - The root path of the project
  * @returns Object with detection results for structure files
@@ -194,59 +198,69 @@ export async function detectLegacyStructureFiles(projectPath) {
     let hasOpenspecAgents = false;
     let hasProjectMd = false;
     let hasRootAgentsWithMarkers = false;
-    // Check for openspec/AGENTS.md
-    const openspecAgentsPath = FileSystemUtils.joinPath(projectPath, 'openspec', 'AGENTS.md');
-    hasOpenspecAgents = await FileSystemUtils.fileExists(openspecAgentsPath);
-    // Check for openspec/project.md (for migration messaging, not deleted)
-    const projectMdPath = FileSystemUtils.joinPath(projectPath, 'openspec', 'project.md');
-    hasProjectMd = await FileSystemUtils.fileExists(projectMdPath);
-    // Check for root AGENTS.md with OpenSpec markers
+    // Check for legacy-spec/AGENTS.md
+    for (const rootName of legacySpecRootNames()) {
+        const legacySpecAgentsPath = FileSystemUtils.joinPath(projectPath, rootName, 'AGENTS.md');
+        if (await FileSystemUtils.fileExists(legacySpecAgentsPath)) {
+            hasOpenspecAgents = true;
+            break;
+        }
+    }
+    // Check for legacy-spec/project.md (for migration messaging, not deleted)
+    for (const rootName of legacySpecRootNames()) {
+        const projectMdPath = FileSystemUtils.joinPath(projectPath, rootName, 'project.md');
+        if (await FileSystemUtils.fileExists(projectMdPath)) {
+            hasProjectMd = true;
+            break;
+        }
+    }
+    // Check for root AGENTS.md with CodeSDD markers
     const rootAgentsPath = FileSystemUtils.joinPath(projectPath, 'AGENTS.md');
     if (await FileSystemUtils.fileExists(rootAgentsPath)) {
         const content = await FileSystemUtils.readFile(rootAgentsPath);
-        hasRootAgentsWithMarkers = hasOpenSpecMarkers(content);
+        hasRootAgentsWithMarkers = hasCodeSDDMarkers(content);
     }
     return { hasOpenspecAgents, hasProjectMd, hasRootAgentsWithMarkers };
 }
 /**
- * Checks if content contains OpenSpec markers.
+ * Checks if content contains CodeSDD markers.
  *
  * @param content - File content to check
  * @returns True if both start and end markers are present
  */
-export function hasOpenSpecMarkers(content) {
-    return (content.includes(OPENSPEC_MARKERS.start) && content.includes(OPENSPEC_MARKERS.end));
+export function hasCodeSDDMarkers(content) {
+    return (content.includes(CODESDD_MARKERS.start) && content.includes(CODESDD_MARKERS.end));
 }
 /**
- * Checks if file content is 100% OpenSpec content (only markers and whitespace outside).
+ * Checks if file content is 100% CodeSDD content (only markers and whitespace outside).
  *
  * @param content - File content to check
  * @returns True if content outside markers is only whitespace
  */
-export function isOnlyOpenSpecContent(content) {
-    const startIndex = content.indexOf(OPENSPEC_MARKERS.start);
-    const endIndex = content.indexOf(OPENSPEC_MARKERS.end);
+export function isOnlyCodeSDDContent(content) {
+    const startIndex = content.indexOf(CODESDD_MARKERS.start);
+    const endIndex = content.indexOf(CODESDD_MARKERS.end);
     if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
         return false;
     }
     const before = content.substring(0, startIndex);
-    const after = content.substring(endIndex + OPENSPEC_MARKERS.end.length);
+    const after = content.substring(endIndex + CODESDD_MARKERS.end.length);
     return before.trim() === '' && after.trim() === '';
 }
 /**
- * Removes the OpenSpec marker block from file content.
+ * Removes the CodeSDD marker block from file content.
  * Only removes markers that are on their own lines (ignores inline mentions).
  * Cleans up double blank lines that may result from removal.
  *
- * @param content - File content with OpenSpec markers
+ * @param content - File content with CodeSDD markers
  * @returns Content with marker block removed
  */
 export function removeMarkerBlock(content) {
-    return removeMarkerBlockUtil(content, OPENSPEC_MARKERS.start, OPENSPEC_MARKERS.end);
+    return removeMarkerBlockUtil(content, CODESDD_MARKERS.start, CODESDD_MARKERS.end);
 }
 /**
- * Cleans up legacy OpenSpec artifacts from a project.
- * Preserves openspec/project.md (shows migration hint instead of deleting).
+ * Cleans up legacy CodeSDD artifacts from a project.
+ * Preserves legacy-spec/project.md (shows migration hint instead of deleting).
  *
  * @param projectPath - The root path of the project
  * @param detection - Detection result from detectLegacyArtifacts
@@ -275,7 +289,7 @@ export async function cleanupLegacyArtifacts(projectPath, detection) {
             result.errors.push(`Failed to modify ${fileName}: ${error.message}`);
         }
     }
-    // Delete legacy slash command directories (these are 100% OpenSpec-managed)
+    // Delete legacy slash command directories (these are 100% CodeSDD-managed)
     for (const dirPath of detection.slashCommandDirs) {
         const fullPath = FileSystemUtils.joinPath(projectPath, dirPath);
         try {
@@ -286,7 +300,7 @@ export async function cleanupLegacyArtifacts(projectPath, detection) {
             result.errors.push(`Failed to delete directory ${dirPath}: ${error.message}`);
         }
     }
-    // Delete legacy slash command files (these are 100% OpenSpec-managed)
+    // Delete legacy slash command files (these are 100% CodeSDD-managed)
     for (const filePath of detection.slashCommandFiles) {
         const fullPath = FileSystemUtils.joinPath(projectPath, filePath);
         try {
@@ -297,20 +311,23 @@ export async function cleanupLegacyArtifacts(projectPath, detection) {
             result.errors.push(`Failed to delete ${filePath}: ${error.message}`);
         }
     }
-    // Delete openspec/AGENTS.md (this is inside openspec/, it's OpenSpec-managed)
+    // Delete legacy-spec/AGENTS.md (this is inside legacy-spec/, it's CodeSDD-managed)
     if (detection.hasOpenspecAgents) {
-        const agentsPath = FileSystemUtils.joinPath(projectPath, 'openspec', 'AGENTS.md');
-        if (await FileSystemUtils.fileExists(agentsPath)) {
+        for (const rootName of legacySpecRootNames()) {
+            const relativePath = `${rootName}/AGENTS.md`;
+            const agentsPath = FileSystemUtils.joinPath(projectPath, relativePath);
+            if (!(await FileSystemUtils.fileExists(agentsPath)))
+                continue;
             try {
                 await fs.unlink(agentsPath);
-                result.deletedFiles.push('openspec/AGENTS.md');
+                result.deletedFiles.push(relativePath);
             }
             catch (error) {
-                result.errors.push(`Failed to delete openspec/AGENTS.md: ${error.message}`);
+                result.errors.push(`Failed to delete ${relativePath}: ${error.message}`);
             }
         }
     }
-    // Handle root AGENTS.md with OpenSpec markers - remove markers only, NEVER delete
+    // Handle root AGENTS.md with CodeSDD markers - remove markers only, NEVER delete
     // Note: Root AGENTS.md is handled via configFilesToUpdate above (it's in LEGACY_CONFIG_FILES)
     // This hasRootAgentsWithMarkers flag is just for detection, cleanup happens via configFilesToUpdate
     return result;
@@ -332,7 +349,7 @@ export function formatCleanupSummary(result) {
             lines.push(`  ✓ Removed ${dir}/ (replaced by /opsx:*)`);
         }
         for (const file of result.modifiedFiles) {
-            lines.push(`  ✓ Removed OpenSpec markers from ${file}`);
+            lines.push(`  ✓ Removed CodeSDD markers from ${file}`);
         }
     }
     if (result.projectMdNeedsMigration) {
@@ -354,7 +371,7 @@ export function formatCleanupSummary(result) {
 }
 /**
  * Build list of files to be removed with explanations.
- * Only includes OpenSpec-managed files (slash commands, openspec/AGENTS.md).
+ * Only includes CodeSDD-managed files (slash commands, legacy-spec/AGENTS.md).
  * Config files like CLAUDE.md, AGENTS.md are NEVER deleted.
  *
  * @param detection - Detection result from detectLegacyArtifacts
@@ -362,19 +379,19 @@ export function formatCleanupSummary(result) {
  */
 function buildRemovalsList(detection) {
     const removals = [];
-    // Slash command directories (these are 100% OpenSpec-managed)
+    // Slash command directories (these are 100% CodeSDD-managed)
     for (const dir of detection.slashCommandDirs) {
         // Split on both forward and backward slashes for Windows compatibility
         const toolDir = dir.split(/[\/\\]/)[0];
         removals.push({ path: dir + '/', explanation: `replaced by ${toolDir}/skills/` });
     }
-    // Slash command files (these are 100% OpenSpec-managed)
+    // Slash command files (these are 100% CodeSDD-managed)
     for (const file of detection.slashCommandFiles) {
         removals.push({ path: file, explanation: 'replaced by skills/' });
     }
-    // openspec/AGENTS.md (inside openspec/, it's OpenSpec-managed)
+    // legacy-spec/AGENTS.md (inside legacy-spec/, it's CodeSDD-managed)
     if (detection.hasOpenspecAgents) {
-        removals.push({ path: 'openspec/AGENTS.md', explanation: 'obsolete workflow file' });
+        removals.push({ path: 'legacy-spec/AGENTS.md', explanation: 'obsolete workflow file' });
     }
     // Note: Config files (CLAUDE.md, AGENTS.md, etc.) are NEVER in the removals list
     // They always go to the updates list where only markers are removed
@@ -391,7 +408,7 @@ function buildUpdatesList(detection) {
     const updates = [];
     // All config files with markers get updated (markers removed, file preserved)
     for (const file of detection.configFilesToUpdate) {
-        updates.push({ path: file, explanation: 'removing OpenSpec markers' });
+        updates.push({ path: file, explanation: 'removing CodeSDD markers' });
     }
     return updates;
 }
@@ -411,9 +428,9 @@ export function formatDetectionSummary(detection) {
         return '';
     }
     // Header - welcoming upgrade message
-    lines.push(chalk.bold('Upgrading to the new OpenSpec'));
+    lines.push(chalk.bold('Upgrading to the new CodeSDD'));
     lines.push('');
-    lines.push('OpenSpec now uses agent skills, the emerging standard across coding');
+    lines.push('CodeSDD now uses agent skills, the emerging standard across coding');
     lines.push('agents. This simplifies your setup while keeping everything working');
     lines.push('as before.');
     lines.push('');
@@ -430,7 +447,7 @@ export function formatDetectionSummary(detection) {
         if (removals.length > 0)
             lines.push('');
         lines.push(chalk.bold('Files to update'));
-        lines.push(chalk.dim('OpenSpec markers will be removed, your content preserved:'));
+        lines.push(chalk.dim('CodeSDD markers will be removed, your content preserved:'));
         for (const { path } of updates) {
             lines.push(`  • ${path}`);
         }
@@ -468,7 +485,7 @@ export function getToolsFromLegacyArtifacts(detection) {
         for (const [toolId, pattern] of Object.entries(LEGACY_SLASH_COMMAND_PATHS)) {
             if (pattern.type === 'files' && pattern.pattern) {
                 // Convert glob pattern to regex for matching
-                // e.g., '.cursor/commands/openspec-*.md' -> /^\.cursor\/commands\/openspec-.*\.md$/
+                // e.g., '.cursor/commands/codesdd-*.md' -> /^\.cursor\/commands\/codesdd-.*\.md$/
                 const patterns = Array.isArray(pattern.pattern) ? pattern.pattern : [pattern.pattern];
                 let matched = false;
                 for (const p of patterns) {
@@ -498,11 +515,11 @@ export function getToolsFromLegacyArtifacts(detection) {
 export function formatProjectMdMigrationHint() {
     const lines = [];
     lines.push(chalk.yellow.bold('Needs your attention'));
-    lines.push('  • openspec/project.md');
+    lines.push('  • legacy-spec/project.md');
     lines.push(chalk.dim('    We won\'t delete this file. It may contain useful project context.'));
     lines.push('');
-    lines.push(chalk.dim('    The new openspec/config.yaml has a "context:" section for planning'));
-    lines.push(chalk.dim('    context. This is included in every OpenSpec request and works more'));
+    lines.push(chalk.dim('    The new legacy-spec/config.yaml has a "context:" section for planning'));
+    lines.push(chalk.dim('    context. This is included in every CodeSDD request and works more'));
     lines.push(chalk.dim('    reliably than the old project.md approach.'));
     lines.push('');
     lines.push(chalk.dim('    Review project.md, move any useful content to config.yaml\'s context'));

package/dist/core/list.js

@@ -5,7 +5,7 @@ import { readFileSync } from 'fs';
 import { join } from 'path';
 import { MarkdownParser } from './parsers/markdown-parser.js';
 import { CLI_NAME } from './branding.js';
-import { resolveOpenSpecSubpath } from './sdd/services/legacy-capability.service.js';
+import { resolveLegacySpecSubpath } from './sdd/services/legacy-capability.service.js';
 /**
  * Get the most recent modification time of any file in a directory (recursive).
  * Falls back to the directory's own mtime if no files are found.
@@ -65,13 +65,27 @@ export class ListCommand {
     async execute(targetPath = '.', mode = 'changes', options = {}) {
         const { sort = 'recent', json = false } = options;
         if (mode === 'changes') {
-            const changesDir = resolveOpenSpecSubpath(targetPath, 'changes');
+            const changesDir = resolveLegacySpecSubpath(targetPath, 'changes');
             // Check if changes directory exists
             try {
                 await fs.access(changesDir);
             }
             catch {
-                throw new Error(`No OpenSpec changes directory found. Run '${CLI_NAME} init' first.`);
+                const sddStatePath = path.join(targetPath, '.sdd', 'state', 'backlog.yaml');
+                try {
+                    await fs.access(sddStatePath);
+                    const message = `This repository uses SDD canonical state. The legacy 'changes/' directory does not apply here.\nUse '${CLI_NAME} sdd next' to see ready FEATs or '${CLI_NAME} sdd check' for the backlog overview.`;
+                    if (json) {
+                        console.log(JSON.stringify({ changes: [], hint: message }, null, 2));
+                    }
+                    else {
+                        console.log(message);
+                    }
+                    return;
+                }
+                catch {
+                    throw new Error(`No CodeSDD changes directory found. Run '${CLI_NAME} init' first.`);
+                }
             }
             // Get all directories in changes (excluding archive)
             const entries = await fs.readdir(changesDir, { withFileTypes: true });
@@ -132,7 +146,7 @@ export class ListCommand {
             return;
         }
         // specs mode
-        const specsDir = resolveOpenSpecSubpath(targetPath, 'specs');
+        const specsDir = resolveLegacySpecSubpath(targetPath, 'specs');
         try {
             await fs.access(specsDir);
         }

package/dist/core/migration.d.ts

@@ -19,5 +19,7 @@ export declare function scanInstalledWorkflows(projectPath: string, tools: AIToo
  * - If no profile field exists and no workflows are installed: no-op (defaults apply).
  * - If profile field already exists: no-op.
  */
-export declare function migrateIfNeeded(projectPath: string, tools: AIToolOption[]): void;
+export declare function migrateIfNeeded(projectPath: string, tools: AIToolOption[], options?: {
+    silent?: boolean;
+}): void;
 //# sourceMappingURL=migration.d.ts.map

package/dist/core/migration.js

@@ -4,7 +4,7 @@
  * One-time migration logic for existing projects when profile system is introduced.
  * Called by both init and update commands before profile resolution.
  */
-import { getGlobalConfig, getGlobalConfigPath, saveGlobalConfig } from './global-config.js';
+import { getGlobalConfig, readGlobalConfigRaw, saveGlobalConfig } from './global-config.js';
 import { CommandAdapterRegistry } from './command-generation/index.js';
 import { WORKFLOW_TO_SKILL_DIR } from './profile-sync-drift.js';
 import { ALL_WORKFLOWS } from './profiles.js';
@@ -71,15 +71,12 @@ function inferDelivery(artifacts) {
  * - If no profile field exists and no workflows are installed: no-op (defaults apply).
  * - If profile field already exists: no-op.
  */
-export function migrateIfNeeded(projectPath, tools) {
+export function migrateIfNeeded(projectPath, tools, options = {}) {
     const config = getGlobalConfig();
     // Check raw config file for profile field presence
-    const configPath = getGlobalConfigPath();
     let rawConfig = {};
     try {
-        if (fs.existsSync(configPath)) {
-            rawConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        }
+        rawConfig = readGlobalConfigRaw();
     }
     catch {
         return; // Can't read config, skip migration
@@ -102,7 +99,9 @@ export function migrateIfNeeded(projectPath, tools) {
         config.delivery = inferDelivery(artifacts);
     }
     saveGlobalConfig(config);
-    console.log(`Migrated: custom profile with ${installedWorkflows.length} workflows`);
-    console.log("New in this version: /opsx:propose. Try 'openspec config profile core' for the streamlined experience.");
+    if (!options.silent) {
+        console.log(`Migrated: custom profile with ${installedWorkflows.length} workflows`);
+        console.log("New in this version: /opsx:propose. Try 'codesdd config profile core' for the streamlined experience.");
+    }
 }
 //# sourceMappingURL=migration.js.map

package/dist/core/parsers/change-parser.js

@@ -31,7 +31,7 @@ export class ChangeParser extends MarkdownParser {
             deltas,
             metadata: {
                 version: '1.0.0',
-                format: 'openspec-change',
+                format: 'codesdd-change',
             },
         };
     }

package/dist/core/parsers/markdown-parser.js

@@ -26,7 +26,7 @@ export class MarkdownParser {
             requirements,
             metadata: {
                 version: '1.0.0',
-                format: 'openspec',
+                format: 'codesdd',
             },
         };
     }
@@ -48,7 +48,7 @@ export class MarkdownParser {
             deltas,
             metadata: {
                 version: '1.0.0',
-                format: 'openspec-change',
+                format: 'codesdd-change',
             },
         };
     }

package/dist/core/profile-sync-drift.d.ts

@@ -6,7 +6,7 @@ type WorkflowId = (typeof ALL_WORKFLOWS)[number];
  */
 export declare const WORKFLOW_TO_SKILL_DIR: Record<WorkflowId, string>;
 /**
- * Checks whether a tool has at least one generated OpenSpec command file.
+ * Checks whether a tool has at least one generated CodeSDD command file.
  */
 export declare function toolHasAnyConfiguredCommand(projectPath: string, toolId: string): boolean;
 /**

package/dist/core/profile-sync-drift.js

@@ -8,24 +8,24 @@ import { COMMAND_IDS, getConfiguredTools } from './shared/index.js';
  * Maps workflow IDs to their skill directory names.
  */
 export const WORKFLOW_TO_SKILL_DIR = {
-    'explore': 'openspec-explore',
-    'new': 'openspec-new-change',
-    'continue': 'openspec-continue-change',
-    'apply': 'openspec-apply-change',
-    'ff': 'openspec-ff-change',
-    'sync': 'openspec-sync-specs',
-    'archive': 'openspec-archive-change',
-    'bulk-archive': 'openspec-bulk-archive-change',
-    'verify': 'openspec-verify-change',
-    'onboard': 'openspec-onboard',
-    'propose': 'openspec-propose',
-    'sdd': 'openspec-sdd',
+    'explore': 'codesdd-explore',
+    'new': 'codesdd-new-change',
+    'continue': 'codesdd-continue-change',
+    'apply': 'codesdd-apply-change',
+    'ff': 'codesdd-ff-change',
+    'sync': 'codesdd-sync-specs',
+    'archive': 'codesdd-archive-change',
+    'bulk-archive': 'codesdd-bulk-archive-change',
+    'verify': 'codesdd-verify-change',
+    'onboard': 'codesdd-onboard',
+    'propose': 'codesdd-propose',
+    'sdd': 'codesdd-sdd',
 };
 function toKnownWorkflows(workflows) {
     return workflows.filter((workflow) => ALL_WORKFLOWS.includes(workflow));
 }
 /**
- * Checks whether a tool has at least one generated OpenSpec command file.
+ * Checks whether a tool has at least one generated CodeSDD command file.
  */
 export function toolHasAnyConfiguredCommand(projectPath, toolId) {
     const adapter = CommandAdapterRegistry.get(toolId);

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

@@ -8,9 +8,9 @@ import { z } from 'zod';
  * 3. Runtime validation - uses safeParse() for resilient field-by-field validation
  *
  * Why Zod over manual validation:
- * - Helps understand OpenSpec's data interfaces at a glance
+ * - Helps understand CodeSDD's data interfaces at a glance
  * - Single source of truth for type and validation
- * - Consistent with other OpenSpec schemas
+ * - Consistent with other CodeSDD schemas
  */
 export declare const ProjectConfigSchema: z.ZodObject<{
     schema: z.ZodString;
@@ -19,7 +19,7 @@ export declare const ProjectConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
 /**
- * Read and parse openspec/config.yaml from project root.
+ * Read and parse legacy-spec/config.yaml from project root.
  * Uses resilient parsing - validates each field independently using Zod safeParse.
  * Returns null if file doesn't exist.
  * Returns partial config if some fields are invalid (with warnings).
@@ -34,7 +34,7 @@ export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
  * invalidation logic) for negligible benefit. Direct reads also ensure config
  * changes are reflected immediately without stale cache issues.
  *
- * @param projectRoot - The root directory of the project (where `openspec/` lives)
+ * @param projectRoot - The root directory of the project (where `legacy-spec/` lives)
  * @returns Parsed config or null if file doesn't exist
  */
 export declare function readProjectConfig(projectRoot: string): ProjectConfig | null;