mycontext-cli 1.0.94 → 2.0.0

package/dist/constants/fileNames.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Standardized file naming convention for MyContext CLI
+ * Single source of truth for all context file names
+ */
+export declare const CONTEXT_FILES: {
+    readonly FEATURES: "01a-features.md";
+    readonly USER_FLOWS: "01b-user-flows.md";
+    readonly EDGE_CASES: "01c-edge-cases.md";
+    readonly TECHNICAL_SPECS: "01d-technical-specs.md";
+    readonly PRD: "02-prd.md";
+    readonly TYPES: "02-types.ts";
+    readonly BRANDING: "03-branding.md";
+    readonly COMPONENT_LIST: "04-component-list.json";
+    readonly PROJECT_STRUCTURE: "05-project-structure.md";
+    readonly STATE: "state.json";
+    readonly CONTEXT_MEMORY: "context.json";
+    readonly PROGRESS: "progress.json";
+    readonly BUILD_STRATEGY_PLAN: "build-strategy-plan.json";
+    readonly BUILD_STRATEGY_RECOMMENDATIONS: "build-strategy-recommendations.json";
+    readonly BUILD_STRATEGY_TASKS: "build-strategy-tasks.json";
+    readonly BUILD_STRATEGY_COMPARISON: "build-strategy-comparison.json";
+};
+/**
+ * Legacy file names for backward compatibility
+ * @deprecated Use CONTEXT_FILES instead
+ */
+export declare const LEGACY_FILE_NAMES: {
+    readonly '01a-brief.md': "01a-features.md";
+    readonly '01b-requirements.md': "01b-user-flows.md";
+    readonly '01c-flows.md': "01c-edge-cases.md";
+    readonly '01-prd.md': "02-prd.md";
+    readonly 'prd.md': "02-prd.md";
+    readonly 'PRD.md': "02-prd.md";
+    readonly '01_PRD.md': "02-prd.md";
+    readonly 'types.ts': "02-types.ts";
+    readonly '02_types.ts': "02-types.ts";
+    readonly 'branding.md': "03-branding.md";
+    readonly '03_branding.md': "03-branding.md";
+    readonly 'component-list.json': "04-component-list.json";
+    readonly 'components-list.json': "04-component-list.json";
+    readonly '04_component_list.json': "04-component-list.json";
+    readonly 'project-structure.md': "05-project-structure.md";
+    readonly '05_project_structure.md': "05-project-structure.md";
+};
+/**
+ * Required context files for various operations
+ */
+export declare const REQUIRED_FILES: {
+    readonly COMPILE_PRD: readonly ["01a-features.md", "01b-user-flows.md", "01c-edge-cases.md", "01d-technical-specs.md"];
+    readonly GENERATE_TYPES: readonly ["02-prd.md"];
+    readonly GENERATE_BRAND: readonly ["02-prd.md"];
+    readonly GENERATE_COMPONENTS_LIST: readonly ["02-prd.md", "02-types.ts"];
+    readonly GENERATE_COMPONENTS: readonly ["02-prd.md", "02-types.ts", "04-component-list.json"];
+};
+/**
+ * Get the standardized file name for a given file
+ * Returns the canonical name or the original if no mapping exists
+ */
+export declare function getStandardFileName(fileName: string): string;
+/**
+ * Check if a file name is legacy
+ */
+export declare function isLegacyFileName(fileName: string): boolean;
+/**
+ * Get all possible names for a canonical file (including legacy)
+ */
+export declare function getAllFileNameVariants(canonicalName: string): string[];
+//# sourceMappingURL=fileNames.d.ts.map

package/dist/constants/fileNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileNames.d.ts","sourceRoot":"","sources":["../../src/constants/fileNames.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAwBhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAkBjB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAUtE"}

package/dist/constants/fileNames.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Standardized file naming convention for MyContext CLI
+ * Single source of truth for all context file names
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_FILES = exports.LEGACY_FILE_NAMES = exports.CONTEXT_FILES = void 0;
+exports.getStandardFileName = getStandardFileName;
+exports.isLegacyFileName = isLegacyFileName;
+exports.getAllFileNameVariants = getAllFileNameVariants;
+exports.CONTEXT_FILES = {
+    // A/B/C/D Context Files (User-centric documentation)
+    FEATURES: '01a-features.md',
+    USER_FLOWS: '01b-user-flows.md',
+    EDGE_CASES: '01c-edge-cases.md',
+    TECHNICAL_SPECS: '01d-technical-specs.md',
+    // Core Context Files
+    PRD: '02-prd.md', // Changed from 01-prd.md to avoid conflict
+    TYPES: '02-types.ts',
+    BRANDING: '03-branding.md',
+    COMPONENT_LIST: '04-component-list.json',
+    PROJECT_STRUCTURE: '05-project-structure.md',
+    // State and Tracking
+    STATE: 'state.json',
+    CONTEXT_MEMORY: 'context.json',
+    PROGRESS: 'progress.json',
+    // Build Strategy
+    BUILD_STRATEGY_PLAN: 'build-strategy-plan.json',
+    BUILD_STRATEGY_RECOMMENDATIONS: 'build-strategy-recommendations.json',
+    BUILD_STRATEGY_TASKS: 'build-strategy-tasks.json',
+    BUILD_STRATEGY_COMPARISON: 'build-strategy-comparison.json',
+};
+/**
+ * Legacy file names for backward compatibility
+ * @deprecated Use CONTEXT_FILES instead
+ */
+exports.LEGACY_FILE_NAMES = {
+    '01a-brief.md': exports.CONTEXT_FILES.FEATURES,
+    '01b-requirements.md': exports.CONTEXT_FILES.USER_FLOWS,
+    '01c-flows.md': exports.CONTEXT_FILES.EDGE_CASES,
+    '01-prd.md': exports.CONTEXT_FILES.PRD,
+    'prd.md': exports.CONTEXT_FILES.PRD,
+    'PRD.md': exports.CONTEXT_FILES.PRD,
+    '01_PRD.md': exports.CONTEXT_FILES.PRD,
+    'types.ts': exports.CONTEXT_FILES.TYPES,
+    '02_types.ts': exports.CONTEXT_FILES.TYPES,
+    'branding.md': exports.CONTEXT_FILES.BRANDING,
+    '03_branding.md': exports.CONTEXT_FILES.BRANDING,
+    'component-list.json': exports.CONTEXT_FILES.COMPONENT_LIST,
+    'components-list.json': exports.CONTEXT_FILES.COMPONENT_LIST,
+    '04_component_list.json': exports.CONTEXT_FILES.COMPONENT_LIST,
+    'project-structure.md': exports.CONTEXT_FILES.PROJECT_STRUCTURE,
+    '05_project_structure.md': exports.CONTEXT_FILES.PROJECT_STRUCTURE,
+};
+/**
+ * Required context files for various operations
+ */
+exports.REQUIRED_FILES = {
+    COMPILE_PRD: [
+        exports.CONTEXT_FILES.FEATURES,
+        exports.CONTEXT_FILES.USER_FLOWS,
+        exports.CONTEXT_FILES.EDGE_CASES,
+        exports.CONTEXT_FILES.TECHNICAL_SPECS,
+    ],
+    GENERATE_TYPES: [exports.CONTEXT_FILES.PRD],
+    GENERATE_BRAND: [exports.CONTEXT_FILES.PRD],
+    GENERATE_COMPONENTS_LIST: [
+        exports.CONTEXT_FILES.PRD,
+        exports.CONTEXT_FILES.TYPES,
+    ],
+    GENERATE_COMPONENTS: [
+        exports.CONTEXT_FILES.PRD,
+        exports.CONTEXT_FILES.TYPES,
+        exports.CONTEXT_FILES.COMPONENT_LIST,
+    ],
+};
+/**
+ * Get the standardized file name for a given file
+ * Returns the canonical name or the original if no mapping exists
+ */
+function getStandardFileName(fileName) {
+    return exports.LEGACY_FILE_NAMES[fileName] || fileName;
+}
+/**
+ * Check if a file name is legacy
+ */
+function isLegacyFileName(fileName) {
+    return fileName in exports.LEGACY_FILE_NAMES;
+}
+/**
+ * Get all possible names for a canonical file (including legacy)
+ */
+function getAllFileNameVariants(canonicalName) {
+    const variants = [canonicalName];
+    for (const [legacy, canonical] of Object.entries(exports.LEGACY_FILE_NAMES)) {
+        if (canonical === canonicalName) {
+            variants.push(legacy);
+        }
+    }
+    return variants;
+}
+//# sourceMappingURL=fileNames.js.map

package/dist/constants/fileNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileNames.js","sourceRoot":"","sources":["../../src/constants/fileNames.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8EH,kDAEC;AAKD,4CAEC;AAKD,wDAUC;AApGY,QAAA,aAAa,GAAG;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,mBAAmB;IAC/B,eAAe,EAAE,wBAAwB;IAEzC,qBAAqB;IACrB,GAAG,EAAE,WAAW,EAAG,2CAA2C;IAC9D,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,gBAAgB;IAC1B,cAAc,EAAE,wBAAwB;IACxC,iBAAiB,EAAE,yBAAyB;IAE5C,qBAAqB;IACrB,KAAK,EAAE,YAAY;IACnB,cAAc,EAAE,cAAc;IAC9B,QAAQ,EAAE,eAAe;IAEzB,iBAAiB;IACjB,mBAAmB,EAAE,0BAA0B;IAC/C,8BAA8B,EAAE,qCAAqC;IACrE,oBAAoB,EAAE,2BAA2B;IACjD,yBAAyB,EAAE,gCAAgC;CACnD,CAAC;AAEX;;;GAGG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,qBAAa,CAAC,QAAQ;IACtC,qBAAqB,EAAE,qBAAa,CAAC,UAAU;IAC/C,cAAc,EAAE,qBAAa,CAAC,UAAU;IACxC,WAAW,EAAE,qBAAa,CAAC,GAAG;IAC9B,QAAQ,EAAE,qBAAa,CAAC,GAAG;IAC3B,QAAQ,EAAE,qBAAa,CAAC,GAAG;IAC3B,WAAW,EAAE,qBAAa,CAAC,GAAG;IAC9B,UAAU,EAAE,qBAAa,CAAC,KAAK;IAC/B,aAAa,EAAE,qBAAa,CAAC,KAAK;IAClC,aAAa,EAAE,qBAAa,CAAC,QAAQ;IACrC,gBAAgB,EAAE,qBAAa,CAAC,QAAQ;IACxC,qBAAqB,EAAE,qBAAa,CAAC,cAAc;IACnD,sBAAsB,EAAE,qBAAa,CAAC,cAAc;IACpD,wBAAwB,EAAE,qBAAa,CAAC,cAAc;IACtD,sBAAsB,EAAE,qBAAa,CAAC,iBAAiB;IACvD,yBAAyB,EAAE,qBAAa,CAAC,iBAAiB;CAClD,CAAC;AAEX;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,WAAW,EAAE;QACX,qBAAa,CAAC,QAAQ;QACtB,qBAAa,CAAC,UAAU;QACxB,qBAAa,CAAC,UAAU;QACxB,qBAAa,CAAC,eAAe;KAC9B;IACD,cAAc,EAAE,CAAC,qBAAa,CAAC,GAAG,CAAC;IACnC,cAAc,EAAE,CAAC,qBAAa,CAAC,GAAG,CAAC;IACnC,wBAAwB,EAAE;QACxB,qBAAa,CAAC,GAAG;QACjB,qBAAa,CAAC,KAAK;KACpB;IACD,mBAAmB,EAAE;QACnB,qBAAa,CAAC,GAAG;QACjB,qBAAa,CAAC,KAAK;QACnB,qBAAa,CAAC,cAAc;KAC7B;CACO,CAAC;AAEX;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,QAAgB;IAClD,OAAO,yBAAiB,CAAC,QAA0C,CAAC,IAAI,QAAQ,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,IAAI,yBAAiB,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,aAAqB;IAC1D,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAC,CAAC;IAEjC,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAiB,CAAC,EAAE,CAAC;QACpE,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/interfaces/AIClient.d.ts

@@ -0,0 +1,198 @@
+/**
+ * AIClient Interface
+ *
+ * Unified interface for all AI client implementations in MyContext CLI.
+ * Supports both simple API calls and complex agentic workflows.
+ */
+export type OperationComplexity = 'simple' | 'moderate' | 'complex';
+export interface AIClientOptions {
+    model?: string;
+    modelCandidates?: string[];
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    workingDirectory?: string;
+}
+export interface AgentContext {
+    prd?: string;
+    types?: string;
+    brand?: string;
+    componentList?: any;
+    projectStructure?: string;
+    previousOutputs?: Record<string, any>;
+    userPrompt?: string;
+    workingDirectory?: string;
+}
+export interface StreamingOptions {
+    onProgress?: (message: string) => void;
+    onToken?: (token: string) => void;
+    onToolUse?: (tool: string, input: any) => void;
+    onError?: (error: Error) => void;
+}
+export interface GenerationResult {
+    content: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    toolsUsed?: string[];
+    duration?: number;
+    context?: AgentContext;
+}
+export interface WorkflowResult {
+    success: boolean;
+    content: string;
+    steps: string[];
+    errors?: string[];
+    context?: AgentContext;
+    duration?: number;
+}
+/**
+ * Base interface that all AI clients must implement
+ */
+export interface AIClient {
+    readonly clientType: 'direct-api' | 'agent-sdk' | 'hybrid';
+    readonly supportsTools: boolean;
+    readonly supportsStreaming: boolean;
+    hasApiKey(): boolean;
+    checkConnection(): Promise<boolean>;
+    setApiKey(apiKey: string): void;
+    generateText(prompt: string, options?: AIClientOptions): Promise<string>;
+    generateComponent(prompt: string, context?: AgentContext, options?: AIClientOptions): Promise<string>;
+    generateComponentRefinement(componentCode: string, prompt: string, context?: AgentContext, options?: AIClientOptions): Promise<string>;
+    listModels(): Promise<string[]>;
+    cleanup?(): Promise<void>;
+}
+/**
+ * Extended interface for Agent SDK clients with advanced capabilities
+ */
+export interface AgentAIClient extends AIClient {
+    clientType: 'agent-sdk' | 'hybrid';
+    supportsTools: true;
+    generateWithTools(prompt: string, tools: string[], context?: AgentContext, options?: AIClientOptions): Promise<GenerationResult>;
+    generateStream(prompt: string, streamOptions: StreamingOptions, context?: AgentContext, options?: AIClientOptions): Promise<GenerationResult>;
+    runWorkflow(workflowPrompt: string, context?: AgentContext, options?: AIClientOptions): Promise<WorkflowResult>;
+    configureAgent(config: AgentConfiguration): Promise<void>;
+    requestPermission(operation: string, target: string): Promise<boolean>;
+    useAgent(agentName: string, prompt: string, context?: AgentContext, options?: AIClientOptions): Promise<GenerationResult>;
+    getAvailableAgents(): string[];
+}
+export interface AgentConfiguration {
+    name: string;
+    description: string;
+    tools?: string[];
+    systemPrompt?: string;
+    model?: 'sonnet' | 'opus' | 'haiku' | 'inherit';
+    permissionMode?: 'strict' | 'permissive' | 'default';
+    allowedTools?: string[];
+    disallowedTools?: string[];
+}
+/**
+ * MCP Tool definition (from @anthropic-ai/claude-agent-sdk)
+ */
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: any;
+    handler: (args: any, extra?: any) => Promise<MCPToolResult>;
+}
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Hook callback types (from SDK)
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStop' | 'PreCompact';
+export interface BaseHookInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode?: string;
+}
+export interface PreToolUseHookInput extends BaseHookInput {
+    hook_event_name: 'PreToolUse';
+    tool_name: string;
+    tool_input: unknown;
+}
+export interface PostToolUseHookInput extends BaseHookInput {
+    hook_event_name: 'PostToolUse';
+    tool_name: string;
+    tool_input: unknown;
+    tool_response: unknown;
+}
+export type HookInput = PreToolUseHookInput | PostToolUseHookInput | BaseHookInput;
+export interface HookOutput {
+    continue?: boolean;
+    suppressOutput?: boolean;
+    stopReason?: string;
+    decision?: 'approve' | 'block';
+}
+export type HookCallback = (input: HookInput, toolUseID: string | undefined, options: {
+    signal: AbortSignal;
+}) => Promise<HookOutput>;
+/**
+ * Permission system types
+ */
+export type PermissionBehavior = 'allow' | 'deny' | 'ask';
+export interface PermissionResult {
+    behavior: PermissionBehavior;
+    updatedInput?: Record<string, unknown>;
+    message?: string;
+    interrupt?: boolean;
+}
+export type CanUseToolCallback = (toolName: string, input: Record<string, unknown>, options: {
+    signal: AbortSignal;
+    suggestions?: any[];
+}) => Promise<PermissionResult>;
+/**
+ * Setting sources (from SDK)
+ */
+export type SettingSource = 'user' | 'project' | 'local';
+/**
+ * Operation metadata to help router decide which client to use
+ */
+export interface OperationMetadata {
+    complexity: OperationComplexity;
+    requiresTools: boolean;
+    requiresStreaming: boolean;
+    requiresMultiStep: boolean;
+    requiresFileAccess: boolean;
+    requiresValidation: boolean;
+    estimatedTokens?: number;
+    timeoutMs?: number;
+}
+/**
+ * Factory configuration for creating AI clients
+ */
+export interface AIClientFactoryConfig {
+    preferredClient?: 'direct-api' | 'agent-sdk' | 'auto';
+    fallbackEnabled?: boolean;
+    autoSelectByComplexity?: boolean;
+    defaultModel?: string;
+    defaultTemperature?: number;
+    defaultMaxTokens?: number;
+    workingDirectory?: string;
+}
+/**
+ * Error types specific to AI operations
+ */
+export declare class AIClientError extends Error {
+    readonly code: string;
+    readonly recoverable: boolean;
+    constructor(message: string, code: string, recoverable?: boolean);
+}
+export declare class PermissionDeniedError extends AIClientError {
+    constructor(operation: string, target: string);
+}
+export declare class ToolExecutionError extends AIClientError {
+    constructor(tool: string, message: string);
+}
+export declare class ContextOverflowError extends AIClientError {
+    constructor(currentTokens: number, maxTokens: number);
+}
+//# sourceMappingURL=AIClient.d.ts.map

package/dist/interfaces/AIClient.d.ts.map

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

package/dist/interfaces/AIClient.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * AIClient Interface
+ *
+ * Unified interface for all AI client implementations in MyContext CLI.
+ * Supports both simple API calls and complex agentic workflows.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextOverflowError = exports.ToolExecutionError = exports.PermissionDeniedError = exports.AIClientError = void 0;
+/**
+ * Error types specific to AI operations
+ */
+class AIClientError extends Error {
+    constructor(message, code, recoverable = false) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.name = 'AIClientError';
+    }
+}
+exports.AIClientError = AIClientError;
+class PermissionDeniedError extends AIClientError {
+    constructor(operation, target) {
+        super(`Permission denied for operation '${operation}' on '${target}'`, 'PERMISSION_DENIED', true);
+    }
+}
+exports.PermissionDeniedError = PermissionDeniedError;
+class ToolExecutionError extends AIClientError {
+    constructor(tool, message) {
+        super(`Tool '${tool}' execution failed: ${message}`, 'TOOL_EXECUTION_FAILED', true);
+    }
+}
+exports.ToolExecutionError = ToolExecutionError;
+class ContextOverflowError extends AIClientError {
+    constructor(currentTokens, maxTokens) {
+        super(`Context overflow: ${currentTokens} tokens exceeds maximum ${maxTokens}`, 'CONTEXT_OVERFLOW', true);
+    }
+}
+exports.ContextOverflowError = ContextOverflowError;
+//# sourceMappingURL=AIClient.js.map

package/dist/interfaces/AIClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIClient.js","sourceRoot":"","sources":["../../src/interfaces/AIClient.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8QH;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACC,IAAY,EACZ,cAAuB,KAAK;QAE5C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAiB;QAG5C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED,MAAa,qBAAsB,SAAQ,aAAa;IACtD,YAAY,SAAiB,EAAE,MAAc;QAC3C,KAAK,CACH,oCAAoC,SAAS,SAAS,MAAM,GAAG,EAC/D,mBAAmB,EACnB,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AARD,sDAQC;AAED,MAAa,kBAAmB,SAAQ,aAAa;IACnD,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CACH,SAAS,IAAI,uBAAuB,OAAO,EAAE,EAC7C,uBAAuB,EACvB,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AARD,gDAQC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IACrD,YAAY,aAAqB,EAAE,SAAiB;QAClD,KAAK,CACH,qBAAqB,aAAa,2BAA2B,SAAS,EAAE,EACxE,kBAAkB,EAClB,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AARD,oDAQC"}

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mycontext-cli",
-  "version": "1.0.94",
-  "description": "MyContext CLI - AI-powered component generation with interactive build strategy planning, shadcn/ui and Next.js 15 integration",
+  "version": "2.0.0",
+  "description": "MyContext CLI - AI-powered full-stack application generator with complete architecture generation, server actions, Next.js 15 App Router, and self-documenting components",
   "main": "dist/cli.js",
   "bin": {
     "mycontext-cli": "dist/cli.js",
@@ -47,6 +47,7 @@
     "url": "https://github.com/farajabien/mycontext/issues"
   },
   "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.1",
     "axios": "^1.6.0",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
@@ -57,7 +58,8 @@
     "ora": "^7.0.1",
     "prompts": "^2.4.2",
     "sonner": "^2.0.7",
-    "uuid": "^9.0.1"
+    "uuid": "^9.0.1",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",