universal-agent-memory 0.1.0

package/dist/cli/droids.d.ts

@@ -0,0 +1,9 @@
+type DroidsAction = 'list' | 'add' | 'import';
+interface DroidsOptions {
+    name?: string;
+    template?: string;
+    path?: string;
+}
+export declare function droidsCommand(action: DroidsAction, options?: DroidsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=droids.d.ts.map

package/dist/cli/droids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"droids.d.ts","sourceRoot":"","sources":["../../src/cli/droids.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE9C,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiGD,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpG"}

package/dist/cli/droids.js

@@ -0,0 +1,227 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, basename } from 'path';
+const BUILTIN_TEMPLATES = {
+    'code-reviewer': {
+        description: 'Reviews diffs for correctness, tests, and migration risks',
+        content: `---
+name: code-reviewer
+description: Reviews diffs for correctness, tests, and migration risks
+model: inherit
+tools: ["Read", "LS", "Grep", "Glob"]
+---
+
+You are a senior code reviewer. Examine the diff and context provided:
+
+- Summarize the intent of the change
+- Flag correctness risks, missing tests, or rollback hazards
+- Call out any migrations or data changes that need coordination
+
+Reply with:
+Summary: <one-line>
+Findings:
+- <issue or ✅ No blockers>
+Follow-up:
+- <action or leave blank>
+`,
+    },
+    'security-reviewer': {
+        description: 'Looks for security issues in code changes',
+        content: `---
+name: security-reviewer
+description: Looks for security issues in recently edited files
+model: inherit
+tools: ["Read", "Grep", "WebSearch"]
+---
+
+Investigate the files referenced for security issues:
+
+- Identify injection, insecure transport, privilege escalation, or secrets exposure
+- Check for OWASP Top 10 vulnerabilities
+- Suggest concrete mitigations
+- Link to relevant CWE or standards when helpful
+
+Respond with:
+Summary: <headline>
+Findings:
+- <file>: <issue>
+Mitigations:
+- <recommendation>
+`,
+    },
+    'performance-reviewer': {
+        description: 'Identifies performance bottlenecks and optimization opportunities',
+        content: `---
+name: performance-reviewer
+description: Identifies performance bottlenecks in code changes
+model: inherit
+tools: ["Read", "Grep", "Glob"]
+---
+
+Analyze the code for performance issues:
+
+- Algorithmic complexity (O(n²), unnecessary iterations)
+- N+1 query patterns
+- Missing caching opportunities
+- Memory leaks or excessive allocations
+- I/O bottlenecks
+
+Respond with:
+Summary: <headline>
+Issues:
+- <file:line>: <issue> (severity: high/medium/low)
+Recommendations:
+- <optimization suggestion>
+`,
+    },
+    'test-writer': {
+        description: 'Generates unit tests for code changes',
+        content: `---
+name: test-writer
+description: Generates comprehensive unit tests for code
+model: inherit
+tools: ["Read", "Create", "Edit", "Execute"]
+---
+
+Generate tests for the provided code:
+
+1. Analyze the code to understand its behavior
+2. Identify edge cases and error conditions
+3. Write comprehensive unit tests
+4. Ensure tests are idiomatic for the language/framework
+5. Include both happy path and error cases
+
+Follow the project's existing test patterns and conventions.
+`,
+    },
+};
+export async function droidsCommand(action, options = {}) {
+    const cwd = process.cwd();
+    switch (action) {
+        case 'list':
+            await listDroids(cwd);
+            break;
+        case 'add':
+            await addDroid(cwd, options.name, options.template);
+            break;
+        case 'import':
+            await importDroids(cwd, options.path);
+            break;
+    }
+}
+async function listDroids(cwd) {
+    console.log(chalk.bold('\n🤖 Available Droids\n'));
+    const droidPaths = [
+        { path: join(cwd, '.factory/droids'), label: 'Project (.factory/droids)' },
+        { path: join(cwd, '.claude/agents'), label: 'Claude Code (.claude/agents)' },
+        { path: join(cwd, '.opencode/agent'), label: 'OpenCode (.opencode/agent)' },
+        { path: join(process.env.HOME || '~', '.factory/droids'), label: 'Personal (~/.factory/droids)' },
+    ];
+    let found = false;
+    for (const { path, label } of droidPaths) {
+        if (existsSync(path)) {
+            const files = readdirSync(path).filter((f) => f.endsWith('.md'));
+            if (files.length > 0) {
+                console.log(chalk.bold(label));
+                for (const file of files) {
+                    const content = readFileSync(join(path, file), 'utf-8');
+                    const descMatch = content.match(/description:\s*(.+)/);
+                    const desc = descMatch ? descMatch[1].trim() : 'No description';
+                    console.log(`  ${chalk.cyan(basename(file, '.md'))}: ${chalk.dim(desc)}`);
+                }
+                console.log('');
+                found = true;
+            }
+        }
+    }
+    if (!found) {
+        console.log(chalk.yellow('No droids found.'));
+        console.log(chalk.dim('Create one with: uam droids add <name>'));
+    }
+    console.log(chalk.bold('Built-in Templates:'));
+    for (const [name, { description }] of Object.entries(BUILTIN_TEMPLATES)) {
+        console.log(`  ${chalk.cyan(name)}: ${chalk.dim(description)}`);
+    }
+    console.log('');
+}
+async function addDroid(cwd, name, template) {
+    const spinner = ora(`Creating droid: ${name}...`).start();
+    try {
+        // Determine target directory
+        const droidDir = join(cwd, '.factory/droids');
+        if (!existsSync(droidDir)) {
+            mkdirSync(droidDir, { recursive: true });
+        }
+        const droidPath = join(droidDir, `${name}.md`);
+        if (existsSync(droidPath)) {
+            spinner.fail(`Droid already exists: ${name}`);
+            return;
+        }
+        let content;
+        if (template && BUILTIN_TEMPLATES[template]) {
+            content = BUILTIN_TEMPLATES[template].content.replace(/name: .+/, `name: ${name}`);
+        }
+        else if (template) {
+            spinner.fail(`Unknown template: ${template}`);
+            console.log(chalk.dim('Available templates: ' + Object.keys(BUILTIN_TEMPLATES).join(', ')));
+            return;
+        }
+        else {
+            content = `---
+name: ${name}
+description: Custom droid for ${name}
+model: inherit
+tools: ["Read", "LS", "Grep", "Glob"]
+---
+
+You are a specialized assistant for ${name} tasks.
+
+Describe what this droid should do and how it should respond.
+`;
+        }
+        writeFileSync(droidPath, content);
+        spinner.succeed(`Created droid: ${name}`);
+        console.log(chalk.dim(`  Path: ${droidPath}`));
+        console.log(chalk.dim(`  Edit the file to customize the droid's behavior.`));
+    }
+    catch (error) {
+        spinner.fail('Failed to create droid');
+        console.error(chalk.red(error));
+    }
+}
+async function importDroids(cwd, sourcePath) {
+    const spinner = ora('Importing droids...').start();
+    try {
+        if (!existsSync(sourcePath)) {
+            spinner.fail(`Path not found: ${sourcePath}`);
+            return;
+        }
+        const files = readdirSync(sourcePath).filter((f) => f.endsWith('.md'));
+        if (files.length === 0) {
+            spinner.fail('No .md files found in source path');
+            return;
+        }
+        const targetDir = join(cwd, '.factory/droids');
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+        }
+        let imported = 0;
+        for (const file of files) {
+            const content = readFileSync(join(sourcePath, file), 'utf-8');
+            const targetPath = join(targetDir, file);
+            if (existsSync(targetPath)) {
+                console.log(chalk.yellow(`  Skipped (exists): ${file}`));
+                continue;
+            }
+            writeFileSync(targetPath, content);
+            imported++;
+        }
+        spinner.succeed(`Imported ${imported} droid(s)`);
+    }
+    catch (error) {
+        spinner.fail('Failed to import droids');
+        console.error(chalk.red(error));
+    }
+}
+//# sourceMappingURL=droids.js.map

package/dist/cli/droids.js.map

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

package/dist/cli/generate.d.ts

@@ -0,0 +1,9 @@
+interface GenerateOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    platform?: string;
+    web?: boolean;
+}
+export declare function generateCommand(options: GenerateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AAWA,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA4K7E"}

package/dist/cli/generate.js

@@ -0,0 +1,203 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { analyzeProject } from '../analyzers/index.js';
+import { generateClaudeMd } from '../generators/claude-md.js';
+import { AgentContextConfigSchema } from '../types/index.js';
+import { mergeClaudeMd } from '../utils/merge-claude-md.js';
+export async function generateCommand(options) {
+    const cwd = process.cwd();
+    const configPath = join(cwd, '.uam.json');
+    console.log(chalk.bold('\n📝 Generate Agent Context Files\n'));
+    // Load config if exists
+    let config;
+    if (existsSync(configPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
+            config = AgentContextConfigSchema.parse(raw);
+            console.log(chalk.dim(`Using config from .uam.json`));
+        }
+        catch (error) {
+            console.error(chalk.red('Invalid .uam.json configuration'));
+            console.error(error);
+            return;
+        }
+    }
+    else {
+        console.log(chalk.yellow('No .uam.json found. Run `uam init` first, or generating with defaults.'));
+        config = {
+            version: '1.0.0',
+            project: {
+                name: 'Unknown Project',
+                defaultBranch: 'main',
+            },
+            template: {
+                extends: 'default',
+            },
+        };
+    }
+    // Analyze project
+    const spinner = ora('Analyzing project...').start();
+    let analysis;
+    try {
+        analysis = await analyzeProject(cwd);
+        spinner.succeed(`Analyzed: ${analysis.projectName}`);
+    }
+    catch (error) {
+        spinner.fail('Failed to analyze project');
+        console.error(chalk.red(error));
+        return;
+    }
+    // Determine target file based on --web flag
+    const isWebPlatform = options.web === true;
+    const claudeMdPath = join(cwd, 'CLAUDE.md');
+    const agentMdPath = join(cwd, 'AGENT.md');
+    const claudeMdExists = existsSync(claudeMdPath);
+    const agentMdExists = existsSync(agentMdPath);
+    let existingContent;
+    // Use AGENT.md when --web flag is passed, CLAUDE.md otherwise
+    let targetPath = isWebPlatform ? agentMdPath : claudeMdPath;
+    let targetFileName = isWebPlatform ? 'AGENT.md' : 'CLAUDE.md';
+    // Check if target file or alternate file exists
+    const targetExists = existsSync(targetPath);
+    const alternateExists = isWebPlatform ? claudeMdExists : agentMdExists;
+    if ((targetExists || alternateExists) && !options.force && !options.dryRun) {
+        // Read existing content from target or alternate file
+        if (targetExists) {
+            existingContent = readFileSync(targetPath, 'utf-8');
+        }
+        else if (alternateExists) {
+            // Read from alternate file but will write to target
+            const alternatePath = isWebPlatform ? claudeMdPath : agentMdPath;
+            existingContent = readFileSync(alternatePath, 'utf-8');
+            console.log(chalk.dim(`Migrating ${isWebPlatform ? 'CLAUDE.md' : 'AGENT.md'} to ${targetFileName}`));
+        }
+        const { action } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: `${targetFileName} ${targetExists ? 'already exists' : 'will be created'}. What would you like to do?`,
+                choices: [
+                    { name: 'Merge with existing content (recommended)', value: 'merge' },
+                    { name: 'Overwrite completely', value: 'overwrite' },
+                    { name: 'Cancel', value: 'cancel' },
+                ],
+                default: 'merge',
+            },
+        ]);
+        if (action === 'cancel') {
+            console.log(chalk.yellow('Generation cancelled.'));
+            return;
+        }
+        if (action === 'overwrite') {
+            existingContent = undefined;
+        }
+    }
+    // Override config based on --web flag
+    // Web mode: set webDatabase to trigger web platform detection
+    // Desktop mode (default): force desktop even if config has webDatabase
+    const effectiveConfig = isWebPlatform
+        ? {
+            ...config,
+            memory: {
+                ...config.memory,
+                shortTerm: {
+                    enabled: config.memory?.shortTerm?.enabled ?? true,
+                    path: config.memory?.shortTerm?.path ?? './agents/data/memory/short_term.db',
+                    webDatabase: 'agentContext',
+                    maxEntries: config.memory?.shortTerm?.maxEntries ?? 50,
+                    forceDesktop: false,
+                },
+            },
+        }
+        : {
+            // Desktop mode: ensure forceDesktop is true to override any webDatabase in config
+            ...config,
+            memory: {
+                ...config.memory,
+                shortTerm: config.memory?.shortTerm
+                    ? {
+                        ...config.memory.shortTerm,
+                        forceDesktop: true, // Force desktop mode regardless of config
+                    }
+                    : undefined,
+            },
+        };
+    const genSpinner = ora(`${existingContent ? 'Merging' : 'Generating'} ${targetFileName}...`).start();
+    try {
+        const newClaudeMd = await generateClaudeMd(analysis, effectiveConfig);
+        const claudeMd = existingContent ? mergeClaudeMd(existingContent, newClaudeMd) : newClaudeMd;
+        if (options.dryRun) {
+            genSpinner.succeed(`${existingContent ? 'Merged' : 'Generated'} (dry run)`);
+            console.log(chalk.dim(`\n--- ${targetFileName} Preview ---\n`));
+            console.log(claudeMd.substring(0, 2000) + '\n...\n');
+            console.log(chalk.dim(`Total: ${claudeMd.length} characters, ${claudeMd.split('\n').length} lines`));
+        }
+        else {
+            writeFileSync(targetPath, claudeMd);
+            genSpinner.succeed(`${existingContent ? 'Merged and updated' : 'Generated'} ${targetFileName}`);
+            if (existingContent) {
+                console.log(chalk.dim('  Preserved custom sections from existing file'));
+            }
+        }
+    }
+    catch (error) {
+        genSpinner.fail(`Failed to ${existingContent ? 'merge' : 'generate'} ${targetFileName}`);
+        console.error(chalk.red(error));
+        return;
+    }
+    // Generate platform-specific files if requested
+    if (options.platform || !options.dryRun) {
+        const platforms = options.platform
+            ? [options.platform]
+            : Object.entries(config.platforms || {})
+                .filter(([_, v]) => v?.enabled)
+                .map(([k]) => k);
+        for (const platform of platforms) {
+            const platformSpinner = ora(`Generating ${platform} files...`).start();
+            try {
+                await generatePlatformFiles(cwd, platform, analysis, config, options.dryRun);
+                platformSpinner.succeed(`Generated ${platform} files`);
+            }
+            catch (error) {
+                platformSpinner.fail(`Failed to generate ${platform} files`);
+                console.error(chalk.red(error));
+            }
+        }
+    }
+    if (!options.dryRun) {
+        console.log(chalk.green('\n✅ Generation complete!\n'));
+    }
+}
+async function generatePlatformFiles(_cwd, platform, _analysis, _config, dryRun) {
+    // Platform-specific generation logic
+    switch (platform) {
+        case 'claudeCode':
+            // Generate .claude/ structure
+            if (!dryRun) {
+                // TODO: Generate Claude Code specific files
+            }
+            break;
+        case 'factory':
+            // Generate .factory/ structure
+            if (!dryRun) {
+                // TODO: Generate Factory specific files
+            }
+            break;
+        case 'vscode':
+            // Generate .vscode/ settings
+            if (!dryRun) {
+                // TODO: Generate VSCode specific files
+            }
+            break;
+        case 'opencode':
+            // Generate opencode.json
+            if (!dryRun) {
+                // TODO: Generate OpenCode specific files
+            }
+            break;
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/generate.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,12 @@
+interface InitOptions {
+    platform: string[];
+    web?: boolean;
+    desktop?: boolean;
+    interactive?: boolean;
+    withMemory?: boolean;
+    withWorktrees?: boolean;
+    force?: boolean;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgPrE"}