The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat: add auto-update command
Affaan Mustafaa7a56fa2a256
diff --git a/AGENTS.md b/AGENTS.mdindex e4edf5fa2..bc08e9361 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,6 +1,6 @@# Everything Claude Code (ECC) — Agent Instructions-This is a **production-ready AI coding plugin** providing 48 specialized agents, 184 skills, 79 commands, and automated hook workflows for software development.+This is a **production-ready AI coding plugin** providing 48 specialized agents, 184 skills, 80 commands, and automated hook workflows for software development.**Version:** 2.0.0-rc.1@@ -147,7 +147,7 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat```agents/ — 48 specialized subagentsskills/ — 184 workflow skills and domain knowledge-commands/ — 79 slash commands+commands/ — 80 slash commandshooks/ — Trigger-based automationsrules/ — Always-follow guidelines (common + per-language)scripts/ — Cross-platform Node.js utilitiesdiff --git a/README.md b/README.mdindex 1aec8238c..446144a44 100644--- a/README.md+++ b/README.md@@ -312,7 +312,7 @@ If you stacked methods, clean up in this order:/plugin list everything-claude-code@everything-claude-code```-**That's it!** You now have access to 48 agents, 184 skills, and 79 legacy command shims.+**That's it!** You now have access to 48 agents, 184 skills, and 80 legacy command shims.### Dashboard GUI@@ -1279,7 +1279,7 @@ The configuration is automatically detected from `.opencode/opencode.json`.| Feature | Claude Code | OpenCode | Status ||---------|-------------|----------|--------|| Agents | PASS: 48 agents | PASS: 12 agents | **Claude Code leads** |-| Commands | PASS: 79 commands | PASS: 31 commands | **Claude Code leads** |+| Commands | PASS: 80 commands | PASS: 31 commands | **Claude Code leads** || Skills | PASS: 184 skills | PASS: 37 skills | **Claude Code leads** || Hooks | PASS: 8 event types | PASS: 11 events | **OpenCode has more!** || Rules | PASS: 29 rules | PASS: 13 instructions | **Claude Code leads** |@@ -1388,7 +1388,7 @@ ECC is the **first plugin to maximize every major AI coding tool**. Here's how e| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode ||---------|------------|------------|-----------|----------|| **Agents** | 48 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |-| **Commands** | 79 | Shared | Instruction-based | 31 |+| **Commands** | 80 | Shared | Instruction-based | 31 || **Skills** | 184 | Shared | 10 (native format) | 37 || **Hook Events** | 8 types | 15 types | None yet | 11 types || **Hook Scripts** | 20+ scripts | 16 scripts (DRY adapter) | N/A | Plugin hooks |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 8f1db967d..0f89779be 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -160,7 +160,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list everything-claude-code@everything-claude-code```-**完成!** 你现在可以使用 48 个代理、184 个技能和 79 个命令。+**完成!** 你现在可以使用 48 个代理、184 个技能和 80 个命令。### multi-* 命令需要额外配置diff --git a/agent.yaml b/agent.yamlindex ba6b3d9e9..de1d8a507 100644--- a/agent.yaml+++ b/agent.yaml@@ -146,6 +146,7 @@ skills:commands:- agent-sort- aside+ - auto-update- build-fix- checkpoint- clawdiff --git a/commands/auto-update.md b/commands/auto-update.mdnew file mode 100644index 000000000..d2670db6e--- /dev/null+++ b/commands/auto-update.md@@ -0,0 +1,28 @@+---+description: Pull the latest ECC repo changes and reinstall the current managed targets.+disable-model-invocation: true+---++# Auto Update++Update ECC from its upstream repo and regenerate the current context's managed install using the original install-state request.++## Usage++```bash+# Preview the update without mutating anything+ECC_ROOT="${CLAUDE_PLUGIN_ROOT:-$(node -e "var r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [['ecc'],['ecc@ecc'],['marketplace','ecc'],['everything-claude-code'],['everything-claude-code@everything-claude-code'],['marketplace','everything-claude-code']]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of ['ecc','everything-claude-code']){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();console.log(r)")}"+node "$ECC_ROOT/scripts/auto-update.js" --dry-run++# Update only Cursor-managed files in the current project+node "$ECC_ROOT/scripts/auto-update.js" --target cursor++# Override the ECC repo root explicitly+node "$ECC_ROOT/scripts/auto-update.js" --repo-root /path/to/everything-claude-code+```++## Notes++- This command uses the recorded install-state request and reruns `install-apply.js` after pulling the latest repo changes.+- Reinstall is intentional: it handles upstream renames and deletions that `repair.js` cannot safely reconstruct from stale operations alone.+- Use `--dry-run` first if you want to see the reconstructed reinstall plan before mutating anything.diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.mdindex 7fe7978c4..04f5d4f8c 100644--- a/docs/zh-CN/AGENTS.md+++ b/docs/zh-CN/AGENTS.md@@ -1,6 +1,6 @@# Everything Claude Code (ECC) — 智能体指令-这是一个**生产就绪的 AI 编码插件**,提供 48 个专业代理、184 项技能、79 条命令以及自动化钩子工作流,用于软件开发。+这是一个**生产就绪的 AI 编码插件**,提供 48 个专业代理、184 项技能、80 条命令以及自动化钩子工作流,用于软件开发。**版本:** 2.0.0-rc.1@@ -148,7 +148,7 @@```agents/ — 48 个专业子代理skills/ — 184 个工作流技能和领域知识-commands/ — 79 个斜杠命令+commands/ — 80 个斜杠命令hooks/ — 基于触发的自动化rules/ — 始终遵循的指导方针(通用 + 每种语言)scripts/ — 跨平台 Node.js 实用工具diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.mdindex 9dbbe9e3e..497c415f7 100644--- a/docs/zh-CN/README.md+++ b/docs/zh-CN/README.md@@ -215,7 +215,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list everything-claude-code@everything-claude-code```-**搞定!** 你现在可以使用 48 个智能体、184 项技能和 79 个命令了。+**搞定!** 你现在可以使用 48 个智能体、184 项技能和 80 个命令了。***@@ -1101,7 +1101,7 @@ opencode| 功能特性 | Claude Code | OpenCode | 状态 ||---------|-------------|----------|--------|| 智能体 | PASS: 48 个 | PASS: 12 个 | **Claude Code 领先** |-| 命令 | PASS: 79 个 | PASS: 31 个 | **Claude Code 领先** |+| 命令 | PASS: 80 个 | PASS: 31 个 | **Claude Code 领先** || 技能 | PASS: 184 项 | PASS: 37 项 | **Claude Code 领先** || 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多!** || 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** |@@ -1213,7 +1213,7 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以| 功能特性 | Claude Code | Cursor IDE | Codex CLI | OpenCode ||---------|------------|------------|-----------|----------|| **智能体** | 48 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |-| **命令** | 79 | 共享 | 基于指令 | 31 |+| **命令** | 80 | 共享 | 基于指令 | 31 || **技能** | 184 | 共享 | 10 (原生格式) | 37 || **钩子事件** | 8 种类型 | 15 种类型 | 暂无 | 11 种类型 || **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |diff --git a/manifests/install-modules.json b/manifests/install-modules.jsonindex dc944c6ec..dade17d0b 100644--- a/manifests/install-modules.json+++ b/manifests/install-modules.json@@ -90,6 +90,7 @@".gemini",".opencode","mcp-configs",+ "scripts/auto-update.js","scripts/setup-package-manager.js"],"targets": [diff --git a/scripts/auto-update.js b/scripts/auto-update.jsnew file mode 100644index 000000000..c6b48119b--- /dev/null+++ b/scripts/auto-update.js@@ -0,0 +1,361 @@+#!/usr/bin/env node++const fs = require('fs');+const os = require('os');+const path = require('path');+const { spawnSync } = require('child_process');++const { discoverInstalledStates } = require('./lib/install-lifecycle');+const { SUPPORTED_INSTALL_TARGETS } = require('./lib/install-manifests');++function showHelp(exitCode = 0) {+ console.log(`+Usage: node scripts/auto-update.js [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--repo-root <path>] [--dry-run] [--json]++Pull the latest ECC repo changes and reinstall the current context's managed targets+using the original install-state request.+`);+ process.exit(exitCode);+}++function parseArgs(argv) {+ const args = argv.slice(2);+ const parsed = {+ targets: [],+ repoRoot: null,+ dryRun: false,+ json: false,+ help: false,+ };++ for (let index = 0; index < args.length; index += 1) {+ const arg = args[index];++ if (arg === '--target') {+ parsed.targets.push(args[index + 1] || null);+ index += 1;+ } else if (arg === '--repo-root') {+ parsed.repoRoot = args[index + 1] || null;+ index += 1;+ } else if (arg === '--dry-run') {+ parsed.dryRun = true;+ } else if (arg === '--json') {+ parsed.json = true;+ } else if (arg === '--help' || arg === '-h') {+ parsed.help = true;+ } else {+ throw new Error(`Unknown argument: ${arg}`);+ }+ }++ return parsed;+}++function deriveRepoRootFromState(state) {+ const operations = Array.isArray(state && state.operations) ? state.operations : [];++ for (const operation of operations) {+ if (typeof operation.sourcePath !== 'string' || !operation.sourcePath.trim()) {+ continue;+ }++ if (typeof operation.sourceRelativePath !== 'string' || !operation.sourceRelativePath.trim()) {+ continue;+ }++ const relativeParts = operation.sourceRelativePath+ .split(/[\\/]+/)+ .filter(Boolean);++ if (relativeParts.length === 0) {+ continue;+ }++ let repoRoot = path.resolve(operation.sourcePath);+ for (let index = 0; index < relativeParts.length; index += 1) {+ repoRoot = path.dirname(repoRoot);+ }++ return repoRoot;+ }++ throw new Error('Unable to infer ECC repo root from install-state operations');+}++function buildInstallApplyArgs(record) {+ const state = record.state;+ const target = state.target.target || record.adapter.target;+ const request = state.request || {};+ const args = [];++ if (target) {+ args.push('--target', target);+ }++ if (request.profile) {+ args.push('--profile', request.profile);+ }++ if (Array.isArray(request.modules) && request.modules.length > 0) {+ args.push('--modules', request.modules.join(','));+ }++ for (const componentId of Array.isArray(request.includeComponents) ? request.includeComponents : []) {+ args.push('--with', componentId);+ }++ for (const componentId of Array.isArray(request.excludeComponents) ? request.excludeComponents : []) {+ args.push('--without', componentId);+ }++ for (const language of Array.isArray(request.legacyLanguages) ? request.legacyLanguages : []) {+ args.push(language);+ }++ return args;+}++function determineInstallCwd(record, repoRoot) {+ if (record.adapter.kind === 'project') {+ return path.dirname(record.state.target.root);+ }++ return repoRoot;+}++function validateRepoRoot(repoRoot) {+ const normalized = path.resolve(repoRoot);+ const packageJsonPath = path.join(normalized, 'package.json');+ const installApplyPath = path.join(normalized, 'scripts', 'install-apply.js');++ if (!fs.existsSync(packageJsonPath)) {+ throw new Error(`Invalid ECC repo root: missing package.json at ${packageJsonPath}`);+ }++ if (!fs.existsSync(installApplyPath)) {+ throw new Error(`Invalid ECC repo root: missing install script at ${installApplyPath}`);+ }++ return normalized;+}++function runExternalCommand(command, args, options = {}) {+ const result = spawnSync(command, args, {+ cwd: options.cwd,+ env: options.env || process.env,+ encoding: 'utf8',+ maxBuffer: 10 * 1024 * 1024,+ });++ if (result.error) {+ throw result.error;+ }++ if (typeof result.status === 'number' && result.status !== 0) {+ const errorOutput = (result.stderr || result.stdout || '').trim();+ throw new Error(`${command} ${args.join(' ')} failed${errorOutput ? `: ${errorOutput}` : ''}`);+ }++ return result;+}++function runAutoUpdate(options = {}, dependencies = {}) {+ const discover = dependencies.discoverInstalledStates || discoverInstalledStates;+ const execute = dependencies.runExternalCommand || runExternalCommand;+ const homeDir = options.homeDir || process.env.HOME || os.homedir();+ const projectRoot = options.projectRoot || process.cwd();+ const requestedRepoRoot = options.repoRoot ? validateRepoRoot(options.repoRoot) : null;+ const records = discover({+ homeDir,+ projectRoot,+ targets: options.targets,+ }).filter(record => record.exists);++ const results = [];+ if (records.length === 0) {+ return {+ dryRun: Boolean(options.dryRun),+ repoRoot: requestedRepoRoot,+ results,+ summary: {+ checkedCount: 0,+ updatedCount: 0,+ errorCount: 0,+ },+ };+ }++ const validRecords = [];+ const inferredRepoRoots = [];+ for (const record of records) {+ if (record.error || !record.state) {+ results.push({+ adapter: record.adapter,+ installStatePath: record.installStatePath,+ status: 'error',+ error: record.error || 'No valid install-state available',+ });+ continue;+ }++ const recordRepoRoot = requestedRepoRoot || validateRepoRoot(deriveRepoRootFromState(record.state));+ inferredRepoRoots.push(recordRepoRoot);+ validRecords.push({+ record,+ repoRoot: recordRepoRoot,+ });+ }++ if (!requestedRepoRoot) {+ const uniqueRepoRoots = [...new Set(inferredRepoRoots)];+ if (uniqueRepoRoots.length > 1) {+ throw new Error(`Multiple ECC repo roots detected: ${uniqueRepoRoots.join(', ')}`);+ }+ }++ const repoRoot = requestedRepoRoot || inferredRepoRoots[0] || null;+ if (!repoRoot) {+ return {+ dryRun: Boolean(options.dryRun),+ repoRoot,+ results,+ summary: {+ checkedCount: results.length,+ updatedCount: 0,+ errorCount: results.length,+ },+ };+ }++ const env = {+ ...process.env,+ HOME: homeDir,+ USERPROFILE: homeDir,+ };++ if (!options.dryRun) {+ execute('git', ['fetch', '--all', '--prune'], { cwd: repoRoot, env });+ execute('git', ['pull', '--ff-only'], { cwd: repoRoot, env });+ }++ for (const entry of validRecords) {+ const installArgs = buildInstallApplyArgs(entry.record);+ const args = [+ path.join(repoRoot, 'scripts', 'install-apply.js'),+ ...installArgs,+ '--json',+ ];++ if (options.dryRun) {+ args.push('--dry-run');+ }++ try {+ const commandResult = execute(process.execPath, args, {+ cwd: determineInstallCwd(entry.record, repoRoot),+ env,+ });++ let payload = null;+ if (commandResult.stdout && commandResult.stdout.trim()) {+ payload = JSON.parse(commandResult.stdout);+ }++ results.push({+ adapter: entry.record.adapter,+ installStatePath: entry.record.installStatePath,+ repoRoot,+ cwd: determineInstallCwd(entry.record, repoRoot),+ installArgs,+ status: options.dryRun ? 'planned' : 'updated',+ payload,+ });+ } catch (error) {+ results.push({+ adapter: entry.record.adapter,+ installStatePath: entry.record.installStatePath,+ repoRoot,+ installArgs,+ status: 'error',+ error: error.message,+ });+ }+ }++ return {+ dryRun: Boolean(options.dryRun),+ repoRoot,+ results,+ summary: {+ checkedCount: results.length,+ updatedCount: results.filter(result => result.status === 'updated' || result.status === 'planned').length,+ errorCount: results.filter(result => result.status === 'error').length,+ },+ };+}++function printHuman(result) {+ if (result.results.length === 0) {+ console.log('No ECC install-state files found for the current home/project context.');+ return;+ }++ console.log(`${result.dryRun ? 'Auto-update dry run' : 'Auto-update summary'}:\n`);+ if (result.repoRoot) {+ console.log(`Repo root: ${result.repoRoot}\n`);+ }++ for (const entry of result.results) {+ console.log(`- ${entry.adapter.id}`);+ console.log(` Status: ${entry.status.toUpperCase()}`);+ console.log(` Install-state: ${entry.installStatePath}`);+ if (entry.error) {+ console.log(` Error: ${entry.error}`);+ continue;+ }++ console.log(` Reinstall args: ${entry.installArgs.join(' ') || '(none)'}`);+ }++ console.log(`\nSummary: checked=${result.summary.checkedCount}, ${result.dryRun ? 'planned' : 'updated'}=${result.summary.updatedCount}, errors=${result.summary.errorCount}`);+}++function main() {+ try {+ const options = parseArgs(process.argv);+ if (options.help) {+ showHelp(0);+ }++ const result = runAutoUpdate({+ homeDir: process.env.HOME || os.homedir(),+ projectRoot: process.cwd(),+ targets: options.targets,+ repoRoot: options.repoRoot,+ dryRun: options.dryRun,+ });++ if (options.json) {+ console.log(JSON.stringify(result, null, 2));+ } else {+ printHuman(result);+ }++ process.exitCode = result.summary.errorCount > 0 ? 1 : 0;+ } catch (error) {+ console.error(`Error: ${error.message}`);+ process.exit(1);+ }+}++if (require.main === module) {+ main();+}++module.exports = {+ parseArgs,+ deriveRepoRootFromState,+ buildInstallApplyArgs,+ determineInstallCwd,+ runAutoUpdate,+};diff --git a/scripts/ecc.js b/scripts/ecc.jsindex 50f469089..44ba6547e 100755--- a/scripts/ecc.js+++ b/scripts/ecc.js@@ -33,6 +33,10 @@ const COMMANDS = {script: 'repair.js',description: 'Restore drifted or missing ECC-managed files',},+ 'auto-update': {+ script: 'auto-update.js',+ description: 'Pull latest ECC changes and reinstall the current managed targets',+ },status: {script: 'status.js',description: 'Query the ECC SQLite state store status summary',@@ -58,6 +62,7 @@ const PRIMARY_COMMANDS = ['list-installed','doctor','repair',+ 'auto-update','status','sessions','session-inspect',@@ -90,6 +95,7 @@ Examples:ecc list-installed --jsonecc doctor --target cursorecc repair --dry-run+ ecc auto-update --dry-runecc status --jsonecc sessionsecc sessions session-active --jsondiff --git a/tests/scripts/auto-update.test.js b/tests/scripts/auto-update.test.jsnew file mode 100644index 000000000..ca77149b2--- /dev/null+++ b/tests/scripts/auto-update.test.js@@ -0,0 +1,392 @@+/**+ * Tests for scripts/auto-update.js+ */++const assert = require('assert');+const fs = require('fs');+const os = require('os');+const path = require('path');++const {+ parseArgs,+ deriveRepoRootFromState,+ buildInstallApplyArgs,+ determineInstallCwd,+ runAutoUpdate,+} = require('../../scripts/auto-update');+const {+ createInstallState,+} = require('../../scripts/lib/install-state');++function test(name, fn) {+ try {+ fn();+ console.log(` \u2713 ${name}`);+ return true;+ } catch (error) {+ console.log(` \u2717 ${name}`);+ console.log(` Error: ${error.message}`);+ return false;+ }+}++function createTempDir(prefix) {+ return fs.mkdtempSync(path.join(os.tmpdir(), prefix));+}++function cleanup(dirPath) {+ fs.rmSync(dirPath, { recursive: true, force: true });+}++function makeRecord({ repoRoot, homeDir, projectRoot, adapter, request, resolution, operations }) {+ const targetRoot = adapter.kind === 'project'+ ? path.join(projectRoot, `.${adapter.target}`)+ : path.join(homeDir, '.claude');+ const installStatePath = adapter.kind === 'project'+ ? path.join(targetRoot, 'ecc-install-state.json')+ : path.join(targetRoot, 'ecc', 'install-state.json');++ const state = createInstallState({+ adapter,+ targetRoot,+ installStatePath,+ request,+ resolution,+ operations,+ source: {+ repoVersion: '1.10.0',+ repoCommit: 'abc123',+ manifestVersion: 1,+ },+ });++ return {+ adapter,+ targetRoot,+ installStatePath,+ exists: true,+ state,+ error: null,+ repoRoot,+ };+}++function ensureFakeRepo(repoRoot) {+ fs.mkdirSync(path.join(repoRoot, 'scripts'), { recursive: true });+ fs.writeFileSync(+ path.join(repoRoot, 'package.json'),+ JSON.stringify({ name: 'everything-claude-code', version: '1.10.0' }, null, 2)+ );+ fs.writeFileSync(path.join(repoRoot, 'scripts', 'install-apply.js'), '#!/usr/bin/env node\n');+}++function runTests() {+ console.log('\n=== Testing auto-update.js ===\n');++ let passed = 0;+ let failed = 0;++ if (test('parseArgs reads repo-root, target, dry-run, and json flags', () => {+ const parsed = parseArgs([+ 'node',+ 'scripts/auto-update.js',+ '--target',+ 'cursor',+ '--repo-root',+ '/tmp/ecc',+ '--dry-run',+ '--json',+ ]);++ assert.deepStrictEqual(parsed.targets, ['cursor']);+ assert.strictEqual(parsed.repoRoot, '/tmp/ecc');+ assert.strictEqual(parsed.dryRun, true);+ assert.strictEqual(parsed.json, true);+ })) passed += 1; else failed += 1;++ if (test('parseArgs rejects unknown arguments', () => {+ assert.throws(+ () => parseArgs(['node', 'scripts/auto-update.js', '--bogus']),+ /Unknown argument: --bogus/+ );+ })) passed += 1; else failed += 1;++ if (test('deriveRepoRootFromState uses sourcePath and sourceRelativePath', () => {+ const state = {+ operations: [+ {+ sourcePath: path.join('/tmp', 'ecc', 'scripts', 'setup-package-manager.js'),+ sourceRelativePath: path.join('scripts', 'setup-package-manager.js'),+ },+ ],+ };++ assert.strictEqual(deriveRepoRootFromState(state), path.join('/tmp', 'ecc'));+ })) passed += 1; else failed += 1;++ if (test('deriveRepoRootFromState fails when source metadata is unavailable', () => {+ assert.throws(+ () => deriveRepoRootFromState({ operations: [{ destinationPath: '/tmp/file' }] }),+ /Unable to infer ECC repo root/+ );+ })) passed += 1; else failed += 1;++ if (test('buildInstallApplyArgs reconstructs legacy installs', () => {+ const record = {+ adapter: { target: 'claude', kind: 'home' },+ state: {+ target: { target: 'claude' },+ request: {+ profile: null,+ modules: [],+ includeComponents: [],+ excludeComponents: [],+ legacyLanguages: ['typescript', 'python'],+ legacyMode: true,+ },+ },+ };++ assert.deepStrictEqual(buildInstallApplyArgs(record), [+ '--target', 'claude',+ 'typescript',+ 'python',+ ]);+ })) passed += 1; else failed += 1;++ if (test('buildInstallApplyArgs reconstructs manifest installs', () => {+ const record = {+ adapter: { target: 'cursor', kind: 'project' },+ state: {+ target: { target: 'cursor' },+ request: {+ profile: 'developer',+ modules: ['platform-configs'],+ includeComponents: ['component:alpha'],+ excludeComponents: ['component:beta'],+ legacyLanguages: [],+ legacyMode: false,+ },+ },+ };++ assert.deepStrictEqual(buildInstallApplyArgs(record), [+ '--target', 'cursor',+ '--profile', 'developer',+ '--modules', 'platform-configs',+ '--with', 'component:alpha',+ '--without', 'component:beta',+ ]);+ })) passed += 1; else failed += 1;++ if (test('determineInstallCwd uses the project root for project installs', () => {+ const record = {+ adapter: { kind: 'project' },+ state: {+ target: {+ root: path.join('/tmp', 'project', '.cursor'),+ },+ },+ };++ assert.strictEqual(determineInstallCwd(record, '/tmp/ecc'), path.join('/tmp', 'project'));+ })) passed += 1; else failed += 1;++ if (test('runAutoUpdate reports when no install-state files are present', () => {+ const result = runAutoUpdate(+ {+ homeDir: '/tmp/home',+ projectRoot: '/tmp/project',+ dryRun: true,+ },+ {+ discoverInstalledStates: () => [],+ }+ );++ assert.strictEqual(result.results.length, 0);+ assert.strictEqual(result.summary.checkedCount, 0);+ assert.strictEqual(result.summary.errorCount, 0);+ })) passed += 1; else failed += 1;++ if (test('runAutoUpdate rejects mixed inferred repo roots', () => {+ const homeDir = createTempDir('auto-update-home-');+ const projectRoot = createTempDir('auto-update-project-');+ const repoOne = createTempDir('auto-update-repo-');+ const repoTwo = createTempDir('auto-update-repo-');++ try {+ ensureFakeRepo(repoOne);+ ensureFakeRepo(repoTwo);++ const records = [+ makeRecord({+ repoRoot: repoOne,+ homeDir,+ projectRoot,+ adapter: { id: 'claude-home', target: 'claude', kind: 'home' },+ request: {+ profile: null,+ modules: [],+ includeComponents: [],+ excludeComponents: [],+ legacyLanguages: ['typescript'],+ legacyMode: true,+ },+ resolution: { selectedModules: ['legacy-claude-rules'], skippedModules: [] },+ operations: [+ {+ kind: 'copy-file',+ moduleId: 'legacy-claude-rules',+ sourcePath: path.join(repoOne, 'rules', 'common', 'coding-style.md'),+ sourceRelativePath: path.join('rules', 'common', 'coding-style.md'),+ destinationPath: path.join(homeDir, '.claude', 'rules', 'common', 'coding-style.md'),+ strategy: 'preserve-relative-path',+ ownership: 'managed',+ scaffoldOnly: false,+ },+ ],+ }),+ makeRecord({+ repoRoot: repoTwo,+ homeDir,+ projectRoot,+ adapter: { id: 'cursor-project', target: 'cursor', kind: 'project' },+ request: {+ profile: 'core',+ modules: [],+ includeComponents: [],+ excludeComponents: [],+ legacyLanguages: [],+ legacyMode: false,+ },+ resolution: { selectedModules: ['rules-core'], skippedModules: [] },+ operations: [+ {+ kind: 'copy-file',+ moduleId: 'rules-core',+ sourcePath: path.join(repoTwo, '.cursor', 'mcp.json'),+ sourceRelativePath: path.join('.cursor', 'mcp.json'),+ destinationPath: path.join(projectRoot, '.cursor', 'mcp.json'),+ strategy: 'sync-root-children',+ ownership: 'managed',+ scaffoldOnly: false,+ },+ ],+ }),+ ];++ assert.throws(+ () => runAutoUpdate(+ {+ homeDir,+ projectRoot,+ dryRun: true,+ },+ {+ discoverInstalledStates: () => records,+ }+ ),+ /Multiple ECC repo roots detected/+ );+ } finally {+ cleanup(homeDir);+ cleanup(projectRoot);+ cleanup(repoOne);+ cleanup(repoTwo);+ }+ })) passed += 1; else failed += 1;++ if (test('runAutoUpdate fetches, pulls, and reinstalls using reconstructed args', () => {+ const homeDir = createTempDir('auto-update-home-');+ const projectRoot = createTempDir('auto-update-project-');+ const repoRoot = createTempDir('auto-update-repo-');++ try {+ ensureFakeRepo(repoRoot);++ const records = [+ makeRecord({+ repoRoot,+ homeDir,+ projectRoot,+ adapter: { id: 'cursor-project', target: 'cursor', kind: 'project' },+ request: {+ profile: 'developer',+ modules: [],+ includeComponents: ['component:alpha'],+ excludeComponents: ['component:beta'],+ legacyLanguages: [],+ legacyMode: false,+ },+ resolution: { selectedModules: ['rules-core'], skippedModules: [] },+ operations: [+ {+ kind: 'copy-file',+ moduleId: 'platform-configs',+ sourcePath: path.join(repoRoot, '.cursor', 'mcp.json'),+ sourceRelativePath: path.join('.cursor', 'mcp.json'),+ destinationPath: path.join(projectRoot, '.cursor', 'mcp.json'),+ strategy: 'sync-root-children',+ ownership: 'managed',+ scaffoldOnly: false,+ },+ ],+ }),+ ];++ const commands = [];+ const result = runAutoUpdate(+ {+ homeDir,+ projectRoot,+ dryRun: false,+ },+ {+ discoverInstalledStates: () => records,+ runExternalCommand: (command, args, options) => {+ commands.push({ command, args, options });+ if (command === process.execPath) {+ return {+ stdout: JSON.stringify({+ dryRun: false,+ result: {+ installStatePath: path.join(projectRoot, '.cursor', 'ecc-install-state.json'),+ },+ }),+ stderr: '',+ };+ }++ return { stdout: '', stderr: '' };+ },+ }+ );++ assert.strictEqual(result.summary.checkedCount, 1);+ assert.strictEqual(result.summary.updatedCount, 1);+ assert.deepStrictEqual(commands.map(entry => [entry.command, entry.args[0]]), [+ ['git', 'fetch'],+ ['git', 'pull'],+ [process.execPath, path.join(repoRoot, 'scripts', 'install-apply.js')],+ ]);+ assert.deepStrictEqual(commands[2].args.slice(1), [+ '--target', 'cursor',+ '--profile', 'developer',+ '--with', 'component:alpha',+ '--without', 'component:beta',+ '--json',+ ]);+ assert.strictEqual(commands[2].options.cwd, projectRoot);+ } finally {+ cleanup(homeDir);+ cleanup(projectRoot);+ cleanup(repoRoot);+ }+ })) passed += 1; else failed += 1;++ console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);+ process.exit(failed > 0 ? 1 : 0);+}++runTests();diff --git a/tests/scripts/ecc.test.js b/tests/scripts/ecc.test.jsindex 33817d1cb..27bd987cd 100644--- a/tests/scripts/ecc.test.js+++ b/tests/scripts/ecc.test.js@@ -68,6 +68,7 @@ function main() {assert.match(result.stdout, /catalog/);assert.match(result.stdout, /list-installed/);assert.match(result.stdout, /doctor/);+ assert.match(result.stdout, /auto-update/);}],['delegates explicit install command', () => {const result = runCli(['install', '--dry-run', '--json', 'typescript']);@@ -112,6 +113,17 @@ function main() {const payload = parseJson(result.stdout);assert.deepStrictEqual(payload.records, []);}],+ ['delegates auto-update command', () => {+ const homeDir = createTempDir('ecc-cli-home-');+ const projectRoot = createTempDir('ecc-cli-project-');+ const result = runCli(['auto-update', '--dry-run', '--json'], {+ cwd: projectRoot,+ env: { HOME: homeDir },+ });+ assert.strictEqual(result.status, 0, result.stderr);+ const payload = parseJson(result.stdout);+ assert.deepStrictEqual(payload.results, []);+ }],['delegates session-inspect command', () => {const homeDir = createTempDir('ecc-cli-home-');const sessionsDir = path.join(homeDir, '.claude', 'sessions');@@ -135,6 +147,11 @@ function main() {assert.strictEqual(result.status, 0, result.stderr);assert.match(result.stdout, /Usage: node scripts\/repair\.js/);}],+ ['supports help for the auto-update subcommand', () => {+ const result = runCli(['help', 'auto-update']);+ assert.strictEqual(result.status, 0, result.stderr);+ assert.match(result.stdout, /Usage: node scripts\/auto-update\.js/);+ }],['supports help for the catalog subcommand', () => {const result = runCli(['help', 'catalog']);assert.strictEqual(result.status, 0, result.stderr);