prizmkit 1.1.42 → 1.1.46

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

@@ -1,12 +1,12 @@
 #!/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.
+# Outputs structural differences between .prizmkit/prizm-docs/ and source code.
+# Silent (exit 0) if no differences or if .prizmkit/prizm-docs doesn't exist.
 # POSIX sh only — no arrays, no bashisms.
 
 set -e
 
-ROOT_PRIZM=".prizm-docs/root.prizm"
+ROOT_PRIZM=".prizmkit/prizm-docs/root.prizm"
 
 # 1. Exit silently if no root.prizm
 [ -f "$ROOT_PRIZM" ] || exit 0
@@ -85,7 +85,7 @@ 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"
+  l1_file=".prizmkit/prizm-docs/${source_path}.prizm"
 
   if [ ! -f "$l1_file" ]; then
     continue
@@ -104,7 +104,7 @@ echo "$REGISTERED_PATHS" | while IFS= read -r source_path; do
 done
 
 # 5. Find orphan docs
-find .prizm-docs -name '*.prizm' 2>/dev/null | while IFS= read -r prizm_file; do
+find .prizmkit/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)
@@ -112,8 +112,8 @@ find .prizm-docs -name '*.prizm' 2>/dev/null | while IFS= read -r prizm_file; do
       ;;
   esac
 
-  # Derive source path: remove .prizm-docs/ prefix and .prizm suffix
-  source_path=$(echo "$prizm_file" | sed 's|^\.prizm-docs/||' | sed 's|\.prizm$||')
+  # Derive source path: remove .prizmkit/prizm-docs/ prefix and .prizm suffix
+  source_path=$(echo "$prizm_file" | sed 's|^\.prizmkit/prizm-docs/||' | sed 's|\.prizm$||')
 
   if [ ! -d "$source_path" ]; then
     echo "ORPHAN_DOC: $prizm_file | source dir missing"
@@ -131,7 +131,7 @@ find . -mindepth 1 -maxdepth 3 -type d \
   ! -path '*/target/*' ! -path './target' \
   ! -path '*/tests/*' ! -path './tests' \
   ! -path '*/__tests__/*' ! -path './__tests__' \
-  ! -path '*/.prizm-docs/*' ! -path './.prizm-docs' \
+  ! -path '*/.prizmkit/prizm-docs/*' ! -path './.prizmkit/prizm-docs' \
   ! -path '*/.claude/*' ! -path './.claude' \
   ! -path '*/.codebuddy/*' ! -path './.codebuddy' \
   ! -path '*/dev-pipeline/*' ! -path './dev-pipeline' \

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

@@ -1,13 +1,13 @@
 #!/bin/sh
-# prizm-pre-commit.sh — git pre-commit hook for .prizm-docs validation
+# prizm-pre-commit.sh — git pre-commit hook for .prizmkit/prizm-docs validation
 
 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
+[ -f "$PROJECT_ROOT/.prizmkit/prizm-docs/root.prizm" ] || exit 0
 
 VALIDATE_SCRIPT="$PROJECT_ROOT/.prizmkit/scripts/validate-prizm-docs.sh"
-[ -f "$VALIDATE_SCRIPT" ] || VALIDATE_SCRIPT="$PROJECT_ROOT/dev-pipeline/scripts/validate-prizm-docs.sh"
+[ -f "$VALIDATE_SCRIPT" ] || VALIDATE_SCRIPT="$PROJECT_ROOT/.prizmkit/dev-pipeline/scripts/validate-prizm-docs.sh"
 
 if [ -f "$VALIDATE_SCRIPT" ]; then
     sh "$VALIDATE_SCRIPT" --staged
@@ -37,7 +37,7 @@ for FILE in $FILES; do
         *root.prizm) LIMIT=4096 ;;
         *)
             DIR=$(dirname "$FILE")
-            if [ "$DIR" = ".prizm-docs" ]; then
+            if [ "$DIR" = ".prizmkit/prizm-docs" ]; then
                 LIMIT=3072
             else
                 LIMIT=5120

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

@@ -6,11 +6,11 @@ MODE="${1:---staged}"
 ERRORS=0
 
 # Not a prizm project — exit silently
-[ -f ".prizm-docs/root.prizm" ] || exit 0
+[ -f ".prizmkit/prizm-docs/root.prizm" ] || exit 0
 
 # Collect files to check
 if [ "$MODE" = "--all" ]; then
-    FILES=$(find .prizm-docs -name '*.prizm' 2>/dev/null)
+    FILES=$(find .prizmkit/prizm-docs -name '*.prizm' 2>/dev/null)
 elif [ "$MODE" = "--staged" ]; then
     FILES=$(git diff --cached --name-only 2>/dev/null | grep '\.prizm$')
 else
@@ -44,9 +44,9 @@ for FILE in $FILES; do
             HINT="Consolidate MODULE_INDEX, keep top-5 RULES."
             ;;
         *)
-            # L1 = direct child of .prizm-docs/, L2 = nested deeper
+            # L1 = direct child of .prizmkit/prizm-docs/, L2 = nested deeper
             DIR=$(dirname "$FILE")
-            if [ "$DIR" = ".prizm-docs" ]; then
+            if [ "$DIR" = ".prizmkit/prizm-docs" ]; then
                 LIMIT=3072; LEVEL="L1"
                 HINT="Move implementation details to L2."
             else

package/bundled/templates/project-memory-template.md

@@ -4,14 +4,14 @@
 This project uses PrizmKit with the Prizm documentation system for AI-optimized progressive context loading.
 
 ### Progressive Loading Protocol
-- ON SESSION START: Always read `.prizm-docs/root.prizm` first (L0 — project map)
+- ON SESSION START: Always read `.prizmkit/prizm-docs/root.prizm` first (L0 — project map)
 - ON RESUME (feature/bugfix directory has session-summary.md): Read session-summary.md first for prior context, then load only L1/L2 for modules mentioned in it
-- ON TASK: Read L1 (`.prizm-docs/<module>.prizm`) for relevant modules referenced in MODULE_INDEX or MODULE_GROUPS. If entries have keyword tags (e.g., `[login, jwt, oauth]`), match user's task against tags to prioritize which modules to load.
-- ON FILE EDIT: Read L2 (`.prizm-docs/<module>/<submodule>.prizm`) before modifying files. Pay attention to TRAPS and DECISIONS.
+- ON TASK: Read L1 (`.prizmkit/prizm-docs/<module>.prizm`) for relevant modules referenced in MODULE_INDEX or MODULE_GROUPS. If entries have keyword tags (e.g., `[login, jwt, oauth]`), match user's task against tags to prioritize which modules to load.
+- ON FILE EDIT: Read L2 (`.prizmkit/prizm-docs/<module>/<submodule>.prizm`) before modifying files. Pay attention to TRAPS and DECISIONS.
 - NEVER load all .prizm docs at once. Load only what is needed for the current task.
 
 ### Auto-Update Protocol
-- BEFORE EVERY COMMIT: Update affected `.prizm-docs/` files
+- BEFORE EVERY COMMIT: Update affected `.prizmkit/prizm-docs/` files
 - Platform hooks (rules or UserPromptSubmit) will remind you automatically
 - Use `/prizmkit-committer` for the complete commit workflow
 

package/package.json

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

package/src/clean.js

@@ -115,8 +115,6 @@ export async function runClean(directory, options = {}) {
   const fullRemoveTargets = [
     '.prizmkit',
     '.dev-team',
-    'dev-pipeline',
-    '.prizm-docs',        // AI-generated project context docs
     'CODEBUDDY.md',
     'CLAUDE.md',
     path.join('.prizmkit', 'plans', 'feature-list.json'),          // feature-planner output
@@ -204,7 +202,7 @@ export async function runClean(directory, options = {}) {
     console.log(chalk.green(`  清理完成：已删除 ${removed} 项。`));
   }
   console.log('');
-  console.log(chalk.gray('  注意：.prizm-docs/ 为 AI 生成的项目上下文文档，已一并清理。'));
+  console.log(chalk.gray('  注意：.prizmkit/prizm-docs/ 为 AI 生成的项目上下文文档，已一并清理。'));
   console.log(chalk.gray('        用户自定义的 agent/skill/rule 文件未受影响。'));
   console.log('');
 }

package/src/config.js

@@ -6,7 +6,7 @@
  *
  * Flow: READ manifest → PROMPT user → COMPUTE DIFF → DISPLAY SUMMARY → EXECUTE
  *
- * Preserves runtime files (.prizm-docs/, dev-pipeline/state/, .prizmkit/specs/).
+ * Preserves runtime files (.prizmkit/prizm-docs/, .prizmkit/state/, .prizmkit/specs/).
  */
 
 import chalk from 'chalk';

package/src/gitignore-template.js

@@ -9,42 +9,22 @@
  * @returns {string}
  */
 export function generateGitignore(options = {}) {
+  void options;
   const lines = [
     '# ===========================',
     '# PrizmKit Runtime Artifacts',
     '# ===========================',
     '',
-    '# PrizmKit 运行时状态（不提交）',
-    '.prizmkit/state/',
+    '# PrizmKit 运行时全部产物（state/、prizm-docs/、.env、logs 等）',
+    '.prizmkit/*',
     '',
     '# 多 Agent 协作临时工作区',
     '.dev-team/',
     '',
-    '# Prizm 文档（按需决定是否提交）',
-    '# .prizm-docs/',
-    '',
-    '# 规划产物（按需决定是否提交）',
-    '# .prizmkit/plans/',
-    '',
-  ];
-
-  if (options.pipeline) {
-    lines.push(
-      '# Dev-Pipeline 运行时状态（已迁移到 .prizmkit/state/）',
-      '.prizmkit/state/features/',
-      '.prizmkit/state/bugfix/',
-      '.prizmkit/state/refactor/',
-      'dev-pipeline/logs/',
-      'dev-pipeline/*.pid',
-      '',
-    );
-  }
-
-  lines.push(
     '# Playwright CLI 快照和截图',
     '.playwright-cli/',
     '',
-  );
+  ];
 
   lines.push(
     '# ===========================',

package/src/scaffold.js

@@ -405,7 +405,7 @@ export async function installSettings(platform, projectRoot, options, dryRun) {
 
     // Settings
     const permissions = [
-      'Bash(python3 dev-pipeline/scripts/*)',
+      'Bash(python3 .prizmkit/dev-pipeline/scripts/*)',
       'Bash(git add *)',
       'Bash(git commit *)',
       'Bash(git diff *)',
@@ -420,7 +420,7 @@ export async function installSettings(platform, projectRoot, options, dryRun) {
         const pipelineEntries = await fs.readdir(pipelineDir);
         const entryScripts = pipelineEntries.filter(f => /^(run-|launch-|retry-|reset-).*\.sh$/.test(f));
         for (const script of entryScripts) {
-          permissions.push(`Bash(./dev-pipeline/${script} *)`);
+          permissions.push(`Bash(./.prizmkit/dev-pipeline/${script} *)`);
         }
       } catch {
         // Fallback: if readdir fails, add no pipeline permissions
@@ -437,7 +437,7 @@ export async function installSettings(platform, projectRoot, options, dryRun) {
             hooks: [
               {
                 type: 'command',
-                command: 'test -f .prizm-docs/root.prizm && echo "PrizmKit: .prizm-docs found. Read root.prizm for project context." || echo "PrizmKit: No .prizm-docs found. Run /prizmkit-init to bootstrap."',
+                command: 'test -f .prizmkit/prizm-docs/root.prizm && echo "PrizmKit: .prizmkit/prizm-docs found. Read root.prizm for project context." || echo "PrizmKit: No .prizmkit/prizm-docs found. Run /prizmkit-init to bootstrap."',
               },
             ],
           },
@@ -634,14 +634,15 @@ export function resolvePipelineFileList() {
 
 /**
  * 安装 dev-pipeline（纯 Copy 模式）
- * Returns an array of installed file relative paths (relative to dev-pipeline/).
+ * 安装目标：.prizmkit/dev-pipeline/
+ * Returns an array of installed file relative paths (relative to .prizmkit/dev-pipeline/).
  */
 export async function installPipeline(projectRoot, dryRun, { forceOverwrite = false } = {}) {
   const pipelineSource = getPipelineDir();
-  const pipelineTarget = path.join(projectRoot, 'dev-pipeline');
+  const pipelineTarget = path.join(projectRoot, '.prizmkit', 'dev-pipeline');
 
   if (dryRun) {
-    console.log(chalk.gray(`      [dry-run] dev-pipeline/`));
+    console.log(chalk.gray(`      [dry-run] .prizmkit/dev-pipeline/`));
     return [];
   }
 
@@ -666,7 +667,7 @@ export async function installPipeline(projectRoot, dryRun, { forceOverwrite = fa
     const srcStat = await fs.stat(src);
 
     if (await fs.pathExists(tgt) && !forceOverwrite) {
-      console.log(chalk.yellow(`      ⚠ dev-pipeline/${item} 已存在，跳过`));
+      console.log(chalk.yellow(`      ⚠ .prizmkit/dev-pipeline/${item} 已存在，跳过`));
       // Still collect existing files for manifest tracking
       if (srcStat.isDirectory()) {
         installedFiles.push(...collectFilesRecursive(src, item));
@@ -687,14 +688,14 @@ export async function installPipeline(projectRoot, dryRun, { forceOverwrite = fa
     }
   }
 
-  console.log(chalk.green(`      ✓ dev-pipeline/ (${installedCount} 项)`));
+  console.log(chalk.green(`      ✓ .prizmkit/dev-pipeline/ (${installedCount} 项)`));
 
-  // Copy .env.example to project root if it exists in pipeline source
+  // Copy .env.example to .prizmkit/.env.example if it exists in pipeline source
   const envExampleSrc = path.join(pipelineSource, '.env.example');
-  const envExampleTgt = path.join(projectRoot, '.env.example');
+  const envExampleTgt = path.join(projectRoot, '.prizmkit', '.env.example');
   if (await fs.pathExists(envExampleSrc) && !await fs.pathExists(envExampleTgt)) {
     await fs.copy(envExampleSrc, envExampleTgt);
-    console.log(chalk.green(`      ✓ .env.example (pipeline environment configuration)`));
+    console.log(chalk.green(`      ✓ .prizmkit/.env.example (pipeline environment configuration)`));
   }
 
   return installedFiles;

package/src/upgrade.js

@@ -125,13 +125,13 @@ export async function removeRuleFiles(platform, projectRoot, ruleFileNames, dryR
  */
 export async function removePipelineFiles(projectRoot, fileList, dryRun) {
   for (const relPath of fileList) {
-    const filePath = path.join(projectRoot, 'dev-pipeline', relPath);
+    const filePath = path.join(projectRoot, '.prizmkit', 'dev-pipeline', relPath);
     if (await fs.pathExists(filePath)) {
       if (dryRun) {
-        console.log(chalk.gray(`      [dry-run] remove dev-pipeline/${relPath}`));
+        console.log(chalk.gray(`      [dry-run] remove .prizmkit/dev-pipeline/${relPath}`));
       } else {
         await fs.remove(filePath);
-        console.log(chalk.red(`      ✗ removed dev-pipeline/${relPath}`));
+        console.log(chalk.red(`      ✗ removed .prizmkit/dev-pipeline/${relPath}`));
       }
     }
   }