/**
 * Repo-relative remediation hints for workspace-kit run JSON failures (Phase 52 / T625).
 * Agent-facing paths use .ai/ and src/modules/.../instructions/; maintainer mirrors are optional docAnchors.
 */
import type { CliRemediation } from "../contracts/module-contract.js";
export declare const CLI_REMEDIATION_INSTRUCTIONS: {
    readonly runTransition: "src/modules/task-engine/instructions/run-transition.md";
    readonly createTask: "src/modules/task-engine/instructions/create-task.md";
    readonly applyTaskBatch: "src/modules/task-engine/instructions/apply-task-batch.md";
    readonly persistPlanningExecutionDrafts: "src/modules/task-engine/instructions/persist-planning-execution-drafts.md";
    readonly updateTask: "src/modules/task-engine/instructions/update-task.md";
    readonly dashboardSummary: "src/modules/task-engine/instructions/dashboard-summary.md";
    readonly createWishlist: "src/modules/task-engine/instructions/create-wishlist.md";
    readonly archiveTask: "src/modules/task-engine/instructions/archive-task.md";
    readonly addDependency: "src/modules/task-engine/instructions/add-dependency.md";
    readonly generateRecommendations: "src/modules/improvement/instructions/generate-recommendations.md";
    readonly synthesizeTranscriptChurn: "src/modules/task-engine/instructions/synthesize-transcript-churn.md";
    readonly dismissPhaseNote: "src/modules/task-engine/instructions/dismiss-phase-note.md";
    readonly supersedePhaseNote: "src/modules/task-engine/instructions/supersede-phase-note.md";
    readonly completionPreflight: "src/modules/task-engine/instructions/completion-preflight.md";
    readonly harvestDeliveryEvidence: "src/modules/task-engine/instructions/harvest-delivery-evidence.md";
    readonly waitForPrChecks: "src/modules/task-engine/instructions/wait-for-pr-checks.md";
    readonly recommendValidation: "src/modules/task-engine/instructions/recommend-validation.md";
    readonly improvementDedupeExplain: "src/modules/task-engine/instructions/improvement-dedupe-explain.md";
    readonly improvementWorkflowSummary: "src/modules/task-engine/instructions/improvement-workflow-summary.md";
    readonly agentMutationPlan: "src/modules/task-engine/instructions/agent-mutation-plan.md";
    readonly getWorkspaceStatus: "src/modules/task-engine/instructions/get-workspace-status.md";
    readonly getLastOutput: "src/modules/task-engine/instructions/get-last-output.md";
};
/** Primary agent doc paths (`.ai/`). Use as `remediation.docPath` for routine agent work. */
export declare const CLI_REMEDIATION_DOCS: {
    readonly policyApproval: ".ai/POLICY-APPROVAL.md";
    readonly agentCliMap: ".ai/AGENT-CLI-MAP.md";
    readonly agentCliMapExtended: ".ai/AGENT-CLI-MAP.extended.md";
    readonly planningGeneration: ".ai/AGENT-CLI-MAP.extended.md";
    readonly remediationContract: ".ai/runbooks/agent-task-engine-ergonomics.md";
    readonly workspaceStatus: ".ai/runbooks/workspace-status-sqlite.md";
    readonly taskPersistence: ".ai/runbooks/task-persistence-operator.md";
};
/** Maintainer-depth mirrors; surface only as secondary `docAnchors` when needed. */
export declare const CLI_REMEDIATION_MAINTAINER_DOCS: {
    readonly policyApproval: "docs/maintainers/POLICY-APPROVAL.md";
    readonly agentCliMap: "docs/maintainers/AGENT-CLI-MAP.md";
    readonly planningGenerationAdr: "docs/maintainers/adrs/ADR-planning-generation-optimistic-concurrency.md";
    readonly remediationContract: "docs/maintainers/adrs/ADR-cli-error-remediation-contract.md";
    readonly workspaceStatus: "docs/maintainers/runbooks/workspace-status-sqlite.md";
    readonly taskPersistence: "docs/maintainers/runbooks/task-persistence-operator.md";
    readonly runtimeRunArgsPilot: "docs/maintainers/adrs/ADR-runtime-run-args-validation-pilot.md";
};
/** Stable codes surfaced on doctor --agent-instruction-surface for agents. */
export type ErrorRemediationCatalogEntry = {
    code: string;
    instructionPath?: string;
    docPath?: string;
    docAnchors?: string[];
};
export declare function buildAgentCliRemediation(parts: {
    instructionPath?: string;
    agentDocPath?: string;
    maintainerDocPath?: string;
}): CliRemediation;
export declare function buildErrorRemediationCatalog(): ErrorRemediationCatalogEntry[];
