@cleocode/cleo 2026.2.5

package/dist/core/ui/aliases.js

@@ -0,0 +1,150 @@
+/**
+ * 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 { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+/** 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
+    let 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/core/ui/aliases.js.map

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

package/dist/core/ui/changelog.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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 type { DataAccessor } from '../../store/data-accessor.js';
+/** Task info for changelog generation. */
+interface ChangelogTask {
+    id: string;
+    title: string;
+    labels: string[];
+    parentId?: string;
+    completedAt?: string;
+}
+/**
+ * Discover task IDs for a release from completed tasks.
+ * Optionally filtered by date range or specific task IDs.
+ */
+export declare function discoverReleaseTasks(options?: {
+    since?: string;
+    until?: string;
+    taskIds?: string[];
+}, cwd?: string, accessor?: DataAccessor): Promise<ChangelogTask[]>;
+/** Grouped changelog sections. */
+export interface ChangelogSection {
+    title: string;
+    entries: Array<{
+        taskId: string;
+        description: string;
+    }>;
+}
+/** Group tasks into changelog sections. */
+export declare function groupTasksIntoSections(tasks: ChangelogTask[]): ChangelogSection[];
+/** Generate changelog markdown for a version. */
+export declare function generateChangelogMarkdown(version: string, date: string, sections: ChangelogSection[]): string;
+/** Format changelog data as JSON. */
+export declare function formatChangelogJson(version: string, date: string, sections: ChangelogSection[]): Record<string, unknown>;
+/** Write changelog content to a file. */
+export declare function writeChangelogFile(filePath: string, content: string): void;
+/** Append a new release section to an existing CHANGELOG.md. */
+export declare function appendToChangelog(filePath: string, newContent: string): void;
+/**
+ * Full changelog generation: discover tasks, group, generate, write.
+ */
+export declare function generateChangelog(version: string, options?: {
+    since?: string;
+    until?: string;
+    taskIds?: string[];
+    outputPath?: string;
+    append?: boolean;
+}, cwd?: string, accessor?: DataAccessor): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=changelog.d.ts.map

package/dist/core/ui/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../../src/core/ui/changelog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAsBjE,0CAA0C;AAC1C,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACf,EACN,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgD1B;AAWD,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,2CAA2C;AAC3C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CA0BjF;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CAeR;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,EACN,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC"}

package/dist/core/ui/changelog.js

@@ -0,0 +1,195 @@
+/**
+ * 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 { existsSync, readFileSync, writeFileSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+import { readJson } from '../../store/json.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 = [];
+    if (accessor) {
+        const todoData = await accessor.loadTodoFile();
+        if (todoData?.tasks)
+            dataSources.push({ tasks: todoData.tasks });
+        const archiveData = await accessor.loadArchive();
+        if (archiveData?.archivedTasks)
+            dataSources.push({ tasks: archiveData.archivedTasks });
+    }
+    else {
+        const todoPath = join(getCleoDir(cwd), 'todo.json');
+        const archivePath = join(getCleoDir(cwd), 'todo-archive.json');
+        for (const path of [todoPath, archivePath]) {
+            if (!existsSync(path))
+                continue;
+            const data = await readJson(path);
+            if (data?.tasks)
+                dataSources.push(data);
+        }
+    }
+    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,
+                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/core/ui/changelog.js.map

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

package/dist/core/ui/command-registry.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Dynamic command registry from self-describing script headers.
+ *
+ * Parses ###CLEO header blocks from script files and builds a registry
+ * of available commands with metadata (category, synopsis, flags, etc.).
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Parsed command metadata. */
+export interface CommandMeta {
+    command: string;
+    category: string;
+    synopsis: string;
+    aliases: string[];
+    relevance: string;
+    flags: string[];
+    exits: string[];
+    jsonOutput: boolean;
+    jsonDefault: boolean;
+    subcommands: string[];
+    note: string;
+    aliasFor: string;
+    scriptName: string;
+}
+/** Parse a ###CLEO header block from a script file. */
+export declare function parseCommandHeader(scriptPath: string): CommandMeta | null;
+/**
+ * Scan a scripts directory and build a command registry.
+ * Returns a map of command name to metadata.
+ */
+export declare function scanAllCommands(scriptsDir: string): Map<string, CommandMeta>;
+/** Validate a command header has required fields. */
+export declare function validateHeader(meta: CommandMeta): {
+    valid: boolean;
+    errors: string[];
+};
+/** Get command-to-script mapping. */
+export declare function getCommandScriptMap(scriptsDir: string): Record<string, string>;
+/** Group commands by category. */
+export declare function getCommandsByCategory(scriptsDir: string): Record<string, CommandMeta[]>;
+/** Filter commands by relevance level. */
+export declare function getCommandsByRelevance(scriptsDir: string, relevance: string): CommandMeta[];
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/core/ui/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../../src/core/ui/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA8DzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAe5E;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAQtF;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,kCAAkC;AAClC,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAW/B;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAKf"}

package/dist/core/ui/command-registry.js

@@ -0,0 +1,156 @@
+/**
+ * Dynamic command registry from self-describing script headers.
+ *
+ * Parses ###CLEO header blocks from script files and builds a registry
+ * of available commands with metadata (category, synopsis, flags, etc.).
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+/** Header start/end markers for CLEO command metadata. */
+const CLEO_HEADER_START = '###CLEO';
+const CLEO_HEADER_END = '###END';
+/** Parse a ###CLEO header block from a script file. */
+export function parseCommandHeader(scriptPath) {
+    if (!existsSync(scriptPath))
+        return null;
+    const content = readFileSync(scriptPath, 'utf-8');
+    const lines = content.split('\n');
+    let inHeader = false;
+    const headerLines = [];
+    for (const line of lines) {
+        if (line.trim() === CLEO_HEADER_START) {
+            inHeader = true;
+            continue;
+        }
+        if (line.trim() === CLEO_HEADER_END)
+            break;
+        if (inHeader && line.startsWith('# ')) {
+            headerLines.push(line.slice(2));
+        }
+    }
+    if (headerLines.length === 0)
+        return null;
+    const meta = {
+        command: '',
+        category: '',
+        synopsis: '',
+        aliases: [],
+        relevance: '',
+        flags: [],
+        exits: [],
+        jsonOutput: false,
+        jsonDefault: false,
+        subcommands: [],
+        note: '',
+        aliasFor: '',
+        scriptName: basename(scriptPath),
+    };
+    for (const line of headerLines) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        switch (key) {
+            case 'command':
+                meta.command = value;
+                break;
+            case 'category':
+                meta.category = value;
+                break;
+            case 'synopsis':
+                meta.synopsis = value;
+                break;
+            case 'aliases':
+                meta.aliases = value.split(',').map(s => s.trim()).filter(Boolean);
+                break;
+            case 'relevance':
+                meta.relevance = value;
+                break;
+            case 'flags':
+                meta.flags = value.split(',').map(s => s.trim()).filter(Boolean);
+                break;
+            case 'exits':
+                meta.exits = value.split(',').map(s => s.trim()).filter(Boolean);
+                break;
+            case 'json_output':
+                meta.jsonOutput = value === 'true';
+                break;
+            case 'json_default':
+                meta.jsonDefault = value === 'true';
+                break;
+            case 'subcommands':
+                meta.subcommands = value.split(',').map(s => s.trim()).filter(Boolean);
+                break;
+            case 'note':
+                meta.note = value;
+                break;
+            case 'alias_for':
+                meta.aliasFor = value;
+                break;
+        }
+    }
+    return meta.command ? meta : null;
+}
+/**
+ * Scan a scripts directory and build a command registry.
+ * Returns a map of command name to metadata.
+ */
+export function scanAllCommands(scriptsDir) {
+    const registry = new Map();
+    if (!existsSync(scriptsDir))
+        return registry;
+    for (const file of readdirSync(scriptsDir)) {
+        if (!file.endsWith('.sh') && !file.endsWith('.ts'))
+            continue;
+        const meta = parseCommandHeader(join(scriptsDir, file));
+        if (meta) {
+            registry.set(meta.command, meta);
+        }
+    }
+    return registry;
+}
+/** Validate a command header has required fields. */
+export function validateHeader(meta) {
+    const errors = [];
+    if (!meta.command)
+        errors.push('Missing required field: command');
+    if (!meta.category)
+        errors.push('Missing required field: category');
+    if (!meta.synopsis)
+        errors.push('Missing required field: synopsis');
+    return { valid: errors.length === 0, errors };
+}
+/** Get command-to-script mapping. */
+export function getCommandScriptMap(scriptsDir) {
+    const registry = scanAllCommands(scriptsDir);
+    const map = {};
+    for (const [cmd, meta] of registry) {
+        map[cmd] = meta.scriptName;
+        for (const alias of meta.aliases) {
+            map[alias] = meta.scriptName;
+        }
+    }
+    return map;
+}
+/** Group commands by category. */
+export function getCommandsByCategory(scriptsDir) {
+    const registry = scanAllCommands(scriptsDir);
+    const byCategory = {};
+    for (const meta of registry.values()) {
+        const cat = meta.category || 'Other';
+        if (!byCategory[cat])
+            byCategory[cat] = [];
+        byCategory[cat].push(meta);
+    }
+    return byCategory;
+}
+/** Filter commands by relevance level. */
+export function getCommandsByRelevance(scriptsDir, relevance) {
+    const registry = scanAllCommands(scriptsDir);
+    return Array.from(registry.values()).filter(meta => meta.relevance === relevance);
+}
+//# sourceMappingURL=command-registry.js.map

package/dist/core/ui/command-registry.js.map

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