harnery 0.46.0 → 0.47.0

package/dist/core/agents/state/proc-start.js

@@ -52,10 +52,11 @@ let cachedBootId;
  */
 export function startTokenProbe() {
     const override = coordEnv("PID_PROBE");
-    if (override === "procfs" || override === "ps")
+    if (override === "procfs" || override === "ps" || override === "windows")
         return override;
     if (cachedProbe === undefined) {
-        cachedProbe = existsSync("/proc/self/stat") ? "procfs" : "ps";
+        cachedProbe =
+            process.platform === "win32" ? "windows" : existsSync("/proc/self/stat") ? "procfs" : "ps";
     }
     return cachedProbe;
 }
@@ -147,9 +148,30 @@ function defaultPsRun(pid) {
  * will not say.
  */
 export function processStartToken(pid) {
-    if (!Number.isFinite(pid) || pid <= 0)
+    if (!Number.isSafeInteger(pid) || pid <= 0)
         return null;
-    return startTokenProbe() === "procfs" ? procfsStartToken(pid) : psStartToken(pid);
+    const probe = startTokenProbe();
+    if (probe === "windows")
+        return windowsStartToken(pid);
+    return probe === "procfs" ? procfsStartToken(pid) : psStartToken(pid);
+}
+/** Windows process creation time in invariant UTC ticks, independent of locale. */
+export function windowsStartToken(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return null;
+    try {
+        const out = spawnSync("powershell.exe", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            `try { (Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks } catch { exit 1 }`,
+        ], { encoding: "utf8", timeout: 4_000, windowsHide: true });
+        const ticks = out.stdout?.trim();
+        return out.status === 0 && ticks && /^\d+$/.test(ticks) ? `w${ticks}` : null;
+    }
+    catch {
+        return null;
+    }
 }
 /**
  * Does `pid` still name the run that wrote `recordedToken`?

package/dist/core/autoupdate/engine.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Project self-update engine (ADR 0229).
+ *
+ * `autoUpdateTick` is the hot path every prompt, session start, and host CLI
+ * command calls: one stat of the throttle stamp when nothing is due. When the
+ * stamp is stale it claims the stamp and launches a detached
+ * `<harn> autoupdate run --background`, which decides with `checkForUpdate`
+ * and, only when needed, runs the host's configured steps under a lock.
+ */
+import { type GitRunner } from "./git.js";
+import { type LockInspection, type LockOwner } from "./state.js";
+import { type AutoUpdateConfig, type AutoUpdateNotice, type AutoUpdateState, type CheckDecision, type RunOutcome, type RunRecord, type TickResult } from "./types.js";
+/** Set on the detached runner and every step so nested CLI calls never tick. */
+export declare const AUTOUPDATE_CHILD_ENV = "HARNERY_AUTOUPDATE_CHILD";
+export interface StepRunResult {
+    exitCode: number | null;
+    timedOut: boolean;
+    output: string;
+    ms: number;
+}
+export type StepRunner = (argv: string[], opts: {
+    cwd: string;
+    timeoutMs: number;
+    env: NodeJS.ProcessEnv;
+    onChunk?: (chunk: string, stream: "stdout" | "stderr") => void;
+}) => Promise<StepRunResult>;
+export interface AutoUpdateDeps {
+    now?: () => number;
+    env?: NodeJS.ProcessEnv;
+    readConfig?: (coordRoot: string) => AutoUpdateConfig | null;
+    git?: GitRunner;
+    /** Launch the detached runner (tick). */
+    spawnRunner?: (coordRoot: string) => void;
+    runStep?: StepRunner;
+    /** Expired-artifact cleanup; best effort. */
+    runCleanup?: (coordRoot: string) => void;
+    binName?: string;
+}
+/** The CLI entry the detached runner executes with `process.execPath`. */
+export declare function harnCliEntry(): string;
+/** Set the throttle stamp's mtime (creating it), which is all the tick reads. */
+export declare function setStamp(coordRoot: string, atMs: number): void;
+/** Keep the log bounded: past 256 KB, keep only its last 64 KB. */
+export declare function rotateLog(path: string): void;
+export declare function isInstructionPath(path: string): boolean;
+export declare function isHookConfigPath(path: string): boolean;
+/** `harnery-notice:` lines in step output. */
+export declare function parseNoticeLines(output: string): string[];
+/**
+ * Activity hook. Never throws. When throttled it reads the config and stats
+ * one file; it runs no Git and parses no state.
+ */
+export declare function autoUpdateTick(coordRoot: string, deps?: AutoUpdateDeps): TickResult;
+export declare function checkForUpdate(coordRoot: string, cfg: AutoUpdateConfig, state: AutoUpdateState, deps?: AutoUpdateDeps & {
+    force?: boolean;
+}): CheckDecision;
+/**
+ * Resolve a step's argv for the current platform. On Windows a bare command
+ * name such as `bun` or `git` is looked up on PATH with PATHEXT, because
+ * spawning without a shell does not try `.cmd` shims; a `.cmd` or `.bat`
+ * match runs through `cmd.exe`. Elsewhere the argv is used as is.
+ */
+export declare function resolveStepCommand(cmd: string, args: string[], env: NodeJS.ProcessEnv, platform?: NodeJS.Platform, exists?: (path: string) => boolean): {
+    cmd: string;
+    args: string[];
+    verbatim: boolean;
+};
+export declare const defaultStepRunner: StepRunner;
+export interface RunAutoUpdateOptions {
+    force?: boolean;
+    /** Detached runner: output goes to the log only. */
+    background?: boolean;
+    /** Foreground streaming of step output (in addition to the log). */
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    deps?: AutoUpdateDeps;
+}
+export interface RunAutoUpdateResult {
+    outcome: RunOutcome;
+    decision: CheckDecision | null;
+    record: RunRecord | null;
+    /** Notices recorded by this run. */
+    notices: AutoUpdateNotice[];
+    /** Holder of the lock when `skipped-locked`. */
+    lockOwner?: LockOwner | null;
+}
+export declare function runAutoUpdate(coordRootRaw: string, opts?: RunAutoUpdateOptions): Promise<RunAutoUpdateResult>;
+export interface AutoUpdateStatus {
+    config: AutoUpdateConfig | null;
+    state: AutoUpdateState;
+    /** Milliseconds since the throttle stamp (negative while backing off); null when never checked. */
+    stampAge: number | null;
+    /** Milliseconds until a tick would launch a check; 0 when due. */
+    nextCheckMs: number | null;
+    locked: LockInspection;
+}
+export declare function autoUpdateStatus(coordRootRaw: string, deps?: AutoUpdateDeps): AutoUpdateStatus;
+//# sourceMappingURL=engine.d.ts.map

package/dist/core/autoupdate/engine.d.ts.map

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