@cleocode/cleo 2026.2.5

package/dist/core/release/ci.js

@@ -0,0 +1,162 @@
+/**
+ * CI/CD template generation for release workflows.
+ *
+ * Generates platform-specific CI/CD configurations (GitHub Actions,
+ * GitLab CI, CircleCI) from templates and project configuration.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { loadReleaseConfig } from './release-config.js';
+/** All supported platforms. */
+export const SUPPORTED_PLATFORMS = ['github-actions', 'gitlab-ci', 'circleci'];
+/** Platform-specific output paths. */
+const PLATFORM_PATHS = {
+    'github-actions': '.github/workflows/release.yml',
+    'gitlab-ci': '.gitlab-ci.yml',
+    'circleci': '.circleci/config.yml',
+};
+/** Get the output path for a CI platform. */
+export function getPlatformPath(platform) {
+    return PLATFORM_PATHS[platform];
+}
+/** Detect the CI platform from the project. */
+export function detectCIPlatform(projectDir) {
+    const dir = projectDir ?? process.cwd();
+    if (existsSync(join(dir, '.github')))
+        return 'github-actions';
+    if (existsSync(join(dir, '.gitlab-ci.yml')))
+        return 'gitlab-ci';
+    if (existsSync(join(dir, '.circleci')))
+        return 'circleci';
+    return null;
+}
+/** Generate GitHub Actions workflow YAML. */
+function generateGitHubActions(config) {
+    const gateSteps = config.gates.map(g => `      - name: ${g.name}\n        run: ${g.command}`).join('\n');
+    return `name: Release
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Install dependencies
+        run: npm ci
+${gateSteps}
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true
+`;
+}
+/** Generate GitLab CI YAML. */
+function generateGitLabCI(config) {
+    const stages = config.gates.map(g => g.name.toLowerCase().replace(/\s+/g, '-'));
+    return `stages:
+  - test
+  - release
+${stages.map(s => `  - ${s}`).join('\n')}
+
+${config.gates.map(g => `${g.name.toLowerCase().replace(/\s+/g, '-')}:
+  stage: ${g.name.toLowerCase().replace(/\s+/g, '-')}
+  script:
+    - ${g.command}`).join('\n\n')}
+
+release:
+  stage: release
+  only:
+    - tags
+  script:
+    - echo "Creating release"
+`;
+}
+/** Generate CircleCI config YAML. */
+function generateCircleCI(config) {
+    return `version: 2.1
+
+jobs:
+  test:
+    docker:
+      - image: cimg/node:20.0
+    steps:
+      - checkout
+      - run: npm ci
+${config.gates.map(g => `      - run:\n          name: ${g.name}\n          command: ${g.command}`).join('\n')}
+
+  release:
+    docker:
+      - image: cimg/node:20.0
+    steps:
+      - checkout
+      - run: echo "Creating release"
+
+workflows:
+  release:
+    jobs:
+      - test:
+          filters:
+            tags:
+              only: /^v.*/
+      - release:
+          requires:
+            - test
+          filters:
+            tags:
+              only: /^v.*/
+`;
+}
+/** Generate CI config for a platform. */
+export function generateCIConfig(platform, cwd) {
+    const releaseConfig = loadReleaseConfig(cwd);
+    const gates = releaseConfig.gates.map(g => ({ name: g.name, command: g.command }));
+    switch (platform) {
+        case 'github-actions':
+            return generateGitHubActions({ gates });
+        case 'gitlab-ci':
+            return generateGitLabCI({ gates });
+        case 'circleci':
+            return generateCircleCI({ gates });
+    }
+}
+/** Write CI config to the appropriate path. */
+export function writeCIConfig(platform, options = {}) {
+    const projectDir = options.projectDir ?? process.cwd();
+    const outputPath = join(projectDir, getPlatformPath(platform));
+    const content = generateCIConfig(platform, projectDir);
+    if (options.dryRun) {
+        return { action: 'would_write', path: outputPath, content };
+    }
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, content, 'utf-8');
+    return { action: 'wrote', path: outputPath, content };
+}
+/** Validate an existing CI config. */
+export function validateCIConfig(platform, projectDir) {
+    const dir = projectDir ?? process.cwd();
+    const configPath = join(dir, getPlatformPath(platform));
+    if (!existsSync(configPath)) {
+        return { valid: false, exists: false, errors: ['Config file not found'] };
+    }
+    const errors = [];
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        if (!content.trim())
+            errors.push('Config file is empty');
+    }
+    catch (err) {
+        errors.push(`Cannot read config: ${String(err)}`);
+    }
+    return { valid: errors.length === 0, exists: true, errors };
+}
+//# sourceMappingURL=ci.js.map

package/dist/core/release/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../../src/core/release/ci.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKxD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAiB,CAAC,gBAAgB,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAE7F,sCAAsC;AACtC,MAAM,cAAc,GAA+B;IACjD,gBAAgB,EAAE,+BAA+B;IACjD,WAAW,EAAE,gBAAgB;IAC7B,UAAU,EAAE,sBAAsB;CACnC,CAAC;AAEF,6CAA6C;AAC7C,MAAM,UAAU,eAAe,CAAC,QAAoB;IAClD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,UAAmB;IAClD,MAAM,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAExC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC9D,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAChE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6CAA6C;AAC7C,SAAS,qBAAqB,CAAC,MAA6E;IAC1G,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACrC,iBAAiB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,OAAO,EAAE,CACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;;;;;;;;;;;;;;;;;EAiBP,SAAS;;;;;CAKV,CAAC;AACF,CAAC;AAED,+BAA+B;AAC/B,SAAS,gBAAgB,CAAC,MAA2D;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEhF,OAAO;;;EAGP,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAEtC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;WACzD,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;;QAE5C,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;;;;CAQhC,CAAC;AACF,CAAC;AAED,qCAAqC;AACrC,SAAS,gBAAgB,CAAC,MAA2D;IACnF,OAAO;;;;;;;;;EASP,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,iCAAiC,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsB7G,CAAC;AACF,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAC9B,QAAoB,EACpB,GAAY;IAEZ,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAEnF,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,gBAAgB;YACnB,OAAO,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,WAAW;YACd,OAAO,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAC3B,QAAoB,EACpB,UAAqD,EAAE;IAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,gBAAgB,CAC9B,QAAoB,EACpB,UAAmB;IAEnB,MAAM,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * 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 { 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: Array<{
+            id: string;
+            title: string;
+            status: string;
+        }>;
+    }>;
+    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/core/release/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/core/release/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,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,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvE,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAyBD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,MAAM,EAAE,EACxB,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,sBAAsB,CAAC,CA2DjC;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/core/release/guards.js

@@ -0,0 +1,110 @@
+/**
+ * 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 { readJson } from '../../store/json.js';
+import { getTodoPath } from '../paths.js';
+/**
+ * Walk parent chain to find the epic ancestor of a task.
+ */
+function findEpicAncestor(taskId, tasksById) {
+    const task = tasksById.get(taskId);
+    if (!task)
+        return null;
+    if (task.type === 'epic')
+        return taskId;
+    // Walk up parent chain (max 3 levels)
+    let current = task;
+    for (let depth = 0; depth < 3; depth++) {
+        if (!current.parentId)
+            return null;
+        const parent = tasksById.get(current.parentId);
+        if (!parent)
+            return null;
+        if (parent.type === 'epic')
+            return parent.id;
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Check epic completeness for a set of release task IDs.
+ * Verifies all children of each referenced epic are included.
+ */
+export async function checkEpicCompleteness(releaseTaskIds, cwd, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJson(getTodoPath(cwd));
+    if (!data?.tasks) {
+        return { hasIncomplete: false, epics: [], orphanTasks: [] };
+    }
+    const tasksById = new Map();
+    for (const task of data.tasks) {
+        tasksById.set(task.id, task);
+    }
+    const releaseSet = new Set(releaseTaskIds);
+    // Map each release task to its epic
+    const taskToEpic = new Map();
+    for (const taskId of releaseTaskIds) {
+        taskToEpic.set(taskId, findEpicAncestor(taskId, tasksById));
+    }
+    // Find orphan tasks (no epic)
+    const orphanTasks = releaseTaskIds.filter(id => !taskToEpic.get(id));
+    // Group by epic
+    const byEpic = new Map();
+    for (const [taskId, epicId] of taskToEpic) {
+        if (!epicId)
+            continue;
+        if (!byEpic.has(epicId))
+            byEpic.set(epicId, []);
+        byEpic.get(epicId).push(taskId);
+    }
+    // Check each epic for completeness
+    const epics = [];
+    let hasIncomplete = false;
+    for (const [epicId, includedTasks] of byEpic) {
+        const epic = tasksById.get(epicId);
+        if (!epic)
+            continue;
+        // Find all children of this epic
+        const allChildren = data.tasks.filter(t => t.parentId === epicId && t.id !== epicId);
+        const includedSet = new Set(includedTasks);
+        const missingChildren = allChildren
+            .filter(t => !includedSet.has(t.id) && !releaseSet.has(t.id))
+            .map(t => ({ id: t.id, title: t.title, status: t.status }));
+        if (missingChildren.length > 0)
+            hasIncomplete = true;
+        epics.push({
+            epicId,
+            epicTitle: epic.title,
+            totalChildren: allChildren.length,
+            includedChildren: includedTasks.length,
+            missingChildren,
+        });
+    }
+    return { hasIncomplete, epics, orphanTasks };
+}
+/**
+ * Check if any tasks are listed in multiple releases.
+ */
+export function checkDoubleListing(releaseTaskIds, existingReleases) {
+    const duplicates = [];
+    for (const taskId of releaseTaskIds) {
+        const inReleases = existingReleases
+            .filter(r => r.tasks.includes(taskId))
+            .map(r => r.version);
+        if (inReleases.length > 0) {
+            duplicates.push({ taskId, releases: inReleases });
+        }
+    }
+    return {
+        hasDoubleListing: duplicates.length > 0,
+        duplicates,
+    };
+}
+//# sourceMappingURL=guards.js.map

package/dist/core/release/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/core/release/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB1C;;GAEG;AACH,SAAS,gBAAgB,CACvB,MAAc,EACd,SAA4B;IAE5B,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAExC,sCAAsC;IACtC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,cAAwB,EACxB,GAAY,EACZ,QAAuB;IAEvB,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,QAAQ,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgB,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAE3C,oCAAoC;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IACpD,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,8BAA8B;IAC9B,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAErE,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,mCAAmC;IACnC,MAAM,KAAK,GAAoC,EAAE,CAAC;IAClD,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACrF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,eAAe,GAAG,WAAW;aAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE9D,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;YAAE,aAAa,GAAG,IAAI,CAAC;QAErD,KAAK,CAAC,IAAI,CAAC;YACT,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,aAAa,EAAE,WAAW,CAAC,MAAM;YACjC,gBAAgB,EAAE,aAAa,CAAC,MAAM;YACtC,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC/C,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,cAAwB,EACxB,gBAA6D;IAE7D,MAAM,UAAU,GAAsC,EAAE,CAAC;IAEzD,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,gBAAgB;aAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEvB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC;QACvC,UAAU;KACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * Release management - create, plan, ship, changelog.
+ * @task T4467
+ * @epic T4454
+ */
+import type { Release } from '../../types/task.js';
+import type { DataAccessor } from '../../store/data-accessor.js';
+import type { BumpResult } from './version-bump.js';
+/** Options for creating a release. */
+export interface CreateReleaseOptions {
+    version: string;
+    tasks?: string[];
+    notes?: string;
+    targetDate?: string;
+}
+/** Options for planning a release. */
+export interface PlanReleaseOptions {
+    version: string;
+    tasks?: string[];
+    removeTasks?: string[];
+    notes?: string;
+}
+/** Ship release options. */
+export interface ShipReleaseOptions {
+    version: string;
+    bumpVersion?: boolean;
+    createTag?: boolean;
+    push?: boolean;
+    dryRun?: boolean;
+}
+/** Release show result. */
+export interface ReleaseShowResult {
+    version: string;
+    status: string;
+    tasks: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    notes: string | null;
+    targetDate: string | null;
+    releasedAt: string | null;
+    changelog: string | null;
+}
+/**
+ * Validate version format (X.Y.Z, CalVer YYYY.M.patch, with optional pre-release/build metadata).
+ * @task T4467
+ */
+export declare function validateVersion(version: string): void;
+/**
+ * Validate version format (legacy alias).
+ * @deprecated Use validateVersion instead.
+ * @task T4467
+ */
+export declare const validateSemver: typeof validateVersion;
+/**
+ * Create a new release.
+ * @task T4467
+ */
+export declare function createRelease(options: CreateReleaseOptions, cwd?: string, accessor?: DataAccessor): Promise<Release>;
+/**
+ * Plan/update a release - add or remove tasks.
+ * @task T4467
+ */
+export declare function planRelease(options: PlanReleaseOptions, cwd?: string, accessor?: DataAccessor): Promise<Release>;
+/** Result of shipping a release. */
+export interface ShipReleaseResult {
+    release: Release;
+    changelog: string;
+    dryRun: boolean;
+    bumpResults?: BumpResult[];
+    changelogWritten?: boolean;
+    gitCommit?: string;
+    gitTag?: string;
+    gitPushed?: boolean;
+}
+/**
+ * Ship a release - mark as released, generate changelog, bump versions, and optionally git commit/tag/push.
+ * @task T4467
+ */
+export declare function shipRelease(options: ShipReleaseOptions, cwd?: string, accessor?: DataAccessor): Promise<ShipReleaseResult>;
+/**
+ * List all releases.
+ * @task T4467
+ */
+export declare function listReleases(cwd?: string, accessor?: DataAccessor): Promise<Release[]>;
+/**
+ * Show a specific release.
+ * @task T4467
+ */
+export declare function showRelease(version: string, cwd?: string, accessor?: DataAccessor): Promise<ReleaseShowResult>;
+/**
+ * Get changelog for a release.
+ * @task T4467
+ */
+export declare function getChangelog(version: string, cwd?: string, accessor?: DataAccessor): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

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

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