hai/everything-claude-code
1
0
Fork 0
mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-05-20 11:19:58 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(install-targets): add claude-project (per-project Claude Code) adapter

Browse Source 
Completes the install-target matrix for Claude Code. Until now, ECC's
Claude support was home-scope only (~/.claude/) via the `claude` target.
This adds a project-scope counterpart (./.claude/) via a new
`claude-project` target so teams can install ECC per-repo without
contaminating ~/.claude/ — matching the existing project-scope adapters
for Cursor, Antigravity, Gemini, CodeBuddy, Joycode, and Zed.

Symmetric with `claude`:
- Same namespace under rules/ecc and skills/ecc
- Same docs/<locale> handling for --locale
- Same hooks placeholder substitution for hooks.json
- Reuses claude-home's destination-mapping logic 1:1

Use cases:
- Monorepos with multiple Flow-managed projects
- Teams that want ECC scoped per-project without touching ~/.claude/
- Per-project skill/rule isolation when global install isn't desirable

No breaking change: existing --target claude continues to route to
claude-home (user-scope) unchanged. New target is opt-in.

Tests
-----
- 4 new tests in tests/lib/install-targets.test.js
  (root resolution, lookup-by-id, plan parity with claude, foreign-path filtering)
- All install-target regression guards (schema enum / SUPPORTED_INSTALL_TARGETS)
  still pass
- End-to-end smoke: `--target claude-project --profile minimal --dry-run`
  emits 359 ops with destinations rooted at <projectRoot>/.claude/ (parity
  with --target claude which emits 359 ops rooted at ~/.claude/)
This commit is contained in:
Mhd Ghaith Al Abtah
2026-05-19 19:39:18 +04:00
committed by Affaan Mustafa
parent 27e4036075
commit 7004a66243
9 changed files with 241 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
manifests/install-modules.json
View File

@@ -10,6 +10,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codebuddy",
@@ -33,6 +34,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -55,6 +57,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"opencode",
@@ -79,6 +82,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"opencode",
"codebuddy"
@@ -106,6 +110,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -177,6 +182,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -210,6 +216,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -255,6 +262,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -294,6 +302,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -326,6 +335,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -360,6 +370,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -402,6 +413,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -428,6 +440,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -459,6 +472,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"codex",
"opencode",
@@ -490,6 +504,7 @@
],
"targets": [
"claude",
"claude-project",
"codex",
"opencode"
],
@@ -515,6 +530,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -559,6 +575,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -592,6 +609,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -617,6 +635,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -653,6 +672,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -679,6 +699,7 @@
],
"targets": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",
@@ -703,7 +724,8 @@
"docs/ja-JP"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -718,7 +740,8 @@
"docs/zh-CN"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -733,7 +756,8 @@
"docs/ko-KR"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -748,7 +772,8 @@
"docs/pt-BR"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -763,7 +788,8 @@
"docs/ru"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -778,7 +804,8 @@
"docs/tr"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -793,7 +820,8 @@
"docs/vi-VN"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,
@@ -808,7 +836,8 @@
"docs/zh-TW"
],
"targets": [
"claude"
"claude",
"claude-project"
],
"dependencies": [],
"defaultInstall": false,

1
schemas/ecc-install-config.schema.json
View File

@@ -19,6 +19,7 @@
"type": "string",
"enum": [
"claude",
"claude-project",
"cursor",
"antigravity",
"codex",

7
scripts/install-apply.js
View File

@@ -27,11 +27,12 @@ Usage: install.sh [--target <${LEGACY_INSTALL_TARGETS.join('|')}>] [--dry-run] [
install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --profile <name> [--with <component>]... [--without <component>]...
install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --modules <id,id,...> [--with <component>]... [--without <component>]...
install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --skills <skill-id[,skill-id...]>
install.sh [--target claude] [--dry-run] [--json] --locale <locale-code>
install.sh [--target claude|claude-project] [--dry-run] [--json] --locale <locale-code>
install.sh [--dry-run] [--json] --config <path>
Targets:
claude (default) - Install ECC into ~/.claude/ with managed rules/skills under rules/ecc and skills/ecc
claude-project - Install ECC into ./.claude/ (per-project) with managed rules/skills under rules/ecc and skills/ecc
cursor - 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/
@@ -49,8 +50,8 @@ Options:
--skills <ids> Install one or more skill directories by ID, e.g. continuous-learning-v2
--without <component>
Exclude a user-facing install component
--locale <code> Install translated docs to ~/.claude/docs/<locale>/
(claude target only; can be combined with --profile or --with)
--locale <code> Install translated docs to ~/.claude/docs/<locale>/ (or ./.claude/docs/<locale>/ for claude-project)
(claude or claude-project target only; can be combined with --profile or --with)
--config <path> Load install intent from ecc-install.json
--dry-run Show the install plan without copying files
--json Emit machine-readable plan/result JSON

10
scripts/lib/install-manifests.js
View File

@@ -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', 'joycode', 'qwen', 'zed'];
const SUPPORTED_INSTALL_TARGETS = ['claude', 'claude-project', 'cursor', 'antigravity', 'codex', 'gemini', 'opencode', 'codebuddy', 'joycode', 'qwen', 'zed'];
const COMPONENT_FAMILY_PREFIXES = {
baseline: 'baseline:',
language: 'lang:',
@@ -43,6 +43,14 @@ const LEGACY_COMPAT_BASE_MODULE_IDS_BY_TARGET = Object.freeze({
'platform-configs',
'workflow-quality',
],
'claude-project': [
'rules-core',
'agents-core',
'commands-core',
'hooks-runtime',
'platform-configs',
'workflow-quality',
],
cursor: [
'rules-core',
'agents-core',

91
scripts/lib/install-targets/claude-project.js Normal file
View File

@@ -0,0 +1,91 @@
const path = require('path');
const {
createInstallTargetAdapter,
createRemappedOperation,
isForeignPlatformPath,
normalizeRelativePath,
} = require('./helpers');
const CLAUDE_ECC_NAMESPACE = 'ecc';
function getClaudeManagedDestinationPath(adapter, sourceRelativePath, input) {
const normalizedSourcePath = normalizeRelativePath(sourceRelativePath);
const targetRoot = adapter.resolveRoot(input);
if (normalizedSourcePath === 'rules') {
return path.join(targetRoot, 'rules', CLAUDE_ECC_NAMESPACE);
}
if (normalizedSourcePath.startsWith('rules/')) {
return path.join(
targetRoot,
'rules',
CLAUDE_ECC_NAMESPACE,
normalizedSourcePath.slice('rules/'.length)
);
}
if (normalizedSourcePath === 'skills') {
return path.join(targetRoot, 'skills', CLAUDE_ECC_NAMESPACE);
}
if (normalizedSourcePath.startsWith('skills/')) {
return path.join(
targetRoot,
'skills',
CLAUDE_ECC_NAMESPACE,
normalizedSourcePath.slice('skills/'.length)
);
}
if (normalizedSourcePath === 'docs' || normalizedSourcePath.startsWith('docs/')) {
return path.join(targetRoot, normalizedSourcePath);
}
return null;
}
module.exports = createInstallTargetAdapter({
id: 'claude-project',
target: 'claude-project',
kind: 'project',
rootSegments: ['.claude'],
installStatePathSegments: ['ecc', 'install-state.json'],
nativeRootRelativePath: '.claude-plugin',
planOperations(input, adapter) {
const modules = Array.isArray(input.modules)
? input.modules
: (input.module ? [input.module] : []);
const planningInput = {
repoRoot: input.repoRoot,
projectRoot: input.projectRoot,
homeDir: input.homeDir,
};
return modules.flatMap(module => {
const paths = Array.isArray(module.paths) ? module.paths : [];
return paths
.filter(p => !isForeignPlatformPath(p, 'claude'))
.map(sourceRelativePath => {
const managedDestinationPath = getClaudeManagedDestinationPath(
adapter,
sourceRelativePath,
planningInput
);
if (managedDestinationPath) {
return createRemappedOperation(
adapter,
module.id,
sourceRelativePath,
managedDestinationPath,
{ strategy: 'preserve-relative-path' }
);
}
return adapter.createScaffoldOperation(module.id, sourceRelativePath, planningInput);
});
});
},
});

2
scripts/lib/install-targets/registry.js
View File

@@ -1,5 +1,6 @@
const antigravityProject = require('./antigravity-project');
const claudeHome = require('./claude-home');
const claudeProject = require('./claude-project');
const codebuddyProject = require('./codebuddy-project');
const codexHome = require('./codex-home');
const cursorProject = require('./cursor-project');
@@ -11,6 +12,7 @@ const zedProject = require('./zed-project');
const ADAPTERS = Object.freeze([
claudeHome,
claudeProject,
cursorProject,
antigravityProject,
codexHome,

2
scripts/lib/install/apply.js
View File

@@ -89,7 +89,7 @@ function isMcpConfigPath(filePath) {
}
function buildResolvedClaudeHooks(plan) {
if (!plan.adapter || plan.adapter.target !== 'claude') {
if (!plan.adapter || (plan.adapter.target !== 'claude' && plan.adapter.target !== 'claude-project')) {
return null;
}

4
scripts/lib/install/request.js
View File

@@ -100,8 +100,8 @@ function normalizeInstallRequest(options = {}) {
`Unsupported locale: "${locale}". Supported locales: ${listSupportedLocales().join(', ')}`
);
}
if (locale && target !== 'claude') {
throw new Error('--locale can only be used with --target claude');
if (locale && target !== 'claude' && target !== 'claude-project') {
throw new Error('--locale can only be used with --target claude or --target claude-project');
}
const requestedIncludeComponentIds = dedupeStrings([
...(config?.includeComponentIds || []),

94
tests/lib/install-targets.test.js
View File

@@ -37,6 +37,7 @@ function runTests() {
const adapters = listInstallTargetAdapters();
const targets = adapters.map(adapter => adapter.target);
assert.ok(targets.includes('claude'), 'Should include claude target');
assert.ok(targets.includes('claude-project'), 'Should include claude-project target');
assert.ok(targets.includes('cursor'), 'Should include cursor target');
assert.ok(targets.includes('antigravity'), 'Should include antigravity target');
assert.ok(targets.includes('codex'), 'Should include codex target');
@@ -865,6 +866,99 @@ function runTests() {
}
})) passed++; else failed++;
if (test('resolves claude-project adapter root and install-state path from project root', () => {
const adapter = getInstallTargetAdapter('claude-project');
const projectRoot = '/workspace/app';
const root = adapter.resolveRoot({ projectRoot });
const statePath = adapter.getInstallStatePath({ projectRoot });
assert.strictEqual(adapter.id, 'claude-project');
assert.strictEqual(adapter.target, 'claude-project');
assert.strictEqual(adapter.kind, 'project');
assert.strictEqual(root, path.join(projectRoot, '.claude'));
assert.strictEqual(statePath, path.join(projectRoot, '.claude', 'ecc', 'install-state.json'));
})) passed++; else failed++;
if (test('claude-project adapter supports lookup by target and adapter id', () => {
const byTarget = getInstallTargetAdapter('claude-project');
const byId = getInstallTargetAdapter('claude-project');
assert.strictEqual(byTarget.id, 'claude-project');
assert.strictEqual(byId.id, 'claude-project');
assert.ok(byTarget.supports('claude-project'));
})) passed++; else failed++;
if (test('plans claude-project rules and skills under project-scope ECC-managed subdirectories', () => {
const repoRoot = path.join(__dirname, '..', '..');
const projectRoot = '/workspace/app';
const plan = planInstallTargetScaffold({
target: 'claude-project',
repoRoot,
projectRoot,
modules: [
{
id: 'rules-core',
paths: ['rules'],
},
{
id: 'workflow-quality',
paths: ['skills/tdd-workflow'],
},
],
});
assert.strictEqual(plan.adapter.id, 'claude-project');
assert.strictEqual(plan.targetRoot, path.join(projectRoot, '.claude'));
assert.strictEqual(plan.installStatePath, path.join(projectRoot, '.claude', 'ecc', 'install-state.json'));
assert.ok(
plan.operations.some(operation => (
normalizedRelativePath(operation.sourceRelativePath) === 'rules'
&& operation.destinationPath === path.join(projectRoot, '.claude', 'rules', 'ecc')
)),
'Should install bundled rules under project-scope rules/ecc'
);
assert.ok(
plan.operations.some(operation => (
normalizedRelativePath(operation.sourceRelativePath) === 'skills/tdd-workflow'
&& operation.destinationPath === path.join(projectRoot, '.claude', 'skills', 'ecc', 'tdd-workflow')
)),
'Should install bundled skills under project-scope skills/ecc'
);
})) passed++; else failed++;
if (test('claude-project skips foreign platform source paths', () => {
const repoRoot = path.join(__dirname, '..', '..');
const projectRoot = '/workspace/app';
const plan = planInstallTargetScaffold({
target: 'claude-project',
repoRoot,
projectRoot,
modules: [
{
id: 'platform-configs',
paths: ['.cursor', '.zed', 'rules'],
},
],
});
assert.ok(
!plan.operations.some(operation => (
normalizedRelativePath(operation.sourceRelativePath) === '.cursor'
|| normalizedRelativePath(operation.sourceRelativePath).startsWith('.cursor/')
)),
'Should skip foreign Cursor platform paths'
);
assert.ok(
!plan.operations.some(operation => (
normalizedRelativePath(operation.sourceRelativePath) === '.zed'
|| normalizedRelativePath(operation.sourceRelativePath).startsWith('.zed/')
)),
'Should skip foreign Zed platform paths'
);
})) passed++; else failed++;
console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);
process.exit(failed > 0 ? 1 : 0);
}