@juicesharp/rpiv-pi 0.5.1 → 0.6.1

package/README.md

@@ -145,6 +145,7 @@ Invoke via `/skill:<name>` from inside a Pi Agent session.
 | `/rpiv-setup` | Install all sibling plugins in one go |
 | `/rpiv-update-agents` | Sync rpiv agent profiles: add new, update changed, remove stale |
 | `/advisor` | Configure advisor model and reasoning effort |
+| `/btw` | Ask a side question without polluting the main conversation |
 | `/todos` | Show current todo list |
 | `/web-search-config` | Set Brave Search API key |
 
@@ -180,6 +181,7 @@ Pi Agent discovers extensions via `"extensions": ["./extensions"]` and skills vi
 
 - **Web search** — run `/web-search-config` to set the Brave Search API key, or set the `BRAVE_SEARCH_API_KEY` environment variable
 - **Advisor** — run `/advisor` to select a reviewer model and reasoning effort
+- **Side questions** — type `/btw <question>` anytime (even mid-stream) to ask the primary model a one-off question; answer appears in a borderless bottom overlay and never enters the main conversation
 - **Agent concurrency** — `@tintinweb/pi-subagents` defaults to 4 concurrent agents; raise via `/agents → Settings → Max concurrency → 48` if skills stall on wide fan-outs
 - **Agent profiles** — editable at `<cwd>/.pi/agents/`; sync from bundled defaults with `/rpiv-update-agents` (overwrites rpiv-managed files, preserves your custom agents)
 

package/extensions/rpiv-core/agents.ts

@@ -4,17 +4,9 @@
  * Pure utility. No ExtensionAPI interactions.
  */
 
-import {
-	existsSync,
-	mkdirSync,
-	readdirSync,
-	copyFileSync,
-	readFileSync,
-	writeFileSync,
-	unlinkSync,
-} from "node:fs";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { join, dirname } from "node:path";
 
 // ---------------------------------------------------------------------------
 // Package-root resolution
@@ -103,7 +95,7 @@ function readManifest(targetDir: string): string[] {
 function writeManifest(targetDir: string, filenames: string[]): void {
 	const manifestPath = join(targetDir, MANIFEST_FILE);
 	try {
-		writeFileSync(manifestPath, JSON.stringify(filenames, null, 2) + "\n", "utf-8");
+		writeFileSync(manifestPath, `${JSON.stringify(filenames, null, 2)}\n`, "utf-8");
 	} catch {
 		// non-fatal — sync results will still be correct for this run;
 		// next run will re-bootstrap if manifest is missing
@@ -269,9 +261,7 @@ export function syncBundledAgents(cwd: string, apply: boolean): SyncResult {
 	// apply=true: stale files were removed, so manifest = sourceEntries.
 	// apply=false: stale files still exist on disk and must stay tracked
 	// so the next apply can remove them.
-	const manifestEntries = apply
-		? sourceEntries
-		: [...sourceEntries, ...result.pendingRemove];
+	const manifestEntries = apply ? sourceEntries : [...sourceEntries, ...result.pendingRemove];
 	writeManifest(targetDir, manifestEntries);
 
 	return result;

package/extensions/rpiv-core/git-context.ts

@@ -17,7 +17,7 @@ type GitContext = { branch: string; commit: string; user: string };
 let lastInjectedSig: string | null = null;
 
 // undefined = not loaded yet, null = not a git repo / failed, object = valid
-let cache: GitContext | null | undefined = undefined;
+let cache: GitContext | null | undefined;
 
 export async function getGitContext(pi: ExtensionAPI): Promise<GitContext | null> {
 	if (cache !== undefined) return cache;
@@ -75,7 +75,5 @@ export async function takeGitContextIfChanged(pi: ExtensionAPI): Promise<string
 }
 
 export function isGitMutatingCommand(cmd: string): boolean {
-	return /\bgit\s+(checkout|switch|commit|merge|rebase|pull|reset|revert|cherry-pick|worktree|am|stash)\b/.test(
-		cmd,
-	);
+	return /\bgit\s+(checkout|switch|commit|merge|rebase|pull|reset|revert|cherry-pick|worktree|am|stash)\b/.test(cmd);
 }

package/extensions/rpiv-core/guidance.ts

@@ -20,7 +20,7 @@
  */
 
 import { existsSync, readFileSync } from "node:fs";
-import { dirname, relative, sep, isAbsolute, join } from "node:path";
+import { dirname, isAbsolute, join, relative, sep } from "node:path";
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { FLAG_DEBUG, MSG_TYPE_GUIDANCE } from "./constants.js";
 
@@ -181,9 +181,7 @@ export function handleToolCallGuidance(
 		injectedGuidance.add(g.relativePath);
 	}
 
-	const contextParts = newFiles.map(
-		(g) => `## Project Guidance: ${formatLabel(g)}\n\n${g.content}`,
-	);
+	const contextParts = newFiles.map((g) => `## Project Guidance: ${formatLabel(g)}\n\n${g.content}`);
 
 	pi.sendMessage({
 		customType: MSG_TYPE_GUIDANCE,
@@ -202,9 +200,7 @@ export function handleToolCallGuidance(
 function formatLabel(g: GuidanceFile): string {
 	if (g.kind === "architecture") {
 		const stripped = g.relativePath.replace(/^\.rpiv\/guidance\//, "");
-		const sub = stripped === "architecture.md"
-			? ""
-			: stripped.replace(/\/architecture\.md$/, "");
+		const sub = stripped === "architecture.md" ? "" : stripped.replace(/\/architecture\.md$/, "");
 		return `${sub || "root"} (architecture.md)`;
 	}
 	const fileName = g.kind === "agents" ? "AGENTS.md" : "CLAUDE.md";

package/extensions/rpiv-core/package-checks.ts

@@ -4,8 +4,8 @@
  */
 
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
 import { homedir } from "node:os";
+import { join } from "node:path";
 import { SIBLINGS, type SiblingPlugin } from "./siblings.js";
 
 const PI_AGENT_SETTINGS = join(homedir(), ".pi", "agent", "settings.json");

package/extensions/rpiv-core/pi-installer.ts

@@ -27,8 +27,12 @@ export function spawnPiInstall(pkg: string, timeoutMs: number): Promise<PiInstal
 		let stderr = "";
 
 		const proc = spawn(cmd, args, { ...spawnOpts, stdio: ["ignore", "pipe", "pipe"] });
-		proc.stdout?.on("data", (d) => (stdout += d.toString()));
-		proc.stderr?.on("data", (d) => (stderr += d.toString()));
+		proc.stdout?.on("data", (d) => {
+			stdout += d.toString();
+		});
+		proc.stderr?.on("data", (d) => {
+			stderr += d.toString();
+		});
 
 		const settle = (result: PiInstallResult) => {
 			if (settled) return;
@@ -42,7 +46,7 @@ export function spawnPiInstall(pkg: string, timeoutMs: number): Promise<PiInstal
 			setTimeout(() => {
 				if (!proc.killed) proc.kill("SIGKILL");
 			}, 5000);
-			settle({ code: 124, stdout, stderr: stderr + `\n[timed out after ${timeoutMs}ms]` });
+			settle({ code: 124, stdout, stderr: `${stderr}\n[timed out after ${timeoutMs}ms]` });
 		}, timeoutMs);
 
 		proc.on("error", (err) => {

package/extensions/rpiv-core/session-hooks.ts

@@ -7,16 +7,16 @@
 
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { isToolCallEventType, type ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { clearInjectionState, handleToolCallGuidance, injectRootGuidance } from "./guidance.js";
+import { type ExtensionAPI, isToolCallEventType } from "@mariozechner/pi-coding-agent";
+import { type SyncResult, syncBundledAgents } from "./agents.js";
+import { FLAG_DEBUG, MSG_TYPE_GIT_CONTEXT } from "./constants.js";
 import {
 	clearGitContextCache,
 	isGitMutatingCommand,
 	resetInjectedMarker,
 	takeGitContextIfChanged,
 } from "./git-context.js";
-import { syncBundledAgents, type SyncResult } from "./agents.js";
-import { FLAG_DEBUG, MSG_TYPE_GIT_CONTEXT } from "./constants.js";
+import { clearInjectionState, handleToolCallGuidance, injectRootGuidance } from "./guidance.js";
 import { findMissingSiblings } from "./package-checks.js";
 
 const THOUGHTS_DIRS = [
@@ -28,8 +28,7 @@ const THOUGHTS_DIRS = [
 ] as const;
 
 const msgAgentsAdded = (n: number) => `Copied ${n} rpiv-pi agent(s) to .pi/agents/`;
-const msgAgentsDrift = (parts: string[]) =>
-	`${parts.join(", ")} agent(s). Run /rpiv-update-agents to sync.`;
+const msgAgentsDrift = (parts: string[]) => `${parts.join(", ")} agent(s). Run /rpiv-update-agents to sync.`;
 const msgMissingSiblings = (n: number, list: string) =>
 	`rpiv-pi requires ${n} sibling extension(s): ${list}. Run /rpiv-setup to install them.`;
 
@@ -90,10 +89,7 @@ function scaffoldThoughtsDirs(cwd: string): void {
 	}
 }
 
-async function injectGitContext(
-	pi: ExtensionAPI,
-	send: (msg: string) => void,
-): Promise<void> {
+async function injectGitContext(pi: ExtensionAPI, send: (msg: string) => void): Promise<void> {
 	const msg = await takeGitContextIfChanged(pi);
 	if (msg) send(msg);
 }
@@ -113,8 +109,5 @@ function notifyAgentSyncDrift(ui: UI, result: SyncResult): void {
 function warnMissingSiblings(ui: UI): void {
 	const missing = findMissingSiblings();
 	if (missing.length === 0) return;
-	ui.notify(
-		msgMissingSiblings(missing.length, missing.map((m) => m.pkg.replace(/^npm:/, "")).join(", ")),
-		"warning",
-	);
+	ui.notify(msgMissingSiblings(missing.length, missing.map((m) => m.pkg.replace(/^npm:/, "")).join(", ")), "warning");
 }

package/extensions/rpiv-core/setup-command.ts

@@ -8,7 +8,7 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { findMissingSiblings } from "./package-checks.js";
 import { spawnPiInstall } from "./pi-installer.js";
-import { type SiblingPlugin } from "./siblings.js";
+import type { SiblingPlugin } from "./siblings.js";
 
 const INSTALL_TIMEOUT_MS = 120_000;
 const STDERR_SNIPPET_CHARS = 300;
@@ -82,9 +82,7 @@ async function installMissing(
 			} else {
 				failed.push({
 					pkg,
-					error: (result.stderr || result.stdout || `exit ${result.code}`)
-						.trim()
-						.slice(0, STDERR_SNIPPET_CHARS),
+					error: (result.stderr || result.stdout || `exit ${result.code}`).trim().slice(0, STDERR_SNIPPET_CHARS),
 				});
 			}
 		} catch (err) {

package/extensions/rpiv-core/siblings.ts

@@ -40,6 +40,11 @@ export const SIBLINGS: readonly SiblingPlugin[] = [
 		matches: /rpiv-advisor/i,
 		provides: "advisor tool + /advisor command",
 	},
+	{
+		pkg: "npm:@juicesharp/rpiv-btw",
+		matches: /rpiv-btw/i,
+		provides: "/btw side-question command",
+	},
 	{
 		pkg: "npm:@juicesharp/rpiv-web-tools",
 		matches: /rpiv-web-tools/i,

package/extensions/rpiv-core/update-agents-command.ts

@@ -4,7 +4,7 @@
  */
 
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { syncBundledAgents, type SyncResult } from "./agents.js";
+import { type SyncResult, syncBundledAgents } from "./agents.js";
 
 const MSG_UP_TO_DATE = "All agents already up-to-date.";
 const MSG_NO_CHANGES = "No changes needed.";
@@ -15,8 +15,7 @@ const msgSyncedWithErrors = (summary: string, errors: string[]) =>
 
 export function registerUpdateAgentsCommand(pi: ExtensionAPI): void {
 	pi.registerCommand("rpiv-update-agents", {
-		description:
-			"Sync rpiv-pi bundled agents into .pi/agents/: add new, update changed, remove stale",
+		description: "Sync rpiv-pi bundled agents into .pi/agents/: add new, update changed, remove stale",
 		handler: async (_args, ctx) => {
 			const result = syncBundledAgents(ctx.cwd, true);
 			if (!ctx.hasUI) return;
@@ -36,7 +35,10 @@ function formatSyncReport(result: SyncResult): string {
 
 	const summary = parts.length > 0 ? msgSynced(parts) : MSG_NO_CHANGES;
 	if (result.errors.length > 0) {
-		return msgSyncedWithErrors(summary, result.errors.map((e) => e.message));
+		return msgSyncedWithErrors(
+			summary,
+			result.errors.map((e) => e.message),
+		);
 	}
 	return summary;
 }

package/package.json

@@ -1,26 +1,44 @@
 {
   "name": "@juicesharp/rpiv-pi",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "Skill-based development workflow for Pi Agent — discover, research, design, plan, implement, validate",
-  "keywords": ["pi-package", "pi-extension", "rpiv", "skills", "workflow"],
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "rpiv",
+    "skills",
+    "workflow"
+  ],
   "license": "MIT",
   "author": "juicesharp",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/juicesharp/rpiv-pi.git"
+    "url": "git+https://github.com/juicesharp/rpiv-mono.git",
+    "directory": "packages/rpiv-pi"
   },
-  "homepage": "https://github.com/juicesharp/rpiv-pi#readme",
+  "homepage": "https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-pi#readme",
   "bugs": {
-    "url": "https://github.com/juicesharp/rpiv-pi/issues"
+    "url": "https://github.com/juicesharp/rpiv-mono/issues"
   },
   "publishConfig": {
     "access": "public"
   },
-  "files": ["extensions/", "skills/", "agents/", "scripts/", "README.md", "LICENSE"],
+  "files": [
+    "extensions/",
+    "skills/",
+    "agents/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
   "pi": {
-    "extensions": ["./extensions"],
-    "skills": ["./skills"]
+    "extensions": [
+      "./extensions"
+    ],
+    "skills": [
+      "./skills"
+    ]
   },
   "peerDependencies": {
     "@mariozechner/pi-coding-agent": "*",
@@ -28,6 +46,7 @@
     "@juicesharp/rpiv-ask-user-question": "*",
     "@juicesharp/rpiv-todo": "*",
     "@juicesharp/rpiv-advisor": "*",
+    "@juicesharp/rpiv-btw": "*",
     "@juicesharp/rpiv-web-tools": "*"
   }
 }

package/scripts/migrate.js

@@ -1,242 +1,245 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, readdirSync, statSync } from 'fs';
-import { join, dirname, relative, sep } from 'path';
-import { execSync } from 'child_process';
+import { execSync } from "child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "fs";
+import { dirname, join, relative, sep } from "path";
+
 // --- CLI Argument Parsing ---
 function parseArgs(argv) {
-    let projectDir = process.cwd();
-    let deleteOriginals = false;
-    let dryRun = false;
-    let force = false;
-    for (let i = 2; i < argv.length; i++) {
-        if (argv[i] === '--project-dir' && argv[i + 1]) {
-            projectDir = argv[++i];
-        }
-        else if (argv[i] === '--delete-originals') {
-            deleteOriginals = true;
-        }
-        else if (argv[i] === '--dry-run') {
-            dryRun = true;
-        }
-        else if (argv[i] === '--force') {
-            force = true;
-        }
-    }
-    return { projectDir, deleteOriginals, dryRun, force };
+	let projectDir = process.cwd();
+	let deleteOriginals = false;
+	let dryRun = false;
+	let force = false;
+	for (let i = 2; i < argv.length; i++) {
+		if (argv[i] === "--project-dir" && argv[i + 1]) {
+			projectDir = argv[++i];
+		} else if (argv[i] === "--delete-originals") {
+			deleteOriginals = true;
+		} else if (argv[i] === "--dry-run") {
+			dryRun = true;
+		} else if (argv[i] === "--force") {
+			force = true;
+		}
+	}
+	return { projectDir, deleteOriginals, dryRun, force };
 }
 // --- Discovery ---
 const HARDCODED_EXCLUDES = new Set([
-    'node_modules', 'dist', 'build', '.git', 'vendor', '.rpiv',
-    '.next', '.nuxt', '.output', 'coverage', '__pycache__', '.venv',
+	"node_modules",
+	"dist",
+	"build",
+	".git",
+	"vendor",
+	".rpiv",
+	".next",
+	".nuxt",
+	".output",
+	"coverage",
+	"__pycache__",
+	".venv",
 ]);
 function discoverClaudeMdFiles(projectDir) {
-    const gitDir = join(projectDir, '.git');
-    if (existsSync(gitDir)) {
-        return discoverViaGit(projectDir);
-    }
-    return discoverViaWalk(projectDir);
+	const gitDir = join(projectDir, ".git");
+	if (existsSync(gitDir)) {
+		return discoverViaGit(projectDir);
+	}
+	return discoverViaWalk(projectDir);
 }
 function discoverViaGit(projectDir) {
-    try {
-        const output = execSync('git ls-files --cached --others --exclude-standard', {
-            cwd: projectDir,
-            encoding: 'utf-8',
-            maxBuffer: 10 * 1024 * 1024,
-        });
-        return output
-            .split('\n')
-            .filter((f) => f.endsWith('/CLAUDE.md') || f === 'CLAUDE.md')
-            .filter((f) => !f.startsWith('.rpiv/'));
-    }
-    catch {
-        // git command failed — fall back to walk
-        return discoverViaWalk(projectDir);
-    }
+	try {
+		const output = execSync("git ls-files --cached --others --exclude-standard", {
+			cwd: projectDir,
+			encoding: "utf-8",
+			maxBuffer: 10 * 1024 * 1024,
+		});
+		return output
+			.split("\n")
+			.filter((f) => f.endsWith("/CLAUDE.md") || f === "CLAUDE.md")
+			.filter((f) => !f.startsWith(".rpiv/"));
+	} catch {
+		// git command failed — fall back to walk
+		return discoverViaWalk(projectDir);
+	}
 }
 function discoverViaWalk(projectDir) {
-    const results = [];
-    function walk(dir) {
-        let entries;
-        try {
-            entries = readdirSync(dir);
-        }
-        catch {
-            return; // permission error, skip
-        }
-        for (const entry of entries) {
-            if (HARDCODED_EXCLUDES.has(entry))
-                continue;
-            const fullPath = join(dir, entry);
-            let stat;
-            try {
-                stat = statSync(fullPath);
-            }
-            catch {
-                continue;
-            }
-            if (stat.isDirectory()) {
-                walk(fullPath);
-            }
-            else if (entry === 'CLAUDE.md') {
-                const rel = relative(projectDir, fullPath).split(sep).join('/');
-                if (!rel.startsWith('.rpiv/')) {
-                    results.push(rel);
-                }
-            }
-        }
-    }
-    walk(projectDir);
-    return results;
+	const results = [];
+	function walk(dir) {
+		let entries;
+		try {
+			entries = readdirSync(dir);
+		} catch {
+			return; // permission error, skip
+		}
+		for (const entry of entries) {
+			if (HARDCODED_EXCLUDES.has(entry)) continue;
+			const fullPath = join(dir, entry);
+			let stat;
+			try {
+				stat = statSync(fullPath);
+			} catch {
+				continue;
+			}
+			if (stat.isDirectory()) {
+				walk(fullPath);
+			} else if (entry === "CLAUDE.md") {
+				const rel = relative(projectDir, fullPath).split(sep).join("/");
+				if (!rel.startsWith(".rpiv/")) {
+					results.push(rel);
+				}
+			}
+		}
+	}
+	walk(projectDir);
+	return results;
 }
 // --- Path Mapping ---
 function computeTargetPath(claudeMdRelative) {
-    const dir = dirname(claudeMdRelative);
-    if (dir === '.') {
-        return '.rpiv/guidance/architecture.md';
-    }
-    return join('.rpiv', 'guidance', dir, 'architecture.md').split(sep).join('/');
+	const dir = dirname(claudeMdRelative);
+	if (dir === ".") {
+		return ".rpiv/guidance/architecture.md";
+	}
+	return join(".rpiv", "guidance", dir, "architecture.md").split(sep).join("/");
 }
 function transformContent(content, targetPath) {
-    let refsTransformed = 0;
-    const warnings = [];
-    // Pattern 1: Backtick-wrapped path references like `src/core/CLAUDE.md`
-    let transformed = content.replace(/`((?:[\w][\w./-]*\/)?CLAUDE\.md)`/g, (_match, claudePath) => {
-        const replacement = claudePathToGuidancePath(claudePath);
-        refsTransformed++;
-        return '`' + replacement + '`';
-    });
-    // Pattern 2: Bare path references (with directory prefix) not inside backticks
-    // Match things like "src/core/CLAUDE.md" but not already-backtick-wrapped
-    transformed = transformed.replace(/(?<!`)([\w][\w./-]*\/CLAUDE\.md)(?!`)/g, (_match, claudePath) => {
-        const replacement = claudePathToGuidancePath(claudePath);
-        refsTransformed++;
-        return replacement;
-    });
-    // Pattern 3: Standalone "CLAUDE.md" that references the root file
-    // Only match when it looks like a file reference (not part of a longer word)
-    // Avoid matching inside paths already transformed above
-    transformed = transformed.replace(/(?<![/\w`])CLAUDE\.md(?![/\w`])/g, () => {
-        refsTransformed++;
-        return '.rpiv/guidance/architecture.md';
-    });
-    // Scan for remaining prose references that might need manual attention
-    const lines = transformed.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-        // Look for prose patterns like "see X CLAUDE.md" or "X layer CLAUDE.md"
-        if (/\b\w+\s+CLAUDE\.md\b/i.test(content.split('\n')[i] ?? '') &&
-            !/(src|lib|app|packages|apps)\//.test(content.split('\n')[i] ?? '')) {
-            // Check if this line still has an untransformed prose reference
-            if (/CLAUDE\.md/i.test(lines[i])) {
-                warnings.push({
-                    file: targetPath,
-                    line: i + 1,
-                    message: `Prose reference to CLAUDE.md may need manual update: "${lines[i].trim()}"`,
-                });
-            }
-        }
-    }
-    return { content: transformed, refsTransformed, warnings };
+	let refsTransformed = 0;
+	const warnings = [];
+	// Pattern 1: Backtick-wrapped path references like `src/core/CLAUDE.md`
+	let transformed = content.replace(/`((?:[\w][\w./-]*\/)?CLAUDE\.md)`/g, (_match, claudePath) => {
+		const replacement = claudePathToGuidancePath(claudePath);
+		refsTransformed++;
+		return `\`${replacement}\``;
+	});
+	// Pattern 2: Bare path references (with directory prefix) not inside backticks
+	// Match things like "src/core/CLAUDE.md" but not already-backtick-wrapped
+	transformed = transformed.replace(/(?<!`)([\w][\w./-]*\/CLAUDE\.md)(?!`)/g, (_match, claudePath) => {
+		const replacement = claudePathToGuidancePath(claudePath);
+		refsTransformed++;
+		return replacement;
+	});
+	// Pattern 3: Standalone "CLAUDE.md" that references the root file
+	// Only match when it looks like a file reference (not part of a longer word)
+	// Avoid matching inside paths already transformed above
+	transformed = transformed.replace(/(?<![/\w`])CLAUDE\.md(?![/\w`])/g, () => {
+		refsTransformed++;
+		return ".rpiv/guidance/architecture.md";
+	});
+	// Scan for remaining prose references that might need manual attention
+	const lines = transformed.split("\n");
+	for (let i = 0; i < lines.length; i++) {
+		// Look for prose patterns like "see X CLAUDE.md" or "X layer CLAUDE.md"
+		if (
+			/\b\w+\s+CLAUDE\.md\b/i.test(content.split("\n")[i] ?? "") &&
+			!/(src|lib|app|packages|apps)\//.test(content.split("\n")[i] ?? "")
+		) {
+			// Check if this line still has an untransformed prose reference
+			if (/CLAUDE\.md/i.test(lines[i])) {
+				warnings.push({
+					file: targetPath,
+					line: i + 1,
+					message: `Prose reference to CLAUDE.md may need manual update: "${lines[i].trim()}"`,
+				});
+			}
+		}
+	}
+	return { content: transformed, refsTransformed, warnings };
 }
 function claudePathToGuidancePath(claudePath) {
-    const dir = dirname(claudePath);
-    if (dir === '.') {
-        return '.rpiv/guidance/architecture.md';
-    }
-    return '.rpiv/guidance/' + dir + '/architecture.md';
+	const dir = dirname(claudePath);
+	if (dir === ".") {
+		return ".rpiv/guidance/architecture.md";
+	}
+	return `.rpiv/guidance/${dir}/architecture.md`;
 }
 // --- Main ---
 function main() {
-    const { projectDir, deleteOriginals, dryRun, force } = parseArgs(process.argv);
-    process.stderr.write(`[rpiv:migrate] scanning ${projectDir} for CLAUDE.md files\n`);
-    const claudeFiles = discoverClaudeMdFiles(projectDir);
-    if (claudeFiles.length === 0) {
-        const report = {
-            migrated: [],
-            conflicts: [],
-            warnings: [],
-            originalsDeleted: false,
-            dryRun,
-        };
-        process.stdout.write(JSON.stringify(report, null, 2));
-        return;
-    }
-    process.stderr.write(`[rpiv:migrate] found ${claudeFiles.length} CLAUDE.md file(s)\n`);
-    const migrated = [];
-    const conflicts = [];
-    const allWarnings = [];
-    const writtenFiles = [];
-    for (const source of claudeFiles) {
-        const target = computeTargetPath(source);
-        const targetAbs = join(projectDir, target);
-        // Check for conflicts
-        if (existsSync(targetAbs) && !force) {
-            conflicts.push(target);
-            continue;
-        }
-        // Read source content
-        const sourceAbs = join(projectDir, source);
-        let content;
-        try {
-            content = readFileSync(sourceAbs, 'utf-8');
-        }
-        catch (err) {
-            allWarnings.push({
-                file: source,
-                line: 0,
-                message: `Failed to read: ${err instanceof Error ? err.message : String(err)}`,
-            });
-            continue;
-        }
-        if (content.trim().length === 0) {
-            allWarnings.push({
-                file: source,
-                line: 0,
-                message: 'Empty file, skipped',
-            });
-            continue;
-        }
-        // Transform content
-        const { content: transformed, refsTransformed, warnings } = transformContent(content, target);
-        const lines = transformed.split('\n').length;
-        migrated.push({ source, target, lines, refsTransformed });
-        allWarnings.push(...warnings);
-        if (!dryRun) {
-            writtenFiles.push({ targetAbs, content: transformed });
-        }
-    }
-    // Write all files (all-or-nothing approach for safety)
-    if (!dryRun) {
-        for (const { targetAbs, content } of writtenFiles) {
-            mkdirSync(dirname(targetAbs), { recursive: true });
-            writeFileSync(targetAbs, content, 'utf-8');
-        }
-        process.stderr.write(`[rpiv:migrate] wrote ${writtenFiles.length} file(s)\n`);
-    }
-    // Delete originals only after all writes succeed
-    let originalsDeleted = false;
-    if (!dryRun && deleteOriginals && writtenFiles.length > 0) {
-        for (const entry of migrated) {
-            const sourceAbs = join(projectDir, entry.source);
-            try {
-                unlinkSync(sourceAbs);
-            }
-            catch (err) {
-                allWarnings.push({
-                    file: entry.source,
-                    line: 0,
-                    message: `Failed to delete original: ${err instanceof Error ? err.message : String(err)}`,
-                });
-            }
-        }
-        originalsDeleted = true;
-        process.stderr.write(`[rpiv:migrate] deleted ${migrated.length} original CLAUDE.md file(s)\n`);
-    }
-    const report = {
-        migrated,
-        conflicts,
-        warnings: allWarnings,
-        originalsDeleted,
-        dryRun,
-    };
-    process.stdout.write(JSON.stringify(report, null, 2));
+	const { projectDir, deleteOriginals, dryRun, force } = parseArgs(process.argv);
+	process.stderr.write(`[rpiv:migrate] scanning ${projectDir} for CLAUDE.md files\n`);
+	const claudeFiles = discoverClaudeMdFiles(projectDir);
+	if (claudeFiles.length === 0) {
+		const report = {
+			migrated: [],
+			conflicts: [],
+			warnings: [],
+			originalsDeleted: false,
+			dryRun,
+		};
+		process.stdout.write(JSON.stringify(report, null, 2));
+		return;
+	}
+	process.stderr.write(`[rpiv:migrate] found ${claudeFiles.length} CLAUDE.md file(s)\n`);
+	const migrated = [];
+	const conflicts = [];
+	const allWarnings = [];
+	const writtenFiles = [];
+	for (const source of claudeFiles) {
+		const target = computeTargetPath(source);
+		const targetAbs = join(projectDir, target);
+		// Check for conflicts
+		if (existsSync(targetAbs) && !force) {
+			conflicts.push(target);
+			continue;
+		}
+		// Read source content
+		const sourceAbs = join(projectDir, source);
+		let content;
+		try {
+			content = readFileSync(sourceAbs, "utf-8");
+		} catch (err) {
+			allWarnings.push({
+				file: source,
+				line: 0,
+				message: `Failed to read: ${err instanceof Error ? err.message : String(err)}`,
+			});
+			continue;
+		}
+		if (content.trim().length === 0) {
+			allWarnings.push({
+				file: source,
+				line: 0,
+				message: "Empty file, skipped",
+			});
+			continue;
+		}
+		// Transform content
+		const { content: transformed, refsTransformed, warnings } = transformContent(content, target);
+		const lines = transformed.split("\n").length;
+		migrated.push({ source, target, lines, refsTransformed });
+		allWarnings.push(...warnings);
+		if (!dryRun) {
+			writtenFiles.push({ targetAbs, content: transformed });
+		}
+	}
+	// Write all files (all-or-nothing approach for safety)
+	if (!dryRun) {
+		for (const { targetAbs, content } of writtenFiles) {
+			mkdirSync(dirname(targetAbs), { recursive: true });
+			writeFileSync(targetAbs, content, "utf-8");
+		}
+		process.stderr.write(`[rpiv:migrate] wrote ${writtenFiles.length} file(s)\n`);
+	}
+	// Delete originals only after all writes succeed
+	let originalsDeleted = false;
+	if (!dryRun && deleteOriginals && writtenFiles.length > 0) {
+		for (const entry of migrated) {
+			const sourceAbs = join(projectDir, entry.source);
+			try {
+				unlinkSync(sourceAbs);
+			} catch (err) {
+				allWarnings.push({
+					file: entry.source,
+					line: 0,
+					message: `Failed to delete original: ${err instanceof Error ? err.message : String(err)}`,
+				});
+			}
+		}
+		originalsDeleted = true;
+		process.stderr.write(`[rpiv:migrate] deleted ${migrated.length} original CLAUDE.md file(s)\n`);
+	}
+	const report = {
+		migrated,
+		conflicts,
+		warnings: allWarnings,
+		originalsDeleted,
+		dryRun,
+	};
+	process.stdout.write(JSON.stringify(report, null, 2));
 }
 main();