@cleocode/cleo 2026.2.5

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

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

@@ -0,0 +1,94 @@
+/**
+ * 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
+ */
+/** Default flag values. */
+export function defaultFlags() {
+    return {
+        format: '',
+        quiet: false,
+        dryRun: false,
+        verbose: false,
+        help: false,
+        force: false,
+        remaining: [],
+    };
+}
+/**
+ * Parse common CLI flags from an argument array.
+ * Returns flags and remaining positional arguments.
+ */
+export function parseCommonFlags(args) {
+    const flags = defaultFlags();
+    const remaining = [];
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case '--json':
+                flags.format = 'json';
+                break;
+            case '--human':
+                flags.format = 'human';
+                break;
+            case '--format': {
+                i++;
+                const fmt = args[i];
+                if (fmt === 'json' || fmt === 'human') {
+                    flags.format = fmt;
+                }
+                break;
+            }
+            case '--quiet':
+            case '-q':
+                flags.quiet = true;
+                break;
+            case '--dry-run':
+                flags.dryRun = true;
+                break;
+            case '--verbose':
+            case '-v':
+                flags.verbose = true;
+                break;
+            case '--help':
+            case '-h':
+                flags.help = true;
+                break;
+            case '--force':
+            case '-f':
+                flags.force = true;
+                break;
+            case '--':
+                // Everything after -- is positional
+                remaining.push(...args.slice(i + 1));
+                i = args.length; // break loop
+                break;
+            default:
+                remaining.push(arg);
+                break;
+        }
+        i++;
+    }
+    flags.remaining = remaining;
+    return flags;
+}
+/**
+ * Resolve output format based on flags and TTY detection.
+ * Returns 'json' for non-TTY (piped), 'human' for TTY.
+ */
+export function resolveFormat(flagFormat) {
+    if (flagFormat === 'json' || flagFormat === 'human')
+        return flagFormat;
+    // Auto-detect: JSON for pipes, human for terminals
+    return process.stdout.isTTY ? 'human' : 'json';
+}
+/** Check if output should be JSON. */
+export function isJsonOutput(flags) {
+    return resolveFormat(flags.format) === 'json';
+}
+//# sourceMappingURL=flags.js.map

package/dist/core/ui/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/core/ui/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,2BAA2B;AAC3B,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QAErB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;gBACtB,MAAM;YACR,KAAK,SAAS;gBACZ,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;gBACvB,MAAM;YACR,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,CAAC,EAAE,CAAC;gBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;oBACtC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;gBACrB,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC;YACf,KAAK,IAAI;gBACP,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,WAAW;gBACd,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI;gBACP,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,IAAI;gBACP,oCAAoC;gBACpC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACrC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,aAAa;gBAC9B,MAAM;YACR;gBACE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,MAAM;QACV,CAAC;QACD,CAAC,EAAE,CAAC;IACN,CAAC;IAED,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC;IAEvE,mDAAmD;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,OAAO,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AAChD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAa9C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/ui/index.js

@@ -0,0 +1,28 @@
+/**
+ * UI module - flags, changelog, command registry, aliases, injection, MCP config.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+// CLI flags
+export { parseCommonFlags, defaultFlags, resolveFormat, isJsonOutput, } from './flags.js';
+// Changelog generation
+export { discoverReleaseTasks, groupTasksIntoSections, generateChangelogMarkdown, formatChangelogJson, writeChangelogFile, appendToChangelog, generateChangelog, } from './changelog.js';
+// Command registry
+export { parseCommandHeader, scanAllCommands, validateHeader, getCommandScriptMap, getCommandsByCategory, getCommandsByRelevance, } from './command-registry.js';
+// Alias management
+export { getCurrentShell, getRcFilePath, detectAvailableShells, generateBashAliases, generatePowershellAliases, hasAliasBlock, getInstalledVersion, injectAliases, removeAliases, checkAliasesStatus, ALIASES_VERSION, } from './aliases.js';
+// Injection & MCP config: DELETED (T4674, T4675, T4677)
+// All injection, provider detection, and MCP config management is now
+// delegated to @cleocode/caamp via src/mcp/engine/caamp-adapter.ts.
+// See Wave 8 epic T4663 for migration context.
+//
+// Legacy exports removed:
+//   injection.ts    -> CAAMP inject()/checkInjection()
+//   mcp-config.ts   -> CAAMP detectAllProviders()/installMcpServer()
+//   injection-registry.ts -> CAAMP getInstructionFiles()
+// Injection legacy utilities (kept for validation/migration support)
+export { getValidationKey, extractMarkerVersion, INJECTION_VALIDATION_KEYS, } from './injection-legacy.js';
+// Version check
+export { checkProjectNeedsUpdate, showVersionWarnings, } from './version-check.js';
+//# sourceMappingURL=index.js.map

package/dist/core/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY;AACZ,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,uBAAuB;AACvB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,wDAAwD;AACxD,sEAAsE;AACtE,oEAAoE;AACpE,+CAA+C;AAC/C,EAAE;AACF,0BAA0B;AAC1B,uDAAuD;AACvD,qEAAqE;AACrE,yDAAyD;AAEzD,qEAAqE;AACrE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection-legacy.d.ts","sourceRoot":"","sources":["../../../src/core/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/core/ui/injection-legacy.js

@@ -0,0 +1,42 @@
+/**
+ * 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 const INJECTION_VALIDATION_KEYS = {
+    'CLAUDE.md': 'claude_md',
+    'AGENTS.md': 'agents_md',
+    'GEMINI.md': 'gemini_md',
+};
+/**
+ * Get the validation key for a target filename.
+ */
+export function getValidationKey(target) {
+    return INJECTION_VALIDATION_KEYS[target] ?? target.toLowerCase().replace(/[^a-z0-9]/g, '_');
+}
+/**
+ * Version pattern for injection markers.
+ * Matches: "CLEO:START -->" (current) or "CLEO:START v0.58.6 -->" (legacy)
+ */
+const INJECTION_VERSION_PATTERN = /CLEO:START( v(\d+\.\d+\.\d+))? -->/;
+/**
+ * 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 function extractMarkerVersion(markerLine) {
+    const match = markerLine.match(INJECTION_VERSION_PATTERN);
+    if (!match)
+        return null;
+    return match[2] ?? null;
+}
+//# sourceMappingURL=injection-legacy.js.map

package/dist/core/ui/injection-legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-legacy.js","sourceRoot":"","sources":["../../../src/core/ui/injection-legacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,WAAW;CAChB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,yBAAyB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,yBAAyB,GAAG,oCAAoC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Injection target registry - single source of truth for injectable documentation files.
+ * Ported from lib/ui/injection-registry.sh
+ *
+ * Defines all supported injection targets and marker formats.
+ * Add new targets here; all commands auto-discover them.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/**
+ * Supported injection target filenames.
+ * Only 3 real instruction files:
+ * - CLAUDE.md (Claude Code)
+ * - AGENTS.md (all others including Codex and Kimi)
+ * - GEMINI.md (Gemini CLI)
+ */
+export declare const INJECTION_TARGETS: readonly ["CLAUDE.md", "AGENTS.md", "GEMINI.md"];
+export type InjectionTarget = (typeof INJECTION_TARGETS)[number];
+/** Injection block marker start. */
+export declare const INJECTION_MARKER_START = "<!-- CLEO:START";
+/** Injection block marker end. */
+export declare const INJECTION_MARKER_END = "<!-- CLEO:END -->";
+/**
+ * Version pattern for injection markers.
+ * Matches: "CLEO:START -->" (current) or "CLEO:START v0.58.6 -->" (legacy)
+ */
+export declare const INJECTION_VERSION_PATTERN: RegExp;
+/** Template path for injection content (relative to CLEO_HOME). */
+export declare const INJECTION_TEMPLATE_MAIN = "templates/AGENT-INJECTION.md";
+/** Template directory for agent-specific overrides (relative to CLEO_HOME). */
+export declare const INJECTION_TEMPLATE_DIR = "templates/agents";
+/**
+ * Validation key names for JSON output.
+ * Maps target filenames to JSON-safe key names used in validation results.
+ * @task T4552
+ */
+export declare const INJECTION_VALIDATION_KEYS: Readonly<Record<InjectionTarget, string>>;
+/**
+ * Check if a filename is a valid injection target.
+ * @task T4552
+ */
+export declare function isInjectionTarget(filename: string): filename is InjectionTarget;
+/**
+ * Get the validation key for a target filename.
+ * @task T4552
+ */
+export declare function getValidationKey(target: InjectionTarget): 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.
+ * @task T4552
+ */
+export declare function extractMarkerVersion(markerLine: string): string | null;
+//# sourceMappingURL=injection-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection-registry.d.ts","sourceRoot":"","sources":["../../../src/core/ui/injection-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kDAAmD,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,oCAAoC;AACpC,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAuC,CAAC;AAE9E,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAItE,CAAC;AAEX;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,eAAe,CAE/E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItE"}

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

@@ -0,0 +1,68 @@
+/**
+ * Injection target registry - single source of truth for injectable documentation files.
+ * Ported from lib/ui/injection-registry.sh
+ *
+ * Defines all supported injection targets and marker formats.
+ * Add new targets here; all commands auto-discover them.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/**
+ * Supported injection target filenames.
+ * Only 3 real instruction files:
+ * - CLAUDE.md (Claude Code)
+ * - AGENTS.md (all others including Codex and Kimi)
+ * - GEMINI.md (Gemini CLI)
+ */
+export const INJECTION_TARGETS = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md'];
+/** Injection block marker start. */
+export const INJECTION_MARKER_START = '<!-- CLEO:START';
+/** Injection block marker end. */
+export const INJECTION_MARKER_END = '<!-- CLEO:END -->';
+/**
+ * Version pattern for injection markers.
+ * Matches: "CLEO:START -->" (current) or "CLEO:START v0.58.6 -->" (legacy)
+ */
+export const INJECTION_VERSION_PATTERN = /CLEO:START( v(\d+\.\d+\.\d+))? -->/;
+/** Template path for injection content (relative to CLEO_HOME). */
+export const INJECTION_TEMPLATE_MAIN = 'templates/AGENT-INJECTION.md';
+/** Template directory for agent-specific overrides (relative to CLEO_HOME). */
+export const INJECTION_TEMPLATE_DIR = 'templates/agents';
+/**
+ * Validation key names for JSON output.
+ * Maps target filenames to JSON-safe key names used in validation results.
+ * @task T4552
+ */
+export const INJECTION_VALIDATION_KEYS = {
+    'CLAUDE.md': 'claude_md',
+    'AGENTS.md': 'agents_md',
+    'GEMINI.md': 'gemini_md',
+};
+/**
+ * Check if a filename is a valid injection target.
+ * @task T4552
+ */
+export function isInjectionTarget(filename) {
+    return INJECTION_TARGETS.includes(filename);
+}
+/**
+ * Get the validation key for a target filename.
+ * @task T4552
+ */
+export function getValidationKey(target) {
+    return INJECTION_VALIDATION_KEYS[target];
+}
+/**
+ * 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.
+ * @task T4552
+ */
+export function extractMarkerVersion(markerLine) {
+    const match = markerLine.match(INJECTION_VERSION_PATTERN);
+    if (!match)
+        return null;
+    return match[2] ?? null;
+}
+//# sourceMappingURL=injection-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection-registry.js","sourceRoot":"","sources":["../../../src/core/ui/injection-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAGlF,oCAAoC;AACpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD,kCAAkC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,oCAAoC,CAAC;AAE9E,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA8C;IAClF,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,WAAW;CAChB,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,51 @@
+/**
+ * Instruction injection engine - manages CLEO instruction blocks in target files.
+ *
+ * Handles injection of CLEO configuration blocks into CLAUDE.md, AGENTS.md,
+ * GEMINI.md, and other agent instruction files. Uses marker-based idempotent
+ * injection to update without duplicating content.
+ *
+ * NOTE: For CAAMP-managed injection, use @cleocode/caamp imports.
+ * This module provides CLEO-specific wrapper logic only.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Valid injection target filenames. */
+export declare const INJECTION_TARGETS: readonly ["CLAUDE.md", "AGENTS.md", "GEMINI.md"];
+export type InjectionTarget = (typeof INJECTION_TARGETS)[number];
+/** Check if a filename is a valid injection target. */
+export declare function isValidTarget(target: string): target is InjectionTarget;
+/** Check if a file has a CLEO injection block. */
+export declare function hasInjectionBlock(filePath: string): boolean;
+/** Get the template path for injection content. */
+export declare function getTemplatePath(cwd?: string): string;
+/** Get the content between CLEO markers in a file. */
+export declare function getInjectionContent(filePath: string): string | null;
+/** Injection action result. */
+export interface InjectionResult {
+    action: 'created' | 'updated' | 'added' | 'no_change';
+    target: string;
+    dryRun: boolean;
+}
+/**
+ * Update or add injection to a target file.
+ * Idempotent: will update existing block or add new one.
+ */
+export declare function injectionUpdate(target: string, options?: {
+    dryRun?: boolean;
+    templatePath?: string;
+}): InjectionResult;
+/** Check injection status for a target file. */
+export declare function injectionCheck(target: string): {
+    target: string;
+    status: 'configured' | 'none' | 'missing' | 'outdated';
+    fileExists: boolean;
+    hasBlock: boolean;
+};
+/** Update all injection targets in the project root. */
+export declare function updateAllTargets(options?: {
+    dryRun?: boolean;
+    cwd?: string;
+}): InjectionResult[];
+//# sourceMappingURL=injection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../../../src/core/ui/injection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,kDAAmD,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,eAAe,CAGvE;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOnE;AAeD,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,eAAe,CAuCjB;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAiBA;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,eAAe,EAAE,CAMnB"}

package/dist/core/ui/injection.js

@@ -0,0 +1,125 @@
+/**
+ * Instruction injection engine - manages CLEO instruction blocks in target files.
+ *
+ * Handles injection of CLEO configuration blocks into CLAUDE.md, AGENTS.md,
+ * GEMINI.md, and other agent instruction files. Uses marker-based idempotent
+ * injection to update without duplicating content.
+ *
+ * NOTE: For CAAMP-managed injection, use @cleocode/caamp imports.
+ * This module provides CLEO-specific wrapper logic only.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { getCleoDir } from '../paths.js';
+/** Injection block markers. */
+const MARKER_START = '<!-- CLEO:START -->';
+const MARKER_END = '<!-- CLEO:END -->';
+/** Valid injection target filenames. */
+export const INJECTION_TARGETS = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md'];
+/** Check if a filename is a valid injection target. */
+export function isValidTarget(target) {
+    const name = target.split('/').pop() ?? target;
+    return INJECTION_TARGETS.includes(name);
+}
+/** Check if a file has a CLEO injection block. */
+export function hasInjectionBlock(filePath) {
+    if (!existsSync(filePath))
+        return false;
+    const content = readFileSync(filePath, 'utf-8');
+    return content.includes(MARKER_START) && content.includes(MARKER_END);
+}
+/** Get the template path for injection content. */
+export function getTemplatePath(cwd) {
+    return join(getCleoDir(cwd), 'templates', 'AGENT-INJECTION.md');
+}
+/** Get the content between CLEO markers in a file. */
+export function getInjectionContent(filePath) {
+    if (!hasInjectionBlock(filePath))
+        return null;
+    const content = readFileSync(filePath, 'utf-8');
+    const startIdx = content.indexOf(MARKER_START) + MARKER_START.length;
+    const endIdx = content.indexOf(MARKER_END);
+    return content.slice(startIdx, endIdx).trim();
+}
+/**
+ * Build the injection content from template.
+ * Returns the full block including markers.
+ */
+function buildInjectionBlock(templatePath) {
+    if (!existsSync(templatePath)) {
+        return `${MARKER_START}\n@${templatePath}\n${MARKER_END}`;
+    }
+    // Use @-reference format
+    return `${MARKER_START}\n@${templatePath}\n${MARKER_END}`;
+}
+/**
+ * Update or add injection to a target file.
+ * Idempotent: will update existing block or add new one.
+ */
+export function injectionUpdate(target, options = {}) {
+    const templatePath = options.templatePath ?? '.cleo/templates/AGENT-INJECTION.md';
+    const injectionBlock = buildInjectionBlock(templatePath);
+    let action;
+    if (!existsSync(target)) {
+        action = 'created';
+    }
+    else if (hasInjectionBlock(target)) {
+        // Check if content is already up to date
+        const current = getInjectionContent(target);
+        const expected = `@${templatePath}`;
+        if (current === expected) {
+            return { action: 'no_change', target, dryRun: options.dryRun ?? false };
+        }
+        action = 'updated';
+    }
+    else {
+        action = 'added';
+    }
+    if (options.dryRun) {
+        return { action, target, dryRun: true };
+    }
+    if (action === 'created') {
+        writeFileSync(target, injectionBlock + '\n', 'utf-8');
+    }
+    else if (action === 'updated') {
+        const content = readFileSync(target, 'utf-8');
+        const startIdx = content.indexOf(MARKER_START);
+        const endIdx = content.indexOf(MARKER_END) + MARKER_END.length;
+        const updated = content.slice(0, startIdx) + injectionBlock + content.slice(endIdx);
+        writeFileSync(target, updated, 'utf-8');
+    }
+    else {
+        // 'added' - prepend to file
+        const existing = readFileSync(target, 'utf-8');
+        writeFileSync(target, injectionBlock + '\n' + existing, 'utf-8');
+    }
+    return { action, target, dryRun: false };
+}
+/** Check injection status for a target file. */
+export function injectionCheck(target) {
+    if (!existsSync(target)) {
+        return { target, status: 'missing', fileExists: false, hasBlock: false };
+    }
+    const hasBlock = hasInjectionBlock(target);
+    if (!hasBlock) {
+        return { target, status: 'none', fileExists: true, hasBlock: false };
+    }
+    // Check if content is the expected @-reference
+    const content = getInjectionContent(target);
+    if (content?.startsWith('@.cleo/templates/')) {
+        return { target, status: 'configured', fileExists: true, hasBlock: true };
+    }
+    return { target, status: 'outdated', fileExists: true, hasBlock: true };
+}
+/** Update all injection targets in the project root. */
+export function updateAllTargets(options = {}) {
+    const projectRoot = dirname(getCleoDir(options.cwd));
+    return INJECTION_TARGETS.map(target => {
+        const targetPath = join(projectRoot, target);
+        return injectionUpdate(targetPath, { dryRun: options.dryRun });
+    });
+}
+//# sourceMappingURL=injection.js.map

package/dist/core/ui/injection.js.map

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

package/dist/core/ui/mcp-config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCP server configuration for multi-tool auto-detection.
+ *
+ * Detects installed AI coding tools (Claude Code, Cursor, Gemini CLI, etc.)
+ * and generates MCP server configuration entries for each.
+ *
+ * NOTE: For CAAMP-managed MCP config, use @cleocode/caamp imports.
+ * This module provides CLEO-specific detection and configuration logic.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Known tool keys (ordered). */
+export declare const MCP_TOOL_KEYS: readonly ["claude-code", "claude-desktop", "cursor", "gemini-cli", "kimi", "windsurf", "goose", "vscode", "zed", "codex"];
+export type MCPToolKey = (typeof MCP_TOOL_KEYS)[number];
+/** Tool metadata. */
+export interface MCPToolInfo {
+    key: MCPToolKey;
+    displayName: string;
+    format: 'json5' | 'json';
+    globalPath: string;
+    projectPath: string;
+    detected: boolean;
+}
+/** Detect all installed tools. */
+export declare function detectAllTools(projectDir?: string): MCPToolInfo[];
+/** Generate an MCP server entry for CLEO. */
+export declare function generateMCPEntry(cleoPath?: string): Record<string, unknown>;
+/** Write MCP config to a tool's config file. */
+export declare function writeMCPConfig(tool: MCPToolKey, entry: Record<string, unknown>, options?: {
+    project?: boolean;
+    projectDir?: string;
+    dryRun?: boolean;
+}): {
+    action: string;
+    path: string;
+};
+/** Get detection summary for all tools. */
+export declare function getDetectionSummary(projectDir?: string): Record<string, unknown>;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/core/ui/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../../src/core/ui/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,iCAAiC;AACjC,eAAO,MAAM,aAAa,2HAWhB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,qBAAqB;AACrB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAsFD,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAWjE;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACzE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwBlC;AAED,2CAA2C;AAC3C,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAehF"}