@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/dist/commands/completion.d.ts

@@ -13,7 +13,7 @@ interface CompleteOptions {
     type: string;
 }
 /**
- * Command for managing shell completions for OpenSpec CLI
+ * Command for managing shell completions for CodeSDD CLI
  */
 export declare class CompletionCommand {
     private completionProvider;

package/dist/commands/completion.js

@@ -6,7 +6,7 @@ import { CompletionProvider } from '../core/completions/completion-provider.js';
 import { getArchivedChangeIds } from '../utils/item-discovery.js';
 import { CLI_NAME } from '../core/branding.js';
 /**
- * Command for managing shell completions for OpenSpec CLI
+ * Command for managing shell completions for CodeSDD CLI
  */
 export class CompletionCommand {
     completionProvider;
@@ -180,7 +180,7 @@ export class CompletionCommand {
             };
             const configPath = configPaths[shell] || `${shell} configuration`;
             const confirmed = await confirm({
-                message: `Remove OpenSpec configuration from ${configPath}?`,
+                message: `Remove CodeSDD configuration from ${configPath}?`,
                 default: false,
             });
             if (!confirmed) {
@@ -237,6 +237,13 @@ export class CompletionCommand {
                     }
                     break;
                 }
+                case 'schemas': {
+                    const schemaNames = await this.completionProvider.getSchemaNames();
+                    for (const name of schemaNames) {
+                        console.log(`${name}\tworkflow schema`);
+                    }
+                    break;
+                }
                 default:
                     // Invalid type - silently exit with no output for graceful shell completion failure
                     process.exitCode = 1;

package/dist/commands/config.js

@@ -1,12 +1,17 @@
 import { spawn, execSync } from 'node:child_process';
 import * as fs from 'node:fs';
+import * as os from 'node:os';
 import * as path from 'node:path';
-import { getGlobalConfigPath, getGlobalConfig, saveGlobalConfig, } from '../core/global-config.js';
-import { getNestedValue, setNestedValue, deleteNestedValue, coerceValue, formatValueYaml, validateConfigKeyPath, validateConfig, DEFAULT_CONFIG, } from '../core/config-schema.js';
+import { getGlobalConfigPath, getGlobalConfig, getGlobalCacheDir, getGlobalCacheTierDirs, ensureGlobalCacheLayout, readGlobalConfigRaw, parseTomlContent, saveGlobalConfig, } from '../core/global-config.js';
+import { getNestedValue, setNestedValue, deleteNestedValue, coerceValue, formatValueYaml, validateConfigKeyPath, validateConfig, isSensitiveConfigPath, redactConfigSecrets, DEFAULT_CONFIG, } from '../core/config-schema.js';
 import { CORE_WORKFLOWS, ALL_WORKFLOWS, getProfileWorkflows } from '../core/profiles.js';
-import { OPENSPEC_DIR_NAME } from '../core/config.js';
 import { hasProjectConfigDrift } from '../core/profile-sync-drift.js';
 import { CLI_NAME } from '../core/branding.js';
+import { resolveLegacySpecLiveRoot } from '../core/sdd/services/legacy-capability.service.js';
+import { resolveRedisBoundaryConfig } from '../core/sdd/coordination/index.js';
+import { buildDeepAgentsOperationalPreflight, createDeepAgentsPolicySnapshot, } from '../core/sdd/deepagents/policy.js';
+import { detectShell } from '../utils/shell-detection.js';
+import { ZshInstaller } from '../core/completions/installers/zsh-installer.js';
 const WORKFLOW_PROMPT_META = {
     propose: {
         name: 'Propose change',
@@ -50,9 +55,33 @@ const WORKFLOW_PROMPT_META = {
     },
     onboard: {
         name: 'Onboard',
-        description: 'Guided onboarding flow for OpenSpec',
+        description: 'Guided onboarding flow for CodeSDD',
     },
 };
+function resolveHomeDir() {
+    return process.env.HOME || process.env.USERPROFILE || os.homedir();
+}
+function buildCodesddEnvTemplate() {
+    return [
+        '#!/usr/bin/env zsh',
+        '# CodeSDD global runtime profile (non-secret settings only).',
+        'export CODESDD_AGENT_PROVIDER="${CODESDD_AGENT_PROVIDER:-deepagents}"',
+        'export CODESDD_DEEPAGENTS_ENABLED="${CODESDD_DEEPAGENTS_ENABLED:-false}"',
+        'export CODESDD_DEEPAGENTS_RUNTIME="${CODESDD_DEEPAGENTS_RUNTIME:-disabled}"',
+        'export CODESDD_AGENT_NETWORK_POLICY="${CODESDD_AGENT_NETWORK_POLICY:-disabled}"',
+        'export CODESDD_DEEPAGENTS_PROVIDER_SMOKE="${CODESDD_DEEPAGENTS_PROVIDER_SMOKE:-0}"',
+        '# Optional live-provider launcher references. Keep values in your shell,',
+        '# password manager, CI secret store, or another untracked launcher context.',
+        '# export CODESDD_DEEPAGENTS_ENABLED=true',
+        '# export CODESDD_DEEPAGENTS_RUNTIME=deepagents-js',
+        '# export CODESDD_AGENT_NETWORK_POLICY=restricted',
+        '# export CODESDD_DEEPAGENTS_MODEL="azure-openai:gpt-4o-mini"',
+        '# export CODESDD_AGENT_ALLOWED_DOMAINS="api.openai.com"',
+        '# export AZURE_OPENAI_ENDPOINT="https://example-resource.openai.azure.com/"',
+        '# export AZURE_OPENAI_API_KEY="<secret-from-manager>"',
+        '',
+    ].join('\n');
+}
 function isPromptCancellationError(error) {
     return (error instanceof Error &&
         (error.name === 'ExitPromptError' || error.message.includes('force closed the prompt with SIGINT')));
@@ -134,8 +163,8 @@ export function diffProfileState(before, after) {
     };
 }
 function maybeWarnConfigDrift(projectDir, state, colorize) {
-    const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
-    if (!fs.existsSync(openspecDir)) {
+    const codesddDir = resolveLegacySpecLiveRoot(projectDir);
+    if (!fs.existsSync(codesddDir)) {
         return;
     }
     if (!hasProjectConfigDrift(projectDir, state.workflows, state.delivery)) {
@@ -151,7 +180,7 @@ function maybeWarnConfigDrift(projectDir, state, colorize) {
 export function registerConfigCommand(program) {
     const configCmd = program
         .command('config')
-        .description('View and modify global OpenSpec configuration')
+        .description('View and modify global CodeSDD configuration')
         .option('--scope <scope>', 'Config scope (only "global" supported currently)')
         .hook('preAction', (thisCommand) => {
         const opts = thisCommand.opts();
@@ -167,6 +196,101 @@ export function registerConfigCommand(program) {
         .action(() => {
         console.log(getGlobalConfigPath());
     });
+    // config init
+    configCmd
+        .command('init')
+        .description('Initialize ~/.codesdd runtime files and idempotent shell integration')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const homeDir = resolveHomeDir();
+        const configPath = getGlobalConfigPath();
+        const envPath = path.join(homeDir, '.codesdd', 'env.zsh');
+        if (!fs.existsSync(configPath)) {
+            saveGlobalConfig(getGlobalConfig());
+        }
+        const tierPaths = ensureGlobalCacheLayout();
+        const envTemplate = buildCodesddEnvTemplate();
+        if (!fs.existsSync(path.dirname(envPath))) {
+            fs.mkdirSync(path.dirname(envPath), { recursive: true });
+        }
+        fs.writeFileSync(envPath, envTemplate, { encoding: 'utf-8', mode: 0o600 });
+        try {
+            fs.chmodSync(envPath, 0o600);
+        }
+        catch {
+            // best effort on non-POSIX filesystems
+        }
+        const detectedShell = detectShell().shell;
+        let zshrcConfigured = false;
+        if (detectedShell === 'zsh' || process.env.SHELL?.toLowerCase().includes('zsh')) {
+            const installer = new ZshInstaller(homeDir);
+            zshrcConfigured = await installer.ensureCodesddEnvSource(envPath);
+        }
+        const payload = {
+            schema_version: 1,
+            config_path: configPath,
+            env_path: envPath,
+            cache_root: getGlobalCacheDir(),
+            cache_tiers: Object.keys(tierPaths),
+            shell_detected: detectedShell ?? 'unknown',
+            zshrc_configured: zshrcConfigured,
+        };
+        if (options.json) {
+            console.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        console.log(`Config file: ${configPath}`);
+        console.log(`Shell profile: ${envPath}`);
+        console.log(`Cache root: ${payload.cache_root}`);
+        console.log(`Cache tiers: ${payload.cache_tiers.join(', ')}`);
+        if (detectedShell === 'zsh') {
+            console.log('Zsh source block ensured for ~/.codesdd/env.zsh.');
+        }
+        else {
+            console.log('Shell source block was not changed automatically (non-zsh or undetected shell).');
+        }
+    });
+    // config doctor
+    configCmd
+        .command('doctor')
+        .description('Run operational readiness checks for DeepAgents/Azure, cache, and Redis boundary')
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        const snapshot = createDeepAgentsPolicySnapshot(process.env);
+        const preflight = buildDeepAgentsOperationalPreflight(snapshot, process.env);
+        const redisBoundary = resolveRedisBoundaryConfig(process.env);
+        const cacheTiers = getGlobalCacheTierDirs();
+        const report = {
+            schema_version: 1,
+            global_config_path: getGlobalConfigPath(),
+            cache: {
+                root: getGlobalCacheDir(),
+                tiers: Object.keys(cacheTiers),
+            },
+            redis: {
+                requested: redisBoundary.requested,
+                namespace: redisBoundary.namespace,
+                status: redisBoundary.requested ? 'requested-unavailable' : 'disabled',
+            },
+            deepagents: preflight,
+        };
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(`Global config: ${report.global_config_path}`);
+            console.log(`Cache root: ${report.cache.root}`);
+            console.log(`Cache tiers: ${report.cache.tiers.join(', ')}`);
+            console.log(`Redis: ${report.redis.status} (namespace=${report.redis.namespace})`);
+            console.log(`DeepAgents preflight: ${preflight.status}`);
+            for (const reason of preflight.reasons) {
+                console.log(`- ${reason}`);
+            }
+        }
+        if (preflight.status === 'blocked') {
+            process.exitCode = 1;
+        }
+    });
     // config list
     configCmd
         .command('list')
@@ -174,22 +298,20 @@ export function registerConfigCommand(program) {
         .option('--json', 'Output as JSON')
         .action((options) => {
         const config = getGlobalConfig();
+        const redactedConfig = redactConfigSecrets(config);
         if (options.json) {
-            console.log(JSON.stringify(config, null, 2));
+            console.log(JSON.stringify(redactedConfig, null, 2));
         }
         else {
             // Read raw config to determine which values are explicit vs defaults
-            const configPath = getGlobalConfigPath();
             let rawConfig = {};
             try {
-                if (fs.existsSync(configPath)) {
-                    rawConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                }
+                rawConfig = readGlobalConfigRaw();
             }
             catch {
                 // If reading fails, treat all as defaults
             }
-            console.log(formatValueYaml(config));
+            console.log(formatValueYaml(redactedConfig));
             // Annotate profile settings
             const profileSource = rawConfig.profile !== undefined ? '(explicit)' : '(default)';
             const deliverySource = rawConfig.delivery !== undefined ? '(explicit)' : '(default)';
@@ -205,6 +327,15 @@ export function registerConfigCommand(program) {
             else {
                 console.log(`  workflows: (none)`);
             }
+            const cacheTiers = getGlobalCacheTierDirs();
+            console.log(`\nCache settings:`);
+            console.log(`  root: ${getGlobalCacheDir()}`);
+            console.log(`  tiers: ${Object.keys(cacheTiers).join(', ')}`);
+            const redisBoundary = resolveRedisBoundaryConfig(process.env);
+            const redisStatus = redisBoundary.requested ? 'requested-unavailable (filesystem-first fallback)' : 'disabled';
+            console.log(`\nRedis boundary:`);
+            console.log(`  status: ${redisStatus}`);
+            console.log(`  namespace: ${redisBoundary.namespace}`);
         }
     });
     // config get
@@ -218,6 +349,10 @@ export function registerConfigCommand(program) {
             process.exitCode = 1;
             return;
         }
+        if (isSensitiveConfigPath(key)) {
+            console.log('[REDACTED]');
+            return;
+        }
         if (typeof value === 'object' && value !== null) {
             console.log(JSON.stringify(value));
         }
@@ -257,7 +392,11 @@ export function registerConfigCommand(program) {
         // Apply changes and save
         setNestedValue(config, key, coercedValue);
         saveGlobalConfig(config);
-        const displayValue = typeof coercedValue === 'string' ? `"${coercedValue}"` : String(coercedValue);
+        const displayValue = isSensitiveConfigPath(key)
+            ? '[REDACTED]'
+            : typeof coercedValue === 'string'
+                ? `"${coercedValue}"`
+                : String(coercedValue);
         console.log(`Set ${key} = ${displayValue}`);
     });
     // config unset
@@ -351,7 +490,7 @@ export function registerConfigCommand(program) {
         });
         try {
             const rawConfig = fs.readFileSync(configPath, 'utf-8');
-            const parsedConfig = JSON.parse(rawConfig);
+            const parsedConfig = parseTomlContent(rawConfig);
             const validation = validateConfig(parsedConfig);
             if (!validation.success) {
                 console.error(`Error: Invalid configuration - ${validation.error}`);
@@ -363,7 +502,7 @@ export function registerConfigCommand(program) {
                 console.error(`Error: Config file not found at ${configPath}`);
             }
             else if (error instanceof SyntaxError) {
-                console.error(`Error: Invalid JSON in ${configPath}`);
+                console.error(`Error: Invalid TOML in ${configPath}`);
                 console.error(error.message);
             }
             else {
@@ -377,7 +516,7 @@ export function registerConfigCommand(program) {
         .command('profile [preset]')
         .description('Configure workflow profile (interactive picker or preset shortcut)')
         .action(async (preset) => {
-        // Preset shortcut: `openspec config profile core`
+        // Preset shortcut: `codesdd config profile core`
         if (preset === 'core') {
             const config = getGlobalConfig();
             config.profile = 'core';
@@ -517,10 +656,10 @@ export function registerConfigCommand(program) {
             config.delivery = nextState.delivery;
             config.workflows = nextState.workflows;
             saveGlobalConfig(config);
-            // Check if inside an OpenSpec project
+            // Check if inside a legacy spec compatibility project
             const projectDir = process.cwd();
-            const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
-            if (fs.existsSync(openspecDir)) {
+            const codesddDir = resolveLegacySpecLiveRoot(projectDir);
+            if (fs.existsSync(codesddDir)) {
                 const applyNow = await confirm({
                     message: 'Apply changes to this project now?',
                     default: true,

package/dist/commands/feedback.js

@@ -30,7 +30,7 @@ function isGhAuthenticated() {
     }
 }
 /**
- * Get OpenSDD version from package.json
+ * Get CodeSDD version from package.json
  */
 function getVersion() {
     try {

package/dist/commands/schema.d.ts

@@ -1,6 +1,69 @@
 import { Command } from 'commander';
+/**
+ * Schema source location type
+ */
+export type SchemaSource = 'project' | 'user' | 'package';
+/**
+ * Result of checking a schema location
+ */
+export interface SchemaLocation {
+    source: SchemaSource;
+    path: string;
+    exists: boolean;
+}
+/**
+ * Schema resolution info with shadowing details
+ */
+export interface SchemaResolution {
+    name: string;
+    source: SchemaSource;
+    path: string;
+    shadows: Array<{
+        source: SchemaSource;
+        path: string;
+    }>;
+}
+/**
+ * Validation issue structure
+ */
+export interface ValidationIssue {
+    level: 'error' | 'warning';
+    path: string;
+    message: string;
+}
+/**
+ * Check all three locations for a schema and return which ones exist.
+ */
+export declare function checkAllLocations(name: string, projectRoot: string): SchemaLocation[];
+/**
+ * Get resolution info for a schema including shadow detection.
+ */
+export declare function getSchemaResolution(name: string, projectRoot: string): SchemaResolution | null;
+/**
+ * Get all schemas with resolution info.
+ */
+export declare function getAllSchemasWithResolution(projectRoot: string): SchemaResolution[];
+/**
+ * Validate a schema and return issues.
+ */
+export declare function validateSchema(schemaDir: string, verbose?: boolean): {
+    valid: boolean;
+    issues: ValidationIssue[];
+};
+/**
+ * Validate schema name format (kebab-case).
+ */
+export declare function isValidSchemaName(name: string): boolean;
+/**
+ * Copy a directory recursively.
+ */
+export declare function copyDirRecursive(src: string, dest: string): void;
 /**
  * Register the schema command and all its subcommands.
  */
 export declare function registerSchemaCommand(program: Command): void;
+/**
+ * Create default template content for an artifact.
+ */
+export declare function createDefaultTemplate(artifactId: string): string;
 //# sourceMappingURL=schema.d.ts.map

package/dist/commands/schema.js

@@ -4,11 +4,11 @@ import ora from 'ora';
 import { stringify as stringifyYaml } from 'yaml';
 import { getSchemaDir, getProjectSchemasDir, getUserSchemasDir, getPackageSchemasDir, listSchemas, } from '../core/artifact-graph/resolver.js';
 import { parseSchema, SchemaValidationError } from '../core/artifact-graph/schema.js';
-import { resolveOpenSpecLiveSubpath } from '../core/sdd/services/legacy-capability.service.js';
+import { resolveLegacySpecLiveSubpath } from '../core/sdd/services/legacy-capability.service.js';
 /**
  * Check all three locations for a schema and return which ones exist.
  */
-function checkAllLocations(name, projectRoot) {
+export function checkAllLocations(name, projectRoot) {
     const locations = [];
     // Project location
     const projectDir = path.join(getProjectSchemasDir(projectRoot), name);
@@ -39,7 +39,7 @@ function checkAllLocations(name, projectRoot) {
 /**
  * Get resolution info for a schema including shadow detection.
  */
-function getSchemaResolution(name, projectRoot) {
+export function getSchemaResolution(name, projectRoot) {
     const locations = checkAllLocations(name, projectRoot);
     const existingLocations = locations.filter((loc) => loc.exists);
     if (existingLocations.length === 0) {
@@ -60,7 +60,7 @@ function getSchemaResolution(name, projectRoot) {
 /**
  * Get all schemas with resolution info.
  */
-function getAllSchemasWithResolution(projectRoot) {
+export function getAllSchemasWithResolution(projectRoot) {
     const schemaNames = listSchemas(projectRoot);
     const results = [];
     for (const name of schemaNames) {
@@ -74,7 +74,7 @@ function getAllSchemasWithResolution(projectRoot) {
 /**
  * Validate a schema and return issues.
  */
-function validateSchema(schemaDir, verbose = false) {
+export function validateSchema(schemaDir, verbose = false) {
     const issues = [];
     const schemaPath = path.join(schemaDir, 'schema.yaml');
     // Check schema.yaml exists
@@ -157,13 +157,13 @@ function validateSchema(schemaDir, verbose = false) {
 /**
  * Validate schema name format (kebab-case).
  */
-function isValidSchemaName(name) {
+export function isValidSchemaName(name) {
     return /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(name);
 }
 /**
  * Copy a directory recursively.
  */
-function copyDirRecursive(src, dest) {
+export function copyDirRecursive(src, dest) {
     fs.mkdirSync(dest, { recursive: true });
     const entries = fs.readdirSync(src, { withFileTypes: true });
     for (const entry of entries) {
@@ -592,12 +592,12 @@ export function registerSchemaCommand(program) {
                         console.log(JSON.stringify({
                             created: false,
                             error: `Schema '${name}' already exists`,
-                            suggestion: 'Use --force to overwrite or "openspec schema fork" to copy',
+                            suggestion: 'Use --force to overwrite or "codesdd schema fork" to copy',
                         }, null, 2));
                     }
                     else {
                         console.error(`Error: Schema '${name}' already exists at ${schemaDir}`);
-                        console.error('Use --force to overwrite or "openspec schema fork" to copy');
+                        console.error('Use --force to overwrite or "codesdd schema fork" to copy');
                     }
                     process.exitCode = 1;
                     return;
@@ -734,7 +734,7 @@ export function registerSchemaCommand(program) {
             }
             // Update config if --default
             if (options?.default) {
-                const configPath = resolveOpenSpecLiveSubpath(projectRoot, 'config.yaml');
+                const configPath = resolveLegacySpecLiveSubpath(projectRoot, 'config.yaml');
                 if (fs.existsSync(configPath)) {
                     const { parse: parseYaml, stringify: stringifyYaml2 } = await import('yaml');
                     const configContent = fs.readFileSync(configPath, 'utf-8');
@@ -771,7 +771,7 @@ export function registerSchemaCommand(program) {
                 console.log(`\nNext steps:`);
                 console.log(`  1. Edit ${schemaDir}/schema.yaml to customize artifacts`);
                 console.log(`  2. Modify templates in the schema directory`);
-                console.log(`  3. Use with: openspec new --schema ${name}`);
+                console.log(`  3. Use with: codesdd new --schema ${name}`);
             }
         }
         catch (error) {
@@ -793,7 +793,7 @@ export function registerSchemaCommand(program) {
 /**
  * Create default template content for an artifact.
  */
-function createDefaultTemplate(artifactId) {
+export function createDefaultTemplate(artifactId) {
     switch (artifactId) {
         case 'proposal':
             return `## Why

package/dist/commands/sdd/backlog.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerBacklogCommands(sddCmd: Command): void;
+//# sourceMappingURL=backlog.d.ts.map

package/dist/commands/sdd/backlog.js

@@ -0,0 +1,54 @@
+import chalk from 'chalk';
+import { buildBacklogProjectDryRun, } from '../../core/sdd/backlog-cli.js';
+export function registerBacklogCommands(sddCmd) {
+    const backlogCmd = sddCmd.command('backlog').description('Plan external backlog projections without provider writes');
+    backlogCmd
+        .command('project')
+        .description('Build a dry-run projection plan for an external backlog provider')
+        .requiredOption('--provider <provider>', 'Backlog provider id, for example azure-devops')
+        .requiredOption('--ref <ref>', 'Canonical SDD ref to project, for example EPIC-0039')
+        .option('--json', 'Return the dry-run projection plan as JSON')
+        .action(async (options) => {
+        try {
+            const result = buildBacklogProjectDryRun({
+                provider: options.provider,
+                ref: options.ref,
+            });
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            printBacklogProjectDryRun(result);
+        }
+        catch (error) {
+            console.error(chalk.red(`Error: ${formatBacklogError(error)}`));
+            process.exitCode = 1;
+        }
+    });
+}
+function formatBacklogError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function printBacklogProjectDryRun(result) {
+    const { plan } = result;
+    console.log(chalk.green(`Backlog projection dry-run: ${plan.provider}`));
+    console.log(`Ref: ${result.ref}`);
+    console.log(`Mode: ${plan.mode}`);
+    console.log(`Direction: ${plan.direction}`);
+    console.log(`Source of truth: ${plan.source_of_truth}`);
+    console.log(`Items: ${plan.items.length}`);
+    console.log(`Operations: ${summarizeOperations(plan.items.map((item) => item.operation))}`);
+    if (plan.warnings.length > 0) {
+        console.log(`Warnings: ${plan.warnings.join(' | ')}`);
+    }
+}
+function summarizeOperations(operations) {
+    const counts = new Map();
+    for (const operation of operations) {
+        counts.set(operation, (counts.get(operation) ?? 0) + 1);
+    }
+    return Array.from(counts.entries())
+        .map(([operation, count]) => `${operation}=${count}`)
+        .join(', ');
+}
+//# sourceMappingURL=backlog.js.map