@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/dist/core/update.js

@@ -1,7 +1,7 @@
 /**
  * Update Command
  *
- * Refreshes OpenSpec skills and commands for configured tools.
+ * Refreshes CodeSDD skills and commands for configured tools.
  * Supports profile-aware updates, delivery changes, migration, and smart update detection.
  */
 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 } from './config.js';
 import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
 import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, } from './shared/index.js';
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
@@ -22,8 +22,9 @@ import { getAvailableTools } from './available-tools.js';
 import { WORKFLOW_TO_SKILL_DIR, getCommandConfiguredTools, getConfiguredToolsForProfileSync, getToolsNeedingProfileSync, } from './profile-sync-drift.js';
 import { scanInstalledWorkflows as scanInstalledWorkflowsShared, migrateIfNeeded as migrateIfNeededShared, } from './migration.js';
 import { CLI_NAME, CLI_REPOSITORY_URL } from './branding.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');
 /**
  * Scans installed workflow artifacts (skills and managed commands) across all configured tools.
  * Returns the union of detected workflow IDs that match ALL_WORKFLOWS.
@@ -43,10 +44,10 @@ export class UpdateCommand {
     }
     async execute(projectPath) {
         const resolvedProjectPath = path.resolve(projectPath);
-        const openspecPath = path.join(resolvedProjectPath, OPENSPEC_DIR_NAME);
-        // 1. Check openspec directory exists
-        if (!await FileSystemUtils.directoryExists(openspecPath)) {
-            throw new Error(`No OpenSpec directory found. Run '${CLI_NAME} init' first.`);
+        const codesddPath = resolveLegacySpecLiveRoot(resolvedProjectPath);
+        // 1. Check codesdd directory exists
+        if (!await FileSystemUtils.directoryExists(codesddPath)) {
+            throw new Error(`No CodeSDD directory found. Run '${CLI_NAME} init' first.`);
         }
         // 2. Perform one-time migration if needed before any legacy upgrade generation.
         // Use detected tool directories to preserve existing opsx skills/commands.
@@ -73,7 +74,7 @@ export class UpdateCommand {
         const commandConfiguredTools = getCommandConfiguredTools(resolvedProjectPath);
         const commandConfiguredSet = new Set(commandConfiguredTools);
         const toolStatuses = configuredTools.map((toolId) => {
-            const status = getToolVersionStatus(resolvedProjectPath, toolId, OPENSPEC_VERSION);
+            const status = getToolVersionStatus(resolvedProjectPath, toolId, CODESDD_VERSION);
             if (!status.configured && commandConfiguredSet.has(toolId)) {
                 return { ...status, configured: true };
             }
@@ -131,7 +132,7 @@ export class UpdateCommand {
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         // Use hyphen-based command references for OpenCode
                         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);
                     }
                     removedDeselectedSkillCount += await this.removeUnselectedSkillDirs(skillsDir, desiredWorkflows);
@@ -170,7 +171,7 @@ export class UpdateCommand {
         // 11. Summary
         console.log();
         if (updatedTools.length > 0) {
-            console.log(chalk.green(`✓ Updated: ${updatedTools.join(', ')} (v${OPENSPEC_VERSION})`));
+            console.log(chalk.green(`✓ Updated: ${updatedTools.join(', ')} (v${CODESDD_VERSION})`));
         }
         if (failedTools.length > 0) {
             console.log(chalk.red(`✗ Failed: ${failedTools.map(f => `${f.name} (${f.error})`).join(', ')}`));
@@ -215,7 +216,7 @@ export class UpdateCommand {
      */
     displayUpToDateMessage(toolStatuses) {
         const toolNames = toolStatuses.map((s) => s.toolId);
-        console.log(chalk.green(`✓ All ${toolStatuses.length} tool(s) up to date (v${OPENSPEC_VERSION})`));
+        console.log(chalk.green(`✓ All ${toolStatuses.length} tool(s) up to date (v${CODESDD_VERSION})`));
         console.log(chalk.dim(`  Tools: ${toolNames.join(', ')}`));
         console.log();
         console.log(chalk.dim('Use --force to refresh files anyway.'));
@@ -228,7 +229,7 @@ export class UpdateCommand {
             const status = statusByTool.get(toolId);
             if (status?.needsUpdate) {
                 const fromVersion = status.generatedByVersion ?? 'unknown';
-                return `${status.toolId} (${fromVersion} → ${OPENSPEC_VERSION})`;
+                return `${status.toolId} (${fromVersion} → ${CODESDD_VERSION})`;
             }
             return `${toolId} (config sync)`;
         });
@@ -262,7 +263,7 @@ export class UpdateCommand {
         const profileSet = new Set(profileWorkflows);
         const extraWorkflows = installedWorkflows.filter((w) => !profileSet.has(w));
         if (extraWorkflows.length > 0) {
-            console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`openspec config profile\` to manage)`));
+            console.log(chalk.dim(`Note: ${extraWorkflows.length} extra workflows not in profile (use \`codesdd config profile\` to manage)`));
         }
     }
     /**
@@ -366,7 +367,7 @@ export class UpdateCommand {
         return removed;
     }
     /**
-     * Detect and handle legacy OpenSpec artifacts.
+     * Detect and handle legacy CodeSDD artifacts.
      * Unlike init, update warns but continues if legacy files found in non-interactive mode.
      * Returns array of tool IDs that were newly configured during legacy upgrade.
      */
@@ -506,7 +507,7 @@ export class UpdateCommand {
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         // Use hyphen-based command references for OpenCode
                         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);
                     }
                 }

package/dist/core/validation/constants.d.ts

@@ -26,7 +26,7 @@ export declare const VALIDATION_MESSAGES: {
     readonly REQUIREMENT_TOO_LONG: "Requirement text is very long (>500 characters). Consider breaking it down.";
     readonly DELTA_DESCRIPTION_TOO_BRIEF: "Delta description is too brief";
     readonly DELTA_MISSING_REQUIREMENTS: "Delta should include requirements";
-    readonly GUIDE_NO_DELTAS: "No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one \"#### Scenario:\" block. Tip: run \"opensdd change show <change-id> --json --deltas-only\" to inspect parsed deltas.";
+    readonly GUIDE_NO_DELTAS: "No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one \"#### Scenario:\" block. Tip: run \"codesdd change show <change-id> --json --deltas-only\" to inspect parsed deltas.";
     readonly GUIDE_MISSING_SPEC_SECTIONS: "Missing required sections. Expected headers: \"## Purpose\" and \"## Requirements\". Example:\n## Purpose\n[brief purpose]\n\n## Requirements\n### Requirement: Clear requirement statement\nUsers SHALL ...\n\n#### Scenario: Descriptive name\n- **WHEN** ...\n- **THEN** ...";
     readonly GUIDE_MISSING_CHANGE_SECTIONS: "Missing required sections. Expected headers: \"## Why\" and \"## What Changes\". Ensure deltas are documented in specs/ using delta headers.";
     readonly GUIDE_SCENARIO_FORMAT: "Scenarios must use level-4 headers. Convert bullet lists into:\n#### Scenario: Short name\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...";

package/dist/core/validation/constants.js

@@ -32,7 +32,7 @@ export const VALIDATION_MESSAGES = {
     DELTA_DESCRIPTION_TOO_BRIEF: 'Delta description is too brief',
     DELTA_MISSING_REQUIREMENTS: 'Delta should include requirements',
     // Guidance snippets (appended to primary messages for remediation)
-    GUIDE_NO_DELTAS: 'No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one "#### Scenario:" block. Tip: run "opensdd change show <change-id> --json --deltas-only" to inspect parsed deltas.',
+    GUIDE_NO_DELTAS: 'No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one "#### Scenario:" block. Tip: run "codesdd change show <change-id> --json --deltas-only" to inspect parsed deltas.',
     GUIDE_MISSING_SPEC_SECTIONS: 'Missing required sections. Expected headers: "## Purpose" and "## Requirements". Example:\n## Purpose\n[brief purpose]\n\n## Requirements\n### Requirement: Clear requirement statement\nUsers SHALL ...\n\n#### Scenario: Descriptive name\n- **WHEN** ...\n- **THEN** ...',
     GUIDE_MISSING_CHANGE_SECTIONS: 'Missing required sections. Expected headers: "## Why" and "## What Changes". Ensure deltas are documented in specs/ using delta headers.',
     GUIDE_SCENARIO_FORMAT: 'Scenarios must use level-4 headers. Convert bullet lists into:\n#### Scenario: Short name\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...',

package/dist/core/view.js

@@ -4,19 +4,19 @@ import chalk from 'chalk';
 import { getTaskProgressForChange } from '../utils/task-progress.js';
 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';
 export class ViewCommand {
     async execute(targetPath = '.') {
-        const openspecDir = resolveOpenSpecSubpath(targetPath);
-        if (!fs.existsSync(openspecDir)) {
-            console.error(chalk.red('No openspec directory found'));
+        const codesddDir = resolveLegacySpecSubpath(targetPath);
+        if (!fs.existsSync(codesddDir)) {
+            console.error(chalk.red('No codesdd directory found'));
             process.exit(1);
         }
-        console.log(chalk.bold('\nOpenSpec Dashboard\n'));
+        console.log(chalk.bold('\nCodeSDD Dashboard\n'));
         console.log('═'.repeat(60));
         // Get changes and specs data
-        const changesData = await this.getChangesData(openspecDir);
-        const specsData = await this.getSpecsData(openspecDir);
+        const changesData = await this.getChangesData(codesddDir);
+        const specsData = await this.getSpecsData(codesddDir);
         // Display summary metrics
         this.displaySummary(changesData, specsData);
         // Display draft changes
@@ -61,8 +61,8 @@ export class ViewCommand {
         console.log('\n' + '═'.repeat(60));
         console.log(chalk.dim(`\nUse ${chalk.white(`${CLI_NAME} list --changes`)} or ${chalk.white(`${CLI_NAME} list --specs`)} for detailed views`));
     }
-    async getChangesData(openspecDir) {
-        const changesDir = path.join(openspecDir, 'changes');
+    async getChangesData(codesddDir) {
+        const changesDir = path.join(codesddDir, 'changes');
         if (!fs.existsSync(changesDir)) {
             return { draft: [], active: [], completed: [] };
         }
@@ -102,8 +102,8 @@ export class ViewCommand {
         completed.sort((a, b) => a.name.localeCompare(b.name));
         return { draft, active, completed };
     }
-    async getSpecsData(openspecDir) {
-        const specsDir = path.join(openspecDir, 'specs');
+    async getSpecsData(codesddDir) {
+        const specsDir = path.join(codesddDir, 'specs');
         if (!fs.existsSync(specsDir)) {
             return [];
         }

package/dist/telemetry/config.d.ts

@@ -8,9 +8,10 @@ export interface GlobalConfig {
 }
 /**
  * Get the path to the global config file.
- * Uses ~/.config/openspec/config.json on all platforms.
+ * Uses ~/.codesdd/config.toml.
  */
 export declare function getConfigPath(): string;
+export declare function getLegacyConfigPath(): string;
 /**
  * Read the global config file.
  * Returns an empty object if the file doesn't exist.

package/dist/telemetry/config.js

@@ -1,17 +1,20 @@
 /**
  * Global configuration for telemetry state.
- * Stores anonymous ID and notice-seen flag in ~/.config/openspec/config.json
+ * Stores anonymous ID and notice-seen flag in ~/.codesdd/config.toml.
+ * The legacy XDG JSON path remains a read-only compatibility fallback.
  */
 import { promises as fs } from 'fs';
 import path from 'path';
-import os from 'os';
+import { getGlobalConfigPath, getLegacyGlobalConfigPath, parseTomlContent, stringifyTomlContent, } from '../core/global-config.js';
 /**
  * Get the path to the global config file.
- * Uses ~/.config/openspec/config.json on all platforms.
+ * Uses ~/.codesdd/config.toml.
  */
 export function getConfigPath() {
-    const configDir = path.join(os.homedir(), '.config', 'openspec');
-    return path.join(configDir, 'config.json');
+    return getGlobalConfigPath();
+}
+export function getLegacyConfigPath() {
+    return getLegacyGlobalConfigPath();
 }
 /**
  * Read the global config file.
@@ -21,11 +24,17 @@ export async function readConfig() {
     const configPath = getConfigPath();
     try {
         const content = await fs.readFile(configPath, 'utf-8');
-        return JSON.parse(content);
+        return parseTomlContent(content);
     }
     catch (error) {
         if (error.code === 'ENOENT') {
-            return {};
+            try {
+                const legacyContent = await fs.readFile(getLegacyConfigPath(), 'utf-8');
+                return JSON.parse(legacyContent);
+            }
+            catch {
+                return {};
+            }
         }
         // If parse fails or other error, return empty config
         return {};
@@ -47,7 +56,7 @@ export async function writeConfig(updates) {
     if (updates.telemetry && existing.telemetry) {
         merged.telemetry = { ...existing.telemetry, ...updates.telemetry };
     }
-    await fs.writeFile(configPath, JSON.stringify(merged, null, 2) + '\n');
+    await fs.writeFile(configPath, stringifyTomlContent(merged));
 }
 /**
  * Get the telemetry config section.

package/dist/telemetry/index.d.ts

@@ -1,8 +1,16 @@
+/**
+ * PostHog hardcodes `console.error('Error while flushing PostHog', err)` in
+ * its core flush path (see @posthog/core posthog-core-stateless.mjs L38).
+ * The library exposes no option to disable it, so we filter those specific
+ * lines at the console.error layer. Non-PostHog calls pass through unchanged.
+ */
+export declare function __installPosthogErrorSilencer(): void;
 /**
  * Check if telemetry is enabled.
  *
  * Disabled when:
- * - OPENSPEC_TELEMETRY=0
+ * - CODESDD_TELEMETRY=0
+ * - CODESDD_TELEMETRY=0 (legacy alias)
  * - DO_NOT_TRACK=1
  * - CI=true (any CI environment)
  */
@@ -16,7 +24,7 @@ export declare function getOrCreateAnonymousId(): Promise<string>;
  * Track a command execution.
  *
  * @param commandName - The command name (e.g., 'init', 'change:apply')
- * @param version - The OpenSpec version
+ * @param version - The CodeSDD version
  */
 export declare function trackCommand(commandName: string, version: string): Promise<void>;
 export declare function trackCommandCompleted(commandName: string, version: string, durationMs: number, status?: 'success' | 'error'): Promise<void>;

package/dist/telemetry/index.js

@@ -4,7 +4,7 @@
  * Privacy-first design:
  * - Only tracks command name and version
  * - No arguments, file paths, or content
- * - Opt-out via OPENSPEC_TELEMETRY=0 or DO_NOT_TRACK=1
+ * - Opt-out via CODESDD_TELEMETRY=0, legacy CODESDD_TELEMETRY=0, or DO_NOT_TRACK=1
  * - Auto-disabled in CI environments
  * - Anonymous ID is a random UUID with no relation to the user
  */
@@ -14,22 +14,49 @@ import { getTelemetryConfig, updateTelemetryConfig } from './config.js';
 // PostHog API key - public key for client-side analytics
 // This is safe to embed as it only allows sending events, not reading data
 const POSTHOG_API_KEY = 'phc_Hthu8YvaIJ9QaFKyTG4TbVwkbd5ktcAFzVTKeMmoW2g';
-// Using reverse proxy to avoid ad blockers and keep traffic on our domain
-const POSTHOG_HOST = 'https://edge.openspec.dev';
+// Legacy reverse proxy retained until the telemetry endpoint is renamed.
+const POSTHOG_HOST = 'https://edge.sdd.dev';
 let posthogClient = null;
 let anonymousId = null;
 const SHUTDOWN_TIMEOUT_MS = 200;
+let consoleErrorPatched = false;
+/**
+ * PostHog hardcodes `console.error('Error while flushing PostHog', err)` in
+ * its core flush path (see @posthog/core posthog-core-stateless.mjs L38).
+ * The library exposes no option to disable it, so we filter those specific
+ * lines at the console.error layer. Non-PostHog calls pass through unchanged.
+ */
+export function __installPosthogErrorSilencer() {
+    installPosthogErrorSilencer();
+}
+function installPosthogErrorSilencer() {
+    if (consoleErrorPatched)
+        return;
+    consoleErrorPatched = true;
+    const originalError = console.error.bind(console);
+    console.error = (...args) => {
+        const first = args[0];
+        if (typeof first === 'string' && first.startsWith('Error while flushing PostHog')) {
+            return;
+        }
+        originalError(...args);
+    };
+}
 /**
  * Check if telemetry is enabled.
  *
  * Disabled when:
- * - OPENSPEC_TELEMETRY=0
+ * - CODESDD_TELEMETRY=0
+ * - CODESDD_TELEMETRY=0 (legacy alias)
  * - DO_NOT_TRACK=1
  * - CI=true (any CI environment)
  */
 export function isTelemetryEnabled() {
     // Check explicit opt-out
-    if (process.env.OPENSPEC_TELEMETRY === '0') {
+    if (process.env.CODESDD_TELEMETRY === '0') {
+        return false;
+    }
+    if (process.env.CODESDD_TELEMETRY === '0') {
         return false;
     }
     // Respect DO_NOT_TRACK standard
@@ -72,11 +99,17 @@ export async function getOrCreateAnonymousId() {
  */
 function getClient() {
     if (!posthogClient) {
+        installPosthogErrorSilencer();
         posthogClient = new PostHog(POSTHOG_API_KEY, {
             host: POSTHOG_HOST,
             flushAt: 1, // Send immediately, don't batch
             flushInterval: 0, // No timer-based flushing
         });
+        if (typeof posthogClient.on === 'function') {
+            posthogClient.on('error', () => {
+                // Swallow emitted errors; PostHog logs them via console.error which is filtered.
+            });
+        }
     }
     return posthogClient;
 }
@@ -84,7 +117,7 @@ function getClient() {
  * Track a command execution.
  *
  * @param commandName - The command name (e.g., 'init', 'change:apply')
- * @param version - The OpenSpec version
+ * @param version - The CodeSDD version
  */
 export async function trackCommand(commandName, version) {
     if (!isTelemetryEnabled()) {
@@ -173,7 +206,7 @@ export async function maybeShowTelemetryNotice() {
             return;
         }
         // Display notice
-        console.log('Note: OpenSpec collects anonymous usage stats. Opt out: OPENSPEC_TELEMETRY=0');
+        console.log('Note: CodeSDD collects anonymous usage stats. Opt out: CODESDD_TELEMETRY=0');
         // Mark as seen
         await updateTelemetryConfig({ noticeSeen: true });
     }

package/dist/ui/ascii-patterns.d.ts

@@ -1,9 +1,9 @@
 /**
  * ASCII art animation patterns for the welcome screen.
- * OpenSpec logo animation - diamond/rhombus shape with hollow center "O".
+ * CodeSDD logo animation - diamond/rhombus shape with hollow center "O".
  */
 /**
- * Welcome animation frames - OpenSpec logo building from center
+ * Welcome animation frames - CodeSDD logo building from center
  * 7 rows × 6 columns diamond with hollow center "O"
  * Center bar is 2 cols × 3 rows (rows 3,4,5 cols 3,4)
  * Each frame is an array of strings (lines of ASCII art)

package/dist/ui/ascii-patterns.js

@@ -1,6 +1,6 @@
 /**
  * ASCII art animation patterns for the welcome screen.
- * OpenSpec logo animation - diamond/rhombus shape with hollow center "O".
+ * CodeSDD logo animation - diamond/rhombus shape with hollow center "O".
  */
 // Detect if full Unicode is supported
 const supportsUnicode = process.platform !== 'win32' ||
@@ -15,7 +15,7 @@ const _ = CHARS.empty;
 const F = CHARS.full;
 const D = CHARS.dim;
 /**
- * Welcome animation frames - OpenSpec logo building from center
+ * Welcome animation frames - CodeSDD logo building from center
  * 7 rows × 6 columns diamond with hollow center "O"
  * Center bar is 2 cols × 3 rows (rows 3,4,5 cols 3,4)
  * Each frame is an array of strings (lines of ASCII art)

package/dist/ui/welcome-screen.js

@@ -13,8 +13,8 @@ const ART_COLUMN_WIDTH = 24;
  */
 function getWelcomeText() {
     return [
-        chalk.white.bold('Welcome to OpenSpec'),
-        chalk.dim('A lightweight spec-driven framework'),
+        chalk.white.bold('Welcome to CodeSDD'),
+        chalk.dim('An AI-native spec-driven framework'),
         '',
         chalk.white('This setup will configure:'),
         chalk.dim('  • Agent Skills for AI tools'),

package/dist/utils/change-metadata.d.ts

@@ -17,7 +17,7 @@ export declare class ChangeMetadataError extends Error {
  */
 export declare function validateSchemaName(schemaName: string, projectRoot?: string): string;
 /**
- * Writes change metadata to .openspec.yaml in the change directory.
+ * Writes change metadata to .sdd.yaml in the change directory.
  *
  * @param changeDir - The path to the change directory
  * @param metadata - The metadata to write
@@ -26,7 +26,7 @@ export declare function validateSchemaName(schemaName: string, projectRoot?: str
  */
 export declare function writeChangeMetadata(changeDir: string, metadata: ChangeMetadata, projectRoot?: string): void;
 /**
- * Reads change metadata from .openspec.yaml in the change directory.
+ * Reads change metadata from .sdd.yaml in the change directory.
  *
  * @param changeDir - The path to the change directory
  * @param projectRoot - Optional project root for project-local schema resolution
@@ -39,8 +39,8 @@ export declare function readChangeMetadata(changeDir: string, projectRoot?: stri
  *
  * Resolution order:
  * 1. Explicit schema (if provided)
- * 2. Schema from .openspec.yaml metadata (if exists)
- * 3. Schema from openspec/config.yaml (if exists)
+ * 2. Schema from .sdd.yaml metadata (if exists)
+ * 3. Schema from legacy-spec/config.yaml (if exists)
  * 4. Default 'spec-driven'
  *
  * @param changeDir - The path to the change directory

package/dist/utils/change-metadata.js

@@ -4,7 +4,7 @@ import * as yaml from 'yaml';
 import { ChangeMetadataSchema } from '../core/artifact-graph/types.js';
 import { listSchemas } from '../core/artifact-graph/resolver.js';
 import { readProjectConfig } from '../core/project-config.js';
-const METADATA_FILENAME = '.openspec.yaml';
+const METADATA_FILENAME = '.sdd.yaml';
 /**
  * Error thrown when change metadata validation fails.
  */
@@ -34,7 +34,7 @@ export function validateSchemaName(schemaName, projectRoot) {
     return schemaName;
 }
 /**
- * Writes change metadata to .openspec.yaml in the change directory.
+ * Writes change metadata to .sdd.yaml in the change directory.
  *
  * @param changeDir - The path to the change directory
  * @param metadata - The metadata to write
@@ -61,7 +61,7 @@ export function writeChangeMetadata(changeDir, metadata, projectRoot) {
     }
 }
 /**
- * Reads change metadata from .openspec.yaml in the change directory.
+ * Reads change metadata from .sdd.yaml in the change directory.
  *
  * @param changeDir - The path to the change directory
  * @param projectRoot - Optional project root for project-local schema resolution
@@ -106,8 +106,8 @@ export function readChangeMetadata(changeDir, projectRoot) {
  *
  * Resolution order:
  * 1. Explicit schema (if provided)
- * 2. Schema from .openspec.yaml metadata (if exists)
- * 3. Schema from openspec/config.yaml (if exists)
+ * 2. Schema from .sdd.yaml metadata (if exists)
+ * 3. Schema from legacy-spec/config.yaml (if exists)
  * 4. Default 'spec-driven'
  *
  * @param changeDir - The path to the change directory
@@ -115,7 +115,7 @@ export function readChangeMetadata(changeDir, projectRoot) {
  * @returns The resolved schema name
  */
 export function resolveSchemaForChange(changeDir, explicitSchema) {
-    // Derive project root from changeDir (changeDir is typically projectRoot/openspec/changes/change-name)
+    // Derive project root from changeDir (changeDir is typically projectRoot/legacy-spec/changes/change-name)
     const projectRoot = path.resolve(changeDir, '../../..');
     // 1. Explicit override wins
     if (explicitSchema) {

package/dist/utils/change-utils.d.ts

@@ -39,7 +39,7 @@ export declare function validateChangeName(name: string): ValidationResult;
 /**
  * Creates a new change directory with metadata file.
  *
- * @param projectRoot - The root directory of the project (where `openspec/` lives)
+ * @param projectRoot - The root directory of a project with compatibility `legacy-spec/` artifacts
  * @param name - The change name (must be valid kebab-case)
  * @param options - Optional settings for the change
  * @throws Error if the change name is invalid
@@ -49,12 +49,12 @@ export declare function validateChangeName(name: string): ValidationResult;
  * @returns Result containing the resolved schema name
  *
  * @example
- * // Creates openspec/changes/add-auth/ with default schema
+ * // Creates compatibility legacy-spec/changes/add-auth/ with default schema
  * const result = await createChange('/path/to/project', 'add-auth')
  * console.log(result.schema) // 'spec-driven' or value from config
  *
  * @example
- * // Creates openspec/changes/add-auth/ with custom schema
+ * // Creates compatibility legacy-spec/changes/add-auth/ with custom schema
  * const result = await createChange('/path/to/project', 'add-auth', { schema: 'my-workflow' })
  * console.log(result.schema) // 'my-workflow'
  */

package/dist/utils/change-utils.js

@@ -1,7 +1,7 @@
 import { FileSystemUtils } from './file-system.js';
 import { writeChangeMetadata, validateSchemaName } from './change-metadata.js';
 import { readProjectConfig } from '../core/project-config.js';
-import { resolveOpenSpecLiveSubpath } from '../core/sdd/services/legacy-capability.service.js';
+import { resolveLegacySpecLiveSubpath } from '../core/sdd/services/legacy-capability.service.js';
 const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Validates that a change name follows kebab-case conventions.
@@ -59,7 +59,7 @@ export function validateChangeName(name) {
 /**
  * Creates a new change directory with metadata file.
  *
- * @param projectRoot - The root directory of the project (where `openspec/` lives)
+ * @param projectRoot - The root directory of a project with compatibility `legacy-spec/` artifacts
  * @param name - The change name (must be valid kebab-case)
  * @param options - Optional settings for the change
  * @throws Error if the change name is invalid
@@ -69,12 +69,12 @@ export function validateChangeName(name) {
  * @returns Result containing the resolved schema name
  *
  * @example
- * // Creates openspec/changes/add-auth/ with default schema
+ * // Creates compatibility legacy-spec/changes/add-auth/ with default schema
  * const result = await createChange('/path/to/project', 'add-auth')
  * console.log(result.schema) // 'spec-driven' or value from config
  *
  * @example
- * // Creates openspec/changes/add-auth/ with custom schema
+ * // Creates compatibility legacy-spec/changes/add-auth/ with custom schema
  * const result = await createChange('/path/to/project', 'add-auth', { schema: 'my-workflow' })
  * console.log(result.schema) // 'my-workflow'
  */
@@ -103,7 +103,7 @@ export async function createChange(projectRoot, name, options = {}) {
     // Validate the resolved schema
     validateSchemaName(schemaName, projectRoot);
     // Build the change directory path
-    const changeDir = resolveOpenSpecLiveSubpath(projectRoot, 'changes', name);
+    const changeDir = resolveLegacySpecLiveSubpath(projectRoot, 'changes', name);
     // Check if change already exists
     if (await FileSystemUtils.directoryExists(changeDir)) {
         throw new Error(`Change '${name}' already exists at ${changeDir}`);

package/dist/utils/file-system.js

@@ -204,7 +204,7 @@ export class FileSystemUtils {
                 }
                 return await this.ensureWritePermissions(parentDir);
             }
-            const testFile = path.join(dirPath, '.openspec-test-' + Date.now() + '-' + Math.random().toString(36).slice(2));
+            const testFile = path.join(dirPath, '.sdd-test-' + Date.now() + '-' + Math.random().toString(36).slice(2));
             await fs.writeFile(testFile, '');
             // On Windows, file may be temporarily locked by antivirus or indexing services.
             // Retry unlink with a small delay if it fails.

package/dist/utils/interactive.js

@@ -11,7 +11,7 @@ export function resolveNoInteractive(value) {
 export function isInteractive(value) {
     if (resolveNoInteractive(value))
         return false;
-    if (process.env.OPEN_SPEC_INTERACTIVE === '0')
+    if (process.env.CODESDD_INTERACTIVE === '0')
         return false;
     // Respect the standard CI environment variable (set by GitHub Actions, GitLab CI, Travis, etc.)
     if ('CI' in process.env)

package/dist/utils/item-discovery.js

@@ -1,8 +1,8 @@
 import { promises as fs } from 'fs';
 import path from 'path';
-import { resolveOpenSpecSubpath } from '../core/sdd/services/legacy-capability.service.js';
+import { resolveLegacySpecSubpath } from '../core/sdd/services/legacy-capability.service.js';
 export async function getActiveChangeIds(root = process.cwd()) {
-    const changesPath = resolveOpenSpecSubpath(root, 'changes');
+    const changesPath = resolveLegacySpecSubpath(root, 'changes');
     try {
         const entries = await fs.readdir(changesPath, { withFileTypes: true });
         const result = [];
@@ -25,7 +25,7 @@ export async function getActiveChangeIds(root = process.cwd()) {
     }
 }
 export async function getSpecIds(root = process.cwd()) {
-    const specsPath = resolveOpenSpecSubpath(root, 'specs');
+    const specsPath = resolveLegacySpecSubpath(root, 'specs');
     const result = [];
     try {
         const entries = await fs.readdir(specsPath, { withFileTypes: true });
@@ -48,7 +48,7 @@ export async function getSpecIds(root = process.cwd()) {
     return result.sort();
 }
 export async function getArchivedChangeIds(root = process.cwd()) {
-    const archivePath = resolveOpenSpecSubpath(root, 'changes', 'archive');
+    const archivePath = resolveLegacySpecSubpath(root, 'changes', 'archive');
     try {
         const entries = await fs.readdir(archivePath, { withFileTypes: true });
         const result = [];

package/dist/utils/legacy-spec-compat.d.ts

@@ -0,0 +1,2 @@
+export { IMPORTED_LEGACY_SPEC_DIR, LEGACY_SPEC_DIR, LEGACY_SPEC_CAPABILITY, displayLegacyCapabilityPath, displayLegacySpecPath, resolveLegacyCapabilityDeprecatedLiveRoots, resolveLegacyCapabilityImportedRoot, resolveLegacyCapabilityDeprecatedImportedRoots, resolveLegacyCapabilityImportedDepositoRoot, resolveLegacyCapabilityLiveSubpath, resolveLegacyCapabilityLiveRoot, resolveLegacyCapabilityRoot, resolveLegacyCapabilitySubpath, resolveLegacySpecLiveSubpath, resolveLegacySpecLiveRoot, resolveLegacySpecRoot, resolveLegacySpecSubpath, type LegacyCapabilityDefinition, } from '../core/sdd/services/legacy-capability.service.js';
+//# sourceMappingURL=legacy-spec-compat.d.ts.map

package/dist/utils/legacy-spec-compat.js

@@ -0,0 +1,2 @@
+export { IMPORTED_LEGACY_SPEC_DIR, LEGACY_SPEC_DIR, LEGACY_SPEC_CAPABILITY, displayLegacyCapabilityPath, displayLegacySpecPath, resolveLegacyCapabilityDeprecatedLiveRoots, resolveLegacyCapabilityImportedRoot, resolveLegacyCapabilityDeprecatedImportedRoots, resolveLegacyCapabilityImportedDepositoRoot, resolveLegacyCapabilityLiveSubpath, resolveLegacyCapabilityLiveRoot, resolveLegacyCapabilityRoot, resolveLegacyCapabilitySubpath, resolveLegacySpecLiveSubpath, resolveLegacySpecLiveRoot, resolveLegacySpecRoot, resolveLegacySpecSubpath, } from '../core/sdd/services/legacy-capability.service.js';
+//# sourceMappingURL=legacy-spec-compat.js.map

package/dist/utils/shell-detection.d.ts

@@ -17,4 +17,5 @@ export interface ShellDetectionResult {
  * @returns Detection result with supported shell and raw detected name
  */
 export declare function detectShell(): ShellDetectionResult;
+export declare function resolveShellProfilePath(shell: SupportedShell, homeDir?: string): string | undefined;
 //# sourceMappingURL=shell-detection.d.ts.map