prizmkit 1.1.113 → 1.1.114

package/bundled/skills/refactor-planner/SKILL.md

@@ -265,12 +265,12 @@ See `${SKILL_DIR}/references/planning-phases.md` for the full 5-step review chec
    ```
    The script fills in defaults (`$schema`, `created_at`, `created_by`), validates all fields, and writes the final file only if validation passes.
 3. If validation fails -> fix the draft and retry (max 3 attempts)
-4. If validation passes -> run the mandatory Post-Generation Plan Review Gate (see §Post-Generation Plan Review Gate below); apply accepted fixes to the draft/source plan, regenerate, and revalidate until pass
+4. If validation passes -> run the mandatory Local Generated-Plan Review Gate (see §Local Generated-Plan Review Gate below); apply accepted fixes to the draft/source plan, regenerate, and revalidate until pass
 5. If review and validation pass -> present final summary
 
 **CHECKPOINT CP-RP-6**: `.prizmkit/plans/refactor-list.json` generated and validated.
 
-**CHECKPOINT CP-RP-7**: `/prizmkit-code-review` reviewed only newly added/changed refactor entries; accepted fixes were regenerated and revalidated.
+**CHECKPOINT CP-RP-7**: Local generated-plan review loaded `${SKILL_DIR}/references/generated-plan-review.md`, reviewed only newly added/changed refactor entries, applied accepted fixes through draft/source data, regenerated, and revalidated.
 
 ## Checkpoints (Mandatory Gates)
 
@@ -283,32 +283,26 @@ See `${SKILL_DIR}/references/planning-phases.md` for the full 5-step review chec
 | **CP-RP-4** | Items Confirmed | User confirmed/modified/skipped each item | 5 |
 | **CP-RP-5** | Completeness OK | DAG valid, preservation strategies declared, no gaps | 6 |
 | **CP-RP-6** | Output Valid | `.prizmkit/plans/refactor-list.json` passes validation script | 7 |
-| **CP-RP-7** | Plan Review Passed | `/prizmkit-code-review` reviewed only newly added/changed refactor entries; accepted fixes were regenerated and revalidated | 7 |
-
-## Post-Generation Plan Review Gate
-
-User requirement preserved verbatim: `每次完成任务规划的时候，应该调用/prizmkit-code-review 对新增的计划内容进行review，确保生成新增的计划的正确行和完整性。`
-
-Run this gate **after** `.prizmkit/plans/refactor-list.json` passes the validation/generate script and **before** the final handoff summary recommends `refactor-pipeline-launcher`. This gate applies to full workflow, Mode B from analysis, and fast-path refactor planning.
-
-1. **Identify review scope**: compare the final validated refactor list against the pre-session list when one existed. Review only newly added or changed refactor entries. Do not re-review unchanged historical entries except when needed to verify dependency references or behavior-preservation interactions.
-2. **Invoke `/prizmkit-code-review` as a planning-quality gate** with an explicit prompt that this is a refactor-plan-entry review, not an implementation review. The review must check:
-   - schema correctness and compatibility with `dev-pipeline-refactor-list-v1`
-   - dependency/DAG soundness, including safe behavior-preserving order
-   - description completeness and headless execution readiness
-   - acceptance criteria specificity and measurable behavior-preservation verification
-   - `behavior_preservation` strategy quality and target scope consistency
-   - preservation of user-provided wording in `description`, `acceptance_criteria`, and `user_context`
-   - task-scoped `user_context` isolation: no unrelated sibling refactor goals, target files, constraints, or supplementary materials, and shared context appears on multiple items only when explicitly global
-   - priority/complexity calibration: every reviewed refactor has a short priority rationale and complexity rationale, medium/low assignments are allowed when criteria fit, and high/high is not used merely because the work is cleanup, framework-related, multi-file, or user-requested
-3. **Keep the review planning-only**: do NOT start `refactor-pipeline-launcher`, do NOT run the refactor pipeline, do NOT run tests/builds/installs, and do NOT implement source-code refactors.
-4. **Apply accepted review fixes through the draft/source plan**: when a finding is accepted, update `.prizmkit/plans/refactor-list.draft.json` or the in-memory draft representation first, then regenerate the final file with:
+| **CP-RP-7** | Local Plan Review Passed | Local generated-plan review loaded `${SKILL_DIR}/references/generated-plan-review.md`, reviewed only newly added/changed refactor entries, applied accepted fixes through draft/source data, regenerated, and revalidated | 7 |
+
+## Local Generated-Plan Review Gate
+
+User requirement preserved verbatim: `there is a litter bug for prizm-code-review will to check git diff in working space and staged space , however the .prizmkit will be gitignored in most situation.  so do you think the content should be change to inline a new reference file instead of use prizmkit-code-review`
+
+Run this gate **after** `.prizmkit/plans/refactor-list.json` passes the validation/generate script and **before** the final handoff summary recommends `refactor-pipeline-launcher`. This gate applies to full workflow, Mode B from analysis, and fast-path refactor planning when the current session generated, appended, or rewrote final refactor planning content. For validate-only, summary-only, or draft-save flows with no new final planning content, report: `Local generated-plan review: not applicable — no new final planning content written.`
+
+1. **Load the local reference**: read `${SKILL_DIR}/references/generated-plan-review.md` and follow it as the source of truth for this planner-output review loop.
+2. **Read actual planning artifacts directly**: inspect `.prizmkit/plans/refactor-list.json`, `.prizmkit/plans/refactor-list.draft.json` when present, and any pre-session or in-memory draft snapshot. Do not rely on `git status`, `git diff`, or `git diff --cached`, because `.prizmkit` planning artifacts are often gitignored or untracked.
+3. **Identify review scope**: compare by stable refactor IDs and item fields against the pre-session list when one existed. Ignore root generator metadata such as `$schema`, `created_at`, and `created_by`. Review only newly added or changed refactor entries; preserve unchanged historical entries except when needed to verify dependency references or behavior-preservation interactions.
+4. **Run the local checklist** from the reference: schema compatibility, dependency/DAG soundness, safe behavior-preserving order, description completeness, headless execution readiness, acceptance criteria measurability, `behavior_preservation` strategy quality, user-provided wording preservation, task-scoped `user_context` isolation, and priority/complexity calibration.
+5. **Keep the review planning-only**: do NOT start `refactor-pipeline-launcher`, do NOT run the refactor pipeline, do NOT run tests/builds/installs, and do NOT implement source-code refactors.
+6. **Apply accepted review fixes through the draft/source plan**: when a finding is accepted, update `.prizmkit/plans/refactor-list.draft.json` or the in-memory draft representation first, then regenerate the final file with:
    ```bash
    python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py generate --input .prizmkit/plans/refactor-list.draft.json --output .prizmkit/plans/refactor-list.json
    ```
    Do not hand-patch the final JSON as the source of truth; map final-output findings back to draft entries before regeneration.
-5. **Revalidate after every accepted fix batch**: the generate script must pass again before the planner can proceed. If validation fails, fix the draft and rerun until pass.
-6. **Report the gate outcome** in the final summary: include `/prizmkit-code-review` verdict, reviewed refactor IDs, accepted fixes (or "none"), and final validation result.
+7. **Revalidate after every accepted fix batch**: the generate script must pass again before the planner can proceed. If validation fails, fix the draft and rerun until pass.
+8. **Report the gate outcome** in the final summary: include local generated-plan review verdict, reviewed refactor IDs, accepted fixes (or "none"), and final validation result.
 
 ## Output Rules
 
@@ -444,10 +438,10 @@ Prevent accidental session exit without deliverable completion.
 
 ## Handoff Message Template
 
-After successful validation and the Post-Generation Plan Review Gate, report:
+After successful validation and the Local Generated-Plan Review Gate, report:
 1. Output file path
 2. Total refactor items
 3. Dependency ordering highlights (which items must run first)
 4. Behavior preservation strategy distribution (N items with test-gate, M with snapshot, etc.)
-5. Review result: `/prizmkit-code-review` verdict, reviewed refactor IDs, accepted fixes (or "none"), and final validation result
+5. Local generated-plan review result: verdict, reviewed refactor IDs, accepted fixes (or "none"), and final validation result
 6. Recommended next action: `refactor-pipeline-launcher`

package/bundled/skills/refactor-planner/references/fast-path.md

@@ -34,7 +34,7 @@ For simple refactoring with minimal scope.
    ```bash
    python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py generate --input .prizmkit/plans/refactor-list.draft.json --output .prizmkit/plans/refactor-list.json
    ```
-5. If valid -> run the mandatory Post-Generation Plan Review Gate from the main `refactor-planner` skill before summarizing or recommending `refactor-pipeline-launcher`.
+5. If valid -> run the mandatory Local Generated-Plan Review Gate from the main `refactor-planner` skill before summarizing or recommending `refactor-pipeline-launcher`.
 6. If invalid -> apply fixes to the draft, re-run generate (max 2 attempts, then escalate to full workflow)
 
 ## When NOT to Use Fast Path
@@ -53,6 +53,6 @@ AI: [Uses AskUserQuestion with options: "Fast-path", "Full workflow"]
 User: [Selects "Fast-path"]
 AI: "Drafting R-001..."
 AI: [Validates immediately]
-AI: [Runs the Post-Generation Plan Review Gate on R-001 only]
+AI: [Runs the Local Generated-Plan Review Gate on R-001 only]
 AI: "Ready to proceed to dev-pipeline."
 ```

package/bundled/skills/refactor-planner/references/generated-plan-review.md

@@ -0,0 +1,63 @@
+# Generated Plan Review — Refactor Planner
+
+Use this local review loop after `.prizmkit/plans/refactor-list.json` has been generated and validated. This is a planner-output review, not an implementation/code-diff review.
+
+## Trigger
+
+Run only when the current `refactor-planner` session generated, appended, or rewrote final refactor planning content. For validate-only, summary-only, or draft-save flows with no new final planning content, report: `Local generated-plan review: not applicable — no new final planning content written.`
+
+## Direct Artifact Reads
+
+Planning artifacts may be gitignored, untracked, or absent from staged and unstaged diffs. Read the actual files directly:
+
+- Final list: `.prizmkit/plans/refactor-list.json`
+- Draft/source list when present: `.prizmkit/plans/refactor-list.draft.json`
+- Pre-session final list snapshot if captured in memory before edits
+- In-memory draft object if the session has not written a draft file yet
+
+Do not rely on `git status`, `git diff`, or `git diff --cached` to decide whether planner output exists or changed. Do not invoke `/prizmkit-code-review` for this planner-output gate; `/prizmkit-code-review` remains the implementation/code-diff review gate after `/prizmkit-implement`.
+
+## Review Scope
+
+1. If a pre-session final list exists, compare by stable refactor IDs (`R-*`).
+2. Treat refactors as changed only when item fields changed. Ignore root generator metadata and formatting-only differences such as `$schema`, `created_at`, and `created_by`.
+3. Review newly added refactor IDs and changed refactor IDs.
+4. Preserve unchanged historical refactors. Read unchanged entries only when needed to verify dependency references or behavior-preservation interactions with reviewed refactors.
+5. If no snapshot exists, review all refactor entries produced by the current generation flow.
+
+## Review Checklist
+
+For every reviewed refactor entry, check:
+
+- Schema compatibility with `dev-pipeline-refactor-list-v1` and `.prizmkit/dev-pipeline/templates/refactor-list-schema.json`
+- Dependency/DAG soundness, including safe behavior-preserving order
+- Description completeness, target scope clarity, and headless execution readiness
+- Acceptance criteria specificity and measurable behavior-preservation verification
+- `behavior_preservation` strategy quality and consistency with target scope and existing tests
+- User-provided wording preservation in `description`, `acceptance_criteria`, and `user_context`
+- Task-scoped `user_context` isolation: no unrelated sibling refactor goals, target files, constraints, desired end states, or supplementary materials; shared context appears on multiple items only when explicitly global
+- Priority/complexity calibration: every reviewed refactor has short priority and complexity rationales, medium/low assignments are allowed when criteria fit, and high/high is not used merely because the work is cleanup, framework-related, multi-file, or user-requested
+
+## Fix Loop
+
+1. Present findings with IDs, severity, evidence, and suggested draft/source changes.
+2. Accept only findings that improve planner correctness, completeness, or downstream behavior-preserving execution readiness.
+3. Apply accepted fixes to `.prizmkit/plans/refactor-list.draft.json` or the in-memory draft object first.
+4. Regenerate the final list through the existing generator:
+
+```bash
+python3 ${SKILL_DIR}/scripts/validate-and-generate-refactor.py generate --input .prizmkit/plans/refactor-list.draft.json --output .prizmkit/plans/refactor-list.json
+```
+
+5. Re-run validation/generation until valid. Do not hand-patch `.prizmkit/plans/refactor-list.json` as the source of truth.
+6. Repeat the local review only for entries changed by accepted fixes.
+
+## Report Format
+
+Report in the final handoff summary:
+
+- `Local generated-plan review: PASS` or `NEEDS_FIXES`
+- Reviewed refactor IDs
+- Accepted fixes, or `none`
+- Final validation result
+- Note when review was not applicable because no new final planning content was written

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.113",
+  "version": "1.1.114",
   "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

@@ -3,6 +3,19 @@ import path from 'path';
 import fs from 'fs-extra';
 import { loadMetadata, loadRulesMetadata } from './metadata.js';
 import { readManifest } from './manifest.js';
+import { privateProjectMemoryFile, projectMemoryFile } from './platforms.js';
+
+const PRIZMKIT_GITIGNORE_HEADERS = new Set([
+  '# PrizmKit',
+  '# PrizmKit 运行时全部产物（state/、prizm-docs/、.env、logs 等）',
+]);
+const PRIZMKIT_GITIGNORE_ENTRIES = new Set([
+  '.prizmkit/',
+  '.prizmkit/*',
+  'CLAUDE.private.md',
+  'AGENTS.private.md',
+  'CODEBUDDY.private.md',
+]);
 
 async function removePath(targetPath, dryRun) {
   if (!await fs.pathExists(targetPath)) {
@@ -54,11 +67,14 @@ async function cleanGitignore(projectRoot, dryRun) {
   }
 
   const content = await fs.readFile(gitignorePath, 'utf8');
-  const next = content
-    .replace(/\n\n# PrizmKit\n\.prizmkit\/\n?/g, '\n')
-    .replace(/\n# PrizmKit\n\.prizmkit\/\n?/g, '\n');
-
-  if (next === content) {
+  const nextLines = content.split(/\r?\n/).filter(line => {
+    const trimmed = line.trim();
+    return !PRIZMKIT_GITIGNORE_HEADERS.has(trimmed)
+      && !PRIZMKIT_GITIGNORE_ENTRIES.has(trimmed);
+  });
+  const next = nextLines.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd();
+
+  if (`${next}\n` === content || next === content.trimEnd()) {
     return { updated: false, reason: 'no_prizmkit_section' };
   }
 
@@ -66,7 +82,7 @@ async function cleanGitignore(projectRoot, dryRun) {
     return { updated: true, reason: 'dry_run' };
   }
 
-  await fs.writeFile(gitignorePath, next.trimEnd() + '\n');
+  await fs.writeFile(gitignorePath, next ? `${next}\n` : '');
   return { updated: true };
 }
 
@@ -100,6 +116,38 @@ async function cleanMarkedProjectMemory(projectRoot, fileName, dryRun) {
   return { path: filePath, removed: true, note: '(PrizmKit section)' };
 }
 
+async function cleanProjectMemoryImport(projectRoot, fileName, privateFileName, dryRun) {
+  const filePath = path.join(projectRoot, fileName);
+  if (!await fs.pathExists(filePath)) {
+    return { path: filePath, removed: false, reason: 'not_found' };
+  }
+
+  const importPointer = `@./${privateFileName}`;
+  const content = await fs.readFile(filePath, 'utf8');
+  const next = content
+    .split(/\r?\n/)
+    .filter(line => line.trim() !== importPointer)
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trimEnd();
+
+  if (next === content.trimEnd()) {
+    return { path: filePath, removed: false, reason: 'no_prizmkit_import' };
+  }
+
+  if (dryRun) {
+    return { path: filePath, removed: false, reason: 'dry_run' };
+  }
+
+  if (!next) {
+    await fs.remove(filePath);
+    return { path: filePath, removed: true, note: '(PrizmKit import only)' };
+  }
+
+  await fs.writeFile(filePath, `${next}\n`);
+  return { path: filePath, removed: true, note: '(PrizmKit import)' };
+}
+
 async function removeGeneratedCodexConfig(projectRoot, dryRun) {
   const configPath = path.join(projectRoot, '.codex', 'config.toml');
   if (!await fs.pathExists(configPath)) {
@@ -228,7 +276,12 @@ export async function runClean(directory, options = {}) {
   const legacyCodexRulesDir = path.join(projectRoot, '.codex', 'rules');
   results.push(...await removeKnownEntries(legacyCodexRulesDir, ruleFileNames.map(n => `${n}.md`), dryRun));
 
-  for (const memoryFile of ['CODEBUDDY.md', 'CLAUDE.md', 'AGENTS.md']) {
+  for (const platform of ['codebuddy', 'claude', 'codex']) {
+    const memoryFile = projectMemoryFile(platform);
+    const privateMemoryFile = privateProjectMemoryFile(platform);
+    if (!memoryFile || !privateMemoryFile) continue;
+    results.push(await cleanProjectMemoryImport(projectRoot, memoryFile, privateMemoryFile, dryRun));
+    results.push(await cleanMarkedProjectMemory(projectRoot, privateMemoryFile, dryRun));
     results.push(await cleanMarkedProjectMemory(projectRoot, memoryFile, dryRun));
   }
 

package/src/config.js

@@ -38,6 +38,7 @@ import {
   resolveRuleNamesForRuntime,
   findStaleManagedPipelineFiles,
   removeStaleManagedPipelineFiles,
+  normalizeMainProjectMemoryContent,
 } from './scaffold.js';
 import {
   removeSkillFiles,
@@ -54,7 +55,7 @@ import {
   confirmTeamMode,
   confirmPipeline,
 } from './prompts.js';
-import { isKnownPlatform, platformLabel, projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
+import { isKnownPlatform, platformLabel, privateProjectMemoryFile, privateProjectMemoryFiles, projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
 import { normalizeRuntime, runtimeLabel } from './runtimes.js';
 import { applyAiCliLaunchToConfig, resolveAiCliLaunchSelection, storedAiCliLaunch } from './ai-cli-launch.js';
 
@@ -114,6 +115,50 @@ function getProjectMemoryFile(platform) {
   return projectMemoryFile(platform);
 }
 
+function logManagedMemoryWarnings(mainFile, warnings) {
+  for (const warning of warnings) {
+    console.log(chalk.yellow(`      ⚠ ${mainFile}: ${warning}; preserving unmatched marker content`));
+  }
+}
+
+async function removeProjectMemoryArtifacts(platform, projectRoot, dryRun) {
+  const mainFile = projectMemoryFile(platform);
+  const privateFile = privateProjectMemoryFile(platform);
+  if (!mainFile || !privateFile) return;
+
+  const privatePath = path.join(projectRoot, privateFile);
+  if (await fs.pathExists(privatePath)) {
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] remove ${privateFile}`));
+    } else {
+      await fs.remove(privatePath);
+      console.log(chalk.red(`      ✗ removed ${privateFile}`));
+    }
+  }
+
+  const mainPath = path.join(projectRoot, mainFile);
+  if (!await fs.pathExists(mainPath)) return;
+
+  const current = await fs.readFile(mainPath, 'utf-8');
+  const normalized = normalizeMainProjectMemoryContent(current, privateFile);
+  logManagedMemoryWarnings(mainFile, normalized.warnings);
+  const next = normalized.content.trim();
+  if (next === current.trim()) return;
+
+  if (dryRun) {
+    console.log(chalk.gray(`      [dry-run] update ${mainFile} (remove PrizmKit import)`));
+    return;
+  }
+
+  if (!next) {
+    await fs.remove(mainPath);
+    console.log(chalk.red(`      ✗ removed ${mainFile} (empty after PrizmKit import removal)`));
+  } else {
+    await fs.writeFile(mainPath, `${next}\n`, 'utf-8');
+    console.log(chalk.green(`      ✓ updated ${mainFile} (removed PrizmKit import)`));
+  }
+}
+
 async function migrateProjectMemoryOnPlatformDrop(droppedPlatform, newPlatforms, projectRoot, dryRun) {
   const sourceFile = getProjectMemoryFile(droppedPlatform);
   if (!sourceFile) return;
@@ -135,8 +180,13 @@ async function migrateProjectMemoryOnPlatformDrop(droppedPlatform, newPlatforms,
     return;
   }
 
-  const sourceContent = await fs.readFile(sourcePath, 'utf-8');
-  if (!sourceContent.trim()) return;
+  const normalized = normalizeMainProjectMemoryContent(
+    await fs.readFile(sourcePath, 'utf-8'),
+    privateProjectMemoryFile(droppedPlatform),
+  );
+  logManagedMemoryWarnings(sourceFile, normalized.warnings);
+  const sourceContent = normalized.content.trim();
+  if (!sourceContent) return;
 
   if (!await fs.pathExists(targetPath)) {
     const normalized = sourceContent.endsWith('\n') ? sourceContent : `${sourceContent}\n`;
@@ -244,18 +294,8 @@ async function removePlatformFiles(platform, projectRoot, manifest, dryRun) {
     }
   }
 
-  // Project memory file
-  const memoryFile = projectMemoryFile(platform);
-  if (!memoryFile) return;
-  const memoryPath = path.join(projectRoot, memoryFile);
-  if (await fs.pathExists(memoryPath)) {
-    if (dryRun) {
-      console.log(chalk.gray(`      [dry-run] remove ${memoryFile}`));
-    } else {
-      await fs.remove(memoryPath);
-      console.log(chalk.red(`      ✗ removed ${memoryFile}`));
-    }
-  }
+  // Project memory artifacts: remove only managed private file/imports, not user-owned main content.
+  await removeProjectMemoryArtifacts(platform, projectRoot, dryRun);
 
   // Command assets (Claude only)
   if (platform === 'claude') {
@@ -611,10 +651,8 @@ export async function runConfig(directory, options = {}) {
       console.log(chalk.blue('\n    Settings & Rules:'));
       await installSettings(p, projectRoot, { pipeline: newConfig.pipeline, rules: newConfig.rules }, false, newConfig.runtime);
 
-      if (isNew) {
-        console.log(chalk.blue('\n    Project Memory:'));
-        await installProjectMemory(p, projectRoot, false);
-      }
+      console.log(chalk.blue('\n    Project Memory:'));
+      await installProjectMemory(p, projectRoot, false);
 
       if (newConfig.team) {
         console.log(chalk.blue('\n    Team Config:'));
@@ -648,7 +686,10 @@ export async function runConfig(directory, options = {}) {
 
   // 5f. Update .gitignore
   console.log(chalk.blue('\n    Gitignore:'));
-  await installGitignore(projectRoot, { pipeline: newConfig.pipeline }, false);
+  await installGitignore(projectRoot, {
+    pipeline: newConfig.pipeline,
+    privateMemoryFiles: privateProjectMemoryFiles(newPlatforms),
+  }, false);
 
   // 5g. Runtime-aware git hook and PrizmKit helper scripts
   if (newConfig.runtime !== currentConfig.runtime || runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization) {

package/src/gitignore-template.js

@@ -9,11 +9,14 @@
  * @returns {string}
  */
 export function generateGitignore(options = {}) {
-  void options;
+  const privateMemoryFiles = Array.isArray(options.privateMemoryFiles)
+    ? options.privateMemoryFiles.filter(Boolean)
+    : [];
   const lines = [
-    '# PrizmKit 运行时全部产物（state/、prizm-docs/、.env、logs 等）',
+    '# PrizmKit',
     '.prizmkit/*',
+    ...privateMemoryFiles,
   ];
 
-  return lines.join('\n');
+  return [...new Set(lines)].join('\n');
 }

package/src/manifest.js

@@ -9,7 +9,7 @@
 
 import fs from 'fs-extra';
 import path from 'path';
-import { projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
+import { privateProjectMemoryFile, projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
 import { normalizeRuntime } from './runtimes.js';
 
 const MANIFEST_FILE = 'manifest.json';
@@ -100,7 +100,11 @@ export function buildManifest({
       pipeline: pipeline ? [...pipeline] : [],
       extras: extras ? [...extras] : [],
       payloadPlatforms: installedPayloadPlatforms,
-      other: [...new Set(installedPayloadPlatforms.map(projectMemoryFile).filter(Boolean))],
+      memory: {
+        main: [...new Set(installedPayloadPlatforms.map(projectMemoryFile).filter(Boolean))],
+        private: [...new Set(installedPayloadPlatforms.map(privateProjectMemoryFile).filter(Boolean))],
+      },
+      other: [...new Set(installedPayloadPlatforms.map(privateProjectMemoryFile).filter(Boolean))],
     },
   };
 }

package/src/platforms.js

@@ -62,6 +62,20 @@ export function projectMemoryFile(platform) {
   return null;
 }
 
+export function privateProjectMemoryFile(platform) {
+  const mainFile = projectMemoryFile(platform);
+  if (!mainFile) return null;
+  return mainFile.replace(/\.md$/i, '.private.md');
+}
+
+export function projectMemoryFiles(platform) {
+  return [projectMemoryFile(platform), privateProjectMemoryFile(platform)].filter(Boolean);
+}
+
+export function privateProjectMemoryFiles(platforms) {
+  return [...new Set((platforms || []).map(privateProjectMemoryFile).filter(Boolean))];
+}
+
 export function defaultCliForPlatform(platform) {
   if (platform === 'claude') return 'claude';
   if (platform === 'codebuddy') return 'cbc';