very-happy-cli 0.2.179 → 0.2.181

package/dist/{deterministicJson-D_whDMFd.mjs → deterministicJson-BcBIKKf1.mjs}

@@ -1,28 +1,29 @@
-import { l as logger } from './logger-BtVhHnD8.mjs';
-import { p as prependToMessage, b as buildDigestLine, a as buildFirstTurnPrefix } from './prompt-BOouDaTM.mjs';
-import { P as ProjectsUnsupportedError } from './client-BhoEBnuN.mjs';
-import { c as createSelfReportState, A as AUTOMATION_TOOL_NAMES, P as PROJECT_TOOL_NAMES, r as registerAutomationTools, a as registerProjectTools, d as createProjectToolExecutor, b as registerReportProgressTool, n as normalizeAttention, e as normalizePhase, f as normalizeProgress, s as shouldAcceptSelfReport } from './reportProgressTool-gHItlSzz.mjs';
-import { C as ContextUsageSchema } from './index-DPOa4NhL.mjs';
+import { l as logger } from './logger-LFr8iPgl.mjs';
+import { p as prependToMessage, b as buildDigestLine, a as buildFirstTurnPrefix } from './prompt-QHuFx9j6.mjs';
+import { P as ProjectsUnsupportedError } from './client-BKyU66lg.mjs';
+import { c as createSelfReportState, A as AUTOMATION_TOOL_NAMES, P as PROJECT_TOOL_NAMES, r as registerAutomationTools, a as registerProjectTools, d as createProjectToolExecutor, b as registerReportProgressTool, n as normalizeAttention, e as normalizePhase, f as normalizeProgress, s as shouldAcceptSelfReport } from './reportProgressTool-tPxEvh6x.mjs';
+import { readFileSync, constants } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { z } from 'zod';
+import { p as piAgentDir } from './pi-CqyoZMjI.mjs';
 import { unlink, mkdir, open, rename } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
-import { constants } from 'node:fs';
-import { dirname } from 'node:path';
-import { z } from 'zod';
-import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-DuTDwWSQ.mjs';
-import { t as teamScopePath } from './context-DploEcoN.mjs';
-import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-BIGgRube.mjs';
-import { T as TEAM_SKILL } from './resources-y9jfyO-_.mjs';
-import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-D8-PnZEG.mjs';
-import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-CWKzcQ7u.mjs';
+import { T as TeamConnectionPreflightError, S as SessionInOtherTeamError, c as createTeamsClient } from './client-DsQcxVUV.mjs';
+import { t as teamScopePath } from './context-_YGq8xdH.mjs';
+import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-DqlftXxe.mjs';
+import { T as TEAM_SKILL, a as TEAM_LEAD_PLAYBOOK } from './resources-CH1iP6Cv.mjs';
+import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-D2E--n1x.mjs';
+import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-CK3JYu1k.mjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { createServer } from 'node:http';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, c as CLIPBOARD_MAX_BYTES } from './limits-DIo7rEBR.mjs';
-import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools, c as checkDownloadTarget } from './downloadTarget-BoNwTIH_.mjs';
+import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools, c as checkDownloadTarget } from './downloadTarget-CeaAXdJj.mjs';
 import { P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as PREVIEW_DOWNLOAD_PARAM_DESCRIPTION } from './agentGuidance-BDYt2Qy2.mjs';
 import { n as normalizeWebPanels, w as webPanelPath } from './webPanels-B2_C2-3g.mjs';
-import { r as readSettings } from './persistence-Cr-wutZ4.mjs';
-import { g as getSessionNotificationBody } from './pushNotifications-BdFjDjQe.mjs';
+import { r as readSettings } from './persistence-D2Djrf7t.mjs';
+import { g as getSessionNotificationBody } from './pushNotifications-DXGIhE-A.mjs';
 import { c as checkPreviewPath } from './previewPath-CXN4Vag0.mjs';
 import { createHash } from 'crypto';
 
@@ -119,11 +120,67 @@ function createProjectInjector(deps) {
   };
 }
 
+const PiContextReportSchema = z.object({
+  source: z.literal("pi"),
+  tokens: z.number().finite().nonnegative().nullable(),
+  contextWindow: z.number().finite().positive(),
+  model: z.string().max(200).nullable().optional(),
+  provider: z.string().max(200).nullable().optional(),
+  /** The pi event that produced the report (`session_compact`, `turn_end`, …). */
+  event: z.string().max(64).nullable().optional(),
+  /** Other registry entries with the same model id. */
+  peers: z.array(z.object({ provider: z.string().max(200), contextWindow: z.number().finite().positive() })).max(8).optional()
+});
+const obj = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : null;
+const positive = (v) => typeof v === "number" && Number.isFinite(v) && v > 0;
+function piWindowConfigured(modelsJson, provider, model) {
+  if (!modelsJson || !provider || !model) return true;
+  const config = obj(obj(modelsJson.providers)?.[provider]);
+  if (!config) return true;
+  if (positive(obj(obj(config.modelOverrides)?.[model])?.contextWindow)) return true;
+  const models = Array.isArray(config.models) ? config.models : [];
+  const entry = models.map(obj).find((m) => m?.id === model);
+  if (!entry) return true;
+  return positive(entry.contextWindow);
+}
+function resolvePiContextUsage(report, modelsJson, previous, now) {
+  let windowSource = "configured";
+  let contextWindow = report.contextWindow;
+  if (!piWindowConfigured(modelsJson, report.provider, report.model)) {
+    const known = new Set((report.peers ?? []).filter((p) => p.provider !== report.provider && piWindowConfigured(modelsJson, p.provider, report.model)).map((p) => p.contextWindow));
+    if (known.size === 1) {
+      windowSource = "inferred";
+      contextWindow = [...known][0];
+    } else {
+      windowSource = "unknown";
+    }
+  }
+  const compactedAt = report.event === "session_compact" ? now : report.tokens === null ? previous?.compactedAt ?? null : null;
+  return {
+    source: "pi",
+    tokens: report.tokens,
+    contextWindow,
+    updatedAt: now,
+    windowSource,
+    model: report.model ?? null,
+    compactedAt
+  };
+}
+function readPiModelsJson(env = process.env, home = homedir()) {
+  try {
+    return obj(JSON.parse(readFileSync(join(piAgentDir({ home, env }), "models.json"), "utf8")));
+  } catch {
+    return null;
+  }
+}
+
 const TEAMS_ADOPT_CAPABILITY = "teams-adopt-v1";
 const TeamAdoptSchema = z.object({
   requestId: z.string().min(1).max(128),
   name: z.string().trim().min(1).max(128),
-  teamId: z.string().min(1).max(128).optional()
+  teamId: z.string().min(1).max(128).optional(),
+  /** B-730: the owner confirmed moving this session out of the team it already belongs to. */
+  transfer: z.literal(true).optional()
 }).strict();
 async function retainIntent(path, input) {
   await mkdir(dirname(path), { recursive: true, mode: 448 });
@@ -206,7 +263,9 @@ function createTeamAdoption(sessionId) {
         const connected = await client.initialize(input, { resumeAdoption: true, expectedTeamId: intent.resolvedTeamId, onTeamResolved: (teamId) => retainTeam(path, input, teamId, intent?.guidanceDelivered) });
         const instructions = `${TEAM_SKILL}
 
-This session is now connected as the team lead. Call team_inspect to read the authoritative state before continuing the user's goal. Do not call team_create or team_join again.`;
+This session is now connected as the team lead. Call team_inspect to read the authoritative state before continuing the user's goal. Do not call team_create or team_join again.
+
+${TEAM_LEAD_PLAYBOOK}`;
         if (!intent.guidanceDelivered) {
           const key = await waitForSessionKey(sessionId, 1e4);
           await sendUserMessage(sessionId, key, instructions, "teams", { localId: `teams-adopt-${input.requestId}`, sentFrom: "team" });
@@ -219,7 +278,12 @@ This session is now connected as the team lead. Call team_inspect to read the au
           });
           operation.safeToChange = true;
         }
-        operation.result = { error: error instanceof Error ? error.message : "Team connection failed; retry the same request", ...operation.safeToChange ? { safeToChange: true } : {} };
+        operation.result = {
+          error: error instanceof Error ? error.message : "Team connection failed; retry the same request",
+          ...operation.safeToChange ? { safeToChange: true } : {},
+          // B-730: the Web asks the owner to confirm a transfer, then sends a new request with `transfer`.
+          ...error instanceof SessionInOtherTeamError ? { code: error.code, teamId: error.teamId, teamName: error.teamName } : {}
+        };
       }
     })();
     return { status: "pending", requestId: input.requestId };
@@ -534,13 +598,12 @@ async function startHappyServer(client, options) {
         let body = "";
         for await (const chunk of req) {
           body += chunk.toString();
-          if (Buffer.byteLength(body) > 2048) {
+          if (Buffer.byteLength(body) > 4096) {
             res.writeHead(413).end();
             return;
           }
         }
-        const usage = ContextUsageSchema.parse({ ...JSON.parse(body), updatedAt: Date.now() });
-        options.onContextUsage(usage);
+        options.onContextUsage(PiContextReportSchema.parse(JSON.parse(body)));
         res.writeHead(204).end();
       } catch {
         if (!res.headersSent) res.writeHead(400).end();
@@ -688,4 +751,4 @@ function hashObject(obj, options, encoding = "hex") {
   return createHash("sha256").update(jsonString).digest(encoding);
 }
 
-export { createProjectInjector as c, hashObject as h, startHappyServer as s };
+export { resolvePiContextUsage as a, createProjectInjector as c, hashObject as h, readPiModelsJson as r, startHappyServer as s };

package/dist/{doctor-Br1Kcy2J.cjs → doctor-Be7zC0AF.cjs}

@@ -1,19 +1,19 @@
 'use strict';
 
 var chalk = require('chalk');
-var configuration = require('./configuration-CMHZnp6G.cjs');
-var persistence = require('./persistence-BegE7NPa.cjs');
-var controlClient = require('./controlClient-C-5qCt8W.cjs');
+var configuration = require('./configuration-C8JgseHy.cjs');
+var persistence = require('./persistence-BY-D00wT.cjs');
+var controlClient = require('./controlClient-D68Zj7Q-.cjs');
 var doctor$1 = require('./doctor-u46qYYKX.cjs');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-SgqTYsjn.cjs');
-var doctorReadiness = require('./doctorReadiness-BCZGcN0a.cjs');
+var projectPath = require('./projectPath-C3ioB4Bu.cjs');
+var _package = require('./package-NoD8QOOM.cjs');
+var doctorReadiness = require('./doctorReadiness-Dl6yRQCy.cjs');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
 var cliUpdate = require('./cliUpdate-DsKXPFYp.cjs');
 var node_child_process = require('node:child_process');
-var piRunnerArgs = require('./piRunnerArgs-Cs-378Vz.cjs');
+var piRunnerArgs = require('./piRunnerArgs-gxLYIZH4.cjs');
 
 function shareSafeProcessLine(process2) {
   return `PID ${process2.pid}: command arguments hidden for privacy`;
@@ -313,8 +313,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-BWcz8mz0.cjs'); });
-    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-B0UjHlAe.cjs'); });
+    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-BtUmGcPX.cjs'); });
+    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-BkluinoS.cjs'); });
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));
@@ -391,6 +391,7 @@ var doctor = /*#__PURE__*/Object.freeze({
     runDoctorDaemon: runDoctorDaemon
 });
 
+exports.NPM_SAFE_ARG = NPM_SAFE_ARG;
 exports.doctor = doctor;
 exports.getEnvironmentInfo = getEnvironmentInfo;
 exports.globalPrefixForPackage = globalPrefixForPackage;

package/dist/{doctor-CmtSsR2-.mjs → doctor-CoOaPq6w.mjs}

@@ -1,17 +1,17 @@
 import chalk from 'chalk';
-import { c as configuration } from './configuration-WMi4idBB.mjs';
-import { r as readSettings, g as readCredentials, d as readDaemonState } from './persistence-Cr-wutZ4.mjs';
-import { a as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-BWUJrj3t.mjs';
+import { c as configuration } from './configuration-BPrfb17M.mjs';
+import { r as readSettings, g as readCredentials, d as readDaemonState } from './persistence-D2Djrf7t.mjs';
+import { a as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-CkNpT5zS.mjs';
 import { findAllHappyProcesses } from './doctor-BPkYWSuq.mjs';
 import { statSync, realpathSync, existsSync, readdirSync } from 'node:fs';
 import { isAbsolute, resolve, dirname, basename, delimiter, join } from 'node:path';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-BPPebGQF.mjs';
+import { p as packageJson } from './package-DYGwlmXl.mjs';
 import { s as shareableSettingsSummary, c as collectRuntimeReadiness, S as SUPPORTED_NODE_LABEL, r as resolveClaudeCredentialReadiness, a as toolProbeLabel, b as daemonReadiness, d as daemonEndpointsMatch } from './doctorReadiness-C208SMN9.mjs';
 import { c as credentialRelayProblem } from './authRelay-DhQhkBvX.mjs';
 import { d as deriveLocalCliUpdateSummary } from './cliUpdate-Y34VGe9Y.mjs';
 import { spawnSync } from 'node:child_process';
-import { c as piInstallCommand } from './piRunnerArgs-DwvM_yWA.mjs';
+import { c as piInstallCommand } from './piRunnerArgs-IZLoL7TG.mjs';
 
 function shareSafeProcessLine(process2) {
   return `PID ${process2.pid}: command arguments hidden for privacy`;
@@ -311,8 +311,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await import('./agentHome-CghLvL_1.mjs');
-    const { describeAgentHome } = await import('./index-CdQI0C9p.mjs');
+    const { resolveAgentHomesForCli } = await import('./agentHome-B1BsKeqD.mjs');
+    const { describeAgentHome } = await import('./index-CO0n9ue6.mjs');
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));
@@ -389,4 +389,4 @@ var doctor = /*#__PURE__*/Object.freeze({
     runDoctorDaemon: runDoctorDaemon
 });
 
-export { getEnvironmentInfo as a, doctor as d, globalPrefixForPackage as g };
+export { NPM_SAFE_ARG as N, globalPrefixForPackage as a, doctor as d, getEnvironmentInfo as g };

package/dist/{doctorReadiness-BCZGcN0a.cjs → doctorReadiness-Dl6yRQCy.cjs}

@@ -4,7 +4,7 @@ var node_child_process = require('node:child_process');
 var node_fs = require('node:fs');
 var os = require('node:os');
 var path = require('node:path');
-var detectCLI = require('./detectCLI-DR9ZaN6B.cjs');
+var detectCLI = require('./detectCLI-BuYR_Qxe.cjs');
 
 const SUPPORTED_NODE_LABEL = "20.19+ within 20.x, 22.13+ within 22.x, or 24+";
 const MIN_TMUX_ENV_MAJOR = 3;

package/dist/{downloadTarget-BoNwTIH_.mjs → downloadTarget-CeaAXdJj.mjs}

@@ -1,14 +1,14 @@
 import { readFile, writeFile, appendFile, stat } from 'node:fs/promises';
 import os from 'node:os';
 import { z } from 'zod';
-import { l as logger } from './logger-BtVhHnD8.mjs';
-import { c as readPersistedSessions } from './persistence-Cr-wutZ4.mjs';
-import { f as spawnDaemonSession } from './controlClient-BWUJrj3t.mjs';
-import { a as listSessions, r as readSessionTranscript, s as sessionWebUrl, g as waitForSessionKey, e as sendUserMessage, b as stopSession, d as archiveSession } from './sessionOps-BIGgRube.mjs';
-import { r as readRemoteTranscript, s as sendRemoteMessage, d as deliverToSession, R as RemoteSessionOpsError } from './remoteSessionClient-Bn2qu5C5.mjs';
+import { l as logger } from './logger-LFr8iPgl.mjs';
+import { c as readPersistedSessions } from './persistence-D2Djrf7t.mjs';
+import { e as spawnDaemonSession } from './controlClient-CkNpT5zS.mjs';
+import { a as listSessions, r as readSessionTranscript, s as sessionWebUrl, g as waitForSessionKey, e as sendUserMessage, b as stopSession, d as archiveSession } from './sessionOps-DqlftXxe.mjs';
+import { r as readRemoteTranscript, s as sendRemoteMessage, d as deliverToSession, R as RemoteSessionOpsError } from './remoteSessionClient-B2POSKFT.mjs';
 import { i as isValidSessionId, a as isValidTerminalId } from './ids-DU6sLx4C.mjs';
 import { l as listVhTerminals, r as readVhTerminal, s as sendToVhTerminal } from './terminals-Dlg0x3nY.mjs';
-import { bootstrapAssistantHome, assistantPersonalMemoryPath } from './bootstrap-iuyufnp3.mjs';
+import { bootstrapAssistantHome, assistantPersonalMemoryPath } from './bootstrap-B6EkZh4u.mjs';
 import { join, isAbsolute, normalize } from 'node:path';
 
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;

package/dist/{downloadTarget-BQJK_6oH.cjs → downloadTarget-LyOiucn_.cjs}

@@ -3,14 +3,14 @@
 var promises = require('node:fs/promises');
 var os = require('node:os');
 var z = require('zod');
-var logger = require('./logger-C1GWx3gi.cjs');
-var persistence = require('./persistence-BegE7NPa.cjs');
-var controlClient = require('./controlClient-C-5qCt8W.cjs');
-var sessionOps = require('./sessionOps-S-qPBLFf.cjs');
-var remoteSessionClient = require('./remoteSessionClient-B7i7MkYV.cjs');
+var logger = require('./logger-DgBwUSgS.cjs');
+var persistence = require('./persistence-BY-D00wT.cjs');
+var controlClient = require('./controlClient-D68Zj7Q-.cjs');
+var sessionOps = require('./sessionOps-DVA-00nR.cjs');
+var remoteSessionClient = require('./remoteSessionClient-CFCn42bs.cjs');
 var ids = require('./ids-B6ZC0HGt.cjs');
 var terminals = require('./terminals-B_bfC9c2.cjs');
-var bootstrap = require('./bootstrap-exVucYav.cjs');
+var bootstrap = require('./bootstrap-CYtOtbi7.cjs');
 var path = require('node:path');
 
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;

package/dist/{ensureDaemonRunning-Czo9IHJQ.mjs → ensureDaemonRunning--98j7-17.mjs}

@@ -1,8 +1,8 @@
-import { l as logger } from './logger-BtVhHnD8.mjs';
-import { i as isDaemonRunningCurrentlyInstalledHappyVersion, a as checkIfDaemonRunningAndCleanupStaleState, b as stopDaemon } from './controlClient-BWUJrj3t.mjs';
-import { s as spawnHappyCLI } from './spawnHappyCLI-CCOrEtf9.mjs';
-import { d as readDaemonState } from './persistence-Cr-wutZ4.mjs';
-import { c as configuration } from './configuration-WMi4idBB.mjs';
+import { l as logger } from './logger-LFr8iPgl.mjs';
+import { i as isDaemonRunningCurrentlyInstalledHappyVersion, a as checkIfDaemonRunningAndCleanupStaleState, s as stopDaemon } from './controlClient-CkNpT5zS.mjs';
+import { s as spawnHappyCLI } from './spawnHappyCLI-Dq3LLXLb.mjs';
+import { d as readDaemonState } from './persistence-D2Djrf7t.mjs';
+import { c as configuration } from './configuration-BPrfb17M.mjs';
 import { d as daemonEndpointsMatch } from './doctorReadiness-C208SMN9.mjs';
 
 function extractNoSandboxFlag(args) {

package/dist/{ensureDaemonRunning-BRUmsq6J.cjs → ensureDaemonRunning-B8z37VKD.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var logger = require('./logger-C1GWx3gi.cjs');
-var controlClient = require('./controlClient-C-5qCt8W.cjs');
-var spawnHappyCLI = require('./spawnHappyCLI-Dywezwk6.cjs');
-var persistence = require('./persistence-BegE7NPa.cjs');
-var configuration = require('./configuration-CMHZnp6G.cjs');
-var doctorReadiness = require('./doctorReadiness-BCZGcN0a.cjs');
+var logger = require('./logger-DgBwUSgS.cjs');
+var controlClient = require('./controlClient-D68Zj7Q-.cjs');
+var spawnHappyCLI = require('./spawnHappyCLI-DnKmIsEt.cjs');
+var persistence = require('./persistence-BY-D00wT.cjs');
+var configuration = require('./configuration-C8JgseHy.cjs');
+var doctorReadiness = require('./doctorReadiness-Dl6yRQCy.cjs');
 
 function extractNoSandboxFlag(args) {
   let noSandbox = false;

package/dist/fileStore-5qpetZS0.mjs

@@ -0,0 +1,146 @@
+import { randomBytes, createHash } from 'node:crypto';
+import { promises, constants } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+
+const MAX_CONFIG_BYTES = 1024 * 1024;
+const MAX_BACKUPS_PER_HARNESS = 20;
+class ModelConfigError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ModelConfigError";
+  }
+}
+function sha256(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+async function readConfigFile(path) {
+  let stat;
+  try {
+    stat = await promises.stat(path);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { path, exists: false, content: "", hash: sha256(""), mode: null };
+    }
+    throw new ModelConfigError("read-failed", `Cannot read ${path}: ${error.message}`);
+  }
+  if (!stat.isFile()) throw new ModelConfigError("not-a-file", `${path} is not a regular file`);
+  if (stat.size > MAX_CONFIG_BYTES) throw new ModelConfigError("file-too-large", `${path} is larger than ${MAX_CONFIG_BYTES} bytes`);
+  const content = await promises.readFile(path, "utf8");
+  return { path, exists: true, content, hash: sha256(content), mode: stat.mode & 511 };
+}
+async function resolveWriteTarget(path) {
+  try {
+    return await promises.realpath(path);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      try {
+        const link = await promises.readlink(path);
+        return link.startsWith("/") ? link : join(dirname(path), link);
+      } catch {
+        return path;
+      }
+    }
+    throw error;
+  }
+}
+async function atomicWriteFile(path, content, mode) {
+  const target = await resolveWriteTarget(path);
+  const dir = dirname(target);
+  await promises.mkdir(dir, { recursive: true, mode: 448 });
+  const tmp = join(dir, `.${basename(target)}.vh-tmp-${process.pid}-${randomBytes(4).toString("hex")}`);
+  const handle = await promises.open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, mode ?? 384);
+  try {
+    await handle.writeFile(content, "utf8");
+    await handle.sync();
+  } catch (error) {
+    await handle.close().catch(() => {
+    });
+    await promises.unlink(tmp).catch(() => {
+    });
+    throw error;
+  }
+  await handle.close();
+  try {
+    if (mode !== null) await promises.chmod(tmp, mode);
+    await promises.rename(tmp, target);
+  } catch (error) {
+    await promises.unlink(tmp).catch(() => {
+    });
+    throw error;
+  }
+  try {
+    const dirHandle = await promises.open(dir, "r");
+    await dirHandle.sync().catch(() => {
+    });
+    await dirHandle.close();
+  } catch {
+  }
+}
+const BACKUP_ID = /^\d{13}-[0-9a-f]{8}$/;
+const HARNESS_DIR = /^[a-z][a-z0-9-]{0,31}$/;
+class BackupStore {
+  constructor(root) {
+    this.root = root;
+  }
+  harnessDir(harness) {
+    if (!HARNESS_DIR.test(harness)) throw new ModelConfigError("invalid-harness", "Invalid harness");
+    return join(this.root, harness);
+  }
+  async create(harness, reason, files, now = Date.now()) {
+    const id = `${now}-${randomBytes(4).toString("hex")}`;
+    const dir = join(this.harnessDir(harness), id);
+    await promises.mkdir(dir, { recursive: true, mode: 448 });
+    const manifest = { id, createdAt: now, reason, files: files.map((f, i) => ({ path: f.path, blob: f.content === null ? null : `f${i}`, mode: f.mode })) };
+    for (const [i, file] of files.entries()) {
+      if (file.content !== null) await promises.writeFile(join(dir, `f${i}`), file.content, { encoding: "utf8", mode: 384 });
+    }
+    await promises.writeFile(join(dir, "manifest.json"), JSON.stringify(manifest, null, 2), { encoding: "utf8", mode: 384 });
+    await this.prune(harness);
+    return { id, createdAt: now, reason, files: files.map((f) => f.path) };
+  }
+  async list(harness) {
+    let names;
+    try {
+      names = await promises.readdir(this.harnessDir(harness));
+    } catch {
+      return [];
+    }
+    const entries = [];
+    for (const name of names.filter((n) => BACKUP_ID.test(n))) {
+      try {
+        const manifest = JSON.parse(await promises.readFile(join(this.harnessDir(harness), name, "manifest.json"), "utf8"));
+        entries.push({ id: name, createdAt: Number(manifest.createdAt) || 0, reason: String(manifest.reason ?? ""), files: (manifest.files ?? []).map((f) => f.path) });
+      } catch {
+      }
+    }
+    return entries.sort((a, b) => b.createdAt - a.createdAt);
+  }
+  async read(harness, id) {
+    if (!BACKUP_ID.test(id)) throw new ModelConfigError("invalid-backup", "Invalid backup id");
+    const dir = join(this.harnessDir(harness), id);
+    let manifest;
+    try {
+      manifest = JSON.parse(await promises.readFile(join(dir, "manifest.json"), "utf8"));
+    } catch {
+      throw new ModelConfigError("backup-not-found", "Backup not found");
+    }
+    const out = [];
+    for (const file of manifest.files) {
+      out.push({
+        path: file.path,
+        content: file.blob === null ? null : await promises.readFile(join(dir, file.blob), "utf8"),
+        mode: typeof file.mode === "number" ? file.mode : null
+      });
+    }
+    return out;
+  }
+  async prune(harness) {
+    const entries = await this.list(harness);
+    for (const stale of entries.slice(MAX_BACKUPS_PER_HARNESS)) {
+      await promises.rm(join(this.harnessDir(harness), stale.id), { recursive: true, force: true });
+    }
+  }
+}
+
+export { BackupStore as B, ModelConfigError as M, atomicWriteFile as a, readConfigFile as r, sha256 as s };

package/dist/fileStore-7qhnbs6N.cjs

@@ -0,0 +1,152 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var node_fs = require('node:fs');
+var path = require('node:path');
+
+const MAX_CONFIG_BYTES = 1024 * 1024;
+const MAX_BACKUPS_PER_HARNESS = 20;
+class ModelConfigError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ModelConfigError";
+  }
+}
+function sha256(text) {
+  return node_crypto.createHash("sha256").update(text).digest("hex");
+}
+async function readConfigFile(path) {
+  let stat;
+  try {
+    stat = await node_fs.promises.stat(path);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { path, exists: false, content: "", hash: sha256(""), mode: null };
+    }
+    throw new ModelConfigError("read-failed", `Cannot read ${path}: ${error.message}`);
+  }
+  if (!stat.isFile()) throw new ModelConfigError("not-a-file", `${path} is not a regular file`);
+  if (stat.size > MAX_CONFIG_BYTES) throw new ModelConfigError("file-too-large", `${path} is larger than ${MAX_CONFIG_BYTES} bytes`);
+  const content = await node_fs.promises.readFile(path, "utf8");
+  return { path, exists: true, content, hash: sha256(content), mode: stat.mode & 511 };
+}
+async function resolveWriteTarget(path$1) {
+  try {
+    return await node_fs.promises.realpath(path$1);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      try {
+        const link = await node_fs.promises.readlink(path$1);
+        return link.startsWith("/") ? link : path.join(path.dirname(path$1), link);
+      } catch {
+        return path$1;
+      }
+    }
+    throw error;
+  }
+}
+async function atomicWriteFile(path$1, content, mode) {
+  const target = await resolveWriteTarget(path$1);
+  const dir = path.dirname(target);
+  await node_fs.promises.mkdir(dir, { recursive: true, mode: 448 });
+  const tmp = path.join(dir, `.${path.basename(target)}.vh-tmp-${process.pid}-${node_crypto.randomBytes(4).toString("hex")}`);
+  const handle = await node_fs.promises.open(tmp, node_fs.constants.O_WRONLY | node_fs.constants.O_CREAT | node_fs.constants.O_EXCL, mode ?? 384);
+  try {
+    await handle.writeFile(content, "utf8");
+    await handle.sync();
+  } catch (error) {
+    await handle.close().catch(() => {
+    });
+    await node_fs.promises.unlink(tmp).catch(() => {
+    });
+    throw error;
+  }
+  await handle.close();
+  try {
+    if (mode !== null) await node_fs.promises.chmod(tmp, mode);
+    await node_fs.promises.rename(tmp, target);
+  } catch (error) {
+    await node_fs.promises.unlink(tmp).catch(() => {
+    });
+    throw error;
+  }
+  try {
+    const dirHandle = await node_fs.promises.open(dir, "r");
+    await dirHandle.sync().catch(() => {
+    });
+    await dirHandle.close();
+  } catch {
+  }
+}
+const BACKUP_ID = /^\d{13}-[0-9a-f]{8}$/;
+const HARNESS_DIR = /^[a-z][a-z0-9-]{0,31}$/;
+class BackupStore {
+  constructor(root) {
+    this.root = root;
+  }
+  harnessDir(harness) {
+    if (!HARNESS_DIR.test(harness)) throw new ModelConfigError("invalid-harness", "Invalid harness");
+    return path.join(this.root, harness);
+  }
+  async create(harness, reason, files, now = Date.now()) {
+    const id = `${now}-${node_crypto.randomBytes(4).toString("hex")}`;
+    const dir = path.join(this.harnessDir(harness), id);
+    await node_fs.promises.mkdir(dir, { recursive: true, mode: 448 });
+    const manifest = { id, createdAt: now, reason, files: files.map((f, i) => ({ path: f.path, blob: f.content === null ? null : `f${i}`, mode: f.mode })) };
+    for (const [i, file] of files.entries()) {
+      if (file.content !== null) await node_fs.promises.writeFile(path.join(dir, `f${i}`), file.content, { encoding: "utf8", mode: 384 });
+    }
+    await node_fs.promises.writeFile(path.join(dir, "manifest.json"), JSON.stringify(manifest, null, 2), { encoding: "utf8", mode: 384 });
+    await this.prune(harness);
+    return { id, createdAt: now, reason, files: files.map((f) => f.path) };
+  }
+  async list(harness) {
+    let names;
+    try {
+      names = await node_fs.promises.readdir(this.harnessDir(harness));
+    } catch {
+      return [];
+    }
+    const entries = [];
+    for (const name of names.filter((n) => BACKUP_ID.test(n))) {
+      try {
+        const manifest = JSON.parse(await node_fs.promises.readFile(path.join(this.harnessDir(harness), name, "manifest.json"), "utf8"));
+        entries.push({ id: name, createdAt: Number(manifest.createdAt) || 0, reason: String(manifest.reason ?? ""), files: (manifest.files ?? []).map((f) => f.path) });
+      } catch {
+      }
+    }
+    return entries.sort((a, b) => b.createdAt - a.createdAt);
+  }
+  async read(harness, id) {
+    if (!BACKUP_ID.test(id)) throw new ModelConfigError("invalid-backup", "Invalid backup id");
+    const dir = path.join(this.harnessDir(harness), id);
+    let manifest;
+    try {
+      manifest = JSON.parse(await node_fs.promises.readFile(path.join(dir, "manifest.json"), "utf8"));
+    } catch {
+      throw new ModelConfigError("backup-not-found", "Backup not found");
+    }
+    const out = [];
+    for (const file of manifest.files) {
+      out.push({
+        path: file.path,
+        content: file.blob === null ? null : await node_fs.promises.readFile(path.join(dir, file.blob), "utf8"),
+        mode: typeof file.mode === "number" ? file.mode : null
+      });
+    }
+    return out;
+  }
+  async prune(harness) {
+    const entries = await this.list(harness);
+    for (const stale of entries.slice(MAX_BACKUPS_PER_HARNESS)) {
+      await node_fs.promises.rm(path.join(this.harnessDir(harness), stale.id), { recursive: true, force: true });
+    }
+  }
+}
+
+exports.BackupStore = BackupStore;
+exports.ModelConfigError = ModelConfigError;
+exports.atomicWriteFile = atomicWriteFile;
+exports.readConfigFile = readConfigFile;
+exports.sha256 = sha256;