@paysdoc/devplatform 1.0.0

package/dist/git/processCleanup.js

@@ -0,0 +1,45 @@
+/**
+ * Process cleanup utility for the GitContext package.
+ * Kills processes that have open files in a given directory.
+ * Self-contained — no git/gh, no ADW core imports.
+ */
+import { execSync } from 'child_process';
+export function killProcessesInDirectory(directoryPath) {
+    try {
+        const output = execSync(`lsof +D "${directoryPath}" -t`, { encoding: 'utf-8' });
+        const pids = output
+            .split('\n')
+            .map((line) => parseInt(line.trim(), 10))
+            .filter((pid) => !isNaN(pid) && pid !== process.pid);
+        if (pids.length === 0)
+            return;
+        pids.forEach((pid) => {
+            try {
+                process.kill(pid, 'SIGTERM');
+            }
+            catch { /* already exited */ }
+        });
+        execSync('sleep 0.5', { stdio: 'pipe' });
+        const survivors = pids.filter((pid) => {
+            try {
+                process.kill(pid, 0);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+        if (survivors.length > 0) {
+            survivors.forEach((pid) => {
+                try {
+                    process.kill(pid, 'SIGKILL');
+                }
+                catch { /* already exited */ }
+            });
+        }
+    }
+    catch {
+        // lsof not available or no processes found — proceed silently
+    }
+}
+//# sourceMappingURL=processCleanup.js.map

package/dist/git/processCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processCleanup.js","sourceRoot":"","sources":["../../src/git/processCleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,wBAAwB,CAAC,aAAqB;IAC5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,aAAa,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM;aAChB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;aACxC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE9B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/git/remoteOps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Package-private remote-interaction and merge op module for GitContext.
+ * Handles fetch from origin, ls-remote queries, merge a ref, and abort
+ * an in-progress merge.
+ *
+ * All functions propagate errors except abortMerge (which swallows them
+ * because aborting with no merge in progress is a benign no-op).
+ */
+type Runner = (command: string, cwd: string) => string;
+declare function fetchRemote(run: Runner, branch: string, cwd: string): string;
+declare function mergeBranch(run: Runner, ref: string, cwd: string, opts?: {
+    noCommit?: boolean;
+    noFf?: boolean;
+    noEdit?: boolean;
+}): void;
+declare function abortMerge(run: Runner, cwd: string): void;
+declare function lsRemote(run: Runner, branch: string, cwd: string): string;
+export declare const remoteOps: {
+    fetchRemote: typeof fetchRemote;
+    mergeBranch: typeof mergeBranch;
+    abortMerge: typeof abortMerge;
+    lsRemote: typeof lsRemote;
+};
+export {};
+//# sourceMappingURL=remoteOps.d.ts.map

package/dist/git/remoteOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteOps.d.ts","sourceRoot":"","sources":["../../src/git/remoteOps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvD,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,iBAAS,WAAW,CAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAClE,IAAI,CAON;AAED,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,iBAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,eAAO,MAAM,SAAS;;;;;CAAqD,CAAC"}

package/dist/git/remoteOps.js

@@ -0,0 +1,30 @@
+/**
+ * Package-private remote-interaction and merge op module for GitContext.
+ * Handles fetch from origin, ls-remote queries, merge a ref, and abort
+ * an in-progress merge.
+ *
+ * All functions propagate errors except abortMerge (which swallows them
+ * because aborting with no merge in progress is a benign no-op).
+ */
+function fetchRemote(run, branch, cwd) {
+    return run(`git fetch origin "${branch}"`, cwd);
+}
+function mergeBranch(run, ref, cwd, opts = {}) {
+    const flags = [
+        opts.noCommit && '--no-commit',
+        opts.noFf && '--no-ff',
+        opts.noEdit && '--no-edit',
+    ].filter(Boolean).join(' ');
+    run(flags ? `git merge ${flags} "${ref}"` : `git merge "${ref}"`, cwd);
+}
+function abortMerge(run, cwd) {
+    try {
+        run('git merge --abort', cwd);
+    }
+    catch { /* no merge in progress — ignore */ }
+}
+function lsRemote(run, branch, cwd) {
+    return run(`git ls-remote origin "${branch}"`, cwd);
+}
+export const remoteOps = { fetchRemote, mergeBranch, abortMerge, lsRemote };
+//# sourceMappingURL=remoteOps.js.map

package/dist/git/remoteOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteOps.js","sourceRoot":"","sources":["../../src/git/remoteOps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,SAAS,WAAW,CAAC,GAAW,EAAE,MAAc,EAAE,GAAW;IAC3D,OAAO,GAAG,CAAC,qBAAqB,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAClB,GAAW,EACX,GAAW,EACX,GAAW,EACX,OAAiE,EAAE;IAEnE,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,QAAQ,IAAI,aAAa;QAC9B,IAAI,CAAC,IAAI,IAAI,SAAS;QACtB,IAAI,CAAC,MAAM,IAAI,WAAW;KAC3B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,KAAK,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,GAAW;IAC1C,IAAI,CAAC;QACH,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC,CAAC,mCAAmC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAc,EAAE,GAAW;IACxD,OAAO,GAAG,CAAC,yBAAyB,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC"}

package/dist/git/repoWorkspace.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Target repository workspace management — absorbed into the gitContext package (issue #700).
+ *
+ * Handles workspace path resolution, cloning, and fetching for external target
+ * repositories. Structurally exempt from the guard (adws/gitContext/ directory).
+ *
+ * All ADW-global config (TARGET_REPOS_DIR) is injected at the shim boundary in
+ * targetRepoManager.ts; this module stays ADW-global-free for standalone reuse.
+ * The `defaultBranch` thunk is injected so the caller can bind a veracious
+ * forge credential rather than relying on ambient auth.
+ *
+ * The caller supplies a ready-made clone URL (issue #793, PRD story 14): this
+ * module clones exactly the URL it is handed, with no rewriting and no forge
+ * vocabulary. The GitHub HTTPS→SSH rewrite lives in the adapter
+ * (`adws/providers/github/cloneUrl.ts`) and is applied by the ADW wiring
+ * shim (`adws/core/targetRepoManager.ts`) before this module is called.
+ */
+import type { ExecSyncOptions } from 'child_process';
+import * as fs from 'fs';
+import type { Logger } from './types.js';
+/** Minimal exec seam shared by clone and fetch operations. */
+export type WorkspaceExecFn = (cmd: string, opts: {
+    cwd?: string;
+    stdio?: ExecSyncOptions['stdio'];
+    encoding?: string;
+}) => void;
+export interface EnsureRepoWorkspaceDeps {
+    /** Absolute path to the directory housing cloned target repos (injected from ADW env). */
+    targetReposDir: string;
+    /** Returns the default branch name, run under per-command veracious auth. */
+    getDefaultBranch: () => string;
+    /** Override for hermetic tests; defaults to execSync. */
+    exec?: WorkspaceExecFn;
+    /** Override for hermetic tests; defaults to real fs. */
+    fsDeps?: Pick<typeof fs, 'existsSync' | 'mkdirSync'>;
+    /** Log function; defaults to no-op (tests control verbosity). */
+    log?: Logger;
+}
+/**
+ * Returns the workspace path for a target repository.
+ * Format: `targetReposDir/{owner}/{repo}`
+ * `targetReposDir` is injected — never reads TARGET_REPOS_DIR directly.
+ */
+export declare function getTargetRepoWorkspacePath(owner: string, repo: string, targetReposDir: string): string;
+/** Returns true if a `.git` directory exists at workspacePath. */
+export declare function isRepoCloned(workspacePath: string, fsDeps?: Pick<typeof fs, 'existsSync'>): boolean;
+/**
+ * Clones a repository into workspacePath. Clones exactly the URL it is
+ * given (issue #793) — no rewriting, no scheme translation. The caller
+ * (`adws/core/targetRepoManager.ts`) is responsible for handing this
+ * function a ready-made clone URL.
+ */
+export declare function cloneRepo(cloneUrl: string, workspacePath: string, opts?: {
+    fsDeps?: Pick<typeof fs, 'mkdirSync'>;
+    log?: Logger;
+    exec?: WorkspaceExecFn;
+}): void;
+/**
+ * Ensures a target repository workspace exists and is up-to-date.
+ *
+ * - Not cloned: clones `cloneUrl` exactly as given — no rewriting. The
+ *   caller supplies a ready-made clone URL (issue #793); this function never
+ *   consults forge conventions to decide what to clone.
+ * - Already cloned: runs `git fetch origin` and reads the default branch through
+ *   the injected `getDefaultBranch` thunk — the forge's default-branch read,
+ *   under per-command veracious auth. The clone URL is never consulted on
+ *   this path.
+ *
+ * Returns the absolute workspace path.
+ */
+export declare function ensureRepoWorkspace(owner: string, repo: string, cloneUrl: string, deps: EnsureRepoWorkspaceDeps): string;
+//# sourceMappingURL=repoWorkspace.d.ts.map

package/dist/git/repoWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoWorkspace.d.ts","sourceRoot":"","sources":["../../src/git/repoWorkspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAEjI,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,yDAAyD;IACzD,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,wDAAwD;IACxD,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,GAAG,WAAW,CAAC,CAAC;IACrD,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtG;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,GAAG,OAAO,CAGnG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,GACA,IAAI,CAUN;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,uBAAuB,GAC5B,MAAM,CAiBR"}

package/dist/git/repoWorkspace.js

@@ -0,0 +1,85 @@
+/**
+ * Target repository workspace management — absorbed into the gitContext package (issue #700).
+ *
+ * Handles workspace path resolution, cloning, and fetching for external target
+ * repositories. Structurally exempt from the guard (adws/gitContext/ directory).
+ *
+ * All ADW-global config (TARGET_REPOS_DIR) is injected at the shim boundary in
+ * targetRepoManager.ts; this module stays ADW-global-free for standalone reuse.
+ * The `defaultBranch` thunk is injected so the caller can bind a veracious
+ * forge credential rather than relying on ambient auth.
+ *
+ * The caller supplies a ready-made clone URL (issue #793, PRD story 14): this
+ * module clones exactly the URL it is handed, with no rewriting and no forge
+ * vocabulary. The GitHub HTTPS→SSH rewrite lives in the adapter
+ * (`adws/providers/github/cloneUrl.ts`) and is applied by the ADW wiring
+ * shim (`adws/core/targetRepoManager.ts`) before this module is called.
+ */
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the workspace path for a target repository.
+ * Format: `targetReposDir/{owner}/{repo}`
+ * `targetReposDir` is injected — never reads TARGET_REPOS_DIR directly.
+ */
+export function getTargetRepoWorkspacePath(owner, repo, targetReposDir) {
+    return path.join(targetReposDir, owner, repo);
+}
+/** Returns true if a `.git` directory exists at workspacePath. */
+export function isRepoCloned(workspacePath, fsDeps) {
+    const fsOps = fsDeps ?? fs;
+    return fsOps.existsSync(path.join(workspacePath, '.git'));
+}
+/**
+ * Clones a repository into workspacePath. Clones exactly the URL it is
+ * given (issue #793) — no rewriting, no scheme translation. The caller
+ * (`adws/core/targetRepoManager.ts`) is responsible for handing this
+ * function a ready-made clone URL.
+ */
+export function cloneRepo(cloneUrl, workspacePath, opts) {
+    const fsDeps = opts?.fsDeps ?? fs;
+    const logFn = opts?.log ?? (() => { });
+    const execFn = opts?.exec ?? ((cmd, o) => { execSync(cmd, { ...o, encoding: 'utf-8' }); });
+    const parentDir = path.dirname(workspacePath);
+    fsDeps.mkdirSync(parentDir, { recursive: true });
+    logFn(`Cloning ${cloneUrl} into ${workspacePath}...`, 'info');
+    execFn(`git clone "${cloneUrl}" "${workspacePath}"`, { stdio: 'pipe', encoding: 'utf-8' });
+    logFn(`Cloned ${cloneUrl} into ${workspacePath}`, 'success');
+}
+// ---------------------------------------------------------------------------
+// ensureRepoWorkspace
+// ---------------------------------------------------------------------------
+/**
+ * Ensures a target repository workspace exists and is up-to-date.
+ *
+ * - Not cloned: clones `cloneUrl` exactly as given — no rewriting. The
+ *   caller supplies a ready-made clone URL (issue #793); this function never
+ *   consults forge conventions to decide what to clone.
+ * - Already cloned: runs `git fetch origin` and reads the default branch through
+ *   the injected `getDefaultBranch` thunk — the forge's default-branch read,
+ *   under per-command veracious auth. The clone URL is never consulted on
+ *   this path.
+ *
+ * Returns the absolute workspace path.
+ */
+export function ensureRepoWorkspace(owner, repo, cloneUrl, deps) {
+    const { targetReposDir, getDefaultBranch, log: logFn = () => { } } = deps;
+    const fsDeps = deps.fsDeps ?? fs;
+    const execFn = deps.exec ?? ((cmd, opts) => { execSync(cmd, { ...opts, encoding: 'utf-8', stdio: 'pipe' }); });
+    const workspacePath = getTargetRepoWorkspacePath(owner, repo, targetReposDir);
+    if (isRepoCloned(workspacePath, fsDeps)) {
+        logFn(`Target repo ${owner}/${repo} already cloned at ${workspacePath}`, 'info');
+        execFn('git fetch origin', { cwd: workspacePath });
+        const defaultBranch = getDefaultBranch();
+        logFn(`Fetched latest refs for ${defaultBranch} in ${workspacePath}`, 'success');
+    }
+    else {
+        cloneRepo(cloneUrl, workspacePath, { fsDeps, log: logFn, exec: execFn });
+    }
+    return workspacePath;
+}
+//# sourceMappingURL=repoWorkspace.js.map

package/dist/git/repoWorkspace.js.map

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

package/dist/git/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Public types for the GitContext deep module.
+ *
+ * Contract: identity in, repo-scoped operations out. Base-path resolution
+ * lives only in the GitContext constructor — no optional base path, no cwd
+ * fallback. All identity and config are injected at construction so the
+ * package carries no dependency on ADW-specific globals.
+ */
+/**
+ * Injectable command runner seam — exists for hermetic testing and
+ * standalone-package reuse. The default is a thin execSync wrapper;
+ * tests inject a spy that records invocations without spawning real processes.
+ *
+ * The optional `input` field passes data to the child process's stdin.
+ */
+export type ExecFn = (command: string, options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    input?: string;
+}) => string;
+/**
+ * The working-directory CLASS a command belongs to — the caller's declaration,
+ * never the executor's inference. There is no `process.cwd()` fallback and no
+ * fourth option.
+ *
+ *  - `workspace`    — the target workspace this context is bound to. Omitting
+ *                      `path` means the context base path; supplying `path`
+ *                      narrows to an explicit worktree beneath it.
+ *  - `frameworkRoot` — the injected framework repository root, for commands
+ *                      that carry their own repository identity and need no
+ *                      checkout (#775's contract). Deliberately carries no `path`
+ *                      — "framework root with an explicit worktree path" is
+ *                      unrepresentable rather than merely undocumented.
+ */
+export type ExecWorkingDirectory = {
+    readonly kind: 'workspace';
+    readonly path?: string;
+} | {
+    readonly kind: 'frameworkRoot';
+};
+/**
+ * Options for {@link GitContext.exec}, the package's public forge-neutral
+ * executor. Deliberately carries no forge semantics — no credential
+ * selection, no PAT-versus-installation-token discrimination, no `--repo`
+ * awareness. `command` stays a separate, first positional parameter on
+ * `exec` (not folded into this object) so the `git-gh-shellout` CI guard
+ * keeps inspecting it.
+ */
+export interface ExecOptions {
+    /** The working-directory class this command runs in — never a bare path. */
+    readonly cwd: ExecWorkingDirectory;
+    /**
+     * Per-command credential/identity overlay, merged over the inherited
+     * process environment inside the executor. Never a whole replacement
+     * environment, and never a `process.env` mutation.
+     */
+    readonly env: NodeJS.ProcessEnv;
+    /** Optional data piped to the child process's stdin. */
+    readonly input?: string;
+}
+/**
+ * The core's forge-neutral declaration of *why* a command needs a credential —
+ * never a declaration of *which kind* of credential it needs. `'alternateIdentity'`
+ * means "the primary automation identity cannot perform this operation" — true of
+ * PR approval (GitHub forbids bot self-approval) and Projects V2 writes (app tokens
+ * lack access on user-owned repos), and expressible on any forge. `'default'` is
+ * everything else. The core never learns that the answer to `'alternateIdentity'`
+ * is a PAT — only the provider knows that.
+ */
+export type CredentialPurpose = 'default' | 'alternateIdentity';
+/** A single command's credential request, bound to the repository it targets. */
+export interface CredentialRequest {
+    readonly owner: string;
+    readonly repo: string;
+    readonly purpose: CredentialPurpose;
+}
+/**
+ * The TokenProvider port — the seam a forge adapter implements to hand the core
+ * credentials without the core ever holding one.
+ *
+ * `credentialEnv` is called on **every** command; the core never memoises its
+ * result. A GitHub App installation token expires roughly an hour after minting,
+ * and this is what lets the credential source's own expiry-aware refresh actually
+ * fire for a long-running orchestrator instead of replaying a stale snapshot.
+ *
+ * The return value is a per-command environment **overlay** — the same shape
+ * `ExecOptions.env` accepts — never a whole environment and never a
+ * `process.env` mutation. Returning an overlay rather than a bare token string
+ * keeps the credential variable's *name* (e.g. `GH_TOKEN`) on the provider's
+ * side of the port, so the core carries no forge vocabulary.
+ */
+export interface TokenProvider {
+    credentialEnv(request: CredentialRequest): NodeJS.ProcessEnv;
+}
+/**
+ * Injectable filesystem seam for worktree management ops.
+ * All fields optional; defaults are the real fs functions.
+ */
+export interface FsDeps {
+    existsSync: (p: string) => boolean;
+    mkdirSync: (p: string, opts?: {
+        recursive?: boolean;
+    }) => void;
+    copyFileSync: (src: string, dest: string) => void;
+    rmSync: (p: string, opts?: {
+        force?: boolean;
+        recursive?: boolean;
+    }) => void;
+}
+/**
+ * The four levels the worktree operations report at.
+ */
+export type LogLevel = 'info' | 'error' | 'success' | 'warn';
+/**
+ * The logger port (PRD story 17) — exists so the package carries no
+ * dependency on the host application's utilities. Structurally compatible
+ * with the host application's `log(message, level?)` (`adws/core/logger.ts`),
+ * so the ADW logger is injectable with no adapter.
+ */
+export type Logger = (message: string, level?: LogLevel) => void;
+/**
+ * Optional dependency bag for GitContext. Follows the ADW Deps idiom
+ * (JanitorDeps, MergeDeps, ReconcileDeps). All fields optional so existing
+ * call sites `new GitContext(options)` continue to work unchanged.
+ */
+export interface GitContextDeps {
+    exec?: ExecFn;
+    /** Injectable fs for worktree management ops — defaults to real 'fs' functions. */
+    fsDeps?: FsDeps;
+    /** Injectable logger port — defaults to `consoleLogger`. */
+    logger?: Logger;
+}
+/** Git author and committer identity for child-process env overlays. */
+export interface GitIdentity {
+    authorName: string;
+    authorEmail: string;
+    committerName: string;
+    committerEmail: string;
+}
+/**
+ * Construction options for GitContext.
+ *
+ * All fields, including `tokenProvider`, are mandatory — any missing or empty
+ * field is a hard construction error. There is no optional base-path
+ * parameter and no cwd fallback.
+ *
+ * frameworkRepoRoot and targetReposDir are injected by the caller (e.g. from
+ * environment.ts's REPO_ROOT and TARGET_REPOS_DIR) so this package depends on
+ * no ADW globals and can be imported by other projects.
+ */
+export interface GitContextOptions {
+    /** Repository owner (organisation or user). */
+    owner: string;
+    /** Repository name (without the owner prefix). */
+    repo: string;
+    /**
+     * True when ADW is operating on its own (self-hosted) repository.
+     * False for any external target repository. Must be a boolean — omitting
+     * this field is a hard construction error (story 23).
+     */
+    selfHost: boolean;
+    /** Author and committer identity for git operations. */
+    gitIdentity: GitIdentity;
+    /**
+     * Absolute path to the ADW framework repository root.
+     * Injected by the caller (environment.ts REPO_ROOT). Used as basePath for
+     * self-host contexts.
+     */
+    frameworkRepoRoot: string;
+    /**
+     * Absolute path to the directory that houses cloned target repositories.
+     * Injected by the caller (environment.ts TARGET_REPOS_DIR). Used as the
+     * base of basePath for target contexts: join(targetReposDir, owner, repo).
+     */
+    targetReposDir: string;
+    /**
+     * A port the core asks, once per command, for a credential environment
+     * overlay. The core holds no token of its own — see {@link TokenProvider}.
+     */
+    tokenProvider: TokenProvider;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/git/types.d.ts.map

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

package/dist/git/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public types for the GitContext deep module.
+ *
+ * Contract: identity in, repo-scoped operations out. Base-path resolution
+ * lives only in the GitContext constructor — no optional base path, no cwd
+ * fallback. All identity and config are injected at construction so the
+ * package carries no dependency on ADW-specific globals.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/git/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/git/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/git/workingDirectoryGuard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Diagnoses a spawn failure caused by a missing working directory and turns
+ * it into an error naming the path and repository identity.
+ *
+ * Node resolves a spawn's cwd before exec'ing the shell, so a nonexistent
+ * cwd surfaces as an ENOENT on the shell binary itself rather than on the
+ * directory. The message differs by runtime (node: "spawnSync /bin/sh
+ * ENOENT"; bun: "ENOENT: no such file or directory, posix_spawn '/bin/sh'")
+ * but `code` does not (verified 2026-07-30) — detection keys off `code`,
+ * never the message.
+ *
+ * Pure — no fs, no spawn. The existence probe is injected by the caller.
+ */
+/** The five facts the diagnostic message needs — deliberately no basePath/frameworkRepoRoot, so the message never classifies which kind of directory went missing. */
+export interface WorkingDirectoryContext {
+    cwd: string;
+    command: string;
+    owner: string;
+    repo: string;
+    selfHost: boolean;
+}
+/**
+ * Structural check for an ENOENT-coded failure — not `instanceof Error`, so
+ * an injected ExecFn seam that throws a plain shaped object is still
+ * diagnosed. Keys off `code` because the message text differs between node
+ * and bun for the same failure.
+ */
+export declare function isSpawnEnoent(error: unknown): boolean;
+/** One message shape for every missing-working-directory case — basePath or an explicit worktree path alike. */
+export declare function describeMissingWorkingDirectory(ctx: WorkingDirectoryContext): string;
+/**
+ * Returns the original error untouched in every case except a confirmed
+ * missing cwd — never a blanket wrap. When it does fire, the returned error
+ * preserves `code: 'ENOENT'` (plus `syscall`/`path`) and carries the
+ * original as `cause`, so existing ENOENT handling keeps working while the
+ * message gains the path, the repo, and the cause.
+ */
+export declare function rewrapMissingWorkingDirectory(error: unknown, ctx: WorkingDirectoryContext, exists: (path: string) => boolean): unknown;
+//# sourceMappingURL=workingDirectoryGuard.d.ts.map

package/dist/git/workingDirectoryGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workingDirectoryGuard.d.ts","sourceRoot":"","sources":["../../src/git/workingDirectoryGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sKAAsK;AACtK,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,gHAAgH;AAChH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAChC,OAAO,CAUT"}

package/dist/git/workingDirectoryGuard.js

@@ -0,0 +1,53 @@
+/**
+ * Diagnoses a spawn failure caused by a missing working directory and turns
+ * it into an error naming the path and repository identity.
+ *
+ * Node resolves a spawn's cwd before exec'ing the shell, so a nonexistent
+ * cwd surfaces as an ENOENT on the shell binary itself rather than on the
+ * directory. The message differs by runtime (node: "spawnSync /bin/sh
+ * ENOENT"; bun: "ENOENT: no such file or directory, posix_spawn '/bin/sh'")
+ * but `code` does not (verified 2026-07-30) — detection keys off `code`,
+ * never the message.
+ *
+ * Pure — no fs, no spawn. The existence probe is injected by the caller.
+ */
+const MAX_COMMAND_CHARS = 120;
+function truncateCommand(command) {
+    if (command.length <= MAX_COMMAND_CHARS)
+        return command;
+    return `${command.slice(0, MAX_COMMAND_CHARS)}…`;
+}
+/**
+ * Structural check for an ENOENT-coded failure — not `instanceof Error`, so
+ * an injected ExecFn seam that throws a plain shaped object is still
+ * diagnosed. Keys off `code` because the message text differs between node
+ * and bun for the same failure.
+ */
+export function isSpawnEnoent(error) {
+    return typeof error === 'object' && error !== null && error.code === 'ENOENT';
+}
+/** One message shape for every missing-working-directory case — basePath or an explicit worktree path alike. */
+export function describeMissingWorkingDirectory(ctx) {
+    return `GitContext: working directory does not exist: ${ctx.cwd} (${ctx.owner}/${ctx.repo}, selfHost=${ctx.selfHost}) — has a workflow ever cloned this workspace on this host? [while running: ${truncateCommand(ctx.command)}]`;
+}
+/**
+ * Returns the original error untouched in every case except a confirmed
+ * missing cwd — never a blanket wrap. When it does fire, the returned error
+ * preserves `code: 'ENOENT'` (plus `syscall`/`path`) and carries the
+ * original as `cause`, so existing ENOENT handling keeps working while the
+ * message gains the path, the repo, and the cause.
+ */
+export function rewrapMissingWorkingDirectory(error, ctx, exists) {
+    if (!isSpawnEnoent(error))
+        return error;
+    if (exists(ctx.cwd))
+        return error;
+    const original = error;
+    return Object.assign(new Error(describeMissingWorkingDirectory(ctx)), {
+        code: 'ENOENT',
+        syscall: original.syscall,
+        path: original.path,
+        cause: original,
+    });
+}
+//# sourceMappingURL=workingDirectoryGuard.js.map

package/dist/git/workingDirectoryGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workingDirectoryGuard.js","sourceRoot":"","sources":["../../src/git/workingDirectoryGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,OAAO,CAAC,MAAM,IAAI,iBAAiB;QAAE,OAAO,OAAO,CAAC;IACxD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3G,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,+BAA+B,CAAC,GAA4B;IAC1E,OAAO,iDAAiD,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,QAAQ,+EAA+E,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;AACpO,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,GAA4B,EAC5B,MAAiC;IAEjC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,KAA8B,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,GAAG,CAAC,CAAC,EAAE;QACpE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/git/worktreeCreateOps.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Package-private worktree create/ensure ops for GitContext.
+ * Injects runner, fs and a logger port for testability — no base-path
+ * computation here.
+ */
+import type { Logger } from './types.js';
+type Runner = (command: string, cwd: string) => string;
+interface FsDeps {
+    existsSync: (p: string) => boolean;
+    mkdirSync: (p: string, opts?: {
+        recursive?: boolean;
+    }) => void;
+    copyFileSync: (src: string, dest: string) => void;
+}
+interface WorktreePaths {
+    worktreesDir: string;
+    worktreePath: string;
+    baseCwd: string;
+}
+export type { FsDeps as WorktreeCreateFsDeps };
+/**
+ * Copies .env and .env.local from baseCwd (the repo root) to the worktree.
+ */
+declare function copyEnvToWorktree(fs: FsDeps, log: Logger, baseCwd: string, worktreePath: string): void;
+/**
+ * Creates a worktree for an existing branch (or creates a new one from baseBranch).
+ * Returns the worktree path.
+ */
+declare function createWorktree(run: Runner, fs: FsDeps, log: Logger, paths: WorktreePaths, branchName: string, baseBranch?: string): string;
+/**
+ * Creates a worktree with a new branch from an optional base (defaults to HEAD).
+ */
+declare function createWorktreeForNewBranch(run: Runner, fs: FsDeps, log: Logger, paths: WorktreePaths, branchName: string, baseBranch?: string): string;
+/**
+ * Ensures a worktree exists for the branch, creating if needed.
+ * Copies env files into the worktree.
+ */
+declare function ensureWorktree(run: Runner, fs: FsDeps, log: Logger, paths: WorktreePaths, branchName: string, baseBranch?: string): string;
+export declare const worktreeCreateOps: {
+    createWorktree: typeof createWorktree;
+    createWorktreeForNewBranch: typeof createWorktreeForNewBranch;
+    ensureWorktree: typeof ensureWorktree;
+    copyEnvToWorktree: typeof copyEnvToWorktree;
+};
+//# sourceMappingURL=worktreeCreateOps.d.ts.map

package/dist/git/worktreeCreateOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeCreateOps.d.ts","sourceRoot":"","sources":["../../src/git/worktreeCreateOps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvD,UAAU,MAAM;IACd,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,aAAa;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,YAAY,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;AAqE/C;;GAEG;AACH,iBAAS,iBAAiB,CACxB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN;AAqBD;;;GAGG;AACH,iBAAS,cAAc,CACrB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA4CR;AAED;;GAEG;AACH,iBAAS,0BAA0B,CACjC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAqBR;AAED;;;GAGG;AACH,iBAAS,cAAc,CACrB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAYR;AAED,eAAO,MAAM,iBAAiB;;;;;CAK7B,CAAC"}