@evolith/smart-cli 0.0.1-beta

package/README.md

@@ -0,0 +1,419 @@
+# Evolith CLI
+
+Command-line interface for Evolith governance, standards validation, and AI agent integration.
+
+## Features
+
+- **Governance**: ADR management, standards tracking, agent installation
+- **Validation**: Repository compliance against Evolith standards
+- **AI Integration**: MCP server for AI agent tool calling
+- **Observability**: Structured logging, metrics, error reporting
+
+## Installation
+
+### npm (Recommended)
+
+```bash
+npm install -g @evolith/smart-cli
+```
+
+### Manual
+
+Download the latest binary from [GitHub Releases](https://github.com/beyondnetcode/evolith_arch32/releases) and add to your PATH.
+
+### Verify Installation
+
+```bash
+smart-cli --version
+# smart-cli version 0.0.1-beta
+```
+
+## Quickstart
+
+### 1. Initialize a Repository
+
+```bash
+cd your-project
+smart-cli init
+```
+
+This creates an `evolith.yaml` file with default configuration.
+
+### 2. Run First Validation
+
+```bash
+smart-cli validate
+```
+
+Output:
+```
+✓ Validating repository...
+✓ Repository is compliant with Evolith standards
+```
+
+### 3. Install an Agent
+
+```bash
+smart-cli agents install
+# Select "standard" template when prompted
+```
+
+## Commands
+
+### validate
+
+Validate repository compliance against Evolith standards.
+
+```bash
+smart-cli validate [options]
+
+Options:
+  --satellite <path>    Path to satellite repository (default: cwd)
+  --core <path>         Path to Evolith Core
+  --format <format>     Output format: json, table, yaml, markdown
+  --output <file>       Write output to file
+  --ruleset <id>        Validate specific ruleset (acl, open-core, inheritance)
+```
+
+**Examples:**
+
+```bash
+# Basic validation
+smart-cli validate
+
+# JSON output for automation
+smart-cli validate --format json
+
+# Table output for humans
+smart-cli validate --format table
+
+# Validate specific ruleset
+smart-cli validate --ruleset acl
+```
+
+### adr
+
+Manage Architecture Decision Records.
+
+```bash
+smart-cli adr <command>
+
+Commands:
+  create     Create new ADR
+  list       List all ADRs
+  get        Show ADR details
+  update     Update existing ADR
+  matrix     Show ADR matrix
+```
+
+**Examples:**
+
+```bash
+# Create new ADR
+smart-cli adr create
+
+# List all ADRs
+smart-cli adr list
+
+# Get specific ADR
+smart-cli adr get ADR-0002
+```
+
+### standards
+
+Manage governance standards.
+
+```bash
+smart-cli standards <command>
+
+Commands:
+  init       Initialize standards directory
+  list       List all standards
+  get        Show standard details
+  validate   Validate against standards
+  export     Export standard to markdown/json
+```
+
+**Examples:**
+
+```bash
+# Initialize standards
+smart-cli standards init
+
+# List standards
+smart-cli standards list
+```
+
+### agents
+
+Install and manage Evolith agents.
+
+```bash
+smart-cli agents <command>
+
+Commands:
+  install    Install new agent
+  list       List installed agents
+  remove     Remove agent
+  validate   Validate agent ruleset
+  upgrade    Upgrade agent
+```
+
+**Examples:**
+
+```bash
+# Interactive install
+smart-cli agents install
+
+# List agents
+smart-cli agents list
+```
+
+### history
+
+View and manage command history.
+
+```bash
+smart-cli history [options]
+
+Options:
+  --list              List recent commands
+  --get <id>          Show command details
+  --search <query>    Search commands
+  --stats             Show statistics
+  --clear             Clear history
+```
+
+**Examples:**
+
+```bash
+# Show last 20 commands
+smart-cli history
+
+# Show statistics
+smart-cli history --stats
+
+# Search commands
+smart-cli history --search validate
+```
+
+### completion
+
+Generate shell completion scripts.
+
+```bash
+smart-cli completion --install <shell>
+
+Supported shells: bash, zsh, fish
+```
+
+**Examples:**
+
+```bash
+# Install bash completion
+smart-cli completion --install bash
+
+# Install zsh completion
+smart-cli completion --install zsh
+```
+
+## MCP Server (AI Agent Integration)
+
+The Evolith CLI includes an MCP server for AI agent integration.
+
+### Starting the MCP Server
+
+```bash
+smart-cli mcp serve
+```
+
+The server communicates via stdio JSON-RPC.
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `evolith-validate` | Validate repository compliance |
+| `evolith-agent-install` | Install new agent |
+| `evolith-agent-list` | List installed agents |
+| `evolith-agent-validate` | Validate agent ruleset |
+| `evolith-architecture-validate` | Validate architecture |
+| `evolith-sdlc-handoff` | Generate phase handoff |
+| `evolith-sdlc-status` | Show SDLC phase status |
+| `evolith-config-get` | Get configuration value |
+| `evolith-config-set` | Set configuration value |
+| `evolith-metrics` | Get MCP server metrics |
+
+### Cursor AI Configuration
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "evolith": {
+      "command": "smart-cli",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+### Claude Desktop Configuration
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "evolith": {
+      "command": "smart-cli",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+## AI Agent Workflow Example
+
+When integrated with an AI agent, you can have conversations like:
+
+```
+You: Validate my repository
+Agent: Let me run the validation...
+
+      await mcp.callTool('evolith-validate', {
+        path: '/user/project',
+        format: 'summary'
+      })
+
+Result: ✓ Repository is compliant with Evolith standards
+        Rules checked: 12
+        All gates passed
+
+You: Show me the ADRs
+Agent: Let me fetch the ADR list...
+
+      await mcp.callTool('evolith-adr-list', {})
+
+Result: Found 5 ADRs:
+        - ADR-0001: Architecture Decision Record Template
+        - ADR-0002: Hexagonal Architecture (accepted)
+        - ADR-0003: Testing Pyramid (accepted)
+```
+
+## Configuration
+
+Evolith uses an `evolith.yaml` file in the repository root:
+
+```yaml
+coreRef:
+  version: "1.0.0"
+  path: "../evolith"
+
+governance:
+  version: "1.0"
+  adrRegistry:
+    - id: "ADR-0001"
+      status: "accepted"
+
+product:
+  name: "my-project"
+  type: "library"
+  runtime: "typescript"
+```
+
+## Output Formats
+
+All commands support multiple output formats:
+
+```bash
+# JSON (default for automation)
+smart-cli validate --format json
+
+# Table (human-readable)
+smart-cli validate --format table
+
+# YAML (pipeline integration)
+smart-cli validate --format yaml
+
+# Markdown (documentation)
+smart-cli validate --format markdown
+```
+
+## Troubleshooting
+
+### Command not found
+
+If `evolith` is not found after installation, ensure npm's global bin is in your PATH:
+
+```bash
+# Add to ~/.bashrc or ~/.zshrc
+export PATH="$(npm config get prefix)/bin:$PATH"
+```
+
+### MCP server not responding
+
+Ensure the MCP server is running:
+
+```bash
+smart-cli mcp serve &
+```
+
+### Validation fails
+
+Check your `evolith.yaml` exists and is valid:
+
+```bash
+cat evolith.yaml
+smart-cli validate --verbose
+```
+
+## Development
+
+### Building from Source
+
+```bash
+cd sdk/cli
+npm install
+npm run build
+npm link  # Link globally for testing
+```
+
+### Running Tests
+
+```bash
+npm test
+```
+
+### Project Structure
+
+```
+sdk/cli/
+├── src/
+│   ├── commands/      # CLI commands (adr, validate, agents, etc.)
+│   ├── application/   # Use cases
+│   ├── domain/        # Business logic (services, entities)
+│   ├── infrastructure/# External integrations (catalog, CLI)
+│   └── core/          # Shared (DI, observability, errors, MCP)
+├── shell/             # Shell completion scripts
+├── templates/         # Configuration templates
+└── docs/              # Documentation
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make changes with tests
+4. Submit a pull request
+
+## License
+
+ISC
+
+## Support
+
+- [Documentation](https://github.com/beyondnetcode/evolith_arch32#readme)
+- [Issue Tracker](https://github.com/beyondnetcode/evolith_arch32/issues)
+- [Discussions](https://github.com/beyondnetcode/evolith_arch32/discussions)

package/dist/app.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AppModule {
+}

package/dist/app.module.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+const init_command_1 = require("./commands/init/init.command");
+const agents_command_1 = require("./commands/init/agents.command");
+const validate_command_1 = require("./commands/validate/validate.command");
+const docs_command_1 = require("./commands/docs/docs.command");
+const upgrade_command_1 = require("./commands/init/upgrade.command");
+const mcp_serve_command_1 = require("./commands/mcp/mcp-serve.command");
+const config_service_1 = require("./core/config/config.service");
+const file_manager_service_1 = require("./core/filesystem/file-manager.service");
+const sync_service_1 = require("./core/sync/sync.service");
+const watcher_service_1 = require("./core/mcp/watcher.service");
+const mcp_server_service_1 = require("./core/mcp/mcp-server.service");
+const sdlc_command_1 = require("./commands/sdlc/sdlc.command");
+const handoff_command_1 = require("./commands/sdlc/handoff.command");
+const generate_domain_command_1 = require("./commands/sdlc/generate-domain.command");
+const scaffold_command_1 = require("./commands/architecture/scaffold.command");
+const adr_command_1 = require("./commands/adr/adr.command");
+const standards_command_1 = require("./commands/standards/standards.command");
+const completion_command_1 = require("./commands/completion/completion.command");
+const history_command_1 = require("./commands/history/history.command");
+let AppModule = class AppModule {
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = __decorate([
+    (0, common_1.Module)({
+        imports: [],
+        providers: [
+            init_command_1.InitCommand,
+            agents_command_1.AgentsCommand,
+            validate_command_1.ValidateCommand,
+            docs_command_1.DocsCommand,
+            upgrade_command_1.UpgradeCommand,
+            mcp_serve_command_1.McpServeCommand,
+            config_service_1.ConfigService,
+            file_manager_service_1.FileManagerService,
+            sync_service_1.SyncService,
+            watcher_service_1.WatcherService,
+            mcp_server_service_1.McpServerService,
+            sdlc_command_1.SdlcCommand,
+            handoff_command_1.HandoffCommand,
+            generate_domain_command_1.GenerateDomainCommand,
+            scaffold_command_1.ScaffoldCommand,
+            adr_command_1.ADRCommand,
+            standards_command_1.StandardsCommand,
+            completion_command_1.CompletionCommand,
+            history_command_1.HistoryCommand,
+        ],
+    })
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,+DAA2D;AAC3D,mEAA+D;AAC/D,2EAAuE;AACvE,+DAA2D;AAC3D,qEAAiE;AACjE,wEAAmE;AACnE,iEAA6D;AAC7D,iFAA4E;AAC5E,2DAAuD;AACvD,gEAA4D;AAC5D,sEAAiE;AACjE,+DAA2D;AAC3D,qEAAiE;AACjE,qFAAgF;AAChF,+EAA2E;AAC3E,4DAAwD;AACxD,8EAA0E;AAC1E,iFAA6E;AAC7E,wEAAoE;AA0B7D,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAxBrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,EAAE;QACX,SAAS,EAAE;YACT,0BAAW;YACX,8BAAa;YACb,kCAAe;YACf,0BAAW;YACX,gCAAc;YACd,mCAAe;YACf,8BAAa;YACb,yCAAkB;YAClB,0BAAW;YACX,gCAAc;YACd,qCAAgB;YAChB,0BAAW;YACX,gCAAc;YACd,+CAAqB;YACrB,kCAAe;YACf,wBAAU;YACV,oCAAgB;YAChB,sCAAiB;YACjB,gCAAc;SACf;KACF,CAAC;GACW,SAAS,CAAG"}

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

@@ -0,0 +1,54 @@
+export interface InitProjectInput {
+    name: string;
+    runtime: string;
+    monorepo: string;
+    architecture: string;
+    database: string;
+    apiProtocol: string;
+    ciCd: string;
+    observability: string;
+    features: string[];
+    agents: string[];
+}
+export interface InitProjectResult {
+    success: boolean;
+    artifacts: string[];
+    warnings: string[];
+    errors: string[];
+}
+export declare class InitializeProjectUseCase {
+    private readonly fs;
+    private readonly phaseService;
+    constructor(fs: any);
+    execute(input: InitProjectInput, cwd: string): Promise<InitProjectResult>;
+    private scaffoldEvolithYaml;
+    private scaffoldReadme;
+    private scaffoldByRuntime;
+    private scaffoldNodeJs;
+    private scaffoldDotnet;
+    private scaffoldPython;
+    private checkRuntimePlatform;
+}
+export declare class PhaseTransitionUseCase {
+    private readonly fs;
+    private readonly phaseService;
+    constructor(fs: any);
+    execute(from: string, to: string, tools: string[], cwd: string): Promise<PhaseTransitionResult>;
+    private validateGates;
+}
+interface GateResult {
+    id: string;
+    passed: boolean;
+    description: string;
+    required: boolean;
+}
+interface PhaseTransitionResult {
+    success: boolean;
+    from: string;
+    to: string;
+    gateResults: GateResult[];
+    executedTools: string[];
+    warnings: string[];
+    errors: string[];
+}
+export {};