@cleocode/core 2026.3.42 → 2026.3.44

package/dist/release/github-pr.d.ts

@@ -0,0 +1,63 @@
+export interface BranchProtectionResult {
+    protected: boolean;
+    detectionMethod: 'gh-api' | 'push-dry-run' | 'unknown';
+    error?: string;
+}
+export interface PRCreateOptions {
+    base: string;
+    head: string;
+    title: string;
+    body: string;
+    labels?: string[];
+    version: string;
+    epicId?: string;
+    projectRoot?: string;
+}
+export interface PRResult {
+    mode: 'created' | 'manual' | 'skipped';
+    prUrl?: string;
+    prNumber?: number;
+    instructions?: string;
+    error?: string;
+}
+export interface RepoIdentity {
+    owner: string;
+    repo: string;
+}
+/**
+ * Check if the `gh` CLI is available by attempting to run `gh --version`.
+ * Does NOT use `which` to remain cross-platform.
+ */
+export declare function isGhCliAvailable(): boolean;
+/**
+ * Parse a GitHub remote URL (HTTPS or SSH) into owner and repo components.
+ * Returns null if the URL cannot be parsed.
+ *
+ * Supported formats:
+ *   https://github.com/owner/repo.git
+ *   https://github.com/owner/repo
+ *   git@github.com:owner/repo.git
+ *   git@github.com:owner/repo
+ */
+export declare function extractRepoOwnerAndName(remote: string): RepoIdentity | null;
+/**
+ * Detect whether a branch has protection rules enabled.
+ *
+ * Strategy 1 (preferred): use `gh api` to query GitHub branch protection.
+ * Strategy 2 (fallback): use `git push --dry-run` and inspect stderr.
+ */
+export declare function detectBranchProtection(branch: string, remote: string, projectRoot?: string): Promise<BranchProtectionResult>;
+/**
+ * Build the markdown body for a GitHub pull request.
+ */
+export declare function buildPRBody(opts: PRCreateOptions): string;
+/**
+ * Format human-readable instructions for creating a PR manually.
+ */
+export declare function formatManualPRInstructions(opts: PRCreateOptions): string;
+/**
+ * Create a GitHub pull request using the `gh` CLI, or return manual instructions
+ * if the CLI is unavailable or the operation fails.
+ */
+export declare function createPullRequest(opts: PRCreateOptions): Promise<PRResult>;
+//# sourceMappingURL=github-pr.d.ts.map

package/dist/release/github-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pr.d.ts","sourceRoot":"","sources":["../../src/release/github-pr.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAO1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgB3E;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAgFjC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAezD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAexE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuEhF"}

package/dist/release/guards.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Release guards - epic-completeness and double-listing checks.
+ *
+ * Pre-release validation to ensure all tasks in an epic are accounted for
+ * and no task appears in multiple releases.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import type { TaskRef } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+/** Epic completeness result. */
+export interface EpicCompletenessResult {
+    hasIncomplete: boolean;
+    epics: Array<{
+        epicId: string;
+        epicTitle: string;
+        totalChildren: number;
+        includedChildren: number;
+        missingChildren: TaskRef[];
+    }>;
+    orphanTasks: string[];
+}
+/**
+ * Check epic completeness for a set of release task IDs.
+ * Verifies all children of each referenced epic are included.
+ */
+export declare function checkEpicCompleteness(releaseTaskIds: string[], cwd?: string, accessor?: DataAccessor): Promise<EpicCompletenessResult>;
+/** Double-listing check result. */
+export interface DoubleListingResult {
+    hasDoubleListing: boolean;
+    duplicates: Array<{
+        taskId: string;
+        releases: string[];
+    }>;
+}
+/**
+ * Check if any tasks are listed in multiple releases.
+ */
+export declare function checkDoubleListing(releaseTaskIds: string[], existingReleases: Array<{
+    version: string;
+    tasks: string[];
+}>): DoubleListingResult;
+//# sourceMappingURL=guards.d.ts.map

package/dist/release/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/release/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAQ,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,gCAAgC;AAChC,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,OAAO,EAAE,CAAC;KAC5B,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAsBD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,MAAM,EAAE,EACxB,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAqEjC;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EAAE,EACxB,gBAAgB,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAC5D,mBAAmB,CAiBrB"}

package/dist/release/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Release core module — barrel export.
+ *
+ * Re-exports all release management operations from the core layer.
+ *
+ * @task T5709
+ * @epic T5701
+ */
+export type { ArtifactConfig, ArtifactHandler, ArtifactResult, ArtifactType } from './artifacts.js';
+export { buildArtifact, getArtifactHandler, getSupportedArtifactTypes, hasArtifactHandler, publishArtifact, validateArtifact, } from './artifacts.js';
+export { parseChangelogBlocks, writeChangelogSection } from './changelog-writer.js';
+export type { ChannelValidationResult, ReleaseChannel } from './channel.js';
+export { channelToDistTag, describeChannel, getDefaultChannelConfig as getDefaultBranchChannelConfig, resolveChannelFromBranch, validateVersionChannel, } from './channel.js';
+export type { CIPlatform } from './ci.js';
+export { detectCIPlatform, generateCIConfig, getPlatformPath, SUPPORTED_PLATFORMS, validateCIConfig, writeCIConfig, } from './ci.js';
+export type { BranchProtectionResult, PRCreateOptions, PRResult, RepoIdentity, } from './github-pr.js';
+export { buildPRBody, createPullRequest, detectBranchProtection, extractRepoOwnerAndName, formatManualPRInstructions, isGhCliAvailable, } from './github-pr.js';
+export type { DoubleListingResult, EpicCompletenessResult } from './guards.js';
+export { checkDoubleListing, checkEpicCompleteness } from './guards.js';
+export type { ChannelConfig, GitFlowConfig, PushMode, ReleaseConfig, ReleaseGate, } from './release-config.js';
+export { getArtifactType, getChangelogConfig, getChannelConfig, getDefaultChannelConfig, getDefaultGitFlowConfig, getGitFlowConfig, getPushMode, getReleaseGates, loadReleaseConfig, validateReleaseConfig, } from './release-config.js';
+export type { PushPolicy, ReleaseGateMetadata, ReleaseListOptions, ReleaseManifest, ReleaseTaskRecord, } from './release-manifest.js';
+export { cancelRelease, commitRelease, generateReleaseChangelog, listManifestReleases, markReleasePushed, migrateReleasesJsonToSqlite, prepareRelease, pushRelease, rollbackRelease, runReleaseGates, showManifestRelease, tagRelease, } from './release-manifest.js';
+export type { BumpResult, BumpType, VersionBumpTarget } from './version-bump.js';
+export { bumpVersionFromConfig, calculateNewVersion, getVersionBumpConfig, isCalVer, isVersionBumpConfigured, validateVersionFormat, } from './version-bump.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/release/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/release/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGpF,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI5E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,uBAAuB,IAAI,6BAA6B,EACxD,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGxE,YAAY,EACV,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/release/release-config.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Release configuration loader and validator.
+ *
+ * Loads release configuration from .cleo/config.json, providing defaults
+ * for versioning scheme, changelog format, artifact types, and gates.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Release configuration shape. */
+export interface ReleaseConfig {
+    versioningScheme: string;
+    tagPrefix: string;
+    changelogFormat: string;
+    changelogFile: string;
+    artifactType: string;
+    gates: ReleaseGate[];
+    versionBump: {
+        files: Array<{
+            file: string;
+            strategy: string;
+            field?: string;
+        }>;
+    };
+    security: {
+        enableProvenance: boolean;
+        slsaLevel: number;
+        requireSignedCommits: boolean;
+    };
+    gitflow?: GitFlowConfig;
+    channels?: ChannelConfig;
+    push?: {
+        mode?: PushMode;
+    };
+}
+/** Release gate definition. */
+export interface ReleaseGate {
+    name: string;
+    type: 'tests' | 'lint' | 'audit' | 'custom';
+    command: string;
+    required: boolean;
+}
+/** Load release configuration with defaults. */
+export declare function loadReleaseConfig(cwd?: string): ReleaseConfig;
+/** Validate release configuration. */
+export declare function validateReleaseConfig(config: ReleaseConfig): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/** Get artifact type from config. */
+export declare function getArtifactType(cwd?: string): string;
+/** Get release gates from config. */
+export declare function getReleaseGates(cwd?: string): ReleaseGate[];
+/** Get changelog configuration. */
+export declare function getChangelogConfig(cwd?: string): {
+    format: string;
+    file: string;
+};
+/** GitFlow branch configuration. */
+export interface GitFlowConfig {
+    enabled: boolean;
+    branches: {
+        main: string;
+        develop: string;
+        featurePrefix: string;
+        hotfixPrefix: string;
+        releasePrefix: string;
+    };
+}
+/** Channel-to-branch mapping for npm dist-tag resolution. */
+export interface ChannelConfig {
+    main: string;
+    develop: string;
+    feature: string;
+    custom?: Record<string, string>;
+}
+/** Push mode: direct push vs PR creation vs auto-detect. */
+export type PushMode = 'direct' | 'pr' | 'auto';
+/** Return the default GitFlow branch configuration. */
+export declare function getDefaultGitFlowConfig(): GitFlowConfig;
+/** Merge caller-supplied GitFlow config with defaults. */
+export declare function getGitFlowConfig(config: ReleaseConfig): GitFlowConfig;
+/** Return the default channel configuration. */
+export declare function getDefaultChannelConfig(): ChannelConfig;
+/** Merge caller-supplied channel config with defaults. */
+export declare function getChannelConfig(config: ReleaseConfig): ChannelConfig;
+/** Return the configured push mode, defaulting to 'auto'. */
+export declare function getPushMode(config: ReleaseConfig): PushMode;
+//# sourceMappingURL=release-config.d.ts.map

package/dist/release/release-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-config.d.ts","sourceRoot":"","sources":["../../src/release/release-config.ts"],"names":[],"mappings":"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"}

package/dist/release/release-manifest.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Release manifest operations backed by the release_manifests SQLite table.
+ *
+ * Migrated from .cleo/releases.json to SQLite per T5580.
+ * All reads/writes now go through Drizzle ORM via tasks.db.
+ *
+ * @task T5580
+ * @task T4788
+ */
+import { createPage } from '../pagination.js';
+import type { ReleaseChannel } from './channel.js';
+import type { PushMode } from './release-config.js';
+/** Release manifest structure. */
+export interface ReleaseManifest {
+    version: string;
+    status: 'draft' | 'prepared' | 'committed' | 'tagged' | 'pushed' | 'rolled_back';
+    createdAt: string;
+    preparedAt?: string;
+    committedAt?: string;
+    taggedAt?: string;
+    pushedAt?: string;
+    tasks: string[];
+    notes?: string;
+    changelog?: string;
+    previousVersion?: string;
+    commitSha?: string;
+    gitTag?: string;
+}
+export interface ReleaseListOptions {
+    status?: ReleaseManifest['status'];
+    limit?: number;
+    offset?: number;
+}
+/** Task record shape needed for release operations. */
+export interface ReleaseTaskRecord {
+    id: string;
+    title: string;
+    status: string;
+    parentId?: string;
+    completedAt?: string | null;
+    labels?: string[];
+    /** Structured task type — 'epic' | 'task' | 'subtask'. Used for changelog filtering and categorization. */
+    type?: string;
+    /** Task description. Used to enrich changelog entries when meaningfully different from the title. */
+    description?: string;
+}
+/**
+ * Prepare a release (create a release manifest entry).
+ * @task T4788
+ */
+export declare function prepareRelease(version: string, tasks: string[] | undefined, notes: string | undefined, loadTasksFn: () => Promise<ReleaseTaskRecord[]>, cwd?: string): Promise<{
+    version: string;
+    status: string;
+    tasks: string[];
+    taskCount: number;
+}>;
+/**
+ * Generate changelog for a release.
+ * @task T4788
+ */
+export declare function generateReleaseChangelog(version: string, loadTasksFn: () => Promise<ReleaseTaskRecord[]>, cwd?: string): Promise<{
+    version: string;
+    changelog: string;
+    taskCount: number;
+    sections: Record<string, number>;
+}>;
+/**
+ * List all releases.
+ * @task T4788
+ */
+export declare function listManifestReleases(optionsOrCwd?: ReleaseListOptions | string, cwd?: string): Promise<{
+    releases: Array<{
+        version: string;
+        status: string;
+        createdAt: string;
+        taskCount: number;
+    }>;
+    total: number;
+    filtered: number;
+    latest?: string;
+    page: ReturnType<typeof createPage>;
+}>;
+/**
+ * Show release details.
+ * @task T4788
+ */
+export declare function showManifestRelease(version: string, cwd?: string): Promise<ReleaseManifest>;
+/**
+ * Mark release as committed (metadata only).
+ * @task T4788
+ */
+export declare function commitRelease(version: string, cwd?: string): Promise<{
+    version: string;
+    status: string;
+    committedAt: string;
+}>;
+/**
+ * Mark release as tagged (metadata only).
+ * @task T4788
+ */
+export declare function tagRelease(version: string, cwd?: string): Promise<{
+    version: string;
+    status: string;
+    taggedAt: string;
+}>;
+/**
+ * Run release validation gates.
+ * @task T4788
+ * @task T5586
+ */
+export declare function runReleaseGates(version: string, loadTasksFn: () => Promise<ReleaseTaskRecord[]>, cwd?: string, opts?: {
+    dryRun?: boolean;
+}): Promise<{
+    version: string;
+    allPassed: boolean;
+    gates: Array<{
+        name: string;
+        status: 'passed' | 'failed';
+        message: string;
+    }>;
+    passedCount: number;
+    failedCount: number;
+    metadata: ReleaseGateMetadata;
+}>;
+/**
+ * Cancel and remove a release in draft or prepared state.
+ * Only releases that have not yet been committed to git can be cancelled.
+ * For committed/tagged/pushed releases, use rollbackRelease() instead.
+ *
+ * @task T5602
+ */
+export declare function cancelRelease(version: string, projectRoot?: string): Promise<{
+    success: boolean;
+    message: string;
+    version: string;
+}>;
+/**
+ * Rollback a release.
+ * @task T4788
+ */
+export declare function rollbackRelease(version: string, reason?: string, cwd?: string): Promise<{
+    version: string;
+    previousStatus: string;
+    status: string;
+    reason: string;
+}>;
+/**
+ * Metadata captured during gate evaluation, returned alongside gate results.
+ * Downstream (engine layer) uses this to determine PR vs direct push.
+ */
+export interface ReleaseGateMetadata {
+    /** npm dist-tag channel resolved from the current branch. */
+    channel: ReleaseChannel;
+    /** Whether the target branch requires a PR (branch protection detected or mode='pr'). */
+    requiresPR: boolean;
+    /** Branch that should be targeted for this release type. */
+    targetBranch: string;
+    /** Branch the repo is currently on. */
+    currentBranch: string;
+}
+/** Push policy configuration from config.release.push. */
+export interface PushPolicy {
+    enabled?: boolean;
+    remote?: string;
+    requireCleanTree?: boolean;
+    allowedBranches?: string[];
+    /** Push mode override: 'direct' | 'pr' | 'auto' (default: 'direct'). */
+    mode?: PushMode;
+    /** Override PR target branch (default: auto-detected from GitFlow config). */
+    prBase?: string;
+}
+/**
+ * Push release to remote via git.
+ *
+ * Respects config.release.push policy:
+ * - remote: override default remote (fallback to 'origin')
+ * - requireCleanTree: verify git working tree is clean before push
+ * - allowedBranches: verify current branch is in the allowed list
+ * - enabled: if false and no explicit push flag, caller should skip
+ *
+ * @task T4788
+ * @task T4276
+ */
+export declare function pushRelease(version: string, remote?: string, cwd?: string, opts?: {
+    explicitPush?: boolean;
+    mode?: PushMode;
+    prBase?: string;
+    epicId?: string;
+    guided?: boolean;
+}): Promise<{
+    version: string;
+    status: string;
+    remote: string;
+    pushedAt: string;
+    requiresPR?: boolean;
+}>;
+/**
+ * Update release status after push, with optional provenance fields.
+ * @task T4788
+ * @task T5580
+ */
+export declare function markReleasePushed(version: string, pushedAt: string, cwd?: string, provenance?: {
+    commitSha?: string;
+    gitTag?: string;
+}): Promise<void>;
+/**
+ * One-time migration: read .cleo/releases.json and insert each release into
+ * the release_manifests table. Renames the file to releases.json.migrated on success.
+ *
+ * @task T5580
+ */
+export declare function migrateReleasesJsonToSqlite(projectRoot?: string): Promise<{
+    migrated: number;
+}>;
+//# sourceMappingURL=release-manifest.d.ts.map

package/dist/release/release-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manifest.d.ts","sourceRoot":"","sources":["../../src/release/release-manifest.ts"],"names":[],"mappings":"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"}

package/dist/release/version-bump.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Version bump - config-driven version bumping across project files.
+ *
+ * Reads release.versionBump from .cleo/config.json and updates all
+ * configured files with the new version. Supports strategies:
+ *   plain - Overwrite entire file (e.g., VERSION)
+ *   json  - Update a JSON field (e.g., package.json .version)
+ *   toml  - Update a TOML key (e.g., Cargo.toml)
+ *   sed   - Custom regex substitution
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Validate version format (semver X.Y.Z or CalVer YYYY.M.patch, with optional pre-release). */
+export declare function validateVersionFormat(version: string): boolean;
+/** Check if a version string is CalVer format. */
+export declare function isCalVer(version: string): boolean;
+/** Bump type for version calculation. */
+export type BumpType = 'patch' | 'minor' | 'major';
+/** Calculate new version from current + bump type. */
+export declare function calculateNewVersion(current: string, bump: BumpType | string): string;
+/** Version bump target config from .cleo/config.json. */
+export interface VersionBumpTarget {
+    file: string;
+    strategy: 'plain' | 'json' | 'toml' | 'sed';
+    field?: string;
+    key?: string;
+    section?: string;
+    pattern?: string;
+}
+/** Get version bump configuration, mapping config field names to VersionBumpTarget. */
+export declare function getVersionBumpConfig(cwd?: string): VersionBumpTarget[];
+/** Check if version bump is configured. */
+export declare function isVersionBumpConfigured(cwd?: string): boolean;
+/** Bump result for a single file. */
+export interface BumpResult {
+    file: string;
+    strategy: string;
+    success: boolean;
+    previousVersion?: string;
+    newVersion?: string;
+    error?: string;
+}
+/** Bump version in all configured files. */
+export declare function bumpVersionFromConfig(newVersion: string, options?: {
+    dryRun?: boolean;
+}, cwd?: string): {
+    results: BumpResult[];
+    allSuccess: boolean;
+};
+//# sourceMappingURL=version-bump.d.ts.map

package/dist/release/version-bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-bump.d.ts","sourceRoot":"","sources":["../../src/release/version-bump.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmCH,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,yCAAyC;AACzC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAiEpF;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAgBtE;AAED,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyFD,4CAA4C;AAC5C,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,EAClC,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAqChD"}

package/dist/remote/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Remote module for .cleo/.git push/pull operations.
+ *
+ * Manages a dedicated git remote for the isolated .cleo/.git repo
+ * (ADR-013, ADR-015 Phase 2). Enables multi-contributor sharing
+ * of CLEO state files via standard git push/pull semantics.
+ *
+ * @task T4884
+ */
+/** Remote configuration. */
+export interface RemoteConfig {
+    name: string;
+    url: string;
+}
+/** Result of a push operation. */
+export interface PushResult {
+    success: boolean;
+    branch: string;
+    remote: string;
+    message: string;
+}
+/** Result of a pull operation. */
+export interface PullResult {
+    success: boolean;
+    branch: string;
+    remote: string;
+    message: string;
+    hasConflicts: boolean;
+    conflictFiles: string[];
+}
+/** Result of a remote list operation. */
+export interface RemoteInfo {
+    name: string;
+    fetchUrl: string;
+    pushUrl: string;
+}
+/**
+ * Get the current branch name in .cleo/.git.
+ * @task T4884
+ */
+export declare function getCurrentBranch(cwd?: string): Promise<string>;
+/**
+ * Add a git remote to .cleo/.git.
+ * @task T4884
+ */
+export declare function addRemote(url: string, name?: string, cwd?: string): Promise<void>;
+/**
+ * Remove a git remote from .cleo/.git.
+ * @task T4884
+ */
+export declare function removeRemote(name?: string, cwd?: string): Promise<void>;
+/**
+ * List configured remotes in .cleo/.git.
+ * @task T4884
+ */
+export declare function listRemotes(cwd?: string): Promise<RemoteInfo[]>;
+/**
+ * Push .cleo/.git to a remote.
+ * @task T4884
+ */
+export declare function push(remote?: string, options?: {
+    force?: boolean;
+    setUpstream?: boolean;
+}, cwd?: string): Promise<PushResult>;
+/**
+ * Pull from a remote into .cleo/.git.
+ * Uses rebase strategy to maintain clean history.
+ * @task T4884
+ */
+export declare function pull(remote?: string, cwd?: string): Promise<PullResult>;
+/**
+ * Get the sync status between local .cleo/.git and remote.
+ * @task T4884
+ */
+export declare function getSyncStatus(remote?: string, cwd?: string): Promise<{
+    ahead: number;
+    behind: number;
+    branch: string;
+    remote: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/remote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AA8BD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBjG;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,MAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAyBrE;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,MAAM,GAAE,MAAiB,EACzB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,EACpD,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,GAAE,MAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EvF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,GAAE,MAAiB,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB5E"}

package/dist/repair.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Repair functions for fixable data integrity issues — SQLite era.
+ *
+ * Each function performs a direct Drizzle SQL update (no in-memory TaskFile mutation).
+ * Used by both `upgrade` and `validate --fix`.
+ *
+ * @task T4862
+ */
+/** A single repair action with status. */
+export interface RepairAction {
+    action: string;
+    status: 'applied' | 'skipped' | 'preview';
+    details: string;
+}
+/**
+ * Set size='medium' on tasks that have no size value.
+ * Operates directly on the SQLite tasks table.
+ */
+export declare function repairMissingSizes(cwd: string | undefined, dryRun: boolean): Promise<RepairAction>;
+/**
+ * Set completedAt=now() on done/cancelled tasks that are missing a completedAt timestamp.
+ * Operates directly on the SQLite tasks table.
+ */
+export declare function repairMissingCompletedAt(cwd: string | undefined, dryRun: boolean): Promise<RepairAction>;
+/**
+ * Run all repair functions.
+ * Returns all actions taken (or previewed in dry-run mode).
+ */
+export declare function runAllRepairs(cwd: string | undefined, dryRun: boolean): Promise<RepairAction[]>;
+//# sourceMappingURL=repair.d.ts.map

package/dist/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../src/repair.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CA0CvB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CAMzB"}

package/dist/research/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../memory/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/research/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}