@on-par/factory-cli 0.0.0-stage → 0.9.1

package/dist/cli/doctor.d.ts

@@ -0,0 +1,127 @@
+export interface DoctorCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+    /** One-line fix suggestion; only meaningful when ok=false. */
+    fix?: string;
+    /** Optional checks never fail the doctor exit code. */
+    optional?: boolean;
+}
+export interface DoctorEnvProbes {
+    commandAvailable: (cmd: string) => boolean;
+    envPresent: (key: string) => boolean;
+    /** Run a command, return trimmed stdout, or null if it fails. */
+    tryExec: (cmd: string) => string | null;
+    pathExists: (p: string) => boolean;
+    distFreshness?: () => {
+        fresh: boolean;
+        detail: string;
+    };
+}
+export declare function runDoctorChecks(probes: DoctorEnvProbes): DoctorCheck[];
+export declare function formatDoctorChecks(checks: DoctorCheck[]): string;
+export declare function doctorFailed(checks: DoctorCheck[]): boolean;
+/** Which Claude profile a keychain probe checked: the keychain service name and, for a
+ *  non-default profile, the CLAUDE_CONFIG_DIR it belongs to. Absent = default profile. */
+export interface KeychainProbeProfile {
+    service?: string;
+    configDir?: string;
+}
+/** Result of the macOS login-keychain probe for the Claude Code credential entry (#1014). */
+export type KeychainProbeStatus = {
+    status: 'skipped';
+    detail: string;
+} | ({
+    status: 'readable';
+} & KeychainProbeProfile) | ({
+    status: 'unreadable';
+    inTmux: boolean;
+} & KeychainProbeProfile);
+export declare function claudeKeychainCheck(probe: KeychainProbeStatus): DoctorCheck;
+/** Non-null when `factory run` must fail fast instead of claiming issues (#1014).
+ *  Only the tmux-without-keychain differential is certain enough to abort a run on. */
+export declare function keychainPreflightError(probe: KeychainProbeStatus): string | null;
+/** Outcome of one `claude -p` probe: it succeeded, it failed, or it was not run. */
+export type ClaudeAuthProbe = 'ok' | 'failed' | 'skipped';
+export interface ClaudeAuthProbeResult {
+    host: ClaudeAuthProbe;
+    sandboxed: ClaudeAuthProbe;
+    hostDetail: string;
+    sandboxDetail: string;
+}
+/** Reports host and sandboxed Claude auth as two separate checks (#1008). Only the
+ *  differential — host ok, sandboxed failed — is a hard doctor failure; that is the one
+ *  combination that proves the sandbox, not the credentials, is at fault. */
+export declare function sandboxClaudeAuthChecks(result: ClaudeAuthProbeResult): DoctorCheck[];
+export interface LeaseHealthRow {
+    worktreeId: string;
+    branch: string;
+    port: number;
+    pid: number;
+    alive: boolean;
+    reason?: 'dead-pid' | 'missing-worktree';
+    portSquatted?: boolean;
+}
+export declare function leaseChecks(rows: LeaseHealthRow[]): DoctorCheck[];
+export interface EventLogIntegrity {
+    total: number;
+    unparseable: number;
+}
+export declare function analyzeEventLog(content: string): EventLogIntegrity;
+export declare function eventLogCheck(integrity: EventLogIntegrity | null): DoctorCheck;
+export interface ReapRow {
+    name: string;
+    removed: boolean;
+    detail: string;
+}
+export declare function orphanContainerChecks(names: readonly string[]): DoctorCheck[];
+export declare function orphanMicroVmChecks(names: readonly string[]): DoctorCheck[];
+export declare function formatContainerReconcileReport(reaped: ReapRow[]): string;
+export declare function formatMicroVmReconcileReport(reaped: ReapRow[]): string;
+export declare function formatReconcileReport(reaped: Array<{
+    lease: {
+        worktreeId: string;
+        port: number;
+    };
+    reason: string;
+}>): string;
+/** One worktree the reconcile pass removed. Structurally the subset of core's `GcCandidate`
+ *  that the report renders — kept local so `doctor.ts` stays dependency-free and unit-testable. */
+export interface ReconciledWorktree {
+    path: string;
+    branch: string | null;
+    reason: string;
+    branchDeleted: boolean;
+}
+export declare function formatWorktreeReconcileReport(removed: ReconciledWorktree[]): string;
+/** One claim the reconcile pass put back in the queue. Structurally the subset of core's
+ *  `StaleClaimRelease` that the report renders — kept local so `doctor.ts` stays
+ *  dependency-free and unit-testable. */
+export interface ReleasedClaim {
+    issue: number;
+    expiresAt: number;
+    released: boolean;
+    detail?: string;
+}
+export declare function formatClaimReconcileReport(released: ReleasedClaim[]): string;
+/** One green-and-ready PR nobody merged. Structurally the subset of core's `UnmergedGreenPr`
+ *  the report renders — kept local so `doctor.ts` stays dependency-free and unit-testable. */
+export interface UnmergedGreenPrRow {
+    number: number;
+    branch: string;
+    issue: number | null;
+    ageHours: number;
+}
+/** Outcome of the green-PR scan: it ran, it was skipped (no repo/token), or it failed. */
+export type GreenPrScanResult = {
+    status: 'ok';
+    rows: UnmergedGreenPrRow[];
+} | {
+    status: 'skipped';
+    detail: string;
+} | {
+    status: 'failed';
+    detail: string;
+};
+export declare function unmergedGreenPrChecks(result: GreenPrScanResult): DoctorCheck[];
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

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

package/dist/cli/doctor.js

@@ -0,0 +1,400 @@
+// packages/cli/src/cli/doctor.ts — `factory doctor` environment preflight
+import { resolve } from 'node:path';
+import { CLAUDE_CODE_URL, GITHUB_TOKENS_URL } from './first-run.js';
+export function runDoctorChecks(probes) {
+    const { commandAvailable, envPresent, tryExec, pathExists, distFreshness } = probes;
+    const checks = [];
+    const repoRoot = tryExec('git rev-parse --show-toplevel');
+    checks.push(repoRoot !== null
+        ? { name: 'git repository', ok: true, detail: repoRoot }
+        : {
+            name: 'git repository',
+            ok: false,
+            detail: 'not inside a git repository',
+            fix: 'run factory inside a git repo (`git init` or clone one)',
+        });
+    checks.push(commandAvailable('claude')
+        ? { name: 'claude CLI', ok: true, detail: 'found on PATH' }
+        : {
+            name: 'claude CLI',
+            ok: false,
+            detail: 'not found on PATH',
+            fix: `install Claude Code first: ${CLAUDE_CODE_URL}`,
+        });
+    if (!commandAvailable('gh')) {
+        checks.push({
+            name: 'gh auth',
+            ok: false,
+            detail: 'gh CLI not found on PATH',
+            fix: 'install GitHub CLI and run `gh auth login`',
+        });
+    }
+    else if (tryExec('gh auth status') === null) {
+        checks.push({
+            name: 'gh auth',
+            ok: false,
+            detail: 'gh is not authenticated',
+            fix: 'install GitHub CLI and run `gh auth login`',
+        });
+    }
+    else {
+        checks.push({ name: 'gh auth', ok: true, detail: 'authenticated' });
+    }
+    if (envPresent('GITHUB_TOKEN')) {
+        checks.push({ name: 'GitHub token', ok: true, detail: 'GITHUB_TOKEN set' });
+    }
+    else if (envPresent('GH_TOKEN')) {
+        checks.push({ name: 'GitHub token', ok: true, detail: 'GH_TOKEN set' });
+    }
+    else {
+        const token = tryExec('gh auth token');
+        if (token) {
+            checks.push({ name: 'GitHub token', ok: true, detail: 'using gh auth token' });
+        }
+        else {
+            checks.push({
+                name: 'GitHub token',
+                ok: false,
+                detail: 'no GITHUB_TOKEN, GH_TOKEN, or gh auth token',
+                fix: `create a token at ${GITHUB_TOKENS_URL} and export it`,
+            });
+        }
+    }
+    checks.push(commandAvailable('npm')
+        ? { name: 'npm', ok: true, detail: 'found on PATH' }
+        : {
+            name: 'npm',
+            ok: false,
+            detail: 'not found on PATH',
+            fix: 'install Node.js >= 20 (which ships npm): https://nodejs.org',
+        });
+    if (repoRoot === null) {
+        checks.push({
+            name: 'git worktree clean',
+            ok: false,
+            optional: true,
+            detail: 'skipped — not a git repository',
+        });
+    }
+    else if (tryExec('git status --porcelain') === '') {
+        checks.push({ name: 'git worktree clean', ok: true, detail: 'clean' });
+    }
+    else {
+        checks.push({
+            name: 'git worktree clean',
+            ok: false,
+            optional: true,
+            detail: 'uncommitted changes present',
+            fix: 'commit or stash changes before running the factory',
+        });
+    }
+    checks.push(commandAvailable('codex')
+        ? { name: 'codex sandbox', ok: true, optional: true, detail: 'codex CLI found (sandboxed builds available)' }
+        : {
+            name: 'codex sandbox',
+            ok: false,
+            optional: true,
+            detail: 'codex CLI not found — codex build routes unavailable',
+            fix: 'install the codex CLI, or rely on claude routes',
+        });
+    if (repoRoot === null) {
+        checks.push({
+            name: '.factory initialized',
+            ok: false,
+            optional: true,
+            detail: 'skipped — not a git repository',
+        });
+    }
+    else if (pathExists(resolve(repoRoot, '.factory'))) {
+        checks.push({ name: '.factory initialized', ok: true, optional: true, detail: '.factory/ present' });
+    }
+    else {
+        checks.push({
+            name: '.factory initialized',
+            ok: false,
+            optional: true,
+            detail: '.factory/ missing',
+            fix: 'run `factory init`',
+        });
+    }
+    if (distFreshness) {
+        const { fresh, detail } = distFreshness();
+        checks.push(fresh
+            ? { name: 'compiled dist fresh', ok: true, detail }
+            : {
+                name: 'compiled dist fresh',
+                ok: false,
+                detail,
+                fix: "run 'npm run build' at the monorepo root",
+            });
+    }
+    return checks;
+}
+export function formatDoctorChecks(checks) {
+    const lines = ['== factory doctor =='];
+    let passed = 0;
+    let failed = 0;
+    let warnings = 0;
+    for (const check of checks) {
+        if (check.ok) {
+            passed++;
+        }
+        else if (check.optional) {
+            warnings++;
+        }
+        else {
+            failed++;
+        }
+        const icon = check.ok ? '✅' : '❌';
+        lines.push(`  ${icon} ${check.name} — ${check.detail}`);
+        if (!check.ok && check.fix) {
+            lines.push(`       fix: ${check.fix}`);
+        }
+    }
+    lines.push(`${passed} passed, ${failed} failed, ${warnings} warnings`);
+    lines.push('');
+    lines.push('Model reachability: factory models --doctor');
+    return lines.join('\n');
+}
+export function doctorFailed(checks) {
+    return checks.some((c) => !c.ok && !c.optional);
+}
+/** The keychain service Claude Code uses for the default profile (CLAUDE_CONFIG_DIR unset). */
+const DEFAULT_KEYCHAIN_SERVICE = 'Claude Code-credentials';
+function loginFix(profile) {
+    return profile.configDir ? `CLAUDE_CONFIG_DIR=${profile.configDir} claude` : '`claude`';
+}
+export function claudeKeychainCheck(probe) {
+    if (probe.status === 'skipped') {
+        return { name: 'claude keychain (macOS)', ok: true, optional: true, detail: probe.detail };
+    }
+    const service = probe.service ?? DEFAULT_KEYCHAIN_SERVICE;
+    const profile = probe.configDir ? ` (profile CLAUDE_CONFIG_DIR=${probe.configDir})` : '';
+    if (probe.status === 'readable') {
+        return {
+            name: 'claude keychain (macOS)',
+            ok: true,
+            detail: `login keychain entry '${service}'${profile} is readable in this context`,
+        };
+    }
+    if (probe.inTmux) {
+        return {
+            name: 'claude keychain (macOS)',
+            ok: false,
+            detail: `security find-generic-password -s '${service}'${profile} failed inside tmux (SecKeychainSearchCopyNext) — Claude OAuth refresh will fail with local_auth`,
+            fix: 'run the factory from a context with login-keychain access — a LaunchAgent in the gui domain (launchctl bootstrap gui/$(id -u) …) or a login Terminal, not a raw tmux pane — see docs/runbooks/macos-keychain-launchagent.md',
+        };
+    }
+    return {
+        name: 'claude keychain (macOS)',
+        ok: false,
+        optional: true,
+        detail: `security find-generic-password -s '${service}'${profile} failed — either never logged in, or this launch context cannot read the login keychain`,
+        fix: `run ${loginFix(probe)} and complete /login (or export ANTHROPIC_API_KEY); if already logged in, see docs/runbooks/macos-keychain-launchagent.md`,
+    };
+}
+/** Non-null when `factory run` must fail fast instead of claiming issues (#1014).
+ *  Only the tmux-without-keychain differential is certain enough to abort a run on. */
+export function keychainPreflightError(probe) {
+    if (probe.status !== 'unreadable' || !probe.inTmux)
+        return null;
+    const service = probe.service ?? DEFAULT_KEYCHAIN_SERVICE;
+    return `Claude Code credentials are not readable from this tmux session (security find-generic-password -s '${service}' failed / SecKeychainSearchCopyNext). OAuth refresh will fail and every claimed issue would spuriously park as local_auth. Launch the factory from a context with login-keychain access — a LaunchAgent in the gui domain (launchctl bootstrap gui/$(id -u) …) or a login Terminal — or export ANTHROPIC_API_KEY. See docs/runbooks/macos-keychain-launchagent.md.`;
+}
+const HOST_AUTH_CHECK = 'claude auth (host)';
+const SANDBOX_AUTH_CHECK = 'claude auth (sandboxed)';
+/** Reports host and sandboxed Claude auth as two separate checks (#1008). Only the
+ *  differential — host ok, sandboxed failed — is a hard doctor failure; that is the one
+ *  combination that proves the sandbox, not the credentials, is at fault. */
+export function sandboxClaudeAuthChecks(result) {
+    const host = result.host === 'ok'
+        ? { name: HOST_AUTH_CHECK, ok: true, detail: result.hostDetail }
+        : result.host === 'skipped'
+            ? { name: HOST_AUTH_CHECK, ok: true, optional: true, detail: result.hostDetail }
+            : {
+                name: HOST_AUTH_CHECK,
+                ok: false,
+                detail: result.hostDetail,
+                fix: 'run `claude` and complete /login, then re-run `factory doctor`',
+            };
+    let sandboxed;
+    if (result.sandboxed === 'ok') {
+        sandboxed = { name: SANDBOX_AUTH_CHECK, ok: true, detail: result.sandboxDetail };
+    }
+    else if (result.sandboxed === 'skipped') {
+        sandboxed = { name: SANDBOX_AUTH_CHECK, ok: true, optional: true, detail: result.sandboxDetail };
+    }
+    else if (result.host === 'ok') {
+        sandboxed = {
+            name: SANDBOX_AUTH_CHECK,
+            ok: false,
+            detail: `${result.sandboxDetail} — host claude auth is healthy, so the sandbox is blocking Claude credential refresh`,
+            fix: 'check the sandbox write allowlist (~/.claude.json*, $CLAUDE_CONFIG_DIR when set, ~/Library/Keychains); as a stopgap run with FACTORY_SANDBOX=0',
+        };
+    }
+    else {
+        sandboxed = {
+            name: SANDBOX_AUTH_CHECK,
+            ok: false,
+            optional: true,
+            detail: `${result.sandboxDetail} — host claude auth is not healthy either, so this is not attributable to the sandbox`,
+            fix: 'fix host claude auth first, then re-run `factory doctor`',
+        };
+    }
+    return [host, sandboxed];
+}
+export function leaseChecks(rows) {
+    if (rows.length === 0) {
+        return [{ name: 'port leases', ok: true, optional: true, detail: 'no active leases' }];
+    }
+    return rows.map((row) => {
+        if (row.alive) {
+            return {
+                name: `port lease :${row.port}`,
+                ok: true,
+                optional: true,
+                detail: `${row.worktreeId} — port ${row.port}, pid ${row.pid}, live`,
+            };
+        }
+        const squatted = row.portSquatted ? '; port still in use by another process' : '';
+        return {
+            name: `port lease :${row.port}`,
+            ok: false,
+            optional: true,
+            detail: `${row.worktreeId} — port ${row.port}, pid ${row.pid}, stale (${row.reason})${squatted}`,
+            fix: 'run `factory doctor --reconcile` to reclaim stale leases',
+        };
+    });
+}
+export function analyzeEventLog(content) {
+    const lines = content.split('\n').filter((l) => l.trim() !== '');
+    let unparseable = 0;
+    for (const line of lines) {
+        try {
+            JSON.parse(line);
+        }
+        catch {
+            unparseable++;
+        }
+    }
+    return { total: lines.length, unparseable };
+}
+export function eventLogCheck(integrity) {
+    if (integrity === null) {
+        return { name: 'event log integrity', ok: true, optional: true, detail: 'no events.ndjson yet' };
+    }
+    if (integrity.total === 0) {
+        return { name: 'event log integrity', ok: true, optional: true, detail: 'events.ndjson is empty' };
+    }
+    const pct = ((integrity.unparseable / integrity.total) * 100).toFixed(1);
+    if (integrity.unparseable === 0) {
+        return {
+            name: 'event log integrity',
+            ok: true,
+            optional: true,
+            detail: `${integrity.total} lines, 0 unparseable (0.0%)`,
+        };
+    }
+    return {
+        name: 'event log integrity',
+        ok: false,
+        optional: true,
+        detail: `${integrity.unparseable} of ${integrity.total} lines unparseable (${pct}%)`,
+        fix: 'historical corruption from pre-lock parallel writes; appends are now serialized — metrics over this file carry this error bar',
+    };
+}
+export function orphanContainerChecks(names) {
+    if (names.length === 0) {
+        return [{ name: 'orphan containers', ok: true, detail: 'no orphan sf-job-*/factory.managed containers' }];
+    }
+    return names.map((name) => ({
+        name: `orphan container ${name}`,
+        ok: false,
+        detail: `${name} is stopped and not tied to any running job`,
+        fix: 'run `factory doctor --reconcile` to remove it and its anonymous volumes',
+    }));
+}
+export function orphanMicroVmChecks(names) {
+    if (names.length === 0) {
+        return [{ name: 'orphan sbx VMs', ok: true, detail: 'no orphan factory-* sbx VMs' }];
+    }
+    return names.map((name) => ({
+        name: `orphan sbx VM ${name}`,
+        ok: false,
+        detail: `${name} has no active lane holding its worktree`,
+        fix: 'run `factory doctor --reconcile` to remove it via `sbx rm --force`',
+    }));
+}
+export function formatContainerReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no orphan containers';
+    return reaped
+        .map((r) => r.removed
+        ? `reconcile: removed container ${r.name}`
+        : `reconcile: failed to remove container ${r.name} — ${r.detail}`)
+        .join('\n');
+}
+export function formatMicroVmReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no orphan sbx VMs';
+    return reaped
+        .map((r) => r.removed
+        ? `reconcile: removed sbx VM ${r.name} (sbx rm --force)`
+        : `reconcile: failed to remove sbx VM ${r.name} — ${r.detail}`)
+        .join('\n');
+}
+export function formatReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no stale leases';
+    return reaped
+        .map((r) => `reconcile: freed port ${r.lease.port} (worktree ${r.lease.worktreeId}, reason ${r.reason})`)
+        .join('\n');
+}
+export function formatWorktreeReconcileReport(removed) {
+    if (removed.length === 0)
+        return 'reconcile: no dead-run worktrees';
+    return removed
+        .map((w) => {
+        const branchLabel = w.branch ?? 'detached';
+        const deleted = w.branchDeleted ? `, deleted branch ${w.branch}` : '';
+        return `reconcile: removed worktree ${w.path} (branch ${branchLabel}, reason ${w.reason})${deleted}`;
+    })
+        .join('\n');
+}
+export function formatClaimReconcileReport(released) {
+    if (released.length === 0)
+        return 'reconcile: no stale claims';
+    return released
+        .map((c) => c.released
+        ? `reconcile: released issue #${c.issue} back to factory:queued (lease expired at ${c.expiresAt})`
+        : `reconcile: failed to release issue #${c.issue} (lease expired at ${c.expiresAt}) — ${c.detail ?? 'unknown error'}`)
+        .join('\n');
+}
+const GREEN_PR_CHECK = 'green PRs awaiting merge';
+export function unmergedGreenPrChecks(result) {
+    if (result.status === 'skipped') {
+        return [{ name: GREEN_PR_CHECK, ok: true, optional: true, detail: result.detail }];
+    }
+    if (result.status === 'failed') {
+        return [
+            {
+                name: GREEN_PR_CHECK,
+                ok: false,
+                optional: true,
+                detail: `scan failed — ${result.detail}`,
+                fix: 'check `gh auth status` and network access, then re-run `factory doctor`',
+            },
+        ];
+    }
+    if (result.rows.length === 0) {
+        return [{ name: GREEN_PR_CHECK, ok: true, optional: true, detail: 'no green-and-ready PRs awaiting merge' }];
+    }
+    return result.rows.map((row) => ({
+        name: `green PR #${row.number}`,
+        ok: false,
+        optional: true,
+        detail: `${row.issue === null ? 'owning issue unknown' : `issue #${row.issue}`} — green and ready on ${row.branch}, open ${row.ageHours}h, not merged`,
+        fix: `review and merge #${row.number} (or close it) — the factory never auto-merges an orphaned PR`,
+    }));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/feedback.d.ts

@@ -0,0 +1,74 @@
+import type { FileBugResult, FilingGitHubClient } from '@on-par/factory-core/internal';
+import type { Octokit } from '@octokit/rest';
+export declare const FEEDBACK_TRIAGE_LABEL = "factory:needs-triage";
+export declare const FEEDBACK_LABELS: string[];
+export interface ReviewFinding {
+    author: string;
+    kind: 'review' | 'comment';
+    body: string;
+    at: string;
+    state?: string;
+    path?: string;
+    line?: number;
+    url?: string;
+}
+interface PrRef {
+    owner: string;
+    repo: string;
+    number: number;
+}
+export interface FeedbackGitHubClient {
+    getPull(input: PrRef): Promise<{
+        headRef: string;
+        title: string;
+        url: string;
+    }>;
+    listReviews(input: PrRef): Promise<Array<{
+        user: string;
+        state: string;
+        body: string;
+        submittedAt: string;
+        url?: string;
+    }>>;
+    listReviewComments(input: PrRef): Promise<Array<{
+        user: string;
+        body: string;
+        path?: string;
+        line?: number;
+        createdAt: string;
+        url?: string;
+    }>>;
+}
+export interface FeedbackDeps {
+    github: FeedbackGitHubClient;
+    filing: FilingGitHubClient;
+    paths: {
+        events: string;
+        plans: string;
+        logs: string;
+    };
+    branchPrefix?: string;
+    now: () => Date;
+    host?: string;
+    internalRepo?: string;
+}
+export declare function parseFeedbackPrUrl(raw: string): {
+    owner: string;
+    repo: string;
+    number: number;
+    url: string;
+};
+export declare function collectReviewFindings(client: FeedbackGitHubClient, pr: PrRef): Promise<ReviewFinding[]>;
+export declare function buildFeedbackTitle(findings: readonly ReviewFinding[], note?: string): string;
+export declare function runFeedback(prUrl: string, opts: {
+    note?: string;
+}, deps: FeedbackDeps): Promise<FileBugResult>;
+export declare function createOctokitFeedbackClient(octokit: Octokit): FeedbackGitHubClient;
+/** Wire the real GitHub clients and run-state paths into FeedbackDeps. */
+export declare function buildFeedbackDeps(octokit: Octokit, paths: {
+    events: string;
+    plans: string;
+    logs: string;
+}, branchPrefix: string, createFilingClient: (octokit: Octokit) => FilingGitHubClient): FeedbackDeps;
+export {};
+//# sourceMappingURL=feedback.d.ts.map

package/dist/cli/feedback.d.ts.map

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