harnery 0.45.1 → 0.46.0

package/dist/core/events/v3/runtime-build.d.ts

@@ -8,4 +8,18 @@ export { liveEventV3BuildId, livePlatformV3 } from "./runtime-identity.js";
  */
 export declare function currentHarneryRuntimeBuild(): string;
 export declare function harneryPackageRoot(): string;
+export interface HarneryBuild {
+    version: string;
+    revision: string;
+}
+/** The installed package version and runtime revision; "unknown" when unreadable. */
+export declare function installedHarneryBuild(): HarneryBuild;
+export interface ServiceBuildStatus {
+    running_build: HarneryBuild | null;
+    installed_build: HarneryBuild;
+    restart_needed: boolean;
+    build_status: string;
+}
+/** A missing or unknown running build, or any difference, means restart. */
+export declare function serviceBuildStatus(recorded: unknown): ServiceBuildStatus;
 //# sourceMappingURL=runtime-build.d.ts.map

package/dist/core/events/v3/runtime-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-build.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-build.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAuBnD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}
+{"version":3,"file":"runtime-build.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-build.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAuBnD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,YAAY,CAkBpD;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,YAAY,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,CA0BxE"}

package/dist/core/events/v3/runtime-build.js

@@ -38,3 +38,47 @@ export function currentHarneryRuntimeBuild() {
 export function harneryPackageRoot() {
     return resolve(dirname(fileURLToPath(import.meta.url)), "../../../..");
 }
+/** The installed package version and runtime revision; "unknown" when unreadable. */
+export function installedHarneryBuild() {
+    let version = "unknown";
+    let revision = "unknown";
+    try {
+        const manifest = JSON.parse(readFileSync(resolve(harneryPackageRoot(), "package.json"), "utf8"));
+        if (typeof manifest.version === "string" && manifest.version.length <= 100)
+            version = manifest.version;
+    }
+    catch {
+        // Missing package metadata cannot establish that a running build is current.
+    }
+    try {
+        revision = currentHarneryRuntimeBuild();
+    }
+    catch {
+        // Status still reports the unavailable build instead of guessing a match.
+    }
+    return { version, revision };
+}
+/** A missing or unknown running build, or any difference, means restart. */
+export function serviceBuildStatus(recorded) {
+    const installed_build = installedHarneryBuild();
+    const candidate = recorded;
+    const known = (value) => typeof value === "string" && value.length > 0 && value.length <= 100 && value !== "unknown";
+    const running_build = candidate && known(candidate.version) && known(candidate.revision)
+        ? { version: candidate.version, revision: candidate.revision }
+        : null;
+    const restart_needed = running_build === null ||
+        installed_build.version === "unknown" ||
+        installed_build.revision === "unknown" ||
+        running_build.version !== installed_build.version ||
+        running_build.revision !== installed_build.revision;
+    return {
+        running_build,
+        installed_build,
+        restart_needed,
+        build_status: running_build === null
+            ? "running build unknown; restart needed"
+            : restart_needed
+                ? "restart needed"
+                : "current",
+    };
+}

package/dist/core/events/v3/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,eAAe,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAuCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAkBvE;AAkSD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAKtE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,eAAe,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgFD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAkBvE;AAkSD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAKtE"}

package/dist/core/events/v3/validate.js

@@ -1,8 +1,43 @@
 import { Value } from "@sinclair/typebox/value";
 import { canonicalJsonV3 } from "./canonical.js";
 import { EventV3Schema } from "./contract.js";
+/**
+ * Every union member requires its own literal `event_type`, so only the member
+ * named by a value's `event_type` can accept it. Checking that one member gives
+ * the union's verdict without trying the other variants, which more than halves
+ * a full-ledger read. Returns null, falling back to the whole union, if a member
+ * ever stops carrying a required unique literal.
+ */
+let eventVariantsByType;
+function eventVariantsByTypeV3() {
+    if (eventVariantsByType !== undefined)
+        return eventVariantsByType;
+    const variants = new Map();
+    for (const variant of EventV3Schema.anyOf) {
+        const literal = variant.properties.event_type?.const;
+        if (typeof literal !== "string" ||
+            !variant.required?.includes("event_type") ||
+            variants.has(literal)) {
+            eventVariantsByType = null;
+            return null;
+        }
+        variants.set(literal, variant);
+    }
+    eventVariantsByType = variants;
+    return variants;
+}
+function checkEventSchemaV3(value) {
+    const variants = eventVariantsByTypeV3();
+    if (!variants)
+        return Value.Check(EventV3Schema, value);
+    const eventType = typeof value === "object" && value !== null
+        ? value.event_type
+        : undefined;
+    const variant = typeof eventType === "string" ? variants.get(eventType) : undefined;
+    return variant !== undefined && Value.Check(variant, value);
+}
 export function validateEventV3(value) {
-    if (!Value.Check(EventV3Schema, value)) {
+    if (!checkEventSchemaV3(value)) {
         return {
             ok: false,
             issues: [...Value.Errors(EventV3Schema, value)]

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

@@ -2,6 +2,7 @@ export { approveGovernorPlan, findCompletedMissionGoverning, rejectGovernorPlan,
 export { readGovernorPlan, readGovernorPlanReviewReceipt, readGovernorPlans, } from "./plan-read.js";
 export { type CreateGovernorPlanTemplateInput, type CreateGovernorReplanningInput, GOVERNOR_PLAN_SCHEMA_VERSION, type GovernorPlanEvent, type GovernorPlanEventType, type GovernorPlanHistory, type GovernorPlanMilestone, type GovernorPlanOutcome, type GovernorPlanProposal, type GovernorPlanRecord, type GovernorPlanRequest, type GovernorPlanReviewFinding, type GovernorPlanReviewReceipt, type GovernorPlanReviewReviewer, type GovernorPlanReviewRound, type GovernorPlanReviewStatus, type GovernorPlanReviewSummary, type GovernorPlanReviewVerdict, type GovernorPlanStatus, type GovernorPlanTemplate, type GovernorPlanWorkSpec, type GovernorReplanningPolicy, MAX_GOVERNOR_PLAN_REVIEWERS, MAX_GOVERNOR_PLAN_REVISION_ROUNDS, } from "./plan-types.js";
 export { type GovernorDispatchOutcome, type GovernorRunReport, type GovernorStopReason, type RunGovernorInput, runGovernor, } from "./runner.js";
-export { type ConfigureGovernorServiceInput, configureGovernorService, GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION, GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION, GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION, type GovernorServiceConfig, type GovernorServiceEngineConfig, type GovernorServiceGoalRuntime, type GovernorServiceGoalState, type GovernorServiceProcessState, type GovernorServiceRuntime, type GovernorServiceStatus, type GovernorServiceStatusRecord, type GovernorServiceSweepOutcome, type GovernorServiceSweepReport, governorServiceLogPath, type RunGovernorServiceDaemonInput, type RunGovernorServiceSweepInput, readGovernorServiceConfig, readGovernorServiceRuntime, readGovernorServiceStatus, requestGovernorServiceStop, runGovernorServiceDaemon, runGovernorServiceSweep, spawnGovernorService, } from "./service.js";
+export { type ConfigureGovernorServiceInput, configureGovernorService, GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION, GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION, GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION, type GovernorServiceConfig, type GovernorServiceEngineConfig, type GovernorServiceGoalRuntime, type GovernorServiceGoalState, type GovernorServiceProcessState, type GovernorServiceRuntime, type GovernorServiceStatus, type GovernorServiceStatusRecord, type GovernorServiceSweepOutcome, type GovernorServiceSweepReport, governorServiceLogPath, type RunGovernorServiceDaemonInput, type RunGovernorServiceSweepInput, readGovernorServiceConfig, requestGovernorServiceStop, runGovernorServiceDaemon, runGovernorServiceSweep, spawnGovernorService, } from "./service.js";
+export { readGovernorServiceRuntime, readGovernorServiceStatus } from "./service-read.js";
 export { assertGovernorId, type CreateGovernorInput, type CreateGovernorMissionInput, collectGovernorWork, createGovernor, GOVERNOR_INTENT_SCHEMA_VERSION, type GovernorAutomationPolicy, type GovernorIntent, type GovernorLimits, type GovernorListResult, type GovernorListWarning, type GovernorMission, type GovernorNextAction, type GovernorProjection, type GovernorRecord, type GovernorState, listGovernors, listGovernorsWithWarnings, newGovernorId, readGovernor, } from "./state.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/governor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,6BAA6B,EAClC,wBAAwB,EACxB,sCAAsC,EACtC,uCAAuC,EACvC,sCAAsC,EACtC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,cAAc,EACd,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,aAAa,EACb,yBAAyB,EACzB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/governor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,6BAA6B,EAClC,wBAAwB,EACxB,sCAAsC,EACtC,uCAAuC,EACvC,sCAAsC,EACtC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,cAAc,EACd,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,aAAa,EACb,yBAAyB,EACzB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/core/governor/index.js

@@ -2,5 +2,6 @@ export { approveGovernorPlan, findCompletedMissionGoverning, rejectGovernorPlan,
 export { readGovernorPlan, readGovernorPlanReviewReceipt, readGovernorPlans, } from "./plan-read.js";
 export { GOVERNOR_PLAN_SCHEMA_VERSION, MAX_GOVERNOR_PLAN_REVIEWERS, MAX_GOVERNOR_PLAN_REVISION_ROUNDS, } from "./plan-types.js";
 export { runGovernor, } from "./runner.js";
-export { configureGovernorService, GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION, GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION, GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION, governorServiceLogPath, readGovernorServiceConfig, readGovernorServiceRuntime, readGovernorServiceStatus, requestGovernorServiceStop, runGovernorServiceDaemon, runGovernorServiceSweep, spawnGovernorService, } from "./service.js";
+export { configureGovernorService, GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION, GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION, GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION, governorServiceLogPath, readGovernorServiceConfig, requestGovernorServiceStop, runGovernorServiceDaemon, runGovernorServiceSweep, spawnGovernorService, } from "./service.js";
+export { readGovernorServiceRuntime, readGovernorServiceStatus } from "./service-read.js";
 export { assertGovernorId, collectGovernorWork, createGovernor, GOVERNOR_INTENT_SCHEMA_VERSION, listGovernors, listGovernorsWithWarnings, newGovernorId, readGovernor, } from "./state.js";

package/dist/core/governor/service-read.d.ts

@@ -1,15 +1,8 @@
-import { type ProcessGenerationVerdict } from "../agents/state/proc-start.js";
-import type { GovernorServiceBuild, GovernorServiceConfig, GovernorServiceProcessDependencies, GovernorServiceRuntime, GovernorServiceStatus, GovernorServiceStatusRecord } from "./service.js";
-export declare function currentGovernorServiceBuild(): GovernorServiceBuild;
-export declare function governorServiceBuildStatus(record: GovernorServiceStatusRecord | undefined): Pick<GovernorServiceStatus, "running_build" | "installed_build" | "restart_needed" | "build_status">;
-/** An unknown token or process probe cannot establish a running or stopped owner. */
-export declare function observeGovernorServiceProcess(record: Pick<GovernorServiceStatusRecord, "pid" | "host" | "state" | "start_token"> | undefined, dependencies?: GovernorServiceProcessDependencies): {
-    generation: ProcessGenerationVerdict;
-    liveness: GovernorServiceStatus["liveness"];
-};
+import { type ServiceProcessDependencies } from "../agents/state/service-process.js";
+import type { GovernorServiceConfig, GovernorServiceRuntime, GovernorServiceStatus } from "./service.js";
 export declare function readGovernorServiceConfig(coordRootRaw: string): GovernorServiceConfig;
 export declare function readGovernorServiceRuntime(coordRootRaw: string): GovernorServiceRuntime | undefined;
-export declare function readGovernorServiceStatus(coordRootRaw: string, dependencies?: GovernorServiceProcessDependencies): GovernorServiceStatus;
+export declare function readGovernorServiceStatus(coordRootRaw: string, dependencies?: ServiceProcessDependencies): GovernorServiceStatus;
 export declare function governorServiceLogPath(coordRoot: string): string;
 export interface GovernorServiceLogReadOptions {
     max_bytes?: number;

package/dist/core/governor/service-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-read.d.ts","sourceRoot":"","sources":["../../../src/core/governor/service-read.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kCAAkC,EAClC,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAMtB,wBAAgB,2BAA2B,IAAI,oBAAoB,CAqBlE;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,2BAA2B,GAAG,SAAS,GAC9C,IAAI,CACL,qBAAqB,EACrB,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,cAAc,CACxE,CAgCA;AAED,qFAAqF;AACrF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,GAAG,SAAS,EAC/F,YAAY,GAAE,kCAAuC,GACpD;IAAE,UAAU,EAAE,wBAAwB,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;CAAE,CA2BvF;AAOD,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CA0BrF;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,sBAAsB,GAAG,SAAS,CAgBpC;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,GAAE,kCAAuC,GACpD,qBAAqB,CA4BvB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAahE;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAeD,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,6BAAkC,GAC1C,4BAA4B,CA6D9B"}
+{"version":3,"file":"service-read.d.ts","sourceRoot":"","sources":["../../../src/core/governor/service-read.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,oCAAoC,CAAC;AAM5C,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAMtB,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CA0BrF;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,sBAAsB,GAAG,SAAS,CAgBpC;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,GAAE,0BAA+B,GAC5C,qBAAqB,CA8BvB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAahE;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAeD,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,6BAAkC,GAC1C,4BAA4B,CA6D9B"}

package/dist/core/governor/service-read.js

@@ -1,101 +1,15 @@
 import { closeSync, existsSync, openSync, readFileSync, readSync, statSync } from "node:fs";
-import { hostname } from "node:os";
 import { join, resolve } from "node:path";
 import { gunzipSync } from "node:zlib";
 import { coordEnv } from "../../lib/env.js";
-import { verifyProcessGeneration, } from "../agents/state/proc-start.js";
-import { currentHarneryRuntimeBuild } from "../events/v3/runtime-build.js";
+import { observeServiceProcess, } from "../agents/state/service-process.js";
+import { serviceBuildStatus } from "../events/v3/runtime-build.js";
 import { createStorageCatalog } from "../storage/catalog.js";
 import { parseLogRecord } from "../storage/jsonl.js";
 import { familyLogDirectory, readSegmentManifest } from "../storage/segments.js";
 const MAX_FILE_BYTES = 512 * 1024;
 const MAX_LOG_RECORDS = 10_000;
 const MAX_GOALS = 100;
-export function currentGovernorServiceBuild() {
-    let version = "unknown";
-    let revision = "unknown";
-    try {
-        const manifest = JSON.parse(readFileSync(new URL("../../../package.json", import.meta.url), "utf8"));
-        if (typeof manifest.version === "string" && manifest.version.length <= 100) {
-            version = manifest.version;
-        }
-    }
-    catch {
-        // Missing package metadata cannot establish that the running build is current.
-    }
-    try {
-        revision = currentHarneryRuntimeBuild();
-    }
-    catch {
-        // Status still reports the unavailable build instead of guessing a match.
-    }
-    return { version, revision };
-}
-export function governorServiceBuildStatus(record) {
-    const installed_build = currentGovernorServiceBuild();
-    const candidate = record?.running_build;
-    const running_build = candidate &&
-        typeof candidate.version === "string" &&
-        candidate.version.length > 0 &&
-        candidate.version.length <= 100 &&
-        typeof candidate.revision === "string" &&
-        candidate.revision.length > 0 &&
-        candidate.revision.length <= 100 &&
-        candidate.version !== "unknown" &&
-        candidate.revision !== "unknown"
-        ? candidate
-        : null;
-    const restart_needed = running_build === null ||
-        installed_build.version === "unknown" ||
-        installed_build.revision === "unknown" ||
-        running_build.version !== installed_build.version ||
-        running_build.revision !== installed_build.revision;
-    return {
-        running_build,
-        installed_build,
-        restart_needed,
-        build_status: running_build === null
-            ? "running build unknown; restart needed"
-            : restart_needed
-                ? "restart needed"
-                : "current",
-    };
-}
-/** An unknown token or process probe cannot establish a running or stopped owner. */
-export function observeGovernorServiceProcess(record, dependencies = {}) {
-    if (!record)
-        return { generation: "unknown", liveness: "stopped" };
-    const generation = record.host === hostname()
-        ? verifyProcessGeneration(record.pid, record.start_token, dependencies.readToken)
-        : "unknown";
-    if (record.host !== hostname())
-        return { generation, liveness: "unknown" };
-    try {
-        const present = (dependencies.probePid ?? probePid)(record.pid);
-        if (!present)
-            return { generation, liveness: "stopped" };
-    }
-    catch (error) {
-        return {
-            generation,
-            liveness: error.code === "ESRCH" ? "stopped" : "unknown",
-        };
-    }
-    return {
-        generation,
-        liveness: generation === "same"
-            ? record.state === "stopped"
-                ? "stopped"
-                : "running"
-            : generation === "different"
-                ? "stopped"
-                : "unknown",
-    };
-}
-function probePid(pid) {
-    process.kill(pid, 0);
-    return true;
-}
 export function readGovernorServiceConfig(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     const config = readBoundedJson(join(serviceDir(coordRoot), "config.json"), "governor service configuration");
@@ -151,15 +65,17 @@ export function readGovernorServiceStatus(coordRootRaw, dependencies = {}) {
     catch {
         // Runtime is recoverable and must not make the dashboard unreadable.
     }
-    const observation = observeGovernorServiceProcess(record, dependencies);
-    if (!record && existsSync(join(serviceDir(coordRoot), "status.json"))) {
-        observation.liveness = "unknown";
-    }
+    const observation = record
+        ? observeServiceProcess(record, dependencies)
+        : {
+            generation: "unknown",
+            liveness: existsSync(join(serviceDir(coordRoot), "status.json")) ? "unknown" : "stopped",
+        };
     return {
-        running: observation.liveness === "running" && record?.state !== "stopped",
+        running: observation.liveness === "running",
         stale: observation.liveness === "stopped" && record !== undefined && record.state !== "stopped",
         ...observation,
-        ...governorServiceBuildStatus(record),
+        ...serviceBuildStatus(record?.running_build),
         record,
         config,
         runtime,

package/dist/core/governor/service.d.ts

@@ -1,4 +1,5 @@
-import { type ProcessGenerationSignalDependencies, type ProcessGenerationVerdict } from "../agents/state/proc-start.js";
+import { type ProcessGenerationVerdict } from "../agents/state/proc-start.js";
+import { type ServiceProcessDependencies } from "../agents/state/service-process.js";
 import { type NormalizedPolicy, type PolicyIsolation } from "../policy/index.js";
 import type { RunWorkItemInput } from "../work/index.js";
 import { type GovernorRunReport, type GovernorStopReason } from "./runner.js";
@@ -55,9 +56,6 @@ export interface GovernorServiceBuild {
     version: string;
     revision: string;
 }
-export interface GovernorServiceProcessDependencies extends ProcessGenerationSignalDependencies {
-    probePid?: (pid: number) => boolean;
-}
 export interface GovernorServiceStatusRecord {
     schema_version: typeof GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION;
     pid: number;
@@ -122,10 +120,8 @@ export interface RunGovernorServiceDaemonInput {
 }
 export declare function configureGovernorService(input: ConfigureGovernorServiceInput): GovernorServiceConfig;
 export declare function readGovernorServiceConfig(coordRootRaw: string): GovernorServiceConfig;
-export declare function readGovernorServiceRuntime(coordRootRaw: string): GovernorServiceRuntime | undefined;
-export declare function readGovernorServiceStatus(coordRootRaw: string, dependencies?: GovernorServiceProcessDependencies): GovernorServiceStatus;
 export declare function spawnGovernorService(coordRootRaw: string): Promise<GovernorServiceStatus>;
-export declare function requestGovernorServiceStop(coordRootRaw: string, dependencies?: GovernorServiceProcessDependencies): GovernorServiceStatus;
+export declare function requestGovernorServiceStop(coordRootRaw: string, dependencies?: ServiceProcessDependencies): GovernorServiceStatus;
 export declare function runGovernorServiceSweep(input: RunGovernorServiceSweepInput): Promise<GovernorServiceSweepReport>;
 export declare function runGovernorServiceDaemon(input: RunGovernorServiceDaemonInput): Promise<GovernorServiceStatusRecord>;
 export declare function governorServiceLogPath(coordRoot: string): string;

package/dist/core/governor/service.d.ts.map

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

package/dist/core/governor/service.js

@@ -1,17 +1,19 @@
 import { spawn } from "node:child_process";
 import { randomBytes, randomUUID } from "node:crypto";
-import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { coordEnv } from "../../lib/env.js";
-import { processStartToken, signalIfSameGeneration, } from "../agents/state/proc-start.js";
+import { processStartToken } from "../agents/state/proc-start.js";
+import { acquireServiceLease, requestServiceStop, serviceStartRefusal, } from "../agents/state/service-process.js";
 import { resolveBinName } from "../config.js";
+import { installedHarneryBuild } from "../events/v3/runtime-build.js";
 import { normalizePolicy } from "../policy/index.js";
 import { closeProcessLoggers, legacyLogFields, processLogger } from "../storage/logger.js";
 import { stateDirMode, stateFileMode } from "../storage/modes.js";
 import { RotatingTextSink } from "../storage/process-log.js";
 import { runGovernor } from "./runner.js";
-import { currentGovernorServiceBuild, governorServiceBuildStatus, observeGovernorServiceProcess, } from "./service-read.js";
+import { readGovernorServiceRuntime, readGovernorServiceStatus } from "./service-read.js";
 import { readGovernor } from "./state.js";
 export const GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION = 1;
 export const GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION = 1;
@@ -21,15 +23,9 @@ const MAX_GOALS = 100;
 const MAX_ERROR = 2_000;
 export function configureGovernorService(input) {
     const coordRoot = resolve(input.coordRoot);
-    const active = readStatusRecord(coordRoot);
-    if (!active && existsSync(serviceStatusPath(coordRoot))) {
-        throw serviceStartRefusal(coordRoot, undefined, "unknown");
-    }
-    if (active) {
-        const liveness = statusOwnerIsLive(active);
-        if (liveness !== "stopped")
-            throw serviceStartRefusal(coordRoot, active.pid, liveness);
-    }
+    const current = readGovernorServiceStatus(coordRoot);
+    if (current.liveness !== "stopped")
+        throw startRefusal(coordRoot, current.record?.pid, current.liveness);
     const goalIds = unique(input.goalIds.map((value) => value.trim()).filter(Boolean));
     if (goalIds.length < 1 || goalIds.length > MAX_GOALS) {
         throw new Error(`governor service requires from 1 to ${MAX_GOALS} unique goal ids`);
@@ -65,57 +61,12 @@ export function readGovernorServiceConfig(coordRootRaw) {
     validateConfig(coordRoot, config);
     return config;
 }
-export function readGovernorServiceRuntime(coordRootRaw) {
-    const coordRoot = resolve(coordRootRaw);
-    if (!existsSync(serviceRuntimePath(coordRoot)))
-        return undefined;
-    const runtime = readBoundedJson(serviceRuntimePath(coordRoot), "governor service runtime");
-    if (runtime.schema_version !== GOVERNOR_SERVICE_RUNTIME_SCHEMA_VERSION ||
-        !validTimestamp(runtime.config_created_at) ||
-        !validTimestamp(runtime.updated_at) ||
-        !runtime.goals ||
-        typeof runtime.goals !== "object" ||
-        Array.isArray(runtime.goals)) {
-        throw new Error("governor service runtime has an unsupported schema");
-    }
-    return runtime;
-}
-export function readGovernorServiceStatus(coordRootRaw, dependencies = {}) {
-    const coordRoot = resolve(coordRootRaw);
-    const record = readStatusRecord(coordRoot);
-    let config;
-    let runtime;
-    try {
-        config = readGovernorServiceConfig(coordRoot);
-    }
-    catch {
-        // A service has no usable configuration until explicitly configured.
-    }
-    try {
-        runtime = readGovernorServiceRuntime(coordRoot);
-    }
-    catch {
-        // Status remains readable when recoverable runtime state is corrupt.
-    }
-    const observation = observeGovernorServiceProcess(record, dependencies);
-    if (!record && existsSync(serviceStatusPath(coordRoot)))
-        observation.liveness = "unknown";
-    return {
-        running: observation.liveness === "running" && record?.state !== "stopped",
-        stale: observation.liveness === "stopped" && record !== undefined && record.state !== "stopped",
-        ...observation,
-        ...governorServiceBuildStatus(record),
-        record,
-        config,
-        runtime,
-    };
-}
 export async function spawnGovernorService(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
     readGovernorServiceConfig(coordRoot);
     const current = readGovernorServiceStatus(coordRoot);
     if (current.liveness !== "stopped") {
-        throw serviceStartRefusal(coordRoot, current.record?.pid, current.liveness);
+        throw startRefusal(coordRoot, current.record?.pid, current.liveness);
     }
     mkdirSync(serviceDir(coordRoot), { recursive: true, mode: stateDirMode() });
     const sharedLogs = coordEnv("SHARED_LOGS") !== "0";
@@ -164,18 +115,7 @@ export function requestGovernorServiceStop(coordRootRaw, dependencies = {}) {
     if ((status.record?.state === "stopped" || !status.record) && status.liveness === "stopped") {
         return { ...status, signal_sent: false, signal_verdict: status.generation };
     }
-    writePrivateJsonAtomic(serviceStopPath(coordRoot), {
-        requested_at: new Date().toISOString(),
-        requested_by_pid: process.pid,
-    });
-    const signal = status.record?.host === hostname() && status.record.state !== "stopped"
-        ? signalIfSameGeneration(status.record.pid, status.record.start_token, "SIGTERM", dependencies)
-        : { sent: false, verdict: status.generation };
-    return {
-        ...readGovernorServiceStatus(coordRoot, dependencies),
-        signal_sent: signal.sent,
-        signal_verdict: signal.verdict,
-    };
+    return requestServiceStop(status, () => readGovernorServiceStatus(coordRoot, dependencies), serviceStopPath(coordRoot), dependencies);
 }
 export async function runGovernorServiceSweep(input) {
     const coordRoot = resolve(input.coordRoot);
@@ -313,23 +253,17 @@ export async function runGovernorServiceSweep(input) {
 export async function runGovernorServiceDaemon(input) {
     const coordRoot = resolve(input.coordRoot);
     const config = readGovernorServiceConfig(coordRoot);
-    const existing = readStatusRecord(coordRoot);
-    if (!existing && existsSync(serviceStatusPath(coordRoot))) {
-        throw serviceStartRefusal(coordRoot, undefined, "unknown");
-    }
-    if (existing) {
-        const liveness = statusOwnerIsLive(existing);
-        if (liveness !== "stopped")
-            throw serviceStartRefusal(coordRoot, existing.pid, liveness);
-    }
-    const release = acquireServiceLease(coordRoot);
+    const current = readGovernorServiceStatus(coordRoot);
+    if (current.liveness !== "stopped")
+        throw startRefusal(coordRoot, current.record?.pid, current.liveness);
+    const { release } = acquireServiceLease(serviceLeasePath(coordRoot), (pid, liveness) => startRefusal(coordRoot, pid, liveness), { running_build: installedHarneryBuild() });
     rmSync(serviceStopPath(coordRoot), { force: true });
     const now = new Date().toISOString();
     const status = {
         schema_version: GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION,
         pid: process.pid,
         start_token: processStartToken(process.pid) ?? undefined,
-        running_build: currentGovernorServiceBuild(),
+        running_build: installedHarneryBuild(),
         host: hostname(),
         nonce: randomUUID(),
         state: "starting",
@@ -537,107 +471,8 @@ function normalizeIsolation(value) {
     }
     throw new Error("service isolation must be shared, worktree, sandbox, or remote");
 }
-function acquireServiceLease(coordRoot) {
-    const path = serviceLeasePath(coordRoot);
-    mkdirSync(dirname(path), { recursive: true, mode: stateDirMode() });
-    const owner = {
-        pid: process.pid,
-        start_token: processStartToken(process.pid) ?? undefined,
-        running_build: currentGovernorServiceBuild(),
-        host: hostname(),
-        nonce: randomUUID(),
-        created_at: new Date().toISOString(),
-    };
-    const acquire = () => {
-        try {
-            const fd = openSync(path, "wx", stateFileMode());
-            try {
-                writeFileSync(fd, `${JSON.stringify(owner)}\n`, "utf8");
-            }
-            finally {
-                closeSync(fd);
-            }
-            return true;
-        }
-        catch (error) {
-            if (error.code !== "EEXIST")
-                throw error;
-            return false;
-        }
-    };
-    if (!acquire()) {
-        const existing = readLease(path);
-        const liveness = existing ? leaseOwnerIsLive(existing) : "unknown";
-        if (liveness !== "stopped") {
-            throw serviceStartRefusal(coordRoot, existing?.pid, liveness);
-        }
-        unlinkSync(path);
-        if (!acquire())
-            throw new Error("governor service lease raced with another process");
-    }
-    return () => {
-        try {
-            const existing = readLease(path);
-            if (existing?.nonce === owner.nonce)
-                unlinkSync(path);
-        }
-        catch {
-            // A stale lease is recoverable by the next explicit service start.
-        }
-    };
-}
-function readLease(path) {
-    try {
-        const value = JSON.parse(readFileSync(path, "utf8"));
-        return Number.isSafeInteger(value.pid) &&
-            (value.pid ?? 0) > 0 &&
-            typeof value.host === "string" &&
-            typeof value.nonce === "string" &&
-            typeof value.created_at === "string"
-            ? {
-                ...value,
-                start_token: typeof value.start_token === "string" ? value.start_token : undefined,
-            }
-            : null;
-    }
-    catch {
-        return null;
-    }
-}
-function leaseOwnerIsLive(lease) {
-    return observeGovernorServiceProcess({ ...lease, state: "running" }).liveness;
-}
-function readStatusRecord(coordRoot) {
-    if (!existsSync(serviceStatusPath(coordRoot)))
-        return undefined;
-    try {
-        const value = readBoundedJson(serviceStatusPath(coordRoot), "governor service status");
-        if (value.schema_version !== GOVERNOR_SERVICE_STATUS_SCHEMA_VERSION ||
-            !Number.isSafeInteger(value.pid) ||
-            value.pid < 1 ||
-            typeof value.host !== "string" ||
-            typeof value.nonce !== "string" ||
-            !validTimestamp(value.started_at) ||
-            !validTimestamp(value.heartbeat_at)) {
-            return undefined;
-        }
-        return {
-            ...value,
-            start_token: typeof value.start_token === "string" ? value.start_token : undefined,
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
-function statusOwnerIsLive(record) {
-    return observeGovernorServiceProcess(record).liveness;
-}
-function serviceStartRefusal(coordRoot, pid, liveness) {
-    const reason = liveness === "unknown"
-        ? `governor service process generation is unknown${pid ? ` for pid ${pid}` : ""}`
-        : `governor service process is still running under pid ${pid}`;
-    return new Error(`${reason}; run \`${resolveBinName(coordRoot)} governor service stop\` to write a durable stop request before starting or reconfiguring it`);
+function startRefusal(coordRoot, pid, liveness) {
+    return serviceStartRefusal("governor service", `${resolveBinName(coordRoot)} governor service stop`, pid, liveness);
 }
 export function appendGovernorServiceDiagnostic(coordRoot, data) {
     if (coordEnv("SHARED_LOGS") !== "0") {