@sublang/slc 0.1.0 → 0.3.0

package/README.md

@@ -3,51 +3,73 @@
 
 # slc
 
+[![npm version](https://img.shields.io/npm/v/@sublang/slc)](https://www.npmjs.com/package/@sublang/slc)
+[![Node.js](https://img.shields.io/node/v/@sublang/slc)](https://nodejs.org/)
 [![CI](https://github.com/sublang-ai/slc/actions/workflows/ci.yml/badge.svg)](https://github.com/sublang-ai/slc/actions/workflows/ci.yml)
 
-_The SubLang Compiler: pipelines whose phases are written in prose and
-carried out by coding agents._
-
-`slc` runs compilation pipelines in which each phase is defined by a
-plain markdown file and executed by an AI coding agent (reached through
-[cligent](https://github.com/sublang-ai/cligent)). Adding a phase means
-writing a definition, never changing the compiler: `slc` itself performs
-only the generic mechanics — chaining phases by their declared formats,
-validating names and locations, and placing artifacts.
-
-```bash
-slc <pipeline>[.<phase>] <source> [-o <target>]
-```
-
-Its flagship pipeline is `playbook`, the compilation service behind
-[playbook](https://github.com/sublang-ai/playbook): it turns a workflow
-written in prose into GEARS spec items (one normative item per state
-behavior) and then into an inspectable XState v5 state machine,
-optionally linked into the runnable runtime module playbook's hosts
-execute.
-
-Distinctively, `slc` is self-hosting. The reserved `slc` meta-pipeline
-compiles phase definitions themselves into runnable playbook artifacts:
-the bundled phases ship compiled, reviewed, and sha256-pinned under
-[`pipelines/playbook/`](pipelines/playbook). A pinned phase runs exactly
-its reviewed compiled artifact, verified by hash — a missing or stale
-pin fails with a diagnostic instead of silently reinterpreting — while
-unpinned phases fall back to the agent reading the definition directly.
+_The SubLang Compiler: describe a workflow in a paragraph of prose, get a
+deterministic multi-agent program you can inspect, verify, and run._
+
+You write what should happen — in English or Chinese, no DSL, no
+orchestration framework. `slc` compiles that paragraph into a spec, a
+state machine, and a runnable **playbook** that drives AI coding agents
+through it. Why compile prose instead of prompting with it:
+
+- **Deterministic where it matters.** Who acts, in what order, when to
+  stop — the control flow becomes an inspectable
+  [XState](https://xstate.js.org) machine, not prompt improvisation.
+  LLM judgment is confined to the work *inside* each state.
+- **Auditable at every stage.** The intermediates are first-class files
+  you can read and edit: the normalized text, one testable "shall" item
+  per behavior (in the GEARS spec grammar the SubLang stack shares), and
+  the state machine itself. The compiler also emits verification tests
+  binding its output to the source spec.
+- **Cheaper and safer by optimization.** Steps that need no judgment are
+  rewritten at compile time into plain shell commands — no LLM call, no
+  hallucination, verifiable before anything runs.
+- **Your agents, per role.** Compilation and execution run through the
+  agent CLIs you already use — Claude Code, Codex, Gemini, OpenCode —
+  selectable per role.
+
+The flagship pipeline is `playbook` (the name of both the pipeline and
+the sibling [playbook](https://github.com/sublang-ai/playbook) project
+that executes its output): prose → GEARS spec items → XState machine →
+a linked module the `playbook` CLI runs.
+
+## See it run
+
+The [demo](demo/README.md) compiles a one-paragraph description into a
+two-agent code-review loop, then lets it loose on a buggy C file: the
+coder and reviewer commit, review, and debate inside a real Git
+repository until the review comes back clean. Precompiled reference
+artifacts are included, so you can watch a run — or just read every
+compile stage — without waiting on a compile.
 
 ## Install
 
-Install the compiler and Playbook runtime in the project that will contain the
-generated artifacts:
-
 ```bash
-npm install --save-dev @sublang/slc @sublang/playbook
-npx slc --version
+npm install -g @sublang/slc @sublang/playbook
+npm install -g @anthropic-ai/claude-agent-sdk @openai/codex-sdk
+slc --version
 ```
 
-The project-local Playbook install is required: generated thin runtime modules
-import `@sublang/playbook/xstate-runtime` and their FSMs import `xstate` from
-the artifact's project. A global-only install does not provide Node module
-resolution for artifacts written elsewhere.
+The second line supplies the agent SDKs for the default Claude and Codex
+lineup. Playbook 4 installs none itself — which versions work is
+`@sublang/cligent`'s to enforce at load — so name the SDKs your own
+configuration needs. If one is missing, the compile stops before any
+agent call and names the package to install; if one is too old, it
+names the installed and required versions along with the exact version
+to install.
+
+Compiled artifacts import the Playbook engine from their own directory;
+when that import does not resolve, `playbook run` (3.1+) links its own
+engine beside the artifact and says so (`--no-provision` opts out).
+Working inside an npm project instead? Install the same set there — the
+compiler, the engine, and the SDKs your lineup uses — and prefix the
+commands with `npx`. A project's own install is always authoritative,
+and a globally installed SDK is invisible to a project's nested
+`@sublang/cligent`, so the SDKs belong in the same tree
+([RELEASE-11](specs/dev/release.md#release-11) has the full rules).
 
 Requirements:
 
@@ -64,32 +86,50 @@ Requirements:
 
 ## Quick start
 
-From the repo root — its [`slc.config.yaml`](slc.config.yaml) routes the
-`playbook` pipeline to the bundled copy under `pipelines/` — compile a
-prose workflow:
+In any directory, write a prose workflow as a `.md` or plain `.txt`
+file — [`demo/workflow.txt`](demo/workflow.txt) is a complete
+one-paragraph example — and compile it:
 
 ```bash
-npx slc playbook my-workflow.md
+slc playbook my-workflow.md
 ```
 
-This writes `my-workflow.playbook/` — the intermediates
-(`my-workflow.gears.md`, the XState machine `my-workflow.fsm.ts`), the
-runnable runtime module, and its verification tests — plus the
-`my-workflow.ts` entry that `playbook run` consumes, all in your
-working directory. A raw input (any extension the entry phase doesn't
-declare, e.g. `.txt`) is normalized first, and the pipeline's
-optimization pass runs by default (`--no-optimize` skips it). For what
-a prose workflow looks like, see playbook's canonical worked example,
-[`code.md`](https://github.com/sublang-ai/playbook/blob/main/reference/sdlc/code.md).
-Intermediates are first-class: edit one and re-run a single
-phase (`npx slc playbook.gears2fsm …`) and it lands in the same place.
-`npx slc --help` shows all invocation forms. The repo config pins
-`agent: claude-code` — set `SLC_AGENT` (or edit the config) to compile
-with another agent CLI.
-
-Success prints the written artifact paths and exits 0; a failure prints
-diagnostics to stderr — naming the failing phase when one is at fault —
-and exits non-zero.
+`slc` finds the `playbook` pipeline inside its own `@sublang/playbook`
+dependency, so it compiles in any directory — no clone, no project
+setup. Compilation drives your configured coding agent — the first run
+seeds `~/.config/slc/config.yaml` with `agent: claude-code`; set
+`SLC_AGENT` (or edit that file) to use another agent CLI. Expect it to
+take a while: duration is agent- and workload-dependent, and measured
+compiles of a five-line workflow have run from tens of minutes to more
+than two hours, with the first intermediate typically landing within
+about five minutes. Plain-text input (`.txt`) works too; it is
+normalized first. The pipeline's optimization pass, which rewrites
+judgment-free steps into plain script, runs by default
+(`--no-optimize` skips it).
+
+Artifacts land in your working directory: `my-workflow.playbook/` holds
+the intermediates — `my-workflow.gears.md`, the XState machine
+`my-workflow.fsm.ts`, the linked runtime module, and its verification
+tests — and `my-workflow.ts` is the runnable entry. Run it:
+
+```bash
+playbook run ./my-workflow.ts "<your task>"
+```
+
+Intermediates are first-class: edit one and re-run a single phase
+(`slc playbook.gears2fsm …`) and it lands in the same place.
+`slc --help` shows all invocation forms.
+
+While a compile runs, `slc` reports progress on stderr: each phase as it
+starts, each artifact as it lands with the elapsed time, the compiled
+runtime's own state transitions, and a heartbeat so the terminal is
+never silent for more than 30 seconds. An agent call that goes quiet for
+`stallTimeout` seconds (default 600, `0` disables) is aborted and
+reported as a failed phase rather than hanging indefinitely.
+
+Success prints the written artifact paths to stdout and exits 0; a
+failure prints diagnostics to stderr — naming the failing phase when one
+is at fault — and exits non-zero.
 
 ## Configuration
 
@@ -104,30 +144,16 @@ and `pipelinePath` to the working directory.
 # slc.config.yaml
 agent: claude-code # claude-code | codex | gemini | opencode
 model: claude-opus-4-8 # optional; omit to use the agent CLI's default
+stallTimeout: 600 # seconds of agent silence before a stalled call fails
 pipelinePath: # search roots for <pipeline> references; defaults to the cwd
   - ./pipelines
 ```
 
-Discovery order (first match wins):
-
-1. `slc.config.yaml` in the working directory.
-2. `${XDG_CONFIG_HOME:-~/.config}/slc/config.yaml`.
-
-`slc --config <path>` loads a specific file and disables discovery; a `--config`
-path that does not exist is an error, whereas a discovery miss simply falls
-through to the environment and defaults. Unknown keys, malformed YAML, and
-wrong-typed values are rejected.
-
-The matching environment variables, which override the file per key, are:
-
-| Variable | Overrides | Meaning |
-| --- | --- | --- |
-| `SLC_AGENT` | `agent` | agent CLI: `claude-code`, `codex`, `gemini`, `opencode` |
-| `SLC_MODEL` | `model` | optional model for the agent CLI |
-| `SLC_PIPELINE_PATH` | `pipelinePath` | OS path-list of search roots (default: cwd) |
-
-Credentials are read by the agent CLI from the inherited process environment.
-Run `slc --help` for the full invocation and configuration summary.
+A `slc.config.yaml` in the working directory wins over the user config;
+`SLC_AGENT`, `SLC_MODEL`, `SLC_STALL_TIMEOUT`, and `SLC_PIPELINE_PATH`
+override either per key. Discovery order, `--config`, and validation
+rules live in the [CLI spec](specs/user/cli.md); `slc --help` prints the
+summary.
 
 ## How pipelines work
 
@@ -135,21 +161,23 @@ A pipeline is a directory of phase definitions named
 `<source-format>2<target-format>.md`, each declaring its formats in a
 `## Formats` table, plus an optional `link.md` defining the terminal
 link phase. `slc` infers phase order by chaining formats — no
-manifest — and refuses incomplete, branching, or cyclic chains. The
-bundled `playbook` pipeline chains `text2gears` and `gears2fsm`, with
-`link` emitting the runnable runtime.
+manifest — and refuses incomplete, branching, or cyclic chains. Adding
+a phase means writing a definition, never changing the compiler: `slc`
+itself performs only the generic mechanics of chaining, validation, and
+artifact placement. The bundled `playbook` pipeline chains `text2gears`
+and `gears2fsm`, with `link` emitting the runnable runtime.
 
 Every phase runs through a coding agent, one of two ways:
 
 - **Interpreted** — the configured agent reads the definition and
-  performs it.
-- **Compiled** — the phase's own compiled playbook artifact (produced by
-  the `slc` meta-pipeline, reviewed, and pinned in
-  [`slc.pins.json`](pipelines/playbook/slc.pins.json)) drives the agent
-  through audited state-machine steps. Pins bind each artifact by
-  sha256 to every input that shaped it — definition, artifact bundle,
-  and runtime dependencies — so which artifact executes is reproducible,
-  and pinned runs fail closed on drift.
+  performs it. This is how an npm-installed `slc` runs the `playbook`
+  pipeline, using the definitions shipped inside `@sublang/playbook`.
+- **Compiled** — the phase's own compiled playbook artifact drives the
+  agent through audited state-machine steps. This repository's checkout
+  runs its bundled phases this way: `slc` is self-hosting, its phase
+  definitions compiled, reviewed, and sha256-pinned under
+  [`pipelines/playbook/`](pipelines/playbook), failing closed on drift
+  ([self-hosting spec](specs/user/self-hosting.md)).
 
 Specs are the source of truth — start at the
 [spec map](specs/map.md).
@@ -163,8 +191,9 @@ Specs are the source of truth — start at the
   coding-agent SDK `slc` executes phases through.
 - [playbook](https://github.com/sublang-ai/playbook) — authors the
   `playbook` pipeline's phase specs and runs the compiled output.
-- [spex](https://github.com/sublang-ai/spex) — the desktop app that
-  invokes `slc` for its in-app playbook compile flow.
+- [spex](https://github.com/sublang-ai/spex) — the spec tool that owns
+  the shared GEARS grammar and invokes `slc` for its in-app playbook
+  compile flow.
 
 ## Develop
 
@@ -175,8 +204,11 @@ npm test
 npm run lint
 ```
 
-CI additionally re-verifies the compiled meta-phase bundles and checks
-that pin regeneration is byte-identical to the committed index.
+A checkout's own [`slc.config.yaml`](slc.config.yaml) routes the
+`playbook` pipeline to the bundled copy under `pipelines/`, so repo
+compiles exercise the pinned artifacts. CI additionally re-verifies the
+compiled meta-phase bundles and checks that pin regeneration is
+byte-identical to the committed index.
 
 ## Contributing
 

package/dist/app.d.ts

@@ -1,5 +1,6 @@
 import { createConfiguredCompiledFactory, createConfiguredExecutor, type AgentSelection } from './config.js';
 import { type FileConfig } from './config-file.js';
+import { type ProgressSink } from './progress.js';
 import { type SlcDeps } from './runner.js';
 /** The program name. */
 export declare const name = "slc";
@@ -14,6 +15,8 @@ export type DepsBuilder = (io: {
     configPath?: string;
     /** Sink for host notes such as first-run config seeding (DR-015, CLI-30). */
     note?: (text: string) => void;
+    /** The run's progress sink, rendered to stderr by the bin (DR-019, CLI-35). */
+    progress?: ProgressSink;
 }) => SlcDeps | Promise<SlcDeps>;
 /** Injectable IO and configuration for {@link run}; all fields default to the process. */
 export interface RunOptions {
@@ -46,19 +49,27 @@ export type CompiledFactoryBuilder = typeof createConfiguredCompiledFactory;
  * @throws {import('./config.js').ConfigError} when neither source supplies an
  *   agent, or the resolved agent is unsupported (CLI-12).
  */
-export declare function buildSlcDeps({ env, cwd, signal, configPath, note }: Parameters<DepsBuilder>[0], createExecutor?: ExecutorFactory, createCompiled?: CompiledFactoryBuilder): Promise<SlcDeps>;
+export declare function buildSlcDeps({ env, cwd, signal, configPath, note, progress }: Parameters<DepsBuilder>[0], createExecutor?: ExecutorFactory, createCompiled?: CompiledFactoryBuilder): Promise<SlcDeps>;
 /** The cligent-invocation selection after merging environment over file (DR-006). */
 export interface RunConfig {
     selection: AgentSelection;
     /** Search-root source: an `SLC_PIPELINE_PATH` string, the file's sequence, or undefined. */
     pipelinePath: string | string[] | undefined;
+    /** Agent-stall watchdog window in milliseconds; `0` disables (DR-019, CLI-34). */
+    stallTimeoutMs: number;
 }
+/** Default agent-stall watchdog window in seconds (DR-019, CLI-34). */
+export declare const DEFAULT_STALL_TIMEOUT_SECONDS = 600;
 /**
  * Merges the environment over config-file values per key (DR-006, CLI-20): for
  * each key a non-blank environment variable wins, otherwise the file value,
  * otherwise the built-in default. The agent and model go through
  * {@link resolveAgentSelection} so the supported-agent check stays single-sourced
- * (CLI-7, CLI-12).
+ * (CLI-7, CLI-12); the stall timeout defaults to
+ * {@link DEFAULT_STALL_TIMEOUT_SECONDS} with `0` disabling the watchdog
+ * (DR-019, CLI-34).
+ *
+ * @throws {Error} when `SLC_STALL_TIMEOUT` is not a non-negative number.
  */
 export declare function resolveRunConfig(env: Record<string, string | undefined>, file: FileConfig): RunConfig;
 /** Usage text naming the documented invocation forms and configuration (CLI-2). */

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EAExB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnE,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAUnD,wBAAwB;AACxB,eAAO,MAAM,IAAI,QAAQ,CAAC;AAE1B,sCAAsC;AACtC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,EAAE,EAAE;IAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEjC,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,yDAAyD;IACzD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,OAAO,wBAAwB,CAAC;AAE9D,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,OAAO,+BAA+B,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAKlE,cAAc,GAAE,eAA0C,EAC1D,cAAc,GAAE,sBAAwD,GACvE,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,4FAA4F;IAC5F,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,IAAI,EAAE,UAAU,GACf,SAAS,CAQX;AAOD,mFAAmF;AACnF,wBAAgB,SAAS,IAAI,MAAM,CAoClC;AA6BD;;;;GAIG;AACH,wBAAsB,GAAG,CACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC9D,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAY/C"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/app.js

@@ -15,7 +15,8 @@
  */
 import { createRequire } from 'node:module';
 import { createConfiguredCompiledFactory, createConfiguredExecutor, resolveAgentSelection, } from './config.js';
-import { loadConfigFile } from './config-file.js';
+import { loadConfigFile, MAX_STALL_TIMEOUT_SECONDS, } from './config-file.js';
+import { createProgressReporter } from './progress.js';
 import { createPipelineResolver, pipelineSearchRoots, withReservedPipelines, } from './resolver.js';
 import { runSlc } from './runner.js';
 const manifest = createRequire(import.meta.url)('../package.json');
@@ -45,7 +46,7 @@ export function version() {
  * @throws {import('./config.js').ConfigError} when neither source supplies an
  *   agent, or the resolved agent is unsupported (CLI-12).
  */
-export async function buildSlcDeps({ env, cwd, signal, configPath, note }, 
+export async function buildSlcDeps({ env, cwd, signal, configPath, note, progress }, 
 // Injectable so a test can capture the executor options — notably the
 // non-interactive write permission below — without constructing a real
 // adapter, the same seam pattern as `createConfiguredExecutor`'s
@@ -58,22 +59,40 @@ createExecutor = createConfiguredExecutor, createCompiled = createConfiguredComp
         // First-run seeding (DR-015): name the created user config on stderr.
         onSeed: (path) => note?.(`slc: seeded ${path} (agent: claude-code)\n`),
     });
-    const { selection, pipelinePath } = resolveRunConfig(env, file.config);
+    const { selection, pipelinePath, stallTimeoutMs } = resolveRunConfig(env, file.config);
     const resolver = withReservedPipelines(createPipelineResolver(pipelineSearchRoots(pipelinePath, cwd)));
     // Auto-accept the agents' file operations so a non-interactive `slc` run can
     // write its target artifact; the DR-003 generic checks still guard the
-    // protected inputs (DR-004).
-    const agentOpts = { cwd, permissions: { mode: 'auto' } };
+    // protected inputs (DR-004). The stall watchdog rides every constructed
+    // transport (DR-019, CLI-35).
+    const agentOpts = {
+        cwd,
+        permissions: { mode: 'auto' },
+        stallTimeoutMs,
+    };
     const executor = createExecutor(selection, agentOpts);
-    const compiled = createCompiled(selection, agentOpts);
-    return { resolver, executor, compiled, cwd, signal };
+    // Compiled-runtime status streams to the same reporter as phase progress
+    // (PHEXEC-25, CLI-32).
+    const compiled = createCompiled(selection, {
+        ...agentOpts,
+        onStatus: progress === undefined
+            ? undefined
+            : (line) => progress({ kind: 'status', text: line }),
+    });
+    return { resolver, executor, compiled, cwd, signal, progress };
 }
+/** Default agent-stall watchdog window in seconds (DR-019, CLI-34). */
+export const DEFAULT_STALL_TIMEOUT_SECONDS = 600;
 /**
  * Merges the environment over config-file values per key (DR-006, CLI-20): for
  * each key a non-blank environment variable wins, otherwise the file value,
  * otherwise the built-in default. The agent and model go through
  * {@link resolveAgentSelection} so the supported-agent check stays single-sourced
- * (CLI-7, CLI-12).
+ * (CLI-7, CLI-12); the stall timeout defaults to
+ * {@link DEFAULT_STALL_TIMEOUT_SECONDS} with `0` disabling the watchdog
+ * (DR-019, CLI-34).
+ *
+ * @throws {Error} when `SLC_STALL_TIMEOUT` is not a non-negative number.
  */
 export function resolveRunConfig(env, file) {
     const selection = resolveAgentSelection({
@@ -82,7 +101,24 @@ export function resolveRunConfig(env, file) {
         SLC_EFFORT: nonBlank(env.SLC_EFFORT) ?? file.effort,
     });
     const pipelinePath = nonBlank(env.SLC_PIPELINE_PATH) ?? file.pipelinePath;
-    return { selection, pipelinePath };
+    const stallSeconds = parseStallTimeout(nonBlank(env.SLC_STALL_TIMEOUT)) ??
+        file.stallTimeout ??
+        DEFAULT_STALL_TIMEOUT_SECONDS;
+    return { selection, pipelinePath, stallTimeoutMs: stallSeconds * 1000 };
+}
+function parseStallTimeout(value) {
+    if (value === undefined)
+        return undefined;
+    const seconds = Number(value);
+    if (!Number.isFinite(seconds) || seconds < 0) {
+        throw new Error(`SLC_STALL_TIMEOUT "${value}" must be a non-negative number of seconds (0 disables the stall watchdog)`);
+    }
+    // Beyond the timer range Node clamps the delay to 1 ms, which would abort
+    // every agent call at once — refuse rather than invert the watchdog.
+    if (seconds > MAX_STALL_TIMEOUT_SECONDS) {
+        throw new Error(`SLC_STALL_TIMEOUT "${value}" must be at most ${MAX_STALL_TIMEOUT_SECONDS} seconds (0 disables the stall watchdog)`);
+    }
+    return seconds;
 }
 /** Returns `value` when set and not all-whitespace, else `undefined` (DR-006). */
 function nonBlank(value) {
@@ -117,12 +153,14 @@ export function usageText() {
         '  environment variable below:',
         '    ./slc.config.yaml',
         '    ${XDG_CONFIG_HOME:-~/.config}/slc/config.yaml',
-        '  Keys: agent, model, effort, pipelinePath.',
+        '  Keys: agent, model, effort, pipelinePath, stallTimeout.',
         '',
         '  SLC_AGENT          agent CLI: claude-code | codex | gemini | opencode',
         '  SLC_MODEL          optional model for the agent CLI',
         '  SLC_EFFORT         optional adapter-scoped reasoning effort (e.g. xhigh)',
         '  SLC_PIPELINE_PATH  search roots for <pipeline> references (default: cwd)',
+        '  SLC_STALL_TIMEOUT  seconds of agent inactivity before a stalled call',
+        '                     fails the run (default: 600; 0 disables)',
         '',
     ].join('\n');
 }
@@ -170,6 +208,9 @@ export async function run(argv, options = {}) {
     const env = options.env ?? process.env;
     const cwd = options.cwd ?? process.cwd();
     const signal = options.signal ?? new AbortController().signal;
+    // In-run progress renders on stderr as it happens, with the silence-bounded
+    // heartbeat (DR-019, CLI-32, CLI-33, CLI-35).
+    const reporter = createProgressReporter(stderr);
     let deps;
     let rest;
     try {
@@ -183,15 +224,23 @@ export async function run(argv, options = {}) {
             signal,
             configPath: extracted.configPath,
             note: stderr,
+            progress: reporter.sink,
         });
     }
     catch (error) {
         // Configuration refusals — a bad `--config`, an invalid config file
         // (CLI-21), or an unset/unsupported agent (CLI-12) — fail the run.
+        reporter.dispose();
         stderr(`${name}: ${messageOf(error)}\n`);
         return 1;
     }
-    const result = await runSlc(rest, deps);
+    let result;
+    try {
+        result = await runSlc(rest, deps);
+    }
+    finally {
+        reporter.dispose();
+    }
     if (result.ok) {
         if (result.outputs.length > 0)
             stdout(`${result.outputs.join('\n')}\n`);

package/dist/app.js.map

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

package/dist/cligent-agent.d.ts

@@ -1,5 +1,16 @@
 import type { AgentAdapter, PermissionPolicy } from '@sublang/cligent';
 import type { AgentClient } from './interpreter.js';
+/** Timer seams for the stall watchdog; injected in tests. */
+export interface WatchdogTimers {
+    setTimeout(callback: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+/**
+ * The production watchdog timers. Exported so a test can assert the ref
+ * behavior the watchdog's correctness depends on, which an injected fake
+ * would bypass.
+ */
+export declare const defaultWatchdogTimers: WatchdogTimers;
 /** Wraps a Cligent adapter as an {@link AgentClient} for the interpreter. */
 export declare function createCligentAgent(opts: {
     adapter: AgentAdapter;
@@ -7,5 +18,13 @@ export declare function createCligentAgent(opts: {
     permissions?: PermissionPolicy;
     /** Adapter-scoped reasoning effort, validated by the configuration layer. */
     effort?: string;
+    /**
+     * Milliseconds of adapter-event inactivity after which the in-flight call is
+     * aborted and reported as an error (DR-019, PHEXEC-36). Zero or absent
+     * disables the watchdog.
+     */
+    stallTimeoutMs?: number;
+    /** Watchdog timer seams; defaults to real timers. Injected in tests. */
+    watchdogTimers?: WatchdogTimers;
 }): AgentClient;
 //# sourceMappingURL=cligent-agent.d.ts.map

package/dist/cligent-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cligent-agent.d.ts","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAEpE,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CAwDd"}
+{"version":3,"file":"cligent-agent.d.ts","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAGpE,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,cASnC,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,WAAW,CAiFd"}