harnery 0.34.1 → 0.36.0

package/dist/commands/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAiCnD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKrE;AA8BD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAevE;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA0K5E"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyCnD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKrE;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAQR;AAyCD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAevE;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAuN5E"}

package/dist/commands/web.js

@@ -2,8 +2,11 @@ import { spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createServer } from "node:net";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { DEFAULT_WEB_PORT, resolveWebPort } from "../core/config.js";
+import { ensureSemanticServiceRunning } from "../core/semantic/service.js";
+import { processLogDestination } from "../core/storage/process-log.js";
+import { parsePerformanceWindow, readWebPerformanceReport, WEB_PERFORMANCE_LOG, } from "../lib/web-performance.js";
 import { lazyFetchWebRoot, webRunner } from "./web-fetch.js";
 /**
  * `harn web`: Next.js dashboard for harnery's coord state.
@@ -12,6 +15,7 @@ import { lazyFetchWebRoot, webRunner } from "./web-fetch.js";
  *   up [--prod]:   start the server (dev mode default; --prod runs next start)
  *   build:         next build (production bundle)
  *   start:         next start (must `harn web build` first)
+ *   performance:   summarize request latency and event-loop delays
  *
  * Launches the Next.js app under `harnery/web/` against the user's current
  * working directory. The web app reads `.harnery/` via `HARNERY_COORD_ROOT`;
@@ -65,6 +69,37 @@ export function nodeOptionsWithHeapCap(mb) {
         return inherited;
     return `${inherited} --max-old-space-size=${mb}`.trim();
 }
+/** Preload the request diagnostics hook without replacing Next's HTTP server. */
+export function nodeOptionsWithWebDiagnostics(webDir, mb) {
+    const inherited = nodeOptionsWithHeapCap(mb) ?? "";
+    if (inherited.includes("server-performance.mjs"))
+        return inherited;
+    const preload = pathToFileURL(path.join(webDir, "server-performance.mjs")).href;
+    return `${inherited} --import=${preload}`.trim();
+}
+export function webPerformanceLogDestination(coordRoot, env = process.env) {
+    return processLogDestination({
+        coord_root: coordRoot,
+        family_id: "web-performance-log",
+        filename: "active.jsonl",
+        legacy_path: path.join(coordRoot, ".harnery", "logs", WEB_PERFORMANCE_LOG),
+        env,
+    });
+}
+async function startSemanticServiceWithWeb(coordRoot, emit) {
+    const result = await ensureSemanticServiceRunning(coordRoot);
+    if (result.state === "started")
+        emit.log("semantic reader · started automatically", "info");
+    if (result.state === "running")
+        emit.log("semantic reader · already running", "info");
+    if (result.state === "paused")
+        emit.log("semantic reader · paused by operator", "info");
+    if (result.state === "inactive")
+        emit.log("semantic reader · waiting for active V3", "info");
+    if (result.state === "unavailable") {
+        emit.log(`semantic reader · unavailable (${result.error ?? "startup failed"})`, "warn");
+    }
+}
 /**
  * Resolve the web app root. A local `web/` (source checkout / submodule) wins.
  * Otherwise, on an npm install, lazy-fetch it (clone + install) unless the
@@ -168,10 +203,14 @@ export function registerWebCommand(program, emit) {
         }
         if (!(await requireAvailablePort(emit, port)))
             return;
+        await startSemanticServiceWithWeb(coordRoot, emit);
         const heapMb = resolveMaxOldSpaceMb(opts.maxOldSpace);
+        const nodeOptions = nodeOptionsWithWebDiagnostics(root, heapMb);
+        const performanceLogPath = webPerformanceLogDestination(coordRoot);
         emit.log(`harn web · http://localhost:${port} (${mode})`, "info");
         emit.log(`files origin · http://harnery-files.localhost:${port}`, "info");
         emit.log(`reading .harnery/ from: ${coordRoot}`, "info");
+        emit.log(`performance log · ${performanceLogPath}`, "info");
         if (heapMb > 0)
             emit.log(`heap ceiling · ${heapMb} MB`, "info");
         const child = spawn(webRunner(), ["run", mode], {
@@ -180,9 +219,9 @@ export function registerWebCommand(program, emit) {
                 ...process.env,
                 HARNERY_COORD_ROOT: coordRoot,
                 HARNERY_WEB_PORT: String(port),
-                ...(nodeOptionsWithHeapCap(heapMb)
-                    ? { NODE_OPTIONS: nodeOptionsWithHeapCap(heapMb) }
-                    : {}),
+                HARNERY_WEB_MODE: mode,
+                HARNERY_WEB_PERFORMANCE_LOG_PATH: performanceLogPath,
+                NODE_OPTIONS: nodeOptions,
             },
             stdio: "inherit",
         });
@@ -253,9 +292,13 @@ export function registerWebCommand(program, emit) {
         }
         if (!(await requireAvailablePort(emit, port)))
             return;
+        await startSemanticServiceWithWeb(coordRoot, emit);
         const heapMb = resolveMaxOldSpaceMb(opts.maxOldSpace);
+        const nodeOptions = nodeOptionsWithWebDiagnostics(root, heapMb);
+        const performanceLogPath = webPerformanceLogDestination(coordRoot);
         emit.log(`harn web · http://localhost:${port} (start)`, "info");
         emit.log(`reading .harnery/ from: ${coordRoot}`, "info");
+        emit.log(`performance log · ${performanceLogPath}`, "info");
         if (heapMb > 0)
             emit.log(`heap ceiling · ${heapMb} MB`, "info");
         const child = spawn(webRunner(), ["run", "start"], {
@@ -264,9 +307,9 @@ export function registerWebCommand(program, emit) {
                 ...process.env,
                 HARNERY_COORD_ROOT: coordRoot,
                 HARNERY_WEB_PORT: String(port),
-                ...(nodeOptionsWithHeapCap(heapMb)
-                    ? { NODE_OPTIONS: nodeOptionsWithHeapCap(heapMb) }
-                    : {}),
+                HARNERY_WEB_MODE: "start",
+                HARNERY_WEB_PERFORMANCE_LOG_PATH: performanceLogPath,
+                NODE_OPTIONS: nodeOptions,
             },
             stdio: "inherit",
         });
@@ -280,4 +323,38 @@ export function registerWebCommand(program, emit) {
             process.exitCode = code ?? 0;
         });
     });
+    web
+        .command("performance")
+        .description("Summarize dashboard request, event-loop, memory, and GC diagnostics")
+        .option("--coord-root <dir>", "Override the coordination root", process.cwd())
+        .option("--since <window>", "Include the last Nm, Nh, or Nd", "1h")
+        .option("--limit <n>", "Keep the N slowest requests and delays", "20")
+        .option("--json", "Emit structured JSON")
+        .action((opts) => {
+        const windowMs = parsePerformanceWindow(opts.since);
+        if (windowMs === null) {
+            emit.error({
+                code: "invalid_web_performance_window",
+                message: `invalid --since value '${opts.since}'`,
+                hint: "Use Nm, Nh, or Nd, for example 30m, 1h, or 7d.",
+            });
+            return;
+        }
+        const limit = Number(opts.limit);
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500) {
+            emit.error({
+                code: "invalid_web_performance_limit",
+                message: `invalid --limit value '${opts.limit}'`,
+                hint: "Use an integer from 1 through 500.",
+            });
+            return;
+        }
+        if (opts.json)
+            emit.config({ format: "json" });
+        emit.data(readWebPerformanceReport({
+            root: opts.coordRoot,
+            since: opts.since,
+            limit,
+        }));
+    });
 }

package/dist/commands/work.js

@@ -1,8 +1,8 @@
 import { resolve } from "node:path";
 import { adapterProofInputs, createBuiltinAdapterRegistry, probeBinaryVersion, } from "../core/adapters/index.js";
+import { resolveCoordRoot } from "../core/agents/coord-client.js";
 import { workflowSubscriptionOnly } from "../core/config.js";
 import { findCompletedMissionGoverning, reopenGovernorMission } from "../core/governor/index.js";
-import { findCoordRoot } from "../core/hooks/resolve/coord-root.js";
 import { loadPolicyFile } from "../core/policy/index.js";
 import { acceptWorkItem, cancelWorkItem, createWorkItem, listWorkItemsWithWarnings, readWorkItem, reconcileAllWorkItems, reconcileWorkItem, reopenWorkItem, runWorkItem, } from "../core/work/index.js";
 import { WorkflowParkedError } from "../core/workflow/index.js";
@@ -344,7 +344,7 @@ export function renderAttemptBudget(record) {
     return uncharged > 0 ? `${base} (+${uncharged} uncharged)` : base;
 }
 function withWorkRoot(emit, fn) {
-    const coordRoot = findCoordRoot();
+    const coordRoot = resolveCoordRoot();
     if (!coordRoot) {
         emit.error({
             code: "no_coord_root",
@@ -362,7 +362,7 @@ function withWorkRoot(emit, fn) {
     }
 }
 async function withWorkRootAsync(emit, fn) {
-    const coordRoot = findCoordRoot();
+    const coordRoot = resolveCoordRoot();
     if (!coordRoot) {
         emit.error({
             code: "no_coord_root",

package/dist/commands/workflow.js

@@ -1,8 +1,8 @@
 import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { adapterProofInputs, createBuiltinAdapterRegistry, probeBinaryVersion, } from "../core/adapters/index.js";
+import { resolveCoordRoot } from "../core/agents/coord-client.js";
 import { resolveBinName, workflowSubscriptionOnly } from "../core/config.js";
-import { findCoordRoot } from "../core/hooks/resolve/coord-root.js";
 import { loadPolicyFile } from "../core/policy/index.js";
 import { WorkflowParkedError } from "../core/workflow/engine.js";
 export function registerWorkflowCommand(program, emit) {
@@ -37,7 +37,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--approval-to <address>", "Address durable ASK requests (default: operator)")
         .option("--json", "Emit the full RunReport as JSON")
         .action(async (script, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -156,7 +156,7 @@ export function registerWorkflowCommand(program, emit) {
         .description("Resume a parked workflow after its durable approval has been resolved.")
         .option("--json", "Emit the full RunReport or parked result as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -228,7 +228,7 @@ export function registerWorkflowCommand(program, emit) {
         .description("Show validated allocation, verification, integration, and cleanup state.")
         .option("--json", "Emit the validated workspace status as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -254,7 +254,7 @@ export function registerWorkflowCommand(program, emit) {
         .description("List validated isolated and shared-compatibility workspace decisions.")
         .option("--json", "Emit workspace inspections as JSON")
         .action(async (opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -300,7 +300,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--approval-to <address>", "Address a durable policy ASK request")
         .option("--json", "Emit the durable integration plan as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -384,7 +384,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--yes", "Confirm the target-branch mutation")
         .option("--json", "Emit the durable integration receipt as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -426,7 +426,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--yes", "Confirm the worktree and provider-branch removal attempt")
         .option("--json", "Emit the cleanup attempt or receipt as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -473,7 +473,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--discard", "Throw the uncommitted work away instead of salvaging it")
         .option("--json", "Emit the reclaim preparation and cleanup result as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",
@@ -539,7 +539,7 @@ export function registerWorkflowCommand(program, emit) {
         .option("--status <status>", "Filter: pending | approved | denied")
         .option("--json", "Emit approval records as JSON")
         .action(async (opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
             process.exit(1);
@@ -571,7 +571,7 @@ export function registerWorkflowCommand(program, emit) {
         .description("Show one durable workflow approval.")
         .option("--json", "Emit the approval record as JSON")
         .action(async (approvalId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
             process.exit(1);
@@ -600,7 +600,7 @@ export function registerWorkflowCommand(program, emit) {
             .option("--reason <text>", "Bounded decision reason")
             .option("--json", "Emit the resolved approval as JSON")
             .action(async (approvalId, opts) => {
-            const coordRoot = findCoordRoot();
+            const coordRoot = resolveCoordRoot();
             if (!coordRoot) {
                 emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
                 process.exit(1);
@@ -640,7 +640,7 @@ export function registerWorkflowCommand(program, emit) {
         .description("Show the bounded proof packet for a completed workflow run.")
         .option("--json", "Emit the stored proof packet as JSON")
         .action(async (runId, opts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
             emit.error({
                 code: "no_coord_root",

package/dist/core/adapters/profiles.d.ts

@@ -62,7 +62,7 @@ export declare const BUILTIN_ADAPTER_PROFILES: {
     };
 };
 export type BuiltinAdapterId = keyof typeof BUILTIN_ADAPTER_PROFILES;
-export declare const BUILTIN_ADAPTER_IDS: readonly ("claude-code" | "cursor" | "codex")[];
+export declare const BUILTIN_ADAPTER_IDS: readonly ("cursor" | "claude-code" | "codex")[];
 export declare function isBuiltinAdapter(id: string): id is BuiltinAdapterId;
 export declare function builtinAdapterProfile(id: string): AdapterProfile | undefined;
 export declare function validateAdapterEffort(id: string, effort: string | undefined): void;

package/dist/core/agents/canonical-emit.d.ts

@@ -10,6 +10,7 @@
  * seconds and record the observation before the parent command exits.
  */
 import type { LiveCoordinationObservationV3 } from "../events/v3/live-observation.js";
+import type { Heartbeat } from "./state/heartbeat-reader.js";
 export type EventV3EmitObservation = LiveCoordinationObservationV3 | {
     event_type: "coord.lifecycle_changed";
     new_state: "active" | "blocked" | "done";
@@ -35,4 +36,6 @@ export declare function emitEventV3(input: EventV3EmitInput): boolean;
  * Normalize the heartbeat's `platform` field to the canonical Adapter type.
  */
 export declare function normalizeAdapter(platform: string | undefined): "claude-code" | "cursor" | "codex";
+/** Producer joins use the private native session ID, never its V3 fingerprint. */
+export declare function nativeSessionIdentity(row: Pick<Heartbeat, "native_session_id" | "session_id"> | null | undefined, fallback: string): string;
 //# sourceMappingURL=canonical-emit.d.ts.map

package/dist/core/agents/canonical-emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAItF,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG"}
+{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR"}

package/dist/core/agents/canonical-emit.js

@@ -80,3 +80,15 @@ export function normalizeAdapter(platform) {
         return "codex";
     return "claude-code";
 }
+/** Producer joins use the private native session ID, never its V3 fingerprint. */
+export function nativeSessionIdentity(row, fallback) {
+    if (row?.native_session_id)
+        return row.native_session_id;
+    // A projection-only row carries the privacy-safe canonical session
+    // fingerprint, not the adapter's native session ID needed to join the hook
+    // producer. Until a disposable cache exists, the resolved owner is the only
+    // native identity available to command surfaces.
+    if (row?.session_id && !/^sid_[a-f0-9]{64}$/.test(row.session_id))
+        return row.session_id;
+    return fallback;
+}

package/dist/core/agents/claim-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical identity for an authority-bearing write claim.
+ *
+ * Workspace paths stay portable and repository-relative. Approved paths
+ * outside the coordination root become resolved absolute paths so a later
+ * release matches whether the caller supplies the stored dot-dot form or the
+ * absolute target. This is lexical identity only; finalization policy owns the
+ * physical containment and symlink checks before a claim is acquired.
+ */
+export declare function canonicalClaimPath(coordRoot: string, value: string): string;
+//# sourceMappingURL=claim-path.d.ts.map

package/dist/core/agents/claim-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-path.d.ts","sourceRoot":"","sources":["../../../src/core/agents/claim-path.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3E"}

package/dist/core/agents/claim-path.js

@@ -0,0 +1,22 @@
+import { isAbsolute, relative, resolve, sep } from "node:path";
+/**
+ * Canonical identity for an authority-bearing write claim.
+ *
+ * Workspace paths stay portable and repository-relative. Approved paths
+ * outside the coordination root become resolved absolute paths so a later
+ * release matches whether the caller supplies the stored dot-dot form or the
+ * absolute target. This is lexical identity only; finalization policy owns the
+ * physical containment and symlink checks before a claim is acquired.
+ */
+export function canonicalClaimPath(coordRoot, value) {
+    const root = resolve(coordRoot);
+    const absolute = resolve(root, value);
+    const fromRoot = relative(root, absolute);
+    const contained = fromRoot !== ".." && !fromRoot.startsWith(`..${sep}`) && !isAbsolute(fromRoot);
+    if (contained)
+        return portable(fromRoot || ".");
+    return portable(absolute);
+}
+function portable(value) {
+    return value.split(sep).join("/");
+}