@north-light/crouter 0.3.249 → 0.3.250

package/dist/shared/generated-context.js

@@ -15,15 +15,21 @@ export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone a
     "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
 /** The daemon's parking mandate: the last turn of a conversation the unattended
  *  clock is concluding. Delivered live, wrapped in a `park` runtime card. It
- *  shares a CONTRACT with `node yield`'s pre-invocation guide (roadmap current,
- *  short and shrinking; context dir for in-progress material; memory only for
- *  gated permanent lessons) but not a string: yield is read by an agent choosing
- *  to refresh, this by an agent being told to conclude. */
-export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing waiting on it, so it is being concluded. This is your last turn — do these four things now, then stop.\n\n'
-    + '1. Bring your roadmap current. It lives at `$CRTR_CONTEXT_DIR/roadmap.md`, and it is the document a fresh cycle reads to know where things stand: what was done, what is still open, and what someone picking this up needs. Write one now if you never had one. Keep it short and shrinking — strategy and present state only, deleting completed items rather than marking them done.\n\n'
-    + '2. Save anything else worth keeping. In-progress task material — what has happened, identifiers, in-flight state — goes to one or more files in your context directory. A permanent lesson worth remembering indefinitely goes to node memory (`crtr memory write -h`), gated deliberately: transcript state does not belong in memory.\n\n'
-    + '3. Push one regular report to your subscribers summarizing where things stand: `crtr push update`. NOT `crtr push final` — this concludes the conversation, it does not finish a mandate.\n\n'
-    + '4. Stop. A later message reopens you on a fresh context window grounded in your goal and that roadmap, so what you leave behind now is what you get back.';
+ *  governs both the node's durable inheritance and reader-facing output:
+ *  one update for subscribers and history, then a goodbye that does not narrate
+ *  the parking.
+ *
+ *  The durable inheritance shares a CONTRACT with `node yield`'s pre-invocation
+ *  guide (roadmap current, short and shrinking; context dir for in-progress
+ *  material; memory only for gated permanent lessons) but not a string: yield is
+ *  read by an agent choosing to refresh, this by an agent being told to conclude. */
+export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing left to wake it, so it is being concluded. This is your last turn. Use it to leave a trustworthy inheritance, not to restart or broaden the work. Do these six things now, then stop.\n\n'
+    + '1. Establish current truth. Check only state that may have changed outside the transcript and matters to resuming—such as the working tree, a remote run, or an external decision. Do not start new work; perform only a quick check needed to avoid recording an unverified claim. If no mandate or work ever began, say that plainly and keep every artifact minimal.\n\n'
+    + '2. Rewrite `$CRTR_CONTEXT_DIR/roadmap.md` for a fresh context window. This is the only handoff document a later fresh cycle receives in full. Preserve the current goal and exit criteria when they still apply, then state the present outcome; what remains or is blocked; decisions or questions still open; exact recovery handles for in-flight state; and the first safe move on return. Keep strategy and present state, not a transcript recap. Delete stale and completed steps instead of marking them done; the roadmap should stay short and shrink. Write a minimal one now if none exists.\n\n'
+    + '3. Put supporting material in your context directory only when the roadmap would become bulky without it. Rewrite existing living documents rather than leave superseded versions. Name every supporting file the next cycle must read from the roadmap and say what it is for—the revive shows filenames but does not inject their contents. Task state, identifiers, and recovery detail belong here, not in memory.\n\n'
+    + '4. Use memory only for a non-obvious, reusable lesson that should survive this task and is not already recorded. Read `crtr memory write -h`, find before writing, and choose the narrowest scope that will reach the next agent who needs it. Do not put a conversation recap, task status, recovery handles, or facts already captured in code or docs into memory.\n\n'
+    + '5. Push exactly one regular update with `crtr push update --tier deferred`, never `crtr push final`. Write it for subscribers and history, not as a second roadmap. Its first line must stand alone as the current outcome, blocker, or decision that matters; then include only unfinished work, a needed decision, and concrete handles a subscriber may need. This concludes the conversation; it does not finish the mandate.\n\n'
+    + '6. End with a short sign-off to the reader in second person: say you are putting your notes in order and pausing here until they come back, and mention anything genuinely worth their attention, such as unfinished work or an open question. Keep all visible text this turn—including the update\'s first line—about their work, not crouter\'s machinery: do not mention roadmap or context paths, filing a report, parking, idling, residency, or node ids. Then stop. A later message reopens you on a fresh context window grounded in your goal and roadmap, so the inheritance you leave now is what you get back.';
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
 export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.249",
+  "version": "0.3.250",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -83,10 +83,10 @@
     "dev": "tsx --conditions=crtr-src src/cli.ts",
     "link": "npm link",
     "prepublishOnly": "npm run build",
-    "test": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --test --test-force-exit --test-concurrency=$(node -p 'Math.max(4, require(`node:os`).availableParallelism() - 1)') --test-timeout=10000 'src/**/__tests__/*.test.ts'",
-    "test:integration": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --test --test-concurrency=$(node -p 'Math.min(8, Math.max(2, require(`node:os`).availableParallelism() - 1))') --test-timeout=60000 'src/**/__tests__/integration/*.test.ts'",
+    "test": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --import ./scripts/test-env-scrub.mjs --test --test-force-exit --test-concurrency=$(node -p 'Math.max(4, require(`node:os`).availableParallelism() - 1)') --test-timeout=10000 'src/**/__tests__/*.test.ts'",
+    "test:integration": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --import ./scripts/test-env-scrub.mjs --test --test-concurrency=$(node -p 'Math.min(8, Math.max(2, require(`node:os`).availableParallelism() - 1))') --test-timeout=60000 'src/**/__tests__/integration/*.test.ts'",
     "test:seam": "npm run build && npm run test:seam:built",
-    "test:seam:built": "CRTR_NO_DAEMON_AUTOSTART=1 node --test --test-concurrency=4 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'",
+    "test:seam:built": "CRTR_NO_DAEMON_AUTOSTART=1 node --import ./scripts/test-env-scrub.mjs --test --test-concurrency=4 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'",
     "test:all": "npm test && npm run test:integration && npm run test:seam"
   },
   "overrides": {

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.249",
+  "version": "0.3.250",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.249",
+      "version": "0.3.250",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

package/dist/builtin-pi-packages/pi-crtr-extensions/extensions/statusline.ts

@@ -1,254 +0,0 @@
-/**
- * Statusline + session-name badge.
- *
- * Footer (statusline): <model> [· subscription] · <tokens used> · <cycle>, with
- *                      <cwd last dir> (<git>) right-aligned on the far right.
- * Input bar border:    session name rendered as a solid-background badge,
- *                      shown only when a name is set (via /name or
- *                      pi.setSessionName()).
- *
- * This extension owns only the statusline and session-name badge. Canvas
- * navigation and interactive chrome live in crouter's attach viewer.
- */
-
-import { execFile } from 'node:child_process';
-import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-import { CustomEditor, type ExtensionContext } from '@earendil-works/pi-coding-agent';
-import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-
-function lastDir(cwd: string): string {
-	const trimmed = cwd.replace(/\/+$/, "");
-	const base = trimmed.split("/").pop();
-	return base && base.length > 0 ? base : "/";
-}
-
-function fmtTokens(n: number): string {
-	return n < 1000 ? `${n}` : `${Math.round(n / 1000)}k`;
-}
-
-interface GitStatus {
-	staged: number;
-	modified: number;
-	untracked: number;
-	conflicts: number;
-	ahead: number;
-	behind: number;
-	stashed: number;
-}
-
-/** Run `git status --porcelain=v1 --branch` and parse a summary. */
-function loadGitStatus(cwd: string): Promise<GitStatus | null> {
-	return new Promise((resolve) => {
-		execFile(
-			"git",
-			["status", "--porcelain=v1", "--branch", "--untracked-files=all"],
-			{ cwd, timeout: 2000, windowsHide: true },
-			(err, stdout) => {
-				if (err) return resolve(null);
-				const s: GitStatus = {
-					staged: 0,
-					modified: 0,
-					untracked: 0,
-					conflicts: 0,
-					ahead: 0,
-					behind: 0,
-					stashed: 0,
-				};
-				for (const line of stdout.split("\n")) {
-					if (line.startsWith("## ")) {
-						const ahead = line.match(/ahead (\d+)/);
-						const behind = line.match(/behind (\d+)/);
-						if (ahead) s.ahead = Number(ahead[1]);
-						if (behind) s.behind = Number(behind[1]);
-						continue;
-					}
-					if (line.length < 2) continue;
-					const x = line[0];
-					const y = line[1];
-					if (x === "?" && y === "?") {
-						s.untracked++;
-					} else if (x === "U" || y === "U" || (x === "A" && y === "A") || (x === "D" && y === "D")) {
-						s.conflicts++;
-					} else {
-						if (x !== " " && x !== "?") s.staged++;
-						if (y !== " " && y !== "?") s.modified++;
-					}
-				}
-				resolve(s);
-			},
-		);
-	});
-}
-
-/** Render git status using standard prompt symbols. */
-function fmtGitStatus(s: GitStatus | null): string {
-	if (!s) return "";
-	const parts: string[] = [];
-	if (s.ahead) parts.push(`⇡${s.ahead}`); // ⇡ ahead
-	if (s.behind) parts.push(`⇣${s.behind}`); // ⇣ behind
-	if (s.conflicts) parts.push(`×${s.conflicts}`); // × conflicts
-	if (s.staged) parts.push(`+${s.staged}`); // + staged
-	if (s.modified) parts.push(`!${s.modified}`); // ! modified
-	if (s.untracked) parts.push(`?${s.untracked}`); // ? untracked
-	if (s.stashed) parts.push(`$${s.stashed}`); // $ stashed
-	if (parts.length === 0) return "✓"; // ✓ clean
-	return parts.join(" ");
-}
-
-function formatTokens(ctx: Pick<ExtensionContext, "getContextUsage">): string {
-	const usage = ctx.getContextUsage();
-	if (!usage || usage.tokens == null) return "0 tokens";
-	return `${fmtTokens(usage.tokens)} tokens`;
-}
-
-interface FooterDataLike {
-	// pi's provider reports "no branch" as null; keep undefined too so tests can pass a
-	// bare stub.
-	getGitBranch(): string | null | undefined;
-	getExtensionStatuses(): ReadonlyMap<string, string>;
-}
-
-export function buildStatuslineFooterLine(
-	width: number,
-	ctx: Pick<ExtensionContext, "cwd" | "model" | "getContextUsage">,
-	footerData: FooterDataLike,
-	gitStatus: GitStatus | null,
-): string {
-	if (width <= 0) return "";
-
-	const cwd = lastDir(ctx.cwd);
-	const branch = footerData.getGitBranch();
-	const status = fmtGitStatus(gitStatus);
-	const gitStr = branch
-		? status
-			? `${branch} ${status}`
-			: branch
-		: "";
-	const cwdStr = gitStr ? `${cwd} (${gitStr})` : cwd;
-
-	const model = ctx.model?.id ?? "no model";
-	const subscription = footerData.getExtensionStatuses().get("provider-rotation")?.trim() ?? "";
-	const tokens = formatTokens(ctx);
-	const cyclesEnv = process.env["CRTR_CYCLES"]?.trim();
-	const cycleCount = cyclesEnv ? Number.parseInt(cyclesEnv, 10) : Number.NaN;
-	const cycle = Number.isFinite(cycleCount) ? `↻${cycleCount}` : "";
-
-	const leftParts = [model];
-	if (subscription !== "") leftParts.push(subscription);
-	leftParts.push(tokens);
-	if (cycle !== "") leftParts.push(cycle);
-	const leftRaw = leftParts.join(" · ");
-	let rightRaw = cwdStr;
-
-	let rightWidth = visibleWidth(rightRaw);
-	if (rightWidth > width) {
-		const cwdWidth = visibleWidth(cwd);
-		if (cwdWidth < width) {
-			rightRaw = cwd;
-			rightWidth = cwdWidth;
-		} else {
-			return truncateToWidth(cwd, width);
-		}
-	}
-
-	if (rightWidth === width) return rightRaw;
-
-	const leftLimit = Math.max(0, width - rightWidth - 1);
-	const leftRawClamped = truncateToWidth(leftRaw, leftLimit);
-	const leftWidth = visibleWidth(leftRawClamped);
-	const padWidth = Math.max(1, width - leftWidth - rightWidth);
-	return `${leftRawClamped}${" ".repeat(padWidth)}${rightRaw}`;
-}
-
-/** Insert `badge` into a single border line at the left, after one corner cell. */
-function borderWithBadge(
-	width: number,
-	badge: string,
-	border: (text: string) => string,
-): string {
-	if (width <= 0) return "";
-	const badgeWidth = visibleWidth(badge);
-	// 1 leading border cell + badge + fill out to width.
-	if (badgeWidth + 1 >= width) {
-		return border("─") + truncateToWidth(badge, Math.max(0, width - 1), "");
-	}
-	const fill = border("─".repeat(width - 1 - badgeWidth));
-	return `${border("─")}${badge}${fill}`;
-}
-
-export default function (pi: ExtensionAPI) {
-	pi.on("session_start", (_event, ctx) => {
-		// Statusline (footer): model · [subscription] · tokens · cycle, with cwd/git right-aligned
-		ctx.ui.setFooter((tui, theme, footerData) => {
-			let gitStatus: GitStatus | null = null;
-
-			const refreshStatus = () => {
-				if (!footerData.getGitBranch()) {
-					if (gitStatus) {
-						gitStatus = null;
-						tui.requestRender();
-					}
-					return;
-				}
-				void loadGitStatus(ctx.cwd).then((next) => {
-					if (JSON.stringify(next) !== JSON.stringify(gitStatus)) {
-						gitStatus = next;
-						tui.requestRender();
-					}
-				});
-			};
-
-			refreshStatus();
-			const unsubBranch = footerData.onBranchChange(() => {
-				tui.requestRender();
-				refreshStatus();
-			});
-			const timer = setInterval(refreshStatus, 4000);
-
-			return {
-				dispose() {
-					unsubBranch();
-					clearInterval(timer);
-				},
-				invalidate() {},
-				render(width: number): string[] {
-					return [theme.fg("dim", buildStatuslineFooterLine(width, ctx, footerData, gitStatus))];
-				},
-			};
-		});
-
-		// Input bar border: session-name badge with solid background
-		// Compose with whatever editor is already installed instead of replacing it:
-		// wrap the previous factory in a Proxy that overrides only render
-		// (session-name badge on the top border). Other editor decorations keep
-		// working regardless of load order.
-		const previousEditorFactory = ctx.ui.getEditorComponent();
-		ctx.ui.setEditorComponent((tui, theme, keybindings) => {
-			const base = (
-				previousEditorFactory
-					? previousEditorFactory(tui, theme, keybindings)
-					: new CustomEditor(tui, theme, keybindings)
-			) as unknown as CustomEditor;
-
-			const render = (width: number): string[] => {
-				const lines = base.render(width);
-				const name = pi.getSessionName();
-				if (!name || lines.length === 0) return lines;
-
-				const thm = ctx.ui.theme;
-				const badge = thm.bg("selectedBg", thm.fg("text", ` ${name} `));
-				const borderColor = (text: string) => base.borderColor(text);
-				lines[0] = borderWithBadge(width, badge, borderColor);
-				return lines;
-			};
-
-			return new Proxy(base, {
-				get(target, prop) {
-					if (prop === "render") return render;
-					const value = Reflect.get(target, prop, target);
-					return typeof value === "function" ? value.bind(target) : value;
-				},
-			});
-		});
-	});
-}

package/dist/pi-extensions/truncate.d.ts

@@ -1,5 +0,0 @@
-/** Hard-truncate to `width` columns with an ellipsis when the text would
- *  overflow. Extension-rendered content is ANSI-free plain text, so a
- *  code-point count stands in for visible width. Every renderer MUST keep its
- *  emitted lines within the terminal width or pi's TUI aborts the whole render. */
-export declare function truncateToWidth(text: string, width: number): string;

package/dist/pi-extensions/truncate.js

@@ -1,14 +0,0 @@
-/** Hard-truncate to `width` columns with an ellipsis when the text would
- *  overflow. Extension-rendered content is ANSI-free plain text, so a
- *  code-point count stands in for visible width. Every renderer MUST keep its
- *  emitted lines within the terminal width or pi's TUI aborts the whole render. */
-export function truncateToWidth(text, width) {
-    if (width <= 0)
-        return '';
-    const chars = Array.from(text);
-    if (chars.length <= width)
-        return text;
-    if (width === 1)
-        return '…';
-    return chars.slice(0, width - 1).join('') + '…';
-}