/**
 * `slowcook upsert-agent-docs` — α.64
 *
 * Writes (or refreshes) a marker-delimited "managed block" inside the
 * consumer's agent-pointer doc(s) so that ANY visiting AI agent —
 * Claude Code, Cursor, OpenAI Codex, Windsurf, etc. — discovers the
 * slowcook methodology + the `.brewing/repo-knowledge/curated/`
 * goldmine on first read.
 *
 * Strategy:
 *   1. Scan for existing agent-pointer files:
 *        AGENTS.md, CLAUDE.md, .cursorrules, .windsurfrules, GEMINI.md,
 *        .github/copilot-instructions.md
 *      For each that exists → upsert the managed block (markers below).
 *   2. If NONE exist → create AGENTS.md as the canonical home.
 *   3. README.md: add a one-line pointer to AGENTS.md if not present.
 *   4. .gitignore: ensure `.brewing/repo-knowledge/auto/` is ignored
 *      and `.brewing/repo-knowledge/curated/` is NOT (auto = derived,
 *      curated = tracked organizational memory).
 *
 * The block is delimited with HTML comments humans wouldn't write by
 * hand:
 *   <!-- BEGIN: managed by slowcook upsert-agent-docs — edit outside markers -->
 *   ...
 *   <!-- END: managed by slowcook upsert-agent-docs -->
 *
 * Idempotent: re-running on a file with the block already present
 * just refreshes the content between the markers. Content outside is
 * never touched.
 *
 * Called from `slowcook init` automatically AND as a standalone
 * command for repos that already ran `init` and want to refresh the
 * block when the canonical content evolves.
 */
export declare function buildManagedBlock(): string;
export interface UpsertAgentDocsResult {
    filesUpserted: Array<{
        path: string;
        action: "created" | "refreshed" | "unchanged";
    }>;
    readme: "added" | "already-present" | "no-readme";
    gitignore: "added" | "already-present" | "no-gitignore";
}
export declare function upsertAgentDocsCore(repoRoot: string, opts?: {
    dryRun?: boolean;
}): UpsertAgentDocsResult;
export declare function upsertAgentDocs(argv: string[]): Promise<void>;
//# sourceMappingURL=upsert-agent-docs.d.ts.map