azclaude-copilot 0.2.3 → 0.3.1

package/README.md

@@ -430,7 +430,7 @@ azclaude-copilot/
 ├── DOCS.md                          <- full user guide
 ├── SECURITY.md                      <- security policy + architecture
 ├── tests/
-│   └── test-features.sh          ← 1048 tests
+│   └── test-features.sh          ← 1055 tests
 ```
 
 ---
@@ -456,11 +456,11 @@ The runner is stateless. These files ARE the state.
 
 ## Verified
 
-1048 tests. Every template, command, capability, agent, and CLI feature verified.
+1055 tests. Every template, command, capability, agent, and CLI feature verified.
 
 ```bash
 bash tests/test-features.sh
-# Results: 1048 passed, 0 failed, 1048 total
+# Results: 1055 passed, 0 failed, 1055 total
 ```
 
 ---

package/bin/cli.js

@@ -417,6 +417,46 @@ function installAgents(projectDir, cfg) {
   }
 }
 
+// ─── Capability Reference Verification ───────────────────────────────────────
+
+function verifyCapabilityReferences(projectDir, cfg) {
+  const dirsToScan = [
+    path.join(projectDir, cfg, 'commands'),
+    path.join(projectDir, cfg, 'agents'),
+  ];
+  const capPattern = /capabilities\/[^\s)}\]"'`,]+/g;
+  let checked = 0, missing = 0;
+  const seen = new Set();
+
+  for (const dir of dirsToScan) {
+    if (!fs.existsSync(dir)) continue;
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(dir, file), 'utf8');
+      const matches = content.match(capPattern);
+      if (!matches) continue;
+      for (const ref of matches) {
+        const key = ref;
+        if (seen.has(key)) continue;
+        seen.add(key);
+        checked++;
+        // Resolve relative to cfg dir (e.g. .claude/capabilities/shared/tdd.md)
+        const resolved = path.join(projectDir, cfg, ref);
+        if (!fs.existsSync(resolved)) {
+          warn(`Capability ref not found: ${ref} (in ${path.basename(dir)}/${file})`);
+          missing++;
+        }
+      }
+    }
+  }
+
+  if (checked > 0 && missing === 0) {
+    ok(`Capability references verified — ${checked} refs, all resolve`);
+  } else if (missing > 0) {
+    warn(`Capability references: ${missing}/${checked} missing — fix or remove stale refs`);
+  }
+}
+
 // ─── Rules File (CLAUDE.md / GEMINI.md / AGENTS.md) ──────────────────────────
 
 function installRulesFile(projectDir, cfg, rulesFile) {
@@ -986,6 +1026,23 @@ console.log('  AZCLAUDE — AI Coding Environment');
 console.log(`  CLI: ${cli.name} → installing to ${cli.cfg}/`);
 console.log('════════════════════════════════════════════════\n');
 
+// ── Detect conflicting installations ─────────────────────────────────────────
+const CLI_DIRS = ['.claude', '.gemini', '.opencode', '.codex', '.cursor'];
+const existing = CLI_DIRS.filter(d => {
+  const p = path.join(projectDir, d);
+  return fs.existsSync(p) && fs.statSync(p).isDirectory() && d !== cli.cfg;
+}).filter(d => {
+  // Only flag dirs that have AZCLAUDE content (commands/ or settings)
+  const p = path.join(projectDir, d);
+  return fs.existsSync(path.join(p, 'commands')) || fs.existsSync(path.join(p, 'settings.local.json'));
+});
+
+if (existing.length > 0) {
+  warn(`Found AZCLAUDE in other CLI directories: ${existing.join(', ')}`);
+  warn(`Installing to ${cli.cfg}/ — the other directories may be stale.`);
+  warn(`Consider removing stale dirs: ${existing.map(d => `rm -rf ${d}`).join(', ')}`);
+}
+
 verifyIntegrity(projectDir, cli.cfg, cli);
 
 // Hooks: project-scoped by default (settings.local.json), global as fallback
@@ -1011,6 +1068,9 @@ if (!fs.existsSync(evolLogPath)) {
   try { fs.writeFileSync(evolLogPath, header); } catch (_) {}
 }
 
+// ── Post-install capability reference verification ───────────────────────────
+verifyCapabilityReferences(projectDir, cli.cfg);
+
 // ── Post-install boundary check (warn if collisions detected) ────────────────
 const postInstallValidator = path.join(projectDir, cli.cfg, 'scripts', 'validate-boundaries.sh');
 if (fs.existsSync(postInstallValidator)) {

package/bin/copilot.js

@@ -36,9 +36,11 @@ if (args[0] && SUBCOMMANDS.includes(args[0].toLowerCase())) {
   process.exit(r.status || 0);
 }
 
-const projectDir = path.resolve(args[0] || '.');
-const intentArg  = args[1] || '';
-const maxSessions = parseInt(args[2] || '20', 10);
+const deepMode   = args.includes('--deep');
+const filteredArgs = args.filter(a => a !== '--deep');
+const projectDir = path.resolve(filteredArgs[0] || '.');
+const intentArg  = filteredArgs[1] || '';
+const maxSessions = parseInt(filteredArgs[2] || '20', 10);
 
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`
@@ -57,6 +59,7 @@ if (args.includes('--help') || args.includes('-h')) {
 
   Options:
     --help, -h    Show this help
+    --deep        Enable deep audit mode (content accuracy, UX, links, a11y)
     max-sessions  Maximum sessions before stopping (default: 20)
   `);
   process.exit(0);
@@ -177,6 +180,15 @@ for (let session = 1; session <= maxSessions; session++) {
   prompt += `\n\nOriginal intent: ${intent}`;
   prompt += `\n\nSession ${session}/${maxSessions}.`;
 
+  if (deepMode) {
+    prompt += '\n\nDEEP MODE: After code audit passes, also run:';
+    prompt += '\n1. Content accuracy audit — verify facts, percentages, links against source material';
+    prompt += '\n2. UX heuristic check — scroll depth, navigation efficiency, mobile responsiveness';
+    prompt += '\n3. Link validation — verify all internal/external links resolve';
+    prompt += '\n4. Accessibility audit — screen reader flow, focus order, color contrast';
+    prompt += '\nDo NOT declare COPILOT_COMPLETE until deep checks pass.';
+  }
+
   if (resuming || session > 1) {
     // Parse plan.md for milestone progress
     if (fs.existsSync(planPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azclaude-copilot",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "AI coding environment — 26 commands, 8 skills, 7 agents, memory, reflexes, evolution. Install once, works on any stack.",
   "bin": {
     "azclaude": "./bin/cli.js",

package/templates/capabilities/shared/quality-check.md

@@ -27,7 +27,7 @@ echo "--- Core files ---"
 [ -f .claude/capabilities/manifest.md ] && echo "✓ manifest.md" || echo "✗ manifest.md MISSING"
 
 echo "--- Commands ---"
-for cmd in dream setup fix add review test plan evolve debate persist level-up ship status explain loop; do
+for cmd in dream setup fix add audit test blueprint evolve debate persist level-up ship pulse explain loop; do
   [ -f ".claude/commands/$cmd.md" ] && echo "✓ /$cmd" || echo "✗ /$cmd MISSING"
 done
 
@@ -71,6 +71,30 @@ done
 
 ---
 
+### Capability Reference Check
+
+Verify all `capabilities/` references in commands and agents resolve to existing files:
+
+```bash
+echo "--- Capability references ---"
+missing=0
+for dir in .claude/commands .claude/agents; do
+  [ -d "$dir" ] || continue
+  for f in "$dir"/*.md; do
+    refs=$(grep -oE 'capabilities/[^ )\]}"'"'"',]+' "$f" 2>/dev/null | sort -u)
+    for ref in $refs; do
+      if [ ! -f ".claude/$ref" ] && [ ! -d ".claude/$ref" ]; then
+        echo "✗ Missing: $ref (in $(basename $f))"
+        missing=$((missing + 1))
+      fi
+    done
+  done
+done
+[ "$missing" -eq 0 ] && echo "✓ All capability references resolve" || echo "✗ $missing broken references"
+```
+
+---
+
 ### Pass Criteria
 
 All checks must show ✓ before declaring setup complete.

package/templates/commands/audit.md

@@ -107,6 +107,19 @@ Issues:
 
 ---
 
+## Content Audit (educational/documentation projects only)
+
+Detect: `ls **/course* **/exam* **/quiz* **/lesson* knowledge/ docs/courses/ 2>/dev/null`
+
+If educational content detected:
+1. **Weight/percentage validation** — compare any stated percentages against source material
+2. **Internal link check** — verify all markdown links resolve to existing files/anchors
+3. **Content completeness** — check each section has substantive content (not just headers)
+4. **Consistency check** — domain names, numbering, terminology used consistently
+5. **Scroll depth warning** — flag any single page with 3000+ words (suggest splitting)
+
+---
+
 ## Completion Rule
 
 **ExitPlanMode**

package/templates/commands/setup.md

@@ -127,6 +127,11 @@ Skip if project has < 10 files or < 5 commits.
 
 Load `capabilities/shared/quality-check.md` and run the full environment check.
 
+Verify all capability file references in commands and agents resolve to existing files:
+- Grep all `.claude/commands/*.md` and `.claude/agents/*.md` for `capabilities/` references
+- Check each referenced path exists under `.claude/`
+- Warn on any missing references — stale refs cause silent load failures
+
 **TaskUpdate → completed** for Run quality check.
 
 All ✓ required before printing "Setup complete."