azclaude-copilot 0.3.5 → 0.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +34 -14
- package/bin/cli.js +25 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -29,39 +29,58 @@ Zero dependencies. One install. Works on any stack.
|
|
|
29
29
|
|
|
30
30
|
## Install
|
|
31
31
|
|
|
32
|
+
**Step 1 — core install** (26 commands, memory, reflexes, evolution):
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npx azclaude-copilot
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
**Step 2 — full install** (adds Level 5+: debate, pipeline, ELO — optional):
|
|
39
|
+
|
|
32
40
|
```bash
|
|
33
|
-
npx azclaude-copilot
|
|
41
|
+
npx azclaude-copilot --full
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**Step 3 — configure your project** (open Claude Code, then run):
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
/setup
|
|
34
48
|
```
|
|
35
49
|
|
|
36
|
-
That's it. Your project now has
|
|
50
|
+
That's it. Your project now has AZCLAUDE in `.claude/`.
|
|
37
51
|
|
|
38
52
|
---
|
|
39
53
|
|
|
40
54
|
## Three Ways to Use It
|
|
41
55
|
|
|
42
|
-
### `/
|
|
56
|
+
### 1. `/setup` — Configure an existing project
|
|
57
|
+
|
|
58
|
+
Open Claude Code in your project, then run:
|
|
43
59
|
|
|
44
60
|
```
|
|
45
|
-
/
|
|
46
|
-
> "Build a compliance SaaS with trilingual support"
|
|
61
|
+
/setup
|
|
47
62
|
```
|
|
48
|
-
Scaffolds the full project: CLAUDE.md, skills, agents, memory, milestones. You build from there.
|
|
49
63
|
|
|
50
|
-
|
|
64
|
+
Analyzes your project's stack, domain, and scale. Fills CLAUDE.md. Generates project-specific skills and agents. Creates memory structure.
|
|
65
|
+
|
|
66
|
+
### 2. `/dream` — Start from an idea
|
|
51
67
|
|
|
52
68
|
```
|
|
53
|
-
/
|
|
69
|
+
/dream
|
|
70
|
+
> "Build a compliance SaaS with trilingual support"
|
|
54
71
|
```
|
|
55
|
-
Analyzes your project's stack, domain, and scale. Fills CLAUDE.md. Generates project-specific skills and agents. Creates memory structure.
|
|
56
72
|
|
|
57
|
-
|
|
73
|
+
Scaffolds the full project: CLAUDE.md, skills, agents, memory, milestones. You build from there.
|
|
74
|
+
|
|
75
|
+
### 3. `/copilot` — Full autonomous mode
|
|
58
76
|
|
|
59
77
|
```bash
|
|
60
78
|
npx azclaude-copilot . "Build a compliance SaaS with trilingual support"
|
|
61
79
|
```
|
|
80
|
+
|
|
62
81
|
Walk away. AZCLAUDE plans, builds, tests, commits, evolves, and deploys. Come back to a working product with full git history.
|
|
63
82
|
|
|
64
|
-
### Day-to-day commands
|
|
83
|
+
### Day-to-day commands (in Claude Code terminal)
|
|
65
84
|
|
|
66
85
|
```bash
|
|
67
86
|
/add [feature] # add a feature with TDD
|
|
@@ -76,7 +95,8 @@ Walk away. AZCLAUDE plans, builds, tests, commits, evolves, and deploys. Come ba
|
|
|
76
95
|
### CLI commands
|
|
77
96
|
|
|
78
97
|
```bash
|
|
79
|
-
npx azclaude-copilot
|
|
98
|
+
npx azclaude-copilot # core install (26 commands, memory, reflexes)
|
|
99
|
+
npx azclaude-copilot --full # full install (adds debate, pipeline, ELO)
|
|
80
100
|
npx azclaude-copilot doctor # 32-check health audit
|
|
81
101
|
npx azclaude-copilot . "intent" 30 # copilot with 30 session limit
|
|
82
102
|
npx azclaude-copilot . # resume existing copilot run
|
|
@@ -390,8 +410,8 @@ AZCLAUDE_HOOK_PROFILE=strict claude # all features + extra validation
|
|
|
390
410
|
### Doctor Audit
|
|
391
411
|
|
|
392
412
|
```bash
|
|
393
|
-
npx azclaude doctor # 32 checks: hooks, settings, commands, memory
|
|
394
|
-
npx azclaude doctor --audit # efficiency + security score
|
|
413
|
+
npx azclaude-copilot doctor # 32 checks: hooks, settings, commands, memory
|
|
414
|
+
npx azclaude-copilot doctor --audit # efficiency + security score
|
|
395
415
|
```
|
|
396
416
|
|
|
397
417
|
See [SECURITY.md](SECURITY.md) for full details including known limitations and copilot-mode mitigations.
|
package/bin/cli.js
CHANGED
|
@@ -310,10 +310,20 @@ function installCapabilities(projectDir, cfg, full) {
|
|
|
310
310
|
// Always install missing core dirs (e.g. evolution/ added in v0.1.6)
|
|
311
311
|
const dirs = full ? FULL_CAP_DIRS : CORE_CAP_DIRS;
|
|
312
312
|
for (const dir of dirs) {
|
|
313
|
+
const srcSub = path.join(src, dir);
|
|
313
314
|
const dstSub = path.join(dst, dir);
|
|
314
315
|
if (!fs.existsSync(dstSub)) {
|
|
315
|
-
copyDir(
|
|
316
|
+
copyDir(srcSub, dstSub);
|
|
316
317
|
ok(`${dir}/ capabilities added`);
|
|
318
|
+
} else {
|
|
319
|
+
// Copy any new files added to existing subdirs (e.g. reflexes.md)
|
|
320
|
+
for (const entry of fs.readdirSync(srcSub, { withFileTypes: true })) {
|
|
321
|
+
if (!entry.isFile()) continue;
|
|
322
|
+
const d = path.join(dstSub, entry.name);
|
|
323
|
+
if (!fs.existsSync(d)) {
|
|
324
|
+
fs.copyFileSync(path.join(srcSub, entry.name), d);
|
|
325
|
+
}
|
|
326
|
+
}
|
|
317
327
|
}
|
|
318
328
|
}
|
|
319
329
|
ok('Capabilities verified — all dirs present');
|
|
@@ -328,7 +338,7 @@ function installCapabilities(projectDir, cfg, full) {
|
|
|
328
338
|
copyDir(path.join(src, dir), path.join(dst, dir));
|
|
329
339
|
}
|
|
330
340
|
ok(`Capabilities installed (${cfg}/capabilities/) — ${full ? 'full' : 'core'}`);
|
|
331
|
-
if (!full) info('Run npx azclaude --full to add intelligence capabilities (debate, pipeline, ELO)');
|
|
341
|
+
if (!full) info('Run npx azclaude-copilot --full to add intelligence capabilities (debate, pipeline, ELO)');
|
|
332
342
|
info('manifest.md is your capability index — read it to find what to load');
|
|
333
343
|
}
|
|
334
344
|
|
|
@@ -448,7 +458,7 @@ function verifyCapabilityReferences(projectDir, cfg) {
|
|
|
448
458
|
path.join(projectDir, cfg, 'commands'),
|
|
449
459
|
path.join(projectDir, cfg, 'agents'),
|
|
450
460
|
];
|
|
451
|
-
const capPattern = /capabilities\/[^\s)}\]"'`,]+/g;
|
|
461
|
+
const capPattern = /capabilities\/[^\s)}\]"'`,{]+/g;
|
|
452
462
|
let checked = 0, missing = 0;
|
|
453
463
|
const seen = new Set();
|
|
454
464
|
|
|
@@ -460,6 +470,7 @@ function verifyCapabilityReferences(projectDir, cfg) {
|
|
|
460
470
|
const matches = content.match(capPattern);
|
|
461
471
|
if (!matches) continue;
|
|
462
472
|
for (const ref of matches) {
|
|
473
|
+
if (!ref.endsWith('.md')) continue; // skip template placeholders like level{N}.md
|
|
463
474
|
const key = ref;
|
|
464
475
|
if (seen.has(key)) continue;
|
|
465
476
|
seen.add(key);
|
|
@@ -660,8 +671,8 @@ function runDemo() {
|
|
|
660
671
|
console.log('\n════════════════════════════════════════════════');
|
|
661
672
|
console.log(' Memory works. Context survives compaction.');
|
|
662
673
|
console.log(' The hook fires on every file edit — no user action needed.');
|
|
663
|
-
console.log('\n Install on your project: npx azclaude');
|
|
664
|
-
console.log(' Check health: npx azclaude doctor');
|
|
674
|
+
console.log('\n Install on your project: npx azclaude-copilot');
|
|
675
|
+
console.log(' Check health: npx azclaude-copilot doctor');
|
|
665
676
|
console.log('════════════════════════════════════════════════\n');
|
|
666
677
|
}
|
|
667
678
|
|
|
@@ -861,7 +872,7 @@ function runDoctor() {
|
|
|
861
872
|
try {
|
|
862
873
|
const gs = JSON.parse(fs.readFileSync(globalSettings, 'utf8'));
|
|
863
874
|
if (gs._azclaude) {
|
|
864
|
-
console.log(' ⚠ Global hooks still present — re-run npx azclaude to migrate');
|
|
875
|
+
console.log(' ⚠ Global hooks still present — re-run npx azclaude-copilot to migrate');
|
|
865
876
|
}
|
|
866
877
|
} catch {}
|
|
867
878
|
}
|
|
@@ -897,7 +908,7 @@ function runDoctor() {
|
|
|
897
908
|
chk('hook integrity hash matches', saved === current);
|
|
898
909
|
}
|
|
899
910
|
|
|
900
|
-
info('Tip: re-run npx azclaude to upgrade to project-scoped hooks');
|
|
911
|
+
info('Tip: re-run npx azclaude-copilot to upgrade to project-scoped hooks');
|
|
901
912
|
} else {
|
|
902
913
|
console.log(`\n[ Hooks ]`);
|
|
903
914
|
console.log(` · hooks not supported for ${cli.name} — skipping`);
|
|
@@ -1003,7 +1014,7 @@ function runDoctor() {
|
|
|
1003
1014
|
const hasGitFail = failures.some(f => /uncommitted/.test(f));
|
|
1004
1015
|
const hasMemoryFail = failures.some(f => /checkpoints|sessions|codebase-map|goals/.test(f));
|
|
1005
1016
|
console.log('');
|
|
1006
|
-
if (hasCommandFail || hasHookFail) console.log(' Fix: re-run npx azclaude to install missing files');
|
|
1017
|
+
if (hasCommandFail || hasHookFail) console.log(' Fix: re-run npx azclaude-copilot to install missing files');
|
|
1007
1018
|
if (hasHookFail) console.log(' If hooks still fail: check that Node.js ≥ 16 is in PATH');
|
|
1008
1019
|
if (hasGitFail) console.log(' Git: commit or stash uncommitted changes');
|
|
1009
1020
|
if (hasMemoryFail) console.log(' Memory: run /setup or /persist to create missing files');
|
|
@@ -1116,9 +1127,12 @@ console.log('\n═════════════════════
|
|
|
1116
1127
|
console.log(` Install mode: ${fullInstall ? 'full (all capabilities)' : 'core (shared + level-builders)'}`);
|
|
1117
1128
|
console.log(' Architecture: lazy-loaded, manifest-driven');
|
|
1118
1129
|
console.log(' Token cost per task: ~200-600 (vs ~21,000 monolith)');
|
|
1119
|
-
console.log(
|
|
1130
|
+
console.log('');
|
|
1120
1131
|
if (!fullInstall) {
|
|
1121
|
-
console.log('');
|
|
1122
|
-
console.log('
|
|
1132
|
+
console.log(' Next steps:');
|
|
1133
|
+
console.log(' 1. npx azclaude-copilot --full (Level 5+: debate, pipeline, ELO)');
|
|
1134
|
+
console.log(' 2. Open Claude Code and run /setup');
|
|
1135
|
+
} else {
|
|
1136
|
+
console.log(' Next step: open Claude Code and run /setup');
|
|
1123
1137
|
}
|
|
1124
1138
|
console.log('════════════════════════════════════════════════\n');
|
package/package.json
CHANGED