@paysdoc/devplatform 1.0.0

package/dist/git/worktreeRemoveOps.js

@@ -0,0 +1,132 @@
+/**
+ * Package-private worktree remove ops for GitContext.
+ * Injects runner, fs, a logger port, and killProcesses for testability.
+ */
+import * as path from 'path';
+import { killProcessesInDirectory } from './processCleanup.js';
+function parseWorktreeBranches(run, baseCwd) {
+    const output = run('git worktree list --porcelain', baseCwd);
+    const lines = output.split('\n');
+    const result = new Map();
+    let currentPath = null;
+    for (const line of lines) {
+        if (line.startsWith('worktree ')) {
+            currentPath = line.substring('worktree '.length);
+        }
+        else if (line.startsWith('branch ') && currentPath?.includes('.worktrees/')) {
+            const branchName = line.substring('branch '.length).replace('refs/heads/', '');
+            result.set(currentPath, branchName);
+        }
+        else if (line === '') {
+            currentPath = null;
+        }
+    }
+    return result;
+}
+function pruneAndRmWorktreeDir(run, fs, log, worktreePath, branchName, baseCwd, killProcs, deleteLocalBranchFn) {
+    if (!fs.existsSync(worktreePath)) {
+        log(`Worktree for branch '${branchName}' does not exist at ${worktreePath}`, 'info');
+        return false;
+    }
+    try {
+        killProcs(worktreePath);
+        run('git worktree prune', baseCwd);
+        fs.rmSync(worktreePath, { recursive: true, force: true });
+        log(`Removed orphaned worktree directory at ${worktreePath}`, 'info');
+        deleteLocalBranchFn(branchName);
+        return true;
+    }
+    catch (cleanupError) {
+        log(`Failed to cleanup worktree directory at ${worktreePath}: ${cleanupError}`, 'error');
+        return false;
+    }
+}
+/**
+ * Removes a worktree for the given branch. Falls back to prune + rmSync on failure.
+ */
+function removeWorktree(run, fs, log, worktreePath, branchName, deleteLocalBranchFn, baseCwd, killProcs = killProcessesInDirectory) {
+    killProcs(worktreePath);
+    try {
+        run(`git worktree remove "${worktreePath}" --force`, baseCwd);
+        log(`Removed worktree for branch '${branchName}' at ${worktreePath}`, 'success');
+        deleteLocalBranchFn(branchName);
+        return true;
+    }
+    catch {
+        return pruneAndRmWorktreeDir(run, fs, log, worktreePath, branchName, baseCwd, killProcs, deleteLocalBranchFn);
+    }
+}
+function rmOrphanedWorktreeDir(fs, log, wtPath, branchName, removeError, deleteLocalBranchFn) {
+    if (!fs.existsSync(wtPath)) {
+        log(`Failed to remove worktree at ${wtPath}: ${removeError}`, 'error');
+        return false;
+    }
+    try {
+        fs.rmSync(wtPath, { recursive: true, force: true });
+        log(`Removed orphaned worktree directory at ${wtPath}`, 'info');
+        if (branchName)
+            deleteLocalBranchFn(branchName);
+        return true;
+    }
+    catch (cleanupError) {
+        log(`Failed to cleanup worktree directory at ${wtPath}: ${cleanupError}`, 'error');
+        return false;
+    }
+}
+function removeOneWorktree(run, fs, log, wtPath, branchName, baseCwd, killProcs, deleteLocalBranchFn) {
+    killProcs(wtPath);
+    try {
+        run(`git worktree remove "${wtPath}" --force`, baseCwd);
+        log(`Removed worktree at ${wtPath}`, 'success');
+        if (branchName)
+            deleteLocalBranchFn(branchName);
+        return true;
+    }
+    catch (error) {
+        return rmOrphanedWorktreeDir(fs, log, wtPath, branchName, error, deleteLocalBranchFn);
+    }
+}
+/**
+ * Removes all worktrees matching the given issue number.
+ */
+function removeWorktreesForIssue(run, fs, log, baseCwd, issueNumber, deleteLocalBranchFn, killProcs = killProcessesInDirectory) {
+    try {
+        const output = run('git worktree list --porcelain', baseCwd);
+        const worktrees = [];
+        for (const line of output.split('\n')) {
+            if (line.startsWith('worktree ')) {
+                const wtPath = line.substring('worktree '.length);
+                if (wtPath.includes('.worktrees'))
+                    worktrees.push(wtPath);
+            }
+        }
+        const pattern = new RegExp(`-issue-${issueNumber}-`);
+        const matching = worktrees.filter((wtPath) => pattern.test(path.basename(wtPath)));
+        if (matching.length === 0) {
+            log(`No worktrees found matching issue #${issueNumber}`, 'info');
+            return 0;
+        }
+        log(`Found ${matching.length} worktree(s) matching issue #${issueNumber}`, 'info');
+        const worktreeBranches = parseWorktreeBranches(run, baseCwd);
+        let removedCount = 0;
+        for (const wtPath of matching) {
+            const branchName = worktreeBranches.get(wtPath);
+            if (removeOneWorktree(run, fs, log, wtPath, branchName, baseCwd, killProcs, deleteLocalBranchFn)) {
+                removedCount += 1;
+            }
+        }
+        try {
+            run('git worktree prune', baseCwd);
+        }
+        catch (pruneError) {
+            log(`Failed to prune worktrees: ${pruneError}`, 'error');
+        }
+        log(`Removed ${removedCount} worktree(s) for issue #${issueNumber}`, 'success');
+        return removedCount;
+    }
+    catch {
+        return 0;
+    }
+}
+export const worktreeRemoveOps = { removeWorktree, removeWorktreesForIssue };
+//# sourceMappingURL=worktreeRemoveOps.js.map

package/dist/git/worktreeRemoveOps.js.map

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

package/dist/git/worktreeResetOps.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Package-private takeover-reset orchestration for GitContext.
+ * Injects both the runner and fs functions for testability.
+ */
+type Runner = (command: string, cwd: string) => string;
+interface FsDeps {
+    existsSync: (p: string) => boolean;
+    rmSync: (p: string, opts?: {
+        force?: boolean;
+        recursive?: boolean;
+    }) => void;
+}
+declare function resetWorktree(run: Runner, fs: FsDeps, worktreePath: string, branch: string): void;
+export declare const worktreeResetOps: {
+    resetWorktree: typeof resetWorktree;
+};
+export {};
+//# sourceMappingURL=worktreeResetOps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeResetOps.d.ts","sourceRoot":"","sources":["../../src/git/worktreeResetOps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,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,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9E;AAqCD,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoB1F;AAED,eAAO,MAAM,gBAAgB;;CAAoB,CAAC"}

package/dist/git/worktreeResetOps.js

@@ -0,0 +1,68 @@
+/**
+ * Package-private takeover-reset orchestration for GitContext.
+ * Injects both the runner and fs functions for testability.
+ */
+import * as path from 'path';
+function resolveGitDir(run, worktreePath) {
+    const raw = run('git rev-parse --git-dir', worktreePath);
+    return path.isAbsolute(raw) ? raw : path.resolve(worktreePath, raw);
+}
+function abortMerge(run, fs, worktreePath, gitDir) {
+    const mergeHead = path.join(gitDir, 'MERGE_HEAD');
+    if (!fs.existsSync(mergeHead))
+        return;
+    try {
+        run('git merge --abort', worktreePath);
+        return;
+    }
+    catch {
+        // fallback to fs removal
+    }
+    fs.rmSync(mergeHead, { force: true });
+    const mergeMsg = path.join(gitDir, 'MERGE_MSG');
+    const mergeMode = path.join(gitDir, 'MERGE_MODE');
+    if (fs.existsSync(mergeMsg))
+        fs.rmSync(mergeMsg, { force: true });
+    if (fs.existsSync(mergeMode))
+        fs.rmSync(mergeMode, { force: true });
+}
+function abortRebase(run, fs, worktreePath, gitDir) {
+    const rebaseApply = path.join(gitDir, 'rebase-apply');
+    const rebaseMerge = path.join(gitDir, 'rebase-merge');
+    if (!fs.existsSync(rebaseApply) && !fs.existsSync(rebaseMerge))
+        return;
+    try {
+        run('git rebase --abort', worktreePath);
+        return;
+    }
+    catch {
+        // fallback to fs removal
+    }
+    fs.rmSync(rebaseApply, { recursive: true, force: true });
+    fs.rmSync(rebaseMerge, { recursive: true, force: true });
+}
+function resetWorktree(run, fs, worktreePath, branch) {
+    const gitDir = resolveGitDir(run, worktreePath);
+    abortMerge(run, fs, worktreePath, gitDir);
+    abortRebase(run, fs, worktreePath, gitDir);
+    try {
+        run(`git fetch origin "${branch}"`, worktreePath);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch origin/${branch} in ${worktreePath}: ${error}`);
+    }
+    try {
+        run(`git reset --hard "origin/${branch}"`, worktreePath);
+    }
+    catch (error) {
+        throw new Error(`Failed to reset to origin/${branch} in ${worktreePath}: ${error}`);
+    }
+    try {
+        run('git clean -fdx', worktreePath);
+    }
+    catch (error) {
+        throw new Error(`Failed to clean worktree ${worktreePath}: ${error}`);
+    }
+}
+export const worktreeResetOps = { resetWorktree };
+//# sourceMappingURL=worktreeResetOps.js.map

package/dist/git/worktreeResetOps.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Root package entry point — forge ports and domain model only.
+ *
+ * This is the platform-agnostic vocabulary shared by every adapter: the
+ * `IssueTracker`/`CodeHost`/`BoardManager` ports, the `Platform`/
+ * `RepoIdentifier`/`Issue`/`PullRequest`/`BoardStatus` domain types, and the
+ * `BoundProviders`/`RepoContext` assembly shapes. It carries no adapter code
+ * and no `forgeProviders` assembly function — those live behind
+ * `"./providers"`. The forge-neutral git/worktree core lives behind
+ * `"./git"`. An import-graph test guards this separation.
+ */
+export * from './providers/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Root package entry point — forge ports and domain model only.
+ *
+ * This is the platform-agnostic vocabulary shared by every adapter: the
+ * `IssueTracker`/`CodeHost`/`BoardManager` ports, the `Platform`/
+ * `RepoIdentifier`/`Issue`/`PullRequest`/`BoardStatus` domain types, and the
+ * `BoundProviders`/`RepoContext` assembly shapes. It carries no adapter code
+ * and no `forgeProviders` assembly function — those live behind
+ * `"./providers"`. The forge-neutral git/worktree core lives behind
+ * `"./git"`. An import-graph test guards this separation.
+ */
+export * from './providers/types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/providers/forgeProviders.d.ts

@@ -0,0 +1,72 @@
+/**
+ * forgeProviders() — the provider package's one public assembly function,
+ * and the library's entry point at 1.0.0 (frozen after HITL review).
+ *
+ * One identity in, every returned provider bound to it. Refuses — before
+ * constructing anything — an identity that fails `validateRepoIdentifier`, a
+ * `tokenProvider` that does not implement the port, a `gitContext` bound to
+ * another repository (naming both), and an unknown or wrong-port forge name
+ * (`UnknownForgeError`, naming the value and the port). The board manager is
+ * present only for a GitHub code host and omitted — never a refusing stub —
+ * otherwise.
+ *
+ * The consumer parses its own configuration into a `ForgeSelection`;
+ * `tokenProvider` is the credential port the consumer built `gitContext`
+ * with, declared on the contract so a later adapter that authenticates
+ * through the port needs no signature change. Imports only the executor,
+ * the ports and this package's own adapters — never `adws/core`,
+ * `adws/types`, `adws/github` or `adws/forge`; reads no file and no
+ * environment variable.
+ */
+import type { GitContext, Logger, TokenProvider } from '../git/index.js';
+import { type BoundProviders, type RepoIdentifier } from './types.js';
+import { type GitHubIssueTrackerDeps } from './github/githubIssueTracker.js';
+import { type GitHubCodeHostDeps } from './github/githubCodeHost.js';
+import type { GitLabConfig } from './gitlab/gitlabApiClient.js';
+import { type JiraConfig } from './jira/jiraIssueTracker.js';
+export declare const CODE_HOST_FORGES: readonly ["github", "gitlab"];
+export declare const ISSUE_TRACKER_FORGES: readonly ["github", "jira"];
+export type CodeHostForge = (typeof CODE_HOST_FORGES)[number];
+export type IssueTrackerForge = (typeof ISSUE_TRACKER_FORGES)[number];
+export type ForgeName = CodeHostForge | IssueTrackerForge;
+/** Runtime guard for JS consumers and config-derived strings — `CodeHostForge` is a compile-time-only guarantee. */
+export declare function isCodeHostForge(value: string): value is CodeHostForge;
+/** Runtime guard for JS consumers and config-derived strings — `IssueTrackerForge` is a compile-time-only guarantee. */
+export declare function isIssueTrackerForge(value: string): value is IssueTrackerForge;
+export interface ForgeSelection {
+    readonly codeHost: CodeHostForge;
+    readonly issueTracker: IssueTrackerForge;
+}
+/** ADW-shaped GitHub seams a consumer may inject — Slack/label/approval behaviour the library itself never learns about. */
+export interface GitHubForgeDeps {
+    readonly onStatusMoved?: GitHubIssueTrackerDeps['onStatusMoved'];
+    readonly resolveLabelDefinition?: GitHubIssueTrackerDeps['resolveLabelDefinition'];
+    readonly canApprovePullRequests?: GitHubCodeHostDeps['canApprovePullRequests'];
+}
+export interface ForgeProviderDeps {
+    readonly logger?: Logger;
+    readonly github?: GitHubForgeDeps;
+    /** Required when `forge.codeHost === 'gitlab'`. */
+    readonly gitlab?: GitLabConfig;
+    /** Required when `forge.issueTracker === 'jira'`. */
+    readonly jira?: JiraConfig;
+}
+export interface ForgeProvidersOptions {
+    readonly forge: ForgeSelection;
+    readonly identity: RepoIdentifier;
+    readonly tokenProvider: TokenProvider;
+    readonly gitContext: GitContext;
+    readonly deps?: ForgeProviderDeps;
+}
+/** Thrown by {@link forgeProviders} for a forge name outside the closed union for its port. */
+export declare class UnknownForgeError extends Error {
+    constructor(value: string, port: 'code host' | 'issue tracker', allowed: readonly string[]);
+}
+/**
+ * Builds the one bound provider set for `identity`. Guard clauses run in
+ * order — identity, token provider, context binding, then both forge names
+ * — entirely before any adapter is constructed, so a refusal never leaves a
+ * partially-built set and never issues a command.
+ */
+export declare function forgeProviders(options: ForgeProvidersOptions): BoundProviders;
+//# sourceMappingURL=forgeProviders.d.ts.map

package/dist/providers/forgeProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgeProviders.d.ts","sourceRoot":"","sources":["../../src/providers/forgeProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAqB,KAAK,cAAc,EAAoC,KAAK,cAAc,EAA0B,MAAM,YAAY,CAAC;AAEnJ,OAAO,EAA4B,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACvG,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAMrF,eAAO,MAAM,gBAAgB,+BAAgC,CAAC;AAC9D,eAAO,MAAM,oBAAoB,6BAA8B,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE1D,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAErE;AAED,wHAAwH;AACxH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C;AAED,4HAA4H;AAC5H,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IACjE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;IACnF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,+FAA+F;AAC/F,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,eAAe,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CAI3F;AAiDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAmB7E"}

package/dist/providers/forgeProviders.js

@@ -0,0 +1,112 @@
+/**
+ * forgeProviders() — the provider package's one public assembly function,
+ * and the library's entry point at 1.0.0 (frozen after HITL review).
+ *
+ * One identity in, every returned provider bound to it. Refuses — before
+ * constructing anything — an identity that fails `validateRepoIdentifier`, a
+ * `tokenProvider` that does not implement the port, a `gitContext` bound to
+ * another repository (naming both), and an unknown or wrong-port forge name
+ * (`UnknownForgeError`, naming the value and the port). The board manager is
+ * present only for a GitHub code host and omitted — never a refusing stub —
+ * otherwise.
+ *
+ * The consumer parses its own configuration into a `ForgeSelection`;
+ * `tokenProvider` is the credential port the consumer built `gitContext`
+ * with, declared on the contract so a later adapter that authenticates
+ * through the port needs no signature change. Imports only the executor,
+ * the ports and this package's own adapters — never `adws/core`,
+ * `adws/types`, `adws/github` or `adws/forge`; reads no file and no
+ * environment variable.
+ */
+import { validateRepoIdentifier } from './types.js';
+import { assertContextBoundTo } from './github/contextBinding.js';
+import { createGitHubIssueTracker } from './github/githubIssueTracker.js';
+import { createGitHubCodeHost } from './github/githubCodeHost.js';
+import { createGitHubBoardManager } from './github/githubBoardManager.js';
+import { createGitLabCodeHost } from './gitlab/gitlabCodeHost.js';
+import { createJiraIssueTracker } from './jira/jiraIssueTracker.js';
+// ---------------------------------------------------------------------------
+// The closed forge unions — one per port
+// ---------------------------------------------------------------------------
+export const CODE_HOST_FORGES = ['github', 'gitlab'];
+export const ISSUE_TRACKER_FORGES = ['github', 'jira'];
+/** Runtime guard for JS consumers and config-derived strings — `CodeHostForge` is a compile-time-only guarantee. */
+export function isCodeHostForge(value) {
+    return CODE_HOST_FORGES.includes(value);
+}
+/** Runtime guard for JS consumers and config-derived strings — `IssueTrackerForge` is a compile-time-only guarantee. */
+export function isIssueTrackerForge(value) {
+    return ISSUE_TRACKER_FORGES.includes(value);
+}
+/** Thrown by {@link forgeProviders} for a forge name outside the closed union for its port. */
+export class UnknownForgeError extends Error {
+    constructor(value, port, allowed) {
+        super(`forgeProviders: unknown ${port} forge "${value}" (expected one of: ${allowed.join(', ')})`);
+        this.name = 'UnknownForgeError';
+    }
+}
+function assertTokenProvider(tokenProvider) {
+    if (typeof tokenProvider?.credentialEnv !== 'function') {
+        throw new Error('forgeProviders: tokenProvider must implement credentialEnv(request)');
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-port builders — one small named function each, no default-to-GitHub fallback
+// ---------------------------------------------------------------------------
+function buildIssueTracker(forgeName, gitContext, identity, deps) {
+    if (forgeName === 'github') {
+        return createGitHubIssueTracker(gitContext, identity, {
+            logger: deps.logger,
+            onStatusMoved: deps.github?.onStatusMoved,
+            resolveLabelDefinition: deps.github?.resolveLabelDefinition,
+        });
+    }
+    if (!deps.jira) {
+        throw new Error('forgeProviders: issue tracker "jira" needs deps.jira (JiraConfig)');
+    }
+    return createJiraIssueTracker(deps.jira, { logger: deps.logger });
+}
+function buildCodeHost(forgeName, gitContext, identity, deps) {
+    if (forgeName === 'github') {
+        return createGitHubCodeHost(gitContext, identity, {
+            logger: deps.logger,
+            canApprovePullRequests: deps.github?.canApprovePullRequests,
+        });
+    }
+    if (!deps.gitlab) {
+        throw new Error('forgeProviders: code host "gitlab" needs deps.gitlab (GitLabConfig)');
+    }
+    return createGitLabCodeHost(identity, deps.gitlab, { logger: deps.logger });
+}
+/** GitHub is the only code host with board support; every other selection omits the member — never a refusing stub. */
+function buildBoardManager(forgeName, gitContext, identity, deps) {
+    if (forgeName !== 'github')
+        return undefined;
+    return createGitHubBoardManager(gitContext, identity, { logger: deps.logger });
+}
+// ---------------------------------------------------------------------------
+// The assembly function
+// ---------------------------------------------------------------------------
+/**
+ * Builds the one bound provider set for `identity`. Guard clauses run in
+ * order — identity, token provider, context binding, then both forge names
+ * — entirely before any adapter is constructed, so a refusal never leaves a
+ * partially-built set and never issues a command.
+ */
+export function forgeProviders(options) {
+    const { forge, identity, tokenProvider, gitContext, deps = {} } = options;
+    validateRepoIdentifier(identity);
+    assertTokenProvider(tokenProvider);
+    assertContextBoundTo(gitContext, identity, 'forgeProviders');
+    if (!isIssueTrackerForge(forge.issueTracker)) {
+        throw new UnknownForgeError(forge.issueTracker, 'issue tracker', ISSUE_TRACKER_FORGES);
+    }
+    if (!isCodeHostForge(forge.codeHost)) {
+        throw new UnknownForgeError(forge.codeHost, 'code host', CODE_HOST_FORGES);
+    }
+    const issueTracker = buildIssueTracker(forge.issueTracker, gitContext, identity, deps);
+    const codeHost = buildCodeHost(forge.codeHost, gitContext, identity, deps);
+    const boardManager = buildBoardManager(forge.codeHost, gitContext, identity, deps);
+    return Object.freeze({ issueTracker, codeHost, boardManager });
+}
+//# sourceMappingURL=forgeProviders.js.map

package/dist/providers/forgeProviders.js.map

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

package/dist/providers/github/appAuth.d.ts

@@ -0,0 +1,70 @@
+/**
+ * GitHub App token mint — GitHub forge adapter (issue #792; originally
+ * absorbed into the gitContext package by issue #700).
+ *
+ * This module is structurally exempt from the git/gh guard
+ * (adws/providers/github/ is skipped by directory). It owns the JWT dance and
+ * installation-token exchange; callers should route through
+ * resolveContextToken for veracity.
+ *
+ * Configuration is INJECTED, never read from process.env — see
+ * {@link GitHubAppConfig}. The ADW wiring shim (adws/github/githubAppAuth.ts)
+ * is the sole site that reads GITHUB_APP_ID/GITHUB_APP_SLUG/
+ * GITHUB_APP_PRIVATE_KEY_PATH and passes them in as a value.
+ *
+ * No ADW-global imports. The log seam defaults to a no-op to keep the package
+ * standalone-reusable.
+ *
+ * The bearer credential travels to curl over its `--config` stdin channel —
+ * never as a command-line argument — so it cannot appear in a thrown
+ * `execFileSync` error or in the process table (issue #780).
+ */
+/** Injected GitHub App identity and signing-key path. Any missing field means "not configured". */
+export interface GitHubAppConfig {
+    readonly appId?: string;
+    readonly appSlug?: string;
+    readonly privateKeyPath?: string;
+}
+/** Runs curl with the given argv, delivering the request description on stdin. */
+export type RunCurl = (args: readonly string[], stdinConfig: string) => string;
+export interface AppAuthDeps {
+    /** Overrides the GitHub API origin. Defaults to GITHUB_API_BASE_URL. */
+    apiBaseUrl?: string;
+    /** Overrides the curl runner. Production uses execFileSync. */
+    runCurl?: RunCurl;
+}
+/** Production GitHub API origin. Overridable via AppAuthDeps.apiBaseUrl for hermetic testing. */
+export declare const GITHUB_API_BASE_URL = "https://api.github.com";
+/** Returns true if the injected GitHub App configuration is complete. */
+export declare function isGitHubAppConfigured(config: GitHubAppConfig): boolean;
+/**
+ * Returns a valid GitHub App installation token for the given repo,
+ * refreshing if needed. Throws if the App is not installed on owner/repo.
+ *
+ * Assumes `isGitHubAppConfigured(config)` was checked first, exactly as
+ * before configuration was injected — but fails with a named error rather
+ * than a `TypeError` from `fs.readFileSync(undefined)` if it was not.
+ */
+export declare function getInstallationToken(config: GitHubAppConfig, owner: string, repo: string, deps?: AppAuthDeps): string;
+/** Clears both module-level caches. Test-only — production never needs to reset them. */
+export declare function clearAppAuthCaches(): void;
+/** Rewrites any `Bearer <token>` fragment to `Bearer [REDACTED]`. Final net over untrusted text (curl stderr, GitHub error bodies) — the credential is already structurally absent by construction. */
+export declare function redactBearerTokens(text: string): string;
+export interface GitHubApiRequest {
+    jwt: string;
+    url: string;
+    method: 'GET' | 'POST';
+    /** Human-readable phrase for failure messages, e.g. "installation lookup". */
+    operation: string;
+    /** Identity echoed in failure messages, e.g. "acme/webapp" or "installation 4711". */
+    subject: string;
+}
+/** Builds a curl `--config` payload carrying the URL, headers (including the bearer credential) and method — never a command-line argument. */
+export declare function buildCurlConfig(request: GitHubApiRequest): string;
+/** Composes the sanitized failure shape the issue asks for: `GitHub App <operation> failed for <subject>: <detail>`. */
+export declare function describeApiFailure(input: {
+    operation: string;
+    subject: string;
+    detail: string;
+}): string;
+//# sourceMappingURL=appAuth.d.ts.map

package/dist/providers/github/appAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appAuth.d.ts","sourceRoot":"","sources":["../../../src/providers/github/appAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAmBD,kFAAkF;AAClF,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAM5D,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEtE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CAwBzH;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAYD,uMAAuM;AACvM,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+IAA+I;AAC/I,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAcjE;AAED,wHAAwH;AACxH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExG"}