azclaude-copilot 0.7.13 → 0.7.15

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "azclaude",
       "description": "AZCLAUDE is a complete AI coding environment for Claude Code. It installs 42 commands, 10 auto-invoked skills, 15 specialized agents, 5 hooks, a real-time pipeline visualizer, and a persistent memory system — in one command.\n\nKey features:\n• Memory across sessions — goals.md + checkpoints injected automatically before every session\n• Self-improving loop — /reflect fixes stale CLAUDE.md rules, /reflexes learns from tool-use patterns, /evolve creates agents from git evidence\n• Autonomous copilot mode — /copilot runs a three-tier team (orchestrator → problem-architect → milestone-builder) across sessions until the product ships\n• Spec-driven workflow — /constitute writes project rules, /spec writes structured ACs, /analyze detects plan drift and ghost milestones, /blueprint traces every milestone to a spec\n• Security layer — 111-rule environment scan (/sentinel), pre-write secret blocking, pre-ship credential audit\n• Progressive levels 0–10 — start with CLAUDE.md, grow into multi-agent pipelines and self-evolving environments\n• Zero dependencies — no npm packages, no external APIs, no vector databases. Plain markdown files and Claude Code's native architecture.\n• Smart install — npx azclaude-copilot@latest auto-detects first install vs upgrade vs verify. Context-aware onboarding shows the right next command for your project state.\n\nExample use cases:\n• /setup — scan an existing project, detect stack + domain + scale, fill CLAUDE.md, generate project-specific skills and agents automatically\n• /copilot \"Build a compliance SaaS with trilingual support\" — walk away, come back to working code across multiple sessions\n• /sentinel — run a scored security audit (0–100, grade A–F) across hooks, permissions, MCP servers, agent configs, and secrets\n• /evolve — detect gaps in the environment, generate new skills and agents from git co-change evidence, report score delta (e.g. 42/100 → 68/100)\n• /constitute — write your project's constitution (non-negotiables, architectural commitments, definition of done) — gates all future AI actions\n• /analyze — cross-artifact consistency check: ghost milestones, spec vs. code drift, unplanned commits\n• /reflect — find stale, missing, or contradicting rules in CLAUDE.md and propose exact fixes\n• /debate \"REST vs GraphQL for this project\" — adversarial evidence-based decision with order-independent scoring, logged to decisions.md",
-      "version": "0.7.13",
+      "version": "0.7.15",
       "source": {
         "source": "github",
         "repo": "haytamAroui/AZ-CLAUDE-COPILOT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "azclaude",
-  "version": "0.7.13",
+  "version": "0.7.15",
   "description": "AZCLAUDE is a complete AI coding environment for Claude Code. It installs 42 commands, 10 auto-invoked skills, 15 specialized agents, 5 hooks, a real-time pipeline visualizer, and a persistent memory system — in one command.\n\nKey features:\n• Memory across sessions — goals.md + checkpoints injected automatically before every session\n• Self-improving loop — /reflect fixes stale CLAUDE.md rules, /reflexes learns from tool-use patterns, /evolve creates agents from git evidence\n• Autonomous copilot mode — /copilot runs a three-tier team (orchestrator → problem-architect → milestone-builder) across sessions until the product ships\n• Spec-driven workflow — /constitute writes project rules, /spec writes structured ACs, /analyze detects plan drift and ghost milestones, /blueprint traces every milestone to a spec\n• Security layer — 111-rule environment scan (/sentinel), pre-write secret blocking, pre-ship credential audit\n• Progressive levels 0–10 — start with CLAUDE.md, grow into multi-agent pipelines and self-evolving environments\n• Zero dependencies — no npm packages, no external APIs, no vector databases. Plain markdown files and Claude Code's native architecture.\n• Smart install — npx azclaude-copilot@latest auto-detects first install vs upgrade vs verify. Context-aware onboarding shows the right next command for your project state.\n\nExample use cases:\n• /setup — scan an existing project, detect stack + domain + scale, fill CLAUDE.md, generate project-specific skills and agents automatically\n• /copilot \"Build a compliance SaaS with trilingual support\" — walk away, come back to working code across multiple sessions\n• /sentinel — run a scored security audit (0–100, grade A–F) across hooks, permissions, MCP servers, agent configs, and secrets\n• /evolve — detect gaps in the environment, generate new skills and agents from git co-change evidence, report score delta (e.g. 42/100 → 68/100)\n• /constitute — write your project's constitution (non-negotiables, architectural commitments, definition of done) — gates all future AI actions\n• /analyze — cross-artifact consistency check: ghost milestones, spec vs. code drift, unplanned commits\n• /reflect — find stale, missing, or contradicting rules in CLAUDE.md and propose exact fixes\n• /debate \"REST vs GraphQL for this project\" — adversarial evidence-based decision with order-independent scoring, logged to decisions.md",
   "author": {
     "name": "haytamAroui",

package/README.md

@@ -637,11 +637,11 @@ AZCLAUDE is a lazy-loaded environment of 48 capability modules. It only loads wh
 
 ## Verified
 
-1996 tests. Every template, command, capability, agent, hook, and CLI feature verified.
+2024 tests. Every template, command, capability, agent, hook, and CLI feature verified.
 
 ```bash
 bash tests/test-features.sh
-# Results: 1996 passed, 0 failed, 1996 total
+# Results: 2024 passed, 0 failed, 2024 total
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azclaude-copilot",
-  "version": "0.7.13",
+  "version": "0.7.15",
   "description": "AI coding environment — 42 commands, 10 skills, 15 agents, real-time visualizer, memory, reflexes, evolution. Install: npx azclaude-copilot@latest, then open Claude Code.",
   "bin": {
     "azclaude": "bin/cli.js",

package/templates/agents/orchestrator.md

@@ -211,9 +211,14 @@ Load `capabilities/shared/context-relay.md` for relay protocol and role-based fi
 7. **Model routing** — read `Model Recommendation` from each Team Spec. Pass it as `model: "{value}"` on the Task/Agent call. If absent, fall back to the agent's frontmatter `model:` field. Model selection varies per milestone — always use the actual recommendation, not a hardcoded assumption.
 8. Spawn each builder via Task with `isolation: "worktree"` and `model: "{from Team Spec}"` in the same message (true parallel)
 9. Include worktree rules + **test scope** (`Test scope: {test-dir}`) in every parallel prompt
-10. **Merge-on-complete**: as each agent reports done, merge its branch immediately (don't wait for all)
-11. After each merge: check if newly-unblocked milestones exist → dispatch them immediately
-12. If `max_parallel <= 3` or merge conflicts detected: fall back to batch-merge (wait for all, then merge)
+10. **Mid-flight control** — while agents run, monitor their partial progress reports via SendMessage:
+    - Agent reports progress (not final result) + new information changes the spec → `SendMessage({ to: agentId, message: "Revised scope: ..." })`
+    - Agent appears stuck (no output for 3+ turns after dispatch) → `SendMessage({ to: agentId, message: "Status check — what's blocking you?" })`
+    - Scope needs adjusting due to a sibling agent's discovery → `SendMessage` with revised file list before the affected agent reaches that file
+    - Agent reports a blocker it cannot resolve → `SendMessage` with the resolution, or redirect to a different approach
+11. **Merge-on-complete**: as each agent reports final result (not partial), merge its branch immediately (don't wait for all)
+12. After each merge: check if newly-unblocked milestones exist → dispatch them immediately
+13. If `max_parallel <= 3` or merge conflicts detected: fall back to batch-merge (wait for all, then merge)
 
 **Sequential dispatch (single milestone OR overlapping files):**
 

package/templates/commands/blueprint.md

@@ -36,7 +36,8 @@ If `$ARGUMENTS` contains `--deep`:
 
 ---
 
-**EnterPlanMode** — read and think only. No file modifications until Step 4.
+Call the `EnterPlanMode` tool NOW — this enforces read-only mode at the kernel level.
+No file edits are possible until you call `ExitPlanMode` at Step 4: Approval Gate.
 
 ---
 

package/templates/commands/kill.md

@@ -6,7 +6,7 @@ description: >
   "port still in use", "EADDRINUSE", "address already in use", "stop all servers",
   "kill background processes", "clean up ports".
   Safe by design — only kills processes bound to TCP ports, never MCP servers (stdio, no ports).
-argument-hint: "[port number | --all (default) | --ports 3000,8080]"
+argument-hint: "[port number | --all | --ports 3000,8080]"
 disable-model-invocation: false
 allowed-tools: Bash, Read, Glob
 ---
@@ -27,50 +27,84 @@ Any process on a TCP port is a dev/test server, not Claude infrastructure.
 
 ## Step 1 — Parse target ports
 
-**If $ARGUMENTS contains a port number** (e.g., `/kill 3000`):
+**If $ARGUMENTS contains a port number** (e.g., `/kill 8005`):
 → Kill only that specific port. Skip to Step 3.
 
-**If $ARGUMENTS is `--ports <list>`** (e.g., `/kill --ports 3000,5173`):
+**If $ARGUMENTS is `--ports <list>`** (e.g., `/kill --ports 3000,8005`):
 → Parse the comma-separated list. Skip to Step 3.
 
-**Default (`--all` or no argument)**:
-→ Target the full dev port list below. Continue to Step 2.
+**`--all` or no argument**:
+→ Scan every active listening TCP port on this machine (dynamic — not a hardcoded list).
+→ Continue to Step 2a.
 
-### Default dev port list
+> Use `--all` when you have custom ports (e.g., 8005, 9999, any port not in a standard list).
+> `/kill 8005` also works to target a single non-standard port directly.
+
+### Common dev ports (reference only — `--all` does NOT use this list)
 ```
 3000  3001  3002  3003  4000  4200  4321
 5000  5001  5173  5174  6006  7000  8000
-8001  8080  8081  8888  9000  9001  9229
+8001  8005  8080  8081  8888  9000  9001  9229
+```
+> 9229 is Node.js debugger. Kill only if you're not actively debugging.
+
+---
+
+## Step 2a — Discover ALL listening ports (used by `--all` / no argument)
+
+**Unix/macOS:**
+```bash
+# Get every TCP port in LISTEN state — no hardcoded list needed
+lsof -iTCP -sTCP:LISTEN -P -n 2>/dev/null | awk 'NR>1 {print $9}' | sed 's/.*://' | sort -nu
+```
+
+**Windows:**
+```bash
+netstat -ano 2>/dev/null | grep "LISTENING" | awk '{print $2}' | sed 's/.*://' | sort -nu
 ```
 
-> Note: 9229 is Node.js debugger. Kill only if you're not actively debugging.
+Print each discovered port and its PID + process name:
+
+**Unix/macOS:**
+```bash
+lsof -iTCP -sTCP:LISTEN -P -n 2>/dev/null | awk 'NR>1 {print $2, $9, $1}' | sed 's/ .*:/  PORT /' | sort -k2 -n
+```
+
+**Windows:**
+```bash
+netstat -ano 2>/dev/null | grep "LISTENING" | awk '{print $2, $5}' | sed 's/.*://' | sort -k1 -n
+```
+
+If no ports found: print `No listening TCP servers found.` and stop.
 
 ---
 
-## Step 2 — Detect which ports are actually in use
+## Step 2b — Detect specific ports (used by `/kill 8005` or `/kill --ports ...`)
 
 **Unix/macOS:**
 ```bash
-for port in 3000 3001 3002 3003 4000 4200 4321 5000 5001 5173 5174 6006 7000 8000 8001 8080 8081 8888 9000 9001 9229; do
+for port in <PORTS>; do
   pid=$(lsof -ti tcp:$port 2>/dev/null)
   if [ -n "$pid" ]; then
     echo "  PORT $port → PID $pid ($(ps -p $pid -o comm= 2>/dev/null))"
+  else
+    echo "  PORT $port → not in use"
   fi
 done
 ```
 
 **Windows:**
 ```bash
-for port in 3000 3001 3002 3003 4000 4200 4321 5000 5001 5173 5174 6006 7000 8000 8001 8080 8081 8888 9000 9001 9229; do
+for port in <PORTS>; do
   result=$(netstat -ano 2>/dev/null | grep ":$port " | grep LISTENING | awk '{print $5}' | head -1)
   if [ -n "$result" ]; then
     echo "  PORT $port → PID $result"
+  else
+    echo "  PORT $port → not in use"
   fi
 done
 ```
 
-Print summary of occupied ports. If none found: print `No dev servers found on standard ports.` and stop.
-
 ---
 
 ## Step 3 — Kill strategy
@@ -79,9 +113,9 @@ Print summary of occupied ports. If none found: print `No dev servers found on s
 ```bash
 npx --yes kill-port <PORTS>
 ```
-Example: `npx --yes kill-port 3000 5173 8080`
+Example: `npx --yes kill-port 8005 3000 5173`
 
-This is safe, silent on ports that are already free, and exits 0 on success.
+Silent on ports already free, exits 0 on success.
 
 ### Fallback — Unix/macOS (if npx not available):
 ```bash
@@ -106,11 +140,11 @@ done
 
 ## Step 4 — Verify
 
-After killing, re-run the detection from Step 2.
+Re-run the detection from Step 2a or 2b (matching what was used).
 
 **Expected output:**
 ```
-No dev servers found on standard ports.
+No listening TCP servers found.
 ```
 
 If any port is still occupied: report it and its PID. Do not retry — report to user.
@@ -121,7 +155,7 @@ If any port is still occupied: report it and its PID. Do not retry — report to
 
 Print a summary:
 ```
-Killed: ports 3000, 5173
+Killed: ports 8005, 3000, 5173
 Still running: (none)
 ```
 

package/templates/hooks/user-prompt.js

@@ -379,6 +379,16 @@ if (fs.existsSync(blockersPath)) {
   } catch (_) {}
 }
 
+// ── Staleness helper — warns when memory files are older than 1 day ──────────
+// File:line references and architecture decisions go stale fast.
+// Claude Code natively warns on memories > 1 day old — AZCLAUDE matches that.
+function _staleWarning(filePath) {
+  try {
+    const ageDays = Math.floor((Date.now() - fs.statSync(filePath).mtimeMs) / 86_400_000);
+    return ageDays > 1 ? `\n⚠ This memory is ${ageDays} day${ageDays > 1 ? 's' : ''} old — verify file:line references against current code before asserting as fact.` : '';
+  } catch (_) { return ''; }
+}
+
 // ── Inject architecture decisions if present ────────────────────────────────
 const decisionsPath = path.join('.claude', 'memory', 'decisions.md');
 if (fs.existsSync(decisionsPath)) {
@@ -387,10 +397,12 @@ if (fs.existsSync(decisionsPath)) {
     if (decisionsContent.length > 0) {
       const decisionsLines = decisionsContent.split('\n').filter(l => !INJECTION.test(l));
       const capped = decisionsLines.slice(0, 30);
+      const stale = _staleWarning(decisionsPath);
       console.log('');
       console.log('--- ARCHITECTURE DECISIONS ---');
       console.log(capped.join('\n'));
       if (decisionsLines.length > 30) console.log(`... ${decisionsLines.length - 30} more lines (on disk)`);
+      if (stale) console.log(stale);
       console.log('--- END DECISIONS ---');
     }
   } catch (_) {}
@@ -404,10 +416,12 @@ if (fs.existsSync(patternsPath)) {
     if (patternsContent.length > 0) {
       const patternsLines = patternsContent.split('\n').filter(l => !INJECTION.test(l));
       const capped = patternsLines.slice(0, 20);
+      const stale = _staleWarning(patternsPath);
       console.log('');
       console.log('--- CODE PATTERNS ---');
       console.log(capped.join('\n'));
       if (patternsLines.length > 20) console.log(`... ${patternsLines.length - 20} more lines (on disk)`);
+      if (stale) console.log(stale);
       console.log('--- END PATTERNS ---');
     }
   } catch (_) {}
@@ -428,9 +442,11 @@ if (fs.existsSync(checkpointDir)) {
     const cpTrimmed  = cpLines.length > MAX_CP
       ? cpLines.slice(0, MAX_CP).concat([`... ${cpLines.length - MAX_CP} more lines (on disk)`])
       : cpLines;
+    const stale = _staleWarning(latest);
     console.log('');
     console.log(`--- LAST CHECKPOINT (${files[0]}) ---`);
     console.log(cpTrimmed.join('\n').trim());
+    if (stale) console.log(stale);
     console.log('--- END CHECKPOINT ---');
   }
 }