@cleocode/core 2026.3.42 → 2026.3.44

package/dist/tasks/update.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Task update logic.
+ * @task T4461
+ * @epic T4454
+ */
+import type { Task, TaskPriority, TaskSize, TaskStatus, TaskType } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+/** Options for updating a task. */
+export interface UpdateTaskOptions {
+    taskId: string;
+    title?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    type?: TaskType;
+    size?: TaskSize;
+    phase?: string;
+    description?: string;
+    labels?: string[];
+    addLabels?: string[];
+    removeLabels?: string[];
+    depends?: string[];
+    addDepends?: string[];
+    removeDepends?: string[];
+    notes?: string;
+    acceptance?: string[];
+    files?: string[];
+    blockedBy?: string;
+    parentId?: string | null;
+    noAutoComplete?: boolean;
+}
+/** Result of updating a task. */
+export interface UpdateTaskResult {
+    task: Task;
+    changes: string[];
+}
+/**
+ * Update a task's fields.
+ * @task T4461
+ */
+export declare function updateTask(options: UpdateTaskOptions, cwd?: string, accessor?: DataAccessor): Promise<UpdateTaskResult>;
+//# sourceMappingURL=update.d.ts.map

package/dist/tasks/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/tasks/update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAK9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAsC9D,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAoO3B"}

package/dist/templates/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core Templates Module
+ *
+ * Barrel export for GitHub issue template parsing logic.
+ *
+ * @task T5705
+ * @epic T5701
+ */
+export type { IssueTemplate, TemplateConfig, TemplateResult, TemplateSection, } from './parser.js';
+export { generateTemplateConfig, getTemplateForSubcommand, parseIssueTemplates, validateLabels, } from './parser.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/templates/parser.d.ts

@@ -0,0 +1,84 @@
+/**
+ * GitHub Issue Template Parser (Core Logic)
+ *
+ * Native TypeScript implementation for parsing GitHub issue template YAML files
+ * and producing structured JSON config. Both the MCP server and the Bash CLI
+ * can consume the generated config at .cleo/issue-templates.json.
+ *
+ * Supports: parseIssueTemplates, getTemplateForSubcommand, generateTemplateConfig, validateLabels
+ *
+ * @task T5705
+ * @epic T5701
+ */
+/**
+ * A single section/field within an issue template.
+ */
+export interface TemplateSection {
+    id: string;
+    type: 'textarea' | 'dropdown' | 'input' | 'markdown' | 'checkboxes';
+    label: string;
+    required: boolean;
+    options?: string[];
+    placeholder?: string;
+}
+/**
+ * A parsed issue template.
+ */
+export interface IssueTemplate {
+    filename: string;
+    subcommand: string;
+    name: string;
+    titlePrefix: string;
+    labels: string[];
+    sections: TemplateSection[];
+}
+/**
+ * The full template config output.
+ */
+export interface TemplateConfig {
+    templates: IssueTemplate[];
+    generatedAt: string;
+    sourceDir: string;
+}
+/**
+ * Result type for template parser operations.
+ */
+export interface TemplateResult<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+/**
+ * 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 declare function parseIssueTemplates(projectRoot: string): TemplateResult<TemplateConfig>;
+/**
+ * Get template config for a specific subcommand (bug/feature/help).
+ *
+ * Performs a live parse and filters to the matching template.
+ */
+export declare function getTemplateForSubcommand(projectRoot: string, subcommand: string): TemplateResult<IssueTemplate>;
+/**
+ * Generate and cache the config as .cleo/issue-templates.json.
+ *
+ * Performs a live parse, then writes the result using writeJsonFileAtomic.
+ */
+export declare function generateTemplateConfig(projectRoot: string): Promise<TemplateResult<TemplateConfig>>;
+/**
+ * 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 declare function validateLabels(labels: string[], repoLabels: string[]): TemplateResult<{
+    existing: string[];
+    missing: string[];
+}>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/templates/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/templates/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAoHD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CA0DvF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,cAAc,CAAC,aAAa,CAAC,CA2B/B;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CA4BzC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,cAAc,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkB3D"}

package/dist/ui/aliases.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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
+ */
+/** Current alias version. */
+export declare const ALIASES_VERSION = "1.0.0";
+/** Supported shell types. */
+export type ShellType = 'bash' | 'zsh' | 'powershell' | 'cmd';
+/** Detect the current shell. */
+export declare function getCurrentShell(): ShellType;
+/** Get the RC file path for a shell. */
+export declare function getRcFilePath(shell?: ShellType): string;
+/** Detect which shells are available on the system. */
+export declare function detectAvailableShells(): ShellType[];
+/** Generate bash/zsh alias content. */
+export declare function generateBashAliases(cleoPath?: string): string;
+/** Generate PowerShell alias content. */
+export declare function generatePowershellAliases(cleoPath?: string): string;
+/** Check if aliases are already injected in a file. */
+export declare function hasAliasBlock(filePath: string): boolean;
+/** Get the installed alias version from an RC file. */
+export declare function getInstalledVersion(filePath: string): string | null;
+/** Inject aliases into a shell RC file. */
+export declare function injectAliases(filePath: string, shell?: ShellType, cleoPath?: string): {
+    action: 'created' | 'updated' | 'added';
+    version: string;
+};
+/** Remove aliases from a shell RC file. */
+export declare function removeAliases(filePath: string): boolean;
+/** Get alias status for the current shell. */
+export declare function checkAliasesStatus(shell?: ShellType): {
+    shell: ShellType;
+    rcFile: string;
+    installed: boolean;
+    version: string | null;
+    needsUpdate: boolean;
+};
+//# sourceMappingURL=aliases.d.ts.map

package/dist/ui/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/ui/aliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,6BAA6B;AAC7B,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC;AAU9D,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,SAAS,CAM3C;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAgBvD;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,SAAS,EAAE,CAQnD;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED,yCAAyC;AACzC,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnE;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,SAAkB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuB9D;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAYvD;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG;IACrD,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB,CAaA"}

package/dist/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/ui/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/ui/changelog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAuB9D,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,CAuC1B;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,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAgB5E;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,CA6BlC"}

package/dist/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/ui/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/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,CAkGzE;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,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY9E;AAED,kCAAkC;AAClC,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAWvF;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAG3F"}

package/dist/ui/flags.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Centralized flag parsing for CLEO CLI commands.
+ *
+ * Provides standardized flag handling: --json, --human, --quiet, --dry-run,
+ * --verbose, --help, --force. Commands import and use these utilities.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Parsed flag state. */
+export interface ParsedFlags {
+    format: 'json' | 'human' | '';
+    quiet: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+    help: boolean;
+    force: boolean;
+    remaining: string[];
+}
+/** Default flag values. */
+export declare function defaultFlags(): ParsedFlags;
+/**
+ * Parse common CLI flags from an argument array.
+ * Returns flags and remaining positional arguments.
+ */
+export declare function parseCommonFlags(args: string[]): ParsedFlags;
+/**
+ * Resolve output format based on flags and TTY detection.
+ * Returns 'json' for non-TTY (piped), 'human' for TTY.
+ */
+export declare function resolveFormat(flagFormat: string): 'json' | 'human';
+/** Check if output should be JSON. */
+export declare function isJsonOutput(flags: ParsedFlags): boolean;
+//# sourceMappingURL=flags.d.ts.map

package/dist/ui/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/ui/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,EAAE,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,IAAI,WAAW,CAU1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAwD5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAKlE;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAExD"}

package/dist/ui/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * UI module - flags, changelog, command registry, aliases, injection, MCP config.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+export type { ShellType } from './aliases.js';
+export { ALIASES_VERSION, checkAliasesStatus, detectAvailableShells, generateBashAliases, generatePowershellAliases, getCurrentShell, getInstalledVersion, getRcFilePath, hasAliasBlock, injectAliases, removeAliases, } from './aliases.js';
+export type { ChangelogSection } from './changelog.js';
+export { appendToChangelog, discoverReleaseTasks, formatChangelogJson, generateChangelog, generateChangelogMarkdown, groupTasksIntoSections, writeChangelogFile, } from './changelog.js';
+export type { CommandMeta } from './command-registry.js';
+export { getCommandScriptMap, getCommandsByCategory, getCommandsByRelevance, parseCommandHeader, scanAllCommands, validateHeader, } from './command-registry.js';
+export type { ParsedFlags } from './flags.js';
+export { defaultFlags, isJsonOutput, parseCommonFlags, resolveFormat, } from './flags.js';
+export { getValidationKey, INJECTION_VALIDATION_KEYS, } from './injection-legacy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAapB,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/ui/injection-legacy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Injection legacy utilities - validation keys and marker version extraction.
+ *
+ * Kept from the deleted injection-registry.ts for backward compatibility
+ * with validation output and legacy marker migration. All active injection
+ * logic is now delegated to @cleocode/caamp.
+ *
+ * @task T4677
+ * @epic T4663
+ */
+/**
+ * Validation key names for JSON output.
+ * Maps target filenames to JSON-safe key names used in validation results.
+ */
+export declare const INJECTION_VALIDATION_KEYS: Readonly<Record<string, string>>;
+/**
+ * Get the validation key for a target filename.
+ */
+export declare function getValidationKey(target: string): string;
+/**
+ * Extract the CLEO version from an injection marker string.
+ * Returns null if no version is present (current format).
+ * Returns the version string for legacy format.
+ */
+export declare function extractMarkerVersion(markerLine: string): string | null;
+//# sourceMappingURL=injection-legacy.d.ts.map

package/dist/ui/injection-legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-legacy.d.ts","sourceRoot":"","sources":["../../src/ui/injection-legacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI7D,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItE"}

package/dist/upgrade.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Core upgrade logic - unified project maintenance.
+ *
+ * Handles:
+ *   1. Storage engine migration (JSON → SQLite)
+ *   2. Schema version upgrades
+ *   3. Structural repairs (checksums, missing fields)
+ *   4. Global ~/.cleo data migration
+ *
+ * Both CLI and MCP delegate here (shared-core pattern).
+ *
+ * @task T4699
+ * @epic T4454
+ */
+/** A single upgrade action with status. */
+export interface UpgradeAction {
+    action: string;
+    status: 'applied' | 'skipped' | 'preview' | 'error';
+    details: string;
+    fix?: string;
+}
+/** Full upgrade result. */
+export interface UpgradeResult {
+    success: boolean;
+    upToDate: boolean;
+    dryRun: boolean;
+    actions: UpgradeAction[];
+    applied: number;
+    errors: string[];
+    /** Storage migration sub-result (if migration was triggered). */
+    storageMigration?: {
+        migrated: boolean;
+        tasksImported: number;
+        archivedImported: number;
+        sessionsImported: number;
+        warnings: string[];
+    };
+}
+/**
+ * Run a full upgrade pass on the project .cleo/ directory.
+ *
+ * Steps:
+ *   1. Pre-flight storage check (JSON → SQLite)
+ *   2. If migration needed and not dry-run, run auto-migration with backup
+ *   3. Schema version checks on JSON files
+ *   4. Structural repairs (checksums, missing fields)
+ *
+ * @param options.dryRun  Preview changes without applying
+ * @param options.includeGlobal  Also check global ~/.cleo
+ * @param options.autoMigrate  Auto-migrate storage if needed (default: true)
+ * @param options.cwd  Project directory override
+ */
+export declare function runUpgrade(options?: {
+    dryRun?: boolean;
+    includeGlobal?: boolean;
+    autoMigrate?: boolean;
+    cwd?: string;
+}): Promise<UpgradeResult>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoCH,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/F,OAAO,CAAC,aAAa,CAAC,CA41BxB"}

package/dist/validation/chain-validation.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Chain Validation Engine
+ *
+ * Validates WarpChain definitions for structural correctness (shape)
+ * and gate satisfiability (gates reference valid stages/gate names).
+ *
+ * @task T5401
+ */
+import type { ChainShape, ChainValidation, WarpChain } from '@cleocode/contracts';
+/**
+ * Validate the topology/DAG of a chain shape.
+ *
+ * Checks:
+ * - All link source/target IDs reference existing stages
+ * - entryPoint references an existing stage
+ * - All exitPoints reference existing stages
+ * - No cycles (topological sort)
+ * - All stages are reachable from the entry point
+ *
+ * @task T5401
+ */
+export declare function validateChainShape(shape: ChainShape): string[];
+/**
+ * Validate that all gates in a chain reference valid stages and gate names.
+ *
+ * Checks:
+ * - Every gate's stageId references an existing stage
+ * - Every stage_complete check references an existing stage
+ * - Every verification_gate check references a valid GateName
+ *
+ * @task T5401
+ */
+export declare function validateGateSatisfiability(chain: WarpChain): string[];
+/**
+ * Validate a complete WarpChain definition.
+ *
+ * Orchestrates shape validation and gate satisfiability checks,
+ * returning a unified ChainValidation result.
+ *
+ * @task T5401
+ */
+export declare function validateChain(chain: WarpChain): ChainValidation;
+//# sourceMappingURL=chain-validation.d.ts.map

package/dist/validation/chain-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-validation.d.ts","sourceRoot":"","sources":["../../src/validation/chain-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGlF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAmF9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CA4BrE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAa/D"}

package/dist/validation/compliance.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Compliance checking - ported from lib/validation/compliance-check.sh
+ *
+ * Validates subagent outputs against protocol requirements, checks manifest
+ * entries, research links, return format, and generates compliance metrics.
+ *
+ * @task T4524
+ * @epic T4454
+ */
+export type ManifestIntegrity = 'valid' | 'partial' | 'invalid' | 'missing';
+export type Severity = 'low' | 'medium' | 'high' | 'critical';
+export interface ComplianceMetrics {
+    timestamp: string;
+    category: string;
+    source: string;
+    sourceId: string;
+    period: string;
+    compliance: {
+        compliancePassRate: number;
+        ruleAdherenceScore: number;
+        violationCount: number;
+        violationSeverity: Severity;
+        manifestIntegrity: ManifestIntegrity;
+    };
+    tags: string[];
+    context: {
+        taskId: string;
+        researchLinked: boolean;
+        returnFormatValid: boolean;
+    };
+}
+export interface ManifestEntry {
+    id?: string;
+    research_id?: string;
+    title?: string;
+    status?: string;
+    key_findings?: string[];
+    findings_summary?: string;
+    linked_tasks?: string[];
+    task_ids?: string[];
+    agent_type?: string;
+    [key: string]: unknown;
+}
+export interface TokenMetrics {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    maxTokens: number;
+    percentage: number;
+    status: string;
+}
+export interface TokenEfficiency {
+    tokensUsed: number;
+    maxTokens: number;
+    tasksCompleted: number;
+    contextUtilization: number;
+    tokenUtilizationRate: number;
+    contextEfficiency: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface OrchestrationOverhead {
+    orchestratorTokens: number;
+    totalSubagentTokens: number;
+    numSubagents: number;
+    overheadRatio: number;
+    tokensPerSubagent: number;
+}
+/**
+ * Verify a manifest entry for a task has valid required fields.
+ * @task T4524
+ */
+export declare function checkManifestEntry(entry: ManifestEntry | null): ManifestIntegrity;
+/**
+ * Check if a response matches the expected return format.
+ * @task T4524
+ */
+export declare function checkReturnFormat(response: string): boolean;
+/**
+ * Calculate comprehensive compliance score for a subagent.
+ * @task T4524
+ */
+export declare function scoreSubagentCompliance(taskId: string, agentId: string, manifestEntry: ManifestEntry | null, researchLinked: boolean, response: string): ComplianceMetrics;
+/**
+ * Calculate token efficiency metrics.
+ * @task T4524
+ */
+export declare function calculateTokenEfficiency(tokensUsed: number, maxTokens?: number, tasksCompleted?: number, inputTokens?: number, outputTokens?: number): TokenEfficiency;
+/**
+ * Calculate orchestration overhead metrics.
+ * @task T4524
+ */
+export declare function calculateOrchestrationOverhead(orchestratorTokens: number, totalSubagentTokens: number, numSubagents?: number): OrchestrationOverhead;
+//# sourceMappingURL=compliance.d.ts.map

package/dist/validation/compliance.d.ts.map

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