@evolith/smart-cli 0.0.1-beta

package/dist/domain/interfaces.d.ts

@@ -0,0 +1,224 @@
+export interface CommandResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface PlatformCheck {
+    name: string;
+    command: string;
+    available: boolean;
+    version?: string;
+    installHint?: string;
+}
+export interface ICommandExecutor {
+    execute(command: string, cwd?: string): Promise<CommandResult>;
+    checkTool(name: string, versionCommand: string): Promise<PlatformCheck>;
+}
+export interface ICatalogLoader {
+    loadRuntimeCatalog(): Runtime[];
+    loadToolCatalog(): ToolCatalog;
+    loadCommandsMatrix(): CommandsMatrix;
+}
+export interface Runtime {
+    id: string;
+    name: string;
+    versions: string[];
+    defaultVersion: string;
+    language: string;
+    typeSystem: string;
+    frameworks: Framework[];
+    databases: Database[];
+    buildTools: string[];
+    testFrameworks: string[];
+    packageManager: string;
+}
+export interface Framework {
+    id: string;
+    name: string;
+    version: string;
+}
+export interface Database {
+    id: string;
+    name: string;
+    orm?: string;
+    type?: string;
+}
+export interface MonorepoOption {
+    id: string;
+    name: string;
+    description: string;
+    defaults: {
+        structure: string;
+        ciStrategy: string;
+        libraryStructure?: string;
+        policyEnforcement?: boolean;
+    };
+}
+export interface ArchitecturePattern {
+    id: string;
+    name: string;
+    description: string;
+    layers: string[];
+    dddConcepts?: string[];
+}
+export interface ToolGroup {
+    question: string;
+    defaultOption: string;
+    options?: ToolOption[];
+    tools: string[];
+}
+export interface ToolOption {
+    value: string;
+    label: string;
+    description: string;
+    hint?: string;
+}
+export interface PhaseDefinition {
+    value: string;
+    label: string;
+    description: string;
+    gateChecks: GateCheck[];
+    artifacts: string[];
+    toolGroups: Record<string, ToolGroup>;
+    defaultTools: string[];
+}
+export interface GateCheck {
+    id: string;
+    description: string;
+    required: boolean;
+}
+export interface PlatformCheck {
+    name: string;
+    command: string;
+    available: boolean;
+    version?: string;
+    installHint?: string;
+}
+export interface ProjectConfig {
+    name: string;
+    runtime: Runtime;
+    monorepo: MonorepoOption;
+    architecture: ArchitecturePattern;
+    database: string;
+    apiProtocol: string;
+    ciCd: string;
+    observability: string;
+}
+export interface PhaseTransition {
+    fromPhase: string;
+    toPhase: string;
+    tools: string[];
+    validated: boolean;
+    timestamp: string;
+}
+export interface ICommandExecutor {
+    execute(command: string, cwd?: string): Promise<CommandResult>;
+    checkTool(name: string, versionCommand: string): Promise<PlatformCheck>;
+}
+export interface ICatalogLoader {
+    loadRuntimeCatalog(): Runtime[];
+    loadToolCatalog(): ToolCatalog;
+    loadCommandsMatrix(): CommandsMatrix;
+}
+export interface ToolCatalog {
+    phases: Record<string, PhaseDefinition>;
+    toolMetadata: Record<string, ToolMetadata>;
+}
+export interface ToolMetadata {
+    description: string;
+    runtimeAgnostic: boolean;
+    runtimeAware?: boolean;
+    phase: string;
+    commands?: string[];
+    platformCheck?: string;
+}
+export interface CommandsMatrix {
+    runtimes: Record<string, RuntimeCommands>;
+    monorepos: Record<string, MonorepoCommands>;
+    container: ContainerCommands;
+    observability: ObservabilityCommands;
+}
+export interface RuntimeCommands {
+    native: string[];
+    scaffold: string[];
+    delegated: string[];
+    unsupported: string[];
+}
+export interface MonorepoCommands {
+    native: string[];
+    delegated: string[];
+}
+export interface ContainerCommands {
+    delegated: string[];
+    unsupported: string[];
+}
+export interface ObservabilityCommands {
+    scaffold: string[];
+    delegated: string[];
+}
+export interface IFileSystem {
+    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>;
+}
+export interface IConfigParser {
+    parse(content: string): unknown;
+    stringify(data: unknown): string;
+}
+export interface ILogger {
+    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;
+}
+export interface IProjectInitializer {
+    initialize(config: ProjectConfig, cwd: string): Promise<InitResult>;
+    scaffoldRuntime(config: ProjectConfig, fs: IFileSystem, projectDir: string): Promise<void>;
+}
+export interface InitResult {
+    success: boolean;
+    artifacts: string[];
+    warnings: string[];
+    errors: string[];
+}
+export interface IPhaseGates {
+    validate(phase: string, cwd: string): Promise<GateResult[]>;
+    canTransition(from: string, to: string): boolean;
+}
+export interface GateResult {
+    id: string;
+    passed: boolean;
+    description: string;
+    error?: string;
+}
+export interface IToolExecutor {
+    execute(tool: string, context: ToolContext): Promise<ToolResult>;
+    detectPlatform(tool: string): Promise<PlatformCheck>;
+}
+export interface ToolContext {
+    phase: string;
+    projectDir: string;
+    runtime?: string;
+}
+export interface ToolResult {
+    success: boolean;
+    command?: string;
+    output?: string;
+    error?: string;
+}
+export interface IToolSelector {
+    getToolsForPhase(phase: string): ToolGroup[];
+    getDefaultTools(phase: string): string[];
+    validateToolSelection(phase: string, tools: string[]): ValidationResult;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}

package/dist/domain/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/domain/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/domain/interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/services/adr.service.d.ts

@@ -0,0 +1,50 @@
+import { IFileSystem } from '../interfaces';
+export interface ADR {
+    id: string;
+    number: number;
+    title: string;
+    status: ADRStatus;
+    date: string;
+    context: string;
+    decision: string;
+    consequences: ADRConsequences;
+    relatedAdrs?: string[];
+    tags?: string[];
+}
+export type ADRStatus = 'Proposed' | 'Accepted' | 'Deprecated' | 'Superseded' | 'Amended';
+export interface ADRConsequences {
+    positive: string[];
+    negative: string[];
+    neutral?: string[];
+}
+export declare class ADRService {
+    private readonly fs;
+    private readonly adrDir;
+    constructor(fs: IFileSystem, basePath: string);
+    create(input: CreateADRInput): Promise<ADR>;
+    list(): Promise<ADR[]>;
+    get(idOrNumber: string): Promise<ADR | undefined>;
+    updateStatus(id: string, status: ADRStatus, reason?: string): Promise<ADR | undefined>;
+    getMatrix(): Promise<ADCMatrix>;
+    private getNextNumber;
+    private updateMatrix;
+    private renderMarkdown;
+}
+export interface CreateADRInput {
+    title: string;
+    context: string;
+    decision: string;
+    consequences: ADRConsequences;
+    relatedAdrs?: string[];
+    tags?: string[];
+}
+export interface ADCMatrix {
+    adrs: ADR[];
+    lastUpdated: string;
+    summary: {
+        total: number;
+        proposed: number;
+        accepted: number;
+        deprecated: number;
+    };
+}

package/dist/domain/services/adr.service.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADRService = void 0;
+class ADRService {
+    constructor(fs, basePath) {
+        this.fs = fs;
+        this.adrDir = `${basePath}/reference/architecture/adrs`;
+    }
+    async create(input) {
+        const adrNumber = await this.getNextNumber();
+        const adr = {
+            id: `ADR-${String(adrNumber).padStart(4, '0')}`,
+            number: adrNumber,
+            title: input.title,
+            status: 'Proposed',
+            date: new Date().toISOString().split('T')[0],
+            context: input.context,
+            decision: input.decision,
+            consequences: input.consequences,
+            relatedAdrs: input.relatedAdrs || [],
+            tags: input.tags || [],
+        };
+        await this.fs.ensureDir(this.adrDir);
+        await this.fs.writeJson(`${this.adrDir}/ADR-${String(adrNumber).padStart(4, '0')}.json`, adr);
+        await this.fs.writeFile(`${this.adrDir}/ADR-${String(adrNumber).padStart(4, '0')}.md`, this.renderMarkdown(adr));
+        await this.updateMatrix(adr);
+        return adr;
+    }
+    async list() {
+        const exists = await this.fs.exists(this.adrDir);
+        if (!exists)
+            return [];
+        const files = await this.fs.readdirNames(this.adrDir);
+        const adrs = [];
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                const adr = await this.fs.readJson(`${this.adrDir}/${file}`);
+                adrs.push(adr);
+            }
+        }
+        return adrs.sort((a, b) => b.number - a.number);
+    }
+    async get(idOrNumber) {
+        const adrs = await this.list();
+        return adrs.find(a => a.id === idOrNumber ||
+            a.id === `ADR-${idOrNumber}` ||
+            `ADR-${String(a.number).padStart(4, '0')}` === idOrNumber);
+    }
+    async updateStatus(id, status, reason) {
+        const adr = await this.get(id);
+        if (!adr)
+            return undefined;
+        const updated = {
+            ...adr,
+            status,
+            consequences: {
+                ...adr.consequences,
+                neutral: reason ? [...(adr.consequences.neutral || []), `Status changed to ${status}: ${reason}`] : adr.consequences.neutral,
+            },
+        };
+        await this.fs.writeJson(`${this.adrDir}/${adr.id}.json`, updated);
+        await this.fs.writeFile(`${this.adrDir}/${adr.id}.md`, this.renderMarkdown(updated));
+        return updated;
+    }
+    async getMatrix() {
+        const adrs = await this.list();
+        return {
+            adrs,
+            lastUpdated: new Date().toISOString(),
+            summary: {
+                total: adrs.length,
+                proposed: adrs.filter(a => a.status === 'Proposed').length,
+                accepted: adrs.filter(a => a.status === 'Accepted').length,
+                deprecated: adrs.filter(a => a.status === 'Deprecated').length,
+            },
+        };
+    }
+    async getNextNumber() {
+        const adrs = await this.list();
+        if (adrs.length === 0)
+            return 1;
+        return Math.max(...adrs.map(a => a.number)) + 1;
+    }
+    async updateMatrix(adr) {
+        const matrix = await this.getMatrix();
+        await this.fs.writeJson(`${this.adrDir}/adr-matrix.json`, matrix);
+    }
+    renderMarkdown(adr) {
+        return `# ${adr.id}: ${adr.title}
+
+## Status
+${adr.status}
+
+## Date
+${adr.date}
+
+## Context
+${adr.context}
+
+## Decision
+${adr.decision}
+
+## Consequences
+### Positive
+${adr.consequences.positive.map(p => `- ${p}`).join('\n')}
+
+### Negative
+${adr.consequences.negative.map(n => `- ${n}`).join('\n')}
+
+${adr.consequences.neutral && adr.consequences.neutral.length > 0 ? `### Neutral
+${adr.consequences.neutral.map(n => `- ${n}`).join('\n')}` : ''}
+
+${adr.relatedAdrs && adr.relatedAdrs.length > 0 ? `## Related ADRs
+${adr.relatedAdrs.map(r => `- ${r}`).join('\n')}` : ''}
+
+${adr.tags && adr.tags.length > 0 ? `## Tags
+${adr.tags.map(t => `\`${t}\``).join(' ')}` : ''}
+
+---
+[Back to ADR Matrix](./adr-matrix.md)
+`;
+    }
+}
+exports.ADRService = ADRService;
+//# sourceMappingURL=adr.service.js.map

package/dist/domain/services/adr.service.js.map

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

package/dist/domain/services/agent-registry.service.d.ts

@@ -0,0 +1,26 @@
+import { IFileSystem } from '../../core/abstractions/interfaces';
+export interface AgentInfo {
+    name: string;
+    version: string;
+    template: string;
+    rulesetFiles: string[];
+    installedAt: string;
+    lastValidated?: string;
+}
+export interface AgentRegistry {
+    agents: AgentInfo[];
+    lastUpdated: string;
+}
+export declare class AgentRegistryService {
+    private readonly fs;
+    private readonly registryFileName;
+    private readonly agentsDirName;
+    constructor(fs: IFileSystem);
+    discover(repoPath: string): Promise<AgentInfo[]>;
+    register(repoPath: string, agent: AgentInfo): Promise<void>;
+    unregister(repoPath: string, agentName: string): Promise<boolean>;
+    getAgent(repoPath: string, agentName: string): Promise<AgentInfo | undefined>;
+    updateLastValidated(repoPath: string, agentName: string): Promise<void>;
+    exportManifest(repoPath: string): Promise<string>;
+    private loadOrCreateRegistry;
+}

package/dist/domain/services/agent-registry.service.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistryService = void 0;
+const path = __importStar(require("path"));
+class AgentRegistryService {
+    constructor(fs) {
+        this.registryFileName = 'agents-registry.json';
+        this.agentsDirName = '.evolith/agents';
+        this.fs = fs;
+    }
+    async discover(repoPath) {
+        const agentsPath = path.join(repoPath, this.agentsDirName);
+        if (!(await this.fs.exists(agentsPath))) {
+            return [];
+        }
+        const registryPath = path.join(agentsPath, this.registryFileName);
+        if (await this.fs.exists(registryPath)) {
+            const registry = await this.fs.readJson(registryPath);
+            return registry.agents || [];
+        }
+        const entries = await this.fs.readdirNames(agentsPath);
+        const agents = [];
+        for (const entry of entries) {
+            const agentPath = path.join(agentsPath, entry);
+            const stat = await this.fs.stat(agentPath);
+            if (stat.isDirectory()) {
+                const agentJsonPath = path.join(agentPath, 'agent.json');
+                if (await this.fs.exists(agentJsonPath)) {
+                    const agentData = await this.fs.readJson(agentJsonPath);
+                    agents.push(agentData);
+                }
+            }
+        }
+        return agents;
+    }
+    async register(repoPath, agent) {
+        const agentsPath = path.join(repoPath, this.agentsDirName);
+        await this.fs.ensureDir(agentsPath);
+        const agentPath = path.join(agentsPath, agent.name);
+        await this.fs.ensureDir(agentPath);
+        await this.fs.writeJson(path.join(agentPath, 'agent.json'), agent);
+        const registry = await this.loadOrCreateRegistry(agentsPath);
+        const existingIdx = registry.agents.findIndex(a => a.name === agent.name);
+        if (existingIdx >= 0) {
+            registry.agents[existingIdx] = agent;
+        }
+        else {
+            registry.agents.push(agent);
+        }
+        registry.lastUpdated = new Date().toISOString();
+        await this.fs.writeJson(path.join(agentsPath, this.registryFileName), registry);
+    }
+    async unregister(repoPath, agentName) {
+        const agentsPath = path.join(repoPath, this.agentsDirName);
+        const registryPath = path.join(agentsPath, this.registryFileName);
+        if (!(await this.fs.exists(registryPath))) {
+            return false;
+        }
+        const registry = await this.fs.readJson(registryPath);
+        const idx = registry.agents.findIndex(a => a.name === agentName);
+        if (idx < 0) {
+            return false;
+        }
+        registry.agents.splice(idx, 1);
+        registry.lastUpdated = new Date().toISOString();
+        await this.fs.writeJson(registryPath, registry);
+        const agentPath = path.join(agentsPath, agentName);
+        if (await this.fs.exists(agentPath)) {
+            await this.fs.remove(agentPath);
+        }
+        return true;
+    }
+    async getAgent(repoPath, agentName) {
+        const agents = await this.discover(repoPath);
+        return agents.find(a => a.name === agentName);
+    }
+    async updateLastValidated(repoPath, agentName) {
+        const agentsPath = path.join(repoPath, this.agentsDirName);
+        const registryPath = path.join(agentsPath, this.registryFileName);
+        if (!(await this.fs.exists(registryPath))) {
+            return;
+        }
+        const registry = await this.fs.readJson(registryPath);
+        const agent = registry.agents.find(a => a.name === agentName);
+        if (agent) {
+            agent.lastValidated = new Date().toISOString();
+            registry.lastUpdated = new Date().toISOString();
+            await this.fs.writeJson(registryPath, registry);
+        }
+    }
+    async exportManifest(repoPath) {
+        const agents = await this.discover(repoPath);
+        return JSON.stringify({
+            version: '1.0',
+            exportedAt: new Date().toISOString(),
+            agentCount: agents.length,
+            agents: agents.map(a => ({
+                name: a.name,
+                version: a.version,
+                template: a.template,
+                rulesets: a.rulesetFiles,
+                installedAt: a.installedAt,
+                status: a.lastValidated ? 'validated' : 'pending',
+            })),
+        }, null, 2);
+    }
+    async loadOrCreateRegistry(agentsPath) {
+        const registryPath = path.join(agentsPath, this.registryFileName);
+        if (await this.fs.exists(registryPath)) {
+            return await this.fs.readJson(registryPath);
+        }
+        return {
+            agents: [],
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+}
+exports.AgentRegistryService = AgentRegistryService;
+//# sourceMappingURL=agent-registry.service.js.map

package/dist/domain/services/agent-registry.service.js.map

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

package/dist/domain/services/index.d.ts

@@ -0,0 +1,33 @@
+import { Phase } from '../entities';
+import { IPhaseGates, GateResult as IGateResult } from '../interfaces';
+export declare class PhaseService implements IPhaseGates {
+    private readonly phases;
+    constructor();
+    getPhase(value: string): Phase | undefined;
+    getAllPhases(): Phase[];
+    canTransition(from: string, to: string): boolean;
+    getNextPhase(current: string): Phase | undefined;
+    getPreviousPhase(current: string): Phase | undefined;
+    validate(_phase: string, _cwd: string): Promise<IGateResult[]>;
+    getPhaseLabel(phaseValue: string): string;
+    getPhaseDescription(phaseValue: string): string;
+    isValidPhase(value: string): boolean;
+    getPhaseIndex(value: string): number;
+}
+export declare class ToolSelectionService {
+    private readonly defaultToolsByPhase;
+    getDefaultTools(phase: string): string[];
+    validateSelection(phase: string, tools: string[]): {
+        valid: boolean;
+        errors: string[];
+    };
+    private isValidToolForPhase;
+    filterByConvention(tools: string[]): string[];
+    expandAllTools(allTag: string, phase: string): string[];
+}
+export declare class PlatformDetectionService {
+    private readonly checks;
+    registerCheck(tool: string, checkFn: () => Promise<boolean>): void;
+    isAvailable(tool: string): Promise<boolean>;
+    detectAll(tools: string[]): Promise<Record<string, boolean>>;
+}