ralph-research 0.1.1 → 0.1.3

package/README.md

@@ -1,45 +1,112 @@
 # ralph-research
 
-Local-first runtime for recursive research improvement.
+Local-first runtime for recursive research improvement over real artifacts.
 
-`ralph-research` runs a bounded improvement loop over a real artifact:
+`ralph-research` ships an actual CLI and stdio MCP server that run a bounded loop:
 
-1. define a metric
+1. load a manifest
 2. generate one candidate change
-3. evaluate it
-4. keep only verified improvements
+3. evaluate it with trusted signals
+4. persist the run, decision, and frontier state
+5. promote only verified improvements
 
-The v0.1 focus is a writing workflow that is runnable in under five minutes on a local machine.
+The current product bar is reliability, not breadth. The bundled success path is the `writing` template, while the runtime itself is manifest-driven and reusable for other local workflows.
 
-## Quickstart
+## Trust Signals
 
-### Zero-config demo
+- Actual shipped surfaces: CLI binary `rrx` and stdio MCP server
+- Development verification commands: `npm test`, `npm run typecheck`, `npm run build`
+- Persisted runtime evidence: runs, decisions, frontier, and lock metadata
+- Recovery semantics are enforced by code and persisted state, not described only in prompts
+- Supported onboarding path is intentionally narrower than the full manifest surface
+
+## What It Is
+
+- A Node/TypeScript runtime with a real CLI: `rrx`
+- A stdio MCP server backed by the same service layer as the CLI
+- A Git-aware candidate execution loop with persisted run, decision, and frontier state
+- A local-first system designed to be resumed, inspected, and trusted after interruptions
+
+## What It Is Not
+
+- Not a no-config autonomous agent for arbitrary domains out of the box
+- Not a hosted service
+- Not a prompt-only protocol with undocumented runtime behavior
+- Not broader than the shipped contract: one bundled template (`writing`) and three MCP tools
+
+## Quick Decision Guide
+
+| If you want to... | Use |
+| --- | --- |
+| Check whether a repo is runnable | `rrx validate` then `rrx doctor` |
+| Materialize the bundled example project | `rrx init --template writing` |
+| Run a disposable end-to-end demo | `rrx demo writing` |
+| Launch the v1 goal-driven orchestrator | `rrx "improve the holdout top-3 model"` |
+| Launch the v1 goal-driven orchestrator explicitly | `rrx launch "improve the holdout top-3 model"` |
+| Resume a persisted TUI research session | `rrx resume latest` |
+| Execute one cycle | `rrx run --json` |
+| Resume the latest recoverable run | `rrx run` |
+| Force a fresh run id | `rrx run --fresh` |
+| Inspect runtime and recovery state | `rrx status --json` |
+| Inspect why one run was accepted or rejected | `rrx inspect <runId> --json` |
+| Review the current accepted frontier | `rrx frontier --json` |
+| Serve the same contract over MCP stdio | `rrx serve-mcp --stdio` |
+
+## Five-Minute Start
+
+### Option A: disposable demo
 
 ```bash
 npx ralph-research demo writing
 ```
 
-This creates a temporary writing repo, runs one accepted cycle, and prints the path plus the run id. The v0.1 demo supports the bundled `writing` template only.
+This creates a temporary Git repo, runs one accepted cycle, and prints the temp path plus the run id.
 
-### Template flow
+### Option B: initialize a local repo
 
 ```bash
 npx ralph-research init --template writing
+npx ralph-research doctor
 npx ralph-research run --json
-npx ralph-research run --until-target --until-no-improve 3 --json
+npx ralph-research status --json
 npx ralph-research inspect run-0001 --json
 ```
 
-This path is the v0.1 success bar: `init -> run -> inspect` should work quickly and produce an acceptance reason you can inspect. The bundled template set is currently `writing` only.
+This is the current truth contract for the bundled template: `init -> run -> inspect` should succeed quickly on a local machine.
 
-## Core Concepts
+`rrx "goal"` now creates or refreshes the launch draft session and drops into the v1 TUI shell. Initial launch does not start an autonomous research cycle until the shell tells it to continue.
+
+When you submit the review step, the shell materializes a real research session and hands control to the selected agent runtime. Once that interactive run returns, `launch-draft` is removed. The remaining persisted session is the only runtime record you need to inspect or resume.
+
+Resume semantics are intentionally narrow:
 
-- `Manifest`: `ralph.yaml` defines the research program.
-- `Metric`: how candidate quality is measured.
-- `Frontier`: the currently accepted best candidate set.
-- `Ratchet`: the acceptance policy that decides whether the frontier advances.
-- `Proposer`: how a bounded candidate change is generated.
-- `Judge`: how qualitative outputs are compared when numeric metrics are not enough.
+- `rrx resume <sessionId>` only works for sessions that ended after a completed cycle checkpoint
+- interrupted sessions are resumable because the runtime has durable evidence for the next cycle boundary
+- a clean agent exit without `goal_achieved` or a completed checkpoint is treated as terminal and is not resumable
+
+## Runtime Model
+
+The runtime is manifest-driven. `ralph.yaml` defines the project, proposer, experiment, metrics, ratchet, and storage root. The service layer then:
+
+- loads and validates the manifest
+- acquires a durable lock
+- classifies recovery against the latest persisted run
+- executes or resumes a candidate
+- writes run, decision, and frontier state under the storage root
+
+See [docs/operation-model.md](docs/operation-model.md) for the full lifecycle and recovery model.
+
+## Current Scope
+
+- Bundled template: `writing`
+- Default template metric: local command metric, no API key required
+- Optional judge path: pairwise LLM judge packs
+- MCP tools:
+  - `run_research_cycle`
+  - `get_research_status`
+  - `get_frontier`
+
+The runtime supports broader manifests than the bundled template demonstrates, but the shipped onboarding path is intentionally narrow until those flows are equally reliable.
 
 ## Writing Template
 
@@ -49,19 +116,51 @@ The bundled writing template is self-contained:
 - `scripts/propose.mjs`: bounded rewrite
 - `scripts/experiment.mjs`: output materialization
 - `scripts/metric.mjs`: local heuristic metric
-- `prompts/judge.md`: pairwise judge prompt you can upgrade to later
+- `prompts/judge.md`: pairwise judge prompt starter
+
+`templates/writing/ralph.yaml` uses a local command metric by default, so the first run works without model credentials.
+
+## Progressive Runs
 
-The default template uses a local command metric so the first run does not require API keys. When you are ready, replace the numeric metric with an `llm_judge` extractor and use the included pairwise prompt as a starting point.
+`rrx run` executes one cycle by default and auto-resumes the latest recoverable run when one exists.
+
+Progressive stop modes are opt-in:
+
+- `--fresh`: start a new `runId` instead of auto-resuming the latest recoverable run
+- `--until-target`: keep iterating until `manifest.stopping.target` is met
+- `--until-no-improve N`: stop after `N` consecutive cycles without frontier improvement
+- `--cycles N` with a progressive flag: treat `N` as a max-cycle cap instead of an exact count
+
+The bundled `writing` template ships with `stopping.target` commented out, so enable that block in `ralph.yaml` before using `--until-target`.
+
+```bash
+npx ralph-research run --until-target --until-no-improve 3 --json
+```
+
+## More Docs
+
+- [docs/operation-model.md](docs/operation-model.md): lifecycle, persisted state, recovery classes
+- [docs/playbook.md](docs/playbook.md): situation-to-command operator guide
+- [docs/examples.md](docs/examples.md): quickstart and manifest examples pulled from shipped templates and fixtures
+- [docs/examples-catalog.md](docs/examples-catalog.md): broader scenario catalog grounded in shipped templates and test fixtures
+- [docs/comparison.md](docs/comparison.md): why this runtime is narrower and more stateful than prompt-only loop systems
+- [docs/faq.md](docs/faq.md): common runtime, recovery, and inspection questions
+- [docs/knowledge/INDEX.md](docs/knowledge/INDEX.md): project knowledge log
 
 ## CLI
 
 ```text
+rrx "improve the holdout top-3 model"
+rrx launch "improve the holdout top-3 model"
+rrx resume latest
 rrx validate
 rrx doctor
 rrx init --template writing
 rrx demo writing
 rrx run
+rrx run --fresh
 rrx run --until-target
+rrx run --until-no-improve 3
 rrx run --until-target --until-no-improve 3
 rrx status
 rrx frontier
@@ -71,85 +170,14 @@ rrx reject <runId>
 rrx serve-mcp --stdio
 ```
 
-`rrx run --cycles N` still executes a finite loop. Progressive modes are opt-in:
-
-- `--until-target`: keep iterating until `manifest.stopping.target` is satisfied
-- `--until-no-improve N`: stop after `N` consecutive cycles without a frontier improvement
-- `--cycles N` with a progressive flag: treat `N` as a max-cycle cap instead of an exact count
-
-## Stopping Targets
-
-Use `stopping.target` when the workflow contract is "keep going until metric X reaches threshold Y":
-
-```yaml
-metrics:
-  catalog:
-    - id: exact_rate
-      kind: numeric
-      direction: maximize
-      extractor:
-        type: command
-        command: "python scripts/metric.py"
-        parser: plain_number
-
-frontier:
-  strategy: single_best
-  primaryMetric: exact_rate
-
-ratchet:
-  type: epsilon_improve
-  metric: exact_rate
-  epsilon: 0
-
-stopping:
-  target:
-    metric: exact_rate
-    op: ">="
-    value: 0.8
-```
-
-## Metric Diagnostics
-
-If a metric script can explain why a candidate was zeroed or downgraded, prefer JSON output plus `parser: json_path` so the reason survives into `run`, `decision`, and `inspect` output:
-
-```yaml
-metrics:
-  catalog:
-    - id: exact_rate
-      kind: numeric
-      direction: maximize
-      extractor:
-        type: command
-        command: "python scripts/metric.py"
-        parser: json_path
-        valuePath: $.value
-```
-
-```json
-{
-  "value": 0,
-  "metricId": "overfit_safe_exact_rate",
-  "reasons": ["all_missing_features", "normalized_order_leak"]
-}
-```
-
-When `project.workspace=git`, rrx now warns if proposer, experiment, or metric command files are dirty in the working tree, because detached candidate worktrees only see committed baseline content.
-
-## MCP
-
-The bundled MCP server currently supports stdio transport and exposes three thin tools backed by the same service layer as the CLI:
-
-- `run_research_cycle`
-- `get_research_status`
-- `get_frontier`
-
-## Design Principles
+## Core Concepts
 
-- local-first execution
-- bounded changes
-- recoverable state transitions
-- trusted signal before automation
-- inspectable accept/reject decisions
+- `Manifest`: `ralph.yaml` defines the research program
+- `Metric`: how candidate quality is measured
+- `Frontier`: the currently accepted best candidate set
+- `Ratchet`: the acceptance policy that decides whether the frontier advances
+- `Proposer`: how a bounded candidate change is generated
+- `Judge`: how qualitative outputs are compared when numeric metrics are not enough
 
 ## Development
 

package/dist/adapters/fs/json-file-research-project-defaults-store.d.ts

@@ -0,0 +1,8 @@
+import { type ResearchProjectDefaultsRecord } from "../../core/model/research-project-defaults.js";
+import type { ResearchProjectDefaultsStore } from "../../core/ports/research-project-defaults-store.js";
+export declare class JsonFileResearchProjectDefaultsStore implements ResearchProjectDefaultsStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    save(record: ResearchProjectDefaultsRecord): Promise<void>;
+    load(): Promise<ResearchProjectDefaultsRecord | null>;
+}

package/dist/adapters/fs/json-file-research-project-defaults-store.js

@@ -0,0 +1,30 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { researchProjectDefaultsRecordSchema, } from "../../core/model/research-project-defaults.js";
+import { isMissingFileError } from "../../shared/fs-errors.js";
+export class JsonFileResearchProjectDefaultsStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = resolve(filePath);
+    }
+    async save(record) {
+        const parsed = researchProjectDefaultsRecordSchema.parse(record);
+        const tempPath = `${this.filePath}.tmp-${process.pid}-${Date.now()}`;
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await writeFile(tempPath, `${JSON.stringify(parsed, null, 2)}\n`, "utf8");
+        await rename(tempPath, this.filePath);
+    }
+    async load() {
+        try {
+            const raw = await readFile(this.filePath, "utf8");
+            return researchProjectDefaultsRecordSchema.parse(JSON.parse(raw));
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=json-file-research-project-defaults-store.js.map

package/dist/adapters/fs/json-file-research-project-defaults-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file-research-project-defaults-store.js","sourceRoot":"","sources":["../../../src/adapters/fs/json-file-research-project-defaults-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EACL,mCAAmC,GAEpC,MAAM,+CAA+C,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,OAAO,oCAAoC;IAC9B,QAAQ,CAAS;IAElC,YAAmB,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAqC;QACrD,MAAM,MAAM,GAAG,mCAAmC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAErE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,OAAO,mCAAmC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/fs/json-file-research-session-repository.d.ts

@@ -0,0 +1,24 @@
+import { type ResearchSessionMetadata, type ResearchSessionRecord } from "../../core/model/research-session.js";
+import type { PersistedResearchSessionBundle, ResearchSessionQuery, ResearchSessionRepository } from "../../core/ports/research-session-repository.js";
+export declare class JsonFileResearchSessionRepository implements ResearchSessionRepository {
+    private readonly sessionsRoot;
+    constructor(sessionsRoot: string);
+    saveSession(record: ResearchSessionRecord): Promise<void>;
+    loadSession(sessionId: string): Promise<ResearchSessionRecord | null>;
+    deleteSession(sessionId: string): Promise<void>;
+    loadSessionMetadata(sessionId: string): Promise<ResearchSessionMetadata | null>;
+    loadPersistedSession(sessionId: string): Promise<PersistedResearchSessionBundle | null>;
+    querySessions(query?: ResearchSessionQuery): Promise<ResearchSessionRecord[]>;
+    querySessionMetadata(query?: ResearchSessionQuery): Promise<ResearchSessionMetadata[]>;
+    private loadAllSessions;
+    private loadAllSessionMetadata;
+    private listSessionDirectories;
+    private getPath;
+    private getLifecyclePath;
+    private getSessionsRoot;
+    private readSessionRecord;
+    private readSessionMetadata;
+    private readLifecycleRecord;
+    private assertDirectoryMatchesSession;
+    private assertLifecycleMatchesSession;
+}

package/dist/adapters/fs/json-file-research-session-repository.js

@@ -0,0 +1,199 @@
+import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { parseCodexCliSessionLifecycleRecord, } from "../../core/model/codex-cli-session-lifecycle.js";
+import { parsePersistedResearchSessionMetadata, researchSessionRecordSchema, } from "../../core/model/research-session.js";
+import { isMissingFileError } from "../../shared/fs-errors.js";
+export class JsonFileResearchSessionRepository {
+    sessionsRoot;
+    constructor(sessionsRoot) {
+        this.sessionsRoot = resolve(sessionsRoot);
+    }
+    async saveSession(record) {
+        const parsed = researchSessionRecordSchema.parse(record);
+        const path = this.getPath(parsed.sessionId);
+        const tempPath = `${path}.tmp-${process.pid}-${Date.now()}`;
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(tempPath, `${JSON.stringify(parsed, null, 2)}\n`, "utf8");
+        await rename(tempPath, path);
+    }
+    async loadSession(sessionId) {
+        return this.readSessionRecord(sessionId);
+    }
+    async deleteSession(sessionId) {
+        const path = join(this.getSessionsRoot(), sessionId);
+        await rm(path, { recursive: true, force: true });
+    }
+    async loadSessionMetadata(sessionId) {
+        return this.readSessionMetadata(sessionId);
+    }
+    async loadPersistedSession(sessionId) {
+        const session = await this.readSessionRecord(sessionId);
+        if (!session) {
+            return null;
+        }
+        const lifecyclePath = this.getLifecyclePath(sessionId);
+        const lifecycle = await this.readLifecycleRecord(sessionId);
+        return {
+            session,
+            lifecycle,
+            codexSessionReference: lifecycle
+                ? {
+                    codexSessionId: lifecycle.identity.codexSessionId,
+                    lifecyclePath,
+                }
+                : null,
+        };
+    }
+    async querySessions(query = {}) {
+        const records = await this.loadAllSessions();
+        const filtered = records.filter((record) => {
+            if (query.workingDirectory && record.workingDirectory !== query.workingDirectory) {
+                return false;
+            }
+            if (query.statuses && !query.statuses.includes(record.status)) {
+                return false;
+            }
+            return true;
+        });
+        if (query.limit === undefined) {
+            return filtered;
+        }
+        return filtered.slice(0, query.limit);
+    }
+    async querySessionMetadata(query = {}) {
+        const records = await this.loadAllSessionMetadata();
+        const filtered = records.filter((record) => {
+            if (query.workingDirectory && record.workingDirectory !== query.workingDirectory) {
+                return false;
+            }
+            if (query.statuses && !query.statuses.includes(record.status)) {
+                return false;
+            }
+            return true;
+        });
+        if (query.limit === undefined) {
+            return filtered;
+        }
+        return filtered.slice(0, query.limit);
+    }
+    async loadAllSessions() {
+        const directories = await this.listSessionDirectories();
+        const records = [];
+        for (const directoryName of directories) {
+            const record = await this.readSessionRecord(directoryName);
+            if (!record) {
+                continue;
+            }
+            this.assertDirectoryMatchesSession(record, directoryName);
+            records.push(record);
+        }
+        return records.sort((left, right) => left.sessionId.localeCompare(right.sessionId));
+    }
+    async loadAllSessionMetadata() {
+        const directories = await this.listSessionDirectories();
+        const records = [];
+        for (const directoryName of directories) {
+            const record = await this.readSessionMetadata(directoryName);
+            if (!record) {
+                continue;
+            }
+            this.assertDirectoryMatchesSession(record, directoryName);
+            records.push(record);
+        }
+        return records.sort((left, right) => left.sessionId.localeCompare(right.sessionId));
+    }
+    async listSessionDirectories() {
+        try {
+            const entries = await readdir(this.getSessionsRoot(), { withFileTypes: true });
+            const directories = [];
+            for (const entry of entries) {
+                if (!entry.isDirectory()) {
+                    continue;
+                }
+                const path = join(this.getSessionsRoot(), entry.name, "session.json");
+                const fileStats = await stat(path).catch((error) => {
+                    if (isMissingFileError(error)) {
+                        return null;
+                    }
+                    throw error;
+                });
+                if (!fileStats?.isFile()) {
+                    continue;
+                }
+                directories.push(entry.name);
+            }
+            return directories.sort((left, right) => left.localeCompare(right));
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    getPath(sessionId) {
+        return join(this.getSessionsRoot(), sessionId, "session.json");
+    }
+    getLifecyclePath(sessionId) {
+        return join(this.getSessionsRoot(), sessionId, "codex-session.json");
+    }
+    getSessionsRoot() {
+        return this.sessionsRoot;
+    }
+    async readSessionRecord(sessionId) {
+        const path = this.getPath(sessionId);
+        try {
+            const raw = await readFile(path, "utf8");
+            const record = researchSessionRecordSchema.parse(JSON.parse(raw));
+            this.assertDirectoryMatchesSession(record, sessionId);
+            return record;
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async readSessionMetadata(sessionId) {
+        const path = this.getPath(sessionId);
+        try {
+            const raw = await readFile(path, "utf8");
+            const record = parsePersistedResearchSessionMetadata(JSON.parse(raw));
+            this.assertDirectoryMatchesSession(record, sessionId);
+            return record;
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async readLifecycleRecord(sessionId) {
+        const path = this.getLifecyclePath(sessionId);
+        try {
+            const raw = await readFile(path, "utf8");
+            const record = parseCodexCliSessionLifecycleRecord(raw);
+            this.assertLifecycleMatchesSession(record, sessionId);
+            return record;
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    assertDirectoryMatchesSession(record, directoryName) {
+        if (record.sessionId !== directoryName) {
+            throw new Error(`Research session directory name "${directoryName}" must match record sessionId "${record.sessionId}"`);
+        }
+    }
+    assertLifecycleMatchesSession(record, directoryName) {
+        if (record.sessionId !== directoryName) {
+            throw new Error(`Research session directory name "${directoryName}" must match lifecycle sessionId "${record.sessionId}"`);
+        }
+    }
+}
+//# sourceMappingURL=json-file-research-session-repository.js.map

package/dist/adapters/fs/json-file-research-session-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file-research-session-repository.js","sourceRoot":"","sources":["../../../src/adapters/fs/json-file-research-session-repository.ts"],"names":[],"mappings":"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"}

package/dist/adapters/fs/lockfile.d.ts

@@ -21,6 +21,12 @@ export interface LockHandle {
     path: string;
     metadata: LockfileMetadata;
 }
+export interface LockRuntimeState {
+    metadata: LockfileMetadata;
+    processAlive: boolean;
+    stale: boolean;
+    heartbeatAgeMs: number;
+}
 export declare class LockAcquisitionError extends Error {
     readonly metadata: LockfileMetadata | undefined;
     readonly heartbeatAgeMs: number | undefined;
@@ -33,5 +39,6 @@ export declare function acquireLock(path: string, options?: AcquireLockOptions):
 export declare function renewLock(path: string, token: string): Promise<LockfileMetadata>;
 export declare function releaseLock(path: string, token?: string): Promise<void>;
 export declare function isStaleLock(path: string): Promise<boolean>;
+export declare function inspectLock(path: string): Promise<LockRuntimeState | null>;
 export declare function readLockMetadata(path: string): Promise<LockfileMetadata | null>;
 export {};

package/dist/adapters/fs/lockfile.js

@@ -107,15 +107,25 @@ export async function releaseLock(path, token) {
     await rm(resolvedPath, { force: true });
 }
 export async function isStaleLock(path) {
-    const metadata = await readLockMetadata(path);
-    if (!metadata) {
+    const runtime = await inspectLock(path);
+    if (!runtime) {
         return false;
     }
-    const ageMs = Date.now() - Date.parse(metadata.updatedAt);
-    if (ageMs > metadata.ttlMs + metadata.graceMs) {
-        return true;
+    return runtime.stale;
+}
+export async function inspectLock(path) {
+    const metadata = await readLockMetadata(path);
+    if (!metadata) {
+        return null;
     }
-    return !isProcessAlive(metadata.pid);
+    const heartbeatAgeMs = Date.now() - Date.parse(metadata.updatedAt);
+    const processAlive = isProcessAlive(metadata.pid);
+    return {
+        metadata,
+        processAlive,
+        stale: heartbeatAgeMs > metadata.ttlMs + metadata.graceMs || !processAlive,
+        heartbeatAgeMs,
+    };
 }
 export async function readLockMetadata(path) {
     const resolvedPath = resolve(path);

package/dist/adapters/fs/lockfile.js.map

@@ -1 +1 @@
-{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../../src/adapters/fs/lockfile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../../src/adapters/fs/lockfile.ts"],"names":[],"mappings":"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"}