prizmkit 1.0.15 → 1.0.16

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.15",
-  "bundledAt": "2026-03-15T12:24:22.555Z",
-  "bundledFrom": "8b809a8"
+  "frameworkVersion": "1.0.16",
+  "bundledAt": "2026-03-15T13:35:03.135Z",
+  "bundledFrom": "d609245"
 }

package/bundled/skills/_metadata.json

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

package/bundled/skills/prizmkit-init/SKILL.md

@@ -39,44 +39,32 @@ BROWNFIELD WORKFLOW (existing project):
 4. Catalog dependencies (external packages)
 5. Count source files per directory
 
-**Step 2: State Assessment**
-2a. Run dependency analysis:
-  - Count outdated dependencies (if lockfile exists)
-  - Note any known vulnerability patterns
-
-2b. Scan for technical debt indicators:
-  - Count TODO/FIXME/HACK/XXX comments
-  - Identify large files (>500 lines)
-  - Check for test directories and coverage config
-
-2c. Generate `ASSESSMENT.md` in project root with findings
-
-**Step 3: Prizm Documentation Generation**
-3a. Invoke prizmkit-prizm-docs `prizmkit.doc.init` algorithm:
+**Step 2: Prizm Documentation Generation**
+2a. Invoke prizmkit-prizm-docs `prizmkit.doc.init` algorithm:
   - Create `.prizm-docs/` directory structure
   - Generate `root.prizm` (L0) with project meta and module index
   - Generate L1 docs for all discovered modules
   - Create `changelog.prizm`
   - Skip L2 (lazy generation)
 
-3b. If project has existing `docs/AI_CONTEXT/`: suggest running `prizmkit.doc.migrate`
+2b. If project has existing `docs/AI_CONTEXT/`: suggest running `prizmkit.doc.migrate`
 
-**Step 4: PrizmKit Workspace Initialization**
-4a. Create `.prizmkit/` directory:
+**Step 3: PrizmKit Workspace Initialization**
+3a. Create `.prizmkit/` directory:
   - `.prizmkit/config.json` (adoption_mode, speckit_hooks_enabled, platform)
   - `.prizmkit/specs/` (empty)
 
-**Step 5: Hook & Settings Configuration (Platform-Specific)**
+**Step 4: Hook & Settings Configuration (Platform-Specific)**
 
 **If platform is CodeBuddy (or both):**
-5a-cb. Read or create `.codebuddy/settings.json`
-5b-cb. Add UserPromptSubmit hook from `${SKILL_DIR}/../../../assets/hooks/prizm-commit-hook.json`
-5c-cb. Preserve any existing hooks
+4a-cb. Read or create `.codebuddy/settings.json`
+4b-cb. Add UserPromptSubmit hook from `${SKILL_DIR}/../../../assets/hooks/prizm-commit-hook.json`
+4c-cb. Preserve any existing hooks
 
 **If platform is Claude Code (or both):**
-5a-cl. Read or create `.claude/settings.json`
-5b-cl. Add `permissions` and `allowedTools` entries if needed
-5c-cl. Create `.claude/rules/prizm-documentation.md` with glob-scoped rules:
+4a-cl. Read or create `.claude/settings.json`
+4b-cl. Add `permissions` and `allowedTools` entries if needed
+4c-cl. Create `.claude/rules/prizm-documentation.md` with glob-scoped rules:
   ```yaml
   ---
   description: PrizmKit documentation rules
@@ -91,7 +79,7 @@ BROWNFIELD WORKFLOW (existing project):
   2. After changes, update affected `.prizm-docs/` files
   3. Follow Prizm doc format (KEY: value, not prose)
   ```
-5d-cl. Create `.claude/rules/prizm-commit-workflow.md` with commit-scoped rules:
+4d-cl. Create `.claude/rules/prizm-commit-workflow.md` with commit-scoped rules:
   ```yaml
   ---
   description: PrizmKit commit workflow enforcement
@@ -105,33 +93,33 @@ BROWNFIELD WORKFLOW (existing project):
   4. Stage .prizm-docs/ changes
   5. Use /prizmkit-committer for the complete workflow
   ```
-5e-cl. Preserve any existing Claude settings and rules
+4e-cl. Preserve any existing Claude settings and rules
 
-**Step 6: Project Memory Update (Platform-Specific)**
+**Step 5: Project Memory Update (Platform-Specific)**
 
 **If platform is CodeBuddy (or both):**
-6a-cb. Read existing `CODEBUDDY.md` (or create if missing)
-6b-cb. Append PrizmKit section from `${SKILL_DIR}/../../../assets/codebuddy-md-template.md`
-6c-cb. Do not duplicate if already present
+5a-cb. Read existing `CODEBUDDY.md` (or create if missing)
+5b-cb. Append PrizmKit section from `${SKILL_DIR}/../../../assets/codebuddy-md-template.md`
+5c-cb. Do not duplicate if already present
 
 **If platform is Claude Code (or both):**
-6a-cl. Read existing `CLAUDE.md` (or create if missing)
-6b-cl. Append PrizmKit section from `${SKILL_DIR}/../../../assets/claude-md-template.md`
-6c-cl. Adjust command references to use `/command-name` format (not `prizmkit.xxx`)
-6d-cl. Do not duplicate if already present
+5a-cl. Read existing `CLAUDE.md` (or create if missing)
+5b-cl. Append PrizmKit section from `${SKILL_DIR}/../../../assets/claude-md-template.md`
+5c-cl. Adjust command references to use `/command-name` format (not `prizmkit.xxx`)
+5d-cl. Do not duplicate if already present
 
-**Step 7: Report**
-Output summary: platform detected, tech stack detected, modules discovered, L1 docs generated, assessment highlights, platform-specific configuration applied, next recommended steps.
+**Step 6: Report**
+Output summary: platform detected, tech stack detected, modules discovered, L1 docs generated, platform-specific configuration applied, next recommended steps.
 
 Include platform-specific guidance:
 - CodeBuddy: "Use `prizmkit.specify` to start your first feature"
 - Claude Code: "Use `/prizmkit-specify` to start your first feature"
 
 GREENFIELD WORKFLOW (new project):
-- Skip Steps 1-2 (no code to scan)
-- Step 3: Create minimal `.prizm-docs/` with just `root.prizm` skeleton
-- Steps 4-6: Same as brownfield
-- Step 7: Recommend starting with specify for first feature (platform-appropriate command format)
+- Skip Step 1 (no code to scan)
+- Step 2: Create minimal `.prizm-docs/` with just `root.prizm` skeleton
+- Steps 3-5: Same as brownfield
+- Step 6: Recommend starting with specify for first feature (platform-appropriate command format)
 
 ### Gradual Adoption Path
 After init, PrizmKit operates in phases:

package/bundled/templates/hooks/commit-intent-claude.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if echo \"$CLAUDE_TOOL_INPUT\" 2>/dev/null | grep -qE 'git (commit|merge|rebase)' 2>/dev/null; then DRIFT=$(sh .prizmkit/scripts/diff-prizm-docs.sh 2>/dev/null); if [ -n \"$DRIFT\" ]; then echo \"PRIZMKIT_DRIFT_DETECTED: prizm-docs structural differences found after git operation:\"; echo \"$DRIFT\"; echo \"Please update affected .prizm-docs/ files using /prizmkit-prizm-docs.\"; fi; fi"
+          }
+        ]
+      }
     ]
   }
 }

package/bundled/templates/hooks/commit-intent-codebuddy.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "TOOL_INPUT=\"${CLAUDE_TOOL_INPUT:-${CODEBUDDY_TOOL_INPUT:-}}\"; if echo \"$TOOL_INPUT\" | grep -qE 'git (commit|merge|rebase)' 2>/dev/null; then DRIFT=$(sh .prizmkit/scripts/diff-prizm-docs.sh 2>/dev/null); if [ -n \"$DRIFT\" ]; then echo \"PRIZMKIT_DRIFT_DETECTED: prizm-docs structural differences found:\"; echo \"$DRIFT\"; echo \"Please update affected .prizm-docs/ files.\"; fi; fi"
+          }
+        ]
+      }
     ]
   }
 }

package/bundled/templates/hooks/diff-prizm-docs.sh

@@ -0,0 +1,158 @@
+#!/bin/sh
+# PrizmKit: diff-prizm-docs.sh
+# Outputs structural differences between .prizm-docs/ and source code.
+# Silent (exit 0) if no differences or if .prizm-docs doesn't exist.
+# POSIX sh only — no arrays, no bashisms.
+
+set -e
+
+ROOT_PRIZM=".prizm-docs/root.prizm"
+
+# 1. Exit silently if no root.prizm
+[ -f "$ROOT_PRIZM" ] || exit 0
+
+# 2. Detect language from LANG: field
+LANG_VAL=$(grep '^LANG:' "$ROOT_PRIZM" | head -1 | sed 's/^LANG:[[:space:]]*//' | tr '[:upper:]' '[:lower:]')
+
+case "$LANG_VAL" in
+  go)
+    FILE_PATTERN="*.go"
+    ;;
+  javascript|typescript|javascript/typescript|typescript/javascript)
+    FILE_PATTERN="*.ts *.tsx *.js *.jsx"
+    ;;
+  python)
+    FILE_PATTERN="*.py"
+    ;;
+  rust)
+    FILE_PATTERN="*.rs"
+    ;;
+  *)
+    FILE_PATTERN=""
+    ;;
+esac
+
+# Helper: count source files in a directory (maxdepth 1) by language
+count_source_files() {
+  _dir="$1"
+  [ -d "$_dir" ] || { echo 0; return; }
+  if [ -z "$FILE_PATTERN" ]; then
+    # All non-hidden files
+    find "$_dir" -maxdepth 1 -type f ! -name '.*' 2>/dev/null | wc -l | tr -d ' '
+  else
+    _count=0
+    for _pat in $FILE_PATTERN; do
+      _c=$(find "$_dir" -maxdepth 1 -type f -name "$_pat" 2>/dev/null | wc -l | tr -d ' ')
+      _count=$((_count + _c))
+    done
+    echo "$_count"
+  fi
+}
+
+# 3. Parse MODULE_INDEX from root.prizm
+# Extract lines between MODULE_INDEX: and next ALL-CAPS header or EOF
+# Each module line: "- src/auth: ..." -> source path is text before first ":" after "- "
+REGISTERED_PATHS=""
+_in_index=0
+while IFS= read -r line; do
+  case "$line" in
+    MODULE_INDEX:*)
+      _in_index=1
+      continue
+      ;;
+  esac
+  if [ "$_in_index" -eq 1 ]; then
+    # Check for next ALL-CAPS section header (word followed by colon, all uppercase letters)
+    _header=$(echo "$line" | grep '^[A-Z_][A-Z_]*:' || true)
+    if [ -n "$_header" ]; then
+      break
+    fi
+    # Extract source path from "- src/auth: ..."
+    case "$line" in
+      "- "*)
+        _path=$(echo "$line" | sed 's/^- //' | sed 's/:.*//')
+        if [ -n "$_path" ]; then
+          REGISTERED_PATHS="${REGISTERED_PATHS}${_path}
+"
+        fi
+        ;;
+    esac
+  fi
+done < "$ROOT_PRIZM"
+
+# 4. Check each registered module for drift
+echo "$REGISTERED_PATHS" | while IFS= read -r source_path; do
+  [ -z "$source_path" ] && continue
+
+  # Derive L1 prizm file path
+  l1_file=".prizm-docs/${source_path}.prizm"
+
+  if [ ! -f "$l1_file" ]; then
+    continue
+  fi
+
+  # Read declared FILES: count
+  declared=$(grep '^FILES:' "$l1_file" | head -1 | awk '{print $2}')
+  [ -z "$declared" ] && continue
+
+  # Count actual source files
+  actual=$(count_source_files "$source_path")
+
+  if [ "$actual" -gt 0 ] && [ "$declared" != "$actual" ]; then
+    echo "MODULE_DRIFT: $source_path | declared FILES: $declared | actual: $actual"
+  fi
+done
+
+# 5. Find orphan docs
+find .prizm-docs -name '*.prizm' 2>/dev/null | while IFS= read -r prizm_file; do
+  _basename=$(basename "$prizm_file")
+  case "$_basename" in
+    root.prizm|changelog.prizm|changelog-archive.prizm)
+      continue
+      ;;
+  esac
+
+  # Derive source path: remove .prizm-docs/ prefix and .prizm suffix
+  source_path=$(echo "$prizm_file" | sed 's|^\.prizm-docs/||' | sed 's|\.prizm$||')
+
+  if [ ! -d "$source_path" ]; then
+    echo "ORPHAN_DOC: $prizm_file | source dir missing"
+  fi
+done
+
+# 6. Find unregistered directories
+find . -mindepth 1 -maxdepth 3 -type d \
+  ! -path '*/.*' \
+  ! -path '*/node_modules/*' ! -path './node_modules' \
+  ! -path '*/vendor/*' ! -path './vendor' \
+  ! -path '*/dist/*' ! -path './dist' \
+  ! -path '*/build/*' ! -path './build' \
+  ! -path '*/__pycache__/*' ! -path './__pycache__' \
+  ! -path '*/target/*' ! -path './target' \
+  ! -path '*/tests/*' ! -path './tests' \
+  ! -path '*/__tests__/*' ! -path './__tests__' \
+  ! -path '*/.prizm-docs/*' ! -path './.prizm-docs' \
+  ! -path '*/.claude/*' ! -path './.claude' \
+  ! -path '*/.codebuddy/*' ! -path './.codebuddy' \
+  ! -path '*/dev-pipeline/*' ! -path './dev-pipeline' \
+  ! -path '*/coverage/*' ! -path './coverage' \
+  ! -path '*/.nyc_output/*' ! -path './.nyc_output' \
+  ! -path '*/out/*' ! -path './out' \
+  ! -path '*/tmp/*' ! -path './tmp' \
+  2>/dev/null | while IFS= read -r candidate; do
+  # Normalize: remove leading ./
+  candidate_clean=$(echo "$candidate" | sed 's|^\./||')
+
+  # Count source files
+  file_count=$(count_source_files "$candidate_clean")
+
+  if [ "$file_count" -ge 3 ]; then
+    # Check if registered in MODULE_INDEX
+    _match=$(echo "$REGISTERED_PATHS" | grep -Fx "$candidate_clean" || true)
+    if [ -z "$_match" ]; then
+      echo "UNREGISTERED: $candidate_clean | $file_count source files | not in MODULE_INDEX"
+    fi
+  fi
+done
+
+exit 0

package/bundled/templates/hooks/prizm-pre-commit.sh

@@ -6,7 +6,8 @@ PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
 # Only run in prizm projects
 [ -f "$PROJECT_ROOT/.prizm-docs/root.prizm" ] || exit 0
 
-VALIDATE_SCRIPT="$PROJECT_ROOT/dev-pipeline/scripts/validate-prizm-docs.sh"
+VALIDATE_SCRIPT="$PROJECT_ROOT/.prizmkit/scripts/validate-prizm-docs.sh"
+[ -f "$VALIDATE_SCRIPT" ] || VALIDATE_SCRIPT="$PROJECT_ROOT/dev-pipeline/scripts/validate-prizm-docs.sh"
 
 if [ -f "$VALIDATE_SCRIPT" ]; then
     sh "$VALIDATE_SCRIPT" --staged

package/package.json

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

package/src/scaffold.js

@@ -472,25 +472,34 @@ async function installGitHook(projectRoot, dryRun) {
 }
 
 /**
- * 安装 validate-prizm-docs.sh 到 dev-pipeline/scripts/
+ * 安装 PrizmKit 脚本到 .prizmkit/scripts/（始终安装）
  */
-async function installValidateScript(projectRoot, dryRun) {
-  const sourcePath = path.join(getTemplatesDir(), 'hooks', 'validate-prizm-docs.sh');
-  if (!fs.existsSync(sourcePath)) return;
+async function installPrizmkitScripts(projectRoot, dryRun) {
+  const scriptsDir = path.join(projectRoot, '.prizmkit', 'scripts');
+  const templateHooksDir = path.join(getTemplatesDir(), 'hooks');
 
-  const targetDir = path.join(projectRoot, 'dev-pipeline', 'scripts');
-  const targetPath = path.join(targetDir, 'validate-prizm-docs.sh');
+  const scripts = [
+    'validate-prizm-docs.sh',
+    'diff-prizm-docs.sh',
+  ];
 
   if (dryRun) {
-    console.log(chalk.gray('      [dry-run] dev-pipeline/scripts/validate-prizm-docs.sh'));
+    for (const s of scripts) {
+      console.log(chalk.gray(`      [dry-run] .prizmkit/scripts/${s}`));
+    }
     return;
   }
 
-  await fs.ensureDir(targetDir);
-  await fs.copy(sourcePath, targetPath);
-  fs.chmodSync(targetPath, 0o755);
+  await fs.ensureDir(scriptsDir);
 
-  console.log(chalk.green('      ✓ dev-pipeline/scripts/validate-prizm-docs.sh'));
+  for (const s of scripts) {
+    const src = path.join(templateHooksDir, s);
+    if (!fs.existsSync(src)) continue;
+    const tgt = path.join(scriptsDir, s);
+    await fs.copy(src, tgt);
+    fs.chmodSync(tgt, 0o755);
+    console.log(chalk.green(`      ✓ .prizmkit/scripts/${s}`));
+  }
 }
 
 /**
@@ -711,11 +720,9 @@ export async function scaffold(config) {
   console.log(chalk.blue('    Git Hook:'));
   await installGitHook(projectRoot, dryRun);
 
-  // 11. Validate script (only if pipeline enabled)
-  if (pipeline) {
-    console.log(chalk.blue('    验证脚本:'));
-    await installValidateScript(projectRoot, dryRun);
-  }
+  // 11. PrizmKit scripts (always installed)
+  console.log(chalk.blue('    PrizmKit 脚本:'));
+  await installPrizmkitScripts(projectRoot, dryRun);
 
   // === 完成 ===
   console.log('');