@cleocode/core 2026.4.7 → 2026.4.11

package/dist/templates/parser.js

@@ -0,0 +1,254 @@
+/**
+ * GitHub Issue Template Parser (Core Logic)
+ *
+ * Native TypeScript implementation for parsing GitHub issue template YAML files
+ * and producing structured JSON config. The CLI
+ * can consume the generated config at .cleo/issue-templates.json.
+ *
+ * Supports: parseIssueTemplates, getTemplateForSubcommand, generateTemplateConfig, validateLabels
+ *
+ * @task T5705
+ * @epic T5701
+ */
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { getDataPath, writeJsonFileAtomic } from '../platform.js';
+/**
+ * Known filename suffixes to strip when deriving subcommand.
+ * Pattern: strip _report, _request, _question, then take the first word.
+ */
+const SUFFIX_PATTERNS = ['_report', '_request', '_question'];
+/**
+ * Derive a subcommand name from a template filename.
+ *
+ * Examples:
+ *   bug_report.yml     -> "bug"
+ *   feature_request.yml -> "feature"
+ *   help_question.yml   -> "help"
+ */
+function deriveSubcommand(filename) {
+    // Remove .yml / .yaml extension
+    let stem = filename.replace(/\.ya?ml$/i, '');
+    // Strip known suffixes
+    for (const suffix of SUFFIX_PATTERNS) {
+        if (stem.endsWith(suffix)) {
+            stem = stem.slice(0, -suffix.length);
+            break;
+        }
+    }
+    // Take the first word (split on underscore, hyphen, or space)
+    const firstWord = stem.split(/[_\-\s]/)[0];
+    return firstWord.toLowerCase();
+}
+/**
+ * Parse a single YAML template file into an IssueTemplate.
+ */
+function parseTemplateFile(templateDir, filename) {
+    const filePath = join(templateDir, filename);
+    const raw = readFileSync(filePath, 'utf-8');
+    const parsed = parseYaml(raw);
+    const name = typeof parsed.name === 'string' ? parsed.name : filename;
+    const titlePrefix = typeof parsed.title === 'string' ? parsed.title : '';
+    // Parse labels - can be an array of strings
+    let labels = [];
+    if (Array.isArray(parsed.labels)) {
+        labels = parsed.labels.map((l) => String(l));
+    }
+    // Parse body sections
+    const sections = [];
+    if (Array.isArray(parsed.body)) {
+        for (const item of parsed.body) {
+            if (typeof item !== 'object' || item === null)
+                continue;
+            const entry = item;
+            const type = String(entry.type || 'unknown');
+            const attributes = (entry.attributes || {});
+            const validations = (entry.validations || {});
+            // For markdown type, use 'value' hash as a pseudo-id since they lack an id field
+            const id = typeof entry.id === 'string'
+                ? entry.id
+                : type === 'markdown'
+                    ? `markdown-${sections.length}`
+                    : `section-${sections.length}`;
+            const label = typeof attributes.label === 'string'
+                ? attributes.label
+                : type === 'markdown'
+                    ? 'Markdown'
+                    : '';
+            const required = validations.required === true;
+            const section = {
+                id,
+                type,
+                label,
+                required,
+            };
+            // Add options for dropdown type
+            if (type === 'dropdown' && Array.isArray(attributes.options)) {
+                section.options = attributes.options.map((o) => String(o));
+            }
+            // Add options for checkboxes type
+            if (type === 'checkboxes' && Array.isArray(attributes.options)) {
+                section.options = attributes.options.map((o) => typeof o.label === 'string' ? o.label : String(o));
+            }
+            // Add placeholder if present
+            if (typeof attributes.placeholder === 'string') {
+                section.placeholder = attributes.placeholder;
+            }
+            sections.push(section);
+        }
+    }
+    return {
+        filename,
+        subcommand: deriveSubcommand(filename),
+        name,
+        titlePrefix,
+        labels,
+        sections,
+    };
+}
+/**
+ * Parse all templates from the repo's .github/ISSUE_TEMPLATE/ directory.
+ *
+ * Reads YAML files directly (live parse, no caching).
+ * Excludes config.yml which is the GitHub template chooser config.
+ */
+export function parseIssueTemplates(projectRoot) {
+    const templateDir = join(projectRoot, '.github', 'ISSUE_TEMPLATE');
+    if (!existsSync(templateDir)) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_FOUND', message: `Issue template directory not found: ${templateDir}` },
+        };
+    }
+    let files;
+    try {
+        files = readdirSync(templateDir).filter((f) => /\.ya?ml$/i.test(f) && f !== 'config.yml');
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: {
+                code: 'E_FILE_ERROR',
+                message: `Failed to read template directory: ${error.message}`,
+            },
+        };
+    }
+    if (files.length === 0) {
+        return {
+            success: false,
+            error: {
+                code: 'E_NOT_FOUND',
+                message: 'No issue template YAML files found (excluding config.yml)',
+            },
+        };
+    }
+    const templates = [];
+    for (const file of files.sort()) {
+        try {
+            templates.push(parseTemplateFile(templateDir, file));
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: {
+                    code: 'E_PARSE_ERROR',
+                    message: `Failed to parse template ${file}: ${error.message}`,
+                    details: { filename: file },
+                },
+            };
+        }
+    }
+    return {
+        success: true,
+        data: {
+            templates,
+            generatedAt: new Date().toISOString(),
+            sourceDir: templateDir,
+        },
+    };
+}
+/**
+ * Get template config for a specific subcommand (bug/feature/help).
+ *
+ * Performs a live parse and filters to the matching template.
+ */
+export function getTemplateForSubcommand(projectRoot, subcommand) {
+    const result = parseIssueTemplates(projectRoot);
+    if (!result.success || !result.data) {
+        return result.error
+            ? { success: false, error: result.error }
+            : {
+                success: false,
+                error: { code: 'E_PARSE_ERROR', message: 'Failed to parse issue templates' },
+            };
+    }
+    const template = result.data.templates.find((t) => t.subcommand === subcommand.toLowerCase());
+    if (!template) {
+        const available = result.data.templates.map((t) => t.subcommand).join(', ');
+        return {
+            success: false,
+            error: {
+                code: 'E_NOT_FOUND',
+                message: `No template found for subcommand '${subcommand}'. Available: ${available}`,
+                details: { available: result.data.templates.map((t) => t.subcommand) },
+            },
+        };
+    }
+    return { success: true, data: template };
+}
+/**
+ * Generate and cache the config as .cleo/issue-templates.json.
+ *
+ * Performs a live parse, then writes the result using writeJsonFileAtomic.
+ */
+export async function generateTemplateConfig(projectRoot) {
+    const result = parseIssueTemplates(projectRoot);
+    if (!result.success || !result.data) {
+        return result.error
+            ? { success: false, error: result.error }
+            : {
+                success: false,
+                error: { code: 'E_PARSE_ERROR', message: 'Failed to parse issue templates' },
+            };
+    }
+    const outputPath = getDataPath(projectRoot, 'issue-templates.json');
+    try {
+        writeJsonFileAtomic(outputPath, result.data);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: {
+                code: 'E_FILE_ERROR',
+                message: `Failed to write template config: ${error.message}`,
+                details: { outputPath },
+            },
+        };
+    }
+    return { success: true, data: result.data };
+}
+/**
+ * Validate that labels exist on a GitHub repo.
+ *
+ * Compares the template labels against a list of known repo labels.
+ * Returns which labels exist and which are missing.
+ */
+export function validateLabels(labels, repoLabels) {
+    const repoLabelSet = new Set(repoLabels.map((l) => l.toLowerCase()));
+    const existing = [];
+    const missing = [];
+    for (const label of labels) {
+        if (repoLabelSet.has(label.toLowerCase())) {
+            existing.push(label);
+        }
+        else {
+            missing.push(label);
+        }
+    }
+    return {
+        success: true,
+        data: { existing, missing },
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/templates/parser.js.map

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

package/dist/ui/aliases.js

@@ -0,0 +1,153 @@
+/**
+ * Claude Code CLI alias management.
+ *
+ * Detects shells, generates alias blocks, and manages injection
+ * into shell RC files for CLEO CLI shortcuts (ct, cleo, etc.).
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+/** Marker constants for idempotent injection. */
+const MARKER_START = '# CLEO-CLAUDE-ALIASES:START';
+const MARKER_END = '# CLEO-CLAUDE-ALIASES:END';
+/** Current alias version. */
+export const ALIASES_VERSION = '1.0.0';
+/** Environment variables for Claude aliases. */
+const CLAUDE_ENV_VARS = [
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true',
+    'ENABLE_BACKGROUND_TASKS=true',
+    'FORCE_AUTO_BACKGROUND_TASKS=true',
+    'CLAUDE_CODE_ENABLE_UNIFIED_READ_TOOL=true',
+];
+/** Detect the current shell. */
+export function getCurrentShell() {
+    const shell = process.env.SHELL ?? '';
+    if (shell.includes('zsh'))
+        return 'zsh';
+    if (shell.includes('bash'))
+        return 'bash';
+    if (platform() === 'win32')
+        return 'powershell';
+    return 'bash';
+}
+/** Get the RC file path for a shell. */
+export function getRcFilePath(shell) {
+    const home = homedir();
+    const sh = shell ?? getCurrentShell();
+    switch (sh) {
+        case 'bash':
+            return join(home, '.bashrc');
+        case 'zsh':
+            return join(home, '.zshrc');
+        case 'powershell':
+            return join(home, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1');
+        case 'cmd':
+            return ''; // CMD doesn't have a standard RC
+        default:
+            return join(home, '.bashrc');
+    }
+}
+/** Detect which shells are available on the system. */
+export function detectAvailableShells() {
+    const shells = [];
+    if (existsSync(getRcFilePath('bash')) || existsSync('/bin/bash'))
+        shells.push('bash');
+    if (existsSync(getRcFilePath('zsh')) || existsSync('/bin/zsh'))
+        shells.push('zsh');
+    if (platform() === 'win32')
+        shells.push('powershell');
+    return shells;
+}
+/** Generate bash/zsh alias content. */
+export function generateBashAliases(cleoPath) {
+    const cleo = cleoPath ?? 'cleo';
+    const envExports = CLAUDE_ENV_VARS.map((v) => `export ${v}`).join('\n');
+    return [
+        MARKER_START,
+        `# CLEO CLI aliases (v${ALIASES_VERSION})`,
+        envExports,
+        `alias ct='${cleo}'`,
+        `alias ct-add='${cleo} add'`,
+        `alias ct-done='${cleo} complete'`,
+        `alias ct-list='${cleo} list'`,
+        `alias ct-find='${cleo} find'`,
+        `alias ct-show='${cleo} show'`,
+        MARKER_END,
+    ].join('\n');
+}
+/** Generate PowerShell alias content. */
+export function generatePowershellAliases(cleoPath) {
+    const cleo = cleoPath ?? 'cleo';
+    return [
+        '# CLEO CLI aliases',
+        ...CLAUDE_ENV_VARS.map((v) => {
+            const [key, val] = v.split('=');
+            return `$env:${key} = "${val}"`;
+        }),
+        `Set-Alias -Name ct -Value ${cleo}`,
+    ].join('\n');
+}
+/** Check if aliases are already injected in a file. */
+export function hasAliasBlock(filePath) {
+    if (!existsSync(filePath))
+        return false;
+    const content = readFileSync(filePath, 'utf-8');
+    return content.includes(MARKER_START) && content.includes(MARKER_END);
+}
+/** Get the installed alias version from an RC file. */
+export function getInstalledVersion(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    const content = readFileSync(filePath, 'utf-8');
+    const match = content.match(/CLEO CLI aliases \(v([^)]+)\)/);
+    return match?.[1] ?? null;
+}
+/** Inject aliases into a shell RC file. */
+export function injectAliases(filePath, shell = 'bash', cleoPath) {
+    const content = shell === 'powershell' ? generatePowershellAliases(cleoPath) : generateBashAliases(cleoPath);
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, content + '\n', 'utf-8');
+        return { action: 'created', version: ALIASES_VERSION };
+    }
+    const existing = readFileSync(filePath, 'utf-8');
+    if (hasAliasBlock(filePath)) {
+        // Replace existing block
+        const startIdx = existing.indexOf(MARKER_START);
+        const endIdx = existing.indexOf(MARKER_END) + MARKER_END.length;
+        const updated = existing.slice(0, startIdx) + content + existing.slice(endIdx);
+        writeFileSync(filePath, updated, 'utf-8');
+        return { action: 'updated', version: ALIASES_VERSION };
+    }
+    // Append
+    writeFileSync(filePath, existing + '\n' + content + '\n', 'utf-8');
+    return { action: 'added', version: ALIASES_VERSION };
+}
+/** Remove aliases from a shell RC file. */
+export function removeAliases(filePath) {
+    if (!existsSync(filePath) || !hasAliasBlock(filePath))
+        return false;
+    const existing = readFileSync(filePath, 'utf-8');
+    const startIdx = existing.indexOf(MARKER_START);
+    const endIdx = existing.indexOf(MARKER_END) + MARKER_END.length;
+    // Remove the block plus any surrounding blank lines
+    const before = existing.slice(0, startIdx).replace(/\n+$/, '\n');
+    const after = existing.slice(endIdx).replace(/^\n+/, '\n');
+    writeFileSync(filePath, before + after, 'utf-8');
+    return true;
+}
+/** Get alias status for the current shell. */
+export function checkAliasesStatus(shell) {
+    const sh = shell ?? getCurrentShell();
+    const rcFile = getRcFilePath(sh);
+    if (!rcFile || !existsSync(rcFile)) {
+        return { shell: sh, rcFile, installed: false, version: null, needsUpdate: false };
+    }
+    const installed = hasAliasBlock(rcFile);
+    const version = installed ? getInstalledVersion(rcFile) : null;
+    const needsUpdate = installed && version !== ALIASES_VERSION;
+    return { shell: sh, rcFile, installed, version, needsUpdate };
+}
+//# sourceMappingURL=aliases.js.map

package/dist/ui/aliases.js.map

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

package/dist/ui/changelog.js

@@ -0,0 +1,184 @@
+/**
+ * Task-to-Changelog generation.
+ *
+ * Generates CHANGELOG.md content from CLEO task metadata.
+ * Groups tasks by labels (features, fixes, docs, etc.) and
+ * formats as conventional changelog sections.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { getAccessor } from '../store/data-accessor.js';
+/** Label-to-category mapping for changelog sections. */
+const LABEL_CATEGORIES = {
+    feature: 'Features',
+    feat: 'Features',
+    enhancement: 'Features',
+    bug: 'Bug Fixes',
+    fix: 'Bug Fixes',
+    bugfix: 'Bug Fixes',
+    hotfix: 'Bug Fixes',
+    docs: 'Documentation',
+    documentation: 'Documentation',
+    refactor: 'Refactoring',
+    cleanup: 'Refactoring',
+    chore: 'Refactoring',
+    test: 'Testing',
+    testing: 'Testing',
+    breaking: 'Breaking Changes',
+    'breaking-change': 'Breaking Changes',
+};
+/**
+ * Discover task IDs for a release from completed tasks.
+ * Optionally filtered by date range or specific task IDs.
+ */
+export async function discoverReleaseTasks(options = {}, cwd, accessor) {
+    const tasks = [];
+    // Collect tasks from both active and archive sources
+    const dataSources = [];
+    const dataAccessor = accessor ?? (await getAccessor(cwd));
+    const { tasks: activeTasks } = await dataAccessor.queryTasks({});
+    if (activeTasks?.length)
+        dataSources.push({ tasks: activeTasks });
+    const archiveData = await dataAccessor.loadArchive();
+    if (archiveData?.archivedTasks)
+        dataSources.push({ tasks: archiveData.archivedTasks });
+    for (const data of dataSources) {
+        for (const task of data.tasks) {
+            const id = task.id;
+            const status = task.status;
+            const completedAt = task.completedAt;
+            // Only completed tasks
+            if (status !== 'done')
+                continue;
+            // Filter by IDs if specified
+            if (options.taskIds?.length && !options.taskIds.includes(id))
+                continue;
+            // Filter by date range
+            if (options.since && completedAt && completedAt < options.since)
+                continue;
+            if (options.until && completedAt && completedAt > options.until)
+                continue;
+            tasks.push({
+                id,
+                title: task.title,
+                labels: task.labels ?? [],
+                parentId: task.parentId ?? undefined,
+                completedAt,
+            });
+        }
+    }
+    return tasks;
+}
+/** Categorize a task based on its labels. Returns the section name. */
+function categorizeTask(task) {
+    for (const label of task.labels) {
+        const category = LABEL_CATEGORIES[label.toLowerCase()];
+        if (category)
+            return category;
+    }
+    return 'Other Changes';
+}
+/** Group tasks into changelog sections. */
+export function groupTasksIntoSections(tasks) {
+    const groups = new Map();
+    for (const task of tasks) {
+        const section = categorizeTask(task);
+        if (!groups.has(section))
+            groups.set(section, []);
+        groups.get(section).push({
+            taskId: task.id,
+            description: task.title,
+        });
+    }
+    // Order: Breaking Changes first, then Features, Bug Fixes, etc.
+    const sectionOrder = [
+        'Breaking Changes',
+        'Features',
+        'Bug Fixes',
+        'Documentation',
+        'Refactoring',
+        'Testing',
+        'Other Changes',
+    ];
+    return sectionOrder
+        .filter((title) => groups.has(title))
+        .map((title) => ({ title, entries: groups.get(title) }));
+}
+/** Generate changelog markdown for a version. */
+export function generateChangelogMarkdown(version, date, sections) {
+    const lines = [];
+    lines.push(`## [${version}] - ${date}`);
+    lines.push('');
+    for (const section of sections) {
+        lines.push(`### ${section.title}`);
+        lines.push('');
+        for (const entry of section.entries) {
+            lines.push(`- ${entry.description} (${entry.taskId})`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/** Format changelog data as JSON. */
+export function formatChangelogJson(version, date, sections) {
+    return {
+        version,
+        date,
+        sections: sections.map((s) => ({
+            title: s.title,
+            entries: s.entries,
+        })),
+        totalEntries: sections.reduce((sum, s) => sum + s.entries.length, 0),
+    };
+}
+/** Write changelog content to a file. */
+export function writeChangelogFile(filePath, content) {
+    writeFileSync(filePath, content, 'utf-8');
+}
+/** Append a new release section to an existing CHANGELOG.md. */
+export function appendToChangelog(filePath, newContent) {
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, `# Changelog\n\n${newContent}`, 'utf-8');
+        return;
+    }
+    const existing = readFileSync(filePath, 'utf-8');
+    // Insert after the first heading
+    const headerMatch = existing.match(/^# .+\n/m);
+    if (headerMatch) {
+        const insertPos = (headerMatch.index ?? 0) + headerMatch[0].length;
+        const updated = existing.slice(0, insertPos) + '\n' + newContent + existing.slice(insertPos);
+        writeFileSync(filePath, updated, 'utf-8');
+    }
+    else {
+        appendFileSync(filePath, '\n' + newContent);
+    }
+}
+/**
+ * Full changelog generation: discover tasks, group, generate, write.
+ */
+export async function generateChangelog(version, options = {}, cwd, accessor) {
+    const date = new Date().toISOString().split('T')[0];
+    const tasks = await discoverReleaseTasks({ since: options.since, until: options.until, taskIds: options.taskIds }, cwd, accessor);
+    if (tasks.length === 0) {
+        return {
+            success: true,
+            result: { version, date, sections: [], totalEntries: 0, message: 'No tasks found' },
+        };
+    }
+    const sections = groupTasksIntoSections(tasks);
+    const markdown = generateChangelogMarkdown(version, date, sections);
+    const outputPath = options.outputPath ?? 'CHANGELOG.md';
+    if (options.append) {
+        appendToChangelog(outputPath, markdown);
+    }
+    else {
+        writeChangelogFile(outputPath, `# Changelog\n\n${markdown}`);
+    }
+    return {
+        success: true,
+        result: formatChangelogJson(version, date, sections),
+    };
+}
+//# sourceMappingURL=changelog.js.map

package/dist/ui/changelog.js.map

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