@cleocode/core 2026.3.42 → 2026.3.43

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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"}

package/dist/validation/docs-sync.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Documentation drift detection - ported from lib/validation/docs-sync.sh
+ *
+ * Detects drift between scripts/, COMMANDS-INDEX.json, wrapper templates,
+ * and README documentation. Helps keep documentation in sync with code.
+ *
+ * @task T4527
+ * @epic T4454
+ */
+export interface DriftIssue {
+    type: 'missing_from_index' | 'orphaned_index' | 'missing_from_wrapper' | 'missing_from_readme';
+    severity: 'error' | 'warning';
+    item: string;
+    message: string;
+}
+export interface DriftReport {
+    mode: 'quick' | 'full';
+    issues: DriftIssue[];
+    exitCode: 0 | 1 | 2;
+}
+export interface CommandIndexEntry {
+    name: string;
+    script?: string;
+    aliasFor?: string | null;
+    note?: string | null;
+}
+export interface CommandIndex {
+    commands: CommandIndexEntry[];
+}
+/**
+ * Get command names from scripts directory.
+ * Returns sorted list of script basenames without .sh extension.
+ * @task T4527
+ */
+export declare function getScriptCommands(scriptsDir: string): string[];
+/**
+ * Get script names from COMMANDS-INDEX.json.
+ * @task T4527
+ */
+export declare function getIndexScripts(indexPath: string): string[];
+/**
+ * Get command names from COMMANDS-INDEX.json.
+ * @task T4527
+ */
+export declare function getIndexCommands(indexPath: string): string[];
+/**
+ * Check commands index vs scripts directory for sync.
+ * @task T4527
+ */
+export declare function checkCommandsSync(scriptsDir: string, indexPath: string): DriftIssue[];
+/**
+ * Check wrapper template sync with COMMANDS-INDEX.
+ * @task T4527
+ */
+export declare function checkWrapperSync(wrapperPath: string, indexPath: string): DriftIssue[];
+/**
+ * Run full drift detection across scripts, index, wrapper, and README.
+ * @task T4527
+ */
+export declare function detectDrift(mode?: 'quick' | 'full', projectRoot?: string): DriftReport;
+/**
+ * Check if drift detection should run automatically based on config.
+ * @task T4527
+ */
+export declare function shouldRunDriftDetection(enabled?: boolean, autoCheck?: boolean, command?: string, criticalCommands?: string[]): boolean;
+//# sourceMappingURL=docs-sync.d.ts.map

package/dist/validation/docs-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-sync.d.ts","sourceRoot":"","sources":["../../src/validation/docs-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;IAC/F,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAW9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAU5D;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CA+BrF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAoCrF;AAkBD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAE,OAAO,GAAG,MAAe,EAC/B,WAAW,GAAE,MAAY,GACxB,WAAW,CA4Cb;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,OAAc,EACvB,SAAS,GAAE,OAAe,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,gBAAgB,GAAE,MAAM,EAAO,GAC9B,OAAO,CAMT"}

package/dist/validation/doctor/checks.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Doctor health checks - ported from lib/validation/doctor-checks.sh
+ *
+ * Global health check functions: CLI installation, version, docs accessibility,
+ * agent configs, registered projects, injection files, and aliases.
+ *
+ * @task T4525
+ * @epic T4454
+ */
+export type CheckStatus = 'passed' | 'failed' | 'warning' | 'info';
+export interface CheckResult {
+    id: string;
+    category: string;
+    status: CheckStatus;
+    message: string;
+    details: Record<string, unknown>;
+    fix: string | null;
+}
+/** @task T4525 */
+export declare function checkCliInstallation(cleoHome?: string): CheckResult;
+/** @task T4525 */
+export declare function checkCliVersion(cleoHome?: string): CheckResult;
+/** @task T4525 */
+export declare function checkDocsAccessibility(cleoHome?: string): CheckResult;
+/** @task T4525 */
+export declare function checkAtReferenceResolution(cleoHome?: string): CheckResult;
+/**
+ * Check that AGENTS.md exists in project root and contains the CAAMP:START marker,
+ * indicating it serves as the injection hub for CLEO protocol content.
+ */
+export declare function checkAgentsMdHub(projectRoot?: string): CheckResult;
+/**
+ * Check if project root .gitignore is blocking the entire .cleo/ directory.
+ * This prevents core CLEO data from being tracked by git.
+ * @task T4641
+ * @epic T4637
+ */
+export declare function checkRootGitignore(projectRoot?: string): CheckResult;
+/**
+ * Check if .cleo/.gitignore exists and matches the template.
+ * @task T4700
+ */
+export declare function checkCleoGitignore(projectRoot?: string): CheckResult;
+/**
+ * Check that vital CLEO configuration files are tracked by git.
+ * Only checks config files (config.json, .gitignore, project-info.json,
+ * project-context.json). SQLite databases are excluded per ADR-013.
+ * @task T4700
+ */
+export declare function checkVitalFilesTracked(projectRoot?: string): CheckResult;
+/**
+ * Check that core CLEO files are not being ignored by .gitignore.
+ * Uses `git check-ignore` to detect files that would be excluded by
+ * any gitignore rule (root, .cleo/, or global).
+ * Returns critical status if any protected file is gitignored.
+ */
+export declare function checkCoreFilesNotIgnored(projectRoot?: string): CheckResult;
+/**
+ * Check that SQLite databases (.cleo/tasks.db) are NOT tracked by project git.
+ * Tracked SQLite files cause data loss from merge conflicts (ADR-013).
+ * Warns if tasks.db is currently tracked so the user can untrack it.
+ * @task T5160
+ */
+export declare function checkSqliteNotTracked(projectRoot?: string): CheckResult;
+/**
+ * Check if any legacy output directories still exist.
+ * Delegates detection to the migration/agent-outputs utility.
+ * @task T4700
+ */
+export declare function checkLegacyAgentOutputs(projectRoot?: string): CheckResult;
+/**
+ * Verify balanced CAAMP:START/END markers in CLAUDE.md and AGENTS.md.
+ * @task T5153
+ */
+export declare function checkCaampMarkerIntegrity(projectRoot?: string): CheckResult;
+/**
+ * Parse @ references from AGENTS.md CAAMP block and verify each target file exists.
+ * @task T5153
+ */
+export declare function checkAtReferenceTargetExists(projectRoot?: string): CheckResult;
+/**
+ * Compare templates/CLEO-INJECTION.md vs ~/.cleo/templates/CLEO-INJECTION.md.
+ * @task T5153
+ */
+export declare function checkTemplateFreshness(projectRoot?: string, cleoHome?: string): CheckResult;
+/**
+ * Verify all 3 tier markers exist with matching close tags in deployed template.
+ * @task T5153
+ */
+export declare function checkTierMarkersPresent(cleoHome?: string): CheckResult;
+/**
+ * Check that Node.js meets the minimum required version.
+ * Provides OS-specific upgrade instructions when below minimum.
+ */
+export declare function checkNodeVersion(): CheckResult;
+/**
+ * Check that global schemas at ~/.cleo/schemas/ are installed and not stale.
+ * Delegates to checkGlobalSchemas() from schema-management.ts.
+ */
+export declare function checkGlobalSchemaHealth(_projectRoot?: string): CheckResult;
+/**
+ * Warn if deprecated .cleo/schemas/ directory still exists in the project.
+ * Schemas should live in ~/.cleo/schemas/ (global), not in project directories.
+ */
+export declare function checkNoLocalSchemas(projectRoot?: string): CheckResult;
+/**
+ * Check that active JSON files (config.json, project-info.json, etc.) are valid
+ * against their schemas and have current schema versions.
+ *
+ * Maps JsonFileIntegrityResult[] from checkSchemaIntegrity() into CheckResult[],
+ * then returns a single rolled-up CheckResult for the doctor summary.
+ */
+export declare function checkJsonSchemaIntegrity(projectDir: string): Promise<CheckResult>;
+/**
+ * Run all global health checks and return results array.
+ * @task T4525
+ */
+export declare function runAllGlobalChecks(cleoHome?: string, projectRoot?: string): CheckResult[];
+/**
+ * Calculate overall status from check results.
+ * Returns: 0=passed, 50=warning, 52=critical.
+ * @task T4525
+ */
+export declare function calculateHealthStatus(checks: CheckResult[]): number;
+//# sourceMappingURL=checks.d.ts.map

package/dist/validation/doctor/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../src/validation/doctor/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAMD,kBAAkB;AAClB,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAsB,GAAG,WAAW,CAYlF;AASD,kBAAkB;AAClB,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,WAAW,CAyB7E;AAMD,kBAAkB;AAClB,wBAAgB,sBAAsB,CAAC,QAAQ,GAAE,MAAsB,GAAG,WAAW,CAoCpF;AAMD,kBAAkB;AAClB,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,MAAsB,GAAG,WAAW,CAkDxF;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAgDlE;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAuDpE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAiFpE;AAcD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAsDxE;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAuD1E;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAsDvE;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAwBzE;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CA8C3E;AAMD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CA8E9E;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAkD3F;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAqDtE;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAkC9C;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CA4C1E;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAuBrE;AAUD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2DvF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAyBzF;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAOnE"}

package/dist/validation/doctor/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Doctor module barrel exports.
+ * @task T4525
+ * @epic T4454
+ */
+export { type CheckResult, type CheckStatus, calculateHealthStatus, checkAtReferenceResolution, checkCliInstallation, checkCliVersion, checkCoreFilesNotIgnored, checkDocsAccessibility, checkNodeVersion, checkRootGitignore, checkSqliteNotTracked, runAllGlobalChecks, } from './checks.js';
+export { CACHE_TTL_SECONDS, CACHE_VERSION, cacheValidationResult, clearEntireCache, clearProjectCache, type DoctorProjectCache, type FileHashes, getCachedValidation, getCacheFilePath, getFileHash, initCacheFile, loadCache, type ProjectCacheEntry, type SchemaVersions, } from './project-cache.js';
+export { type CategorizedProjects, categorizeProjects, formatProjectHealthSummary, getJourneyGuidance, getProjectCategoryName, getProjectGuidance, getUserJourneyStage, type HealthSummary, isTempProject, type ProjectDetail, type UserJourneyStage, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/doctor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/doctor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,mBAAmB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC"}

package/dist/validation/doctor/project-cache.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Project validation caching - ported from lib/validation/doctor-project-cache.sh
+ *
+ * Caches validation results per project with TTL-based invalidation
+ * and file hash comparison for cache freshness.
+ *
+ * @task T4525
+ * @epic T4454
+ */
+export interface SchemaVersions {
+    todo?: string;
+    config?: string;
+    archive?: string;
+    log?: string;
+}
+export interface FileHashes {
+    'tasks.db'?: string;
+    'config.json'?: string;
+}
+export interface ProjectCacheEntry {
+    path: string;
+    lastValidated: string;
+    validationStatus: 'passed' | 'failed' | 'warning';
+    schemaVersions: SchemaVersions;
+    fileHashes: FileHashes;
+    issues: string[];
+    ttl: number;
+}
+export interface DoctorProjectCache {
+    version: string;
+    lastUpdated: string;
+    projects: Record<string, ProjectCacheEntry>;
+}
+export declare const CACHE_VERSION = "1.0.0";
+export declare const CACHE_TTL_SECONDS = 300;
+/**
+ * Get cache file path.
+ * @task T4525
+ */
+export declare function getCacheFilePath(cleoHome?: string): string;
+/**
+ * Initialize empty cache file.
+ * @task T4525
+ */
+export declare function initCacheFile(cacheFile: string): DoctorProjectCache;
+/**
+ * Load cache file or return null if missing/invalid.
+ * @task T4525
+ */
+export declare function loadCache(cacheFile: string): DoctorProjectCache | null;
+/**
+ * Get file hash for cache invalidation.
+ * @task T4525
+ */
+export declare function getFileHash(filePath: string): string;
+/**
+ * Check if project validation is cached and valid.
+ * Returns the cache entry if valid, null if cache miss.
+ * @task T4525
+ */
+export declare function getCachedValidation(projectHash: string, projectPath: string, cacheFile?: string): ProjectCacheEntry | null;
+/**
+ * Cache project validation results.
+ * @task T4525
+ */
+export declare function cacheValidationResult(projectHash: string, projectPath: string, validationStatus: 'passed' | 'failed' | 'warning', issues?: string[], schemaVersions?: SchemaVersions, cacheFile?: string): void;
+/**
+ * Clear cache for a specific project.
+ * @task T4525
+ */
+export declare function clearProjectCache(projectHash: string, cacheFile?: string): void;
+/**
+ * Clear entire cache.
+ * @task T4525
+ */
+export declare function clearEntireCache(cacheFile?: string): void;
+//# sourceMappingURL=project-cache.d.ts.map

package/dist/validation/doctor/project-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-cache.d.ts","sourceRoot":"","sources":["../../../src/validation/doctor/project-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC7C;AAMD,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAOrC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAcnE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAStE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,GAAG,IAAI,CAyB1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,EACjD,MAAM,GAAE,MAAM,EAAO,EACrB,cAAc,GAAE,cAAmB,EACnC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CA6BN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAO/E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMzD"}