/**
 * Stage 1 capture gate — writes pending lessons to the session-scoped buffer
 * on disk for later user validation (per the context-clearing cycle).
 *
 * Authoritative source: `docs/opensquid-real-design.md` §"Two-stage wedge gate"
 * Stage 1 + §"Automation buffer pattern" §"Directory layout" + §"Context-
 * clearing cycle".
 *
 * Layout produced:
 *
 *   ~/.opensquid/sessions/<session-id>/pending-lessons/potential-lessons/
 *     <ts>_<type>_<id>.md
 *
 * Filename ordering: `<ISO-timestamp-with-colons-replaced>_<type>_<id>.md`.
 * Colons in ISO timestamps break Windows paths, so they collapse to `-`
 * (per spec risk callout 1). The deterministic ordering lets `walkBuffer`
 * (Task 7.2) iterate by chronological proposal order without sorting on
 * parsed frontmatter.
 *
 * Frontmatter is a strict subset of YAML — no nested keys, no multiline
 * values. The `sourceContext` and `content` fields are written into the
 * Markdown body (under headings) NOT the frontmatter — that sidesteps the
 * "body contains `---`" risk callout (a stray `---` in the lesson text
 * cannot break a frontmatter parser that doesn't try to match the body).
 *
 * Validation interface: this module exposes `validatePendingLesson(lesson)`
 * — callers MUST run it before calling `capturePendingLesson`. The function
 * surface is intentionally split (rather than auto-validating in capture) so
 * the caller can choose what to do with invalid input (drop silently, route
 * to the user, raise) without the file-writer making policy decisions.
 *
 * Imports from: node:fs/promises, node:path, ../paths, ./types.
 * Imported by: src/runtime/wedge/index.ts.
 */
import type { PendingLesson } from './types.js';
export declare function pendingLessonsDir(sessionId: string): string;
export declare function validatePendingLesson(lesson: PendingLesson): string | null;
export declare function safeTimestamp(iso: string): string;
export declare function capturePendingLesson(sessionId: string, lesson: PendingLesson): Promise<string>;
//# sourceMappingURL=capture.d.ts.map