@shepai/cli 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Shep AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,200 @@
+<div align="center">
+
+# 🐑 Shep AI
+
+### Autonomous AI Native SDLC Platform
+
+_Automate the entire development cycle from idea to deploy_
+
+[![CI](https://github.com/shep-ai/cli/actions/workflows/ci.yml/badge.svg)](https://github.com/shep-ai/cli/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@shepai/cli.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/@shepai/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-3178c6.svg?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-≥18-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![pnpm](https://img.shields.io/badge/pnpm-≥8-f69220.svg?logo=pnpm&logoColor=white)](https://pnpm.io/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/shep-ai/cli/pulls)
+[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-fe5196.svg?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
+
+<br />
+
+[Getting Started](#quick-start) •
+[Documentation](#documentation) •
+[Contributing](#contributing) •
+[License](#license)
+
+</div>
+
+---
+
+Shep is an intelligent CLI tool that transforms how you build software. Point it at any repository, and it will analyze your codebase, gather requirements through conversational AI, break down features into actionable tasks, generate comprehensive documentation, and execute implementation autonomously.
+
+## Installation
+
+```bash
+pnpm add -g @shepai/cli
+```
+
+Or with npm:
+
+```bash
+npm install -g @shepai/cli
+```
+
+## Quick Start
+
+```bash
+cd ~/repos/your-project
+shep
+```
+
+Or explicitly initialize:
+
+```bash
+shep --init
+```
+
+This launches a TUI wizard to:
+
+1. Configure Claude Code authentication (setup token or use existing session)
+2. Start repository analysis
+3. Open the web UI at `http://localhost:3030/`
+
+## How It Works
+
+### Repository Analysis
+
+When you run `shep`, it performs comprehensive multi-perspective analysis of your codebase:
+
+- Architecture patterns and structure
+- Technology stack detection
+- Code conventions and style
+- Dependency mapping
+- Testing patterns
+- Documentation coverage
+
+Analysis results are persisted in `~/.shep/repos/<encoded-repo-path>/docs/` for instant access on subsequent runs.
+
+### Feature Lifecycle
+
+Every feature follows the SDLC lifecycle:
+
+```
+Requirements → Plan → Implementation → Test → Deploy → Maintenance
+```
+
+#### 1. Requirements Phase
+
+Interactive chat-based gathering powered by repository context. The AI proposes relevant options based on your codebase analysis, ensuring no open questions remain.
+
+#### 2. Plan Phase
+
+Automatic breakdown into:
+
+- **Tasks** - High-level work items with dependencies
+- **Action Items** - Granular steps within tasks
+- **Artifacts** - Generated documentation (PRDs, RFCs, Design Docs, Tech Plans)
+
+#### 3. Implementation Phase
+
+Autonomous code generation using LangGraph agents, executing tasks according to the dependency graph.
+
+#### 4. Test → Deploy → Maintenance
+
+Continuous lifecycle management with AI assistance at every stage.
+
+## Spec-Driven Development
+
+All contributions follow our spec-driven workflow:
+
+```
+/shep-kit:new-feature → /shep-kit:research → /shep-kit:plan → implement
+```
+
+Every feature begins with a specification in `specs/NNN-feature-name/` before any implementation code is written. See [Spec-Driven Workflow](./docs/development/spec-driven-workflow.md) for details.
+
+## Architecture
+
+Shep follows **Clean Architecture** principles:
+
+```mermaid
+flowchart TB
+    P["<b>Presentation</b><br/>CLI · Web UI · TUI"]
+    A["<b>Application</b><br/>Use Cases · Orchestration · Ports"]
+    D["<b>Domain</b><br/>Entities · Value Objects · Services"]
+    I["<b>Infrastructure</b><br/>SQLite · LangGraph · LanceDB"]
+
+    P --> A --> D
+    I --> A
+
+    style P fill:#dbeafe,stroke:#3b82f6,color:#1e3a5f
+    style A fill:#fef3c7,stroke:#f59e0b,color:#78350f
+    style D fill:#d1fae5,stroke:#10b981,color:#064e3b
+    style I fill:#ede9fe,stroke:#8b5cf6,color:#4c1d95
+```
+
+### Data Persistence
+
+Uses **Repository Pattern** with SQLite:
+
+- Database location: `~/.shep/repos/<encoded-repo-path>/data`
+- Interface-driven design for testability
+- Supports future backend swaps
+
+## Tech Stack
+
+| Component       | Technology                                                                              |
+| --------------- | --------------------------------------------------------------------------------------- |
+| Language        | TypeScript                                                                              |
+| Package Manager | pnpm                                                                                    |
+| CLI Framework   | Commander                                                                               |
+| TUI Framework   | [OpenTUI](https://opentui.com/)                                                         |
+| Web UI          | Next.js + shadcn/ui                                                                     |
+| Design System   | Storybook                                                                               |
+| Build Tool      | Vite                                                                                    |
+| Database        | SQLite                                                                                  |
+| Agent System    | [LangGraph](https://www.langchain.com/langgraph) (`@langchain/langgraph`)               |
+| Vector DB       | [LanceDB](https://lancedb.com/) (file-based)                                            |
+| Embeddings      | [Transformers.js](https://huggingface.co/docs/transformers.js) (local, multiple models) |
+| Testing         | Vitest (unit/integration) + Playwright (e2e)                                            |
+| Methodology     | TDD (Red-Green-Refactor)                                                                |
+
+## Documentation
+
+| Document                                           | Description                        |
+| -------------------------------------------------- | ---------------------------------- |
+| [CLAUDE.md](./CLAUDE.md)                           | Guidance for Claude Code instances |
+| [AGENTS.md](./AGENTS.md)                           | Agent system architecture          |
+| [CONTRIBUTING-AGENTS.md](./CONTRIBUTING-AGENTS.md) | AI agent contribution guidelines   |
+| [Architecture](./docs/architecture/)               | System design and patterns         |
+| [Concepts](./docs/concepts/)                       | Core domain concepts               |
+| [Guides](./docs/guides/)                           | User guides and tutorials          |
+| [Development](./docs/development/)                 | Contributing and development setup |
+| [API Reference](./docs/api/)                       | Interface and model documentation  |
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for human contributors and [CONTRIBUTING-AGENTS.md](./CONTRIBUTING-AGENTS.md) for AI agents.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+---
+
+## Maintaining This Document
+
+**When to update:**
+
+- New major features or commands
+- Architecture changes
+- Tech stack updates
+- New documentation sections
+
+**Style guide:**
+
+- Keep Quick Start minimal (3-5 steps max)
+- Update badges when versions change
+- Ensure all internal links work
+- Test code examples
+
+**Related docs:** [CONTRIBUTING.md](./CONTRIBUTING.md), [docs/guides/getting-started.md](./docs/guides/getting-started.md)

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @shepai/cli - Autonomous AI Native SDLC Platform
+ *
+ * Automate the development cycle from idea to deploy.
+ */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * @shepai/cli - Autonomous AI Native SDLC Platform
+ *
+ * Automate the development cycle from idea to deploy.
+ */
+export const VERSION = '0.1.0';

package/dist/infrastructure/services/version.service.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Version Service
+ *
+ * Infrastructure service that reads version information from package.json.
+ * Follows Clean Architecture: Infrastructure layer implements data access.
+ */
+export interface VersionInfo {
+    /** Package version (e.g., "0.1.0") */
+    version: string;
+    /** Package name (e.g., "@shepai/cli") */
+    name: string;
+    /** Package description */
+    description: string;
+}
+/**
+ * Service for reading version information from package.json
+ */
+export declare class VersionService {
+    private readonly versionInfo;
+    constructor();
+    private loadVersionInfo;
+    /**
+     * Get version information
+     */
+    getVersion(): VersionInfo;
+}
+//# sourceMappingURL=version.service.d.ts.map

package/dist/infrastructure/services/version.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.service.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/services/version.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AA8BD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;;IAM1C,OAAO,CAAC,eAAe;IAqCvB;;OAEG;IACH,UAAU,IAAI,WAAW;CAG1B"}

package/dist/infrastructure/services/version.service.js

@@ -0,0 +1,80 @@
+/**
+ * Version Service
+ *
+ * Infrastructure service that reads version information from package.json.
+ * Follows Clean Architecture: Infrastructure layer implements data access.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Default version info when package.json cannot be read */
+const DEFAULT_VERSION_INFO = {
+    version: 'unknown',
+    name: '@shepai/cli',
+    description: 'Autonomous AI Native SDLC Platform',
+};
+/**
+ * Find package.json by traversing up from a starting directory.
+ * Works in both development (src/) and production (dist/) environments.
+ */
+function findPackageJson(startDir) {
+    let currentDir = startDir;
+    // Traverse up to find package.json (max 5 levels to avoid infinite loops)
+    for (let i = 0; i < 5; i++) {
+        const pkgPath = join(currentDir, 'package.json');
+        if (existsSync(pkgPath)) {
+            return pkgPath;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached filesystem root
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Service for reading version information from package.json
+ */
+export class VersionService {
+    versionInfo;
+    constructor() {
+        this.versionInfo = this.loadVersionInfo();
+    }
+    loadVersionInfo() {
+        try {
+            const __dirname = dirname(fileURLToPath(import.meta.url));
+            const packageJsonPath = findPackageJson(__dirname);
+            if (!packageJsonPath) {
+                return DEFAULT_VERSION_INFO;
+            }
+            const content = readFileSync(packageJsonPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // Validate parsed JSON has required fields
+            if (typeof parsed === 'object' &&
+                parsed !== null &&
+                'version' in parsed &&
+                'name' in parsed &&
+                'description' in parsed &&
+                typeof parsed.version === 'string' &&
+                typeof parsed.name === 'string' &&
+                typeof parsed.description === 'string') {
+                return {
+                    version: parsed.version,
+                    name: parsed.name,
+                    description: parsed.description,
+                };
+            }
+            return DEFAULT_VERSION_INFO;
+        }
+        catch {
+            // If anything goes wrong, return defaults to keep CLI functional
+            return DEFAULT_VERSION_INFO;
+        }
+    }
+    /**
+     * Get version information
+     */
+    getVersion() {
+        return this.versionInfo;
+    }
+}

package/dist/presentation/cli/commands/version.command.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Version Command
+ *
+ * Displays detailed version information for Shep AI CLI.
+ * Provides more context than the --version flag.
+ *
+ * Usage: shep version
+ *
+ * @example
+ * $ shep version
+ * @shepai/cli v0.1.0
+ * Autonomous AI Native SDLC Platform
+ *
+ * Node:     v20.10.0
+ * Platform: linux x64
+ */
+import { Command } from 'commander';
+/**
+ * Create the version command
+ */
+export declare function createVersionCommand(): Command;
+//# sourceMappingURL=version.command.d.ts.map

package/dist/presentation/cli/commands/version.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.command.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/version.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAa9C"}

package/dist/presentation/cli/commands/version.command.js

@@ -0,0 +1,35 @@
+/**
+ * Version Command
+ *
+ * Displays detailed version information for Shep AI CLI.
+ * Provides more context than the --version flag.
+ *
+ * Usage: shep version
+ *
+ * @example
+ * $ shep version
+ * @shepai/cli v0.1.0
+ * Autonomous AI Native SDLC Platform
+ *
+ * Node:     v20.10.0
+ * Platform: linux x64
+ */
+import { Command } from 'commander';
+import { VersionService } from '../../../infrastructure/services/version.service.js';
+import { colors, fmt, messages } from '../ui/index.js';
+/**
+ * Create the version command
+ */
+export function createVersionCommand() {
+    return new Command('version').description('Display version information').action(() => {
+        const versionService = new VersionService();
+        const info = versionService.getVersion();
+        messages.newline();
+        console.log(`${fmt.heading(info.name)} ${fmt.version(info.version)}`);
+        console.log(colors.muted(info.description));
+        messages.newline();
+        console.log(`${fmt.label('Node:')}     ${process.version}`);
+        console.log(`${fmt.label('Platform:')} ${process.platform} ${process.arch}`);
+        messages.newline();
+    });
+}

package/dist/presentation/cli/index.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Shep AI CLI Entry Point
+ *
+ * Autonomous AI Native SDLC Platform - CLI Interface
+ *
+ * Usage:
+ *   shep [command] [options]
+ *
+ * Commands:
+ *   shep           Show help
+ *   shep version   Display version information
+ *   shep --version Display version number only
+ *
+ * Global Options:
+ *   -v, --version  Display version number
+ *   -h, --help     Display help
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presentation/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/presentation/cli/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Shep AI CLI Entry Point
+ *
+ * Autonomous AI Native SDLC Platform - CLI Interface
+ *
+ * Usage:
+ *   shep [command] [options]
+ *
+ * Commands:
+ *   shep           Show help
+ *   shep version   Display version information
+ *   shep --version Display version number only
+ *
+ * Global Options:
+ *   -v, --version  Display version number
+ *   -h, --help     Display help
+ */
+import { Command } from 'commander';
+import { VersionService } from '../../infrastructure/services/version.service.js';
+import { createVersionCommand } from './commands/version.command.js';
+import { messages } from './ui/index.js';
+// Initialize version service
+const versionService = new VersionService();
+const { version, description } = versionService.getVersion();
+// Create main program
+const program = new Command()
+    .name('shep')
+    .description(description)
+    .version(version, '-v, --version', 'Display version number')
+    .action(() => {
+    // Default action when no subcommand is provided - show help
+    program.outputHelp();
+});
+// Register commands
+program.addCommand(createVersionCommand());
+// Global error handler
+process.on('uncaughtException', (error) => {
+    messages.error('An unexpected error occurred', error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    const error = reason instanceof Error ? reason : new Error(String(reason));
+    messages.error('Unhandled promise rejection', error);
+    process.exit(1);
+});
+// Parse arguments
+program.parse();

package/dist/presentation/cli/ui/colors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CLI Design System - Colors
+ *
+ * Centralized color palette for consistent terminal output.
+ * Uses picocolors for fast, lightweight ANSI color support.
+ *
+ * Respects NO_COLOR environment variable automatically.
+ *
+ * @example
+ * import { colors } from './colors';
+ * console.log(colors.success('Operation completed'));
+ */
+/**
+ * Semantic color palette for CLI output
+ */
+export declare const colors: {
+    /** Primary brand color (cyan) */
+    readonly brand: import("picocolors/types").Formatter;
+    /** Success state (green) */
+    readonly success: import("picocolors/types").Formatter;
+    /** Error state (red) */
+    readonly error: import("picocolors/types").Formatter;
+    /** Warning state (yellow) */
+    readonly warning: import("picocolors/types").Formatter;
+    /** Info state (blue) */
+    readonly info: import("picocolors/types").Formatter;
+    /** Muted/secondary text (gray) */
+    readonly muted: import("picocolors/types").Formatter;
+    /** Highlighted/accent text (magenta) */
+    readonly accent: import("picocolors/types").Formatter;
+};
+export type Colors = typeof colors;
+//# sourceMappingURL=colors.d.ts.map

package/dist/presentation/cli/ui/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/ui/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,eAAO,MAAM,MAAM;IAEjB,iCAAiC;;IAIjC,4BAA4B;;IAE5B,wBAAwB;;IAExB,6BAA6B;;IAE7B,wBAAwB;;IAIxB,kCAAkC;;IAElC,wCAAwC;;CAEhC,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/presentation/cli/ui/colors.js

@@ -0,0 +1,35 @@
+/**
+ * CLI Design System - Colors
+ *
+ * Centralized color palette for consistent terminal output.
+ * Uses picocolors for fast, lightweight ANSI color support.
+ *
+ * Respects NO_COLOR environment variable automatically.
+ *
+ * @example
+ * import { colors } from './colors';
+ * console.log(colors.success('Operation completed'));
+ */
+import pc from 'picocolors';
+/**
+ * Semantic color palette for CLI output
+ */
+export const colors = {
+    // Brand colors
+    /** Primary brand color (cyan) */
+    brand: pc.cyan,
+    // Semantic colors
+    /** Success state (green) */
+    success: pc.green,
+    /** Error state (red) */
+    error: pc.red,
+    /** Warning state (yellow) */
+    warning: pc.yellow,
+    /** Info state (blue) */
+    info: pc.blue,
+    // Text modifiers
+    /** Muted/secondary text (gray) */
+    muted: pc.gray,
+    /** Highlighted/accent text (magenta) */
+    accent: pc.magenta,
+};

package/dist/presentation/cli/ui/formatters.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CLI Design System - Text Formatters
+ *
+ * Text formatting utilities for consistent CLI output styling.
+ *
+ * @example
+ * import { fmt } from './formatters';
+ * console.log(fmt.bold('Important'));
+ * console.log(fmt.heading('Section Title'));
+ */
+/**
+ * Text formatting functions
+ */
+export declare const fmt: {
+    /** Bold text */
+    readonly bold: import("picocolors/types.js").Formatter;
+    /** Dimmed/muted text */
+    readonly dim: import("picocolors/types.js").Formatter;
+    /** Italic text */
+    readonly italic: import("picocolors/types.js").Formatter;
+    /** Underlined text */
+    readonly underline: import("picocolors/types.js").Formatter;
+    /** Inverse (swap foreground/background) */
+    readonly inverse: import("picocolors/types.js").Formatter;
+    /** Heading style (bold + brand color) */
+    readonly heading: (text: string) => string;
+    /** Code/command style (cyan) */
+    readonly code: (text: string) => string;
+    /** Label style (bold + muted) */
+    readonly label: (text: string) => string;
+    /** Value style (normal) */
+    readonly value: (text: string) => string;
+    /** Version number style */
+    readonly version: (text: string) => string;
+};
+export type Formatters = typeof fmt;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/presentation/cli/ui/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/ui/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,eAAO,MAAM,GAAG;IACd,gBAAgB;;IAEhB,wBAAwB;;IAExB,kBAAkB;;IAElB,sBAAsB;;IAEtB,2CAA2C;;IAK3C,yCAAyC;6BACzB,MAAM;IACtB,gCAAgC;0BACnB,MAAM;IACnB,iCAAiC;2BACnB,MAAM;IACpB,2BAA2B;2BACb,MAAM;IACpB,2BAA2B;6BACX,MAAM;CACd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC"}

package/dist/presentation/cli/ui/formatters.js

@@ -0,0 +1,38 @@
+/**
+ * CLI Design System - Text Formatters
+ *
+ * Text formatting utilities for consistent CLI output styling.
+ *
+ * @example
+ * import { fmt } from './formatters';
+ * console.log(fmt.bold('Important'));
+ * console.log(fmt.heading('Section Title'));
+ */
+import pc from 'picocolors';
+import { colors } from './colors.js';
+/**
+ * Text formatting functions
+ */
+export const fmt = {
+    /** Bold text */
+    bold: pc.bold,
+    /** Dimmed/muted text */
+    dim: pc.dim,
+    /** Italic text */
+    italic: pc.italic,
+    /** Underlined text */
+    underline: pc.underline,
+    /** Inverse (swap foreground/background) */
+    inverse: pc.inverse,
+    // Semantic formatters
+    /** Heading style (bold + brand color) */
+    heading: (text) => pc.bold(colors.brand(text)),
+    /** Code/command style (cyan) */
+    code: (text) => colors.brand(text),
+    /** Label style (bold + muted) */
+    label: (text) => pc.bold(colors.muted(text)),
+    /** Value style (normal) */
+    value: (text) => text,
+    /** Version number style */
+    version: (text) => colors.muted(`v${text}`),
+};

package/dist/presentation/cli/ui/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI Design System
+ *
+ * Unified design system for consistent terminal output.
+ * All CLI commands should use these utilities for visual consistency.
+ *
+ * @example
+ * import { colors, symbols, fmt, messages } from '@/presentation/cli/ui';
+ *
+ * messages.success('Repository initialized');
+ * console.log(fmt.heading('Shep AI CLI'));
+ * console.log(`${colors.muted('Version:')} ${fmt.version('0.1.0')}`);
+ */
+export { colors, type Colors } from './colors.js';
+export { symbols, type Symbols } from './symbols.js';
+export { fmt, type Formatters } from './formatters.js';
+export { messages, type Messages } from './messages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/cli/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/presentation/cli/ui/index.js

@@ -0,0 +1,17 @@
+/**
+ * CLI Design System
+ *
+ * Unified design system for consistent terminal output.
+ * All CLI commands should use these utilities for visual consistency.
+ *
+ * @example
+ * import { colors, symbols, fmt, messages } from '@/presentation/cli/ui';
+ *
+ * messages.success('Repository initialized');
+ * console.log(fmt.heading('Shep AI CLI'));
+ * console.log(`${colors.muted('Version:')} ${fmt.version('0.1.0')}`);
+ */
+export { colors } from './colors.js';
+export { symbols } from './symbols.js';
+export { fmt } from './formatters.js';
+export { messages } from './messages.js';

package/dist/presentation/cli/ui/messages.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CLI Design System - Message Components
+ *
+ * Pre-styled message output functions for consistent CLI feedback.
+ *
+ * @example
+ * import { messages } from './messages';
+ * messages.success('Repository initialized');
+ * messages.error('Failed to connect', new Error('timeout'));
+ */
+/**
+ * Message output functions
+ */
+export declare const messages: {
+    /**
+     * Print success message
+     * @example messages.success('Operation completed')
+     * // Output: ✓ Operation completed
+     */
+    readonly success: (text: string) => void;
+    /**
+     * Print error message
+     * @param text - Error message
+     * @param error - Optional error object (shown in debug mode)
+     * @example messages.error('Connection failed')
+     * // Output: ✗ Connection failed
+     */
+    readonly error: (text: string, error?: Error) => void;
+    /**
+     * Print warning message
+     * @example messages.warning('Config file not found, using defaults')
+     * // Output: ⚠ Config file not found, using defaults
+     */
+    readonly warning: (text: string) => void;
+    /**
+     * Print info message
+     * @example messages.info('Analyzing repository...')
+     * // Output: ℹ Analyzing repository...
+     */
+    readonly info: (text: string) => void;
+    /**
+     * Print debug message (only when DEBUG env var is set)
+     * @example messages.debug('Cache hit: features.json')
+     * // Output: › Cache hit: features.json (only in debug mode)
+     */
+    readonly debug: (text: string) => void;
+    /**
+     * Print a blank line
+     */
+    readonly newline: () => void;
+    /**
+     * Print raw text without formatting
+     */
+    readonly log: (text: string) => void;
+};
+export type Messages = typeof messages;
+//# sourceMappingURL=messages.d.ts.map

package/dist/presentation/cli/ui/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/ui/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;;;OAMG;2BACW,MAAM,UAAU,KAAK,KAAG,IAAI;IAO1C;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;OAIG;0BACU,MAAM,KAAG,IAAI;IAI1B;;;;OAIG;2BACW,MAAM,KAAG,IAAI;IAM3B;;OAEG;4BACU,IAAI;IAIjB;;OAEG;yBACS,MAAM,KAAG,IAAI;CAGjB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC"}

package/dist/presentation/cli/ui/messages.js

@@ -0,0 +1,76 @@
+/**
+ * CLI Design System - Message Components
+ *
+ * Pre-styled message output functions for consistent CLI feedback.
+ *
+ * @example
+ * import { messages } from './messages';
+ * messages.success('Repository initialized');
+ * messages.error('Failed to connect', new Error('timeout'));
+ */
+import { colors } from './colors.js';
+import { symbols } from './symbols.js';
+/**
+ * Message output functions
+ */
+export const messages = {
+    /**
+     * Print success message
+     * @example messages.success('Operation completed')
+     * // Output: ✓ Operation completed
+     */
+    success: (text) => {
+        console.log(colors.success(`${symbols.success} ${text}`));
+    },
+    /**
+     * Print error message
+     * @param text - Error message
+     * @param error - Optional error object (shown in debug mode)
+     * @example messages.error('Connection failed')
+     * // Output: ✗ Connection failed
+     */
+    error: (text, error) => {
+        console.error(colors.error(`${symbols.error} ${text}`));
+        if (error && process.env.DEBUG) {
+            console.error(colors.muted(error.stack ?? error.message));
+        }
+    },
+    /**
+     * Print warning message
+     * @example messages.warning('Config file not found, using defaults')
+     * // Output: ⚠ Config file not found, using defaults
+     */
+    warning: (text) => {
+        console.log(colors.warning(`${symbols.warning} ${text}`));
+    },
+    /**
+     * Print info message
+     * @example messages.info('Analyzing repository...')
+     * // Output: ℹ Analyzing repository...
+     */
+    info: (text) => {
+        console.log(colors.info(`${symbols.info} ${text}`));
+    },
+    /**
+     * Print debug message (only when DEBUG env var is set)
+     * @example messages.debug('Cache hit: features.json')
+     * // Output: › Cache hit: features.json (only in debug mode)
+     */
+    debug: (text) => {
+        if (process.env.DEBUG) {
+            console.log(colors.muted(`${symbols.pointer} ${text}`));
+        }
+    },
+    /**
+     * Print a blank line
+     */
+    newline: () => {
+        console.log();
+    },
+    /**
+     * Print raw text without formatting
+     */
+    log: (text) => {
+        console.log(text);
+    },
+};

package/dist/presentation/cli/ui/symbols.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CLI Design System - Symbols
+ *
+ * Unicode symbols for visual feedback in terminal output.
+ * Includes ASCII fallbacks for non-UTF8 terminals.
+ *
+ * @example
+ * import { symbols } from './symbols';
+ * console.log(`${symbols.success} Done!`);
+ */
+/**
+ * Unicode symbols with ASCII fallbacks
+ */
+export declare const symbols: {
+    /** Success checkmark */
+    readonly success: "✓" | "√";
+    /** Error cross */
+    readonly error: "✗" | "×";
+    /** Warning triangle */
+    readonly warning: "⚠" | "‼";
+    /** Info circle */
+    readonly info: "ℹ" | "i";
+    /** Arrow/pointer */
+    readonly arrow: "→" | "->";
+    /** Bullet point */
+    readonly bullet: "•" | "*";
+    /** Pointer right */
+    readonly pointer: "❯" | ">";
+    /** Ellipsis for loading/truncation */
+    readonly ellipsis: "…" | "...";
+    /** Line separator */
+    readonly line: "─" | "-";
+    /** Spinner frames for loading animation */
+    readonly spinner: string[];
+};
+export type Symbols = typeof symbols;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/presentation/cli/ui/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../src/presentation/cli/ui/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB,wBAAwB;;IAExB,kBAAkB;;IAElB,uBAAuB;;IAEvB,kBAAkB;;IAElB,oBAAoB;;IAEpB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,sCAAsC;;IAEtC,qBAAqB;;IAErB,2CAA2C;;CAEnC,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC"}

package/dist/presentation/cli/ui/symbols.js

@@ -0,0 +1,65 @@
+/**
+ * CLI Design System - Symbols
+ *
+ * Unicode symbols for visual feedback in terminal output.
+ * Includes ASCII fallbacks for non-UTF8 terminals.
+ *
+ * @example
+ * import { symbols } from './symbols';
+ * console.log(`${symbols.success} Done!`);
+ */
+/**
+ * Detect if terminal supports Unicode
+ */
+const isUnicodeSupported = () => {
+    // Windows Terminal and modern terminals support Unicode
+    if (process.env.WT_SESSION)
+        return true;
+    if (process.env.TERM_PROGRAM === 'vscode')
+        return true;
+    if (process.env.TERM === 'xterm-256color')
+        return true;
+    // Legacy Windows CMD/PowerShell may not
+    if (process.platform === 'win32') {
+        const { env } = process;
+        // Check for modern terminal indicators on Windows
+        const isModernTerminal = Boolean(env.CI) ||
+            Boolean(env.WT_SESSION) ||
+            Boolean(env.TERMINUS_SUBLIME) ||
+            env.ConEmuTask === '{cmd::Cmder}' ||
+            env.TERM_PROGRAM === 'Terminus-Sublime' ||
+            env.TERM_PROGRAM === 'vscode' ||
+            env.TERM === 'xterm-256color' ||
+            env.TERM === 'alacritty' ||
+            env.TERMINAL_EMULATOR === 'JetBrains-JediTerm';
+        return isModernTerminal;
+    }
+    // Unix-like systems generally support Unicode
+    return process.env.TERM !== 'linux';
+};
+const unicode = isUnicodeSupported();
+/**
+ * Unicode symbols with ASCII fallbacks
+ */
+export const symbols = {
+    /** Success checkmark */
+    success: unicode ? '✓' : '√',
+    /** Error cross */
+    error: unicode ? '✗' : '×',
+    /** Warning triangle */
+    warning: unicode ? '⚠' : '‼',
+    /** Info circle */
+    info: unicode ? 'ℹ' : 'i',
+    /** Arrow/pointer */
+    arrow: unicode ? '→' : '->',
+    /** Bullet point */
+    bullet: unicode ? '•' : '*',
+    /** Pointer right */
+    pointer: unicode ? '❯' : '>',
+    /** Ellipsis for loading/truncation */
+    ellipsis: unicode ? '…' : '...',
+    /** Line separator */
+    line: unicode ? '─' : '-',
+    /** Spinner frames for loading animation */
+    spinner: unicode ? ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'] : ['|', '/', '-', '\\'],
+};

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@shepai/cli",
+  "version": "1.0.1",
+  "description": "Autonomous AI Native SDLC Platform - Automate the development cycle from idea to deploy",
+  "type": "module",
+  "license": "MIT",
+  "author": "Shep AI",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shep-ai/cli.git"
+  },
+  "keywords": [
+    "ai",
+    "sdlc",
+    "automation",
+    "cli",
+    "developer-tools",
+    "code-generation",
+    "langgraph"
+  ],
+  "bin": {
+    "shep": "./dist/presentation/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:int": "vitest run tests/integration",
+    "test:e2e": "vitest run tests/e2e",
+    "test:e2e:cli": "vitest run tests/e2e/cli",
+    "test:e2e:tui": "vitest run tests/e2e/tui",
+    "test:e2e:web": "vitest run tests/e2e/web",
+    "test:single": "vitest run",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "lint:tsp": "tsp compile tsp/ --no-emit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "format:tsp": "tsp format \"tsp/**/*.tsp\"",
+    "cli": "tsx src/presentation/cli/index.ts",
+    "storybook": "storybook dev -p 6006",
+    "storybook:build": "storybook build",
+    "web:dev": "next dev",
+    "web:build": "next build",
+    "tsp:compile": "tsp compile tsp/",
+    "tsp:format": "tsp format \"tsp/**/*.tsp\"",
+    "tsp:watch": "tsp compile tsp/ --watch",
+    "prepare": "husky",
+    "validate": "pnpm run lint:fix && pnpm run format && pnpm run typecheck && pnpm run tsp:compile"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@eslint/js": "^9.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.3",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^25.2.0",
+    "@typespec/compiler": "^0.60.0",
+    "@typespec/json-schema": "^0.60.0",
+    "@typespec/openapi3": "^0.60.0",
+    "@typespec/prettier-plugin-typespec": "^0.60.0",
+    "@typespec/protobuf": "^0.60.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "semantic-release": "^25.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.0.0",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "packageManager": "pnpm@9.0.0",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1"
+  }
+}