@bluewombat/runtime 0.1.2 → 0.3.0

package/README.md

@@ -55,6 +55,7 @@ package's README — Host does not grow a `--repo` flag for it.
 | `mason run`    | Drain the FeatureManager, run Conductor, report                                        |
 | `mason watch`  | Snapshot the ledger and follow the journal. Ctrl-C leaves the worker running           |
 | `mason status` | Snapshot the ledger, then exit. `--json` for scripts                                   |
+| `mason log`    | Replay the journal, with the reason a phase stopped. `--problems` for just those       |
 | `mason init`   | Set this directory up: asks, writes the config and the Builder stub, then runs `setup` |
 | `mason setup`  | Prepare the tracker. A plan by default; `--apply` writes. Exit 1 on a blocked step     |
 | `mason doctor` | Check the config, the slots, and the manager. Exit 1 on any failure                    |
@@ -83,6 +84,21 @@ of the current step (`submitted` included). It does not talk to the tracker, and
 it cannot `ready` or claim. `status` is the same snapshot without the
 follow. `--json` prints that snapshot as JSON.
 
+When a run only printed `unavailable:<key>`, the reason is already in the
+journal and `log` is how you read it:
+
+```bash
+mason log --problems
+```
+
+`--all` keeps the idle polls. `--tail N` limits the text film (`0` shows every
+kept line). `--json` prints every kept line; with `--tail`, a truncated reply
+names how many were kept and how many are shown. The closing tally counts each
+distinct failure. A pause with no planner exit code is counted apart from a
+non-zero exit. If a slot was started with `--transcript-dir`, the newest
+transcript files are named underneath, with the agent exit and duration read
+from the start of each file.
+
 To abandon a Feature the tracker can no longer mention (a deleted issue, a
 manager with no `probe`), stop `run` if it holds the ledger lock, then:
 
@@ -95,31 +111,44 @@ crash — the ledger is. The file can grow; there is no rotation yet.
 
 ## Config
 
-`mason.config.json`, found by walking up from the working directory. `--config
+`mason.config.yaml`, found by walking up from the working directory. `--config
 FILE` names another one. Relative paths resolve against the file; relative
 flag paths resolve against the working directory. Flags override the file, and
 `--manager-option` overrides one manager option without dropping the others.
-
-```json
-{
-  "manager": "@bluewombat/manager-fake",
-  "managerOptions": { "source": "./.mason/source", "target": "./.mason/threads" },
-  "workLine": { "stable": "./work-line-stable", "isolation": "@bluewombat/isolation-copy" },
-  "planner": {
-    "cmd": ["node", "./node_modules/@bluewombat/slots/planners/one-subtask.mjs"],
-    "timeoutMs": 600000
-  },
-  "builder": {
-    "producer": { "cmd": ["node", "./mason-builder.mjs"], "timeoutMs": 600000 },
-    "repair": { "cmd": ["node", "./mason-repair.mjs"], "timeoutMs": 600000 },
-    "maxAttempts": 3,
-    "gates": { "defaultTimeoutMs": 120000, "gates": [] }
-  },
-  "assembly": { "gates": { "defaultTimeoutMs": 900000, "gates": [] } },
-  "authority": { "enabled": false },
-  "timeoutMs": 600000,
-  "pollIntervalMs": 30000
-}
+Parsed with the `yaml` package (YAML 1.2 core schema), so a repeated key is
+refused rather than silently keeping the last one, and `no` / `on` / `off`
+stay plain strings — never coerced to a boolean the way YAML 1.1 would. A
+value that starts with `@`, like every `@bluewombat/...` package name, needs
+quotes: `@` is a reserved YAML indicator at the start of a plain scalar.
+
+```yaml
+manager: "@bluewombat/manager-fake"
+managerOptions:
+  source: ./.mason/source
+  target: ./.mason/threads
+workLine:
+  stable: ./work-line-stable
+  isolation: "@bluewombat/isolation-copy"
+planner:
+  cmd:
+    - node
+    - ./node_modules/@bluewombat/slots/planners/one-subtask.mjs
+  timeoutMs: 600000
+builder:
+  producer:
+    cmd: [node, ./mason-builder.mjs]
+    timeoutMs: 600000
+  repair:
+    cmd: [node, ./mason-repair.mjs]
+    timeoutMs: 600000
+  maxAttempts: 3
+  gates: { defaultTimeoutMs: 120000, gates: [] }
+assembly:
+  gates: { defaultTimeoutMs: 900000, gates: [] }
+authority:
+  enabled: false
+timeoutMs: 600000
+pollIntervalMs: 30000
 ```
 
 | Field                       | Meaning                                                                                                                                                                                                                  |
@@ -140,17 +169,23 @@ flag paths resolve against the working directory. Flags override the file, and
 | `builder.repair`            | The same, for a pass a Gate refused. **Required**, and never inherited                                                                                                                                                   |
 | `builder.maxAttempts`       | Attempts one Task may start. Default 3                                                                                                                                                                                   |
 | `builder.gates`             | `defaultTimeoutMs` and `gates`: ordered checks on each Subtask                                                                                                                                                           |
-| `assembly.fix`              | `cmd` / `timeoutMs`. Spawned when a judgement of the whole refused it. Needs `authority.enabled`                                                                                                                         |
+| `assembly.fix`              | `cmd` / `timeoutMs`. Spawned when a judgement of the whole refused it — by an Authority, by `assembly.validate`, or by both                                                                                              |
+| `assembly.validate`         | `cmd` / `timeoutMs`. Optional. A local, read-only judge of the assembled feature, run after align, with or without an Authority. A refusal is repaired by `assembly.fix` the same as an Authority's                     |
 | `assembly.maxAttempts`      | Attempts that one fix may start. Default 3                                                                                                                                                                               |
 | `assembly.gates`            | Ordered checks on the assembled feature. Empty: the Authority judges alone                                                                                                                                               |
 | `timeoutMs`                 | How long a child **outside** a Task may run: manager, isolations                                                                                                                                                         |
-| `maxRefusals`               | Times an Authority may send a Submission back before it escalates. Default 3                                                                                                                                             |
+| `maxRefusals`               | Times the work may be sent back before it escalates, by an Authority, by `assembly.validate`, or by both — one shared budget. Default 3                                                                                 |
 | `pollIntervalMs`            | Set it and the process keeps draining until SIGINT. Absent: one tick                                                                                                                                                     |
+| `observability.streams`     | `enabled`, `dir`, `keep`. Films what every child says, as it says it — one file per child under `<dir>/<feature>/`, named in the journal by a `stream-opened` line. `dir` resolves against the config file; default `<home>/streams`. `keep` is `stdout` / `stderr`, default both. Off unless `enabled` is true: a stream is the Project's own code and prompts in the clear |
 
 Every `cmd` is named where it is used, and nothing falls back to a neighbour: a
 `repair` with no command of its own is refused rather than quietly running the
 first-pass agent again. `builder` makes a Subtask. `assembly` judges the whole
 and, when that judgement refuses it, runs `assembly.fix` — not a second first-pass.
+`assembly.validate`, when declared, is a second, local judge of the whole: it
+runs after align, before the Authority sees the work (or before the final
+fold, with none). Its refusal is repaired by `assembly.fix` exactly as an
+Authority's is, and shares the same `maxRefusals` budget.
 
 Every tracker field lives in `managerOptions`. Host does not read them.
 
@@ -206,7 +241,17 @@ feature, which makes nothing.
 Spawned in the feature workspace when a judgement of the whole refused it
 (`--report`, `--report-from`). Same argv as a Builder otherwise. Host hands
 Implementer `assembly.fix` as that pass's only agent: there is no first-pass
-producer at this moment.
+producer at this moment. The refusal it repairs may have come from an
+Authority or from `assembly.validate`.
+
+### Assembly validate
+
+Spawned in the feature workspace after align, with or without an Authority —
+`--intention`, `--id`, `--attempt`, `--context`. No `--report`: it is a
+read-only review, not a repair, and takes nothing a producer would. Optional.
+Its verdict is not the exit code alone: the slot reads what the agent itself
+answered and maps a refusal through the Builder failure contract, so a review
+that completes cleanly but finds a problem is still a refusal.
 
 ### Gates
 
@@ -330,7 +375,9 @@ it each stop `mason run` at boot, and `mason doctor` reports the same offline
 and is the operator's directory, as before.
 
 ```
-assembled → Publisher places the work → manager opens the Submission
+assembled → align → assembly.validate (optional, local)
+              refused  → assembly.fix, then align again, then validate again
+              accepted → Publisher places the work → manager opens the Submission
           → submitted, and the run comes back to it on each poll
               assembly.gates judge what was published
               refused  → assembly.fix, then the same Submission is offered again
@@ -338,7 +385,9 @@ assembled → Publisher places the work → manager opens the Submission
 ```
 
 Neither half judges: that is what `assembly.gates` are for. The Authority places
-and folds; a Gate says whether the fold may happen. After the
+and folds; a Gate says whether the fold may happen. `assembly.validate`, when
+declared, judges before either half — the same verdict has the same fate
+whether or not there is an Authority to offer the work to afterwards. After the
 Authority folds, Host brings its copy of the work line up to date with a
 fast-forward — the work line moved where the Authority is, and the next
 Isolation must start from that version, not from a copy left behind.
@@ -410,10 +459,10 @@ change that breaks it does not merge.
 
 | Layer                | Holds                                                                                                                                                     | Does not hold                                                    | May import                                    |
 | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------- |
-| `config/`            | What a Project wrote: argv, `mason.config.json`, discovery, `HostOptions`. Pure: JSON in, options out                                                     | A runtime value (a Journal, a Port, a process handle)            | Node, `manager-kit` types                     |
+| `config/`            | What a Project wrote: argv, `mason.config.yaml`, discovery, `HostOptions`. Pure: YAML in, options out                                                     | A runtime value (a Journal, a Port, a process handle)            | Node, `manager-kit` types                     |
 | `plugins/`           | Load a package by name and check its shape: a manager, an isolation strategy                                                                              | What to do with the loaded thing                                 | `config`                                      |
 | `loop/`              | The process: listen → probe → adapt → admit → run → report; composition (`open-host`, `transformers`, Authority, work line, lock, Cursor, journal, trace) | A command a human types; a string a human reads about the config | `plugins`, `config`, the kernel, Transformers |
-| `operator/`          | Tools for a human: `init`, `setup`, `doctor`, `watch` / `status`, `cancel`, `board`, the terminal prompt                                                  | Anything the loop needs — the loop cannot see this layer         | everything below                              |
+| `operator/`          | Tools for a human: `init`, `setup`, `doctor`, `watch` / `status`, `log`, `cancel`, `board`, the terminal prompt                                           | Anything the loop needs — the loop cannot see this layer         | everything below                              |
 | `index.ts`, `cli.ts` | The package surface and the dispatch. Nothing else sits at the top of `src/`                                                                              | Logic                                                            | everything                                    |
 
 Host's code names no plugin. A manager, an isolation strategy, a persistence
@@ -464,10 +513,10 @@ SPECS.md                 behavioural contract
 README.md                how to install, configure and run; the layers above
 src/
   index.ts               the package surface
-  cli.ts                 mason run | watch | status | cancel | init | setup | doctor
+  cli.ts                 mason run | watch | status | log | cancel | init | setup | doctor
   config/                argv, JSON config, config discovery → HostOptions; defaults: the plugin names Host ships with
   plugins/               load: the one loader; manager, isolation, persist: one shape each; discover
-  loop/                  open-host (composition), tick (the loop), deliveries, drive, probe, report, authority, work-line, cursor, lock, journal, trace, transformers
-  operator/              init, setup, doctor, live (watch / status), cancel, board, prompt, git-remote
+  loop/                  open-host (composition), tick (the loop), deliveries, drive, probe, report, authority, work-line, cursor, lock, journal (the film), streams (what a child said), trace, transformers
+  operator/              init, setup, doctor, live (watch / status), log, film, cancel, board, prompt, git-remote
 fixtures/                stand-in slots for the loop's tests
 ```

package/SPECS.md

@@ -34,10 +34,10 @@ Planner / Builder / Gate argv.
 
 ## 2. Faces
 
-| Face   | Entry                                                               | Must not                                      |
-| ------ | ------------------------------------------------------------------- | --------------------------------------------- |
-| Import | `openHost(options)` then `runOnce` / `run`                          | Live inside Conductor `src/run/`              |
-| CLI    | `mason run \| watch \| status \| cancel \| init \| setup \| doctor` | Interpret a FeatureStandard; pick Child paths |
+| Face   | Entry                                                                      | Must not                                      |
+| ------ | -------------------------------------------------------------------------- | --------------------------------------------- |
+| Import | `openHost(options)` then `runOnce` / `run`                                 | Live inside Conductor `src/run/`              |
+| CLI    | `mason run \| watch \| status \| log \| cancel \| init \| setup \| doctor` | Interpret a FeatureStandard; pick Child paths |
 
 `src/loop/` is the process: `open-host.ts` opens packages (composition),
 `tick.ts` runs the listen / probe / Cursor / sweep loop, `deliveries.ts` handles one
@@ -52,16 +52,23 @@ import rule between them are in [README.md](./README.md) § Layers.
 
 ## 3. Configuration
 
-`mason.config.json`, found by walking up from the working directory, or the
+`mason.config.yaml`, found by walking up from the working directory, or the
 file `--config` names. Relative paths in the file resolve against the file;
 relative paths in a flag resolve against the working directory. Flags override
 the file. `--manager-option key=value` merges per key, so overriding one option
 does not drop the others; a repeated key becomes an array.
 
-Host validates only its own keys. `managerOptions` is copied through untouched:
+Host validates only its own keys, against a closed list: an unknown key is a
+refusal, not something ignored. `managerOptions` is copied through untouched:
 a tracker's fields are that package's business, and its errors are that
 package's words.
 
+`observability` is the one key that changes nothing about how work is done, only
+what is written down about it. It holds `streams` — `enabled`, `dir`, `keep` —
+and `enabled` is declared rather than defaulted, for the same reason an
+Authority's is: what a stream holds is the Project's own material in the clear.
+See § 8.
+
 ## 4. Loading a manager
 
 `manager` is a package name or a path. Resolution imports the bare specifier
@@ -95,7 +102,7 @@ not losing an Event.
 | `invalid` (new, or the intention changed)   | `recordInvalid`, emit `invalid`                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `invalid` (same fingerprint as recorded)    | leave it; the tracker was told, and telling it is what delivered it again                                                                                                                                                                                                                                                                                                                                                                            |
 | `upsert` (new/invalid)                      | `admit`, emit `accepted`, then `runProject` when the Project is free; a Project frozen by an escalation queues the Feature (journal `queued`, one `progress` Event) and the sweep starts it once the Project is free. Post-run Events (`planned` / `done` / `escalated`) are reported on the Feature that was driven, not on the delivered key. `progress` (once per refusal) when the Authority sent the Submission back and a repair is on its way |
-| `upsert` (in-flight / terminal)             | leave it; do not restart. In-flight is `planning`, `running`, `escalated`, `integrating`, `submitted`; terminal is `merging`, `done`, `cancelled`. An echo of a Host report (Submitted, a progress comment) is this row: do not admit it                                                                                                                                                                                                              |
+| `upsert` (in-flight / terminal)             | leave it; do not restart. In-flight is `planning`, `running`, `escalated`, `integrating`, `submitted`; terminal is `merging`, `done`, `cancelled`. An echo of a Host report (Submitted, a progress comment) is this row: do not admit it                                                                                                                                                                                                             |
 | `upsert` (`received`)                       | same drive as a new upsert (no second `accepted`)                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `upsert` + `signalsReady` while `escalated` | same as `ready` — a poll snapshot has no `labeled` edge                                                                                                                                                                                                                                                                                                                                                                                              |
 | `ready`                                     | `resumeReady`, emit `resumed`, `runProject`, then the same post-run Events                                                                                                                                                                                                                                                                                                                                                                           |
@@ -140,6 +147,13 @@ Transformer progress, admitted, reported, queued, idle, a heartbeat while
 the ledger is still right. `mason run` still writes a human Trace on stdout.
 The journal is how another process attaches.
 
+An offer the work could not get past is journaled `submit-refused`, with the
+Feature's `key`, `by` (`publisher` when the work could not be placed,
+`authority` when the Authority would not open a Submission) and the refuser's
+own `reason`. The same reason becomes the escalation's Trace; the line is so
+`mason log --problems` and a watcher see why a run stopped, not only that it
+did.
+
 After listen, if the manager declares `probe` and the listen reached the source
 (`completed`, `listened` — not `source-lost` / `interrupted` / `invalid-invocation`),
 Host asks `probe` of every Feature abandon is still legal for (`received`,
@@ -157,7 +171,7 @@ and left; the next sweep that finds the Project free claims it. The same set
 copy: starting a queued Feature on a copy that was not fast-forwarded this
 tick would build on a version that no longer exists.
 
-## 8. init, setup, doctor, watch, status and cancel
+## 8. init, setup, doctor, watch, status, log and cancel
 
 `init` writes a config that already runs: the Planner is the bootstrap one from
 `@bluewombat/slots/planners/`, the Builder is a stub that says what to replace
@@ -172,6 +186,10 @@ other — `workspace-changed` says an Attempt that changed nothing did nothing,
 which is true of a Subtask and false of an assembly whose correct outcome is that
 nothing was left to do. The assembly produces nothing unless something refused it
 first: it is a judgement, and a refusal is `assembly.fix`, not a second first-pass.
+Two things may judge it: the Gate sequence (`assembly.gates`, and an Authority's
+own checks on what was published) and, optionally, `assembly.validate` — a local,
+read-only pass that runs before either. Both send a refusal to the same `fix`
+and spend the same `maxRefusals` budget.
 
 Every child of a Task carries its own ceiling and no other. Every `cmd` names
 its own `timeoutMs`, and none is inherited from a neighbour — nothing else
@@ -239,13 +257,67 @@ whether the manager loads, and then the manager's own findings. It parses
 without demanding that paths exist, so one missing directory does not hide
 every other check, and it never uses the network.
 
+A run names itself. `openHost` mints a `run_id`, stamps it on every journal
+line it writes, and opens the film with `host-started` — pid, Host's version,
+the manager, the ledger root — and closes it with `host-stopped` before the lock
+is released. A journal holds every run that ever wrote to that ledger, and
+without these a reader cannot tell one process's film from the next, nor a run
+that ended from one whose process was killed: the missing `host-stopped` is how
+the second is said. Every line about a Task also carries the Feature it serves,
+as `key`; a line that names a Task and no Feature is a line nothing can join.
+
+`observability.streams` films what every child says, as it says it: the
+producers, the Gates, the Planner. One file per child under
+`<dir>/<feature>/<task>-attempt-<n>[-gate-<id>]-<stamp>.ndjson`, one JSON object
+per chunk with its own stamp and which stream it came from, filed under the same
+directory name a transcript uses. Each file is named in the journal by a
+`stream-opened` line, so nothing has to rebuild the path. `dir` resolves against
+the config directory and defaults to `<home>/streams`; `keep` chooses `stdout`,
+`stderr`, or both. `--streams-dir DIR` is the same switch for one run, and there
+is no bare flag: what a stream holds is the Project's own material in the clear,
+and saying where it lands is part of asking for it. Off unless declared.
+
+Writing it is asynchronous and may be lost. The ledger is truth, the journal is
+the film and is written synchronously so it lands before the next phase, and
+this is the noise underneath — an agent's stream is large enough that putting it
+on a synchronous path would make visibility able to take a run down. A child
+killed for writing past its output bound is filmed up to the kill: the bound
+protects Host's memory, and that child is the one worth having a film of.
+
+A film says what it held as it closes — `stream-closed` with the bytes, the
+chunks and the milliseconds — and a Feature that reaches `done` or `cancelled`
+has its films removed, which the journal records as `streams-discarded` with the
+count and the size. An escalation keeps everything: that is the outcome where
+somebody has to go and look. Nothing prunes transcripts.
+
+A pass that listened to nothing and drove nothing is not written as it happens.
+Such passes are held and said as a single `idle` line carrying `passes`, at most
+once a minute, so a `watch` still shows the loop turning without a line every
+poll. A `listen` that did not complete is never held and never hidden.
+
 `watch` and `status` are the operator live view. They open the ledger the same
 way `run` does (`openFilesystemPersist` then `openWorkLedger`) and they do not
 open a manager, Conductor, or Host. `status` prints a snapshot of every known
 Feature and exits. `watch` prints that snapshot, then follows new journal lines
 until SIGINT (exit 0). A missing journal is not an error: the snapshot still
 stands. `--json` prints the snapshot as JSON. Ctrl-C on watch leaves the worker
-running. The file can grow without rotation.
+running. The file can grow without rotation. A followed line that records a
+stop includes the child's last words (`detail`, `reason`, a non-zero exit, a
+Gate report that did not pass). `run` prints that same note under the phase
+label.
+
+`log` reads that same journal and exits. It does not follow, and it does not
+open a manager or Host. Quiet lines (`idle`, a listen that delivered nothing)
+are hidden. `--all` keeps them. `--problems` keeps only lines that explain a
+stop. `--tail N` keeps the last N of the text film (0 means no limit). `--json`
+prints every kept line, and when `--tail` is also passed and drops lines the
+object names `kept` and `shown`. After the text film it tallies the distinct
+problems. A `result` is counted with the exit code of the `planner-finished`
+just before it. A run that then pauses, with no exit code, is tallied as
+`interrupted`, apart from a non-zero exit that left the same detail. When a
+slot was given `--transcript-dir` it names the newest transcript files with
+the agent exit and duration read from the start of each file. A missing
+journal is not an error. Exit 2 when the config or `--tail` cannot be read.
 
 `cancel <key>` abandons one Feature the same way a `cancel` delivery does. The
 team still abandons in the FeatureManager; this is the hatch when the tracker
@@ -299,5 +371,10 @@ positional: `cancel github:owner/name#19`.
 18. A Feature `submitted`, then the same upsert delivered again, then the
     Authority refuses: Host skips the echo, records no `pending_fingerprint`,
     and the next pass repairs. It does not escalate as a plan refusal.
+19. `log` on a journal that recorded `unavailable` with a `detail` prints that
+    detail, hides `idle`, and `--problems` drops the phase labels that are not
+    themselves the failure. `--json` returns every kept line. A paused run
+    with no planner exit code is tallied apart from a non-zero exit. It does
+    not import `openHost`.
 
 How to install, configure and run: [README.md](./README.md).

package/dist/cli.js

@@ -8,6 +8,7 @@ import { runCancel } from "./operator/cancel.js";
 import { runDoctor } from "./operator/doctor.js";
 import { runInit } from "./operator/init.js";
 import { runLive } from "./operator/live.js";
+import { runLog } from "./operator/log.js";
 import { isInteractive, terminalAsk } from "./operator/prompt.js";
 import { runSetup } from "./operator/setup.js";
 const USAGE = `Usage: ${PRODUCT} <command>
@@ -15,6 +16,7 @@ const USAGE = `Usage: ${PRODUCT} <command>
   run      drain the FeatureManager, run Conductor, report
   watch    snapshot the ledger and follow the journal
   status   snapshot the ledger, then exit
+  log      replay the journal, including why a phase stopped
   cancel   abandon a Feature by key (when the tracker cannot say it is gone)
   init     set this directory up — asks, writes, then runs setup
   doctor   check the config, the slots, and the manager
@@ -25,11 +27,13 @@ init flags:   --manager PKG --manager-option KEY=VALUE --work-line-stable DIR
 
 Shared flags: --config FILE --manager NAME --manager-option KEY=VALUE --home DIR
               --work-line-stable DIR --work-line-branch NAME --workspace-root DIR --ledger DIR
+              --streams-dir DIR
               --planner -- CMD --planner-timeout-ms N
               --builder -- CMD --builder-timeout-ms N --builder-max-attempts N
               --builder-repair -- CMD --builder-repair-timeout-ms N
               --builder-gate ID -- CMD --builder-gate-timeout-ms N
               --assembly-fix -- CMD --assembly-fix-timeout-ms N --assembly-max-attempts N
+              --assembly-validate -- CMD --assembly-validate-timeout-ms N
               --assembly-gate ID -- CMD --assembly-gate-timeout-ms N
               --timeout-ms N --poll-interval-ms N
 
@@ -37,9 +41,17 @@ A gate's --*-gate-timeout-ms comes before the --*-gate it bounds.
 
 watch / status also take --json (snapshot as JSON).
 
+log also takes --problems, --all, and --json (every kept line).
+--tail N limits the text film (0 = no limit). With --json it names kept and shown when it drops lines.
+
 Without --config, the nearest ${CONFIG_FILENAME} is used. --home is where Host
 keeps its own files (default ${DEFAULT_HOME}): the ledger, the workspaces, its copy of
 the work line.
+
+--streams-dir films what every child says, as it says it, one file per child.
+Naming the directory is what turns it on; the config key "observability.streams"
+is the same switch for good. It is off by default: a stream is the Project's own
+material — its code, its prompts — written down in the clear.
 `;
 function installSignalHandlers(state) {
     const onSignal = () => {
@@ -85,6 +97,13 @@ async function main(argv) {
     if (command === "run") {
         return await run(rest);
     }
+    if (command === "log") {
+        return await runLog({
+            cwd: process.cwd(),
+            argv: rest,
+            write: (line) => process.stdout.write(line),
+        });
+    }
     if (command === "watch" || command === "status") {
         const interruptFlag = { interrupted: false };
         const detachSignals = installSignalHandlers(interruptFlag);

package/dist/cli.js.map

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

package/dist/config/find-config.d.ts

@@ -1,6 +1,6 @@
-export declare const CONFIG_FILENAME = "mason.config.json";
+export declare const CONFIG_FILENAME = "mason.config.yaml";
 /**
- * The nearest `mason.config.json`, walking up from `startDir`.
+ * The nearest `mason.config.yaml`, walking up from `startDir`.
  *
  * Running from a subdirectory of the project is the common case, so the file is
  * looked up the way a toolchain config is, not demanded on the command line.

package/dist/config/find-config.js

@@ -1,9 +1,9 @@
 import { existsSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { PRODUCT } from "@bluewombat/manager-kit";
-export const CONFIG_FILENAME = `${PRODUCT}.config.json`;
+export const CONFIG_FILENAME = `${PRODUCT}.config.yaml`;
 /**
- * The nearest `mason.config.json`, walking up from `startDir`.
+ * The nearest `mason.config.yaml`, walking up from `startDir`.
  *
  * Running from a subdirectory of the project is the common case, so the file is
  * looked up the way a toolchain config is, not demanded on the command line.

package/dist/config/load-config.d.ts

@@ -7,7 +7,7 @@ export type LoadedConfig = {
     reason: string;
 };
 /**
- * Read one JSON object and resolve relative paths against the file's directory.
+ * Read one YAML document and resolve relative paths against the file's directory.
  */
 export declare function loadConfig(path: string): LoadedConfig;
 //# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA+B,cAAc,EAAuB,MAAM,YAAY,CAAC;AA0BnG,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAyJrD"}
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,YAAY,CAAC;AA8BpB,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAmKrD"}