viepilot 3.11.0 → 3.12.1

package/CHANGELOG.md

@@ -9,6 +9,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [3.12.1] - 2026-05-26
+### Fixed
+- `bin/vp-tools.cjs` `check-update --silent`: OS session guard file (`/tmp/vp-update-check-{today}.done`) — subsequent skill invocations skip npm call entirely, exit with 0 stdout (0 tokens) (DEBT-003)
+- `lib/viepilot-update.cjs`: reduce version cache TTL 24h → 6h for more timely update notices (DEBT-003)
+
+---
+
+## [3.12.0] - 2026-05-25
+### Changed
+- `workflows/autonomous.md`: tracker-agent now rewrites Current State block (find-and-replace)
+  instead of appending — TRACKER.md stays ≤ 20 lines regardless of phase count (DEBT-002)
+- `workflows/autonomous.md`: auto-compact size guard — if TRACKER.md > 400 lines, runs
+  `vp-tools tracker compact` before reading (DEBT-002)
+- `workflows/autonomous.md`: Decision Log capped at 20 rows; older rows archived to TRACKER-HISTORY.md
+
+### Added
+- `lib/tracker-compact.cjs`: compact() + rewriteCurrentState() — rescue tool for bloated TRACKER.md files
+- `bin/vp-tools.cjs`: `tracker compact [--keep N]` subcommand — compact bloated TRACKER.md, archive history to TRACKER-HISTORY.md
+
+---
+
 ## [3.11.0] - 2026-05-25
 
 ### Added

package/bin/vp-tools.cjs

@@ -1174,10 +1174,43 @@ ${colors.cyan}Examples:${colors.reset}
     const silent = args.includes('--silent');
     const json = args.includes('--json');
     const force = args.includes('--force');
+
+    // OS session guard — skip npm check if already done today (DEBT-003)
+    if (!force && !json) {
+      const _os = require('os');
+      const _today = new Date().toISOString().split('T')[0];
+      const _guardFile = require('path').join(_os.tmpdir(), `vp-update-check-${_today}.done`);
+      if (fs.existsSync(_guardFile)) {
+        try {
+          const _g = JSON.parse(fs.readFileSync(_guardFile, 'utf8'));
+          if (silent) {
+            if (_g.updateAvailable) { process.stdout.write(_g.latest + '\n'); process.exit(1); }
+            process.exit(0);
+          }
+          process.exit(0);
+        } catch (_) { /* corrupt guard — fall through */ }
+      }
+    }
+
     const { checkLatestVersion } = require('../lib/viepilot-update.cjs');
 
     checkLatestVersion({ force })
       .then(({ upToDate, installed, latest }) => {
+        // Write OS session guard for subsequent skill inits (DEBT-003)
+        if (silent || !json) {
+          try {
+            const _os2 = require('os');
+            const _today2 = new Date().toISOString().split('T')[0];
+            const _gf = require('path').join(_os2.tmpdir(), `vp-update-check-${_today2}.done`);
+            fs.writeFileSync(_gf, JSON.stringify({
+              updateAvailable: !upToDate,
+              latest,
+              installed,
+              checkedAt: new Date().toISOString()
+            }));
+          } catch (_) { /* non-fatal */ }
+        }
+
         const has_update = !upToDate;
         if (json) {
           process.stdout.write(JSON.stringify({ installed, latest, has_update }) + '\n');
@@ -1389,6 +1422,70 @@ ${colors.cyan}Examples:${colors.reset}
     console.log();
   },
 
+  /**
+   * Compact bloated TRACKER.md and archive history (DEBT-002)
+   * Usage: vp-tools tracker compact [--keep N] [--dry-run] [--path <file>]
+   */
+  tracker: (args) => {
+    const sub = args[0];
+
+    if (!sub || sub === 'help') {
+      console.log(`${colors.cyan}Usage:${colors.reset}
+  vp-tools tracker compact [--keep N] [--dry-run] [--path <file>]
+
+${colors.cyan}Subcommands:${colors.reset}
+  compact   Compact bloated TRACKER.md, archive history
+
+${colors.cyan}Options:${colors.reset}
+  --keep N       Number of rows to keep (default: 5)
+  --dry-run      Preview changes without writing
+  --path <file>  Path to TRACKER.md (default: .viepilot/TRACKER.md)
+
+${colors.cyan}Examples:${colors.reset}
+  ${colors.gray}$${colors.reset} vp-tools tracker compact
+  ${colors.gray}$${colors.reset} vp-tools tracker compact --keep 10 --dry-run
+  ${colors.gray}$${colors.reset} vp-tools tracker compact --path /path/to/TRACKER.md`);
+      return;
+    }
+
+    if (sub === 'compact') {
+      // Parse options
+      const keepIdx = args.indexOf('--keep');
+      const keepN = keepIdx !== -1 ? parseInt(args[keepIdx + 1], 10) : 5;
+      const isDryRun = args.includes('--dry-run');
+
+      const pathIdx = args.indexOf('--path');
+      const argPath = pathIdx !== -1 ? args[pathIdx + 1] : null;
+
+      const trackerPath = argPath || path.join(process.cwd(), '.viepilot', 'TRACKER.md');
+
+      try {
+        const { compact } = require(path.join(__dirname, '../lib/tracker-compact.cjs'));
+        const result = compact(trackerPath, { keep: keepN, dryRun: isDryRun });
+
+        if (isDryRun) {
+          console.log(`[dry-run] Would compact ${trackerPath}`);
+          console.log(`  Lines to remove:  ${result.linesRemoved}`);
+          console.log(`  Rows to archive:  ${result.rowsArchived}`);
+          console.log('  No files written.');
+        } else {
+          console.log(formatSuccess(`Compacted ${trackerPath}`));
+          console.log(`  Lines removed:  ${result.linesRemoved}`);
+          console.log(`  Rows archived:  ${result.rowsArchived}`);
+          console.log(`  History file:   ${result.historyFile}`);
+          console.log(`  Result:         ${result.trackerLines} lines remaining`);
+        }
+        process.exit(0);
+      } catch (err) {
+        console.error(formatError('tracker compact error:', err.message));
+        process.exit(1);
+      }
+    }
+
+    console.error(formatError(`Unknown tracker subcommand: ${sub}`, 'Use: compact'));
+    process.exit(1);
+  },
+
   /**
    * Validate adapter capability requirements (FEAT-021 Phase 127)
    * Usage: vp-tools validate --adapter <id>
@@ -1618,6 +1715,20 @@ ${colors.cyan}Examples:${colors.reset}
           'vp-tools update --global --dry-run',
         ],
       },
+      'tracker': {
+        usage: 'vp-tools tracker compact [--keep N] [--dry-run] [--path <file>]',
+        description: 'Compact bloated TRACKER.md and archive history',
+        options: [
+          '--keep N: Number of rows to keep (default: 5)',
+          '--dry-run: Preview changes without writing',
+          '--path <file>: Path to TRACKER.md (default: .viepilot/TRACKER.md)',
+        ],
+        examples: [
+          'vp-tools tracker compact',
+          'vp-tools tracker compact --keep 10 --dry-run',
+          'vp-tools tracker compact --path /path/to/TRACKER.md',
+        ],
+      },
     };
 
     if (command && commandHelp[command]) {
@@ -1669,6 +1780,7 @@ ${colors.cyan}Commands:${colors.reset}
   ${colors.bold}persona${colors.reset} <op>              Manage user personas (get|infer|list|set|auto-switch|context)
   ${colors.bold}detect-adapter${colors.reset} [--json]   Detect active adapter (claude-code/cursor/antigravity/codex/copilot)
   ${colors.bold}validate${colors.reset} --adapter <id>   Validate adapter capability requirements; exits 1 on critical gaps
+  ${colors.bold}tracker${colors.reset} compact [--keep N] Compact bloated TRACKER.md, archive history
   ${colors.bold}help${colors.reset} [command]           Show help (optionally for specific command)
 
 ${colors.cyan}Examples:${colors.reset}

package/docs/skills-reference.md

@@ -643,3 +643,39 @@ controls output style, stack preferences, and team-size assumptions injected int
 ### Output
 - `~/.viepilot/config.json` updated
 - `## User Persona` injected into each skill session
+
+---
+
+## /vp-qa
+
+**Version**: v1.0.0 (fw 2.19.0)
+**Phase**: 148 (ENH-100)
+
+Scan-first QA agent team generator. Researches the codebase first (stack detection, file sampling,
+domain mapping), then generates a context-tailored QA agent team using the Write tool directly — no
+templates. Number of agents and their domains are determined by research output.
+
+### Triggers
+`vp-qa`, `/vp-qa`, "qa agents", "generate qa team", "quality assurance agents"
+
+### Flags
+- `/vp-qa` — auto-detect adapter + stack, generate QA team
+- `/vp-qa --run` — generate + immediately invoke qa-orchestrator
+- `/vp-qa --focus sec` — bias research toward security domains
+- `/vp-qa --focus perf` — bias research toward performance domains
+- `/vp-qa --target <id>` — override adapter detection (claude-code / cursor-agent / antigravity / codex / copilot)
+
+### Output by Adapter
+| Adapter | Output Location | Format |
+|---------|----------------|--------|
+| claude-code | `.claude/agents/qa-orchestrator.md` + `*-scanner.md` | Multi-file, parallel fan-out |
+| cursor-agent | `.cursor/rules/qa-checklist.mdc` | Single MDC rule file |
+| codex | `AGENTS.md` (appended) | `## QA Agent Instructions` section |
+| antigravity | `.agents/skills/qa-orchestrator/SKILL.md` | Multi-file skill |
+| copilot | `.github/agents/qa-orchestrator.agent.md` | Single agent file |
+
+### Flow
+1. **Research phase**: reads codebase, detects stack, samples files, reads `agents/qa-templates/rules/{stack}.md`
+2. **Adapter routing**: `lib/qa-router.cjs` determines output spec
+3. **LLM generates**: Write tool creates agent files directly from research output
+4. **Post-scan**: generated `qa-orchestrator` creates `.viepilot/requests/BUG-{N}.md` entries; `AskUserQuestion` for accept/decline

package/lib/tracker-compact.cjs

@@ -0,0 +1,124 @@
+const fs = require('fs');
+const path = require('path');
+
+function rewriteCurrentState(content, newBlock) {
+  const match = content.match(/^## Current State\n/m);
+  if (!match) return content;
+  const start = match.index + match[0].length;
+  const after = content.slice(start).search(/^## /m);
+  const before = content.slice(0, match.index);
+  const nextSection = after === -1 ? '' : content.slice(start + after);
+  return before + '## Current State\n' + newBlock + nextSection;
+}
+
+function parseStanzas(lines) {
+  const stanzas = [];
+  let current = [];
+  for (const line of lines) {
+    if (line.match(/\*\*Current Phase\*\*/)) {
+      if (current.length > 0) stanzas.push(current);
+      current = [line];
+    } else if (current.length > 0) {
+      current.push(line);
+    }
+  }
+  if (current.length > 0) stanzas.push(current);
+  return stanzas;
+}
+
+function compact(trackerPath, options = {}) {
+  if (!fs.existsSync(trackerPath)) {
+    throw new Error('TRACKER.md not found: ' + trackerPath);
+  }
+
+  const { keep = 5, dryRun = false } = options;
+  const maxRows = Math.max(keep * 4, 20);
+  const content = fs.readFileSync(trackerPath, 'utf8');
+  const lines = content.split('\n');
+
+  let linesRemoved = 0;
+  let rowsArchived = 0;
+  let archiveBlock = '';
+
+  // Process Current State
+  const csIdx = lines.findIndex(l => l === '## Current State');
+  const nextIdx = lines.findIndex((l, i) => i > csIdx && l.match(/^## /));
+
+  if (csIdx !== -1 && nextIdx !== -1) {
+    const csLines = lines.slice(csIdx + 1, nextIdx);
+    const stanzas = parseStanzas(csLines);
+    if (stanzas.length > 1) {
+      const archived = stanzas.slice(0, -1).map(s => s.join('\n')).join('\n');
+      linesRemoved = archived.split('\n').length;
+      archiveBlock += '## Archived Current State\n' + archived + '\n\n';
+    }
+  }
+
+  // Process Decision Log
+  const dlIdx = lines.findIndex(l => l === '## Decision Log');
+  const dlEnd = nextIdx > dlIdx ? nextIdx : lines.length;
+
+  if (dlIdx !== -1) {
+    const tlines = lines.slice(dlIdx + 1, dlEnd);
+    let hIdx = -1, sIdx = -1;
+    for (let i = 0; i < tlines.length; i++) {
+      if (tlines[i].match(/\|\s*Date\s*\|/)) hIdx = i;
+      if (hIdx !== -1 && tlines[i].match(/^\|\s*[-:]+/)) {
+        sIdx = i;
+        break;
+      }
+    }
+    if (hIdx !== -1 && sIdx !== -1) {
+      const rows = tlines.slice(sIdx + 1).filter(l => l.trim().match(/^\|/));
+      if (rows.length > maxRows) {
+        rowsArchived = rows.length - maxRows;
+        archiveBlock += '## Archived Decision Log Rows\n' + rows.slice(0, -maxRows).join('\n') + '\n';
+      }
+    }
+  }
+
+  if (!dryRun && archiveBlock) {
+    const histPath = path.join(path.dirname(trackerPath), 'TRACKER-HISTORY.md');
+    fs.appendFileSync(histPath, '\n---\n# TRACKER Archive — ' + new Date().toISOString().split('T')[0] + '\n\n' + archiveBlock);
+
+    // Rewrite TRACKER.md
+    let newContent = content;
+    if (csIdx !== -1 && nextIdx !== -1) {
+      const stanzas = parseStanzas(lines.slice(csIdx + 1, nextIdx));
+      if (stanzas.length > 0) {
+        newContent = rewriteCurrentState(newContent, stanzas[stanzas.length - 1].join('\n') + '\n');
+      }
+    }
+
+    if (dlIdx !== -1) {
+      const tlines = lines.slice(dlIdx + 1, dlEnd);
+      let hIdx = -1, sIdx = -1;
+      for (let i = 0; i < tlines.length; i++) {
+        if (tlines[i].match(/\|\s*Date\s*\|/)) hIdx = i;
+        if (hIdx !== -1 && tlines[i].match(/^\|\s*[-:]+/)) {
+          sIdx = i;
+          break;
+        }
+      }
+      if (hIdx !== -1 && sIdx !== -1) {
+        const rows = tlines.slice(sIdx + 1).filter(l => l.trim().match(/^\|/));
+        const kept = rows.slice(-maxRows);
+        const newTable = [tlines[hIdx], tlines[sIdx], ...kept].join('\n');
+        const before = lines.slice(0, dlIdx + 1).join('\n');
+        const after = lines.slice(dlEnd).join('\n');
+        newContent = before + '\n' + newTable + '\n' + after;
+      }
+    }
+
+    fs.writeFileSync(trackerPath, newContent, 'utf8');
+  }
+
+  return {
+    linesRemoved,
+    rowsArchived,
+    historyFile: path.join(path.dirname(trackerPath), 'TRACKER-HISTORY.md'),
+    trackerLines: lines.length - linesRemoved
+  };
+}
+
+module.exports = { compact, rewriteCurrentState };

package/lib/viepilot-update.cjs

@@ -161,7 +161,7 @@ function runNpmUpdate(plan) {
  */
 async function checkLatestVersion(opts = {}) {
   const SILENT_RESULT = { upToDate: true, installed: '', latest: '' };
-  const TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+  const TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
 
   try {
     const cacheFile =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "3.11.0",
+  "version": "3.12.1",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {

package/workflows/autonomous.md

@@ -74,6 +74,13 @@ Parse `{{VP_ARGS}}` for flags:
 Load context:
 ```bash
 cat .viepilot/AI-GUIDE.md
+
+# Size guard — auto-compact if TRACKER.md is bloated (> 400 lines)
+if [ -f ".viepilot/TRACKER.md" ] && [ "$(wc -l < .viepilot/TRACKER.md)" -gt 400 ]; then
+  echo "⚠️ TRACKER.md is large ($(wc -l < .viepilot/TRACKER.md) lines) — auto-compacting..."
+  node bin/vp-tools.cjs tracker compact --keep 5
+fi
+
 cat .viepilot/TRACKER.md
 cat .viepilot/ROADMAP.md
 ```
@@ -907,9 +914,10 @@ After phase quality gate passes, send a desktop + phone alert:
    ```
    Agent({ subagent_type: "tracker-agent",
      description: "Update TRACKER.md — phase {N} complete",
-     prompt: "operation: update-current-state. data: Last completed phase {N} — {phase_name}. version: {version}."
+     prompt: "operation: rewrite-current-state. data: Last completed phase {N} — {phase_name}. version: {version}. IMPORTANT: REPLACE the entire '## Current State' section (find the section, overwrite it) — do NOT append new lines. The section must stay ≤ 20 lines total. Also cap '## Decision Log' table at 20 rows — if > 20 rows exist, archive older rows to .viepilot/TRACKER-HISTORY.md."
    })
    ```
+   > Rescue bloated TRACKER.md: `node bin/vp-tools.cjs tracker compact [--keep N]` (DEBT-002)
 7. Push branch + tags — spawn vp-git-agent:
    ```
    Agent({ subagent_type: "vp-git-agent",