prizmkit 1.0.13 → 1.0.14

package/bin/create-prizmkit.js

@@ -28,11 +28,14 @@ program
   .command('install [directory]')
   .description('Install PrizmKit into a project directory')
   .option('--platform <platform>', 'Target platform: codebuddy, claude, or both')
-  .option('--skills <suite>', 'Skill suite: full, core, or minimal', 'full')
+  .option('--skills <suite>', 'Skill suite: full, core, minimal, or recommended:<type> (frontend/backend/fullstack/library)', 'full')
   .option('--team', 'Enable multi-agent team mode (default: true)')
   .option('--no-team', 'Disable multi-agent team mode')
   .option('--pipeline', 'Install dev-pipeline (default: true)')
   .option('--no-pipeline', 'Disable dev-pipeline')
+  .option('--rules <preset>', 'Rules preset: recommended, minimal, or none', 'recommended')
+  .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, claude-internal)')
+  .option('--external-skills <names>', 'Comma-separated external skill names to install (e.g. find-skill,uiuxpromax)')
   .option('--non-interactive', 'Skip interactive prompts (requires --platform)')
   .option('--dry-run', 'Show what would be created without making changes')
   .action(async (directory = '.', options) => {

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.13",
-  "bundledAt": "2026-03-13T01:34:34.833Z",
-  "bundledFrom": "cca8058"
+  "frameworkVersion": "1.0.14",
+  "bundledAt": "2026-03-15T11:21:10.029Z",
+  "bundledFrom": "94ac498"
 }

package/bundled/adapters/claude/command-adapter.js

@@ -15,6 +15,37 @@ import { existsSync, mkdirSync, cpSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
 import path from 'path';
 
+const TOOL_SHORTHANDS = new Set([
+  'tech_debt_tracker',
+  'bug_reproducer',
+  'adr_manager',
+  'security_audit',
+  'dependency_health',
+  'ci_cd_generator',
+  'deployment_strategy',
+  'db_migration',
+  'monitoring_setup',
+  'error_triage',
+  'log_analyzer',
+  'perf_profiler',
+  'onboarding_generator',
+  'api_doc_generator',
+]);
+
+function toClaudePrizmkitCommand(sub) {
+  const normalized = sub.replace(/_/g, '-');
+
+  if (sub.startsWith('tool_')) {
+    return `prizmkit-${normalized}`;
+  }
+
+  if (TOOL_SHORTHANDS.has(sub)) {
+    return `prizmkit-tool-${normalized}`;
+  }
+
+  return `prizmkit-${normalized}`;
+}
+
 /**
  * Convert a core SKILL.md to Claude Code command.md format.
  * @param {string} skillContent - Content of the core SKILL.md
@@ -27,7 +58,7 @@ export function convertSkillToCommand(skillContent, skillName) {
   // Claude Code command frontmatter only uses description
   // Also convert prizmkit.xxx references in the description field
   let desc = frontmatter.description || `PrizmKit ${skillName} command`;
-  desc = desc.replace(/prizmkit\.(\w+)/g, (_m, sub) => `/prizmkit-${sub.replace(/_/g, '-')}`);
+  desc = desc.replace(/prizmkit\.(\w+)/g, (_m, sub) => `/${toClaudePrizmkitCommand(sub)}`);
 
   const claudeFrontmatter = {
     description: desc,
@@ -53,9 +84,9 @@ export function convertSkillToCommand(skillContent, skillName) {
   // Replace prizmkit.xxx with /prizmkit-xxx for Claude Code
   convertedBody = convertedBody.replace(
     /prizmkit\.(\w+)/g,
-    (match, sub) => {
-      // Map common shorthand: prizmkit.init -> /prizmkit-init
-      const commandName = `prizmkit-${sub.replace(/_/g, '-')}`;
+    (_match, sub) => {
+      // Map shorthand references like prizmkit.tech_debt_tracker -> /prizmkit-tool-tech-debt-tracker
+      const commandName = toClaudePrizmkitCommand(sub);
       return `\`/${commandName}\``;
     }
   );

package/bundled/adapters/claude/rules-adapter.js

@@ -8,70 +8,18 @@ import { mkdirSync } from 'node:fs';
 import { writeFile } from 'node:fs/promises';
 import path from 'path';
 
-const RULES = [
-  {
-    filename: 'prizm-documentation.md',
-    content: `---
-description: "PrizmKit documentation rules"
-globs:
-  - "**/*.ts"
-  - "**/*.tsx"
-  - "**/*.js"
-  - "**/*.jsx"
-  - "**/*.py"
-  - "**/*.go"
-  - "**/*.rs"
-  - "**/*.java"
----
-
-When modifying source files in this project:
-1. Check if \`.prizm-docs/root.prizm\` exists
-2. If it does, read it before making changes to understand project structure
-3. After making changes, update affected \`.prizm-docs/\` files
-4. Follow the Prizm doc format (KEY: value, not prose)
-5. Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB
-`,
-  },
-  {
-    filename: 'prizm-commit-workflow.md',
-    content: `---
-description: "PrizmKit commit workflow rules"
----
-
-Before any git commit in this project:
-1. Update \`.prizm-docs/\` for affected modules
-2. Use Conventional Commits format: type(scope): description
-3. Bug fixes use \`fix()\` prefix, not \`feat()\`
-4. Do NOT create REGISTRY.md entries for bug fixes
-5. Use \`/prizmkit-committer\` command for the complete commit workflow
-`,
-  },
-  {
-    filename: 'prizm-progressive-loading.md',
-    content: `---
-description: "PrizmKit progressive context loading protocol"
----
-
-This project uses PrizmKit's progressive loading protocol:
-- ON SESSION START: Read \`.prizm-docs/root.prizm\` (L0 — project map)
-- ON TASK: Read L1 (\`.prizm-docs/<module>.prizm\`) for relevant modules
-- ON FILE EDIT: Read L2 (\`.prizm-docs/<module>/<submodule>.prizm\`) before modifying
-- NEVER load all .prizm docs at once
-- Arrow notation (->) in .prizm files indicates load pointers
-- DECISIONS and CHANGELOG in .prizm files are append-only
-`,
-  },
-];
-
 /**
  * Install PrizmKit rules to the target project's .claude/rules/ directory.
  * @param {string} targetRoot - Target project root
+ * @param {Array<{name: string, content: string}>} ruleFiles - Rules to install
  */
-export async function installRules(targetRoot) {
+export async function installRules(targetRoot, ruleFiles) {
   const rulesDir = path.join(targetRoot, '.claude', 'rules');
   mkdirSync(rulesDir, { recursive: true });
 
-  for (const rule of RULES) {
-    await writeFile(path.join(rulesDir, rule.filename), rule.content);
+  for (const rule of ruleFiles) {
+    // Use the basename (after /) as the filename
+    const baseName = rule.name.includes('/') ? rule.name.split('/').pop() : rule.name;
+    await writeFile(path.join(rulesDir, `${baseName}.md`), rule.content);
   }
 }

package/bundled/adapters/claude/team-adapter.js

@@ -15,8 +15,8 @@
  *   - 支持 shutdown 消息终止 teammate
  */
 
-import { mkdirSync, existsSync } from 'node:fs';
-import { writeFile, readFile } from 'node:fs/promises';
+import { mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
 import path from 'path';
 
 /**

package/bundled/adapters/codebuddy/agent-adapter.js

@@ -4,7 +4,6 @@
  * For CodeBuddy, this is mostly pass-through as the core format matches.
  */
 
-import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
 import { existsSync, mkdirSync } from 'node:fs';
 import { readFile, writeFile, symlink } from 'node:fs/promises';
 import path from 'path';

package/bundled/adapters/codebuddy/rules-adapter.js

@@ -0,0 +1,30 @@
+/**
+ * CodeBuddy Rules Adapter
+ * Installs .codebuddy/rules/*.mdc files for PrizmKit-enabled projects.
+ */
+import { mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import path from 'path';
+
+export async function installRules(targetRoot, ruleFiles) {
+  // ruleFiles: [{ name: 'prizm/prizm-documentation', content: '...' }, ...]
+  const rulesDir = path.join(targetRoot, '.codebuddy', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  for (const rule of ruleFiles) {
+    const mdcContent = convertToMdc(rule.content, rule.name);
+    // Use the basename (after /) as the filename
+    const baseName = rule.name.includes('/') ? rule.name.split('/').pop() : rule.name;
+    await writeFile(path.join(rulesDir, `${baseName}.mdc`), mdcContent);
+  }
+}
+
+function convertToMdc(mdContent, name) {
+  // Strip existing frontmatter from .md, build .mdc frontmatter
+  const bodyMatch = mdContent.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+  const descMatch = mdContent.match(/description:\s*"([^"]+)"/);
+  const body = bodyMatch ? bodyMatch[1] : mdContent;
+  const description = descMatch ? descMatch[1] : name;
+
+  return `---\ndescription: ${description}\nalwaysApply: true\nenabled: true\nupdatedAt: ${new Date().toISOString()}\nprovider: \n---\n${body}`;
+}

package/bundled/adapters/shared/frontmatter.js

@@ -38,9 +38,11 @@ export function parseFrontmatter(content) {
       value = value.slice(1, -1);
     }
 
-    // Parse numbers
+    // Parse numbers (integer or float)
     if (/^\d+$/.test(value)) {
       value = parseInt(value, 10);
+    } else if (/^\d+\.\d+$/.test(value)) {
+      value = parseFloat(value);
     }
 
     frontmatter[key] = value;

package/bundled/dev-pipeline/README.md

@@ -4,7 +4,7 @@ Autonomous development pipeline that drives the `prizm-dev-team` multi-agent tea
 
 ## Prerequisites
 
-- Python 3.6+
+- Python 3.8+
 - [jq](https://jqlang.github.io/jq/) (`brew install jq`)
 - AI CLI in PATH: CodeBuddy (`cbc`) or Claude Code (`claude`)
 - `feature-list.json` generated by the `app-planner` skill
@@ -31,13 +31,15 @@ python3 dev-pipeline/scripts/init-pipeline.py \
 
 | Command | Description |
 |---------|-------------|
-| `./run.sh run [feature-list.json]` | Start or resume the pipeline. Processes features sequentially by dependency order. |
+| `./run.sh run [feature-list.json] [options]` | Start or resume the pipeline. Processes features sequentially by dependency order. |
 | `./run.sh status [feature-list.json]` | Display current pipeline status: completed, pending, blocked, failed features. |
 | `./run.sh reset` | Clear all runtime state in `state/`. Pipeline starts fresh on next `run`. |
 | `./run.sh help` | Show usage help. |
 | `./retry-feature.sh <feature-id> [feature-list.json]` | Retry a single failed feature. Runs one session then exits. |
 | `./reset-feature.sh <feature-id> [--clean] [--run]` | Reset a feature to pending. `--clean` deletes artifacts, `--run` auto-retries. |
 
+`run.sh` 常用 options：`--resume-phase N`、`--max-retries N`、`--timeout SEC`、`--ai-cli CMD`、`--dry-run`、`--no-reset`。
+
 If `feature-list.json` path is omitted, defaults to `.dev-pipeline/feature-list.json` (run.sh) or `feature-list.json` (retry-feature.sh).
 
 ### Retrying a Failed Feature
@@ -95,8 +97,12 @@ What is always reset (with or without `--clean`):
 | `MAX_RETRIES` | `3` | Maximum retry attempts per feature before marking as failed. |
 | `SESSION_TIMEOUT` | `0` (no limit) | Timeout in seconds per AI CLI session. 0 = no timeout. |
 | `AI_CLI` | auto-detect | AI CLI command name. Auto-detects `cbc` or `claude`. Set to override. |
+| `CODEBUDDY_CLI` | (deprecated) | Legacy alias for `AI_CLI`. Prefer `AI_CLI`. |
 | `HEARTBEAT_INTERVAL` | `30` | Seconds between heartbeat log output while a session is running. |
 | `HEARTBEAT_STALE_THRESHOLD` | `600` | Seconds before a session is considered stale/stuck. |
+| `LOG_CLEANUP_ENABLED` | `1` | Run log cleanup before pipeline execution (`1`=enabled, `0`=disabled). |
+| `LOG_RETENTION_DAYS` | `14` | Delete logs older than N days. |
+| `LOG_MAX_TOTAL_MB` | `1024` | Keep total log size under N MB by deleting oldest logs first. |
 
 Example with custom config:
 
@@ -105,6 +111,9 @@ MAX_RETRIES=5 ./dev-pipeline/run.sh run feature-list.json
 
 # With 2-hour timeout per session
 SESSION_TIMEOUT=7200 ./dev-pipeline/run.sh run feature-list.json
+
+# Keep only recent logs and cap total log size
+LOG_RETENTION_DAYS=7 LOG_MAX_TOTAL_MB=512 ./dev-pipeline/run.sh run feature-list.json
 ```
 
 ## How It Works
@@ -215,6 +224,7 @@ cat dev-pipeline/state/features/F-003/sessions/F-003-*/logs/session.log | less
 
 - **Ctrl+C** during execution triggers graceful shutdown — current state is saved.
 - **Re-running** `./run.sh run feature-list.json` resumes from where it left off. Completed features are skipped.
+- 如需强制从某一阶段继续，可使用：`./run.sh run feature-list.json --resume-phase 6`（例如直接进入实现阶段）。
 
 ### Manual Intervention
 
@@ -422,7 +432,7 @@ run-bugfix.sh main loop
   │
   ├─ AI CLI session               # cbc --print -y < prompt (CBC)
   │   │                            # claude --print -p "$(cat prompt)" --yes (CC)
-  │   └─ prizmkit-bug-fix-workflow  # 5-phase pipeline
+  │   └─ bugfix 5-phase workflow
   │       ├─ Phase 1: Triage      (Dev agent: classify, assess impact, write fix-plan.md)
   │       ├─ Phase 2: Reproduce   (Dev agent: create failing reproduction test)
   │       ├─ Phase 3: Fix         (Dev agent: TDD — make reproduction test pass)

package/bundled/dev-pipeline/launch-bugfix-daemon.sh

@@ -134,6 +134,16 @@ cmd_start() {
     local start_time
     start_time=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
 
+    # Rotate log if over 50 MB
+    if [[ -f "$LOG_FILE" ]]; then
+        local log_bytes
+        log_bytes=$(wc -c < "$LOG_FILE" 2>/dev/null | tr -d ' ')
+        if [[ "$log_bytes" -gt 52428800 ]]; then
+            mv "$LOG_FILE" "${LOG_FILE}.$(date -u '+%Y%m%dT%H%M%S').bak"
+            log_info "Log rotated (was $((log_bytes / 1048576))MB): ${LOG_FILE}.bak"
+        fi
+    fi
+
     log_info "Launching bugfix pipeline..."
     log_info "Bug fix list: $bug_list"
     log_info "Log file: $LOG_FILE"

package/bundled/dev-pipeline/launch-daemon.sh

@@ -160,6 +160,16 @@ cmd_start() {
     local start_time
     start_time=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
 
+    # Rotate log if over 50 MB
+    if [[ -f "$LOG_FILE" ]]; then
+        local log_bytes
+        log_bytes=$(wc -c < "$LOG_FILE" 2>/dev/null | tr -d ' ')
+        if [[ "$log_bytes" -gt 52428800 ]]; then
+            mv "$LOG_FILE" "${LOG_FILE}.$(date -u '+%Y%m%dT%H%M%S').bak"
+            log_info "Log rotated (was $((log_bytes / 1048576))MB): ${LOG_FILE}.bak"
+        fi
+    fi
+
     # Launch run.sh in background, fully detached
     log_info "Launching pipeline..."
     log_info "Feature list: $feature_list"
@@ -190,10 +200,11 @@ cmd_start() {
     local pipeline_pid=$!
     disown "$pipeline_pid" 2>/dev/null || true
 
-    # Write PID file
-    echo "$pipeline_pid" > "$PID_FILE"
+    # Write PID file (atomic)
+    echo "$pipeline_pid" > "${PID_FILE}.tmp"
+    mv "${PID_FILE}.tmp" "$PID_FILE"
 
-    # Write start metadata
+    # Write start metadata (atomic)
     python3 -c "
 import json, sys, os
 pid, started_at, feature_list, env_overrides, log_file, state_dir = int(sys.argv[1]), sys.argv[2], sys.argv[3], sys.argv[4], sys.argv[5], sys.argv[6]
@@ -204,8 +215,11 @@ data = {
     'env_overrides': env_overrides,
     'log_file': log_file
 }
-with open(os.path.join(state_dir, '.pipeline-meta.json'), 'w') as f:
+target = os.path.join(state_dir, '.pipeline-meta.json')
+tmp = target + '.tmp'
+with open(tmp, 'w') as f:
     json.dump(data, f, indent=2)
+os.replace(tmp, target)
 " "$pipeline_pid" "$start_time" "$feature_list" "$env_overrides" "$LOG_FILE" "$STATE_DIR" 2>/dev/null || true
 
     # Wait briefly and verify

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

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# ============================================================
+# dev-pipeline/lib/common.sh - Shared shell helpers
+#
+# Shared by feature and bugfix pipeline runners.
+# Provides:
+#   - CLI/platform detection
+#   - Common color + log helpers
+#   - Common dependency checks
+# ============================================================
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+log_info()    { echo -e "${BLUE}[INFO]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_warn()    { echo -e "${YELLOW}[WARN]${NC}    $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_error()   { echo -e "${RED}[ERROR]${NC}   $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $(date '+%Y-%m-%d %H:%M:%S') $*"; }
+
+# Detect AI CLI + platform.
+# Priority:
+#   AI_CLI env > .prizmkit/config.json > CODEBUDDY_CLI > auto-detect(cbc/claude) > error
+#
+# Exports:
+#   CLI_CMD
+#   PLATFORM
+#   PRIZMKIT_PLATFORM
+prizm_detect_cli_and_platform() {
+    if [[ -n "${AI_CLI:-}" ]]; then
+        CLI_CMD="$AI_CLI"
+    # Read from .prizmkit/config.json if present
+    elif [[ -f ".prizmkit/config.json" ]]; then
+        _config_ai_cli=$(python3 -c "
+import json, sys
+try:
+    with open('.prizmkit/config.json') as f:
+        d = json.load(f)
+    v = d.get('ai_cli', '')
+    if v: print(v)
+except: pass
+" 2>/dev/null || true)
+        if [[ -n "$_config_ai_cli" ]]; then
+            CLI_CMD="$_config_ai_cli"
+        elif [[ -n "${CODEBUDDY_CLI:-}" ]]; then
+            CLI_CMD="$CODEBUDDY_CLI"
+        elif command -v cbc &>/dev/null; then
+            CLI_CMD="cbc"
+        elif command -v claude &>/dev/null; then
+            CLI_CMD="claude"
+        else
+            echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude)." >&2
+            exit 1
+        fi
+    elif [[ -n "${CODEBUDDY_CLI:-}" ]]; then
+        CLI_CMD="$CODEBUDDY_CLI"
+    elif command -v cbc &>/dev/null; then
+        CLI_CMD="cbc"
+    elif command -v claude &>/dev/null; then
+        CLI_CMD="claude"
+    else
+        echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude)." >&2
+        exit 1
+    fi
+
+    if [[ -n "${PRIZMKIT_PLATFORM:-}" ]]; then
+        PLATFORM="$PRIZMKIT_PLATFORM"
+    elif [[ "$CLI_CMD" == *"claude"* ]]; then
+        PLATFORM="claude"
+    else
+        PLATFORM="codebuddy"
+    fi
+
+    export CLI_CMD
+    export PLATFORM
+    export PRIZMKIT_PLATFORM="$PLATFORM"
+}
+
+# Common dependency check (jq + python3 + optional CLI in PATH)
+# Args:
+#   $1 - cli command (optional)
+prizm_check_common_dependencies() {
+    local cli_cmd="${1:-}"
+
+    if ! command -v jq &>/dev/null; then
+        log_error "jq is required but not installed. Install with: brew install jq"
+        exit 1
+    fi
+
+    if ! command -v python3 &>/dev/null; then
+        log_error "python3 is required but not installed."
+        exit 1
+    fi
+
+    if [[ -n "$cli_cmd" ]] && ! command -v "$cli_cmd" &>/dev/null; then
+        log_warn "AI CLI '$cli_cmd' not found in PATH."
+        log_warn "Set AI_CLI environment variable to the correct command."
+        log_warn "Continuing anyway (will fail when spawning sessions)..."
+    fi
+}