azclaude-copilot 0.4.14 → 0.4.16

package/README.md

@@ -58,10 +58,10 @@ Most AI coding tools require upfront decisions: which agents to create, what pro
 AZCLAUDE inverts this. **You start with almost nothing. The environment builds itself from evidence.**
 
 ```bash
-azclaude-copilot setup --full   # one command. that's it.
+npx azclaude-copilot   # one command. that's it.
 ```
 
-No agent files to write. No skills to configure. No prompt engineering. `setup --full` installs 27 commands, 4 hooks, memory structure, and a manifest. The rest is generated from your actual codebase as you work.
+No agent files to write. No skills to configure. No prompt engineering. `npx azclaude-copilot` installs 33 commands, 4 hooks, memory structure, and a manifest. The rest is generated from your actual codebase as you work. Run the same command again later — it auto-detects whether to skip, install, or upgrade.
 
 **What the environment looks like across sessions:**
 
@@ -113,19 +113,16 @@ Claude reads the manifest (one file), finds which 1-3 capability files apply, lo
 **Step 1 — Install globally from your terminal:**
 
 ```bash
-npm install -g azclaude-copilot@latest
+npx azclaude-copilot
 ```
 
-**Step 2 — Run setup inside Claude Code:**
+That's it. One command, no flags. Auto-detects whether this is a fresh install or an upgrade:
+- **First time** → full install (33 commands, 4 hooks, 15 agents, 8 skills, memory, reflexes)
+- **Already installed, older version** → auto-upgrades everything to latest templates
+- **Already up to date** → verifies, no overwrites
 
 ```bash
-azclaude-copilot setup --full
-```
-
-That's it. Your project now has AZCLAUDE in `.claude/` — 33 commands, 4 hooks, memory, reflexes, agents, and skills.
-
-```bash
-azclaude-copilot doctor   # 32 checks — verify everything is wired correctly
+npx azclaude-copilot doctor   # 32 checks — verify everything is wired correctly
 ```
 
 ---
@@ -772,10 +769,10 @@ AZCLAUDE builds capability progressively — start simple, grow into complexity:
 | 3 | Skills — project-specific commands | `/setup` generates ≥ 2 |
 | 4 | Memory — goals.md, patterns, antipatterns | `/setup` |
 | 5 | Agents — from git co-change analysis | `/evolve` after 5+ commits |
-| 6 | Hooks — stateful session tracking | `azclaude-copilot setup` |
+| 6 | Hooks — stateful session tracking | `npx azclaude-copilot` |
 | 7 | External MCP servers | `/level-up` |
 | 8 | Orchestrated pipeline — multi-agent with problem-architect | `/level-up` |
-| 9 | Intelligence — debate, OPRO, ELO, pipeline isolation | `setup --full` |
+| 9 | Intelligence — debate, OPRO, ELO, pipeline isolation | `npx azclaude-copilot` |
 | 10 | Self-evolving — loop-controller, 3-cycle autonomous evolution | `/evolve` sustained |
 
 Run `/level-up` at any time to see your current level and build the next one.

package/bin/cli.js

@@ -1144,15 +1144,82 @@ if (fs.existsSync(postInstallValidator)) {
   } catch (_) {}
 }
 
+// ── Detect project state for smart onboarding ────────────────────────────────
+const planPath   = path.join(projectDir, cli.cfg, 'plan.md');
+const intentPath = path.join(projectDir, cli.cfg, 'copilot-intent.md');
+const hasPlan    = fs.existsSync(planPath);
+const hasIntent  = fs.existsSync(intentPath);
+
+// Check for pending milestones in plan.md
+let hasPendingMilestones = false;
+if (hasPlan) {
+  try {
+    const planContent = fs.readFileSync(planPath, 'utf8');
+    hasPendingMilestones = /status:\s*pending/i.test(planContent);
+  } catch (_) {}
+}
+
+// Check for existing code files (not empty project)
+const codeExtensions = ['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java', '.rb', '.cs'];
+let hasCode = false;
+try {
+  const entries = fs.readdirSync(projectDir);
+  for (const entry of entries) {
+    if (entry.startsWith('.') || entry === 'node_modules') continue;
+    const ext = path.extname(entry);
+    if (codeExtensions.includes(ext)) { hasCode = true; break; }
+    // check one level deep
+    const sub = path.join(projectDir, entry);
+    try {
+      if (fs.statSync(sub).isDirectory()) {
+        const subEntries = fs.readdirSync(sub);
+        if (subEntries.some(f => codeExtensions.includes(path.extname(f)))) {
+          hasCode = true; break;
+        }
+      }
+    } catch (_) {}
+  }
+} catch (_) {}
+
+// Determine onboarding path
+let onboardingPath;
+if (hasPlan && hasPendingMilestones) {
+  onboardingPath = 'RESUME';
+} else if (hasPlan || hasCode || hasIntent) {
+  onboardingPath = 'EXISTING';
+} else {
+  onboardingPath = 'NEW';
+}
+
 console.log('\n════════════════════════════════════════════════');
-console.log(`  v${currentVer} — ${isFirstInstall ? 'installed' : needsUpgrade ? 'upgraded' : 'up to date'}`);
-console.log('  Architecture: lazy-loaded, manifest-driven');
-console.log('  Token cost per task: ~200-600 (vs ~21,000 monolith)');
+console.log(`  AZCLAUDE v${currentVer} — ${isFirstInstall ? 'installed' : needsUpgrade ? 'upgraded' : 'up to date'}`);
+console.log('');
+console.log('  Open Claude Code in this directory, then:');
 console.log('');
-if (isFirstInstall || needsUpgrade) {
-  console.log('  Next step: open Claude Code and run /setup');
+
+if (onboardingPath === 'RESUME') {
+  console.log('  You have a plan with pending work:');
+  console.log('');
+  console.log('    /copilot          resume autonomous build');
+  console.log('    /pulse            see current state first');
+  console.log('    /analyze plan     verify plan vs reality');
+} else if (onboardingPath === 'EXISTING') {
+  console.log('  Existing project detected:');
+  console.log('');
+  console.log('    /setup            scan + configure this project');
+  console.log('    /dream            define what to build next');
+  console.log('    /blueprint        plan the next feature');
+  console.log('    /copilot .        build autonomously');
 } else {
-  console.log('  Already up to date. Run /setup in Claude Code to configure.');
+  console.log('  New project:');
+  console.log('');
+  console.log('    /setup            configure this project');
+  console.log('    /add [feature]    start building immediately');
+  console.log('    /dream            plan a full product first');
 }
-console.log(`  To upgrade later: npx azclaude-copilot@latest  (auto-detects version)`);
+
+console.log('');
+console.log('  ─────────────────────────────────────────────');
+console.log('  docs:    github.com/haytamAroui/AZ-CLAUDE-COPILOT');
+console.log('  upgrade: npx azclaude-copilot  (auto-detects)');
 console.log('════════════════════════════════════════════════\n');

package/bin/copilot.js

@@ -25,15 +25,18 @@ const args       = process.argv.slice(2);
 
 // ── Subcommand routing ──────────────────────────────────────────────────────
 // Catch `npx azclaude-copilot setup` and similar — run the installer instead
-const SUBCOMMANDS = ['setup', 'init', 'install', 'doctor'];
+// Also: no arguments at all → run installer (auto-detect install vs upgrade)
+const SUBCOMMANDS = ['setup', 'init', 'install', 'doctor', 'upgrade'];
 const CLI_FLAGS   = ['--update', '--full', '--audit'];
-if (args[0] && SUBCOMMANDS.includes(args[0].toLowerCase())) {
+const noArgs = args.length === 0 || (args.length === 1 && CLI_FLAGS.includes(args[0]));
+if (noArgs || (args[0] && SUBCOMMANDS.includes(args[0].toLowerCase()))) {
   const subFlags = args.filter(a => CLI_FLAGS.includes(a));
-  const subPositional = args.slice(1).filter(a => !CLI_FLAGS.includes(a));
+  const subPositional = (noArgs ? [] : args.slice(1)).filter(a => !CLI_FLAGS.includes(a));
   const subDir = path.resolve(subPositional[0] || '.');
-  console.log(`\n  Running AZCLAUDE installer on ${subDir}...${subFlags.length ? ' (' + subFlags.join(' ') + ')' : ''}\n`);
+  if (!noArgs) console.log(`\n  Running AZCLAUDE installer on ${subDir}...${subFlags.length ? ' (' + subFlags.join(' ') + ')' : ''}\n`);
   const cliPath = path.join(__dirname, 'cli.js');
-  const subArgs = args[0].toLowerCase() === 'doctor'
+  const isDoctor = !noArgs && args[0].toLowerCase() === 'doctor';
+  const subArgs = isDoctor
     ? [cliPath, subDir, '--doctor', ...subFlags]
     : [cliPath, subDir, ...subFlags];
   const r = spawnSync('node', subArgs, { cwd: subDir, stdio: 'inherit' });
@@ -51,8 +54,9 @@ if (args.includes('--help') || args.includes('-h')) {
   AZCLAUDE — Autonomous Mode
 
   Usage:
-    npx azclaude-copilot <project-dir> <intent> [max-sessions]
-    npx azclaude-copilot setup [dir]      # install AZCLAUDE into project
+    npx azclaude-copilot                  # install or upgrade (auto-detected)
+    npx azclaude-copilot . <intent>       # autonomous mode — build from intent
+    npx azclaude-copilot .                # autonomous mode — resume existing plan
     npx azclaude-copilot doctor [dir]     # run health check
 
   Examples:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azclaude-copilot",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "description": "AI coding environment — 27 commands, 8 skills, 13 agents, memory, reflexes, evolution. Install: npm install -g azclaude-copilot@latest, then in Claude Code: azclaude-copilot setup --full",
   "bin": {
     "azclaude": "bin/cli.js",