--- r1/docs/TOOLS.md +++ r2/docs/TOOLS.md @@ -175,10 +175,13 @@ path from the checkout. On a pinned host, `mosaic` on PATH is a wrapper around a pinned copy's `scripts/mosaic` ([Stack copies](#stack-copies-scriptsstack-copysh)) and carries the human -commands. Queue commands stay on `scripts/mosaic queue` in the canonical -checkout, because a copy refuses them. Exit codes: the launch script's own -once it runs; before that 1 could not start, 2 invalid config or seat, 4 -usage. Details and the record's fields: `packages/seat/README.md`. +commands; on Jason's host the estate CLI it replaced is `mosaic-old`. +Queue commands stay on `scripts/mosaic queue` in the canonical checkout, +because a copy refuses them ([One pinned +copy](../packages/cli/README.md#one-pinned-copy-row-85-1579)). Exit +codes: the launch script's own once it runs; before that 1 could not +start, 2 invalid config or seat, 4 usage. Details and the record's +fields: `packages/seat/README.md`. ## Work queue (`scripts/mosaic queue`) --- r1/packages/queue/tests/dispatch.test.mjs +++ r2/packages/queue/tests/dispatch.test.mjs @@ -102,8 +102,9 @@ test("the pre-A2 fixture is the script A2 changed", () => { const fixture = readFileSync(join(HERE, "fixtures", "mosaic-pre-a2.sh"), "utf8"); const now = readFileSync(join(SCRIPTS, "mosaic"), "utf8"); - // A2 adds lines and removes none. Comment lines are left out: later rows - // rewrite the header (row 70), and the pin is on what the script runs. + // A2 adds lines and removes none. Lines that start with "# " are left out: + // later rows rewrite the header (row 70), and the pin is on what the script + // runs. The shebang and any other line stay in. const code = (s) => s.split("\n").filter((l) => !l.startsWith("# ")); const lines = code(now); let i = 0; --- r1/packages/seat/README.md +++ r2/packages/seat/README.md @@ -12,7 +12,8 @@ The repository wrapper is `scripts/mosaic`; run it by path from the checkout. A host may also put `mosaic` on PATH as a wrapper around a -pinned copy's `scripts/mosaic` (`scripts/stack-copy.sh wrapper`). On +pinned copy's `scripts/mosaic` (`scripts/stack-copy.sh wrapper`, see +[docs/TOOLS.md, Stack copies](../../docs/TOOLS.md#stack-copies-scriptsstack-copysh)). On Jason's host the estate CLI it replaced is `mosaic-old`, which has no `launch` or `seat` command. On a pinned host the human commands go through `mosaic` on PATH, and queue commands stay on `scripts/mosaic --- r1/scripts/mosaic +++ r2/scripts/mosaic @@ -10,7 +10,8 @@ # This is the repository wrapper; run it by path from the checkout. A host # may also put `mosaic` on PATH as a wrapper that runs a pinned copy's # scripts/mosaic (scripts/stack-copy.sh wrapper, docs/TOOLS.md "Stack -# copies"). On a pinned host the human commands and --tester go through +# copies"). On Jason's host the estate CLI it replaced is `mosaic-old`. +# On a pinned host the human commands and --tester go through # that `mosaic`, and from a checkout they exit 3. Queue commands stay on # scripts/mosaic queue in the canonical checkout, because a copy refuses # them. See packages/cli/README.md "One pinned copy".