agcel 1.0.4 → 2.0.0

package/README.md

@@ -1,72 +1,65 @@
-# AgCel
+# AgCEL
 
-AgCel is a local MCP (Model Context Protocol) Skills Server that functions both as a command-line tool and a backend for Antigravity workflows. It bridges the gap between local execution and AI agent capabilities by providing structured "Skills".
+Agentic Context Engineering Library: registry-backed agents and skills, MCP server, RAG (local JSON or optional ChromaDB), and CLI tooling.
 
-## Overview
+## Requirements
 
-The project consists of two main components:
-1.  **AgCel CLI**: A command-line interface to manage and interact with the MCP server.
-2.  **AgCel MCP Skills Server**: A local server that hosts skills and capabilities, enabling AI agents to perform complex tasks.
+- Node.js 20+
+- For Chroma mode: a running Chroma server (see [Chroma docs](https://docs.trychroma.com/))
 
-To install the AgCel CLI globally:
+## Install
 
 ```bash
-npm install -g agcel
+npm install
+npm run build
 ```
 
-This will make the `agc` command available globally. If you are developing locally, you can run `npm install -g .` from the project root.
-
-To remove AgCel, simply uninstall the npm package:
+Global MCP wiring:
 
 ```bash
-npm uninstall -g agcel
+npx agcel install
 ```
 
-You may also want to manually remove the global data directory (`~/.agcel`) and the server registration in your MCP config if you previously ran the legacy `install` command.
-
-## CLI Usage
+Targets Claude Desktop (macOS, Linux, Windows where paths are known), Claude Code (`~/.claude.json`), and Cursor (`~/.cursor/mcp.json`).
 
-The `agc` command-line tool is your primary interface. Application data is stored in the `.agc` directory in your project root, and `~/.agcel` for global configuration.
+## CLI
 
-| Command | Description |
-| :--- | :--- |
-| `agc init` | Initialize AgCel in the current project (copies workflows to `.agent/workflows`). |
-| `agc skills list` | List all available skills (local or global). |
-| `agc workflows list` | List all available workflows (local or global). |
-| `agc uninstall` | Clean up global data and remove the npm package. |
-| `agc --help` | Show the help menu. |
-| `agc --version` | Show the CLI version. |
+| Command | Purpose |
+|--------|---------|
+| `agcel init` | Project `.agcel/` layout and provider stubs |
+| `agcel install` | Register the MCP server in host configs |
+| `agcel suggest <words...>` | Rank agents for a task; prints next steps if confidence is low |
+| `agcel create-agent` | Interactive agent file (`--research` prints best-practice links) |
+| `agcel create-skill` | Interactive skill file |
+| `agcel pulse` | Summarize git changes into memory/RAG |
 
-## Concepts
+Run from source:
 
-### Skills
-
-**Skills** are specialized capabilities that allow the AI to perform complex tasks. AgCel comes with a rich set of built-in skills:
+```bash
+npm run cli -- suggest your task here
+```
 
--   **Languages**: Python, TypeScript, JavaScript
--   **Frameworks**: React, Next.js, FastAPI, Django
--   **DevOps**: Docker, GitHub Actions, Vercel
--   **Security**: OWASP, Vulnerability Scanning
--   **Methodology**: TDD, Systematic Debugging, Code Review, Architecture
+## MCP tools
 
-### Workflows
+- `route_query`: intent, RAG context, assembled prompt. Optional `conversation_history`, `previous_agent_name`, `draft_output` (guardrail check), `guardrail_strict`.
+- `detect_intent`, `get_context`, `ingest_document`, `generate_config`, `validate_output`
 
-**Workflows** are standard operating procedures for common development tasks.
+## Configuration (`.agcel/config.json`)
 
--   **Development**: `/feature`, `/fix`, `/test`, `/refactor`
--   **Planning**: `/plan`, `/brainstorm`, `/research`
--   **Operations**: `/ship`, `/deploy`, `/security-scan`
+- `ragEnabled`, `ragBackend` (`local` | `chroma`), `chroma` connection options
+- `ragQueryMetadataFilter`: restrict RAG hits by metadata equality
+- `strictGuardrailsOnRouteQuery`: treat failed guardrails on `draft_output` as blocking
 
-### Rules
+## Development
 
-**Rules** serve as guardrails for the AI.
+```bash
+npm run typecheck
+npm test
+```
 
--   **Boundary Rules**: "Do not use external libraries."
--   **Operational Rules**: "Always ask for clarification."
--   **Security Rules**: "Never share API keys."
+## Troubleshooting
 
-## Integration with Antigravity
+- **No skills attached to an agent**: ensure files exist under `.agcel/registry/skills/` and names match the agent `skills` list. Missing skills appear in `route_query` as `missing_skills` and `warnings`.
+- **Chroma errors**: AgCEL falls back to the local JSON index when Chroma is unreachable.
 
-When working with the Antigravity IDE:
-1.  Run `agc init` to set up the environment.
-2.  Use workflows in the Agent Window (e.g., `/feature` to start developing a new feature).
+See `requirements.md` for the full requirement set and `gaps.md` for implementation status.

package/dist/cli/commands/create.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare const createAgentCommand: Command;
+export declare const createSkillCommand: Command;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,kBAAkB,SAsD3B,CAAC;AAEL,eAAO,MAAM,kBAAkB,SAuB3B,CAAC"}

package/dist/cli/commands/create.js

@@ -0,0 +1,68 @@
+import { Command } from 'commander';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { formatResearchForSkills } from '../research-hints.js';
+function prompt(rl, question) {
+    return new Promise(resolve => rl.question(question, resolve));
+}
+export const createAgentCommand = new Command('create-agent')
+    .description('Interactively create a new AgCEL agent persona')
+    .option('--research', 'After skills are listed, print vetted best-practice links to review while authoring')
+    .action(async (options) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log('\nAgCEL Interactive Agent Builder\n');
+    const name = await prompt(rl, 'Agent name (e.g., backend-developer): ');
+    const description = await prompt(rl, 'Agent description: ');
+    const role = await prompt(rl, 'Role / System instruction summary: ');
+    const skillsInput = await prompt(rl, 'Skills (comma-separated, e.g., python,testing,debugging): ');
+    const skills = skillsInput.split(',').map(s => s.trim()).filter(Boolean);
+    const agent = { name, description, role, skills };
+    const registryPath = path.join(process.cwd(), '.agcel', 'registry', 'agents');
+    await fs.mkdir(registryPath, { recursive: true });
+    const filePath = path.join(registryPath, `${name}.json`);
+    await fs.writeFile(filePath, JSON.stringify(agent, null, 2));
+    console.log(`\nAgent "${name}" created at ${filePath}`);
+    if (options.research && skills.length > 0) {
+        console.log(`\n${formatResearchForSkills(skills)}\n`);
+    }
+    const createSkills = await prompt(rl, '\nWould you like to create skill files for this agent? (y/n): ');
+    if (createSkills.toLowerCase() === 'y') {
+        const skillsPath = path.join(process.cwd(), '.agcel', 'registry', 'skills');
+        await fs.mkdir(skillsPath, { recursive: true });
+        for (const skillName of skills) {
+            const skillDesc = await prompt(rl, `  Description for skill "${skillName}": `);
+            const systemPrompt = await prompt(rl, `  System prompt for "${skillName}": `);
+            const skill = {
+                name: skillName,
+                description: skillDesc,
+                systemPrompt,
+                tools: []
+            };
+            const skillFile = path.join(skillsPath, `${skillName}.json`);
+            await fs.writeFile(skillFile, JSON.stringify(skill, null, 2));
+            console.log(`  Skill "${skillName}" created at ${skillFile}`);
+        }
+    }
+    rl.close();
+    console.log('\nAgent setup complete. Run the MCP server to start using your new agent.\n');
+});
+export const createSkillCommand = new Command('create-skill')
+    .description('Interactively create a new AgCEL skill')
+    .action(async () => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log('\nAgCEL Interactive Skill Builder\n');
+    const name = await prompt(rl, 'Skill name: ');
+    const description = await prompt(rl, 'Description: ');
+    const systemPrompt = await prompt(rl, 'System prompt / instructions: ');
+    const toolsInput = await prompt(rl, 'Associated tools (comma-separated, or leave empty): ');
+    const tools = toolsInput.split(',').map(s => s.trim()).filter(Boolean);
+    const skill = { name, description, systemPrompt, tools };
+    const skillsPath = path.join(process.cwd(), '.agcel', 'registry', 'skills');
+    await fs.mkdir(skillsPath, { recursive: true });
+    const filePath = path.join(skillsPath, `${name}.json`);
+    await fs.writeFile(filePath, JSON.stringify(skill, null, 2));
+    rl.close();
+    console.log(`\nSkill "${name}" created at ${filePath}\n`);
+});
+//# sourceMappingURL=create.js.map

package/dist/cli/commands/create.js.map

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

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

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,WAAW,SA2FpB,CAAC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,98 @@
+import { Command } from 'commander';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getAdapter, getAllAdapters } from '../../providers/index.js';
+import { Registry } from '../../core/registry.js';
+function parseRagBackend(value) {
+    const v = String(value).toLowerCase();
+    if (v === 'local' || v === 'chroma')
+        return v;
+    throw new Error(`Invalid --rag-backend "${value}". Use local or chroma.`);
+}
+export const initCommand = new Command('init')
+    .description('Initialize AgCEL project structure (and optionally provider configs)')
+    .option('-p, --provider <type>', 'Provider type (claude, gemini, cursor, chatgpt)')
+    .option('-a, --agent <name>', 'Agent name to generate config for')
+    .option('--rag <mode>', 'RAG mode (enable, disable, auto)', 'auto')
+    .option('--rag-backend <backend>', 'When RAG is enabled: local (JSON index) or chroma (ChromaDB server)', (v) => parseRagBackend(v), 'local')
+    .option('--chroma-host <host>', 'Chroma server host (default localhost)')
+    .option('--chroma-port <port>', 'Chroma server port (default 8000)', (v) => {
+    const n = Number(v);
+    if (!Number.isFinite(n))
+        throw new Error(`Invalid --chroma-port "${v}"`);
+    return n;
+})
+    .option('--chroma-ssl', 'Use HTTPS for Chroma')
+    .option('--chroma-collection <name>', 'Chroma collection name (default agcel)')
+    .action(async (options) => {
+    const skillsDir = path.join(process.cwd(), '.agcel', 'skills');
+    const registryDir = path.join(process.cwd(), '.agcel', 'registry');
+    const configDir = path.join(process.cwd(), '.agcel');
+    const configPath = path.join(configDir, 'config.json');
+    try {
+        await fs.mkdir(skillsDir, { recursive: true });
+        await fs.mkdir(path.join(registryDir, 'agents'), { recursive: true });
+        await fs.mkdir(path.join(registryDir, 'skills'), { recursive: true });
+        await fs.mkdir(configDir, { recursive: true });
+        const ragMode = String(options.rag || 'auto').toLowerCase();
+        let ragEnabled;
+        if (ragMode === 'enable')
+            ragEnabled = true;
+        else if (ragMode === 'disable')
+            ragEnabled = false;
+        else
+            ragEnabled = undefined;
+        const config = {};
+        if (ragEnabled !== undefined) {
+            config.ragEnabled = ragEnabled;
+        }
+        if (ragEnabled === true) {
+            config.ragBackend = options.ragBackend;
+        }
+        if (options.chromaHost || options.chromaPort !== undefined || options.chromaSsl || options.chromaCollection) {
+            config.chroma = {};
+            if (options.chromaHost)
+                config.chroma.host = options.chromaHost;
+            if (options.chromaPort !== undefined)
+                config.chroma.port = options.chromaPort;
+            if (options.chromaSsl)
+                config.chroma.ssl = true;
+            if (options.chromaCollection)
+                config.chroma.collectionName = options.chromaCollection;
+        }
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
+        console.log('Initialized AgCEL structure under .agcel/.');
+        // If an agent is specified, generate provider-specific config
+        if (!options.agent)
+            return;
+        const registry = new Registry();
+        const agents = await registry.loadAgents();
+        const agent = agents.find(a => a.name === options.agent);
+        if (!agent) {
+            console.warn(`Agent "${options.agent}" not found in registry. Run 'agcel create-agent' first.`);
+            return;
+        }
+        const skills = await registry.loadSkills();
+        const adapters = options.provider
+            ? [getAdapter(options.provider)].filter((a) => Boolean(a))
+            : getAllAdapters();
+        if (options.provider && adapters.length === 0) {
+            console.error(`Unknown provider: ${options.provider}. Supported: claude, gemini, cursor, chatgpt`);
+            process.exit(1);
+        }
+        for (const adapter of adapters) {
+            const providerFiles = adapter.generateConfig(agent, skills);
+            for (const file of providerFiles) {
+                const filePath = path.join(process.cwd(), file.pathFromProjectRoot);
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, file.content);
+                console.log(`Generated ${path.relative(process.cwd(), filePath)}`);
+            }
+        }
+    }
+    catch (error) {
+        console.error('Failed to initialize project:', error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const installCommand: Command;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,cAAc,SA4CvB,CAAC"}

package/dist/cli/commands/install.helpers.d.ts

@@ -0,0 +1,15 @@
+export interface McpServerEntry {
+    command: string;
+    args: string[];
+}
+export interface McpConfig {
+    mcpServers?: Record<string, McpServerEntry>;
+    [key: string]: unknown;
+}
+export declare function getMcpConfigPaths(): Array<{
+    name: string;
+    path: string;
+}>;
+export declare function readJsonFile(filePath: string): Promise<McpConfig>;
+export declare function writeJsonFile(filePath: string, data: McpConfig): Promise<void>;
+//# sourceMappingURL=install.helpers.d.ts.map

package/dist/cli/commands/install.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.helpers.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BzE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOvE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF"}

package/dist/cli/commands/install.helpers.js

@@ -0,0 +1,47 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+export function getMcpConfigPaths() {
+    const home = os.homedir();
+    const paths = [
+        { name: 'Claude Code', path: path.join(home, '.claude.json') },
+        { name: 'Cursor', path: path.join(home, '.cursor', 'mcp.json') }
+    ];
+    const claudeDesktopPaths = [];
+    if (process.platform === 'darwin') {
+        claudeDesktopPaths.push({
+            name: 'Claude Desktop',
+            path: path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+        });
+    }
+    else if (process.platform === 'linux') {
+        claudeDesktopPaths.push({
+            name: 'Claude Desktop',
+            path: path.join(home, '.config', 'Claude', 'claude_desktop_config.json')
+        });
+    }
+    else if (process.platform === 'win32') {
+        const appData = process.env.APPDATA;
+        if (appData) {
+            claudeDesktopPaths.push({
+                name: 'Claude Desktop',
+                path: path.join(appData, 'Claude', 'claude_desktop_config.json')
+            });
+        }
+    }
+    return [...claudeDesktopPaths, ...paths];
+}
+export async function readJsonFile(filePath) {
+    try {
+        const data = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeJsonFile(filePath, data) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+//# sourceMappingURL=install.helpers.js.map

package/dist/cli/commands/install.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.helpers.js","sourceRoot":"","sources":["../../../src/cli/commands/install.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAY9B,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAA0C;QACnD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE;QAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE;KACjE,CAAC;IAEF,MAAM,kBAAkB,GAA0C,EAAE,CAAC;IACrE,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,kBAAkB,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC;SAChG,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACxC,kBAAkB,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC;SACzE,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpC,IAAI,OAAO,EAAE,CAAC;YACZ,kBAAkB,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC;aACjE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,kBAAkB,EAAE,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAe;IACnE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACrE,CAAC"}

package/dist/cli/commands/install.helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install.helpers.test.d.ts.map

package/dist/cli/commands/install.helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.helpers.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.helpers.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/install.helpers.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { getMcpConfigPaths } from './install.helpers.js';
+describe('getMcpConfigPaths', () => {
+    it('Given any platform when listing paths then Claude Code and Cursor entries exist', () => {
+        const paths = getMcpConfigPaths();
+        const labels = paths.map((p) => p.name);
+        expect(labels).toContain('Claude Code');
+        expect(labels).toContain('Cursor');
+    });
+    it('Given paths when listing then every path is absolute-style under homedir', () => {
+        const paths = getMcpConfigPaths();
+        expect(paths.length).toBeGreaterThanOrEqual(2);
+        for (const p of paths) {
+            expect(p.path.length).toBeGreaterThan(0);
+        }
+    });
+});
+//# sourceMappingURL=install.helpers.test.js.map

package/dist/cli/commands/install.helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.helpers.test.js","sourceRoot":"","sources":["../../../src/cli/commands/install.helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/commands/install.js

@@ -0,0 +1,74 @@
+import { Command } from 'commander';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getMcpConfigPaths, readJsonFile, writeJsonFile } from './install.helpers.js';
+export const installCommand = new Command('install')
+    .description('Globally install the AgCEL MCP server into IDE configurations')
+    .option('--target <ide>', 'Install to a specific IDE only (claude-desktop, claude-code, cursor)')
+    .option('--uninstall', 'Remove AgCEL from IDE configurations')
+    .option('--dry-run', 'Show what would be written without making changes')
+    .action(async (options) => {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const serverScript = path.resolve(__dirname, '../../server/index.js');
+    const serverEntry = {
+        command: 'node',
+        args: [serverScript]
+    };
+    const allConfigs = getMcpConfigPaths();
+    const targets = options.target
+        ? allConfigs.filter(c => c.name.toLowerCase().replaceAll(/\s+/g, '-') === options.target)
+        : allConfigs;
+    if (targets.length === 0) {
+        console.error(`Unknown target: ${options.target}. Available: claude-desktop, claude-code, cursor`);
+        process.exit(1);
+    }
+    console.log(options.uninstall ? 'Uninstalling AgCEL MCP Server.' : 'Installing AgCEL MCP Server.');
+    for (const target of targets) {
+        if (options.uninstall) {
+            await uninstallFromTarget({
+                target,
+                dryRun: Boolean(options.dryRun)
+            });
+        }
+        else {
+            await installToTarget({
+                target,
+                serverEntry,
+                dryRun: Boolean(options.dryRun)
+            });
+        }
+    }
+    if (!options.dryRun && !options.uninstall) {
+        console.log('AgCEL MCP Server installed. Restart your IDE to activate.');
+    }
+});
+async function uninstallFromTarget(args) {
+    const config = await readJsonFile(args.target.path);
+    const hasEntry = Boolean(config.mcpServers && 'agcel' in config.mcpServers);
+    if (!hasEntry) {
+        console.log(`   ${args.target.name} not installed, skipping`);
+        return;
+    }
+    delete config.mcpServers['agcel'];
+    if (args.dryRun) {
+        console.log(`   [DRY RUN] Would remove "agcel" from ${args.target.name} (${args.target.path})`);
+        return;
+    }
+    await writeJsonFile(args.target.path, config);
+    console.log(`   Removed from ${args.target.name}`);
+}
+async function installToTarget(args) {
+    const config = await readJsonFile(args.target.path);
+    config.mcpServers ??= {};
+    config.mcpServers['agcel'] = args.serverEntry;
+    if (args.dryRun) {
+        console.log(`   [DRY RUN] Would write to ${args.target.name}:`);
+        console.log(`   ${args.target.path}`);
+        console.log(`   ${JSON.stringify({ agcel: args.serverEntry }, null, 2).split('\n').join('\n   ')}\n`);
+        return;
+    }
+    await writeJsonFile(args.target.path, config);
+    console.log(`   Installed for ${args.target.name} at ${args.target.path}`);
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

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

package/dist/cli/commands/pulse.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function parsePorcelainChangedFiles(porcelain: string): string[];
+export declare const pulseCommand: Command;
+//# sourceMappingURL=pulse.d.ts.map

package/dist/cli/commands/pulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CActE;AAWD,eAAO,MAAM,YAAY,SAkBrB,CAAC"}

package/dist/cli/commands/pulse.js

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { ContextManager } from '../../core/context.js';
+import { PulseService } from '../../core/pulse.js';
+const execFileAsync = promisify(execFile);
+export function parsePorcelainChangedFiles(porcelain) {
+    // Porcelain v1 lines: XY SP <path> (rename/copy: <old> -> <new>)
+    return porcelain
+        .split('\n')
+        .map(l => l.replace(/\r$/, ''))
+        .filter(Boolean)
+        .map((line) => {
+        if (line.length < 4)
+            return '';
+        const payload = line.slice(3).trim();
+        const arrow = ' -> ';
+        if (payload.includes(arrow))
+            return payload.split(arrow).at(-1).trim();
+        return payload;
+    })
+        .filter(Boolean);
+}
+async function safeGit(args) {
+    try {
+        const { stdout } = await execFileAsync('git', args, { encoding: 'utf-8' });
+        return String(stdout || '').trim();
+    }
+    catch {
+        return '';
+    }
+}
+export const pulseCommand = new Command('pulse')
+    .description('Summarize recent project changes into memory/RAG')
+    .action(async () => {
+    const timestampIso = new Date().toISOString();
+    const gitHead = await safeGit(['log', '-1', '--oneline']);
+    const changedFilesRaw = await safeGit(['status', '--porcelain']);
+    const changedFiles = parsePorcelainChangedFiles(changedFilesRaw);
+    const diffStat = await safeGit(['diff', '--stat']);
+    const pulse = new PulseService();
+    const memo = pulse.buildMemo({ timestampIso, changedFiles, diffStat, gitHead });
+    const cm = new ContextManager();
+    await cm.initialize();
+    await cm.ingest(`pulse-${timestampIso}`, memo, { type: 'pulse' });
+    console.log('Pulse memo saved.');
+});
+//# sourceMappingURL=pulse.js.map

package/dist/cli/commands/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../../src/cli/commands/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,iEAAiE;IACjE,OAAO,SAAS;SACb,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;SAC9B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAc;IACnC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,0BAA0B,CAAC,eAAe,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAEhF,MAAM,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAElE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/cli/commands/pulse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pulse.test.d.ts.map

package/dist/cli/commands/pulse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pulse.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/pulse.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+import { parsePorcelainChangedFiles } from './pulse.js';
+describe('parsePorcelainChangedFiles', () => {
+    it('Given leading-space status codes when parsing then returns clean file paths', () => {
+        const porcelain = [
+            ' M src/a.ts',
+            'M  src/b.ts',
+            '?? src/new.ts'
+        ].join('\n');
+        const files = parsePorcelainChangedFiles(porcelain);
+        expect(files).toEqual(['src/a.ts', 'src/b.ts', 'src/new.ts']);
+    });
+    it('Given rename entry when parsing then returns new path', () => {
+        const porcelain = 'R  old/name.ts -> new/name.ts';
+        const files = parsePorcelainChangedFiles(porcelain);
+        expect(files).toEqual(['new/name.ts']);
+    });
+});
+//# sourceMappingURL=pulse.test.js.map

package/dist/cli/commands/pulse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.test.js","sourceRoot":"","sources":["../../../src/cli/commands/pulse.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,SAAS,GAAG;YAChB,aAAa;YACb,aAAa;YACb,eAAe;SAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,KAAK,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,SAAS,GAAG,+BAA+B,CAAC;QAElD,MAAM,KAAK,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/commands/suggest.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const suggestCommand: Command;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/cli/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,cAAc,SA8BvB,CAAC"}