The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat: add JoyCode install target
Affaan Mustafac7c1e366256e
diff --git a/README.md b/README.mdindex 9bff6c07f..3d96f2bbe 100644--- a/README.md+++ b/README.md@@ -1083,6 +1083,7 @@ Yes. ECC is cross-platform:- **OpenCode**: Full plugin support in `.opencode/`. See [OpenCode Support](#opencode-support).- **Codex**: First-class support for both macOS app and CLI, with adapter drift guards and SessionStart fallback. See PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257).- **Antigravity**: Tightly integrated setup for workflows, skills, and flattened rules in `.agent/`. See [Antigravity Guide](docs/ANTIGRAVITY-GUIDE.md).+- **JoyCode / CodeBuddy**: Project-local selective install adapters for commands, agents, skills, and flattened rules. See [JoyCode Adapter Guide](docs/JOYCODE-GUIDE.md).- **Non-native harnesses**: Manual fallback path for Grok and similar interfaces. See [Manual Adaptation Guide](docs/MANUAL-ADAPTATION-GUIDE.md).- **Claude Code**: Native — this is the primary target.</details>diff --git a/docs/JOYCODE-GUIDE.md b/docs/JOYCODE-GUIDE.mdnew file mode 100644index 000000000..596816fd7--- /dev/null+++ b/docs/JOYCODE-GUIDE.md@@ -0,0 +1,55 @@+# JoyCode Adapter Guide++JoyCode can consume ECC through the selective installer. The adapter installs shared ECC commands, agents, skills, and flattened rules into a project-local `.joycode/` directory.++## Install++Preview the install plan:++```bash+node scripts/install-plan.js --target joycode --profile full+```++Apply it to the current project:++```bash+node scripts/install-apply.js --target joycode --profile full+```++For a smaller install, select modules explicitly:++```bash+node scripts/install-apply.js --target joycode --modules rules-core,commands-core,workflow-quality+```++## Layout++The project adapter writes managed files under:++```text+.joycode/+ agents/+ commands/+ rules/+ skills/+ mcp-configs/+ scripts/+ ecc-install-state.json+```++Rules are flattened into namespaced filenames so a JoyCode project does not receive nested rule directories such as `rules/common/coding-style.md`. Commands, agents, and skills keep the same structure they use elsewhere in ECC.+The full profile also includes shared MCP and setup helper files that other ECC project-local adapters use.++## Uninstall++Use ECC's managed uninstall path instead of deleting files by hand:++```bash+node scripts/uninstall.js --target joycode+```++The uninstall command reads `.joycode/ecc-install-state.json` and removes only files that ECC installed. User-created JoyCode files are preserved.++## Source PR++This adapter salvages the useful project-local JoyCode intent from stale PR #1429 while replacing the standalone shell installer with ECC's current install-state and uninstall machinery.diff --git a/manifests/install-modules.json b/manifests/install-modules.jsonindex d0ae8ef39..ebeb2c22a 100644--- a/manifests/install-modules.json+++ b/manifests/install-modules.json@@ -12,7 +12,8 @@"claude","cursor","antigravity",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": [],"defaultInstall": true,@@ -33,7 +34,8 @@"cursor","antigravity","codex",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": [],"defaultInstall": true,@@ -52,7 +54,8 @@"cursor","antigravity","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": [],"defaultInstall": true,@@ -100,7 +103,8 @@"codex","gemini","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": [],"defaultInstall": true,@@ -159,7 +163,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["rules-core",@@ -188,7 +193,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -227,7 +233,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -262,7 +269,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["workflow-quality"@@ -289,7 +297,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -320,7 +329,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -358,7 +368,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -381,7 +392,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["business-content"@@ -407,7 +419,8 @@"cursor","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -461,7 +474,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -500,7 +514,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -529,7 +544,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -558,7 +574,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"@@ -581,7 +598,8 @@"antigravity","codex","opencode",- "codebuddy"+ "codebuddy",+ "joycode"],"dependencies": ["platform-configs"diff --git a/schemas/ecc-install-config.schema.json b/schemas/ecc-install-config.schema.jsonindex cb866aa3b..04bda09bf 100644--- a/schemas/ecc-install-config.schema.json+++ b/schemas/ecc-install-config.schema.json@@ -24,7 +24,8 @@"codex","gemini","opencode",- "codebuddy"+ "codebuddy",+ "joycode"]},"profile": {diff --git a/schemas/install-modules.schema.json b/schemas/install-modules.schema.jsonindex fbaa7fafc..f2e5da65a 100644--- a/schemas/install-modules.schema.json+++ b/schemas/install-modules.schema.json@@ -53,7 +53,8 @@"codex","gemini","opencode",- "codebuddy"+ "codebuddy",+ "joycode"]}},diff --git a/scripts/install-apply.js b/scripts/install-apply.jsindex 3acfe2282..e1f482369 100755--- a/scripts/install-apply.js+++ b/scripts/install-apply.js@@ -31,6 +31,11 @@ Targets:claude (default) - Install ECC into ~/.claude/ with managed rules/skills under rules/ecc and skills/ecccursor - Install rules, hooks, and bundled Cursor configs to ./.cursor/antigravity - Install rules, workflows, skills, and agents to ./.agent/+ codex - Install shared agents/config into ~/.codex/+ gemini - Install project-local Gemini config into ./.gemini/+ opencode - Install shared commands/hooks/config into ~/.opencode/+ codebuddy - Install commands, agents, skills, and flattened rules into ./.codebuddy/+ joycode - Install commands, agents, skills, and flattened rules into ./.joycode/Options:--profile <name> Resolve and install a manifest profilediff --git a/scripts/lib/install-manifests.js b/scripts/lib/install-manifests.jsindex 631eb1114..0f179f252 100644--- a/scripts/lib/install-manifests.js+++ b/scripts/lib/install-manifests.js@@ -4,7 +4,7 @@ const path = require('path');const { getInstallTargetAdapter, planInstallTargetScaffold } = require('./install-targets/registry');const DEFAULT_REPO_ROOT = path.join(__dirname, '../..');-const SUPPORTED_INSTALL_TARGETS = ['claude', 'cursor', 'antigravity', 'codex', 'gemini', 'opencode', 'codebuddy'];+const SUPPORTED_INSTALL_TARGETS = ['claude', 'cursor', 'antigravity', 'codex', 'gemini', 'opencode', 'codebuddy', 'joycode'];const COMPONENT_FAMILY_PREFIXES = {baseline: 'baseline:',language: 'lang:',diff --git a/scripts/lib/install-targets/helpers.js b/scripts/lib/install-targets/helpers.jsindex bb9a0648d..5b033fe1d 100644--- a/scripts/lib/install-targets/helpers.js+++ b/scripts/lib/install-targets/helpers.js@@ -7,6 +7,7 @@ const PLATFORM_SOURCE_PATH_OWNERS = Object.freeze({'.codex': 'codex','.cursor': 'cursor','.gemini': 'gemini',+ '.joycode': 'joycode','.opencode': 'opencode','.codebuddy': 'codebuddy',});diff --git a/scripts/lib/install-targets/joycode-project.js b/scripts/lib/install-targets/joycode-project.jsnew file mode 100644index 000000000..8faf3515b--- /dev/null+++ b/scripts/lib/install-targets/joycode-project.js@@ -0,0 +1,50 @@+const path = require('path');++const {+ createFlatRuleOperations,+ createInstallTargetAdapter,+ isForeignPlatformPath,+} = require('./helpers');++module.exports = createInstallTargetAdapter({+ id: 'joycode-project',+ target: 'joycode',+ kind: 'project',+ rootSegments: ['.joycode'],+ installStatePathSegments: ['ecc-install-state.json'],+ nativeRootRelativePath: '.joycode',+ planOperations(input, adapter) {+ const modules = Array.isArray(input.modules)+ ? input.modules+ : (input.module ? [input.module] : []);+ const {+ repoRoot,+ projectRoot,+ homeDir,+ } = input;+ const planningInput = {+ repoRoot,+ projectRoot,+ homeDir,+ };+ const targetRoot = adapter.resolveRoot(planningInput);++ return modules.flatMap(module => {+ const paths = Array.isArray(module.paths) ? module.paths : [];+ return paths+ .filter(p => !isForeignPlatformPath(p, adapter.target))+ .flatMap(sourceRelativePath => {+ if (sourceRelativePath === 'rules') {+ return createFlatRuleOperations({+ moduleId: module.id,+ repoRoot,+ sourceRelativePath,+ destinationDir: path.join(targetRoot, 'rules'),+ });+ }++ return [adapter.createScaffoldOperation(module.id, sourceRelativePath, planningInput)];+ });+ });+ },+});diff --git a/scripts/lib/install-targets/registry.js b/scripts/lib/install-targets/registry.jsindex 648386082..87db5f65c 100644--- a/scripts/lib/install-targets/registry.js+++ b/scripts/lib/install-targets/registry.js@@ -4,6 +4,7 @@ const codebuddyProject = require('./codebuddy-project');const codexHome = require('./codex-home');const cursorProject = require('./cursor-project');const geminiProject = require('./gemini-project');+const joycodeProject = require('./joycode-project');const opencodeHome = require('./opencode-home');const ADAPTERS = Object.freeze([@@ -14,6 +15,7 @@ const ADAPTERS = Object.freeze([geminiProject,opencodeHome,codebuddyProject,+ joycodeProject,]);function listInstallTargetAdapters() {diff --git a/tests/lib/install-targets.test.js b/tests/lib/install-targets.test.jsindex fe9bc9b2a..eac286d9b 100644--- a/tests/lib/install-targets.test.js+++ b/tests/lib/install-targets.test.js@@ -43,6 +43,7 @@ function runTests() {assert.ok(targets.includes('gemini'), 'Should include gemini target');assert.ok(targets.includes('opencode'), 'Should include opencode target');assert.ok(targets.includes('codebuddy'), 'Should include codebuddy target');+ assert.ok(targets.includes('joycode'), 'Should include joycode target');})) passed++; else failed++;if (test('resolves cursor adapter root and install-state path from project root', () => {@@ -501,6 +502,29 @@ function runTests() {assert.ok(byTarget.supports('codebuddy-project'));})) passed++; else failed++;+ if (test('resolves joycode adapter root and install-state path from project root', () => {+ const adapter = getInstallTargetAdapter('joycode');+ const projectRoot = '/workspace/app';+ const root = adapter.resolveRoot({ projectRoot });+ const statePath = adapter.getInstallStatePath({ projectRoot });++ assert.strictEqual(adapter.id, 'joycode-project');+ assert.strictEqual(adapter.target, 'joycode');+ assert.strictEqual(adapter.kind, 'project');+ assert.strictEqual(root, path.join(projectRoot, '.joycode'));+ assert.strictEqual(statePath, path.join(projectRoot, '.joycode', 'ecc-install-state.json'));+ })) passed++; else failed++;++ if (test('joycode adapter supports lookup by target and adapter id', () => {+ const byTarget = getInstallTargetAdapter('joycode');+ const byId = getInstallTargetAdapter('joycode-project');++ assert.strictEqual(byTarget.id, 'joycode-project');+ assert.strictEqual(byId.id, 'joycode-project');+ assert.ok(byTarget.supports('joycode'));+ assert.ok(byTarget.supports('joycode-project'));+ })) passed++; else failed++;+if (test('plans codebuddy rules with flat namespaced filenames', () => {const repoRoot = path.join(__dirname, '..', '..');const projectRoot = '/workspace/app';@@ -536,6 +560,68 @@ function runTests() {);})) passed++; else failed++;+ if (test('plans joycode commands, agents, skills, and flattened rules', () => {+ const repoRoot = path.join(__dirname, '..', '..');+ const projectRoot = '/workspace/app';++ const plan = planInstallTargetScaffold({+ target: 'joycode',+ repoRoot,+ projectRoot,+ modules: [+ {+ id: 'rules-core',+ paths: ['rules'],+ },+ {+ id: 'agents-core',+ paths: ['agents'],+ },+ {+ id: 'commands-core',+ paths: ['commands'],+ },+ {+ id: 'workflow-quality',+ paths: ['skills/tdd-workflow'],+ },+ ],+ });++ assert.strictEqual(plan.adapter.id, 'joycode-project');+ assert.strictEqual(plan.targetRoot, path.join(projectRoot, '.joycode'));+ assert.strictEqual(plan.installStatePath, path.join(projectRoot, '.joycode', 'ecc-install-state.json'));++ assert.ok(+ plan.operations.some(operation => (+ normalizedRelativePath(operation.sourceRelativePath) === 'rules/common/coding-style.md'+ && operation.destinationPath === path.join(projectRoot, '.joycode', 'rules', 'common-coding-style.md')+ )),+ 'Should flatten common rules into namespaced files for joycode'+ );+ assert.ok(+ plan.operations.some(operation => (+ normalizedRelativePath(operation.sourceRelativePath) === 'agents'+ && operation.destinationPath === path.join(projectRoot, '.joycode', 'agents')+ )),+ 'Should install agents under .joycode/agents'+ );+ assert.ok(+ plan.operations.some(operation => (+ normalizedRelativePath(operation.sourceRelativePath) === 'commands'+ && operation.destinationPath === path.join(projectRoot, '.joycode', 'commands')+ )),+ 'Should install commands under .joycode/commands'+ );+ assert.ok(+ plan.operations.some(operation => (+ normalizedRelativePath(operation.sourceRelativePath) === 'skills/tdd-workflow'+ && operation.destinationPath === path.join(projectRoot, '.joycode', 'skills', 'tdd-workflow')+ )),+ 'Should install skills under .joycode/skills'+ );+ })) passed++; else failed++;+if (test('exposes validate and planOperations on codebuddy adapter', () => {const codebuddyAdapter = getInstallTargetAdapter('codebuddy');diff --git a/tests/scripts/install-apply.test.js b/tests/scripts/install-apply.test.jsindex fcedff0b9..5a941cf76 100644--- a/tests/scripts/install-apply.test.js+++ b/tests/scripts/install-apply.test.js@@ -233,6 +233,40 @@ function runTests() {}})) passed++; else failed++;+ if (test('installs JoyCode profile through managed install-state', () => {+ const homeDir = createTempDir('install-apply-home-');+ const projectDir = createTempDir('install-apply-project-');++ try {+ const result = run(['--target', 'joycode', '--profile', 'minimal'], { cwd: projectDir, homeDir });+ assert.strictEqual(result.code, 0, result.stderr);++ assert.ok(fs.existsSync(path.join(projectDir, '.joycode', 'rules', 'common-coding-style.md')));+ assert.ok(!fs.existsSync(path.join(projectDir, '.joycode', 'rules', 'common', 'coding-style.md')));+ assert.ok(fs.existsSync(path.join(projectDir, '.joycode', 'agents', 'architect.md')));+ assert.ok(fs.existsSync(path.join(projectDir, '.joycode', 'commands', 'plan.md')));+ assert.ok(fs.existsSync(path.join(projectDir, '.joycode', 'skills', 'tdd-workflow', 'SKILL.md')));+ assert.ok(fs.existsSync(path.join(projectDir, '.joycode', 'mcp-configs', 'mcp-servers.json')));+ assert.ok(!fs.existsSync(path.join(projectDir, '.joycode', 'hooks')));++ const statePath = path.join(projectDir, '.joycode', 'ecc-install-state.json');+ const state = readJson(statePath);+ assert.strictEqual(state.target.id, 'joycode-project');+ assert.deepStrictEqual(state.request.modules, []);+ assert.strictEqual(state.request.profile, 'minimal');+ assert.ok(state.resolution.selectedModules.includes('workflow-quality'));+ assert.ok(+ state.operations.some(operation => (+ operation.destinationPath.endsWith(path.join('.joycode', 'skills', 'tdd-workflow', 'SKILL.md'))+ )),+ 'Should record JoyCode skill file operation'+ );+ } finally {+ cleanup(homeDir);+ cleanup(projectDir);+ }+ })) passed++; else failed++;+if (test('supports dry-run without mutating the target project', () => {const homeDir = createTempDir('install-apply-home-');const projectDir = createTempDir('install-apply-project-');