harnery 0.36.0 → 0.37.0

package/dist/core/agents/rules/commit-conflict.js

@@ -24,6 +24,7 @@ import { appendFileSync, existsSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { coordFreshnessSeconds } from "../../config.js";
 import { resolveOwner } from "../../hooks/resolve/owner.js";
+import { recordLiveClaimChangeV3 } from "../live-authority-v3.js";
 import { readLiveCoordinationRows } from "../state/live-coordination-view.js";
 import { instanceHasLivePid } from "../state/pidmap.js";
 export function evaluateCommit(coordRoot, req) {
@@ -120,6 +121,14 @@ export function evaluateCommit(coordRoot, req) {
             suppressed_self_attribution: true,
         };
     }
+    // A blocked commit proves this session has work in every staged path, even
+    // when the edit hook never acquired a claim (for example, a shell edit made
+    // just before another session claimed the same file). Keep those paths on
+    // the blocked session's durable claim set. The original holder's later
+    // commit will then see the overlap instead of silently sweeping this
+    // session's working-tree hunks. A successful later commit releases clean
+    // paths through the existing post-commit hook.
+    retainBlockedStagedPaths(coordRoot, me, mySession, req.staged_paths, peers);
     return {
         allow: false,
         exit_code: 1,
@@ -132,6 +141,37 @@ export function evaluateCommit(coordRoot, req) {
             "  active agents:",
     };
 }
+function retainBlockedStagedPaths(coordRoot, instanceId, sessionId, stagedPaths, peers) {
+    if (instanceId === "__unattributed__")
+        return;
+    const self = peers.find((peer) => peer.instance_id === instanceId);
+    if (!self)
+        return;
+    for (const path of stagedPaths) {
+        try {
+            recordLiveClaimChangeV3({
+                coordRoot,
+                owner: instanceId,
+                nativeSessionId: self.session_id ?? sessionId,
+                adapter: adapterFromPlatform(self.platform),
+                operation: "acquired",
+                path,
+                access: "write",
+            });
+        }
+        catch {
+            // The commit is already blocked. Coordination remains fail-open for
+            // authority-write failures so a damaged cache cannot brick Git.
+        }
+    }
+}
+function adapterFromPlatform(platform) {
+    if (platform === "cursor")
+        return "cursor";
+    if (platform === "codex")
+        return "codex";
+    return "claude-code";
+}
 function findOverlap(staged, files, coordRoot, stagedIsGitlink) {
     for (const claimed of files) {
         if (claimed === staged)
@@ -188,13 +228,22 @@ function isGitlinkInIndex(coordRoot, path) {
     return result.stdout.trim().startsWith("160000 ");
 }
 function isHolderSelfAttributed(coordRoot, holderId, stagedSet, peers) {
+    const holder = peers.find((p) => p.instance_id === holderId);
+    // Windows-hosted Codex sessions cross a process boundary into WSL, so they
+    // deliberately have no usable PID anchor. Their canonical V3 session row is
+    // the foreign-identity evidence instead. Treating that row as a transient
+    // self identity would suppress the symmetric claim retained after a blocked
+    // commit and reopen the working-tree sweep this guard is meant to stop.
+    if (holder?.platform === "codex" && holder.session_id) {
+        debugGate(coordRoot, { holder: holderId, gate: "B", reason: "canonical_codex_session" });
+        return false;
+    }
     // Gate B (cheaper): live foreign pid-map entry blocks self-attribution.
     if (holderHasLiveForeignPid(coordRoot, holderId)) {
         debugGate(coordRoot, { holder: holderId, gate: "B", reason: "live_pid_anchor" });
         return false;
     }
     // Gate A: every held path is either in the staged set or already clean in HEAD.
-    const holder = peers.find((p) => p.instance_id === holderId);
     if (!holder) {
         debugGate(coordRoot, { holder: holderId, gate: "A", reason: "holder_not_found" });
         return false;

package/dist/core/agents/rules/stop-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAM3D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA6BvF;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,aAAa,CAuIf"}
+{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAM3D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA6BvF;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,aAAa,CAiIf"}

package/dist/core/agents/rules/stop-hook.js

@@ -91,17 +91,13 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
         .map((event) => observedBoolean(event.payload.ritual?.status_box_present_strict))
         .filter((value) => value !== undefined);
     const currentStrictBox = claudeContinuation ? req.status_box_present_strict : undefined;
-    if (req.adapter !== "cursor" && latestBox === undefined && currentStrictBox === undefined) {
+    if (latestBox === undefined && currentStrictBox === undefined) {
         return evidenceUnavailable("turn.completed has no observed V3 assistant-text status-box result; Stop remains fail-open");
     }
-    const ackPresent = req.adapter === "cursor"
-        ? requiredStatusChecked
-        : claudeContinuation
-            ? strictBoxObservations.includes(true) || currentStrictBox === true
-            : latestBox === true;
-    const ackBlock = req.adapter === "cursor"
-        ? () => rule13Block(coordRoot, req.session_id)
-        : () => rule23Block(coordRoot, req.session_id);
+    const ackPresent = claudeContinuation
+        ? strictBoxObservations.includes(true) || currentStrictBox === true
+        : latestBox === true;
+    const ackBlock = () => rule23Block(coordRoot, req.session_id);
     // Pure prose turns keep the human-visible acknowledgement but do not require
     // task or final-status mutations. This preserves the pre-V3 policy exactly.
     if (!usedTool) {
@@ -260,7 +256,7 @@ function sessionIdSuffix(sessionId) {
  * The verdict keeps the first failure's rule id, so the `blocked_rule`
  * telemetry and the adapter's `rule=` stderr contract are unchanged; the
  * reason enumerates the rest so a single continuation can repair all of them.
- * Cursor maps the acknowledgement onto rule 1/3, so identical rules dedupe.
+ * Duplicate rules are folded so one continuation repairs every missing signal.
  */
 function mergeStopBlocks(blocks) {
     let primary;

package/dist/core/agents/session-finalizer-v3.js

@@ -450,7 +450,10 @@ function observeCascades(coordRoot, route, records, events, lastByGeneration, no
             }
         }
         if (event.event_type === "lifecycle.sweep_observed" &&
-            event.payload.observation === "stale_sweep") {
+            // stale-sweep.ts emits the observation as `stale_heartbeat`; the
+            // finalization request it produces is the one named `stale_sweep`.
+            // Matching the request name here made this branch unreachable.
+            event.payload.observation === "stale_heartbeat") {
             const record = records.find(({ state }) => !state.terminal && state.instance_id === event.payload.subject_instance_id);
             const last = record ? lastByGeneration.get(record.state.generation_id) : undefined;
             if (!record?.state.last_event_id || !last)

package/dist/core/artifacts/index.d.ts

@@ -28,8 +28,9 @@ export interface ArtifactManifestV1 {
     };
     released_at?: string;
     released_by?: ArtifactActor;
+    oversize_acknowledged?: boolean;
 }
-export type ArtifactClassification = "managed-active" | "managed-current" | "managed-expired" | "managed-tracked" | "invalid-manifest" | "unmanaged" | "symlink" | "unknown";
+export type ArtifactClassification = "managed-active" | "managed-current" | "managed-expired" | "managed-oversize" | "managed-over-budget" | "managed-tracked" | "invalid-manifest" | "unmanaged" | "symlink" | "unknown";
 export interface ArtifactInventoryEntry {
     name: string;
     path: string;
@@ -44,6 +45,7 @@ export interface ArtifactInventoryEntry {
     last_modified_at: string | null;
     expires_at: string | null;
     owner_instance_id: string | null;
+    oversize_acknowledged: boolean;
 }
 export interface ArtifactCreateInput {
     slug: string;
@@ -52,11 +54,25 @@ export interface ArtifactCreateInput {
     actor?: ArtifactActor;
     now?: Date;
     id?: string;
+    big?: boolean;
 }
 export interface ArtifactMutationInput {
     actor?: ArtifactActor;
     now?: Date;
 }
+export interface ArtifactAdoptionResult {
+    candidates: Array<{
+        path: string;
+        name: string;
+        bytes: number;
+        kind: "file" | "directory";
+    }>;
+    candidate_bytes: number;
+    requires_big: boolean;
+    adopted_artifact_id: string | null;
+    adopted_path: string | null;
+    adopted_directories: number;
+}
 export declare function artifactsRoot(repoRoot: string): string;
 /** Public config-aware default for embedding hosts that create artifact units. */
 export declare function configuredArtifactRetentionDays(repoRoot: string): number;
@@ -77,6 +93,15 @@ export declare function showArtifact(repoRoot: string, ref: string, opts?: {
 };
 export declare function renewArtifact(repoRoot: string, ref: string, days: number, reason: string, input?: ArtifactMutationInput): ArtifactManifestV1;
 export declare function releaseArtifact(repoRoot: string, ref: string, input?: ArtifactMutationInput): ArtifactManifestV1;
+/** Adopt untracked loose files and legacy directories without changing directory paths. */
+export declare function adoptUnmanagedArtifactFiles(repoRoot: string, input: {
+    yes?: boolean;
+    big?: boolean;
+    purpose: string;
+    retentionDays: number;
+    actor?: ArtifactActor;
+    now?: Date;
+}): ArtifactAdoptionResult;
 export declare function cleanArtifacts(repoRoot: string, opts?: {
     yes?: boolean;
     now?: Date;

package/dist/core/artifacts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/index.ts"],"names":[],"mappings":"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"}

package/dist/core/artifacts/index.js

@@ -12,7 +12,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { readLiveCoordinationRow } from "../agents/state/live-coordination-view.js";
-import { artifactAutoCleanEnabled, artifactAutoCleanIntervalHours, artifactDefaultRetentionDays, } from "../config.js";
+import { artifactAutoCleanEnabled, artifactAutoCleanIntervalHours, artifactDefaultRetentionDays, artifactMaxBytes, artifactMaxUnitBytes, } from "../config.js";
 import { ARTIFACT_MANIFEST, ARTIFACT_SCHEMA_VERSION, ARTIFACTS_DIR } from "./constants.js";
 export { ARTIFACT_MANIFEST, ARTIFACT_SCHEMA_VERSION, ARTIFACTS_DIR } from "./constants.js";
 export function artifactsRoot(repoRoot) {
@@ -51,6 +51,7 @@ export function createArtifact(repoRoot, input) {
         retention: {
             expires_at: addDays(now, retentionDays).toISOString(),
         },
+        ...(input.big ? { oversize_acknowledged: true } : {}),
     };
     atomicWriteManifest(path, manifest);
     return { path, manifest };
@@ -75,11 +76,13 @@ export function inventoryArtifacts(repoRoot, opts = {}) {
     for (const name of names) {
         rows.push(classifyArtifactPath(repoRoot, join(root, name), now, freshnessSeconds));
     }
-    return rows;
+    return applyArtifactBudgets(repoRoot, rows);
 }
 export function showArtifact(repoRoot, ref, opts = {}) {
     const path = resolveArtifactRef(repoRoot, ref);
-    const entry = classifyArtifactPath(repoRoot, path, opts.now ?? new Date(), opts.freshnessSeconds ?? 600);
+    const entry = inventoryArtifacts(repoRoot, opts).find((row) => row.path === path);
+    if (!entry)
+        throw new Error(`artifact "${ref}" was not found`);
     const parsed = readManifest(path);
     if (!parsed.ok)
         throw new Error(parsed.reason);
@@ -122,6 +125,98 @@ export function releaseArtifact(repoRoot, ref, input = {}) {
     atomicWriteManifest(path, manifest);
     return manifest;
 }
+/** Adopt untracked loose files and legacy directories without changing directory paths. */
+export function adoptUnmanagedArtifactFiles(repoRoot, input) {
+    const now = input.now ?? new Date();
+    const candidates = [];
+    for (const row of inventoryArtifacts(repoRoot, { now })) {
+        if (row.classification !== "unmanaged")
+            continue;
+        try {
+            const stat = lstatSync(row.path);
+            if (stat.isSymbolicLink() || containsTrackedPath(repoRoot, row.path))
+                continue;
+            if (stat.isFile()) {
+                candidates.push({ path: row.path, name: row.name, bytes: stat.size, kind: "file" });
+                continue;
+            }
+            if (stat.isDirectory() && !existsSync(join(row.path, ARTIFACT_MANIFEST))) {
+                const bytes = safeTreeSize(row.path);
+                if (bytes !== null && normalizeSlug(row.name)) {
+                    candidates.push({ path: row.path, name: row.name, bytes, kind: "directory" });
+                }
+            }
+        }
+        catch {
+            // A racing or unreadable entry stays unmanaged.
+        }
+    }
+    const candidateBytes = candidates.reduce((sum, row) => sum + row.bytes, 0);
+    const fileBytes = candidates.reduce((sum, row) => sum + (row.kind === "file" ? row.bytes : 0), 0);
+    const maxUnitBytes = artifactMaxUnitBytes(repoRoot);
+    const requiresBig = fileBytes > maxUnitBytes ||
+        candidates.some((row) => row.kind === "directory" && row.bytes > maxUnitBytes);
+    const preview = {
+        candidates,
+        candidate_bytes: candidateBytes,
+        requires_big: requiresBig,
+        adopted_artifact_id: null,
+        adopted_path: null,
+        adopted_directories: 0,
+    };
+    if (!input.yes || candidates.length === 0)
+        return preview;
+    if (requiresBig && !input.big) {
+        throw new Error("unmanaged adoption exceeds the per-bundle ceiling; repeat with --big");
+    }
+    // Revalidate every exact source before creating a destination. A changed,
+    // tracked, linked, or non-regular entry aborts the whole adoption.
+    for (const candidate of candidates) {
+        const stat = lstatSync(candidate.path);
+        const bytes = stat.isDirectory() ? safeTreeSize(candidate.path) : stat.size;
+        if (stat.isSymbolicLink() ||
+            bytes !== candidate.bytes ||
+            containsTrackedPath(repoRoot, candidate.path)) {
+            throw new Error(`unmanaged entry changed before adoption: ${candidate.name}`);
+        }
+        if (candidate.kind === "file" ? !stat.isFile() : !stat.isDirectory()) {
+            throw new Error(`unmanaged entry changed before adoption: ${candidate.name}`);
+        }
+    }
+    const files = candidates.filter((candidate) => candidate.kind === "file");
+    const created = files.length
+        ? createArtifact(repoRoot, {
+            slug: "adopted-unmanaged",
+            purpose: input.purpose,
+            retentionDays: input.retentionDays,
+            actor: input.actor,
+            now,
+            big: input.big,
+        })
+        : null;
+    for (const candidate of files)
+        renameSync(candidate.path, join(created.path, candidate.name));
+    const retentionDays = positiveDays(input.retentionDays);
+    const directories = candidates.filter((candidate) => candidate.kind === "directory");
+    for (const candidate of directories) {
+        atomicWriteManifest(candidate.path, {
+            schema_version: ARTIFACT_SCHEMA_VERSION,
+            artifact_id: randomUUID(),
+            slug: normalizeSlug(candidate.name),
+            purpose: `${input.purpose}: ${candidate.name}`,
+            created_at: now.toISOString(),
+            created_by: input.actor,
+            retention: { expires_at: addDays(now, retentionDays).toISOString() },
+            ...(input.big ? { oversize_acknowledged: true } : {}),
+        });
+    }
+    return {
+        ...preview,
+        adopted_artifact_id: created?.manifest.artifact_id ?? null,
+        adopted_path: created?.path ?? null,
+        adopted_directories: directories.length,
+    };
+}
 export function cleanArtifacts(repoRoot, opts = {}) {
     const now = opts.now ?? new Date();
     const freshnessSeconds = opts.freshnessSeconds ?? 600;
@@ -129,13 +224,21 @@ export function cleanArtifacts(repoRoot, opts = {}) {
     if (!opts.yes)
         return rows;
     return rows.map((entry) => {
-        if (entry.classification !== "managed-expired")
+        if (entry.action !== "would-delete")
             return entry;
         // Reclassify immediately before removal. A renewal, release-state change,
         // heartbeat, symlink swap, or tracked file added since inventory must win.
-        const current = classifyArtifactPath(repoRoot, entry.path, now, freshnessSeconds);
-        if (current.classification !== "managed-expired")
+        const current = inventoryArtifacts(repoRoot, { now, freshnessSeconds }).find((row) => row.path === entry.path);
+        if (!current) {
+            return { ...entry, classification: "unknown", reason: "entry disappeared", action: "keep" };
+        }
+        if (current.action !== "would-delete" ||
+            current.artifact_id !== entry.artifact_id ||
+            current.bytes !== entry.bytes ||
+            current.last_modified_at !== entry.last_modified_at ||
+            current.expires_at !== entry.expires_at) {
             return current;
+        }
         try {
             const top = lstatSync(current.path);
             if (!top.isDirectory() || top.isSymbolicLink()) {
@@ -264,6 +367,7 @@ function classifyArtifactPath(repoRoot, path, now, freshnessSeconds) {
         last_modified_at: new Date(effectiveLastModifiedMs).toISOString(),
         expires_at: effectiveExpiresAt,
         owner_instance_id: manifest.created_by?.instance_id ?? null,
+        oversize_acknowledged: manifest.oversize_acknowledged === true,
     });
     if (base.bytes === null || lastModifiedMs === null) {
         return {
@@ -309,6 +413,38 @@ function classifyArtifactPath(repoRoot, path, now, freshnessSeconds) {
         action: "would-delete",
     };
 }
+function applyArtifactBudgets(repoRoot, inputRows) {
+    const maxUnitBytes = artifactMaxUnitBytes(repoRoot);
+    const maxBytes = artifactMaxBytes(repoRoot);
+    const rows = inputRows.map((row) => ({ ...row }));
+    for (const row of rows) {
+        if (row.classification === "managed-current" &&
+            row.bytes !== null &&
+            row.bytes > maxUnitBytes &&
+            !row.oversize_acknowledged) {
+            row.classification = "managed-oversize";
+            row.reason = `bundle uses ${row.bytes} bytes, above the ${maxUnitBytes}-byte ceiling without --big`;
+            row.action = "would-delete";
+        }
+    }
+    const managedBytes = rows.reduce((sum, row) => sum + (row.artifact_id && row.bytes !== null ? row.bytes : 0), 0);
+    let retainedBytes = managedBytes -
+        rows.reduce((sum, row) => sum + (row.action === "would-delete" && row.bytes !== null ? row.bytes : 0), 0);
+    if (retainedBytes <= maxBytes)
+        return rows;
+    const candidates = rows
+        .filter((row) => row.classification === "managed-current" && row.action === "keep" && row.bytes !== null)
+        .sort((left, right) => `${left.expires_at ?? ""}\0${left.created_at ?? ""}\0${left.name}`.localeCompare(`${right.expires_at ?? ""}\0${right.created_at ?? ""}\0${right.name}`));
+    for (const row of candidates) {
+        if (retainedBytes <= maxBytes)
+            break;
+        row.classification = "managed-over-budget";
+        row.reason = `repository artifact budget is ${maxBytes} bytes; earliest-expiring inactive bundles are removed first`;
+        row.action = "would-delete";
+        retainedBytes -= row.bytes ?? 0;
+    }
+    return rows;
+}
 function readManifest(path) {
     const manifestPath = join(path, ARTIFACT_MANIFEST);
     if (!existsSync(manifestPath)) {
@@ -357,6 +493,9 @@ function readManifest(path) {
     if (m.released_by !== undefined && !validActor(m.released_by)) {
         return { ok: false, reason: "invalid released_by" };
     }
+    if (m.oversize_acknowledged !== undefined && typeof m.oversize_acknowledged !== "boolean") {
+        return { ok: false, reason: "invalid oversize_acknowledged" };
+    }
     return { ok: true, manifest: m };
 }
 function atomicWriteManifest(path, manifest) {
@@ -460,6 +599,7 @@ function rowFor(path, name, repoRoot, classification, reason, bytes = safeTreeSi
         last_modified_at: null,
         expires_at: null,
         owner_instance_id: null,
+        oversize_acknowledged: false,
     };
 }
 function normalizeSlug(value) {

package/dist/core/config.d.ts

@@ -185,6 +185,14 @@ export declare function coordFreshnessSeconds(coordRoot?: string | null): number
  * `0` (or a negative value) disables automatic rotation.
  */
 export declare function eventLedgerRotateActiveBytes(coordRoot?: string | null): number;
+export interface EventLedgerArchivePolicy {
+    maxBytes: number;
+    maxAgeDays: number;
+    keepMin: number;
+    autoClean: boolean;
+}
+/** Bounded retention for closed V3 epochs under `ledgers/v3-archives`. */
+export declare function eventLedgerArchivePolicy(coordRoot?: string | null): EventLedgerArchivePolicy;
 /**
  * Resolve the standalone dashboard port.
  *
@@ -200,6 +208,10 @@ export declare function sessionFinalizationConfig(coordRoot?: string | null): Se
  * `artifacts.default_retention_days` -> 3 days.
  */
 export declare function artifactDefaultRetentionDays(coordRoot?: string | null): number;
+/** Soft repository budget for managed working artifacts. */
+export declare function artifactMaxBytes(coordRoot?: string | null): number;
+/** Size at which one bundle requires an explicit `artifacts create --big` acknowledgement. */
+export declare function artifactMaxUnitBytes(coordRoot?: string | null): number;
 /**
  * Whether the daily SessionStart sweep of expired artifact workspaces runs.
  * Precedence: `HARNERY_ARTIFACT_AUTO_CLEAN` (0/false disables) ->

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,wCAAwC,EAAE,MAAM,gCAAgC,CAAC;AAE1F,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,mCAAmC,EAAE,yBAMjD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,4BAA4B,CAAC;CAC3C;AAyGD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqCvD;AA0CD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,CAAC,2BAA2B,EAAE,2BAA2B,CAAC,CAAC;CAC7E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAa3E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,CAqBrF;AAmFD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAShE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAK9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAU3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,EAAE,CAY1F;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOrE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAWzE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG9E;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAcvF;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,yBAAyB,CA0B9F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAe9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAOvD;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAmBpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS3C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/config.js

@@ -473,6 +473,20 @@ export function eventLedgerRotateActiveBytes(coordRoot) {
     const root = coordRoot ?? findCoordRoot();
     return resolveEventLedgerRotateActiveBytesV3(root);
 }
+const DEFAULT_EVENT_ARCHIVE_MAX_BYTES = 1024 * 1024 * 1024;
+const DEFAULT_EVENT_ARCHIVE_MAX_AGE_DAYS = 7;
+const DEFAULT_EVENT_ARCHIVE_KEEP_MIN = 2;
+/** Bounded retention for closed V3 epochs under `ledgers/v3-archives`. */
+export function eventLedgerArchivePolicy(coordRoot) {
+    const root = coordRoot ?? findCoordRoot();
+    const configured = root ? readConfig(root).events : undefined;
+    return {
+        maxBytes: integerSetting(coordEnv("EVENT_V3_ARCHIVE_MAX_BYTES"), configured?.archive_max_bytes, 64 * 1024 * 1024, 1024 * 1024 * 1024 * 1024, DEFAULT_EVENT_ARCHIVE_MAX_BYTES),
+        maxAgeDays: integerSetting(coordEnv("EVENT_V3_ARCHIVE_MAX_AGE_DAYS"), configured?.archive_max_age_days, 1, 3650, DEFAULT_EVENT_ARCHIVE_MAX_AGE_DAYS),
+        keepMin: integerSetting(coordEnv("EVENT_V3_ARCHIVE_KEEP_MIN"), configured?.archive_keep_min, 1, 1000, DEFAULT_EVENT_ARCHIVE_KEEP_MIN),
+        autoClean: booleanSetting(coordEnv("EVENT_V3_ARCHIVE_AUTO_CLEAN"), configured?.archive_auto_clean, true),
+    };
+}
 function parseWebPort(value, source) {
     const port = typeof value === "number" ? value : Number(value);
     if (!Number.isInteger(port) || port < 1024 || port > 65535) {
@@ -540,6 +554,18 @@ export function artifactDefaultRetentionDays(coordRoot) {
         ? configured
         : 3;
 }
+const DEFAULT_ARTIFACT_MAX_BYTES = 20 * 1024 * 1024 * 1024;
+const DEFAULT_ARTIFACT_MAX_UNIT_BYTES = 1024 * 1024 * 1024;
+/** Soft repository budget for managed working artifacts. */
+export function artifactMaxBytes(coordRoot) {
+    const root = coordRoot ?? findCoordRoot();
+    return integerSetting(coordEnv("ARTIFACT_MAX_BYTES"), root ? readConfig(root).artifacts?.max_bytes : undefined, 64 * 1024 * 1024, 1024 * 1024 * 1024 * 1024, DEFAULT_ARTIFACT_MAX_BYTES);
+}
+/** Size at which one bundle requires an explicit `artifacts create --big` acknowledgement. */
+export function artifactMaxUnitBytes(coordRoot) {
+    const root = coordRoot ?? findCoordRoot();
+    return integerSetting(coordEnv("ARTIFACT_MAX_UNIT_BYTES"), root ? readConfig(root).artifacts?.max_unit_bytes : undefined, 16 * 1024 * 1024, 1024 * 1024 * 1024 * 1024, DEFAULT_ARTIFACT_MAX_UNIT_BYTES);
+}
 /**
  * Whether the daily SessionStart sweep of expired artifact workspaces runs.
  * Precedence: `HARNERY_ARTIFACT_AUTO_CLEAN` (0/false disables) ->
@@ -571,6 +597,23 @@ export function artifactAutoCleanIntervalHours() {
     }
     return 24;
 }
+function integerSetting(envValue, configured, minimum, maximum, fallback) {
+    for (const value of [envValue, configured]) {
+        const parsed = typeof value === "number" ? value : Number(value);
+        if (Number.isSafeInteger(parsed) && parsed >= minimum && parsed <= maximum)
+            return parsed;
+    }
+    return fallback;
+}
+function booleanSetting(envValue, configured, fallback) {
+    if (envValue !== undefined) {
+        if (envValue === "1" || envValue.toLowerCase() === "true")
+            return true;
+        if (envValue === "0" || envValue.toLowerCase() === "false")
+            return false;
+    }
+    return typeof configured === "boolean" ? configured : fallback;
+}
 /**
  * `harn backup` (restic) defaults. Per field, precedence is env → config → built-in:
  *   repo:          `HARNERY_RESTIC_REPO` → `backup.repo` → `~/.cache/harnery/restic-repo`

package/dist/core/diagnostics/advice.d.ts

@@ -0,0 +1,9 @@
+import type { SupervisorCapability, SupervisorFinding } from "../supervisor/contract.js";
+import { type DiagnosticAdvice } from "./contract.js";
+export interface BuildDiagnosticAdviceInput {
+    findings: readonly SupervisorFinding[];
+    sourceCapability: SupervisorCapability;
+    evaluatedAt: string;
+}
+export declare function buildDiagnosticAdvice(input: BuildDiagnosticAdviceInput): DiagnosticAdvice;
+//# sourceMappingURL=advice.d.ts.map

package/dist/core/diagnostics/advice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advice.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/advice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAGL,KAAK,gBAAgB,EAGtB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CA4CzF"}