autonomous-sdlc-harness 0.1.0

package/dist/generators/stateDir.js

@@ -0,0 +1,221 @@
+/**
+ * Generator: the run-artifact tree `init` materialises at the configured `stateDir`.
+ *
+ * **The rule this module exists to enforce: {@link STATE_DIR_ENTRIES} is the single declaration of
+ * which directories the tree has and which phase each one belongs to.** One row is one line, so a
+ * directory is added or gated by editing a row rather than by threading a condition through the
+ * writer, and `doctor` asks {@link selectedStateDirs} what should be there instead of re-deriving
+ * the list from its own copy. A second copy of this table anywhere is a copy that will drift.
+ *
+ * ## Three non-obvious choices, and where each comes from
+ *
+ * 1. **A phase that is off gets no directories at all.** An adopter who never runs the parity phase
+ *    has no reference implementation to compare against, so a `business_parity_*` directory in
+ *    their tree would be an empty slot they cannot fill and cannot tell from one the flow forgot to
+ *    write. Turning the phase on in `harness.config.json` and re-running `init` creates them, which
+ *    is why the omission is safe as well as tidy.
+ * 2. **The two ledgers are `create-if-absent` and are never truncated or rewritten.** They
+ *    accumulate over a project's whole life and are the only copy of that history — the write
+ *    engine's table says the same (`core/writer.ts`) — so a re-run leaves a ledger with content in
+ *    it byte-identical. This is the artifact where the re-run contract is not a nicety: an
+ *    overwrite here destroys a record nothing else holds.
+ * 3. **Templates are copied verbatim; there is no token substitution in this generator.** The
+ *    wrapper-script generator renders `{{token}}`s because a wrapper's body is a *detected* value;
+ *    nothing in this tree depends on one, and a README that named its own configured path would go
+ *    stale the moment the adopter moved the tree. A path a reader wants is read from the config.
+ *
+ * ## Scope this release
+ *
+ * This module is the **writer**, and what it writes out is a contract per directory: each README
+ * states what one file in its directory is and exactly how it is named, who writes it and who reads
+ * it by role, when it appears and when it is superseded, and the one mistake a reader would
+ * otherwise make. The tree's root README frames the set, and the two ledgers carry a worked example
+ * entry each. Every row here has a file at its final path and name, so revising a contract is an
+ * edit in place rather than a second layout.
+ *
+ * Four of this tree's directories are runtime surfaces whose *contents* are machine-local — the two
+ * the run daemon writes, the park-and-ask clarification channel, and the scratch directory an agent
+ * writes a probe file into — but which of them an ignore rule
+ * may cover is settled in the generator that writes the repository's ignore file
+ * (`generators/repoRoot.ts`), not here: a directory with a row in {@link STATE_DIR_ENTRIES} has a
+ * committed README and is therefore ignored **by its contents** with a negation for that file, because
+ * a whole-directory rule takes the README with it and no negation can bring it back. That generator
+ * reads this table to check the row still exists, so a directory removed on either side fails loudly
+ * rather than leaving a rule pointing at nothing.
+ */
+import { join } from 'node:path';
+import { DEFAULTS, STATE_DIR_DOT_PATTERN } from '../config/model.js';
+import { HarnessError } from '../core/errors.js';
+import { readTemplate } from '../core/paths.js';
+import { normalizeRepoDir } from '../core/repoPaths.js';
+/**
+ * Every directory of the run-artifact tree, in the order `init` writes it: the always-on set
+ * first, then the phase-gated ones grouped by phase.
+ *
+ * The set comes from the artifact families the flow actually writes — one directory per family,
+ * with the per-item findings directories kept separate from the reviews they re-check, because the
+ * two have different writers and different readers.
+ */
+export const STATE_DIR_ENTRIES = Object.freeze([
+    // Always written.
+    Object.freeze({ dir: 'task_prompts' }),
+    Object.freeze({ dir: 'story_plans' }),
+    Object.freeze({ dir: 'task_plans' }),
+    Object.freeze({ dir: 'code_reviews' }),
+    Object.freeze({ dir: 'task_plan_reviews' }),
+    Object.freeze({ dir: 'task_plan_point_reviews' }),
+    Object.freeze({ dir: 'review_plan_reviews' }),
+    Object.freeze({ dir: 'review_plan_point_reviews' }),
+    Object.freeze({ dir: 'skeptic_reviews' }),
+    Object.freeze({ dir: 'skeptic_review_plan_reviews' }),
+    Object.freeze({ dir: 'skeptic_review_point_reviews' }),
+    Object.freeze({ dir: 'architecture_reviews' }),
+    Object.freeze({ dir: 'architecture_branch_reviews' }),
+    Object.freeze({ dir: 'architecture_branch_review_point_reviews' }),
+    Object.freeze({ dir: 'architecture_user_review_reviews' }),
+    Object.freeze({ dir: 'user_reviews' }),
+    Object.freeze({ dir: 'user_review_fix_plan_point_reviews' }),
+    Object.freeze({ dir: 'flow_progress' }),
+    Object.freeze({ dir: 'branch_statistics' }),
+    Object.freeze({ dir: 'autonomous_inbox' }),
+    Object.freeze({ dir: 'autonomous_logs' }),
+    Object.freeze({ dir: 'clarifications' }),
+    // The fourth of the runtime surfaces whose contents are machine-local, and the reason it sits with
+    // the three above rather than under a phase: an implementer or a reviewer in *any* phase may need
+    // to run a probe, so gating it would take the capability away from the phases that ask for it most.
+    Object.freeze({ dir: 'scratch' }),
+    Object.freeze({ dir: 'improvement_observations' }),
+    Object.freeze({ dir: 'clarification_digests' }),
+    Object.freeze({ dir: 'dispatch_additions' }),
+    // The interactive-test phase.
+    Object.freeze({ dir: 'qa_reviews', phase: 'qa' }),
+    Object.freeze({ dir: 'qa_review_point_reviews', phase: 'qa' }),
+    Object.freeze({ dir: 'ui_test_plans', phase: 'qa' }),
+    Object.freeze({ dir: 'ui_test_plan_reviews', phase: 'qa' }),
+    // The documentation phase.
+    Object.freeze({ dir: 'docs_catalog', phase: 'docs' }),
+    // The reference-implementation-parity phase.
+    Object.freeze({ dir: 'business_parity_reviews', phase: 'parity' }),
+    Object.freeze({ dir: 'business_parity_branch_reviews', phase: 'parity' }),
+    Object.freeze({ dir: 'business_parity_branch_review_point_reviews', phase: 'parity' }),
+    Object.freeze({ dir: 'business_parity_user_review_reviews', phase: 'parity' }),
+]);
+/**
+ * The long-lived ledgers at the root of the tree, which are files rather than directories and are
+ * written whatever the phases are.
+ */
+export const STATE_DIR_LEDGERS = Object.freeze(['lessons.md', 'improvement_suggestions.md']);
+/** The templates' subdirectory under `cli/templates/`, addressed as {@link readTemplate} wants it. */
+const TEMPLATE_DIR = 'state-dir';
+/** The per-directory contract file, in the template tree and in the adopter's tree alike. */
+const README_FILENAME = 'README.md';
+/**
+ * The template for the tree's own top-level README.
+ *
+ * Named apart from the per-directory ones because `templates/state-dir/README.md` already describes
+ * the *template* directory to a reader of this repository, and is not written to an adopter.
+ */
+const ROOT_README_TEMPLATE = 'README-root.md';
+/**
+ * Re-assert the two things `stateDir` must be before a single directory is enqueued under it.
+ *
+ * The schema checks both and so does `config/check.ts`, and this checks them **again** deliberately:
+ * a config can be hand-edited between the run that validated it and this one, and by the time a
+ * dot-named tree has been created the failure is invisible — an unattended run may not be permitted
+ * to write beneath a dot-path at all, and it reports success with no artifacts to show for it. That is a condition the adopter fixes by editing one key, so it carries the default
+ * exit code rather than the internal one.
+ *
+ * The check runs against the **raw** configured value rather than the normalised one: normalising
+ * strips a leading `./`, which is itself a dot segment the rule refuses.
+ */
+function assertWritableStateDir(raw) {
+    if (STATE_DIR_DOT_PATTERN.test(raw)) {
+        throw new HarnessError(`stateDir is ${JSON.stringify(raw)}, which has a path segment starting with '.': the run-artifact tree must not be dot-named or reach through a dot segment, because it has to be writable by an unattended run and a dot-path is where a host reserves directories an unattended run may not write to — measured for .claude/**, where such a run completes with exit 0 having written nothing. Set stateDir in harness.config.json to a name without a leading dot; do not "fix" it back to a dot-name`);
+    }
+    const normalized = normalizeRepoDir(raw.trim());
+    if (normalized === '.' || normalized === '') {
+        throw new HarnessError(`stateDir is ${JSON.stringify(raw)}, which names the repository root rather than a directory in it: the run-artifact tree is a directory of its own, and writing it at the root would scatter the flow's artifact directories through the repository. Set stateDir in harness.config.json to a directory name`);
+    }
+    return normalized;
+}
+/** Whether a phase is on. Absent phases are off, which is the schema's default for all three. */
+function phaseEnabled(phases, phase) {
+    return phases?.[phase] === true;
+}
+/**
+ * The directories that belong in the tree for a given set of phases, in table order.
+ *
+ * Exported so `doctor` reports a missing directory against the same list `init` writes, rather than
+ * against a second copy of it that can disagree.
+ */
+export function selectedStateDirs(phases) {
+    return STATE_DIR_ENTRIES.filter((entry) => entry.phase === undefined || phaseEnabled(phases, entry.phase));
+}
+/**
+ * Enqueue the run-artifact tree: `ensure-dir` for the root and for every selected directory, and
+ * `create-if-absent` for the tree's README, each directory's README and both ledgers.
+ *
+ * `ensure-dir` is the whole of the directory contract — it is idempotent by construction, so a
+ * second `init` reports the tree as ensured and changes nothing, and it never removes a directory
+ * an adopter added. `create-if-absent` is the contract for every file here: the READMEs because the
+ * adopter may have rewritten a contract sentence to match how their team uses the directory, and
+ * the ledgers because they accumulate and an overwrite would destroy history.
+ *
+ * The two differ in what `--force` may do to them. A README is template content, so `--force`
+ * replaces one after the write engine has taken a `.bak`, and the adopter's sentence is a `.bak`
+ * away. **The ledgers are outside `--force` entirely** (`forceOverride: 'never'`): nothing can
+ * re-derive an accumulating ledger, and the engine's `.bak` is single-generation — it is
+ * overwritten rather than chained — so "recoverable" would only ever have meant "recoverable until
+ * the next forced run". `--force` is an operation this CLI's own remedy messages routinely send an
+ * adopter to, so a ledger has to survive it however many times it is run.
+ *
+ * Nothing here touches the filesystem: the generator plans, and `init` applies the plan once.
+ */
+export function writeStateDir({ repoRoot, config, plan }) {
+    const stateDir = assertWritableStateDir(config.stateDir ?? DEFAULTS.stateDir);
+    const root = join(repoRoot, stateDir);
+    const directories = [];
+    const skipped = [];
+    const notes = [];
+    plan.add({ path: root, policy: 'ensure-dir', label: 'run-artifact tree' });
+    plan.add({
+        path: join(root, README_FILENAME),
+        policy: 'create-if-absent',
+        content: readTemplate(`${TEMPLATE_DIR}/${ROOT_README_TEMPLATE}`),
+        label: 'run-artifact tree README',
+    });
+    for (const ledger of STATE_DIR_LEDGERS) {
+        plan.add({
+            path: join(root, ledger),
+            policy: 'create-if-absent',
+            content: readTemplate(`${TEMPLATE_DIR}/${ledger}`),
+            label: `ledger ${ledger}`,
+            // Outside `--force` entirely (`core/writer.ts`'s `WriteRequest.forceOverride`), and for the
+            // same reason `harness.config.json` is: an accumulating ledger has no derivable content to
+            // regenerate, so an overwrite is pure loss — and the engine's `.bak` is single-generation, so
+            // a second forced run takes the history with it. `--force` is an operation this CLI's own
+            // remedy messages send an adopter to, so it has to be safe to run twice.
+            forceOverride: 'never',
+        });
+    }
+    for (const entry of STATE_DIR_ENTRIES) {
+        const relative = `${stateDir}/${entry.dir}`;
+        if (entry.phase !== undefined && !phaseEnabled(config.phases, entry.phase)) {
+            skipped.push(relative);
+            continue;
+        }
+        plan.add({ path: join(root, entry.dir), policy: 'ensure-dir', label: `artifact directory ${entry.dir}` });
+        plan.add({
+            path: join(root, entry.dir, README_FILENAME),
+            policy: 'create-if-absent',
+            content: readTemplate(`${TEMPLATE_DIR}/${entry.dir}/${README_FILENAME}`),
+            label: `artifact directory README ${entry.dir}`,
+        });
+        directories.push(relative);
+    }
+    if (skipped.length > 0) {
+        notes.push(`${skipped.length} artifact ${skipped.length === 1 ? 'directory belongs' : 'directories belong'} to a phase that is off, so ${skipped.length === 1 ? 'it was' : 'they were'} not created: turn the phase on in harness.config.json and re-run init to add ${skipped.length === 1 ? 'it' : 'them'}`);
+    }
+    return { stateDir, root, directories, skipped, notes };
+}
+//# sourceMappingURL=stateDir.js.map

package/dist/generators/stateDir.js.map

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

package/dist/machine/paths.js

@@ -0,0 +1,111 @@
+/**
+ * The machine-local directories this CLI addresses, resolved once: its own two, and the agent
+ * runner's configuration home.
+ *
+ * **The rule this module exists to enforce: the environment variables that move any of them are read
+ * here and nowhere else in the CLI.**
+ * `grep -rn 'XDG_STATE_HOME\|XDG_CONFIG_HOME\|CLAUDE_CONFIG_DIR' cli/src` answers with this file
+ * alone, which is the property that makes the resolution correctable in one place — a second reader
+ * would be a second answer, and the two would disagree exactly on the machines whose environment is
+ * not the default one.
+ *
+ * ## Three things this module is careful about
+ *
+ * 1. **It addresses the usage lane's directory; it never re-defines it.** {@link machineStateDir}
+ *    is the same directory `docs/watcher.md` §5 publishes as the home of `usage-state.json` and
+ *    `run-lane.lock/`, and that section is the format of record for both artifacts. Nothing here
+ *    describes their shape, their merge rule or their lock protocol: a TypeScript consumer reads
+ *    them there, and this module only says where the directory is.
+ * 2. **The resolution matches the shell half byte for byte**, because the two halves address one
+ *    directory on one machine: `hr_lane_dir()` in the generated `lib/harness-run-lib.sh` reads
+ *    `XDG_STATE_HOME`, falls back to `$HOME/.local/state` when it is **unset or empty**, strips one
+ *    trailing slash, and appends {@link MACHINE_DIR_NAME}. So does {@link resolveMachineDir}, with
+ *    `homeRoot()` — `core/paths.ts`'s single definition of the account home — standing in for
+ *    `$HOME`. A variable holding a relative path yields a relative directory here exactly as it
+ *    does there. Only a target on a `WritePlan` is refused for that, and of these two directories
+ *    the one that goes on a plan is {@link machineConfigDir} — `generators/notifications.ts`
+ *    enqueues it under `allowOutsideRepo`. `machine/registry.ts` writes {@link machineStateDir}
+ *    directly, so a relative base there lands under the process's working directory.
+ * 3. **A read never creates any of these directories.** Every function here is pure string
+ *    resolution — nothing touches the filesystem — so a `doctor` check or any other reader can ask
+ *    where a file would be without bringing its directory into existence. Creation belongs to a
+ *    writer, and a writer creates it at {@link MACHINE_DIR_MODE}: these directories hold an
+ *    account's push credential and its cross-repository run state, neither of which is another
+ *    account's to read. {@link claudeHome} is the one directory here **no** part of this CLI
+ *    creates or writes into at all — it is the agent runner's, and this CLI only reads from it.
+ */
+import { homeRoot } from '../core/paths.js';
+/**
+ * The one directory name both machine-local trees carry, under whichever base applies.
+ *
+ * It is the package name, and it is shared with the shell half's `hr_lane_dir`. Changing it here
+ * without changing it there would leave two components each believing they hold the machine.
+ */
+export const MACHINE_DIR_NAME = 'autonomous-sdlc-harness';
+/**
+ * The mode a writer creates either directory at: the owner's, and nobody else's.
+ *
+ * The same `0700` the shell half applies with an explicit `chmod` after its `mkdir -p`, and for
+ * the same reason — the mode argument of a directory creation is masked by the process umask and
+ * does nothing at all for a directory that already exists, so it is applied as its own step.
+ */
+export const MACHINE_DIR_MODE = 0o700;
+/**
+ * `<base>/autonomous-sdlc-harness` for one XDG base variable and its fallback, in the shell half's
+ * exact order: the variable when it holds something, the fallback under {@link homeRoot} otherwise,
+ * then one trailing slash stripped.
+ *
+ * The result is joined with a literal separator rather than through `path.join`, which would
+ * normalise a base of `/` into a relative result — the one input where the two spellings differ,
+ * and the shell half's answer is the absolute one.
+ */
+function resolveMachineDir(variable, fallback) {
+    const configured = process.env[variable];
+    const base = configured === undefined || configured === '' ? `${homeRoot()}/${fallback}` : configured;
+    const stripped = base.endsWith('/') ? base.slice(0, -1) : base;
+    return `${stripped}/${MACHINE_DIR_NAME}`;
+}
+/**
+ * The machine-local **state** directory — `${XDG_STATE_HOME:-$HOME/.local/state}/autonomous-sdlc-harness`.
+ *
+ * What lives in it is machine-scoped run state that no single repository owns: the usage lane's two
+ * artifacts, published by `docs/watcher.md` §5, and the registry of initialized repositories, which
+ * that section is explicit is a different artifact defined elsewhere.
+ */
+export function machineStateDir() {
+    return resolveMachineDir('XDG_STATE_HOME', '.local/state');
+}
+/**
+ * The machine-local **configuration** directory — `${XDG_CONFIG_HOME:-$HOME/.config}/autonomous-sdlc-harness`.
+ *
+ * What lives in it is an operator's own settings rather than a repository's: `docs/watcher.md` §6's
+ * `push.env` is the one file this release puts there, and it comes first in that section's
+ * precedence because a push credential belongs to a person and a machine rather than to a checkout.
+ */
+export function machineConfigDir() {
+    return resolveMachineDir('XDG_CONFIG_HOME', '.config');
+}
+/**
+ * The environment variable that relocates the agent runner's configuration home, and the directory
+ * name it falls back to under {@link homeRoot}.
+ */
+const CLAUDE_HOME_VARIABLE = 'CLAUDE_CONFIG_DIR';
+const CLAUDE_HOME_FALLBACK = '.claude';
+/**
+ * The **agent runner's** configuration home — `${CLAUDE_CONFIG_DIR:-$HOME/.claude}`.
+ *
+ * Not this CLI's directory and never written to: what it holds that the CLI reads is the record of
+ * which plugins are installed and where (`machine/plugins.ts`), which is the one machine-local fact
+ * `init` cannot generate an answer for. It is resolved here rather than beside that reader for the
+ * module rule above — one home for the variable, so a scratch home an operator or a test points the
+ * runner at moves every reader with it instead of half of them.
+ *
+ * Same three properties as the two directories above: the variable when it holds something, the
+ * fallback otherwise, one trailing slash stripped, and no filesystem touch.
+ */
+export function claudeHome() {
+    const configured = process.env[CLAUDE_HOME_VARIABLE];
+    const base = configured === undefined || configured === '' ? `${homeRoot()}/${CLAUDE_HOME_FALLBACK}` : configured;
+    return base.endsWith('/') ? base.slice(0, -1) : base;
+}
+//# sourceMappingURL=paths.js.map

package/dist/machine/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/machine/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACtG,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,OAAO,GAAG,QAAQ,IAAI,gBAAgB,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,iBAAiB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,iBAAiB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACjD,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,IAAI,GACR,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACvG,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/machine/plugins.js

@@ -0,0 +1,224 @@
+/**
+ * Where this harness's plugin lives on **this** machine — both roots of it — read from the records
+ * the agent runner keeps.
+ *
+ * **The rule this module exists to enforce: the plugin's roots are resolved here and nowhere else in
+ * the CLI, and each is re-derived on every call.** The install root carries the plugin's version in
+ * its path, so a value written down once — into a generated permission entry, into a document —
+ * stops being true at the next plugin upgrade while still looking right. A caller that wants a root
+ * asks for it now; nothing here caches, and nothing here may be persisted.
+ *
+ * **Why there are two.** A helper named in an **instruction file** arrives as bytes and the agent
+ * resolves the root itself; a helper named in an **agent definition body** has `${CLAUDE_PLUGIN_ROOT}`
+ * substituted by the runtime. On a `directory`-sourced marketplace those two were measured to differ
+ * (2026-08-26): the runtime substituted `<installLocation>/plugin` — the live source tree — while
+ * `installPath` named a version-pinned cache snapshot. So {@link pluginInstallRoot} answers "where
+ * the runner installed it" and {@link pluginRuntimeRoot} answers "what the runtime substitutes",
+ * and on a git-sourced marketplace the two collapse to one directory.
+ *
+ * The files are the **agent runner's**, not this CLI's, both under {@link claudeHome}'s `plugins/`:
+ * `installed_plugins.json` for the install root, and `known_marketplaces.json` — plus the
+ * `.claude-plugin/marketplace.json` its `installLocation` points at — for the runtime root. Two
+ * consequences follow and both are deliberate.
+ *
+ * 1. **They are read-only, always.** No function here writes, creates a directory, or repairs
+ *    anything. A format this CLI does not recognise is the runner's to change and not ours to
+ *    correct.
+ * 2. **Their shape is navigated, not validated.** `version` is read past rather than pinned: a bump
+ *    that adds a field would otherwise turn every working machine into a finding. Only the fields a
+ *    root is navigated for are looked at, and they are checked where they are used: `installPath`
+ *    on a plugin row, and `source.source` plus `installLocation` on a marketplace entry together
+ *    with the plugin `source` in the manifest that entry locates. That is the opposite of
+ *    `machine/registry.ts`'s `schema` handling, and the reason is ownership: that file is this
+ *    CLI's own and a version it does not know means a newer CLI wrote it, while these belong to
+ *    another program that may change them at any release.
+ *
+ * **Every failure is `undefined`, never a throw** — file absent, unreadable, unparseable, key
+ * absent, no usable row. A machine where the plugin is not installed is an answer a caller has
+ * something correct to do with, which is the discipline `core/git.ts`'s `hasCommits` states for the
+ * same reason: the one consumer is a `doctor` check, and "not installed" is a state it reports. It
+ * is also why {@link pluginRuntimeRoot} falls back to the install root rather than throwing on a
+ * record it cannot navigate.
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { isJsonObject, readJsonFile } from '../core/json.js';
+import { MARKETPLACE_NAME, PLUGIN_KEY, PLUGIN_NAME } from '../generators/projectSettings.js';
+import { claudeHome } from './paths.js';
+/** The runner's plugin directory under {@link claudeHome}, and the two records inside it. */
+const PLUGINS_DIRNAME = 'plugins';
+const INSTALLED_PLUGINS_FILENAME = 'installed_plugins.json';
+const KNOWN_MARKETPLACES_FILENAME = 'known_marketplaces.json';
+/** The object keying every installed plugin's rows, and the fields one row is selected on. */
+const PLUGINS_KEY = 'plugins';
+const INSTALL_PATH_FIELD = 'installPath';
+const SCOPE_FIELD = 'scope';
+const PROJECT_PATH_FIELD = 'projectPath';
+/** The marketplace entry's own fields, and the source type whose install location is a live tree. */
+const SOURCE_FIELD = 'source';
+const DIRECTORY_SOURCE = 'directory';
+const INSTALL_LOCATION_FIELD = 'installLocation';
+/** The marketplace manifest inside an install location, and the field one plugin entry is found by. */
+const MARKETPLACE_MANIFEST_DIRNAME = '.claude-plugin';
+const MARKETPLACE_MANIFEST_FILENAME = 'marketplace.json';
+const NAME_FIELD = 'name';
+/**
+ * The directory of helper scripts inside an install root — the segment {@link pluginScriptsDir}
+ * joins, and the one a reader outside this module recognises a helper path by. Exported so that
+ * reader imports it instead of keeping a second copy: a copy of a literal is a copy that can drift,
+ * and reading the name resolves no plugin and touches no filesystem.
+ */
+export const SCRIPTS_DIRNAME = 'scripts';
+/** The suffix a helper script is named with. */
+const SCRIPT_SUFFIX = '.sh';
+/** The record's absolute path. A pure string: asking where it is never creates anything. */
+export function installedPluginsPath() {
+    return join(claudeHome(), PLUGINS_DIRNAME, INSTALLED_PLUGINS_FILENAME);
+}
+/** The marketplace register's absolute path, resolved the same pure way. */
+export function knownMarketplacesPath() {
+    return join(claudeHome(), PLUGINS_DIRNAME, KNOWN_MARKETPLACES_FILENAME);
+}
+/** One row's install root, or `undefined` when the row is not one or does not carry a usable path. */
+function installPathOf(row) {
+    if (!isJsonObject(row))
+        return undefined;
+    const value = row[INSTALL_PATH_FIELD];
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+/** Whether a row was installed at the given scope. */
+function atScope(row, scope) {
+    return isJsonObject(row) && row[SCOPE_FIELD] === scope;
+}
+/**
+ * The install root of this harness's plugin, or `undefined` when this machine has none.
+ *
+ * **The selection rule, in order**, because one plugin carries a row per scope it was enabled at and
+ * they can name different versions:
+ *
+ * 1. a `project`-scope row whose `projectPath` is `repoRoot` — the row describing *this* repository,
+ *    which is the one a run started here resolves the plugin through;
+ * 2. failing that, a `user`-scope row — enabled once for the account, so it applies here too;
+ * 3. failing that, the first row carrying a usable `installPath`, so a scope this CLI has not been
+ *    taught yet still yields an answer rather than a false "not installed".
+ *
+ * `repoRoot` is optional so a caller with no repository can still ask; it then starts at step 2.
+ */
+export function pluginInstallRoot(repoRoot) {
+    let parsed;
+    try {
+        parsed = readJsonFile(installedPluginsPath());
+    }
+    catch {
+        return undefined;
+    }
+    if (!isJsonObject(parsed))
+        return undefined;
+    const plugins = parsed[PLUGINS_KEY];
+    if (!isJsonObject(plugins))
+        return undefined;
+    const rows = plugins[PLUGIN_KEY];
+    if (!Array.isArray(rows))
+        return undefined;
+    const usable = rows.filter((row) => installPathOf(row) !== undefined);
+    const here = repoRoot === undefined
+        ? undefined
+        : usable.find((row) => atScope(row, 'project') && isJsonObject(row) && row[PROJECT_PATH_FIELD] === repoRoot);
+    return installPathOf(here ?? usable.find((row) => atScope(row, 'user')) ?? usable[0]);
+}
+/**
+ * The root the **runtime** substitutes for `${CLAUDE_PLUGIN_ROOT}`, or the install root when this
+ * machine gives no reason to think they differ.
+ *
+ * **The one case where they differ is a `directory`-sourced marketplace.** The runner reads such a
+ * marketplace's manifest in place — `known_marketplaces.json` gives the entry an `installLocation`
+ * equal to the source tree — while still installing the plugin as a version-pinned snapshot under
+ * `installPath`. Measured 2026-08-26 on `claude` 2.1.246: a sub-agent's `${CLAUDE_PLUGIN_ROOT}`
+ * resolved to `<installLocation>/<the manifest's plugin source>`, not to `installPath`. So the
+ * derivation is the runner's own two records, in order: the marketplace entry for the location, and
+ * the manifest at that location for this plugin's relative `source`.
+ *
+ * **Anything else collapses to {@link pluginInstallRoot}** — a git source, an entry this CLI cannot
+ * navigate, a manifest that does not name this plugin, a `source` that is not a relative path
+ * string. A git-sourced adopter therefore gets one root, which is correct: there the two are the
+ * same directory. `repoRoot` is passed through to the fallback and is otherwise unused.
+ */
+export function pluginRuntimeRoot(repoRoot) {
+    const fallback = () => pluginInstallRoot(repoRoot);
+    let parsed;
+    try {
+        parsed = readJsonFile(knownMarketplacesPath());
+    }
+    catch {
+        return fallback();
+    }
+    if (!isJsonObject(parsed))
+        return fallback();
+    const entry = parsed[MARKETPLACE_NAME];
+    if (!isJsonObject(entry))
+        return fallback();
+    const source = entry[SOURCE_FIELD];
+    if (!isJsonObject(source) || source[SOURCE_FIELD] !== DIRECTORY_SOURCE)
+        return fallback();
+    const location = entry[INSTALL_LOCATION_FIELD];
+    if (typeof location !== 'string' || location === '')
+        return fallback();
+    let manifest;
+    try {
+        manifest = readJsonFile(join(location, MARKETPLACE_MANIFEST_DIRNAME, MARKETPLACE_MANIFEST_FILENAME));
+    }
+    catch {
+        return fallback();
+    }
+    if (!isJsonObject(manifest))
+        return fallback();
+    const plugins = manifest[PLUGINS_KEY];
+    if (!Array.isArray(plugins))
+        return fallback();
+    const row = plugins.find((candidate) => isJsonObject(candidate) && candidate[NAME_FIELD] === PLUGIN_NAME);
+    const relative = isJsonObject(row) ? row[SOURCE_FIELD] : undefined;
+    if (typeof relative !== 'string' || relative === '')
+        return fallback();
+    return join(location, relative);
+}
+/**
+ * The helper scripts shipped inside an install root, by filename, in codepoint order.
+ *
+ * **Read from the directory rather than listed here**, and that is the point: the names are declared
+ * once, in the plugin's own `scripts/README.md`, and a copy in the CLI would be a second declaration
+ * that drifts the first time a helper is added or renamed. Sorted so one machine reports them the
+ * same way twice, whatever order the filesystem enumerates in.
+ *
+ * An unreadable or absent directory is an empty list, for the module header's reason: it is the
+ * runner's tree, and a caller grades what it found rather than being stopped by what it did not.
+ */
+export function pluginHelperScripts(installRoot) {
+    const dir = pluginScriptsDir(installRoot);
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    return names
+        .filter((name) => name.endsWith(SCRIPT_SUFFIX))
+        .filter((name) => {
+        try {
+            return statSync(join(dir, name)).isFile();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+/** `<installRoot>/scripts` — the directory {@link pluginHelperScripts} enumerates. */
+export function pluginScriptsDir(installRoot) {
+    return join(installRoot, SCRIPTS_DIRNAME);
+}
+/** `<installRoot>/scripts/<name>` — the path a helper is invoked by, joined here and nowhere else. */
+export function pluginHelperPath(installRoot, name) {
+    return join(pluginScriptsDir(installRoot), name);
+}
+//# sourceMappingURL=plugins.js.map

package/dist/machine/plugins.js.map

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