prizmkit 1.0.3 → 1.0.4

package/bin/create-prizmkit.js

@@ -9,14 +9,20 @@
  *   npx prizmkit uninstall . --dry-run
  */
 
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import { runScaffold } from '../src/index.js';
 import { runClean } from '../src/clean.js';
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+
 program
   .name('prizmkit')
   .description('PrizmKit project installer/uninstaller')
-  .version('1.0.0');
+  .version(pkg.version);
 
 program
   .command('install [directory]')

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.0",
-  "bundledAt": "2026-03-10T01:40:43.750Z",
-  "bundledFrom": "/Users/loneyu/SelfProjects/PrizmKitEvolvingProgramming"
+  "frameworkVersion": "1.0.4",
+  "bundledAt": "2026-03-11T11:34:52.898Z",
+  "bundledFrom": "85fad5e"
 }

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

@@ -11,20 +11,11 @@
  */
 
 import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
+import { TOOL_MAPPING } from '../shared/constants.js';
 import { mkdirSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
 import path from 'path';
 
-// Tool name mapping from CodeBuddy to Claude Code
-// Claude Code 原生 Agent Teams 支持 SendMessage 工具进行 teammate 间通信
-const TOOL_MAPPING = {
-  'TaskCreate': 'Task',
-  'TaskGet': 'Task',
-  'TaskUpdate': 'Task',
-  'TaskList': 'Task',
-  'SendMessage': 'SendMessage',
-};
-
 // Default model for Claude Code agents
 const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
 

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

@@ -25,8 +25,12 @@ export function convertSkillToCommand(skillContent, skillName) {
   const { frontmatter, body } = parseFrontmatter(skillContent);
 
   // 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, '-')}`);
+
   const claudeFrontmatter = {
-    description: frontmatter.description || `PrizmKit ${skillName} command`,
+    description: desc,
   };
 
   // Rewrite ${SKILL_DIR} references to use relative path from .claude/commands/<name>/

package/bundled/adapters/claude/paths.js

@@ -20,8 +20,7 @@ export const GLOBAL_AGENTS_DIR = '.claude/agents';
 // Command file conventions (equivalent to skills)
 // Note: Actual command files are named <skill-name>.md (e.g. prizmkit-specify.md)
 // Directory-based commands with assets also use <skill-name>.md inside the directory.
-export const COMMAND_DEFINITION_FILE = '<skill-name>.md';
-export const COMMAND_DIR_VAR = '${COMMAND_DIR}';     // May not be natively supported
+// Claude Code does not have a native ${COMMAND_DIR} variable equivalent.
 
 // Agent definition format
 export const AGENT_FILE_EXT = '.md';

package/bundled/adapters/shared/constants.js

@@ -0,0 +1,13 @@
+/**
+ * Shared constants for PrizmKit adapters.
+ */
+
+// Tool name mapping from CodeBuddy to Claude Code
+// Claude Code 原生 Agent Teams 支持 SendMessage 工具进行 teammate 间通信
+export const TOOL_MAPPING = {
+  'TaskCreate': 'Task',
+  'TaskGet': 'Task',
+  'TaskUpdate': 'Task',
+  'TaskList': 'Task',
+  'SendMessage': 'SendMessage',
+};

package/bundled/adapters/shared/frontmatter.js

@@ -5,6 +5,9 @@
 
 /**
  * Parse YAML frontmatter from a markdown file content string.
+ * LIMITATION: Only supports flat key: value pairs. Does not support
+ * YAML arrays, nested objects, or multi-line values. For complex YAML
+ * needs, consider using a full YAML parser library.
  * @param {string} content - Full file content with optional frontmatter
  * @returns {{ frontmatter: Object, body: string }}
  */

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

@@ -191,18 +191,18 @@ cmd_start() {
 
     # Write start metadata
     python3 -c "
-import json
-from datetime import datetime
+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]
 data = {
-    'pid': $pipeline_pid,
-    'started_at': '$start_time',
-    'feature_list': '$feature_list',
-    'env_overrides': '$env_overrides',
-    'log_file': '$LOG_FILE'
+    'pid': pid,
+    'started_at': started_at,
+    'feature_list': feature_list,
+    'env_overrides': env_overrides,
+    'log_file': log_file
 }
-with open('$STATE_DIR/.pipeline-meta.json', 'w') as f:
+with open(os.path.join(state_dir, '.pipeline-meta.json'), 'w') as f:
     json.dump(data, f, indent=2)
-" 2>/dev/null || true
+" "$pipeline_pid" "$start_time" "$feature_list" "$env_overrides" "$LOG_FILE" "$STATE_DIR" 2>/dev/null || true
 
     # Wait briefly and verify
     sleep 2
@@ -304,10 +304,10 @@ cmd_status() {
         if [[ -f "$STATE_DIR/.pipeline-meta.json" ]]; then
             local last_feature_list
             last_feature_list=$(python3 -c "
-import json
-with open('$STATE_DIR/.pipeline-meta.json') as f:
+import json, sys
+with open(sys.argv[1]) as f:
     print(json.load(f).get('feature_list', ''))
-" 2>/dev/null || echo "")
+" "$STATE_DIR/.pipeline-meta.json" 2>/dev/null || echo "")
 
             if [[ -n "$last_feature_list" && -f "$last_feature_list" ]]; then
                 echo "" >&2
@@ -339,15 +339,15 @@ with open('$STATE_DIR/.pipeline-meta.json') as f:
     local feature_list_path=""
     if [[ -f "$STATE_DIR/.pipeline-meta.json" ]]; then
         started_at=$(python3 -c "
-import json
-with open('$STATE_DIR/.pipeline-meta.json') as f:
+import json, sys
+with open(sys.argv[1]) as f:
     print(json.load(f).get('started_at', ''))
-" 2>/dev/null || echo "")
+" "$STATE_DIR/.pipeline-meta.json" 2>/dev/null || echo "")
         feature_list_path=$(python3 -c "
-import json
-with open('$STATE_DIR/.pipeline-meta.json') as f:
+import json, sys
+with open(sys.argv[1]) as f:
     print(json.load(f).get('feature_list', ''))
-" 2>/dev/null || echo "")
+" "$STATE_DIR/.pipeline-meta.json" 2>/dev/null || echo "")
     fi
 
     log_success "Pipeline is running (PID: $pid)"
@@ -381,20 +381,19 @@ with open('$STATE_DIR/.pipeline-meta.json') as f:
     if [[ -n "$feature_list_path" && -f "$feature_list_path" ]]; then
         progress_json=$(python3 -c "
 import json, sys, os
-sys.path.insert(0, '$SCRIPT_DIR/scripts')
-from datetime import datetime
 
 def load_json(p):
     with open(p, 'r') as f:
         return json.load(f)
 
-fl = load_json('$feature_list_path')
+feature_list_path, state_dir = sys.argv[1], sys.argv[2]
+fl = load_json(feature_list_path)
 features = fl.get('features', [])
 total = len(features)
 counts = {'completed': 0, 'in_progress': 0, 'failed': 0, 'pending': 0, 'skipped': 0}
 for feat in features:
     fid = feat.get('id', '')
-    sp = os.path.join('$STATE_DIR', 'features', fid, 'status.json')
+    sp = os.path.join(state_dir, 'features', fid, 'status.json')
     if os.path.isfile(sp):
         fs = load_json(sp)
         st = fs.get('status', 'pending')
@@ -414,7 +413,7 @@ print(json.dumps({
     'pending': counts['pending'],
     'percent': pct
 }))
-" 2>/dev/null || echo "")
+" "$feature_list_path" "$STATE_DIR" 2>/dev/null || echo "")
     fi
 
     if [[ -n "$progress_json" ]]; then

package/bundled/dev-pipeline/run.sh

@@ -402,14 +402,15 @@ run_one() {
     local feature_title
     feature_title=$(python3 -c "
 import json, sys
-with open('$feature_list') as f:
+feature_list_path, fid = sys.argv[1], sys.argv[2]
+with open(feature_list_path) as f:
     data = json.load(f)
 for feat in data.get('features', []):
-    if feat.get('id') == '$feature_id':
+    if feat.get('id') == fid:
         print(feat.get('title', ''))
         sys.exit(0)
 sys.exit(1)
-" 2>/dev/null) || {
+" "$feature_list" "$feature_id" 2>/dev/null) || {
         log_error "Feature $feature_id not found in $feature_list"
         exit 1
     }
@@ -424,19 +425,20 @@ sys.exit(1)
             local feature_slug
             feature_slug=$(python3 -c "
 import json, re, sys
-with open('$feature_list') as f:
+feature_list_path, fid = sys.argv[1], sys.argv[2]
+with open(feature_list_path) as f:
     data = json.load(f)
 for feat in data.get('features', []):
-    if feat.get('id') == '$feature_id':
-        fid = feat['id'].replace('F-', '').replace('f-', '').zfill(3)
+    if feat.get('id') == fid:
+        fnum = feat['id'].replace('F-', '').replace('f-', '').zfill(3)
         title = feat.get('title', '').lower()
         title = re.sub(r'[^a-z0-9\s-]', '', title)
         title = re.sub(r'[\s]+', '-', title.strip())
         title = re.sub(r'-+', '-', title).strip('-')
-        print(f'{fid}-{title}')
+        print(f'{fnum}-{title}')
         sys.exit(0)
 sys.exit(1)
-" 2>/dev/null) || {
+" "$feature_list" "$feature_id" 2>/dev/null) || {
                 log_warn "Could not determine feature slug for cleanup"
                 feature_slug=""
             }
@@ -741,16 +743,17 @@ for f in data.get('stuck_features', []):
 
         # Update current session tracking
         python3 -c "
-import json, sys
+import json, sys, os
 from datetime import datetime
+feature_id, session_id, state_dir = sys.argv[1], sys.argv[2], sys.argv[3]
 data = {
-    'feature_id': '$feature_id',
-    'session_id': '$session_id',
+    'feature_id': feature_id,
+    'session_id': session_id,
     'started_at': datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')
 }
-with open('$STATE_DIR/current-session.json', 'w') as f:
+with open(os.path.join(state_dir, 'current-session.json'), 'w') as f:
     json.dump(data, f, indent=2)
-"
+" "$feature_id" "$session_id" "$STATE_DIR"
 
         # Spawn session and wait
         log_info "Spawning AI CLI session: $session_id"

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

@@ -19,6 +19,8 @@ import os
 import re
 import sys
 
+from utils import load_json_file
+
 
 DEFAULT_MAX_RETRIES = 3
 
@@ -87,21 +89,6 @@ def parse_args():
     return parser.parse_args()
 
 
-def load_json_file(path):
-    """Load and return parsed JSON from a file."""
-    abs_path = os.path.abspath(path)
-    if not os.path.isfile(abs_path):
-        return None, "File not found: {}".format(abs_path)
-    try:
-        with open(abs_path, "r", encoding="utf-8") as f:
-            data = json.load(f)
-    except json.JSONDecodeError as e:
-        return None, "Invalid JSON: {}".format(str(e))
-    except IOError as e:
-        return None, "Cannot read file: {}".format(str(e))
-    return data, None
-
-
 def read_text_file(path):
     """Read and return the text content of a file."""
     abs_path = os.path.abspath(path)

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

@@ -19,6 +19,8 @@ import os
 import re
 import sys
 
+from utils import load_json_file
+
 
 DEFAULT_MAX_RETRIES = 3
 
@@ -42,21 +44,6 @@ def parse_args():
     return parser.parse_args()
 
 
-def load_json_file(path):
-    """Load and return parsed JSON from a file."""
-    abs_path = os.path.abspath(path)
-    if not os.path.isfile(abs_path):
-        return None, "File not found: {}".format(abs_path)
-    try:
-        with open(abs_path, "r", encoding="utf-8") as f:
-            data = json.load(f)
-    except json.JSONDecodeError as e:
-        return None, "Invalid JSON: {}".format(str(e))
-    except IOError as e:
-        return None, "Cannot read file: {}".format(str(e))
-    return data, None
-
-
 def read_text_file(path):
     """Read and return the text content of a file."""
     abs_path = os.path.abspath(path)
@@ -238,9 +225,8 @@ def build_replacements(args, bug, global_context, script_dir):
     else:
         fix_scope = bug.get("title", "unknown").split()[0].lower() if bug.get("title") else "unknown"
 
-    # Determine if manual/hybrid verification
+    # Determine verification type
     vtype = bug.get("verification_type", "automated")
-    is_manual_or_hybrid = vtype in ("manual", "hybrid")
 
     replacements = {
         "{{RUN_ID}}": args.run_id,

package/bundled/dev-pipeline/scripts/init-dev-team.py

@@ -51,21 +51,21 @@ def create_directories(project_root, feature_slug=None):
         dirs_to_create.extend([
             ".prizmkit/specs",
         ])
-    
+
     created = []
     for dir_path in dirs_to_create:
         full_path = os.path.join(project_root, dir_path)
         if not os.path.exists(full_path):
             os.makedirs(full_path, exist_ok=True)
             created.append(dir_path)
-    
+
     return created
 
 
 def init_prizmkit_config(project_root, feature_id):
     """Initialize or update .prizmkit/config.json."""
     config_path = os.path.join(project_root, ".prizmkit", "config.json")
-    
+
     if os.path.exists(config_path):
         # Update existing config
         with open(config_path, "r", encoding="utf-8") as f:
@@ -84,7 +84,7 @@ def init_prizmkit_config(project_root, feature_id):
                     project_name = pkg.get("name", project_name)
             except (json.JSONDecodeError, IOError):
                 pass
-        
+
         config = {
             "adoption_mode": "active",
             "speckit_hooks_enabled": True,
@@ -93,17 +93,17 @@ def init_prizmkit_config(project_root, feature_id):
             "feature_prefix": "F-",
             "current_feature": feature_id,
         }
-    
+
     with open(config_path, "w", encoding="utf-8") as f:
         json.dump(config, f, indent=2)
-    
+
     return config_path
 
 
 def main():
     args = parse_args()
     project_root = os.path.abspath(args.project_root)
-    
+
     if not os.path.isdir(project_root):
         result = {
             "success": False,
@@ -111,13 +111,13 @@ def main():
         }
         print(json.dumps(result, indent=2))
         sys.exit(1)
-    
+
     # Create directories
     created_dirs = create_directories(project_root, args.feature_slug)
-    
+
     # Initialize config
     config_path = init_prizmkit_config(project_root, args.feature_id)
-    
+
     result = {
         "success": True,
         "project_root": project_root,
@@ -125,7 +125,7 @@ def main():
         "directories_created": created_dirs,
         "config_path": config_path,
     }
-    
+
     print(json.dumps(result, indent=2))
     sys.exit(0)
 

package/bundled/dev-pipeline/scripts/update-bug-status.py

@@ -21,9 +21,16 @@ import argparse
 import json
 import os
 import shutil
-import sys
 from datetime import datetime, timezone
 
+from utils import (
+    load_json_file,
+    write_json_file,
+    error_out,
+    pad_right,
+    _build_progress_bar,
+)
+
 
 SESSION_STATUS_VALUES = [
     "success",
@@ -71,37 +78,6 @@ def now_iso():
     return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
 
 
-def load_json_file(path):
-    abs_path = os.path.abspath(path)
-    if not os.path.isfile(abs_path):
-        return None, "File not found: {}".format(abs_path)
-    try:
-        with open(abs_path, "r", encoding="utf-8") as f:
-            data = json.load(f)
-    except json.JSONDecodeError as e:
-        return None, "Invalid JSON: {}".format(str(e))
-    except IOError as e:
-        return None, "Cannot read file: {}".format(str(e))
-    return data, None
-
-
-def write_json_file(path, data):
-    abs_path = os.path.abspath(path)
-    parent = os.path.dirname(abs_path)
-    if parent and not os.path.isdir(parent):
-        try:
-            os.makedirs(parent, exist_ok=True)
-        except OSError as e:
-            return "Cannot create directory: {}".format(str(e))
-    try:
-        with open(abs_path, "w", encoding="utf-8") as f:
-            json.dump(data, f, indent=2, ensure_ascii=False)
-            f.write("\n")
-    except IOError as e:
-        return "Cannot write file: {}".format(str(e))
-    return None
-
-
 def load_bug_status(state_dir, bug_id):
     status_path = os.path.join(state_dir, "bugs", bug_id, "status.json")
     if not os.path.isfile(status_path):
@@ -403,31 +379,6 @@ COLOR_RESET = "\033[0m"
 BOX_WIDTH = 68
 
 
-def pad_right(text, width):
-    visible = text
-    i = 0
-    visible_len = 0
-    while i < len(text):
-        if text[i] == "\033":
-            while i < len(text) and text[i] != "m":
-                i += 1
-            i += 1
-        else:
-            visible_len += 1
-            i += 1
-    padding = width - visible_len
-    if padding > 0:
-        return text + " " * padding
-    return text
-
-
-def _build_progress_bar(percent, width=20):
-    filled = int(width * percent / 100)
-    empty = width - filled
-    bar = "█" * filled + "░" * empty
-    return "{} {:>3}%".format(bar, int(percent))
-
-
 SEVERITY_ICONS = {
     "critical": COLOR_RED + "🔴" + COLOR_RESET,
     "high": COLOR_MAGENTA + "🟠" + COLOR_RESET,
@@ -697,16 +648,6 @@ def action_pause(state_dir):
     print(json.dumps(result, indent=2, ensure_ascii=False))
 
 
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-def error_out(message):
-    output = {"error": message}
-    print(json.dumps(output, indent=2, ensure_ascii=False))
-    sys.exit(1)
-
-
 # ---------------------------------------------------------------------------
 # Main
 # ---------------------------------------------------------------------------

package/bundled/dev-pipeline/scripts/update-feature-status.py

@@ -23,9 +23,16 @@ import json
 import os
 import re
 import shutil
-import sys
 from datetime import datetime, timezone
 
+from utils import (
+    load_json_file,
+    write_json_file,
+    error_out,
+    pad_right,
+    _build_progress_bar,
+)
+
 
 SESSION_STATUS_VALUES = [
     "success",
@@ -99,45 +106,6 @@ def now_iso():
     return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
 
 
-def load_json_file(path):
-    """Load and return parsed JSON from a file.
-
-    Returns (data, error_string). On success error_string is None.
-    """
-    abs_path = os.path.abspath(path)
-    if not os.path.isfile(abs_path):
-        return None, "File not found: {}".format(abs_path)
-    try:
-        with open(abs_path, "r", encoding="utf-8") as f:
-            data = json.load(f)
-    except json.JSONDecodeError as e:
-        return None, "Invalid JSON: {}".format(str(e))
-    except IOError as e:
-        return None, "Cannot read file: {}".format(str(e))
-    return data, None
-
-
-def write_json_file(path, data):
-    """Write data as JSON to a file. Creates parent directories if needed.
-
-    Returns an error string on failure, None on success.
-    """
-    abs_path = os.path.abspath(path)
-    parent = os.path.dirname(abs_path)
-    if parent and not os.path.isdir(parent):
-        try:
-            os.makedirs(parent, exist_ok=True)
-        except OSError as e:
-            return "Cannot create directory: {}".format(str(e))
-    try:
-        with open(abs_path, "w", encoding="utf-8") as f:
-            json.dump(data, f, indent=2, ensure_ascii=False)
-            f.write("\n")
-    except IOError as e:
-        return "Cannot write file: {}".format(str(e))
-    return None
-
-
 def load_feature_status(state_dir, feature_id):
     """Load the status.json for a feature.
 
@@ -509,27 +477,6 @@ COLOR_RESET = "\033[0m"
 BOX_WIDTH = 68
 
 
-def pad_right(text, width):
-    """Pad text with spaces to fill width, accounting for ANSI escape codes."""
-    # Strip ANSI codes to calculate visible length
-    visible = text
-    i = 0
-    visible_len = 0
-    while i < len(text):
-        if text[i] == "\033":
-            # Skip until 'm'
-            while i < len(text) and text[i] != "m":
-                i += 1
-            i += 1  # skip the 'm'
-        else:
-            visible_len += 1
-            i += 1
-    padding = width - visible_len
-    if padding > 0:
-        return text + " " * padding
-    return text
-
-
 def _calc_feature_duration(state_dir, feature_id):
     """计算已完成 Feature 的耗时（秒）。
 
@@ -579,17 +526,6 @@ def _format_duration(seconds):
         return "{}h{}m".format(h, m)
 
 
-def _build_progress_bar(percent, width=20):
-    """生成文本进度条。
-
-    例如: ████████░░░░░░░░░░░░ 40%
-    """
-    filled = int(width * percent / 100)
-    empty = width - filled
-    bar = "█" * filled + "░" * empty
-    return "{} {:>3}%".format(bar, int(percent))
-
-
 def _estimate_remaining_time(features, state_dir, counts):
     """基于已完成 Feature 的历史耗时，按 complexity 加权预估剩余时间。
 
@@ -1015,17 +951,6 @@ def action_pause(state_dir):
     print(json.dumps(result, indent=2, ensure_ascii=False))
 
 
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-def error_out(message):
-    """Print an error JSON and exit with code 1."""
-    output = {"error": message}
-    print(json.dumps(output, indent=2, ensure_ascii=False))
-    sys.exit(1)
-
-
 # ---------------------------------------------------------------------------
 # Main
 # ---------------------------------------------------------------------------