@codemieai/code 0.0.33 → 0.0.34

package/dist/agents/plugins/claude/claude.plugin.d.ts

@@ -1,7 +1,8 @@
-import { AgentMetadata } from '../../core/types.js';
+import { AgentMetadata, VersionCompatibilityResult } from '../../core/types.js';
 import { BaseAgentAdapter } from '../../core/BaseAgentAdapter.js';
 import type { SessionAdapter } from '../../core/session/BaseSessionAdapter.js';
 import type { BaseExtensionInstaller } from '../../core/extension/BaseExtensionInstaller.js';
+import { type InstallationMethod } from '../../../utils/installation-detector.js';
 /**
  * Claude Code Plugin Metadata
  */
@@ -22,5 +23,47 @@ export declare class ClaudePlugin extends BaseAgentAdapter {
      * Returns installer to handle plugin installation
      */
     getExtensionInstaller(): BaseExtensionInstaller;
+    /**
+     * Get Claude version (override from BaseAgentAdapter)
+     * Parses version from 'claude --version' output
+     * Claude outputs: "2.1.23 (Claude Code)" - we need just "2.1.23"
+     *
+     * @returns Version string or null if not installed
+     */
+    getVersion(): Promise<string | null>;
+    /**
+     * Detect how Claude was installed (npm vs native)
+     * Returns installation method for informational purposes
+     *
+     * @returns Installation method: 'npm', 'native', or 'unknown'
+     */
+    getInstallationMethod(): Promise<InstallationMethod>;
+    /**
+     * Install Claude Code using native installer (override from BaseAgentAdapter)
+     * Installs latest available version from native installer
+     * For version-specific installs, use installVersion() method
+     *
+     * @throws {AgentInstallationError} If installation fails
+     */
+    install(): Promise<void>;
+    /**
+     * Install specific version of Claude Code
+     * Uses native installer with version parameter
+     * Special handling for version parameter:
+     * - undefined/'latest': Install latest available version
+     * - 'supported': Install version from metadata.supportedVersion
+     * - Semantic version string (e.g., '2.0.30'): Install specific version
+     *
+     * @param version - Version string (e.g., '2.0.30', 'latest', 'supported')
+     * @throws {AgentInstallationError} If installation fails
+     */
+    installVersion(version?: string): Promise<void>;
+    /**
+     * Check if installed version is compatible with CodeMie
+     * Compares against metadata.supportedVersion
+     *
+     * @returns Version compatibility result with status and version info
+     */
+    checkVersionCompatibility(): Promise<VersionCompatibilityResult>;
 }
 //# sourceMappingURL=claude.plugin.d.ts.map

package/dist/agents/plugins/claude/claude.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.plugin.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/claude/claude.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aA6ElC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,kBAAkB,CAAyB;;IAUnD;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;;OAGG;IACH,qBAAqB,IAAI,sBAAsB;CAGhD"}
+{"version":3,"file":"claude.plugin.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/claude/claude.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAK7F,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE5G;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aA+FlC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,kBAAkB,CAAyB;;IAUnD;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;;OAGG;IACH,qBAAqB,IAAI,sBAAsB;IAI/C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsB1C;;;;;OAKG;IACG,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAQ1D;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;;;;OAUG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ErD;;;;;OAKG;IACG,yBAAyB,IAAI,OAAO,CAAC,0BAA0B,CAAC;CA2FvE"}

package/dist/agents/plugins/claude/claude.plugin.js

@@ -1,6 +1,11 @@
 import { BaseAgentAdapter } from '../../core/BaseAgentAdapter.js';
 import { ClaudeSessionAdapter } from './claude.session.js';
 import { ClaudePluginInstaller } from './claude.plugin-installer.js';
+import { installNativeAgent } from '../../../utils/native-installer.js';
+import { compareVersions, isValidSemanticVersion } from '../../../utils/version-utils.js';
+import { AgentInstallationError, createErrorContext } from '../../../utils/errors.js';
+import { logger } from '../../../utils/logger.js';
+import { detectInstallationMethod } from '../../../utils/installation-detector.js';
 /**
  * Claude Code Plugin Metadata
  */
@@ -10,6 +15,14 @@ export const ClaudePluginMetadata = {
     description: 'Claude Code - official Anthropic CLI tool',
     npmPackage: '@anthropic-ai/claude-code',
     cliCommand: 'claude',
+    // Version management configuration
+    supportedVersion: '2.1.22', // Latest version tested with CodeMie backend
+    // Native installer URLs (used by installNativeAgent utility)
+    installerUrls: {
+        macOS: 'https://claude.ai/install.sh',
+        windows: 'https://claude.ai/install.cmd',
+        linux: 'https://claude.ai/install.sh'
+    },
     // Data paths (used by lifecycle hooks and analytics)
     dataPaths: {
         home: '.claude'
@@ -67,6 +80,13 @@ export const ClaudePluginMetadata = {
             if (!env.CLAUDE_CODE_ENABLE_TELEMETRY) {
                 env.CLAUDE_CODE_ENABLE_TELEMETRY = '0';
             }
+            // CRITICAL: Disable Claude Code auto-updater to maintain version control
+            // CodeMie manages Claude versions explicitly via installVersion() for compatibility
+            // Auto-updates could break version compatibility with CodeMie backend
+            // https://code.claude.com/docs/en/settings
+            if (!env.DISABLE_AUTOUPDATER) {
+                env.DISABLE_AUTOUPDATER = '1';
+            }
             return env;
         }
     }
@@ -97,5 +117,199 @@ export class ClaudePlugin extends BaseAgentAdapter {
     getExtensionInstaller() {
         return this.extensionInstaller;
     }
+    /**
+     * Get Claude version (override from BaseAgentAdapter)
+     * Parses version from 'claude --version' output
+     * Claude outputs: "2.1.23 (Claude Code)" - we need just "2.1.23"
+     *
+     * @returns Version string or null if not installed
+     */
+    async getVersion() {
+        if (!this.metadata.cliCommand) {
+            return null;
+        }
+        try {
+            const { exec } = await import('../../../utils/processes.js');
+            const result = await exec(this.metadata.cliCommand, ['--version']);
+            // Parse version from output like "2.1.23 (Claude Code)"
+            // Extract just the version number
+            const versionMatch = result.stdout.trim().match(/^(\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                return versionMatch[1];
+            }
+            return result.stdout.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Detect how Claude was installed (npm vs native)
+     * Returns installation method for informational purposes
+     *
+     * @returns Installation method: 'npm', 'native', or 'unknown'
+     */
+    async getInstallationMethod() {
+        if (!this.metadata.cliCommand) {
+            return 'unknown';
+        }
+        return await detectInstallationMethod(this.metadata.cliCommand);
+    }
+    /**
+     * Install Claude Code using native installer (override from BaseAgentAdapter)
+     * Installs latest available version from native installer
+     * For version-specific installs, use installVersion() method
+     *
+     * @throws {AgentInstallationError} If installation fails
+     */
+    async install() {
+        // Install latest available version (no version specified)
+        await this.installVersion(undefined);
+    }
+    /**
+     * Install specific version of Claude Code
+     * Uses native installer with version parameter
+     * Special handling for version parameter:
+     * - undefined/'latest': Install latest available version
+     * - 'supported': Install version from metadata.supportedVersion
+     * - Semantic version string (e.g., '2.0.30'): Install specific version
+     *
+     * @param version - Version string (e.g., '2.0.30', 'latest', 'supported')
+     * @throws {AgentInstallationError} If installation fails
+     */
+    async installVersion(version) {
+        const metadata = this.metadata;
+        // Resolve 'supported' to actual version from metadata
+        let resolvedVersion = version;
+        if (version === 'supported') {
+            if (!metadata.supportedVersion) {
+                throw new AgentInstallationError(metadata.name, 'No supported version defined in metadata');
+            }
+            resolvedVersion = metadata.supportedVersion;
+            logger.debug('Resolved version', {
+                from: 'supported',
+                to: resolvedVersion,
+            });
+        }
+        // SECURITY: Validate version format to prevent command injection
+        // Only allow semantic versions (e.g., "2.0.30") or special channels
+        if (resolvedVersion) {
+            const allowedChannels = ['latest', 'stable'];
+            const isValidChannel = allowedChannels.includes(resolvedVersion.toLowerCase());
+            const isValidVersion = isValidSemanticVersion(resolvedVersion);
+            if (!isValidChannel && !isValidVersion) {
+                throw new AgentInstallationError(metadata.name, `Invalid version format: "${resolvedVersion}". Expected semantic version (e.g., "2.0.30"), "latest", or "stable".`);
+            }
+            logger.debug('Version validation passed', {
+                version: resolvedVersion,
+                isValidChannel,
+                isValidVersion,
+            });
+        }
+        // Validate installer URLs are configured
+        if (!metadata.installerUrls) {
+            throw new AgentInstallationError(metadata.name, 'No installer URLs configured for native installation');
+        }
+        logger.info(`Installing ${metadata.displayName} ${resolvedVersion || 'latest'}...`);
+        // Execute native installer
+        const result = await installNativeAgent(metadata.name, metadata.installerUrls, resolvedVersion, {
+            timeout: 120000, // 2 minute timeout
+            verifyCommand: metadata.cliCommand || undefined,
+            installFlags: ['--force'], // Force installation to overwrite existing version
+        });
+        if (!result.success) {
+            throw new AgentInstallationError(metadata.name, `Installation failed. Output: ${result.output}`);
+        }
+        logger.success(`${metadata.displayName} ${result.installedVersion || resolvedVersion || 'latest'} installed successfully`);
+    }
+    /**
+     * Check if installed version is compatible with CodeMie
+     * Compares against metadata.supportedVersion
+     *
+     * @returns Version compatibility result with status and version info
+     */
+    async checkVersionCompatibility() {
+        const metadata = this.metadata;
+        const supportedVersion = metadata.supportedVersion || 'latest';
+        // Get installed version
+        const installedVersion = await this.getVersion();
+        logger.debug('Checking version compatibility', {
+            installedVersion,
+            supportedVersion,
+        });
+        // If not installed, return incompatible
+        if (!installedVersion) {
+            return {
+                compatible: false,
+                installedVersion: null,
+                supportedVersion,
+                isNewer: false,
+            };
+        }
+        // If no supported version configured, consider compatible
+        if (!metadata.supportedVersion) {
+            return {
+                compatible: true,
+                installedVersion,
+                supportedVersion: 'latest',
+                isNewer: false,
+            };
+        }
+        // Compare versions
+        try {
+            const comparison = compareVersions(installedVersion, supportedVersion);
+            logger.debug('Version comparison result', {
+                comparison,
+                installedVersion,
+                supportedVersion,
+                compatible: comparison <= 0,
+                isNewer: comparison > 0,
+            });
+            return {
+                compatible: comparison <= 0, // Compatible if installed <= supported
+                installedVersion,
+                supportedVersion,
+                isNewer: comparison > 0, // Newer if installed > supported (warning case)
+            };
+        }
+        catch (error) {
+            // If version comparison fails, provide comprehensive error context for debugging
+            const errorContext = createErrorContext(error, {
+                agent: metadata.name,
+            });
+            // Differentiate between parse errors (non-standard format) and unexpected errors
+            const isParseError = error instanceof Error && error.message.includes('Invalid semantic version');
+            if (isParseError) {
+                // Parse error: version format not recognized (e.g., "2.1.22 (Claude Code)" or custom format)
+                logger.warn('Non-standard version format detected, treating as incompatible', {
+                    ...errorContext,
+                    operation: 'checkVersionCompatibility',
+                    phase: 'version_comparison',
+                    installedVersion,
+                    supportedVersion,
+                    reason: 'parse_error',
+                });
+            }
+            else {
+                // Unexpected error: something went wrong during comparison
+                logger.error('Version compatibility check failed unexpectedly', {
+                    ...errorContext,
+                    operation: 'checkVersionCompatibility',
+                    phase: 'version_comparison',
+                    installedVersion,
+                    supportedVersion,
+                    reason: 'unexpected_error',
+                });
+            }
+            // Return incompatible (safer default) - users should be aware of version issues
+            // Don't throw - this would break user experience during setup/execution
+            return {
+                compatible: false,
+                installedVersion,
+                supportedVersion,
+                isNewer: false,
+            };
+        }
+    }
 }
 //# sourceMappingURL=claude.plugin.js.map

package/dist/agents/plugins/claude/claude.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.plugin.js","sourceRoot":"","sources":["../../../../src/agents/plugins/claude/claude.plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,2CAA2C;IAExD,UAAU,EAAE,2BAA2B;IACvC,UAAU,EAAE,QAAQ;IAEpB,qDAAqD;IACrD,SAAS,EAAE;QACT,IAAI,EAAE,SAAS;KAChB;IAED,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,oBAAoB,CAAC;QAC/B,MAAM,EAAE,CAAC,sBAAsB,CAAC;QAChC,KAAK,EAAE,CAAC,iBAAiB,CAAC;KAC3B;IAED,kBAAkB,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IACxD,oBAAoB,EAAE,EAAE;IACxB,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,eAAe,EAAE,SAAS,CAAC;IAEpE,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,gBAAgB;KAC7B;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,IAAI;SACb;KACF;IAED,mEAAmE;IACnE,aAAa,EAAE;QACb,sBAAsB,EAAE,CAAC,MAAM,CAAC;KACjC;IAED,0CAA0C;IAC1C,iFAAiF;IACjF,uDAAuD;IACvD,iFAAiF;IACjF,SAAS,EAAE;QACT,KAAK,EAAE;YACL,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,2BAA2B;SACtC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,YAAY;SACvB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,YAAY;SACvB;KACF;IAED,SAAS,EAAE;QACT,sDAAsD;QACtD,KAAK,CAAC,SAAS,CAAC,GAAG;YACjB,gDAAgD;YAChD,IAAI,CAAC,GAAG,CAAC,sCAAsC,EAAE,CAAC;gBAChD,GAAG,CAAC,sCAAsC,GAAG,GAAG,CAAC;YACnD,CAAC;YAED,4EAA4E;YAC5E,yEAAyE;YACzE,2CAA2C;YAC3C,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC;gBACtC,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAC;YACzC,CAAC;YAED,OAAO,GAAG,CAAC;QACb,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IACxC,cAAc,CAAiB;IAC/B,kBAAkB,CAAyB;IAEnD;QACE,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,oEAAoE;QACpE,IAAI,CAAC,cAAc,GAAG,IAAI,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;QACrE,0EAA0E;QAC1E,IAAI,CAAC,kBAAkB,GAAG,IAAI,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;CACF"}
+{"version":3,"file":"claude.plugin.js","sourceRoot":"","sources":["../../../../src/agents/plugins/claude/claude.plugin.ts"],"names":[],"mappings":"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"}

package/dist/agents/plugins/claude/plugin/README.md

@@ -84,9 +84,45 @@ Once loaded, the plugin automatically:
 
 ### Available Commands
 
-#### `/codemie-status`
+The plugin provides several built-in commands for project documentation and memory management.
 
-Display current session tracking status:
+#### Documentation Generation
+
+**`/codemie-init`** - Generate AI-optimized project documentation
+```bash
+# Analyze codebase and create CLAUDE.md + guides
+/codemie-init
+
+# With additional context
+/codemie-init "focus on API patterns"
+```
+
+**`/codemie-subagents`** - Generate project-specific subagents
+```bash
+# Create tailored subagent files in .claude/agents/
+/codemie-subagents
+```
+
+#### Memory Management
+
+**`/memory-add`** - Capture important learnings
+```bash
+# Add knowledge to project documentation
+/memory-add
+
+# With specific context
+/memory-add "auth flow requires initialization"
+```
+
+**`/memory-refresh`** - Audit and update documentation
+```bash
+# Verify docs match current implementation
+/memory-refresh
+```
+
+#### Status
+
+**`/codemie-status`** - Display session tracking status:
 
 ```
 CodeMie Session Status
@@ -98,6 +134,8 @@ Sync:           ✓ Connected (last: 30s ago)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
+**See [commands/README.md](./commands/README.md) for detailed usage and examples.**
+
 ## Hook Events
 
 The plugin registers the following hooks:

package/dist/agents/plugins/claude/plugin/claude-templates/README.md

@@ -38,7 +38,7 @@ claude-templates/
         ├── api/
         │   └── api-patterns.md.template
         ├── architecture/
-        │   └── layered-architecture.md.template
+        │   └── architecture.md.template
         ├── data/
         │   └── database-patterns.md.template
         ├── development/
@@ -160,7 +160,7 @@ claude-templates/
 - **development/security-patterns.md.template**: Authentication, validation, encryption
 - **development/setup-guide.md.template**: Installation and setup
 - **api/api-patterns.md.template**: REST/GraphQL endpoint patterns
-- **architecture/layered-architecture.md.template**: Layer responsibilities and flow
+- **architecture/architecture.md.template**: Directory structure, layered architecture, and organizational patterns
 - **data/database-patterns.md.template**: ORM, queries, transactions, migrations
 - **testing/testing-patterns.md.template**: Unit/integration tests, fixtures, mocking
 - **standards/code-quality.md.template**: Linting, formatting, type safety
@@ -410,7 +410,7 @@ The process includes 5 decision gates where Claude Code checks:
 
 **Generated guides**:
 - api/api-patterns.md (FastAPI endpoints)
-- architecture/layered-architecture.md (router→service→repository)
+- architecture/architecture.md (router→service→repository layers and project structure)
 - data/database-patterns.md (SQLAlchemy models, queries)
 - development/error-handling.md (FastAPI exception handlers)
 - development/logging-patterns.md (Python logging)
@@ -435,7 +435,7 @@ The process includes 5 decision gates where Claude Code checks:
 
 **Generated guides**:
 - api/api-patterns.md (Express routes)
-- architecture/layered-architecture.md (routes→services→repositories)
+- architecture/architecture.md (routes→services→repositories layers and project structure)
 - data/database-patterns.md (Mongoose schemas, queries)
 - development/error-handling.md (Express error middleware)
 - development/logging-patterns.md (Winston/Morgan)
@@ -460,7 +460,7 @@ The process includes 5 decision gates where Claude Code checks:
 
 **Generated guides**:
 - api/api-patterns.md (REST controllers)
-- architecture/layered-architecture.md (controller→service→repository)
+- architecture/architecture.md (controller→service→repository layers and project structure)
 - data/database-patterns.md (JPA entities, repositories)
 - development/error-handling.md (Exception handlers)
 - development/logging-patterns.md (SLF4J/Logback)