/**
 * toolchain.config contract.
 *
 * Every GoodVibes repo keeps a small `toolchain.config.json` (or a
 * `toolchain.config.ts` that default-exports a {@link ToolchainConfig}) at its
 * root. The published `@pellux/goodvibes-toolchain` package holds the behavior;
 * the config holds the repo-specific values (package names, binary matrix,
 * coverage floors, publish ordering) so one implementation serves every repo.
 *
 * The full contract and per-repo examples are documented in
 * `docs/release-and-publishing.md` (SDK repo).
 */
/** Where the SDK dependency pin lives and how the pin gate is parameterized. */
export interface SdkPinConfig {
    /** npm name of the pinned SDK package, e.g. `@pellux/goodvibes-sdk`. */
    readonly sdkPackage: string;
    /** Manifest group the pin is read from. TUI/webui use `dependencies`; the agent bundles the SDK as a `devDependencies` pin. */
    readonly pinSource: 'dependencies' | 'devDependencies';
    /** Lockfile whose text must resolve the pin, e.g. `bun.lock`. */
    readonly lockfile: string;
    /** Path (relative to repo root) of the dev-link overlay marker whose presence blocks a cut. */
    readonly overlayMarker: string;
    /** Source roots scanned for non-npm SDK imports. */
    readonly sourceRoots: readonly string[];
    /** When true, also assert every SDK subpath import resolves to a key in the installed package's `exports` map (webui browser-bundle gate). */
    readonly enforceExportsMap: boolean;
}
/** One row of the compiled-binary build matrix. */
export interface BinaryTarget {
    /** Canonical key, e.g. `linux-x64`. */
    readonly key: string;
    /** `bun build --compile --target` value, e.g. `bun-linux-x64`. */
    readonly bunTarget: string;
    /** Primary binary output name, e.g. `goodvibes-linux-x64`. */
    readonly appArtifact: string;
    /** Optional second binary (the TUI daemon leg), e.g. `goodvibes-daemon-linux-x64`. */
    readonly daemonArtifact?: string;
    /** Optional native-addon package that stays `--external` and is copied beside the binary, e.g. `sqlite-vec-linux-x64`. */
    readonly nativeAddonPackage?: string;
    /** Native-addon filename, e.g. `vec0.so` / `vec0.dylib`. */
    readonly nativeAddonFile?: string;
}
/** build-binaries parameters. */
export interface BuildConfig {
    /** Primary compile entrypoint, e.g. `src/main.ts`. */
    readonly appEntrypoint: string;
    /** Optional daemon compile entrypoint (present only for repos with a daemon leg), e.g. `src/daemon/cli.ts`. */
    readonly daemonEntrypoint?: string;
    /** Output directory for binaries, e.g. `dist`. */
    readonly outDir: string;
    /** Directory for copied native addons, e.g. `dist/lib`. */
    readonly addonOutDir: string;
    /** The build matrix. */
    readonly targets: readonly BinaryTarget[];
    /** Commands run once before compiling (each a full argv), e.g. `[["bun","run","scripts/prebuild.ts"]]`. */
    readonly prebuild: readonly (readonly string[])[];
}
/** coverage-gate ratchet floors and the coverage command. */
export interface CoverageConfig {
    readonly funcsFloor: number;
    readonly linesFloor: number;
    /** argv that emits Bun's text coverage table, e.g. `["bun","test","--coverage","src"]`. */
    readonly command: readonly string[];
}
/** post-build-smoke parameters. */
export interface SmokeConfig {
    /** Expected `--version` banner prefix, e.g. `goodvibes-agent `. */
    readonly bannerPrefix: string;
    /** Substrings whose presence in output signals a packaging failure, e.g. `["sqlite-vec","$bunfs/root"]`. */
    readonly forbiddenStrings: readonly string[];
    /**
     * Default binary path when `--binary` is not passed. Serves LOCAL CLI runs
     * only, CI matrix legs each build a different suffixed artifact, so the
     * reusable binary-matrix workflow always passes the leg's own `--binary`.
     */
    readonly binaryDefault: string;
}
/** release-cut parameters (prepare/bump/changelog/tag only, never re-runs gates). */
export interface ReleaseCutConfig {
    /** Branch a cut is allowed from, e.g. `main`. */
    readonly branch: string;
    /** Extra `package.json` paths (beyond root) whose version is stamped, e.g. platform-package manifests. */
    readonly versionFiles: readonly string[];
    /** Commands that sync generated version surfaces after the bump, e.g. `[["bun","run","scripts/prebuild.ts"]]`. */
    readonly syncCommands: readonly (readonly string[])[];
    /** Paths staged into the release commit. */
    readonly commitPaths: readonly string[];
    /** `bracket` → `## [x.y.z] - DATE`; `plain` → `## x.y.z - DATE`. */
    readonly changelogHeading: 'bracket' | 'plain';
    /** `first-separator` inserts the new section after the first `---`; `top` prepends above all sections. */
    readonly changelogInsertMarker: 'first-separator' | 'top';
}
/** publish-package parameters. */
export interface PublishPackageConfig {
    readonly packageName: string;
    readonly defaultRegistry: string;
    /** Tarball paths that must be present (all of them). */
    readonly requiredTarballPaths: readonly string[];
    /** Tarball path prefixes that must be absent. */
    readonly forbiddenTarballPrefixes: readonly string[];
    /** Hard cap on unpacked tarball size in bytes. */
    readonly maxTarballBytes: number;
}
/** per-job-green parameters. */
export interface PerJobGreenConfig {
    readonly owner: string;
    readonly repo: string;
    /** Workflow file whose run is verified, e.g. `ci.yml`. */
    readonly workflow: string;
    /** Triggering event to match, e.g. `push`. */
    readonly event: string;
    readonly pollIntervalMs: number;
    readonly deadlineMs: number;
    /** Bounded retry attempts applied to EVERY GitHub API call before its status is treated as final. */
    readonly retryAttempts: number;
    /** Sleep between retry attempts. */
    readonly retryDelayMs: number;
}
/** The complete repo config. All sections are optional so a repo declares only the tools it uses. */
export interface ToolchainConfig {
    /** npm name of the repo's primary package, e.g. `@pellux/goodvibes-tui`. */
    readonly packageName: string;
    readonly sdkPin?: SdkPinConfig;
    readonly build?: BuildConfig;
    readonly coverage?: CoverageConfig;
    readonly smoke?: SmokeConfig;
    readonly releaseCut?: ReleaseCutConfig;
    readonly publish?: PublishPackageConfig;
    readonly perJobGreen?: PerJobGreenConfig;
}
export declare const DEFAULT_SDK_PACKAGE = "@pellux/goodvibes-sdk";
export declare const DEFAULT_LOCKFILE = "bun.lock";
export declare const DEFAULT_REGISTRY = "https://registry.npmjs.org";
export declare const DEFAULT_POLL_INTERVAL_MS = 20000;
export declare const DEFAULT_DEADLINE_MS = 1800000;
export declare const DEFAULT_RETRY_ATTEMPTS = 8;
export declare const DEFAULT_RETRY_DELAY_MS = 7000;
/** Fill an SdkPinConfig with the conventional defaults for any missing field. */
export declare function resolveSdkPinConfig(partial: Partial<SdkPinConfig> | undefined): SdkPinConfig;
/** Fill a PerJobGreenConfig from a partial plus required identity fields. */
export declare function resolvePerJobGreenConfig(partial: Partial<PerJobGreenConfig> & Pick<PerJobGreenConfig, 'owner' | 'repo'>): PerJobGreenConfig;
/**
 * Parse a JSON toolchain config. Kept separate from disk I/O so callers can
 * validate a config object from any source (file, env, test fixture).
 */
export declare function parseToolchainConfig(raw: string): ToolchainConfig;
//# sourceMappingURL=config.d.ts.map