@aperant/framework 0.6.2

package/dist/cli/commands/personas.mjs

@@ -0,0 +1,306 @@
+/**
+ * commands/personas.mjs — `apt-tools personas <sub>` (C48).
+ *
+ * Deterministic CLI surface for the apt:personas skill. This command never
+ * calls an LLM. The SKILL.md body invokes the host LLM to author personas +
+ * classify tiers, then hands the structured payload to this CLI for
+ * persistence + run tracking.
+ *
+ * Subcommand menu:
+ *
+ *   apt-tools personas scan <project-dir>
+ *     → emit the role-scan envelope (read-only). The SKILL.md body injects
+ *       this into the LLM prompt alongside the tier rubric.
+ *
+ *   apt-tools personas rubric <project-dir>
+ *     → emit the tier-rubric prompt body. Inputs come from product-
+ *       context.json + role-scan; the CLI composes them into the exact text
+ *       the SKILL.md body hands to the host LLM.
+ *
+ *   apt-tools personas read <project-dir>
+ *     → emit the current `.aperant/personas.json` envelope (or null if
+ *       missing). Used by --from-app flows and by `/apt:docs` to render
+ *       personas into README / ABOUT.
+ *
+ *   apt-tools personas write <project-dir>
+ *       --mode <fresh | extend | from-app>
+ *       [--payload <path>]
+ *       [--force]
+ *     → persist personas. `--payload` points to a JSON file containing a
+ *       Persona[] array — the SKILL.md body writes it to a tmp path so the
+ *       CLI can consume it without argv explosion.
+ *
+ *   apt-tools personas record-run <project-dir>
+ *       --status <pending | running | completed | failed>
+ *       [--candidates-found N] [--phase <slug>] [--error <msg>]
+ *     → append an entry to `.aperant/personas-runs.json` (D-09).
+ *
+ * Return shape: always `{ status, command, ... }`. On refused writes (D-10
+ * guard hit without --force), exits 0 with `status: 'refused'` so the
+ * SKILL.md body can pick up the message and ask the user — we do NOT exit 1
+ * here, that would break auto-mode branches.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { runRoleScan } from '../personas/role-scan.mjs';
+import { FRAMEWORK_LOCAL_TEAM_ID, PERSONAS_ENVELOPE_VERSION, personasPaths, readFromApp, readPersonas, readRuns, recordRun, resolveProjectId, writeExtend, writeFresh, } from '../personas/sidecar.mjs';
+import { buildTierPrompt, buildTierRubricPrompt } from '../personas/tier-rubric.mjs';
+import { getFlagValue, resolveProjectDir } from '../util/common-flags.mjs';
+import { err, ok } from '../util/result.mjs';
+/**
+ * @param {string | undefined} subcommand
+ * @param {string[] | undefined} extraArgs
+ */
+export function cmdPersonas(subcommand, extraArgs) {
+    const args = extraArgs ?? [];
+    if (!subcommand) {
+        return err('Usage: apt-tools personas <scan|rubric|read|write|record-run> <project-dir> [flags]\n' +
+            '  scan            emit role-scan findings\n' +
+            '  rubric          emit tier-assignment prompt body (rubric + inputs)\n' +
+            '  read            emit current .aperant/personas.json envelope\n' +
+            '  write           persist personas (--mode fresh|extend|from-app, --payload <path>, --force)\n' +
+            '  record-run      append entry to .aperant/personas-runs.json');
+    }
+    switch (subcommand) {
+        case 'scan':
+            return cmdScan(args);
+        case 'rubric':
+            return cmdRubric(args);
+        case 'read':
+            return cmdRead(args);
+        case 'write':
+            return cmdWrite(args);
+        case 'record-run':
+            return cmdRecordRun(args);
+        default:
+            return err(`apt-tools personas: unknown subcommand "${subcommand}". ` +
+                'Known: scan, rubric, read, write, record-run');
+    }
+}
+/**
+ * scan — role-scan findings. Read-only, no files written.
+ *
+ * @param {string[]} args
+ */
+function cmdScan(args) {
+    const projectDir = resolveProjectDir(args);
+    const result = runRoleScan(projectDir);
+    return ok({
+        status: 'ok',
+        command: 'personas-scan',
+        projectDir,
+        team_id: FRAMEWORK_LOCAL_TEAM_ID,
+        project_id: resolveProjectId(projectDir),
+        result,
+    });
+}
+/**
+ * rubric — emit the tier-rubric prompt body. Inputs come from the project's
+ * product-context.json (C44); the role-scan is combined in-line so the
+ * SKILL.md body can hand a single text block to the host LLM.
+ *
+ * @param {string[]} args
+ */
+function cmdRubric(args) {
+    const projectDir = resolveProjectDir(args);
+    const productContextPath = resolve(projectDir, '.aperant', 'product-context.json');
+    /** @type {any} */
+    let productContext = null;
+    if (existsSync(productContextPath)) {
+        try {
+            productContext = JSON.parse(readFileSync(productContextPath, 'utf-8'));
+        }
+        catch {
+            productContext = null;
+        }
+    }
+    const scan = runRoleScan(projectDir);
+    const inputs = {
+        productName: productContext?.productName ?? 'Unnamed Project',
+        productDescription: productContext?.productDescription ?? '',
+        targetAudience: productContext?.targetAudience ?? '',
+        coreValue: productContext?.productDescription ?? '',
+        uniqueRoleStrings: scan.unique_role_strings,
+        roleFindings: scan.findings,
+        features: Array.isArray(productContext?.features) ? productContext.features : [],
+    };
+    const prompt = buildTierPrompt(inputs);
+    const rubricOnly = buildTierRubricPrompt();
+    return ok({
+        status: 'ok',
+        command: 'personas-rubric',
+        projectDir,
+        product_context_present: Boolean(productContext),
+        inputs,
+        rubric: rubricOnly,
+        prompt,
+    });
+}
+/**
+ * read — emit the current personas envelope.
+ *
+ * @param {string[]} args
+ */
+function cmdRead(args) {
+    const projectDir = resolveProjectDir(args);
+    const envelope = readPersonas(projectDir);
+    const runs = readRuns(projectDir);
+    return ok({
+        status: 'ok',
+        command: 'personas-read',
+        projectDir,
+        paths: personasPaths(projectDir),
+        envelope,
+        runs_count: runs.runs.length,
+    });
+}
+/**
+ * write — persist personas. The payload is passed via a file path because
+ * persona ui_json blobs can be multi-KB, and argv limits are unfriendly.
+ *
+ * @param {string[]} args
+ */
+function cmdWrite(args) {
+    const projectDir = resolveProjectDir(args);
+    const flags = new Set(args.filter((a) => a.startsWith('--') && !hasValueAfter(args, a)));
+    const mode = getFlagValue(args, '--mode') ?? 'extend';
+    const payloadPath = getFlagValue(args, '--payload');
+    const force = flags.has('--force');
+    if (mode !== 'fresh' && mode !== 'extend' && mode !== 'from-app') {
+        return err(`personas write: unknown --mode "${mode}" (known: fresh, extend, from-app)`);
+    }
+    if (mode === 'from-app') {
+        const result = readFromApp(projectDir);
+        return ok({
+            status: result.status === 'ok' ? 'ok' : 'not-found',
+            command: 'personas-write',
+            mode,
+            projectDir,
+            message: result.message,
+            envelope: result.envelope,
+        });
+    }
+    if (!payloadPath) {
+        return err(`personas write --mode ${mode} requires --payload <path-to-json>`);
+    }
+    const abs = resolve(payloadPath);
+    if (!existsSync(abs)) {
+        return err(`personas write: payload not found at ${abs}`);
+    }
+    let personas;
+    try {
+        const raw = readFileSync(abs, 'utf-8');
+        personas = JSON.parse(raw);
+    }
+    catch (e) {
+        return err(`personas write: unable to parse payload at ${abs}: ${errMsg(e)}`);
+    }
+    if (!Array.isArray(personas)) {
+        return err('personas write: payload must be a JSON array of Persona objects');
+    }
+    if (mode === 'fresh') {
+        const result = writeFresh(projectDir, personas, { force });
+        return ok({
+            status: result.status,
+            command: 'personas-write',
+            mode,
+            projectDir,
+            schema_version: PERSONAS_ENVELOPE_VERSION,
+            guard_reason: result.guardReason,
+            envelope: result.envelope,
+            written_path: personasPaths(projectDir).personas,
+        });
+    }
+    // mode === 'extend'
+    const result = writeExtend(projectDir, personas);
+    return ok({
+        status: 'ok',
+        command: 'personas-write',
+        mode,
+        projectDir,
+        schema_version: PERSONAS_ENVELOPE_VERSION,
+        added_count: result.added.length,
+        skipped_count: result.skipped.length,
+        envelope: result.envelope,
+        written_path: personasPaths(projectDir).personas,
+    });
+}
+/**
+ * record-run — append an entry to `.aperant/personas-runs.json` (D-09).
+ *
+ * @param {string[]} args
+ */
+function cmdRecordRun(args) {
+    const projectDir = resolveProjectDir(args);
+    const status = getFlagValue(args, '--status');
+    if (!status || !['pending', 'running', 'completed', 'failed'].includes(status)) {
+        return err('personas record-run: --status is required (one of pending|running|completed|failed)');
+    }
+    const candidatesFoundRaw = getFlagValue(args, '--candidates-found');
+    const candidatesFound = candidatesFoundRaw ? Number.parseInt(candidatesFoundRaw, 10) : null;
+    const phase = getFlagValue(args, '--phase');
+    const errorMsg = getFlagValue(args, '--error');
+    const id = getFlagValue(args, '--id');
+    const startedAtRaw = getFlagValue(args, '--started-at');
+    const completedAtRaw = getFlagValue(args, '--completed-at');
+    /** @type {Record<string, unknown>} */
+    const payload = {
+        status: /** @type {'pending'|'running'|'completed'|'failed'} */ (status),
+    };
+    if (id)
+        payload.id = id;
+    if (phase)
+        payload.current_phase = phase;
+    if (errorMsg)
+        payload.error_message = errorMsg;
+    if (startedAtRaw) {
+        const n = Number.parseInt(startedAtRaw, 10);
+        if (Number.isFinite(n))
+            payload.started_at = n;
+    }
+    if (completedAtRaw) {
+        const n = Number.parseInt(completedAtRaw, 10);
+        if (Number.isFinite(n))
+            payload.completed_at = n;
+    }
+    if (candidatesFound !== null && Number.isFinite(candidatesFound)) {
+        payload.candidates_found = candidatesFound;
+    }
+    const run = recordRun(projectDir, /** @type {any} */ (payload));
+    return ok({
+        status: 'ok',
+        command: 'personas-record-run',
+        projectDir,
+        run,
+        path: personasPaths(projectDir).runs,
+    });
+}
+/**
+ * Detect whether a flag is being used as a key/value pair so we can skip it
+ * in the flag-set membership check.
+ *
+ * @param {string[]} args
+ * @param {string} flag
+ * @returns {boolean}
+ */
+function hasValueAfter(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx < 0)
+        return false;
+    const next = args[idx + 1];
+    if (!next)
+        return false;
+    return !next.startsWith('--');
+}
+/**
+ * @param {unknown} err
+ * @returns {string}
+ */
+function errMsg(err) {
+    if (err && typeof err === 'object' && 'message' in err) {
+        const m = /** @type {{ message: unknown }} */ (err).message;
+        return typeof m === 'string' ? m : String(m);
+    }
+    return String(err);
+}
+//# sourceMappingURL=personas.mjs.map

package/dist/cli/commands/personas.mjs.map

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

package/dist/cli/commands/plan-approval.d.mts

@@ -0,0 +1,2 @@
+export function cmdPlanApproval(subcommand: any, projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=plan-approval.d.mts.map

package/dist/cli/commands/plan-approval.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-approval.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/plan-approval.mjs"],"names":[],"mappings":"AAqDA,8HA+CC"}

package/dist/cli/commands/plan-approval.mjs

@@ -0,0 +1,228 @@
+/**
+ * commands/plan-approval.mjs — C21 plan-approval artifact CLI.
+ *
+ * Subcommands:
+ *   record       — write {task_dir}/plan_approval.json with the human decision.
+ *   read         — emit the existing plan_approval.json (or status:'missing').
+ *   verify-hash  — recompute sha256 of spec.md + implementation_plan.json and
+ *                  compare against the stored hashes; report drift.
+ *
+ * Schema (v1):
+ *   {
+ *     "$schema": "plan_approval.v1",
+ *     "task_id": string,
+ *     "decision": "approved" | "rejected" | "revise",
+ *     "actor":     string,            // user id, or "human" as default
+ *     "timestamp": string,            // ISO8601
+ *     "plan_hash": string,            // sha256(implementation_plan.json bytes)
+ *     "spec_hash": string,            // sha256(spec.md bytes)
+ *     "note":      string | null,     // optional reason / feedback
+ *     "iteration": number             // 1-based; auto-increments on re-record
+ *   }
+ *
+ * Atomic write — we route through util/io.mjs::atomicWriteJson so a crash
+ * mid-write cannot leave a partial file (R3 / AC-R4c).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { createCoordinationStore } from '../coordination/store.mjs';
+import { getTaskDir } from '../task/ids.mjs';
+import { parseFlags } from '../util/args.mjs';
+import { atomicWriteJson } from '../util/io.mjs';
+import { err, exitWith, ok, UsageError } from '../util/result.mjs';
+// Defense-in-depth: reject task-id strings that could escape the tasks dir
+// when joined into a filesystem path. The legitimate generator
+// (generateTaskId in task/ids.mjs) only emits `[a-z0-9-_]` segments.
+const TASK_ID_PATTERN = /^[A-Za-z0-9._-]+$/;
+const VALID_DECISIONS = new Set(['approved', 'rejected', 'revise']);
+/**
+ * Sentinel error class for helper-level usage failures inside cmdPlanApproval.
+ */
+class PlanApprovalUsageError extends UsageError {
+    constructor(message) {
+        super(message);
+        this.name = 'PlanApprovalUsageError';
+    }
+}
+export function cmdPlanApproval(subcommand, projectDir, extraArgs) {
+    if (!subcommand) {
+        return err('Usage: apt-tools plan-approval <record|read|verify-hash> <project-dir> [flags]');
+    }
+    if (!projectDir) {
+        return err(`Usage: apt-tools plan-approval ${subcommand} <project-dir> [flags]`);
+    }
+    const targetDir = resolve(projectDir);
+    const flags = parseFlags(extraArgs ?? []);
+    const taskId = flags.get('task');
+    if (!taskId || typeof taskId !== 'string') {
+        return err('Required: --task <task-id>');
+    }
+    // S3 — reject task-ids that contain path-traversal characters or separators
+    // before they reach `join()`. The generator only emits `[a-z0-9-_.]`.
+    if (!TASK_ID_PATTERN.test(taskId)) {
+        return err(`Invalid --task value: "${taskId}" (must match /^[A-Za-z0-9._-]+$/)`);
+    }
+    // L5 — resolve to the SHARED root (main repo's `.aperant/`) so that callers
+    // running inside a per-task worktree write/read the same plan_approval.json
+    // that `consistency check` reads. Without this, a worktree-resident
+    // `plan-approval record` would land under `worktree/.aperant/tasks/{id}/`
+    // while consistency reads from `mainRepo/.aperant/tasks/{id}/`.
+    const sharedRoot = createCoordinationStore(targetDir).resolveSharedRoot();
+    const taskDir = getTaskDir(sharedRoot, taskId);
+    if (!existsSync(taskDir)) {
+        return err(`task not found: ${taskId}`);
+    }
+    try {
+        switch (subcommand) {
+            case 'record':
+                return doRecord(taskDir, taskId, flags);
+            case 'read':
+                return doRead(taskDir, taskId);
+            case 'verify-hash':
+                return doVerifyHash(taskDir, taskId);
+            default:
+                return err(`Unknown plan-approval subcommand: ${subcommand}. Expected: record, read, verify-hash`);
+        }
+    }
+    catch (e) {
+        if (e instanceof PlanApprovalUsageError)
+            return err(e.message);
+        throw e;
+    }
+}
+function doRecord(taskDir, taskId, flags) {
+    const decision = flags.get('decision');
+    if (!decision || typeof decision !== 'string' || !VALID_DECISIONS.has(decision)) {
+        throw new PlanApprovalUsageError(`Required: --decision <${Array.from(VALID_DECISIONS).join('|')}> (got: ${decision ?? 'unset'})`);
+    }
+    const actorRaw = flags.get('actor');
+    const actor = typeof actorRaw === 'string' && actorRaw.trim() ? actorRaw.trim() : 'human';
+    const noteRaw = flags.get('note');
+    const note = typeof noteRaw === 'string' && noteRaw.length > 0 ? noteRaw : null;
+    const planPath = join(taskDir, 'implementation_plan.json');
+    const specPath = join(taskDir, 'spec.md');
+    const planHash = sha256File(planPath);
+    const specHash = sha256File(specPath);
+    const approvalPath = join(taskDir, 'plan_approval.json');
+    let iteration = 1;
+    if (existsSync(approvalPath)) {
+        try {
+            const prev = JSON.parse(readFileSync(approvalPath, 'utf-8'));
+            if (typeof prev?.iteration === 'number' && prev.iteration > 0) {
+                iteration = prev.iteration + 1;
+            }
+        }
+        catch {
+            // Corrupt previous file — treat as iteration 1.
+        }
+    }
+    const record = {
+        $schema: 'plan_approval.v1',
+        task_id: taskId,
+        decision,
+        actor,
+        timestamp: new Date().toISOString(),
+        plan_hash: planHash,
+        spec_hash: specHash,
+        note,
+        iteration,
+    };
+    atomicWriteJson(approvalPath, record);
+    return ok({
+        status: 'ok',
+        command: 'plan-approval-record',
+        path: approvalPath,
+        task_id: taskId,
+        decision,
+        actor,
+        iteration,
+        plan_hash: planHash,
+        spec_hash: specHash,
+    });
+}
+function doRead(taskDir, taskId) {
+    const approvalPath = join(taskDir, 'plan_approval.json');
+    if (!existsSync(approvalPath)) {
+        return ok({
+            status: 'missing',
+            command: 'plan-approval-read',
+            task_id: taskId,
+            path: approvalPath,
+        });
+    }
+    let record = null;
+    try {
+        record = JSON.parse(readFileSync(approvalPath, 'utf-8'));
+    }
+    catch (e) {
+        throw new PlanApprovalUsageError(`Failed to parse plan_approval.json: ${e.message}`);
+    }
+    return ok({
+        status: 'ok',
+        command: 'plan-approval-read',
+        task_id: taskId,
+        path: approvalPath,
+        record,
+    });
+}
+function doVerifyHash(taskDir, taskId) {
+    const approvalPath = join(taskDir, 'plan_approval.json');
+    if (!existsSync(approvalPath)) {
+        return ok({
+            status: 'missing',
+            command: 'plan-approval-verify-hash',
+            task_id: taskId,
+            path: approvalPath,
+        });
+    }
+    let record;
+    try {
+        record = JSON.parse(readFileSync(approvalPath, 'utf-8'));
+    }
+    catch (e) {
+        throw new PlanApprovalUsageError(`Failed to parse plan_approval.json: ${e.message}`);
+    }
+    const planPath = join(taskDir, 'implementation_plan.json');
+    const specPath = join(taskDir, 'spec.md');
+    const currentPlanHash = sha256File(planPath);
+    const currentSpecHash = sha256File(specPath);
+    const planMatch = currentPlanHash === record?.plan_hash;
+    const specMatch = currentSpecHash === record?.spec_hash;
+    const drift = [];
+    if (!planMatch) {
+        drift.push({
+            file: 'implementation_plan.json',
+            stored: record?.plan_hash ?? null,
+            current: currentPlanHash,
+        });
+    }
+    if (!specMatch) {
+        drift.push({
+            file: 'spec.md',
+            stored: record?.spec_hash ?? null,
+            current: currentSpecHash,
+        });
+    }
+    const envelope = {
+        status: drift.length === 0 ? 'ok' : 'drift',
+        command: 'plan-approval-verify-hash',
+        task_id: taskId,
+        path: approvalPath,
+        plan_match: planMatch,
+        spec_match: specMatch,
+        drift,
+    };
+    return drift.length === 0 ? ok(envelope) : exitWith(envelope, 1);
+}
+/**
+ * sha256 of a file's raw bytes, hex-encoded. Returns null when the file is
+ * missing — callers decide whether that is a fatal condition.
+ */
+function sha256File(path) {
+    if (!existsSync(path))
+        return null;
+    const buf = readFileSync(path);
+    return createHash('sha256').update(buf).digest('hex');
+}
+//# sourceMappingURL=plan-approval.mjs.map

package/dist/cli/commands/plan-approval.mjs.map

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

package/dist/cli/commands/pr-review-audit-fixer.d.mts

@@ -0,0 +1,96 @@
+/**
+ * Parse the terse status line fix agents emit. Case-insensitive on the
+ * PASS/FAIL token; all other fields must be integers. Malformed lines
+ * return null — callers should treat null as a hallucination signal
+ * (fail-closed).
+ */
+export function parseFixerStatusLine(line: any): {
+    fixed: number;
+    failed: number;
+    skipped: number;
+    verification: string;
+} | null;
+/**
+ * Parse a fixes-applied.md produced by apt-pr-review-fixer. Returns
+ * `{ fixes: Array<{id, title, file, verification}>, skipped: Array<{id}>, exists: true }`.
+ * Non-existent or empty report returns `{ exists: false, fixes: [], skipped: [] }`.
+ *
+ * "File" is extracted from `- **File**: path[:line]` anywhere inside the
+ * `### <id>` block. We strip any trailing `(created)` / `(modify)` etc
+ * annotation the fixer template shows as free-form text so the intersect
+ * step can match against `git diff --name-only` output cleanly.
+ */
+export function parseFixesAppliedMarkdown(md: any): {
+    exists: boolean;
+    fixes: {
+        id: any;
+        title: any;
+        file: string;
+        files: string[];
+        verification: string | null;
+    }[];
+    skipped: {
+        id: any;
+        title: any;
+    }[];
+};
+/**
+ * Set-intersect claimed files with the worktree diff. Path matching is
+ * done by exact equality after trimming; we also accept a suffix match
+ * (`diffPath.endsWith('/' + claimed)` or vice versa) to tolerate the
+ * fixer reporting `apps/desktop/...` while `git diff` from a nested
+ * worktree root emits the same path, or the reverse.
+ *
+ * Returns `{ matched: string[], unmatched: string[] }` where `matched`
+ * is the subset of `claimedFiles` that appear in `diffFiles`.
+ */
+export function intersectClaimedAndStaged(claimedFiles: any, diffFiles: any): {
+    matched: any[];
+    unmatched: any[];
+};
+/**
+ * Apply the verdict rules to the already-parsed inputs. Pure function —
+ * no I/O. Callers compose it over the raw inputs so tests can feed
+ * hand-crafted objects.
+ */
+export function decideVerdict({ statusLine, fixesApplied, diffFiles }: {
+    statusLine: any;
+    fixesApplied: any;
+    diffFiles: any;
+}): {
+    verdict: string;
+    reason: string;
+    claimed: null;
+    matched: never[];
+    unmatched: never[];
+    claimedFiles: never[];
+} | {
+    verdict: string;
+    reason: string;
+    claimed: {
+        fixed: number;
+        failed: number;
+        skipped: number;
+        verification: string;
+    };
+    matched: any[];
+    unmatched: any[];
+    claimedFiles: any;
+} | {
+    verdict: string;
+    reason: null;
+    claimed: {
+        fixed: number;
+        failed: number;
+        skipped: number;
+        verification: string;
+    };
+    matched: any[];
+    unmatched: any[];
+    claimedFiles: any;
+};
+/**
+ * Main command entry point. Wired into the pr-review dispatcher.
+ */
+export function cmdPrReviewAuditFixer(projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=pr-review-audit-fixer.d.mts.map

package/dist/cli/commands/pr-review-audit-fixer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-review-audit-fixer.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/pr-review-audit-fixer.mjs"],"names":[],"mappings":"AA+EA;;;;;GAKG;AACH;;;;;SAgBC;AAiBD;;;;;;;;;GASG;AACH;;;;;;;;;;;;;EASC;AAuQD;;;;;;;;;GASG;AACH;;;EAoBC;AAED;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwJC;AAgFD;;GAEG;AACH,mHA4NC"}