@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/dist/core/init.js

@@ -1,7 +1,7 @@
 /**
  * Init Command
  *
- * Sets up OpenSpec with Agent Skills and /opsx:* slash commands.
+ * Sets up CodeSDD with Agent Skills and /opsx:* slash commands.
  * This is the unified setup command that replaces both the old init and experimental commands.
  */
 import path from 'path';
@@ -11,7 +11,7 @@ import * as fs from 'fs';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { transformToHyphenCommands } from '../utils/command-references.js';
-import { AI_TOOLS, OPENSPEC_DIR_NAME, } from './config.js';
+import { AI_TOOLS, LEGACY_SPEC_DIR_NAME, } from './config.js';
 import { isInteractive } from '../utils/interactive.js';
 import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
 import { CLI_ISSUES_URL, CLI_NAME, CLI_PRODUCT_NAME, CLI_REPOSITORY_URL } from './branding.js';
@@ -21,24 +21,25 @@ import { getGlobalConfig } from './global-config.js';
 import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
 import { getAvailableTools } from './available-tools.js';
 import { migrateIfNeeded } from './migration.js';
+import { resolveLegacySpecLiveRoot } from './sdd/services/legacy-capability.service.js';
 const require = createRequire(import.meta.url);
-const { version: OPENSPEC_VERSION } = require('../../package.json');
+const { version: CODESDD_VERSION } = require('../../package.json');
 // -----------------------------------------------------------------------------
 // Constants
 // -----------------------------------------------------------------------------
 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',
 };
 // -----------------------------------------------------------------------------
 // Init Command Class
@@ -48,25 +49,28 @@ export class InitCommand {
     force;
     interactiveOption;
     profileOverride;
+    allowNoToolsFallback;
+    silent;
     constructor(options = {}) {
         this.toolsArg = options.tools;
         this.force = options.force ?? false;
         this.interactiveOption = options.interactive;
         this.profileOverride = options.profile;
+        this.allowNoToolsFallback = options.allowNoToolsFallback ?? false;
+        this.silent = options.silent ?? false;
     }
     async execute(targetPath) {
         const projectPath = path.resolve(targetPath);
-        const openspecDir = OPENSPEC_DIR_NAME;
-        const openspecPath = path.join(projectPath, openspecDir);
+        const codesddPath = resolveLegacySpecLiveRoot(projectPath);
         // Validation happens silently in the background
-        const extendMode = await this.validate(projectPath, openspecPath);
+        const extendMode = await this.validate(projectPath, codesddPath);
         // Check for legacy artifacts and handle cleanup
         await this.handleLegacyCleanup(projectPath, extendMode);
         // Detect available tools in the project (task 7.1)
         const detectedTools = getAvailableTools(projectPath);
         // Migration check: migrate existing projects to profile system (task 7.3)
         if (extendMode) {
-            migrateIfNeeded(projectPath, detectedTools);
+            migrateIfNeeded(projectPath, detectedTools, { silent: this.silent });
         }
         // Show animated welcome screen (interactive mode only)
         const canPrompt = this.canPromptInteractively();
@@ -84,19 +88,19 @@ export class InitCommand {
         // Validate selected tools
         const validatedTools = this.validateTools(selectedToolIds, toolStates);
         // Create directory structure
-        await this.createDirectoryStructure(openspecPath, extendMode);
+        await this.createDirectoryStructure(codesddPath, extendMode);
         // Generate skills and commands for each tool
         const results = await this.generateSkillsAndCommands(projectPath, validatedTools);
-        // Preserve an existing legacy OpenSpec config, but do not create one for new OpenSDD projects.
-        const configStatus = await this.createConfig(openspecPath, extendMode);
+        // Preserve an existing legacy CodeSDD config, but do not create one for new CodeSDD projects.
+        const configStatus = await this.createConfig(codesddPath, extendMode);
         // Display success message
         this.displaySuccessMessage(projectPath, validatedTools, results, configStatus);
     }
     // ═══════════════════════════════════════════════════════════
     // VALIDATION & SETUP
     // ═══════════════════════════════════════════════════════════
-    async validate(projectPath, openspecPath) {
-        const extendMode = await FileSystemUtils.directoryExists(openspecPath);
+    async validate(projectPath, codesddPath) {
+        const extendMode = await FileSystemUtils.directoryExists(codesddPath);
         // Check write permissions
         if (!(await FileSystemUtils.ensureWritePermissions(projectPath))) {
             throw new Error(`Insufficient permissions to write to ${projectPath}`);
@@ -110,6 +114,16 @@ export class InitCommand {
             return false;
         return isInteractive({ interactive: this.interactiveOption });
     }
+    log(message) {
+        if (!this.silent) {
+            if (typeof message === 'undefined') {
+                console.log();
+            }
+            else {
+                console.log(message);
+            }
+        }
+    }
     resolveProfileOverride() {
         if (this.profileOverride === undefined) {
             return undefined;
@@ -129,13 +143,13 @@ export class InitCommand {
             return; // No legacy artifacts found
         }
         // Show what was detected
-        console.log();
-        console.log(formatDetectionSummary(detection));
-        console.log();
+        this.log();
+        this.log(formatDetectionSummary(detection));
+        this.log();
         const canPrompt = this.canPromptInteractively();
         if (this.force || !canPrompt) {
             // --force flag or non-interactive mode: proceed with cleanup automatically.
-            // Legacy slash commands are 100% OpenSpec-managed, and config file cleanup
+            // Legacy slash commands are 100% CodeSDD-managed, and config file cleanup
             // only removes markers (never deletes files), so auto-cleanup is safe.
             await this.performLegacyCleanup(projectPath, detection);
             return;
@@ -147,22 +161,22 @@ export class InitCommand {
             default: true,
         });
         if (!shouldCleanup) {
-            console.log(chalk.dim('Initialization cancelled.'));
-            console.log(chalk.dim('Run with --force to skip this prompt, or manually remove legacy files.'));
+            this.log(chalk.dim('Initialization cancelled.'));
+            this.log(chalk.dim('Run with --force to skip this prompt, or manually remove legacy files.'));
             process.exit(0);
         }
         await this.performLegacyCleanup(projectPath, detection);
     }
     async performLegacyCleanup(projectPath, detection) {
-        const spinner = ora('Cleaning up legacy files...').start();
+        const spinner = this.silent ? null : ora('Cleaning up legacy files...').start();
         const result = await cleanupLegacyArtifacts(projectPath, detection);
-        spinner.succeed('Legacy files cleaned up');
+        spinner?.succeed('Legacy files cleaned up');
         const summary = formatCleanupSummary(result);
-        if (summary) {
-            console.log();
-            console.log(summary);
+        if (summary && !this.silent) {
+            this.log();
+            this.log(summary);
         }
-        console.log();
+        this.log();
     }
     // ═══════════════════════════════════════════════════════════
     // TOOL SELECTION
@@ -185,6 +199,9 @@ export class InitCommand {
             if (detectedToolIds.size > 0) {
                 return [...detectedToolIds];
             }
+            if (this.allowNoToolsFallback) {
+                return [];
+            }
             throw new Error(`No tools detected and no --tools flag provided. Valid tools:\n  ${validTools.join('\n  ')}\n\nUse --tools all, --tools none, or --tools claude,cursor,...`);
         }
         if (validTools.length === 0) {
@@ -223,7 +240,7 @@ export class InitCommand {
             .filter((toolId) => configuredToolIds.has(toolId))
             .map((toolId) => AI_TOOLS.find((t) => t.value === toolId)?.name || toolId);
         if (configuredNames.length > 0) {
-            console.log(`OpenSpec configured: ${configuredNames.join(', ')} (pre-selected)`);
+            this.log(`CodeSDD configured: ${configuredNames.join(', ')} (pre-selected)`);
         }
         const detectedOnlyNames = detectedTools
             .filter((tool) => !configuredToolIds.has(tool.value))
@@ -232,7 +249,7 @@ export class InitCommand {
             const detectionLabel = shouldPreselectDetected
                 ? 'pre-selected for first-time setup'
                 : 'not pre-selected';
-            console.log(`Detected tool directories: ${detectedOnlyNames.join(', ')} (${detectionLabel})`);
+            this.log(`Detected tool directories: ${detectedOnlyNames.join(', ')} (${detectionLabel})`);
         }
         const selectedTools = await searchableMultiSelect({
             message: `Select tools to set up (${validTools.length} available)`,
@@ -312,18 +329,18 @@ export class InitCommand {
     // ═══════════════════════════════════════════════════════════
     // DIRECTORY STRUCTURE
     // ═══════════════════════════════════════════════════════════
-    async createDirectoryStructure(openspecPath, extendMode) {
+    async createDirectoryStructure(codesddPath, extendMode) {
         if (!extendMode) {
-            // New OpenSDD installs are .sdd-native. Keep openspec/ only as a legacy
+            // New CodeSDD installs are .sdd-native. Keep legacy-spec/ only as a legacy
             // compatibility surface when it already exists in the target project.
             return;
         }
         // In extend mode, just ensure legacy directories exist without spinner.
         const directories = [
-            openspecPath,
-            path.join(openspecPath, 'specs'),
-            path.join(openspecPath, 'changes'),
-            path.join(openspecPath, 'changes', 'archive'),
+            codesddPath,
+            path.join(codesddPath, 'specs'),
+            path.join(codesddPath, 'changes'),
+            path.join(codesddPath, 'changes', 'archive'),
         ];
         for (const dir of directories) {
             await FileSystemUtils.createDirectory(dir);
@@ -349,7 +366,7 @@ export class InitCommand {
         const shouldGenerateCommands = delivery !== 'skills';
         const skillTemplates = shouldGenerateSkills ? getSkillTemplates(workflows) : [];
         const commandContents = shouldGenerateCommands ? getCommandContents(workflows) : [];
-        const useSpinner = tools.length === 1;
+        const useSpinner = !this.silent && tools.length === 1;
         const toolResults = await Promise.all(tools.map(async (tool) => {
             const spinner = useSpinner ? ora(`Setting up ${tool.name}...`).start() : null;
             try {
@@ -359,7 +376,7 @@ export class InitCommand {
                         const skillDir = path.join(skillsDir, dirName);
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         const transformer = tool.value === 'opencode' ? transformToHyphenCommands : undefined;
-                        const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
+                        const skillContent = generateSkillContent(template, CODESDD_VERSION, transformer);
                         await FileSystemUtils.writeFile(skillFile, skillContent);
                     }));
                 }
@@ -437,9 +454,9 @@ export class InitCommand {
     // ═══════════════════════════════════════════════════════════
     // CONFIG FILE
     // ═══════════════════════════════════════════════════════════
-    async createConfig(openspecPath, _extendMode) {
-        const configPath = path.join(openspecPath, 'config.yaml');
-        const configYmlPath = path.join(openspecPath, 'config.yml');
+    async createConfig(codesddPath, _extendMode) {
+        const configPath = path.join(codesddPath, 'config.yaml');
+        const configYmlPath = path.join(codesddPath, 'config.yml');
         const configYamlExists = fs.existsSync(configPath);
         const configYmlExists = fs.existsSync(configYmlPath);
         if (configYamlExists || configYmlExists) {
@@ -451,15 +468,18 @@ export class InitCommand {
     // UI & OUTPUT
     // ═══════════════════════════════════════════════════════════
     displaySuccessMessage(projectPath, tools, results, configStatus) {
-        console.log();
-        console.log(chalk.bold(`${CLI_PRODUCT_NAME} Setup Complete`));
-        console.log();
+        if (this.silent) {
+            return;
+        }
+        this.log();
+        this.log(chalk.bold(`${CLI_PRODUCT_NAME} Setup Complete`));
+        this.log();
         // Show created vs refreshed tools
         if (results.createdTools.length > 0) {
-            console.log(`Created: ${results.createdTools.map((t) => t.name).join(', ')}`);
+            this.log(`Created: ${results.createdTools.map((t) => t.name).join(', ')}`);
         }
         if (results.refreshedTools.length > 0) {
-            console.log(`Refreshed: ${results.refreshedTools.map((t) => t.name).join(', ')}`);
+            this.log(`Refreshed: ${results.refreshedTools.map((t) => t.name).join(', ')}`);
         }
         // Show counts (respecting profile filter)
         const successfulTools = [...results.createdTools, ...results.refreshedTools];
@@ -472,66 +492,68 @@ export class InitCommand {
             const skillCount = delivery !== 'commands' ? getSkillTemplates(workflows).length : 0;
             const commandCount = delivery !== 'skills' ? getCommandContents(workflows).length : 0;
             if (skillCount > 0 && commandCount > 0) {
-                console.log(`${skillCount} skills and ${commandCount} commands in ${toolDirs}/`);
+                this.log(`${skillCount} skills and ${commandCount} commands in ${toolDirs}/`);
             }
             else if (skillCount > 0) {
-                console.log(`${skillCount} skills in ${toolDirs}/`);
+                this.log(`${skillCount} skills in ${toolDirs}/`);
             }
             else if (commandCount > 0) {
-                console.log(`${commandCount} commands in ${toolDirs}/`);
+                this.log(`${commandCount} commands in ${toolDirs}/`);
             }
         }
         // Show failures
         if (results.failedTools.length > 0) {
-            console.log(chalk.red(`Failed: ${results.failedTools.map((f) => `${f.name} (${f.error.message})`).join(', ')}`));
+            this.log(chalk.red(`Failed: ${results.failedTools.map((f) => `${f.name} (${f.error.message})`).join(', ')}`));
         }
         // Show skipped commands
         if (results.commandsSkipped.length > 0) {
-            console.log(chalk.dim(`Commands skipped for: ${results.commandsSkipped.join(', ')} (no adapter)`));
+            this.log(chalk.dim(`Commands skipped for: ${results.commandsSkipped.join(', ')} (no adapter)`));
         }
         if (results.removedCommandCount > 0) {
-            console.log(chalk.dim(`Removed: ${results.removedCommandCount} command files (delivery: skills)`));
+            this.log(chalk.dim(`Removed: ${results.removedCommandCount} command files (delivery: skills)`));
         }
         if (results.removedSkillCount > 0) {
-            console.log(chalk.dim(`Removed: ${results.removedSkillCount} skill directories (delivery: commands)`));
+            this.log(chalk.dim(`Removed: ${results.removedSkillCount} skill directories (delivery: commands)`));
         }
         // Config status
         if (configStatus === 'exists') {
             // Show actual filename (config.yaml or config.yml)
-            const configYaml = path.join(projectPath, OPENSPEC_DIR_NAME, 'config.yaml');
-            const configYml = path.join(projectPath, OPENSPEC_DIR_NAME, 'config.yml');
+            const configRoot = resolveLegacySpecLiveRoot(projectPath);
+            const configRootDisplay = path.relative(projectPath, configRoot) || LEGACY_SPEC_DIR_NAME;
+            const configYaml = path.join(configRoot, 'config.yaml');
+            const configYml = path.join(configRoot, 'config.yml');
             const configName = fs.existsSync(configYaml) ? 'config.yaml' : fs.existsSync(configYml) ? 'config.yml' : 'config.yaml';
-            console.log(`Legacy config: openspec/${configName} (exists)`);
+            this.log(`Legacy config: ${configRootDisplay}/${configName} (exists)`);
         }
         else {
-            console.log(chalk.dim(`Project config: not created (SDD uses .sdd/config.yaml)`));
+            this.log(chalk.dim(`Project config: not created (SDD uses .sdd/config.yaml)`));
         }
         // Getting started (task 7.6: show propose if in profile)
         const globalCfg = getGlobalConfig();
         const activeProfile = this.profileOverride ?? globalCfg.profile ?? 'core';
         const activeWorkflows = [...getProfileWorkflows(activeProfile, globalCfg.workflows)];
-        console.log();
+        this.log();
         if (activeWorkflows.includes('propose')) {
-            console.log(chalk.bold('Getting started:'));
-            console.log('  Start your first change: /opsx:propose "your idea"');
+            this.log(chalk.bold('Getting started:'));
+            this.log('  Start your first change: /opsx:propose "your idea"');
         }
         else if (activeWorkflows.includes('new')) {
-            console.log(chalk.bold('Getting started:'));
-            console.log('  Start your first change: /opsx:new "your idea"');
+            this.log(chalk.bold('Getting started:'));
+            this.log('  Start your first change: /opsx:new "your idea"');
         }
         else {
-            console.log(`Done. Run '${CLI_NAME} config profile' to configure your workflows.`);
+            this.log(`Done. Run '${CLI_NAME} config profile' to configure your workflows.`);
         }
         // Links
-        console.log();
-        console.log(`Learn more: ${chalk.cyan(CLI_REPOSITORY_URL)}`);
-        console.log(`Feedback:   ${chalk.cyan(CLI_ISSUES_URL)}`);
+        this.log();
+        this.log(`Learn more: ${chalk.cyan(CLI_REPOSITORY_URL)}`);
+        this.log(`Feedback:   ${chalk.cyan(CLI_ISSUES_URL)}`);
         // Restart instruction if any tools were configured
         if (results.createdTools.length > 0 || results.refreshedTools.length > 0) {
-            console.log();
-            console.log(chalk.white('Restart your IDE for slash commands to take effect.'));
+            this.log();
+            this.log(chalk.white('Restart your IDE for slash commands to take effect.'));
         }
-        console.log();
+        this.log();
     }
     async removeSkillDirs(skillsDir) {
         let removed = 0;

package/dist/core/legacy-cleanup.d.ts

@@ -1,10 +1,10 @@
 /**
- * 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.
  */
 /**
  * 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 declare const LEGACY_CONFIG_FILES: readonly ["CLAUDE.md", "CLINE.md", "CODEBUDDY.md", "COSTRICT.md", "QODER.md", "IFLOW.md", "AGENTS.md", "QWEN.md"];
 /**
@@ -25,7 +25,7 @@ export interface LegacySlashCommandPattern {
  * Result of legacy artifact detection
  */
 export interface LegacyDetectionResult {
-    /** Config files with OpenSpec markers detected */
+    /** Config files with CodeSDD markers detected */
     configFiles: string[];
     /** Config files to update (remove markers only, never delete) */
     configFilesToUpdate: string[];
@@ -33,24 +33,24 @@ export interface LegacyDetectionResult {
     slashCommandDirs: string[];
     /** Legacy slash command files found (for file-based tools) */
     slashCommandFiles: string[];
-    /** Whether openspec/AGENTS.md exists */
+    /** Whether legacy-spec/AGENTS.md exists */
     hasOpenspecAgents: boolean;
-    /** Whether openspec/project.md exists (preserved, migration hint only) */
+    /** Whether legacy-spec/project.md exists (preserved, migration hint only) */
     hasProjectMd: boolean;
-    /** Whether root AGENTS.md has OpenSpec markers */
+    /** Whether root AGENTS.md has CodeSDD markers */
     hasRootAgentsWithMarkers: boolean;
     /** Whether any legacy artifacts were found */
     hasLegacyArtifacts: boolean;
 }
 /**
- * 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
  */
 export declare function detectLegacyArtifacts(projectPath: string): Promise<LegacyDetectionResult>;
 /**
- * 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.
  *
@@ -72,7 +72,7 @@ export declare function detectLegacySlashCommands(projectPath: string): Promise<
     files: string[];
 }>;
 /**
- * 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
@@ -83,25 +83,25 @@ export declare function detectLegacyStructureFiles(projectPath: string): Promise
     hasRootAgentsWithMarkers: boolean;
 }>;
 /**
- * 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 declare function hasOpenSpecMarkers(content: string): boolean;
+export declare function hasCodeSDDMarkers(content: string): boolean;
 /**
- * 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 declare function isOnlyOpenSpecContent(content: string): boolean;
+export declare function isOnlyCodeSDDContent(content: string): boolean;
 /**
- * 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 declare function removeMarkerBlock(content: string): string;
@@ -121,8 +121,8 @@ export interface CleanupResult {
     errors: string[];
 }
 /**
- * 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