npm - @smthrs/std - Versions diffs - 1.0.0-rc.3 → 1.0.0-rc.5 - Mend

@smthrs/std 1.0.0-rc.3 → 1.0.0-rc.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/README.md +35 -35
package/dist/cjs/Bash.d.ts +76 -0
package/dist/cjs/Bash.d.ts.map +1 -1
package/dist/cjs/Bash.js +20 -9
package/dist/cjs/Bash.js.map +2 -2
package/dist/cjs/internal/GitWorktree.d.ts +11 -1
package/dist/cjs/internal/GitWorktree.d.ts.map +1 -1
package/dist/cjs/internal/GitWorktree.js +7 -1
package/dist/cjs/internal/GitWorktree.js.map +2 -2
package/dist/esm/Bash.d.ts +76 -0
package/dist/esm/Bash.d.ts.map +1 -1
package/dist/esm/Bash.js +46 -10
package/dist/esm/Bash.js.map +1 -1
package/dist/esm/internal/GitWorktree.d.ts +11 -1
package/dist/esm/internal/GitWorktree.d.ts.map +1 -1
package/dist/esm/internal/GitWorktree.js +8 -1
package/dist/esm/internal/GitWorktree.js.map +1 -1
package/docs/concepts/flows-and-handlers.md +2 -2
package/docs/guides/run-a-shell-command.md +8 -0
package/docs/troubleshooting.md +5 -0
package/package.json +6 -6
package/src/Bash.ts +67 -9
package/src/internal/GitWorktree.ts +20 -2

package/dist/esm/internal/GitWorktree.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GitWorktree.js","sourceRoot":"","sources":["../../../src/internal/GitWorktree.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Detached checkouts shared by checkpoint reads and baseline test runs.\n \n ## Host git never reads a file the agent can write that names a program\n \n The repository is the workspace's, and an agent can write its `.git`: a\n * containerised agent writes it through the bind mount. Git reads programs out\n * of that directory in more places than any list of `-c` overrides can close.\n * Hooks and `core.fsmonitor` can be overridden, but a filter driver\n * (`filter.<name>.clean`/`.smudge` in `.git/config`, selected by\n * `.git/info/attributes`) cannot: git has no switch that ignores repository\n * config or `$GIT_DIR/info/attributes`, and overriding each driver by name\n * races an agent that keeps rewriting the file.\n \n So the git that records and checks out trees runs against a shadow\n * `GIT_DIR`: a bare repository this module creates under the host's temporary\n * directory for one operation and deletes afterwards. Its config, hooks and\n * `info/attributes` are the ones `git init --template=` writes, which is none.\n * `GIT_CONFIG_NOSYSTEM` and `GIT_CONFIG_GLOBAL=/dev/null` drop the host's own\n * config files too, so the only settings are the ones on the command line.\n * `GIT_OBJECT_DIRECTORY` points at the workspace's object store, because objects\n * are data: git hashes and inflates them and never runs anything they say.\n \n What still touches the workspace repository is plain data:\n \n - `rev-parse` in the workspace, which resolves refs and paths and runs no\n * hook, filter, fsmonitor or other configured program;\n * - `git config --file <workspace config>`, which reads or writes that one file\n * and follows no `include`;\n * - a copy of the workspace index into the shadow, so the recorded tree holds\n * what the agent staged without the harness writing the agent's index; and\n * - a handful of `core.` settings that change how bytes are hashed\n ({@link dataSettings}), each accepted only as a bare word.\n \n A materialized checkout gets its own standalone `.git`, written by this\n * module as files, so a container can still run git in it: `HEAD` names the\n * commit, `objects/info/alternates` points back at the workspace's objects by a\n * relative path, and `index` is the one the checkout was written from. Host git\n * never uses that directory; it is the container's.\n \n @since 1.0.0\n /\n\nimport type { ChildProcessSpawner } from \"@smthrs/kernel/ChildProcessSpawner\"\nimport { Effect } from \"effect\"\nimport as StdError from \"../StdError.ts\"\nimport * as Exec from \"./Exec.ts\"\n\nconst failed = (message: string, code: StdError.Code = \"command_failed\") => new StdError.StdError({ code, message })\n\n/*\n Settings that stop the workspace repository from naming a program for the\n * `rev-parse` this module runs in it. `rev-parse` runs none of them; these keep\n * that true if a later call is added beside it.\n /\nconst hostGitSettings = [\"-c\", \"core.hooksPath=/dev/null\", \"-c\", \"core.fsmonitor=false\"] as const\n\n/* Host config files git would otherwise read, removed from every shadow command. /\nconst isolated = { GIT_CONFIG_NOSYSTEM: \"1\", GIT_CONFIG_GLOBAL: \"/dev/null\" } as const\n\n/\n Workspace settings that change how a tree is hashed or compared, carried\n * onto the shadow so a checkpoint records what the agent's own git would.\n * None of them names a program.\n /\nconst dataSettings = /^core\\.(autocrlf\|eol\|safecrlf\|filemode\|symlinks\|ignorecase\|precomposeunicode)$/\n\n/* A setting value this module will repeat to git: a bare word, never a command. /\nconst bareWord = /^[A-Za-z0-9_-]+$/\n\nconst run = (command: string, args: ReadonlyArray<string>, env?: Readonly<Record<string, string>>) =>\n Exec.exec(command, { args, ...(env === undefined ? {} : { env }) }).pipe(\n Effect.mapError((error) => failed(`${command} could not run: ${error.message}`))\n )\n\n/\n Runs host git in the workspace at `root`, for `rev-parse` only.\n \n @category utilities\n * @since 1.0.0\n /\nconst git = (root: string, args: ReadonlyArray<string>) => run(\"git\", [...hostGitSettings, \"-C\", root, ...args])\n\nconst resolveCommit = (root: string, refs: ReadonlyArray<string>) =>\n Effect.gen(function() {\n for (const ref of refs) {\n const answer = yield* git(root, [\"rev-parse\", \"--verify\", \"--quiet\", `${ref}^{commit}`])\n const commit = answer.stdout.trim()\n if (answer.exitCode === 0 && commit !== \"\") return { ref, commit }\n }\n return yield* Effect.fail(failed(`No commit resolves from ${refs.join(\" or \")} in ${root}.`, \"not_found\"))\n })\n\n/*\n Where one workspace repository keeps what the shadow needs, as its own git\n * reports it.\n \n @category models\n * @since 1.0.0\n /\nexport interface Repository {\n /* The root the caller named, without a trailing slash. /\n readonly root: string\n /* The same directory, as git canonicalizes it. /\n readonly toplevel: string\n /* The common git directory, which holds config and objects. /\n readonly common: string\n /* The workspace index. /\n readonly index: string\n readonly objectFormat: string\n /* {@link dataSettings} as `-c` arguments. /\n readonly settings: ReadonlyArray<string>\n}\n\n/\n Reads or writes the workspace's config file as a file, never as a repository.\n \n `--git-dir=/dev/null` stops git discovering any repository around the host's\n * working directory, and `--file` reads the one file without `include`s.\n \n @category utilities\n * @since 1.0.0\n /\nconst config = (repository: Pick<Repository, \"common\">, args: ReadonlyArray<string>) =>\n run(\"git\", [\"--git-dir=/dev/null\", \"config\", \"--file\", `${repository.common}/config`, ...args], isolated)\n\nconst open = (root: string): Effect.Effect<Repository, StdError.StdError, ChildProcessSpawner> =>\n Effect.gen(function() {\n const stripped = root.replace(/\\/+$/, \"\")\n const answer = yield* git(stripped, [\n \"rev-parse\",\n \"--path-format=absolute\",\n \"--show-toplevel\",\n \"--git-common-dir\",\n \"--git-path\",\n \"index\",\n \"--show-object-format\"\n ])\n const [toplevel, common, index, objectFormat] = answer.stdout.split(\"\\n\").map((line) => line.trim())\n if (\n answer.exitCode !== 0 \|\| toplevel === undefined \|\| toplevel === \"\" \|\| common === undefined \|\| common === \"\" \|\|\n index === undefined \|\| index === \"\" \|\| objectFormat === undefined \|\| !bareWord.test(objectFormat)\n ) {\n return yield* Effect.fail(failed(`${stripped} is not a git work tree: ${answer.stderr.trim()}`))\n }\n const found = yield* config({ common }, [\"--get-regexp\", dataSettings.source])\n const settings = found.exitCode === 0\n ? found.stdout.split(\"\\n\").flatMap((line) => {\n const [key, value] = line.trim().split(/\\s+/)\n return key !== undefined && value !== undefined && dataSettings.test(key) && bareWord.test(value)\n ? [\"-c\", `${key}=${value}`]\n : []\n })\n : []\n return { root: stripped, toplevel, common, index, objectFormat, settings }\n })\n\nconst temporaryRoot = (): string => {\n const configured = globalThis.process?.env?.TMPDIR?.replace(/\\/+$/, \"\")\n return configured === undefined \|\| configured === \"\" ? \"/tmp\" : configured\n}\n\nconst remove = (path: string) =>\n run(\"rm\", [\"-rf\", \"--\", path]).pipe(\n Effect.flatMap((removed) => removed.exitCode === 0 ? Effect.void : Effect.fail(failed(removed.stderr.trim())))\n )\n\n/*\n A harness-owned `GIT_DIR` over one workspace's objects.\n \n @category models\n * @since 1.0.0\n /\nexport interface Shadow {\n readonly path: string\n readonly repository: Repository\n /* Runs host git with the shadow as `GIT_DIR`, and `workTree` as its work tree when given. /\n readonly git: (\n args: ReadonlyArray<string>,\n workTree?: string\n ) => Effect.Effect<Exec.ExecResult, StdError.StdError, ChildProcessSpawner>\n /* Copies the workspace index into the shadow, so the shadow never writes the agent's own. /\n readonly adoptIndex: Effect.Effect<void, StdError.StdError, ChildProcessSpawner>\n}\n\nconst shadowOf = (repository: Repository, path: string): Shadow => ({\n path,\n repository,\n git: (args, workTree) =>\n run(\n \"git\",\n [\n `--git-dir=${path}`,\n ...(workTree === undefined ? [] : [`--work-tree=${workTree}`]),\n ...hostGitSettings,\n ...repository.settings,\n ...args\n ],\n { ...isolated, GIT_OBJECT_DIRECTORY: `${repository.common}/objects` }\n ),\n adoptIndex: run(\"sh\", [\n \"-c\",\n \"set -C; if [ -e \\\"$1\\\" ]; then cat -- \\\"$1\\\" > \\\"$2\\\"; fi\",\n \"sh\",\n repository.index,\n `${path}/index`\n ]).pipe(\n Effect.flatMap((copied) =>\n copied.exitCode === 0\n ? Effect.void\n : Effect.fail(failed(`Could not read the workspace index: ${copied.stderr.trim()}`))\n )\n )\n})\n\n/\n Runs `use` with a fresh {@link Shadow} over the repository at `root`, and\n * deletes the shadow however `use` ends.\n \n @category utilities\n * @since 1.0.0\n /\nconst withShadow = <A, E, R>(\n root: string \| Repository,\n use: (shadow: Shadow) => Effect.Effect<A, E, R>\n): Effect.Effect<A, E \| StdError.StdError, R \| ChildProcessSpawner> =>\n Effect.gen(function() {\n const repository = typeof root === \"string\" ? yield* open(root) : root\n const path = `${temporaryRoot()}/smithers-git-${globalThis.crypto.randomUUID()}`\n return yield* Effect.acquireUseRelease(\n Effect.succeed(path),\n () =>\n Effect.gen(function() {\n const created = yield run(\n \"git\",\n [\"init\", \"--quiet\", \"--bare\", \"--template=\", `--object-format=${repository.objectFormat}`, path],\n isolated\n )\n if (created.exitCode !== 0) {\n return yield* Effect.fail(failed(`Could not create a shadow repository: ${created.stderr.trim()}`))\n }\n return yield* use(shadowOf(repository, path))\n }),\n () =>\n remove(path).pipe(\n Effect.catch((error) =>\n Effect.logWarning(\"could not remove a shadow repository\").pipe(\n Effect.annotateLogs({ path, reason: error.message })\n )\n )\n )\n )\n })\n\n/** `to` relative to `from`, both absolute POSIX paths. /\nconst relative = (from: string, to: string): string => {\n const source = from.split(\"/\").filter((part) => part !== \"\")\n const target = to.split(\"/\").filter((part) => part !== \"\")\n let shared = 0\n while (shared < source.length && shared < target.length && source[shared] === target[shared]) shared++\n return [...source.slice(shared).map(() => \"..\"), ...target.slice(shared)].join(\"/\") \|\| \".\"\n}\n\n/\n The config of a checkout's own `.git`, for the container's git.\n \n Only {@link dataSettings}, already restricted to bare words, reach it.\n /\nconst checkoutConfig = (repository: Repository): string => {\n const sha1 = repository.objectFormat === \"sha1\"\n const lines = [\n \"[core]\",\n `\\trepositoryformatversion = ${sha1 ? 0 : 1}`,\n \"\\tbare = false\",\n ...repository.settings.filter((_, index) => index % 2 === 1).map((setting) => {\n const [key, value] = setting.split(\"=\")\n return `\\t${key?.slice(\"core.\".length)} = ${value}`\n }),\n ...(sha1 ? [] : [\"[extensions]\", `\\tobjectformat = ${repository.objectFormat}`])\n ]\n return `${lines.join(\"\\n\")}\\n`\n}\n\n/* Fails with `message` and the command's stderr unless it exited 0. /\nconst succeeded = (result: Exec.ExecResult, message: string) =>\n result.exitCode === 0 ? Effect.void : Effect.fail(failed(`${message}: ${result.stderr.trim()}`))\n\n/\n Measures which staging directory shares the filesystem of the checkout's\n * parent `$1`: the shadow `$2`, the workspace root's parent `$3`, or the host\n * cache directory `$4`. Prints one line each for the parent, the shadow, the\n * root's parent (`unwritable` when the host user cannot create a stage there)\n * and the cache (empty unless both others missed and it could be created).\n * `stat -c` is GNU and BusyBox, `stat -f` is BSD; an empty line means neither\n * answered.\n /\nconst measure = [\n \"set -e\",\n \"mkdir -p -- \\\"$1\\\"\",\n \"dev() { stat -c %d -- \\\"$1\\\" 2>/dev/null \|\| stat -f %d -- \\\"$1\\\" 2>/dev/null \|\| echo; }\",\n \"t=$(dev \\\"$1\\\")\",\n \"s=$(dev \\\"$2\\\")\",\n \"if [ -w \\\"$3\\\" ]; then b=$(dev \\\"$3\\\"); else b=unwritable; fi\",\n \"c=\",\n \"if [ -n \\\"$t\\\" ] && [ \\\"$t\\\" != \\\"$s\\\" ] && [ \\\"$t\\\" != \\\"$b\\\" ] && [ -n \\\"$4\\\" ] && mkdir -p -m 700 -- \\\"$4\\\" 2>/dev/null; then c=$(dev \\\"$4\\\"); fi\",\n \"printf '%s\\\\n' \\\"$t\\\" \\\"$s\\\" \\\"$b\\\" \\\"$c\\\"\"\n].join(\"; \")\n\n/\n The host user's cache directory for checkout stages: `$XDG_CACHE_HOME`, or\n * `~/.cache`, under `smithers`. Empty when neither is an absolute path.\n /\nconst cacheRoot = (): string => {\n const env = globalThis.process?.env\n const xdg = env?.XDG_CACHE_HOME?.replace(/\\/+$/, \"\")\n if (xdg !== undefined && xdg.startsWith(\"/\")) return `${xdg}/smithers`\n const home = env?.HOME?.replace(/\\/+$/, \"\")\n return home !== undefined && home.startsWith(\"/\") ? `${home}/.cache/smithers` : \"\"\n}\n\n/\n Moves the staged checkout `$1` into the directory `$2` under the name `$3`\n * in one `rename`, then proves the directory there is the one that was staged.\n * The staging directory is on the same filesystem, so `mv` renames and never\n * copies.\n \n The shell first enters `$2` by its physical path and refuses unless that\n * lies under the real path of the workspace root `$4`. The rename then names\n * the target relative to that directory, so a parent the agent swaps for a\n * symlink, before or after the check, cannot carry the checkout out of the\n * workspace.\n /\nconst publish = [\n \"set -e\",\n \"root=$(cd -P -- \\\"$4\\\" && pwd -P)\",\n \"cd -P -- \\\"$2\\\"\",\n \"here=$(pwd -P)\",\n \"case \\\"$here\\\" in \\\"$root\\\"\|\\\"$root\\\"/) ;; ) echo \\\"$2 resolves to $here, outside the workspace $root\\\" >&2; exit 1 ;; esac\",\n \"if [ -e \\\"./$3\\\" ] \|\| [ -L \\\"./$3\\\" ]; then echo \\\"$2/$3 already exists\\\" >&2; exit 1; fi\",\n \"staged=$(ls -di -- \\\"$1\\\" \| awk '{print $1}')\",\n \"mv -- \\\"$1\\\" \\\"./$3\\\"\",\n \"if [ -L \\\"./$3\\\" ] \|\| [ ! -d \\\"./$3\\\" ]; then echo \\\"$2/$3 was replaced while it was written\\\" >&2; exit 1; fi\",\n \"moved=$(ls -di -- \\\"./$3\\\" \| awk '{print $1}')\",\n \"if [ \\\"$staged\\\" != \\\"$moved\\\" ]; then echo \\\"$2/$3 was replaced while it was written\\\" >&2; exit 1; fi\"\n].join(\"; \")\n\n/\n Checks `commit`'s tree out at the new directory `host`, with a standalone\n * `.git` the container's git can use.\n \n Host git never writes into an agent-writable directory. The tree and its\n * `.git` are written into a staging directory the agent cannot reach: inside\n * the shadow, or, when the host's temporary directory is another filesystem,\n * beside the workspace root or under the host user's cache directory. One\n * `rename` then gives the finished directory its name under the workspace. A\n * path the agent swaps for a symlink cannot redirect a write: a symlink at\n * `host` fails the call before the rename, and a parent that resolves outside\n * the workspace root fails it before the rename too.\n /\nconst checkout = (shadow: Shadow, host: string, commit: string) =>\n Effect.gen(function() {\n const repository = shadow.repository\n const parent = host.slice(0, host.lastIndexOf(\"/\"))\n const name = host.slice(host.lastIndexOf(\"/\") + 1)\n const beside = repository.root.slice(0, repository.root.lastIndexOf(\"/\")) \|\| \"/\"\n const cache = cacheRoot()\n const stage = `checkout-${globalThis.crypto.randomUUID()}`\n const besideStage = `${beside.replace(/\\/+$/, \"\")}/.smithers-${stage}`\n const cacheStage = `${cache}/${stage}`\n const measured = yield* run(\"sh\", [\"-c\", measure, \"sh\", parent, shadow.path, beside, cache])\n yield* succeeded(measured, `Could not check out ${commit}`)\n const [target, inShadow, besideRoot, inCache] = measured.stdout.split(\"\\n\").map((line) => line.trim())\n const scratch = target === undefined \|\| target === \"\" \|\| target === inShadow\n ? undefined\n : target === besideRoot\n ? besideStage\n : target === inCache\n ? cacheStage\n : undefined\n const base = target === undefined \|\| target === \"\"\n ? undefined\n : target === inShadow\n ? shadow.path\n : scratch\n if (base === undefined) {\n const unwritable = besideRoot === \"unwritable\" ? \" (not writable by this user)\" : \"\"\n return yield* Effect.fail(\n failed(\n `Could not check out ${commit}: neither ${shadow.path} nor ${beside}${unwritable} nor ${\n cache === \"\" ? \"a cache directory\" : cache\n } is on the filesystem of ${parent}`\n )\n )\n }\n const staged = `${base}/${name}`\n const objects = relative(\n `${repository.toplevel}${host.slice(repository.root.length)}/.git/objects`,\n `${repository.common}/objects`\n )\n const write = Effect.gen(function() {\n const prepared = yield run(\"sh\", [\n \"-c\",\n [\n \"set -eC\",\n ...(scratch !== undefined ? [\"mkdir -m 700 -- \\\"$1\\\"\"] : []),\n \"mkdir -- \\\"$2\\\" \\\"$2/.git\\\" \\\"$2/.git/objects\\\" \\\"$2/.git/objects/info\\\" \\\"$2/.git/refs\\\"\",\n \"printf '%s\\\\n' \\\"$3\\\" > \\\"$2/.git/HEAD\\\"\",\n \"printf '%s\\\\n' \\\"$4\\\" > \\\"$2/.git/objects/info/alternates\\\"\",\n \"printf '%s' \\\"$5\\\" > \\\"$2/.git/config\\\"\"\n ].join(\"; \"),\n \"sh\",\n base,\n staged,\n commit,\n objects,\n checkoutConfig(repository)\n ])\n yield* succeeded(prepared, `Could not check out ${commit}`)\n const written = yield* shadow.git([\"read-tree\", \"--reset\", \"-u\", commit], staged)\n yield* succeeded(written, `Could not check out ${commit}`)\n const indexed = yield* run(\"sh\", [\n \"-c\",\n \"set -C; cat -- \\\"$1\\\" > \\\"$2\\\"\",\n \"sh\",\n `${shadow.path}/index`,\n `${staged}/.git/index`\n ])\n yield* succeeded(indexed, `Could not check out ${commit}`)\n const moved = yield* run(\"sh\", [\"-c\", publish, \"sh\", staged, parent, name, repository.root])\n yield* succeeded(moved, `Could not check out ${commit}`)\n })\n return yield* scratch !== undefined\n ? write.pipe(Effect.ensuring(remove(scratch).pipe(Effect.ignore)))\n : write\n })\n\nconst withDetachedWorktree = <A, E, R>(\n root: string,\n prefix: string,\n commit: string,\n use: (host: string) => Effect.Effect<A, E, R>\n): Effect.Effect<A, E \| StdError.StdError, R \| ChildProcessSpawner> =>\n Effect.gen(function() {\n // Allocate on execution, including when the same Effect is run twice.\n // Never remove an existing checkout: another call may still be using it.\n const host = `${root.replace(/\\/+$/, \"\")}/${prefix}-${globalThis.crypto.randomUUID()}`\n return yield Effect.acquireUseRelease(\n Effect.succeed(host),\n () =>\n Effect.gen(function() {\n yield withShadow(root, (shadow) => checkout(shadow, host, commit))\n return yield* use(host)\n }),\n // A checkout left behind is a stale copy of the repository inside the\n // workspace. Walks prune it, but the operator must still hear about it.\n () =>\n remove(host).pipe(\n Effect.catch((error) =>\n Effect.logWarning(\"could not remove a scratch checkout\").pipe(\n Effect.annotateLogs({ path: host, reason: error.message })\n )\n )\n )\n )\n })\n\n/*\n Internal Git operations used by both checkpoint and baseline leases.\n \n @category utilities\n * @since 1.0.0\n */\nexport const GitWorktree = { config, git, open, resolveCommit, withDetachedWorktree, withShadow }\n"]}
1	+ {"version":3,"file":"GitWorktree.js","sourceRoot":"","sources":["../../../src/internal/GitWorktree.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Detached checkouts shared by checkpoint reads and baseline test runs.\n \n ## Host git never reads a file the agent can write that names a program\n \n The repository is the workspace's, and an agent can write its `.git`: a\n * containerised agent writes it through the bind mount. Git reads programs out\n * of that directory in more places than any list of `-c` overrides can close.\n * Hooks and `core.fsmonitor` can be overridden, but a filter driver\n * (`filter.<name>.clean`/`.smudge` in `.git/config`, selected by\n * `.git/info/attributes`) cannot: git has no switch that ignores repository\n * config or `$GIT_DIR/info/attributes`, and overriding each driver by name\n * races an agent that keeps rewriting the file.\n \n So the git that records and checks out trees runs against a shadow\n * `GIT_DIR`: a bare repository this module creates under the host's temporary\n * directory for one operation and deletes afterwards. Its config, hooks and\n * `info/attributes` are the ones `git init --template=` writes, which is none.\n * `GIT_CONFIG_NOSYSTEM` and `GIT_CONFIG_GLOBAL=/dev/null` drop the host's own\n * config files too, so the only settings are the ones on the command line.\n * `GIT_OBJECT_DIRECTORY` points at the workspace's object store, because objects\n * are data: git hashes and inflates them and never runs anything they say.\n \n What still touches the workspace repository is plain data:\n \n - `rev-parse` in the workspace, which resolves refs and paths and runs no\n * hook, filter, fsmonitor or other configured program;\n * - `git config --file <workspace config>`, which reads or writes that one file\n * and follows no `include`;\n * - a copy of the workspace index into the shadow, so the recorded tree holds\n * what the agent staged without the harness writing the agent's index; and\n * - a handful of `core.` settings that change how bytes are hashed\n ({@link dataSettings}), each accepted only as a bare word.\n \n A materialized checkout gets its own standalone `.git`, written by this\n * module as files, so a container can still run git in it: `HEAD` names the\n * commit, `objects/info/alternates` points back at the workspace's objects by a\n * relative path, and `index` is the one the checkout was written from. Host git\n * never uses that directory; it is the container's.\n \n @since 1.0.0\n /\n\nimport type { ChildProcessSpawner } from \"@smthrs/kernel/ChildProcessSpawner\"\nimport { Effect } from \"effect\"\nimport as StdError from \"../StdError.ts\"\nimport * as Exec from \"./Exec.ts\"\n\nconst failed = (message: string, code: StdError.Code = \"command_failed\") => new StdError.StdError({ code, message })\n\n/*\n Settings that stop the workspace repository from naming a program for the\n * `rev-parse` this module runs in it. `rev-parse` runs none of them; these keep\n * that true if a later call is added beside it.\n /\nconst hostGitSettings = [\"-c\", \"core.hooksPath=/dev/null\", \"-c\", \"core.fsmonitor=false\"] as const\n\n/* Host config files git would otherwise read, removed from every shadow command. /\nconst isolated = { GIT_CONFIG_NOSYSTEM: \"1\", GIT_CONFIG_GLOBAL: \"/dev/null\" } as const\n\n/\n Workspace settings that change how a tree is hashed or compared, carried\n * onto the shadow so a checkpoint records what the agent's own git would.\n * None of them names a program.\n /\nconst dataSettings = /^core\\.(autocrlf\|eol\|safecrlf\|filemode\|symlinks\|ignorecase\|precomposeunicode)$/\n\n/* A setting value this module will repeat to git: a bare word, never a command. /\nconst bareWord = /^[A-Za-z0-9_-]+$/\n\nconst run = (command: string, args: ReadonlyArray<string>, env?: Readonly<Record<string, string>>) =>\n Exec.exec(command, { args, ...(env === undefined ? {} : { env }) }).pipe(\n Effect.mapError((error) => failed(`${command} could not run: ${error.message}`))\n )\n\n/\n Runs host git in the workspace at `root`, for `rev-parse` only.\n \n @category utilities\n * @since 1.0.0\n /\nconst git = (root: string, args: ReadonlyArray<string>) => run(\"git\", [...hostGitSettings, \"-C\", root, ...args])\n\nconst resolveCommit = (root: string, refs: ReadonlyArray<string>) =>\n Effect.gen(function() {\n for (const ref of refs) {\n const answer = yield* git(root, [\"rev-parse\", \"--verify\", \"--quiet\", `${ref}^{commit}`])\n const commit = answer.stdout.trim()\n if (answer.exitCode === 0 && commit !== \"\") return { ref, commit }\n }\n return yield* Effect.fail(failed(`No commit resolves from ${refs.join(\" or \")} in ${root}.`, \"not_found\"))\n })\n\n/*\n Where one workspace repository keeps what the shadow needs, as its own git\n * reports it.\n \n @category models\n * @since 1.0.0\n /\nexport interface Repository {\n /* The root the caller named, without a trailing slash. /\n readonly root: string\n /* The same directory, as git canonicalizes it. /\n readonly toplevel: string\n /* The common git directory, which holds config and objects. /\n readonly common: string\n /* The workspace index. /\n readonly index: string\n readonly objectFormat: string\n /* {@link dataSettings} as `-c` arguments. /\n readonly settings: ReadonlyArray<string>\n}\n\n/\n Reads or writes the workspace's config file as a file, never as a repository.\n \n `--git-dir=/dev/null` stops git discovering any repository around the host's\n * working directory, and `--file` reads the one file without `include`s.\n \n @category utilities\n * @since 1.0.0\n /\nconst config = (repository: Pick<Repository, \"common\">, args: ReadonlyArray<string>) =>\n run(\"git\", [\"--git-dir=/dev/null\", \"config\", \"--file\", `${repository.common}/config`, ...args], isolated)\n\nconst open = (root: string): Effect.Effect<Repository, StdError.StdError, ChildProcessSpawner> =>\n Effect.gen(function() {\n const stripped = root.replace(/\\/+$/, \"\")\n const answer = yield* git(stripped, [\n \"rev-parse\",\n \"--path-format=absolute\",\n \"--show-toplevel\",\n \"--git-common-dir\",\n \"--git-path\",\n \"index\",\n \"--show-object-format\"\n ])\n const [toplevel, common, index, objectFormat] = answer.stdout.split(\"\\n\").map((line) => line.trim())\n if (\n answer.exitCode !== 0 \|\| toplevel === undefined \|\| toplevel === \"\" \|\| common === undefined \|\| common === \"\" \|\|\n index === undefined \|\| index === \"\" \|\| objectFormat === undefined \|\| !bareWord.test(objectFormat)\n ) {\n return yield* Effect.fail(failed(`${stripped} is not a git work tree: ${answer.stderr.trim()}`))\n }\n const found = yield* config({ common }, [\"--get-regexp\", dataSettings.source])\n const settings = found.exitCode === 0\n ? found.stdout.split(\"\\n\").flatMap((line) => {\n const [key, value] = line.trim().split(/\\s+/)\n return key !== undefined && value !== undefined && dataSettings.test(key) && bareWord.test(value)\n ? [\"-c\", `${key}=${value}`]\n : []\n })\n : []\n return { root: stripped, toplevel, common, index, objectFormat, settings }\n })\n\nconst temporaryRoot = (): string => {\n const configured = globalThis.process?.env?.TMPDIR?.replace(/\\/+$/, \"\")\n return configured === undefined \|\| configured === \"\" ? \"/tmp\" : configured\n}\n\nconst remove = (path: string) =>\n run(\"rm\", [\"-rf\", \"--\", path]).pipe(\n Effect.flatMap((removed) => removed.exitCode === 0 ? Effect.void : Effect.fail(failed(removed.stderr.trim())))\n )\n\n/*\n A harness-owned `GIT_DIR` over one workspace's objects.\n \n @category models\n * @since 1.0.0\n /\nexport interface Shadow {\n readonly path: string\n readonly repository: Repository\n /* Runs host git with the shadow as `GIT_DIR`, and `workTree` as its work tree when given. /\n readonly git: (\n args: ReadonlyArray<string>,\n workTree?: string\n ) => Effect.Effect<Exec.ExecResult, StdError.StdError, ChildProcessSpawner>\n /\n Copies the workspace index into the shadow, with its modification time, so\n * the shadow never writes the agent's own.\n \n The time is part of what git reads. It trusts an entry's recorded stat\n * unless the entry is at least as new as the index file, in whole seconds;\n * a copy stamped at the moment of copying made every entry look older, and a\n * same-size edit from the second the index was written was recorded as the\n * committed bytes (#3431). The time is taken before the bytes are read, so\n * an index rewritten meanwhile leaves the copy looking older, never newer.\n /\n readonly adoptIndex: Effect.Effect<void, StdError.StdError, ChildProcessSpawner>\n}\n\n/* The `adoptIndex` script: `$1` is the workspace index, `$2` the shadow's. /\nconst adoptIndexScript = [\n \"set -C\",\n \"if [ -e \\\"$1\\\" ]\",\n \"then : > \\\"$2.at\\\" && touch -r \\\"$1\\\" -- \\\"$2.at\\\" && cat -- \\\"$1\\\" > \\\"$2\\\" && touch -r \\\"$2.at\\\" -- \\\"$2\\\" && rm -f -- \\\"$2.at\\\"\",\n \"fi\"\n].join(\"; \")\n\nconst shadowOf = (repository: Repository, path: string): Shadow => ({\n path,\n repository,\n git: (args, workTree) =>\n run(\n \"git\",\n [\n `--git-dir=${path}`,\n ...(workTree === undefined ? [] : [`--work-tree=${workTree}`]),\n ...hostGitSettings,\n ...repository.settings,\n ...args\n ],\n { ...isolated, GIT_OBJECT_DIRECTORY: `${repository.common}/objects` }\n ),\n adoptIndex: run(\"sh\", [\n \"-c\",\n adoptIndexScript,\n \"sh\",\n repository.index,\n `${path}/index`\n ]).pipe(\n Effect.flatMap((copied) =>\n copied.exitCode === 0\n ? Effect.void\n : Effect.fail(failed(`Could not read the workspace index: ${copied.stderr.trim()}`))\n )\n )\n})\n\n/\n Runs `use` with a fresh {@link Shadow} over the repository at `root`, and\n * deletes the shadow however `use` ends.\n \n @category utilities\n * @since 1.0.0\n /\nconst withShadow = <A, E, R>(\n root: string \| Repository,\n use: (shadow: Shadow) => Effect.Effect<A, E, R>\n): Effect.Effect<A, E \| StdError.StdError, R \| ChildProcessSpawner> =>\n Effect.gen(function() {\n const repository = typeof root === \"string\" ? yield* open(root) : root\n const path = `${temporaryRoot()}/smithers-git-${globalThis.crypto.randomUUID()}`\n return yield* Effect.acquireUseRelease(\n Effect.succeed(path),\n () =>\n Effect.gen(function() {\n const created = yield run(\n \"git\",\n [\"init\", \"--quiet\", \"--bare\", \"--template=\", `--object-format=${repository.objectFormat}`, path],\n isolated\n )\n if (created.exitCode !== 0) {\n return yield* Effect.fail(failed(`Could not create a shadow repository: ${created.stderr.trim()}`))\n }\n return yield* use(shadowOf(repository, path))\n }),\n () =>\n remove(path).pipe(\n Effect.catch((error) =>\n Effect.logWarning(\"could not remove a shadow repository\").pipe(\n Effect.annotateLogs({ path, reason: error.message })\n )\n )\n )\n )\n })\n\n/** `to` relative to `from`, both absolute POSIX paths. /\nconst relative = (from: string, to: string): string => {\n const source = from.split(\"/\").filter((part) => part !== \"\")\n const target = to.split(\"/\").filter((part) => part !== \"\")\n let shared = 0\n while (shared < source.length && shared < target.length && source[shared] === target[shared]) shared++\n return [...source.slice(shared).map(() => \"..\"), ...target.slice(shared)].join(\"/\") \|\| \".\"\n}\n\n/\n The config of a checkout's own `.git`, for the container's git.\n \n Only {@link dataSettings}, already restricted to bare words, reach it.\n /\nconst checkoutConfig = (repository: Repository): string => {\n const sha1 = repository.objectFormat === \"sha1\"\n const lines = [\n \"[core]\",\n `\\trepositoryformatversion = ${sha1 ? 0 : 1}`,\n \"\\tbare = false\",\n ...repository.settings.filter((_, index) => index % 2 === 1).map((setting) => {\n const [key, value] = setting.split(\"=\")\n return `\\t${key?.slice(\"core.\".length)} = ${value}`\n }),\n ...(sha1 ? [] : [\"[extensions]\", `\\tobjectformat = ${repository.objectFormat}`])\n ]\n return `${lines.join(\"\\n\")}\\n`\n}\n\n/* Fails with `message` and the command's stderr unless it exited 0. /\nconst succeeded = (result: Exec.ExecResult, message: string) =>\n result.exitCode === 0 ? Effect.void : Effect.fail(failed(`${message}: ${result.stderr.trim()}`))\n\n/\n Measures which staging directory shares the filesystem of the checkout's\n * parent `$1`: the shadow `$2`, the workspace root's parent `$3`, or the host\n * cache directory `$4`. Prints one line each for the parent, the shadow, the\n * root's parent (`unwritable` when the host user cannot create a stage there)\n * and the cache (empty unless both others missed and it could be created).\n * `stat -c` is GNU and BusyBox, `stat -f` is BSD; an empty line means neither\n * answered.\n /\nconst measure = [\n \"set -e\",\n \"mkdir -p -- \\\"$1\\\"\",\n \"dev() { stat -c %d -- \\\"$1\\\" 2>/dev/null \|\| stat -f %d -- \\\"$1\\\" 2>/dev/null \|\| echo; }\",\n \"t=$(dev \\\"$1\\\")\",\n \"s=$(dev \\\"$2\\\")\",\n \"if [ -w \\\"$3\\\" ]; then b=$(dev \\\"$3\\\"); else b=unwritable; fi\",\n \"c=\",\n \"if [ -n \\\"$t\\\" ] && [ \\\"$t\\\" != \\\"$s\\\" ] && [ \\\"$t\\\" != \\\"$b\\\" ] && [ -n \\\"$4\\\" ] && mkdir -p -m 700 -- \\\"$4\\\" 2>/dev/null; then c=$(dev \\\"$4\\\"); fi\",\n \"printf '%s\\\\n' \\\"$t\\\" \\\"$s\\\" \\\"$b\\\" \\\"$c\\\"\"\n].join(\"; \")\n\n/\n The host user's cache directory for checkout stages: `$XDG_CACHE_HOME`, or\n * `~/.cache`, under `smithers`. Empty when neither is an absolute path.\n /\nconst cacheRoot = (): string => {\n const env = globalThis.process?.env\n const xdg = env?.XDG_CACHE_HOME?.replace(/\\/+$/, \"\")\n if (xdg !== undefined && xdg.startsWith(\"/\")) return `${xdg}/smithers`\n const home = env?.HOME?.replace(/\\/+$/, \"\")\n return home !== undefined && home.startsWith(\"/\") ? `${home}/.cache/smithers` : \"\"\n}\n\n/\n Moves the staged checkout `$1` into the directory `$2` under the name `$3`\n * in one `rename`, then proves the directory there is the one that was staged.\n * The staging directory is on the same filesystem, so `mv` renames and never\n * copies.\n \n The shell first enters `$2` by its physical path and refuses unless that\n * lies under the real path of the workspace root `$4`. The rename then names\n * the target relative to that directory, so a parent the agent swaps for a\n * symlink, before or after the check, cannot carry the checkout out of the\n * workspace.\n /\nconst publish = [\n \"set -e\",\n \"root=$(cd -P -- \\\"$4\\\" && pwd -P)\",\n \"cd -P -- \\\"$2\\\"\",\n \"here=$(pwd -P)\",\n \"case \\\"$here\\\" in \\\"$root\\\"\|\\\"$root\\\"/) ;; ) echo \\\"$2 resolves to $here, outside the workspace $root\\\" >&2; exit 1 ;; esac\",\n \"if [ -e \\\"./$3\\\" ] \|\| [ -L \\\"./$3\\\" ]; then echo \\\"$2/$3 already exists\\\" >&2; exit 1; fi\",\n \"staged=$(ls -di -- \\\"$1\\\" \| awk '{print $1}')\",\n \"mv -- \\\"$1\\\" \\\"./$3\\\"\",\n \"if [ -L \\\"./$3\\\" ] \|\| [ ! -d \\\"./$3\\\" ]; then echo \\\"$2/$3 was replaced while it was written\\\" >&2; exit 1; fi\",\n \"moved=$(ls -di -- \\\"./$3\\\" \| awk '{print $1}')\",\n \"if [ \\\"$staged\\\" != \\\"$moved\\\" ]; then echo \\\"$2/$3 was replaced while it was written\\\" >&2; exit 1; fi\"\n].join(\"; \")\n\n/\n Checks `commit`'s tree out at the new directory `host`, with a standalone\n * `.git` the container's git can use.\n \n Host git never writes into an agent-writable directory. The tree and its\n * `.git` are written into a staging directory the agent cannot reach: inside\n * the shadow, or, when the host's temporary directory is another filesystem,\n * beside the workspace root or under the host user's cache directory. One\n * `rename` then gives the finished directory its name under the workspace. A\n * path the agent swaps for a symlink cannot redirect a write: a symlink at\n * `host` fails the call before the rename, and a parent that resolves outside\n * the workspace root fails it before the rename too.\n /\nconst checkout = (shadow: Shadow, host: string, commit: string) =>\n Effect.gen(function() {\n const repository = shadow.repository\n const parent = host.slice(0, host.lastIndexOf(\"/\"))\n const name = host.slice(host.lastIndexOf(\"/\") + 1)\n const beside = repository.root.slice(0, repository.root.lastIndexOf(\"/\")) \|\| \"/\"\n const cache = cacheRoot()\n const stage = `checkout-${globalThis.crypto.randomUUID()}`\n const besideStage = `${beside.replace(/\\/+$/, \"\")}/.smithers-${stage}`\n const cacheStage = `${cache}/${stage}`\n const measured = yield* run(\"sh\", [\"-c\", measure, \"sh\", parent, shadow.path, beside, cache])\n yield* succeeded(measured, `Could not check out ${commit}`)\n const [target, inShadow, besideRoot, inCache] = measured.stdout.split(\"\\n\").map((line) => line.trim())\n const scratch = target === undefined \|\| target === \"\" \|\| target === inShadow\n ? undefined\n : target === besideRoot\n ? besideStage\n : target === inCache\n ? cacheStage\n : undefined\n const base = target === undefined \|\| target === \"\"\n ? undefined\n : target === inShadow\n ? shadow.path\n : scratch\n if (base === undefined) {\n const unwritable = besideRoot === \"unwritable\" ? \" (not writable by this user)\" : \"\"\n return yield* Effect.fail(\n failed(\n `Could not check out ${commit}: neither ${shadow.path} nor ${beside}${unwritable} nor ${\n cache === \"\" ? \"a cache directory\" : cache\n } is on the filesystem of ${parent}`\n )\n )\n }\n const staged = `${base}/${name}`\n const objects = relative(\n `${repository.toplevel}${host.slice(repository.root.length)}/.git/objects`,\n `${repository.common}/objects`\n )\n const write = Effect.gen(function() {\n const prepared = yield run(\"sh\", [\n \"-c\",\n [\n \"set -eC\",\n ...(scratch !== undefined ? [\"mkdir -m 700 -- \\\"$1\\\"\"] : []),\n \"mkdir -- \\\"$2\\\" \\\"$2/.git\\\" \\\"$2/.git/objects\\\" \\\"$2/.git/objects/info\\\" \\\"$2/.git/refs\\\"\",\n \"printf '%s\\\\n' \\\"$3\\\" > \\\"$2/.git/HEAD\\\"\",\n \"printf '%s\\\\n' \\\"$4\\\" > \\\"$2/.git/objects/info/alternates\\\"\",\n \"printf '%s' \\\"$5\\\" > \\\"$2/.git/config\\\"\"\n ].join(\"; \"),\n \"sh\",\n base,\n staged,\n commit,\n objects,\n checkoutConfig(repository)\n ])\n yield* succeeded(prepared, `Could not check out ${commit}`)\n const written = yield* shadow.git([\"read-tree\", \"--reset\", \"-u\", commit], staged)\n yield* succeeded(written, `Could not check out ${commit}`)\n const indexed = yield* run(\"sh\", [\n \"-c\",\n \"set -C; cat -- \\\"$1\\\" > \\\"$2\\\"\",\n \"sh\",\n `${shadow.path}/index`,\n `${staged}/.git/index`\n ])\n yield* succeeded(indexed, `Could not check out ${commit}`)\n const moved = yield* run(\"sh\", [\"-c\", publish, \"sh\", staged, parent, name, repository.root])\n yield* succeeded(moved, `Could not check out ${commit}`)\n })\n return yield* scratch !== undefined\n ? write.pipe(Effect.ensuring(remove(scratch).pipe(Effect.ignore)))\n : write\n })\n\nconst withDetachedWorktree = <A, E, R>(\n root: string,\n prefix: string,\n commit: string,\n use: (host: string) => Effect.Effect<A, E, R>\n): Effect.Effect<A, E \| StdError.StdError, R \| ChildProcessSpawner> =>\n Effect.gen(function() {\n // Allocate on execution, including when the same Effect is run twice.\n // Never remove an existing checkout: another call may still be using it.\n const host = `${root.replace(/\\/+$/, \"\")}/${prefix}-${globalThis.crypto.randomUUID()}`\n return yield Effect.acquireUseRelease(\n Effect.succeed(host),\n () =>\n Effect.gen(function() {\n yield withShadow(root, (shadow) => checkout(shadow, host, commit))\n return yield* use(host)\n }),\n // A checkout left behind is a stale copy of the repository inside the\n // workspace. Walks prune it, but the operator must still hear about it.\n () =>\n remove(host).pipe(\n Effect.catch((error) =>\n Effect.logWarning(\"could not remove a scratch checkout\").pipe(\n Effect.annotateLogs({ path: host, reason: error.message })\n )\n )\n )\n )\n })\n\n/*\n Internal Git operations used by both checkpoint and baseline leases.\n \n @category utilities\n * @since 1.0.0\n */\nexport const GitWorktree = { config, git, open, resolveCommit, withDetachedWorktree, withShadow }\n"]}

package/docs/concepts/flows-and-handlers.md CHANGED Viewed

@@ -46,14 +46,14 @@ import * as Read from "@smthrs/std/Read"
 import * as Schema from "effect/Schema"
 /** A step that reads a file. It declares what `read` declares. */
-export const ReadTarget = ({
+export const ReadTarget = {
   name: "read-target",
   input: Schema.Struct({ path: Schema.String }),
   output: Read.Output,
   capabilities: Read.capabilities,
   effects: Read.effects,
   flows: [Read.flow]
-})
+}
 ```
 A planner reading `ReadTarget` can see that the step reads and does not write,

package/docs/guides/run-a-shell-command.md CHANGED Viewed

@@ -88,6 +88,14 @@ The native CLI refuses named-container execution with `provider_unavailable`.
 An existing Docker daemon is outside its OS sandbox. Isolated providers are
 tracked in [#1790](https://github.com/smithersai/smithers/issues/1790).
+A host sealed to one container is the exception. `SMITHERS_BASH_CONTAINER` names
+the container, and `bash` and `test` then run in it through the `docker` CLI.
+Every other container, and a call that names none, fails with
+`outside_container`. The transport process runs outside the OS sandbox, which
+denies the daemon's socket, and receives the host's `DOCKER_HOST`,
+`DOCKER_CONTEXT`, `DOCKER_CONFIG`, `DOCKER_TLS_VERIFY`, and `DOCKER_CERT_PATH`,
+so it reaches a rootless daemon.
 The transport always goes through a login shell, because the images an agent
 meets activate the project's interpreter from `/etc/profile.d`. A program
 spawned directly by `docker exec` gets a different Python from the one that owns

package/docs/troubleshooting.md CHANGED Viewed

@@ -168,6 +168,11 @@ bound, or `Container.layerNoop` was.
 **What to change.** Bind `Container.layerCommand()` for the `docker` or `podman`
 CLI, or drop the `container` field and run the command on the host.
+The native CLI binds a transport only on a host sealed to one container: set
+`SMITHERS_BASH_CONTAINER` to the container `bash` and `test` may reach. An
+unsealed CLI host keeps refusing, because an existing Docker daemon is outside
+its OS sandbox.
 ## provider_unavailable: no test runner is declared
 **What happened.** `test` ran with `TestRunner.layerNoop` bound.

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@smthrs/std",
   "type": "module",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.5",
   "license": "MIT",
   "smthrs": {
     "group": "agent"
@@ -401,11 +401,11 @@
     "tag": "next"
   },
   "dependencies": {
-    "@smthrs/capability": "1.0.0-rc.3",
-    "@smthrs/control": "1.0.0-rc.3",
-    "@smthrs/core": "1.0.0-rc.3",
-    "@smthrs/kernel": "1.0.0-rc.3",
-    "@smthrs/model": "1.0.0-rc.3"
+    "@smthrs/capability": "1.0.0-rc.5",
+    "@smthrs/control": "1.0.0-rc.5",
+    "@smthrs/core": "1.0.0-rc.5",
+    "@smthrs/kernel": "1.0.0-rc.5",
+    "@smthrs/model": "1.0.0-rc.5"
   },
   "devDependencies": {
     "@effect/language-service": "0.87.2",

package/src/Bash.ts CHANGED Viewed

@@ -369,6 +369,18 @@ const plan = (input: Input): Plan | StdError.StdError => {
   }
 }
+/**
+ * The plan, refused when its input names no one invocation or when a hermetic
+ * call's paths fall outside its declared envelope. Spawned and terminal
+ * execution share this one check.
+ */
+const precheck = (input: Input, path: Path.Path): Plan | StdError.StdError => {
+  const intent = plan(input)
+  if (intent instanceof StdError.StdError || input.mode !== "hermetic") return intent
+  // A planned call carries exactly one of command or script.
+  return outsideEnvelope(input, input.command ?? input.script!, path) ?? intent
+}
 /** The plan as the host will spawn it, once the container transport has had it. */
 const routed = (
   plan: Plan,
@@ -378,7 +390,7 @@ const routed = (
   if (input.container === undefined) return Effect.succeed(plan)
   if (Option.isNone(transport)) return Effect.fail(Container.unavailable(input.container))
   return Effect.map(
-    transport.value.exec(request(plan, input)),
+    transport.value.exec(request(plan, input, input.container)),
     (routing): Plan => ({
       file: routing.file,
       args: routing.args,
@@ -411,8 +423,8 @@ const routed = (
  * still arrives on the inherited standard input and no argument is ever
  * re-parsed as shell text.
  */
-const request = (plan: Plan, input: Input): Container.Request => ({
-  container: input.container ?? "",
+const request = (plan: Plan, input: Input, container: string): Container.Request => ({
+  container,
   file: "bash",
   args: plan.args === undefined
     ? ["-lc", plan.file]
@@ -472,13 +484,8 @@ const fingerprint = (
 export const run = Effect.fn("Bash.run")(function*(
   input: Input
 ): Effect.fn.Return<Output, StdError.StdError, ChildProcessSpawner.ChildProcessSpawner | Path.Path> {
-  const path = yield* Path.Path
-  const intent = plan(input)
+  const intent = precheck(input, yield* Path.Path)
   if (intent instanceof StdError.StdError) return yield* Effect.fail(intent)
-  if (input.mode === "hermetic") {
-    const violation = outsideEnvelope(input, input.command ?? input.script ?? "", path)
-    if (violation !== undefined) return yield* Effect.fail(violation)
-  }
   // The working directory belongs to the container. The transport supplies
   // any environment overrides its host process needs to forward into it.
   const contained = input.container !== undefined
@@ -516,6 +523,57 @@ export const run = Effect.fn("Bash.run")(function*(
   }
 })
+/**
+ * What one call runs, after planning and before any transport: the program,
+ * its arguments (absent for a shell command line), standard input, the
+ * caller's environment, and the logical invocation as a person reads it.
+ *
+ * @category models
+ * @since 1.0.0
+ */
+export interface Invocation {
+  readonly file: string
+  readonly args: ReadonlyArray<string> | undefined
+  readonly stdin: string | undefined
+  readonly env: Record<string, string> | undefined
+  readonly quoted: string
+}
+/**
+ * The invocation `input` names, or the typed refusal explaining why it names
+ * none. The same plan {@link run} spawns; a terminal provider runs it instead.
+ *
+ * @category constructors
+ * @since 1.0.0
+ */
+export const invocation = (input: Input): Invocation | StdError.StdError => plan(input)
+/**
+ * {@link run}'s contract through a registered terminal (T-TRM-05): the same
+ * plan, hermetic pre-check, bounded output and diagnostics refresh, with
+ * execution supplied by `execute` instead of a spawn on this host. A terminal
+ * has no container transport, so a containerised call is refused before it
+ * reaches `execute`.
+ *
+ * @category handlers
+ * @since 1.0.0
+ */
+export const inTerminal = <R>(
+  execute: (input: Input) => Effect.Effect<Output, StdError.StdError, R>
+) =>
+  Effect.fn("Bash.inTerminal")(function*(
+    input: Input
+  ): Effect.fn.Return<Output, StdError.StdError, R | Path.Path> {
+    const intent = precheck(input, yield* Path.Path)
+    if (intent instanceof StdError.StdError) return yield* Effect.fail(intent)
+    if (input.container !== undefined) return yield* Effect.fail(Container.unavailable(input.container))
+    const output = yield* execute(input)
+    // The terminal ran on this workspace: files a language server holds may
+    // have changed, exactly as after a spawn here.
+    yield* Diagnostics.refresh
+    return output
+  })
 /**
  * The refusal a sealed host answers a call outside its container with.
  *

package/src/internal/GitWorktree.ts CHANGED Viewed

@@ -179,10 +179,28 @@ export interface Shadow {
     args: ReadonlyArray<string>,
     workTree?: string
   ) => Effect.Effect<Exec.ExecResult, StdError.StdError, ChildProcessSpawner>
-  /** Copies the workspace index into the shadow, so the shadow never writes the agent's own. */
+  /**
+   * Copies the workspace index into the shadow, with its modification time, so
+   * the shadow never writes the agent's own.
+   *
+   * The time is part of what git reads. It trusts an entry's recorded stat
+   * unless the entry is at least as new as the index file, in whole seconds;
+   * a copy stamped at the moment of copying made every entry look older, and a
+   * same-size edit from the second the index was written was recorded as the
+   * committed bytes (#3431). The time is taken before the bytes are read, so
+   * an index rewritten meanwhile leaves the copy looking older, never newer.
+   */
   readonly adoptIndex: Effect.Effect<void, StdError.StdError, ChildProcessSpawner>
 }
+/** The `adoptIndex` script: `$1` is the workspace index, `$2` the shadow's. */
+const adoptIndexScript = [
+  "set -C",
+  "if [ -e \"$1\" ]",
+  "then : > \"$2.at\" && touch -r \"$1\" -- \"$2.at\" && cat -- \"$1\" > \"$2\" && touch -r \"$2.at\" -- \"$2\" && rm -f -- \"$2.at\"",
+  "fi"
+].join("; ")
 const shadowOf = (repository: Repository, path: string): Shadow => ({
   path,
   repository,
@@ -200,7 +218,7 @@ const shadowOf = (repository: Repository, path: string): Shadow => ({
     ),
   adoptIndex: run("sh", [
     "-c",
-    "set -C; if [ -e \"$1\" ]; then cat -- \"$1\" > \"$2\"; fi",
+    adoptIndexScript,
     "sh",
     repository.index,
     `${path}/index`