prizmkit 1.0.136 → 1.0.138

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.136",
-  "bundledAt": "2026-03-28T13:29:14.147Z",
-  "bundledFrom": "0e6a37f"
+  "frameworkVersion": "1.0.138",
+  "bundledAt": "2026-03-28T14:47:53.378Z",
+  "bundledFrom": "cc919b1"
 }

package/bundled/dev-pipeline/lib/common.sh

@@ -90,22 +90,27 @@ except: pass
 
 # prizm_detect_subagents <session_log>
 #
-# Scan session log for subagent spawns and log the result.
-# Uses grep -q for early exit on first match.
+# Scan session log for subagent spawns, count them, and log the result.
+# Sets _SUBAGENT_COUNT to the number of Agent tool calls detected.
 # Requires: USE_STREAM_JSON (from detect_stream_json_support)
+_SUBAGENT_COUNT=0
 prizm_detect_subagents() {
     local session_log="$1"
+    _SUBAGENT_COUNT=0
     [[ -f "$session_log" ]] || return 0
 
-    local has_subagent=false
+    local count=0
     if [[ "$USE_STREAM_JSON" == "true" ]]; then
-        grep -q '"name"[[:space:]]*:[[:space:]]*"Agent"' "$session_log" 2>/dev/null && has_subagent=true
+        count=$(grep -c '"name"[[:space:]]*:[[:space:]]*"Agent"' "$session_log" 2>/dev/null || echo "0")
     else
-        grep -qE '(Tool: Agent|"tool":\s*"Agent"|tool_use.*Agent|subagent_type)' "$session_log" 2>/dev/null && has_subagent=true
+        count=$(grep -cE '(Tool: Agent|"tool":\s*"Agent"|tool_use.*Agent|subagent_type)' "$session_log" 2>/dev/null || echo "0")
     fi
 
-    if [[ "$has_subagent" == true ]]; then
-        log_info "Subagent calls detected in session"
+    _SUBAGENT_COUNT=$count
+    if [[ "$count" -gt 0 ]]; then
+        log_info "Subagent calls detected in session: $count"
+    else
+        log_info "Subagent calls detected in session: 0 (single-agent mode)"
     fi
 }
 

package/bundled/dev-pipeline/run-bugfix.sh

@@ -599,6 +599,7 @@ main() {
     fi
 
     local session_count=0
+    local total_subagent_calls=0
 
     while true; do
         # Find next bug to process
@@ -614,6 +615,7 @@ main() {
             log_success "════════════════════════════════════════════════════"
             log_success "  All bugs processed! Bug fix pipeline finished."
             log_success "  Total sessions: $session_count"
+            log_success "  Total subagent calls: $total_subagent_calls"
             log_success "════════════════════════════════════════════════════"
 
             # Merge dev branch back to original
@@ -672,6 +674,10 @@ main() {
             --state-dir "$STATE_DIR" \
             --output "$bootstrap_prompt" >/dev/null 2>&1
 
+        # Log agent configuration (bugfix always uses dual-agent: Orchestrator + Dev + Reviewer)
+        log_info "Pipeline mode: ${BOLD}standard${NC} (Dual Agent — Orchestrator + Dev + Reviewer)"
+        log_info "Agents: 3 (critic: disabled)"
+
         # Spawn session
         log_info "Spawning AI CLI session: $session_id"
         _SPAWN_RESULT=""
@@ -681,6 +687,7 @@ main() {
             "$bootstrap_prompt" "$session_dir" "$MAX_RETRIES" "$_ORIGINAL_BRANCH"
 
         session_count=$((session_count + 1))
+        total_subagent_calls=$((total_subagent_calls + _SUBAGENT_COUNT))
 
         log_info "Pausing 5s before next bug..."
         sleep 5

package/bundled/dev-pipeline/run.sh

@@ -647,8 +647,11 @@ sys.exit(1)
         log_error "Failed to generate bootstrap prompt for $feature_id"
         return 1
     }
-    local feature_model
+    local feature_model pipeline_mode agent_count critic_enabled
     feature_model=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('model',''))" 2>/dev/null || echo "")
+    pipeline_mode=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('pipeline_mode','lite'))" 2>/dev/null || echo "lite")
+    agent_count=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('agent_count',1))" 2>/dev/null || echo "1")
+    critic_enabled=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('critic_enabled','false'))" 2>/dev/null || echo "false")
 
     # Dry-Run: Print info and exit
     if [[ "$dry_run" == true ]]; then
@@ -664,6 +667,8 @@ sys.exit(1)
         else
             log_info "Mode:          auto-detect (from complexity)"
         fi
+        log_info "Pipeline mode: $pipeline_mode"
+        log_info "Agents:        $agent_count (critic: $([ "$critic_enabled" = "true" ] && echo "enabled" || echo "disabled"))"
         if [[ -n "$feature_model" ]]; then
             log_info "Feature Model: $feature_model"
         elif [[ -n "${MODEL:-}" ]]; then
@@ -707,6 +712,15 @@ sys.exit(1)
     if [[ -n "$mode_override" ]]; then
         log_info "Mode Override: $mode_override"
     fi
+    local _run_one_mode_desc
+    case "$pipeline_mode" in
+        lite)     _run_one_mode_desc="Tier 1 — Single Agent" ;;
+        standard) _run_one_mode_desc="Tier 2 — Orchestrator + Dev + Reviewer" ;;
+        full)     _run_one_mode_desc="Tier 3 — Full Team (+ Multi-Critic)" ;;
+        *)        _run_one_mode_desc="$pipeline_mode" ;;
+    esac
+    log_info "Pipeline mode: ${BOLD}$pipeline_mode${NC} ($_run_one_mode_desc)"
+    log_info "Agents: $agent_count (critic: $([ "$critic_enabled" = "true" ] && echo "enabled" || echo "disabled"))"
     if [[ $SESSION_TIMEOUT -gt 0 ]]; then
         log_info "Session timeout: ${SESSION_TIMEOUT}s"
     else
@@ -881,6 +895,7 @@ main() {
 
     # Main processing loop
     local session_count=0
+    local total_subagent_calls=0
 
     while true; do
         # Check for stuck features
@@ -923,6 +938,7 @@ for f in data.get('stuck_features', []):
             log_success "════════════════════════════════════════════════════"
             log_success "  All features completed! Pipeline finished."
             log_success "  Total sessions: $session_count"
+            log_success "  Total subagent calls: $total_subagent_calls"
             log_success "════════════════════════════════════════════════════"
             break
         fi
@@ -999,8 +1015,22 @@ for f in data.get('stuck_features', []):
             log_error "Failed to generate bootstrap prompt for $feature_id"
             continue
         }
-        local feature_model
+        local feature_model pipeline_mode agent_count critic_enabled
         feature_model=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('model',''))" 2>/dev/null || echo "")
+        pipeline_mode=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('pipeline_mode','lite'))" 2>/dev/null || echo "lite")
+        agent_count=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('agent_count',1))" 2>/dev/null || echo "1")
+        critic_enabled=$(echo "$gen_output" | python3 -c "import json,sys; print(json.load(sys.stdin).get('critic_enabled','false'))" 2>/dev/null || echo "false")
+
+        # Log pipeline mode and agent configuration
+        local _mode_desc
+        case "$pipeline_mode" in
+            lite)     _mode_desc="Tier 1 — Single Agent" ;;
+            standard) _mode_desc="Tier 2 — Orchestrator + Dev + Reviewer" ;;
+            full)     _mode_desc="Tier 3 — Full Team (+ Multi-Critic)" ;;
+            *)        _mode_desc="$pipeline_mode" ;;
+        esac
+        log_info "Pipeline mode: ${BOLD}$pipeline_mode${NC} ($_mode_desc)"
+        log_info "Agents: $agent_count (critic: $([ "$critic_enabled" = "true" ] && echo "enabled" || echo "disabled"))"
 
         # Mark feature as in-progress before spawning session
         python3 "$SCRIPTS_DIR/update-feature-status.py" \
@@ -1042,6 +1072,7 @@ for f in data.get('stuck_features', []):
         fi
 
         session_count=$((session_count + 1))
+        total_subagent_calls=$((total_subagent_calls + _SUBAGENT_COUNT))
 
         # Brief pause before next iteration
         log_info "Pausing 5s before next feature..."

package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py

@@ -723,10 +723,22 @@ def main():
 
     # Success
     feature_model = feature.get("model", "")
+    pipeline_mode = replacements.get("{{PIPELINE_MODE}}", "lite")
+    critic_enabled = replacements.get("{{CRITIC_ENABLED}}", "false") == "true"
+    # Map mode to agent count for logging
+    # lite=1 (single agent), standard/full=3 (orchestrator + dev + reviewer)
+    mode_agent_counts = {"lite": 1, "standard": 3, "full": 3}
+    agent_count = mode_agent_counts.get(pipeline_mode, 1)
+    critic_count_val = int(replacements.get("{{CRITIC_COUNT}}", "1"))
+    if critic_enabled:
+        agent_count += critic_count_val
     output = {
         "success": True,
         "output_path": os.path.abspath(args.output),
         "model": feature_model,
+        "pipeline_mode": pipeline_mode,
+        "agent_count": agent_count,
+        "critic_enabled": "true" if critic_enabled else "false",
     }
     print(json.dumps(output, indent=2, ensure_ascii=False))
     sys.exit(0)

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.136",
+  "version": "1.0.138",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.0.136",
+  "version": "1.0.138",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/manifest.js

@@ -55,6 +55,7 @@ export async function writeManifest(projectRoot, data) {
  * @param {boolean} params.team - whether team config was installed
  * @param {string} [params.aiCli] - AI CLI command
  * @param {string} [params.rulesPreset] - rules preset name
+ * @param {string[]} [params.extras] - installed extras (e.g. ['playwright-cli'])
  * @returns {Object} manifest
  */
 export function buildManifest({
@@ -68,6 +69,7 @@ export function buildManifest({
   team,
   aiCli,
   rulesPreset,
+  extras,
 }) {
   const now = new Date().toISOString();
   return {
@@ -87,6 +89,7 @@ export function buildManifest({
       agents: [...agents],
       rules: [...rules],
       pipeline: pipeline ? [...pipeline] : [],
+      extras: extras ? [...extras] : [],
       other: [platform === 'claude' ? 'CLAUDE.md' : platform === 'codebuddy' ? 'CODEBUDDY.md' : 'CLAUDE.md'],
     },
   };
@@ -96,7 +99,7 @@ export function buildManifest({
  * Diff two manifests and return added/removed items.
  * @param {Object} oldManifest - previous manifest
  * @param {Object} newManifest - new manifest to compare against
- * @returns {Object} { skills: {added, removed}, agents: {added, removed}, rules: {added, removed} }
+ * @returns {Object} { skills: {added, removed}, agents: {added, removed}, rules: {added, removed}, pipeline: {added, removed}, extras: {added, removed} }
  */
 export function diffManifest(oldManifest, newManifest) {
   function diffArrays(oldArr, newArr) {
@@ -116,5 +119,6 @@ export function diffManifest(oldManifest, newManifest) {
       Array.isArray(oldManifest?.files?.pipeline) ? oldManifest.files.pipeline : [],
       Array.isArray(newManifest?.files?.pipeline) ? newManifest.files.pipeline : [],
     ),
+    extras: diffArrays(oldManifest?.files?.extras, newManifest?.files?.extras),
   };
 }

package/src/scaffold.js

@@ -676,6 +676,7 @@ export async function installPipeline(projectRoot, dryRun, { forceOverwrite = fa
  */
 export async function installGitignore(projectRoot, options, dryRun) {
   const targetPath = path.join(projectRoot, '.gitignore');
+  const templateContent = generateGitignore({ pipeline: options.pipeline });
 
   if (dryRun) {
     console.log(chalk.gray(`      [dry-run] .gitignore`));
@@ -683,12 +684,23 @@ export async function installGitignore(projectRoot, options, dryRun) {
   }
 
   if (await fs.pathExists(targetPath)) {
-    console.log(chalk.yellow(`      ⚠ .gitignore 已存在，跳过`));
-    return;
+    // 合并模式：追加缺失条目
+    const existing = await fs.readFile(targetPath, 'utf-8');
+    const existingLines = new Set(existing.split('\n').map(l => l.trim()));
+    const templateLines = templateContent.split('\n').map(l => l.trim()).filter(Boolean);
+    const missing = templateLines.filter(line => !existingLines.has(line) && !line.startsWith('#'));
+
+    if (missing.length > 0) {
+      const separator = existing.endsWith('\n') ? '' : '\n';
+      const header = existingLines.has('# PrizmKit') ? '' : '# PrizmKit\n';
+      await fs.appendFile(targetPath, separator + '\n' + header + missing.join('\n') + '\n');
+      console.log(chalk.green(`      ✓ .gitignore (added ${missing.length} entries)`));
+    } else {
+      console.log(chalk.green('      ✓ .gitignore (up-to-date)'));
+    }
   } else {
-    const content = generateGitignore({ pipeline: options.pipeline });
-    await fs.writeFile(targetPath, content);
-    console.log(chalk.green(`      ✓ .gitignore`));
+    await fs.writeFile(targetPath, templateContent);
+    console.log(chalk.green('      ✓ .gitignore'));
   }
 }
 
@@ -733,6 +745,21 @@ export async function installPlaywrightCli(projectRoot, dryRun) {
   }
 }
 
+// ============================================================
+// Extras 注册表
+// ============================================================
+
+/**
+ * 外部工具注册表。upgrade.js 遍历此表来安装/更新外部工具。
+ * 新增工具只需：1) 写 installXxx 函数  2) 加一行到此表
+ */
+export const EXTRAS_REGISTRY = {
+  'playwright-cli': {
+    label: '浏览器交互工具',
+    install: installPlaywrightCli,
+  },
+};
+
 // ============================================================
 // 主安装函数
 // ============================================================
@@ -846,9 +873,11 @@ export async function scaffold(config) {
     }
   }
 
-  // 10. Playwright CLI (optional)
+  // 10. Extras (external tools via registry)
+  const activeExtras = [];
   if (playwrightCli) {
-    console.log(chalk.blue('    浏览器交互工具:'));
+    activeExtras.push('playwright-cli');
+    console.log(chalk.blue(`    ${EXTRAS_REGISTRY['playwright-cli'].label}:`));
     await installPlaywrightCli(projectRoot, dryRun);
     console.log('');
   }
@@ -866,15 +895,15 @@ export async function scaffold(config) {
     }
   }
 
-  // 11. Git pre-commit hook
+  // 12. Git pre-commit hook
   console.log(chalk.blue('    Git Hook:'));
   await installGitHook(projectRoot, dryRun);
 
-  // 12. PrizmKit scripts (always installed)
+  // 13. PrizmKit scripts (always installed)
   console.log(chalk.blue('    PrizmKit 脚本:'));
   await installPrizmkitScripts(projectRoot, dryRun);
 
-  // 13. Write installation manifest
+  // 14. Write installation manifest
   if (!dryRun) {
     const agentsDir = getAgentsDir();
     const agentFileNames = (await fs.readdir(agentsDir)).filter(f => f.endsWith('.md'));
@@ -894,6 +923,7 @@ export async function scaffold(config) {
       team,
       aiCli,
       rulesPreset: rulesPresetName,
+      extras: activeExtras,
     });
     await writeManifest(projectRoot, manifest);
     console.log(chalk.green('      ✓ .prizmkit/manifest.json'));

package/src/upgrade.js

@@ -30,6 +30,7 @@ import {
   installGitignore,
   installProjectMemory,
   resolvePipelineFileList,
+  EXTRAS_REGISTRY,
 } from './scaffold.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -244,6 +245,13 @@ export async function runUpgrade(directory, options = {}) {
   // Resolve pipeline file list from source (for manifest diff)
   const newPipelineFiles = pipeline ? resolvePipelineFileList() : [];
 
+  // Resolve extras: merge old manifest extras + default extras for old manifests without the field
+  const extrasToInstall = [...new Set([
+    ...(oldManifest?.files?.extras || []),
+    // Old manifests without extras field: default to all registered extras
+    ...(!oldManifest?.files?.extras ? Object.keys(EXTRAS_REGISTRY) : []),
+  ])].filter(name => EXTRAS_REGISTRY[name]);  // only keep extras that still exist in registry
+
   // 4. Build new manifest and compute diff
   const newManifest = buildManifest({
     version: pkg.version,
@@ -256,6 +264,7 @@ export async function runUpgrade(directory, options = {}) {
     team,
     aiCli,
     rulesPreset,
+    extras: extrasToInstall,
   });
 
   // Preserve original installedAt
@@ -263,7 +272,7 @@ export async function runUpgrade(directory, options = {}) {
     newManifest.installedAt = oldManifest.installedAt;
   }
 
-  const diff = oldManifest ? diffManifest(oldManifest, newManifest) : { skills: { added: [], removed: [] }, agents: { added: [], removed: [] }, rules: { added: [], removed: [] }, pipeline: { added: [], removed: [] } };
+  const diff = oldManifest ? diffManifest(oldManifest, newManifest) : { skills: { added: [], removed: [] }, agents: { added: [], removed: [] }, rules: { added: [], removed: [] }, pipeline: { added: [], removed: [] }, extras: { added: [], removed: [] } };
 
   // 5. Display upgrade summary
   const oldVersion = oldManifest?.version || 'unknown';
@@ -273,8 +282,8 @@ export async function runUpgrade(directory, options = {}) {
   console.log(`    Suite: ${suite}`);
   console.log('');
 
-  const totalAdded = diff.skills.added.length + diff.agents.added.length + diff.rules.added.length + diff.pipeline.added.length;
-  const totalRemoved = diff.skills.removed.length + diff.agents.removed.length + diff.rules.removed.length + diff.pipeline.removed.length;
+  const totalAdded = diff.skills.added.length + diff.agents.added.length + diff.rules.added.length + diff.pipeline.added.length + diff.extras.added.length;
+  const totalRemoved = diff.skills.removed.length + diff.agents.removed.length + diff.rules.removed.length + diff.pipeline.removed.length + diff.extras.removed.length;
   const totalUpdated = newSkillList.length + newAgentFiles.length + newRuleFiles.length;
 
   if (diff.skills.added.length) console.log(chalk.green(`    + Skills added: ${diff.skills.added.join(', ')}`));
@@ -285,6 +294,8 @@ export async function runUpgrade(directory, options = {}) {
   if (diff.rules.removed.length) console.log(chalk.red(`    - Rules removed: ${diff.rules.removed.join(', ')}`));
   if (diff.pipeline.added.length) console.log(chalk.green(`    + Pipeline files added: ${diff.pipeline.added.length} file(s)`));
   if (diff.pipeline.removed.length) console.log(chalk.red(`    - Pipeline files removed: ${diff.pipeline.removed.length} file(s)`));
+  if (diff.extras.added.length) console.log(chalk.green(`    + Extras added: ${diff.extras.added.join(', ')}`));
+  if (diff.extras.removed.length) console.log(chalk.red(`    - Extras removed: ${diff.extras.removed.join(', ')}`));
 
   if (totalAdded === 0 && totalRemoved === 0 && oldVersion === pkg.version) {
     console.log(chalk.gray('    No changes detected. Re-installing all files to ensure consistency.'));
@@ -360,6 +371,17 @@ export async function runUpgrade(directory, options = {}) {
     console.log('');
   }
 
+  // Extras (external tools via registry)
+  if (extrasToInstall.length > 0) {
+    for (const extraName of extrasToInstall) {
+      const entry = EXTRAS_REGISTRY[extraName];
+      if (!entry) continue;
+      console.log(chalk.blue(`    ${entry.label}:`));
+      await entry.install(projectRoot, dryRun);
+      console.log('');
+    }
+  }
+
   // Git hook
   console.log(chalk.blue('    Git Hook:'));
   await installGitHook(projectRoot, dryRun);