@evolith/smart-cli 0.0.1-beta

package/dist/infrastructure/formatters/output-formatter.service.js

@@ -0,0 +1,198 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputFormatterService = void 0;
+class OutputFormatterService {
+    format(data, options) {
+        switch (options.format) {
+            case 'table':
+                return this.formatTable(data, options);
+            case 'yaml':
+                return this.formatYaml(data, options);
+            case 'markdown':
+                return this.formatMarkdown(data, options);
+            case 'json':
+            default:
+                return this.formatJson(data, options);
+        }
+    }
+    formatJson(data, _options) {
+        return JSON.stringify(data, null, 2);
+    }
+    formatYaml(data, _options) {
+        try {
+            return this.toYaml(data);
+        }
+        catch {
+            return this.formatJson(data, _options);
+        }
+    }
+    formatMarkdown(data, _options) {
+        if (Array.isArray(data)) {
+            return this.tableToMarkdown(data);
+        }
+        if (typeof data === 'object' && data !== null) {
+            return this.objectToMarkdown(data);
+        }
+        return String(data);
+    }
+    formatTable(data, options) {
+        if (Array.isArray(data)) {
+            return this.arrayToTable(data, options);
+        }
+        if (typeof data === 'object' && data !== null) {
+            return this.objectToTable(data, options);
+        }
+        return String(data);
+    }
+    arrayToTable(data, options) {
+        if (data.length === 0)
+            return '(empty)';
+        const firstItem = data[0];
+        if (typeof firstItem !== 'object' || firstItem === null) {
+            return data.map(item => String(item)).join('\n');
+        }
+        const keys = Object.keys(firstItem);
+        const columns = keys.map(key => ({
+            header: this.humanizeKey(key),
+            key,
+        }));
+        return this.renderTable(data, columns, options);
+    }
+    objectToTable(data, options) {
+        const entries = Object.entries(data);
+        if (entries.length === 0)
+            return '(empty)';
+        const maxKeyLength = Math.max(...entries.map(([k]) => k.length));
+        const lines = [];
+        for (const [key, value] of entries) {
+            const valueStr = this.formatValue(value);
+            const paddedKey = key.padEnd(maxKeyLength);
+            lines.push(`  ${paddedKey}  ${valueStr}`);
+        }
+        return lines.join('\n');
+    }
+    renderTable(data, columns, options) {
+        if (data.length === 0)
+            return '(empty)';
+        const colWidths = columns.map(col => {
+            const maxData = Math.max(col.header.length, ...data.map(row => String(row[col.key] || '').length));
+            return Math.min(col.width || maxData + 2, 50);
+        });
+        const headerRow = columns.map((col, i) => col.header.padEnd(colWidths[i]).substring(0, colWidths[i])).join(' | ');
+        const separator = colWidths.map(w => '─'.repeat(w)).join('─┼─');
+        const rows = data.map(item => columns.map((col, i) => {
+            const value = String(item[col.key] ?? '');
+            return value.padEnd(colWidths[i]).substring(0, colWidths[i]);
+        }).join(' | '));
+        return [headerRow, separator, ...rows].join('\n');
+    }
+    humanizeKey(key) {
+        return key
+            .replace(/([A-Z])/g, ' $1')
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            .replace(/_/g, ' ')
+            .replace(/^./, str => str.toUpperCase())
+            .trim();
+    }
+    formatValue(value) {
+        if (value === null || value === undefined)
+            return chalk_1.default.gray('(none)');
+        if (typeof value === 'boolean')
+            return value ? chalk_1.default.green('✓') : chalk_1.default.red('✗');
+        if (typeof value === 'object') {
+            if (Array.isArray(value))
+                return `[${value.length} items]`;
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+    tableToMarkdown(data) {
+        if (data.length === 0)
+            return '(empty)';
+        const firstItem = data[0];
+        if (typeof firstItem !== 'object' || firstItem === null) {
+            return data.map(item => `- ${item}`).join('\n');
+        }
+        const keys = Object.keys(firstItem);
+        const header = `| ${keys.map(k => this.humanizeKey(k)).join(' | ')} |`;
+        const separator = `| ${keys.map(() => '---').join(' | ')} |`;
+        const rows = data.map(item => `| ${keys.map(k => {
+            const val = item[k];
+            return String(val ?? '');
+        }).join(' | ')} |`);
+        return [header, separator, ...rows].join('\n');
+    }
+    objectToMarkdown(data) {
+        const lines = [];
+        for (const [key, value] of Object.entries(data)) {
+            if (value === null || value === undefined)
+                continue;
+            const formattedValue = this.formatMarkdownValue(value);
+            if (Array.isArray(value) && value.length > 0 && typeof value[0] === 'object') {
+                lines.push(`\n### ${this.humanizeKey(key)}`);
+                lines.push(this.tableToMarkdown(value));
+            }
+            else {
+                lines.push(`**${this.humanizeKey(key)}:** ${formattedValue}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    formatMarkdownValue(value) {
+        if (value === null || value === undefined)
+            return '(none)';
+        if (typeof value === 'boolean')
+            return value ? 'Yes' : 'No';
+        if (typeof value === 'object') {
+            if (Array.isArray(value))
+                return value.join(', ');
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+    toYaml(obj, indent = 0) {
+        const spaces = '  '.repeat(indent);
+        if (obj === null || obj === undefined) {
+            return 'null';
+        }
+        if (typeof obj === 'string') {
+            if (obj.includes('\n') || obj.includes(':') || obj.includes('#')) {
+                return `|-\n${obj.split('\n').map(line => spaces + '  ' + line).join('\n')}`;
+            }
+            return obj;
+        }
+        if (typeof obj === 'number' || typeof obj === 'boolean') {
+            return String(obj);
+        }
+        if (Array.isArray(obj)) {
+            if (obj.length === 0)
+                return '[]';
+            return obj.map(item => {
+                const itemYaml = this.toYaml(item, indent + 1);
+                if (itemYaml.includes('\n')) {
+                    return `\n${obj.map(i => spaces + '- ' + this.toYaml(i, indent + 1)).join('\n')}`;
+                }
+                return `${spaces}- ${itemYaml}`;
+            }).join('\n');
+        }
+        if (typeof obj === 'object') {
+            const entries = Object.entries(obj);
+            if (entries.length === 0)
+                return '{}';
+            return entries.map(([key, value]) => {
+                const valueYaml = this.toYaml(value, indent + 1);
+                if (valueYaml.includes('\n') && !valueYaml.startsWith('- ')) {
+                    return `${spaces}${key}:\n${valueYaml}`;
+                }
+                return `${spaces}${key}: ${valueYaml}`;
+            }).join('\n');
+        }
+        return String(obj);
+    }
+}
+exports.OutputFormatterService = OutputFormatterService;
+const chalk_1 = __importDefault(require("chalk"));
+//# sourceMappingURL=output-formatter.service.js.map

package/dist/infrastructure/formatters/output-formatter.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.service.js","sourceRoot":"","sources":["../../../src/infrastructure/formatters/output-formatter.service.ts"],"names":[],"mappings":"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"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const nest_commander_1 = require("nest-commander");
+const app_module_1 = require("./app.module");
+async function bootstrap() {
+    await nest_commander_1.CommandFactory.run(app_module_1.AppModule, ['warn', 'error']);
+}
+bootstrap();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAChD,6CAAyC;AAEzC,KAAK,UAAU,SAAS;IACtB,MAAM,+BAAc,CAAC,GAAG,CAAC,sBAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,EAAE,CAAC"}

package/dist/test/mocks/index.d.ts

@@ -0,0 +1,44 @@
+import { IFileSystem, IConfigParser, ILogger } from '../../../domain/interfaces';
+export declare class MockFileSystem implements IFileSystem {
+    private files;
+    private directories;
+    exists(path: string): Promise<boolean>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    readJson<T>(path: string): Promise<T>;
+    writeJson(path: string, data: unknown): Promise<void>;
+    ensureDir(path: string): Promise<void>;
+    readdirNames(path: string): Promise<string[]>;
+    remove(path: string): Promise<void>;
+    setFile(path: string, content: string): void;
+    setJsonFile(path: string, data: unknown): void;
+    setDirectory(path: string): void;
+    clear(): void;
+    getFilePaths(): string[];
+    getDirectoryPaths(): string[];
+}
+export declare class MockConfigParser implements IConfigParser {
+    parse(content: string): unknown;
+    stringify(data: unknown): string;
+}
+export declare class MockLogger implements ILogger {
+    private logs;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    getLogs(): Array<{
+        level: string;
+        message: string;
+        context?: Record<string, unknown>;
+    }>;
+    clear(): void;
+    getLogsByLevel(level: string): Array<{
+        level: string;
+        message: string;
+        context?: Record<string, unknown>;
+    }>;
+}
+export declare function createMockFileSystem(): MockFileSystem;
+export declare function createMockConfigParser(): MockConfigParser;
+export declare function createMockLogger(): MockLogger;

package/dist/test/mocks/index.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockLogger = exports.MockConfigParser = exports.MockFileSystem = void 0;
+exports.createMockFileSystem = createMockFileSystem;
+exports.createMockConfigParser = createMockConfigParser;
+exports.createMockLogger = createMockLogger;
+class MockFileSystem {
+    constructor() {
+        this.files = new Map();
+        this.directories = new Set();
+    }
+    async exists(path) {
+        return this.files.has(path) || this.directories.has(path);
+    }
+    async readFile(path) {
+        const content = this.files.get(path);
+        if (content === undefined) {
+            throw new Error(`File not found: ${path}`);
+        }
+        return content;
+    }
+    async writeFile(path, content) {
+        this.files.set(path, content);
+    }
+    async readJson(path) {
+        const content = await this.readFile(path);
+        return JSON.parse(content);
+    }
+    async writeJson(path, data) {
+        await this.writeFile(path, JSON.stringify(data, null, 2));
+    }
+    async ensureDir(path) {
+        this.directories.add(path);
+    }
+    async readdirNames(path) {
+        const prefix = path.endsWith('/') ? path : path + '/';
+        const entries = [];
+        for (const key of this.files.keys()) {
+            if (key.startsWith(prefix) && key !== path) {
+                const remainder = key.slice(prefix.length);
+                const firstSlash = remainder.indexOf('/');
+                const entry = firstSlash === -1 ? remainder : remainder.slice(0, firstSlash);
+                if (!entries.includes(entry)) {
+                    entries.push(entry);
+                }
+            }
+        }
+        for (const dir of this.directories) {
+            if (dir.startsWith(prefix) && dir !== path) {
+                const remainder = dir.slice(prefix.length);
+                const firstSlash = remainder.indexOf('/');
+                const entry = firstSlash === -1 ? remainder : remainder.slice(0, firstSlash);
+                if (!entries.includes(entry)) {
+                    entries.push(entry);
+                }
+            }
+        }
+        return entries;
+    }
+    async remove(path) {
+        this.files.delete(path);
+        this.directories.delete(path);
+    }
+    setFile(path, content) {
+        this.files.set(path, content);
+    }
+    setJsonFile(path, data) {
+        this.files.set(path, JSON.stringify(data, null, 2));
+    }
+    setDirectory(path) {
+        this.directories.add(path);
+    }
+    clear() {
+        this.files.clear();
+        this.directories.clear();
+    }
+    getFilePaths() {
+        return Array.from(this.files.keys());
+    }
+    getDirectoryPaths() {
+        return Array.from(this.directories);
+    }
+}
+exports.MockFileSystem = MockFileSystem;
+class MockConfigParser {
+    parse(content) {
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return content;
+        }
+    }
+    stringify(data) {
+        return JSON.stringify(data);
+    }
+}
+exports.MockConfigParser = MockConfigParser;
+class MockLogger {
+    constructor() {
+        this.logs = [];
+    }
+    info(message, context) {
+        this.logs.push({ level: 'INFO', message, context });
+    }
+    warn(message, context) {
+        this.logs.push({ level: 'WARN', message, context });
+    }
+    error(message, context) {
+        this.logs.push({ level: 'ERROR', message, context });
+    }
+    debug(message, context) {
+        this.logs.push({ level: 'DEBUG', message, context });
+    }
+    getLogs() {
+        return [...this.logs];
+    }
+    clear() {
+        this.logs = [];
+    }
+    getLogsByLevel(level) {
+        return this.logs.filter(l => l.level === level);
+    }
+}
+exports.MockLogger = MockLogger;
+function createMockFileSystem() {
+    return new MockFileSystem();
+}
+function createMockConfigParser() {
+    return new MockConfigParser();
+}
+function createMockLogger() {
+    return new MockLogger();
+}
+//# sourceMappingURL=index.js.map

package/dist/test/mocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/test/mocks/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@evolith/smart-cli",
+  "version": "0.0.1-beta",
+  "description": "Evolith Smart CLI - Governance, standards validation, and AI agent integration for satellite repositories",
+  "main": "dist/main.js",
+  "bin": {
+    "smart-cli": "./dist/main.js"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/main.js",
+    "start:dev": "tsc -w & node dist/main.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:e2e": "jest --config ./test/jest-e2e.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "evolith",
+    "sdk",
+    "cli",
+    "governance",
+    "standards",
+    "validation",
+    "adr",
+    "architecture-decision-records",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "satellite-repository",
+    "clean-architecture"
+  ],
+  "homepage": "https://github.com/beyondnetcode/evolith_arch32#readme",
+  "author": "Beyondnet <dev@beyondnetcode.com>",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/beyondnetcode/evolith_arch32.git",
+    "directory": "sdk/cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "shell/",
+    "templates/",
+    "README.md",
+    "ARCHITECTURE.md"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/core": "^11.1.24",
+    "chalk": "^4.1.2",
+    "chokidar": "^5.0.0",
+    "conf": "^15.1.0",
+    "fs-extra": "^11.3.5",
+    "nest-commander": "^3.20.1",
+    "ora": "^9.4.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@nestjs/testing": "^11.1.24",
+    "@types/conf": "^2.1.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.1",
+    "@types/yaml": "^1.9.6",
+    "jest": "^30.4.2",
+    "nest-commander-testing": "^3.5.1",
+    "ts-jest": "^29.4.11",
+    "typescript": "^6.0.3"
+  }
+}

package/shell/completion.bash

@@ -0,0 +1,85 @@
+#!/bin/bash
+# Evolith Smart CLI Bash Completion
+# Install: source this file or add to ~/.bashrc
+# Also: smart-cli completion --install to auto-install
+
+_smart_cli_completions() {
+    local cur prev words cword
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+    # Top-level commands
+    COMMANDS="validate adr standards agents init mcp sdlc docs upgrade config completion help"
+
+    # Subcommands for each command
+    declare -A SUBCOMMANDS
+    SUBCOMMANDS[validate]="--format --output --satellite --core --ruleset"
+    SUBCOMMANDS[adr]="create list get update matrix"
+    SUBCOMMANDS[standards]="init list get validate export"
+    SUBCOMMANDS[agents]="install remove list validate upgrade menu"
+    SUBCOMMANDS[mcp]="serve version"
+    SUBCOMMANDS[sdlc]="handoff status list phases"
+    SUBCOMMANDS[config]="get set list delete"
+    SUBCOMMANDS[init]="--runtime --template --path"
+    SUBCOMMANDS[docs]="validate serve --serve"
+
+    # Global options
+    GLOBAL_OPTS="--help --version --verbose --debug --json --quiet"
+
+    # If we're completing a command (cur is a command name)
+    if [[ $cword -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "$COMMANDS" -- "$cur"))
+        return 0
+    fi
+
+    # If prev is a command, show its subcommands/options
+    if [[ -n "${SUBCOMMANDS[$prev]}" ]]; then
+        COMPREPLY=($(compgen -W "${SUBCOMMANDS[$prev]}" -- "$cur"))
+        return 0
+    fi
+
+    # Check if we're past the command word
+    local cmd=""
+    for word in "${COMP_WORDS[@]:1}"; do
+        if [[ " ${COMMANDS} " == *" $word "* ]] && [[ -z "$cmd" ]]; then
+            cmd="$word"
+        fi
+    done
+
+    # Show options for the current command
+    if [[ -n "$cmd" ]] && [[ -n "${SUBCOMMANDS[$cmd]}" ]]; then
+        COMPREPLY=($(compgen -W "${SUBCOMMANDS[$cmd]}" -- "$cur"))
+    else
+        # Show global options
+        COMPREPLY=($(compgen -W "$GLOBAL_OPTS" -- "$cur"))
+    fi
+
+    return 0
+}
+
+complete -F _smart_cli_completions smart-cli
+
+# Auto-install function
+_smart_cli_install() {
+    local shell="$1"
+    if [[ "$shell" == "bash" ]]; then
+        local profile="${HOME}/.bashrc"
+        local line="source $(pwd)/shell/completion.bash"
+        if ! grep -q "$line" "$profile" 2>/dev/null; then
+            echo "Adding completion to $profile"
+            echo "$line" >> "$profile"
+        fi
+        echo "Bash completion installed. Reload shell or run: source $profile"
+    elif [[ "$shell" == "zsh" ]]; then
+        local profile="${HOME}/.zshrc"
+        local line="source $(pwd)/shell/completion.zsh"
+        if ! grep -q "$line" "$profile" 2>/dev/null; then
+            echo "Adding completion to $profile"
+            echo "$line" >> "$profile"
+        fi
+        echo "Zsh completion installed. Reload shell or run: source $profile"
+    else
+        echo "Usage: smart-cli completion --install [bash|zsh]"
+    fi
+}

package/shell/completion.fish

@@ -0,0 +1,72 @@
+#!/bin/fish
+# Evolith Smart CLI Fish Completion
+# Install: cp this file to ~/.config/fish/completions/smart-cli.fish
+
+complete -c smart-cli -f
+
+# Top-level commands
+complete -c smart-cli -a 'validate' -d 'Validate repository'
+complete -c smart-cli -a 'adr' -d 'Manage ADRs'
+complete -c smart-cli -a 'standards' -d 'Manage standards'
+complete -c smart-cli -a 'agents' -d 'Manage agents'
+complete -c smart-cli -a 'init' -d 'Initialize repository'
+complete -c smart-cli -a 'mcp' -d 'Start MCP server'
+complete -c smart-cli -a 'sdlc' -d 'SDLC phase management'
+complete -c smart-cli -a 'docs' -d 'Documentation'
+complete -c smart-cli -a 'config' -d 'Configuration'
+complete -c smart-cli -a 'upgrade' -d 'Upgrade CLI'
+complete -c smart-cli -a 'completion' -d 'Shell completions'
+complete -c smart-cli -a 'help' -d 'Show help'
+
+# validate options
+complete -c smart-cli -n '__fish_seen_subcommand_from validate' -l format -d 'Output format' -a 'json table yaml'
+complete -c smart-cli -n '__fish_seen_subcommand_from validate' -l output -d 'Output file'
+complete -c smart-cli -n '__fish_seen_subcommand_from validate' -l satellite -d 'Satellite path'
+complete -c smart-cli -n '__fish_seen_subcommand_from validate' -l core -d 'Core path'
+complete -c smart-cli -n '__fish_seen_subcommand_from validate' -l ruleset -d 'Specific ruleset'
+
+# adr subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from adr' -a 'create' -d 'Create ADR'
+complete -c smart-cli -n '__fish_seen_subcommand_from adr' -a 'list' -d 'List ADRs'
+complete -c smart-cli -n '__fish_seen_subcommand_from adr' -a 'get' -d 'Get ADR details'
+complete -c smart-cli -n '__fish_seen_subcommand_from adr' -a 'update' -d 'Update ADR'
+complete -c smart-cli -n '__fish_seen_subcommand_from adr' -a 'matrix' -d 'Show ADR matrix'
+
+# standards subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from standards' -a 'init' -d 'Initialize'
+complete -c smart-cli -n '__fish_seen_subcommand_from standards' -a 'list' -d 'List standards'
+complete -c smart-cli -n '__fish_seen_subcommand_from standards' -a 'get' -d 'Get standard'
+complete -c smart-cli -n '__fish_seen_subcommand_from standards' -a 'validate' -d 'Validate'
+complete -c smart-cli -n '__fish_seen_subcommand_from standards' -a 'export' -d 'Export standard'
+
+# agents subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'install' -d 'Install agent'
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'remove' -d 'Remove agent'
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'list' -d 'List agents'
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'validate' -d 'Validate agent'
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'upgrade' -d 'Upgrade agent'
+complete -c smart-cli -n '__fish_seen_subcommand_from agents' -a 'menu' -d 'Interactive menu'
+
+# mcp subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from mcp' -a 'serve' -d 'Start MCP server'
+complete -c smart-cli -n '__fish_seen_subcommand_from mcp' -a 'version' -d 'Show MCP version'
+
+# sdlc subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from sdlc' -a 'handoff' -d 'Generate handoff'
+complete -c smart-cli -n '__fish_seen_subcommand_from sdlc' -a 'status' -d 'Show status'
+complete -c smart-cli -n '__fish_seen_subcommand_from sdlc' -a 'list' -d 'List phases'
+complete -c smart-cli -n '__fish_seen_subcommand_from sdlc' -a 'phases' -d 'Show phases'
+
+# config subcommands
+complete -c smart-cli -n '__fish_seen_subcommand_from config' -a 'get' -d 'Get config value'
+complete -c smart-cli -n '__fish_seen_subcommand_from config' -a 'set' -d 'Set config value'
+complete -c smart-cli -n '__fish_seen_subcommand_from config' -a 'list' -d 'List config'
+complete -c smart-cli -n '__fish_seen_subcommand_from config' -a 'delete' -d 'Delete config'
+
+# Global options
+complete -c smart-cli -l help -d 'Show help'
+complete -c smart-cli -l version -d 'Show version'
+complete -c smart-cli -l verbose -d 'Verbose output'
+complete -c smart-cli -l debug -d 'Debug mode'
+complete -c smart-cli -l json -d 'JSON output'
+complete -c smart-cli -l quiet -d 'Quiet mode'