@cleocode/core 2026.3.42 → 2026.3.44

package/dist/hooks/types.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Universal Hooks Core Types - Phase 2B of T5237
+ *
+ * This module defines the core type system for CLEO's Universal Hooks
+ * integration with CAAMP 1.6.0. CLEO builds the hook registry and
+ * execution system while CAAMP provides the event definitions.
+ *
+ * @module @cleocode/cleo/hooks/types
+ */
+import type { HookEvent as CAAMPHookEvent } from '@cleocode/caamp';
+export { getCommonHookEvents, getProvidersByHookEvent } from '@cleocode/caamp';
+/**
+ * CAAMP-defined hook events supported by provider capability discovery.
+ */
+export type ProviderHookEvent = CAAMPHookEvent;
+/**
+ * CLEO-local coordination events used by the autonomous runtime.
+ *
+ * These are internal lifecycle signals for worker orchestration and are not
+ * surfaced through CAAMP's provider capability registry.
+ */
+export declare const INTERNAL_HOOK_EVENTS: readonly ["onWorkAvailable", "onAgentSpawn", "onAgentComplete", "onCascadeStart", "onPatrol"];
+export type InternalHookEvent = (typeof INTERNAL_HOOK_EVENTS)[number];
+/**
+ * Full CLEO hook event union.
+ *
+ * CAAMP defines provider-facing events; CLEO extends the registry with local
+ * coordination events for autonomous execution.
+ */
+export type HookEvent = ProviderHookEvent | InternalHookEvent;
+/**
+ * Type guard for CAAMP/provider-discoverable hook events.
+ */
+export declare function isProviderHookEvent(event: HookEvent): event is ProviderHookEvent;
+/**
+ * Type guard for CLEO-local coordination hook events.
+ */
+export declare function isInternalHookEvent(event: HookEvent): event is InternalHookEvent;
+/**
+ * Base interface for all hook payloads
+ * Provides common fields available across all hook events
+ */
+export interface HookPayload {
+    /** ISO 8601 timestamp when the hook fired */
+    timestamp: string;
+    /** Optional session ID if firing within a session context */
+    sessionId?: string;
+    /** Optional task ID if firing within a task context */
+    taskId?: string;
+    /** Optional provider ID that triggered the hook */
+    providerId?: string;
+    /** Optional metadata for extensibility */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payload for onSessionStart hook
+ * Fired when a CLEO session begins
+ */
+export interface OnSessionStartPayload extends HookPayload {
+    /** Session identifier (required for session events) */
+    sessionId: string;
+    /** Human-readable session name */
+    name: string;
+    /** Session scope/area of work */
+    scope: string;
+    /** Optional agent identifier */
+    agent?: string;
+}
+/**
+ * Payload for onSessionEnd hook
+ * Fired when a CLEO session ends
+ */
+export interface OnSessionEndPayload extends HookPayload {
+    /** Session identifier */
+    sessionId: string;
+    /** Session duration in seconds */
+    duration: number;
+    /** Array of task IDs completed during this session */
+    tasksCompleted: string[];
+}
+/**
+ * Payload for onToolStart hook
+ * Fired when a task/tool operation begins
+ */
+export interface OnToolStartPayload extends HookPayload {
+    /** Task identifier */
+    taskId: string;
+    /** Human-readable task title */
+    taskTitle: string;
+    /** Optional ID of the previous task if sequential */
+    previousTask?: string;
+}
+/**
+ * Payload for onToolComplete hook
+ * Fired when a task/tool operation completes
+ */
+export interface OnToolCompletePayload extends HookPayload {
+    /** Task identifier */
+    taskId: string;
+    /** Human-readable task title */
+    taskTitle: string;
+    /** Final status of the completed task */
+    status: 'done' | 'archived' | 'cancelled';
+}
+/**
+ * Handler function type for hook events
+ * Handlers receive project root and typed payload
+ */
+export type HookHandler<T extends HookPayload = HookPayload> = (projectRoot: string, payload: T) => Promise<void> | void;
+/**
+ * Hook registration metadata
+ * Tracks registered handlers with priority and event binding
+ */
+export interface HookRegistration<T extends HookPayload = HookPayload> {
+    /** Unique identifier for this registration */
+    id: string;
+    /** CAAMP hook event this handler listens for */
+    event: HookEvent;
+    /** Handler function to execute when event fires */
+    handler: HookHandler<T>;
+    /** Priority for execution order (higher = earlier) */
+    priority: number;
+}
+/**
+ * Configuration for the hook system
+ * Controls which events are enabled/disabled
+ */
+export interface HookConfig {
+    /** Master switch for hook system */
+    enabled: boolean;
+    /** Per-event enable/disable configuration */
+    events: Record<HookEvent, boolean>;
+}
+/**
+ * Payload for onFileChange hook
+ * Fired when a tracked file is written, created, or deleted
+ */
+export interface OnFileChangePayload extends HookPayload {
+    /** Absolute or project-relative path of the changed file */
+    filePath: string;
+    /** Kind of filesystem change */
+    changeType: 'write' | 'create' | 'delete';
+    /** File size in bytes after the change (absent for deletes) */
+    sizeBytes?: number;
+}
+/**
+ * Payload for onError hook
+ * Fired when an operation fails with a structured error
+ */
+export interface OnErrorPayload extends HookPayload {
+    /** Numeric exit code or string error code */
+    errorCode: number | string;
+    /** Human-readable error message */
+    message: string;
+    /** Domain where the error occurred */
+    domain?: string;
+    /** Operation that failed */
+    operation?: string;
+    /** Gateway (query / mutate) that received the error */
+    gateway?: string;
+    /** Optional stack trace */
+    stack?: string;
+}
+/**
+ * Payload for onPromptSubmit hook
+ * Fired when an agent submits a prompt through a gateway
+ */
+export interface OnPromptSubmitPayload extends HookPayload {
+    /** Gateway that received the prompt (query / mutate) */
+    gateway: string;
+    /** Target domain */
+    domain: string;
+    /** Target operation */
+    operation: string;
+    /** Optional source identifier (e.g. agent name) */
+    source?: string;
+}
+/**
+ * Payload for onResponseComplete hook
+ * Fired when a gateway operation finishes (success or failure)
+ */
+export interface OnResponseCompletePayload extends HookPayload {
+    /** Gateway that handled the operation */
+    gateway: string;
+    /** Target domain */
+    domain: string;
+    /** Target operation */
+    operation: string;
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Wall-clock duration in milliseconds */
+    durationMs?: number;
+    /** Error code if the operation failed */
+    errorCode?: string;
+}
+/**
+ * Payload for onWorkAvailable hook
+ * Fired when the system detects ready work on a Loom/Tapestry
+ */
+export interface OnWorkAvailablePayload extends HookPayload {
+    /** IDs of tasks now ready for execution */
+    taskIds: string[];
+    /** Optional epic / Loom identifier */
+    epicId?: string;
+    /** Optional chain or tessera instance identifier */
+    chainId?: string;
+    /** Why the work became available */
+    reason?: 'dependency-cleared' | 'new-task' | 'retry' | 'manual' | 'patrol';
+}
+/**
+ * Payload for onAgentSpawn hook
+ * Fired when a worker session/process is launched
+ */
+export interface OnAgentSpawnPayload extends HookPayload {
+    /** Worker or session identifier */
+    agentId: string;
+    /** Worker role / archetype name */
+    role: string;
+    /** Provider or adapter used to launch the worker */
+    adapterId?: string;
+    /** Optional task assignment at spawn time */
+    taskId?: string;
+}
+/**
+ * Payload for onAgentComplete hook
+ * Fired when a worker finishes its assigned run
+ */
+export interface OnAgentCompletePayload extends HookPayload {
+    /** Worker or session identifier */
+    agentId: string;
+    /** Worker role / archetype name */
+    role: string;
+    /** Completion status for the run */
+    status: 'complete' | 'partial' | 'blocked' | 'failed';
+    /** Optional task assignment that was completed */
+    taskId?: string;
+    /** Optional summary or manifest reference */
+    summary?: string;
+}
+/**
+ * Payload for onCascadeStart hook
+ * Fired when autonomous execution begins flowing through a chain or wave
+ */
+export interface OnCascadeStartPayload extends HookPayload {
+    /** Identifier for the cascade / execution wave */
+    cascadeId: string;
+    /** Optional chain identifier */
+    chainId?: string;
+    /** Optional tessera template / instance identifier */
+    tesseraId?: string;
+    /** Task IDs participating in the cascade */
+    taskIds?: string[];
+}
+/**
+ * Payload for onPatrol hook
+ * Fired when a watcher performs a periodic health/sweep cycle
+ */
+export interface OnPatrolPayload extends HookPayload {
+    /** Watcher / patrol identifier */
+    watcherId: string;
+    /** Patrol category */
+    patrolType: 'health' | 'sweep' | 'refinery' | 'watcher' | 'custom';
+    /** Optional scope being patrolled */
+    scope?: string;
+}
+/**
+ * Mapping from CLEO internal lifecycle events to CAAMP hook events
+ * This is where CLEO connects its lifecycle to CAAMP's event definitions
+ */
+export declare const CLEO_TO_CAAMP_HOOK_MAP: {
+    readonly 'session.start': "onSessionStart";
+    readonly 'session.end': "onSessionEnd";
+    readonly 'task.start': "onToolStart";
+    readonly 'task.complete': "onToolComplete";
+    readonly 'file.change': "onFileChange";
+    readonly 'system.error': "onError";
+    readonly 'prompt.submit': "onPromptSubmit";
+    readonly 'response.complete': "onResponseComplete";
+};
+/**
+ * Internal CLEO lifecycle events that drive autonomous coordination.
+ */
+export declare const CLEO_INTERNAL_HOOK_MAP: {
+    readonly 'agent.work.available': "onWorkAvailable";
+    readonly 'agent.spawn': "onAgentSpawn";
+    readonly 'agent.complete': "onAgentComplete";
+    readonly 'cascade.start': "onCascadeStart";
+    readonly 'watcher.patrol': "onPatrol";
+};
+/**
+ * Type for CLEO lifecycle event names
+ * These are the internal events CLEO fires that get mapped to CAAMP events
+ */
+export type CLEOLifecycleEvent = keyof typeof CLEO_TO_CAAMP_HOOK_MAP;
+/**
+ * Type for autonomous CLEO lifecycle events.
+ */
+export type CLEOAutonomousLifecycleEvent = keyof typeof CLEO_INTERNAL_HOOK_MAP;
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Git hook management utilities.
+ *
+ * Extracted from init.ts to enable shared use across init, upgrade, and
+ * doctor/health-check workflows.
+ *
+ * Handles installation, update, and verification of managed git hooks
+ * from the package's templates/git-hooks/ directory.
+ */
+export interface ScaffoldResult {
+    action: 'created' | 'repaired' | 'skipped';
+    path: string;
+    details?: string;
+}
+export interface HookCheckResult {
+    hook: string;
+    installed: boolean;
+    current: boolean;
+    sourcePath: string;
+    installedPath: string;
+}
+export interface EnsureGitHooksOptions {
+    force?: boolean;
+}
+/** Git hooks managed by CLEO. */
+export declare const MANAGED_HOOKS: readonly ["commit-msg", "pre-commit", "pre-push"];
+export type ManagedHook = (typeof MANAGED_HOOKS)[number];
+/**
+ * Install or update managed git hooks from templates/git-hooks/ into .git/hooks/.
+ *
+ * Handles:
+ * - No .git directory (skips gracefully)
+ * - No source templates directory (skips gracefully)
+ * - Hooks already installed (skips unless force)
+ * - Sets executable permissions on installed hooks
+ */
+export declare function ensureGitHooks(projectRoot: string, opts?: EnsureGitHooksOptions): Promise<ScaffoldResult>;
+/**
+ * Verify managed hooks are installed and current.
+ *
+ * Compares installed hooks in .git/hooks/ against source templates in the
+ * package's templates/git-hooks/ directory. Returns per-hook status including
+ * whether the hook is installed and whether its content matches the source.
+ */
+export declare function checkGitHooks(projectRoot: string): Promise<HookCheckResult[]>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,iCAAiC;AACjC,eAAO,MAAM,aAAa,mDAAoD,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,qBAAqB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAyEzB;AAID;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA8CnF"}

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @cleocode/core — CLEO core business logic kernel.
+ *
+ * This is the standalone package consumers install for programmatic
+ * task management, sessions, memory, orchestration, and lifecycle.
+ *
+ * Import patterns:
+ *   // Pattern 1: Facade (recommended)
+ *   import { Cleo } from '@cleocode/core';
+ *   const cleo = await Cleo.init('./project');
+ *
+ *   // Pattern 2: Namespace access
+ *   import { tasks, sessions, memory } from '@cleocode/core';
+ *
+ *   // Pattern 3: Direct function imports (tree-shakeable)
+ *   import { addTask, startSession, observeBrain } from '@cleocode/core';
+ *
+ * @package @cleocode/core
+ */
+export * from '@cleocode/contracts';
+export * as adapters from './adapters/index.js';
+export * as admin from './admin/index.js';
+export * as adrs from './adrs/index.js';
+export * as agents from './agents/index.js';
+export * as caamp from './caamp/index.js';
+export * as codebaseMap from './codebase-map/index.js';
+export * as compliance from './compliance/index.js';
+export * as context from './context/index.js';
+export * as coreHooks from './hooks/index.js';
+export * as inject from './inject/index.js';
+export * as intelligence from './intelligence/index.js';
+export * as issue from './issue/index.js';
+export * as lifecycle from './lifecycle/index.js';
+export * as coreMcp from './mcp/index.js';
+export * as memory from './memory/index.js';
+export * as metrics from './metrics/index.js';
+export * as migration from './migration/index.js';
+export * as nexus from './nexus/index.js';
+export * as observability from './observability/index.js';
+export * as orchestration from './orchestration/index.js';
+export * as otel from './otel/index.js';
+export * as phases from './phases/index.js';
+export * as pipeline from './pipeline/index.js';
+export * as reconciliation from './reconciliation/index.js';
+export * as release from './release/index.js';
+export * as remote from './remote/index.js';
+export * as research from './research/index.js';
+export * as roadmap from './roadmap/index.js';
+export * as routing from './routing/index.js';
+export * as security from './security/index.js';
+export * as sequence from './sequence/index.js';
+export * as sessions from './sessions/index.js';
+export * as signaldock from './signaldock/index.js';
+export * as skills from './skills/index.js';
+export * as snapshot from './snapshot/index.js';
+export * as spawn from './spawn/index.js';
+export * as stats from './stats/index.js';
+export * as sticky from './sticky/index.js';
+export * as system from './system/index.js';
+export * as taskWork from './task-work/index.js';
+export * as tasks from './tasks/index.js';
+export * as templates from './templates/index.js';
+export * as ui from './ui/index.js';
+export * as validation from './validation/index.js';
+export { adrStatusSchema, agentInstanceStatusSchema, agentTypeSchema, brainConfidenceLevelSchema, brainDecisionTypeSchema, brainEdgeTypeSchema, brainImpactLevelSchema, brainLinkTypeSchema, brainMemoryTypeSchema, brainNodeTypeSchema, brainObservationSourceTypeSchema, brainObservationTypeSchema, brainOutcomeTypeSchema, brainPatternTypeSchema, brainStickyColorSchema, brainStickyPrioritySchema, brainStickyStatusSchema, externalLinkTypeSchema, gateStatusSchema, insertAgentErrorLogSchema, insertAgentInstanceSchema, insertExternalTaskLinkSchema, insertPipelineManifestSchema, insertReleaseManifestSchema, insertSessionSchema, insertTaskSchema, lifecycleEvidenceTypeSchema, lifecycleGateResultSchema, lifecyclePipelineStatusSchema, lifecycleStageNameSchema, lifecycleStageStatusSchema, lifecycleTransitionTypeSchema, manifestStatusSchema, selectAgentErrorLogSchema, selectAgentInstanceSchema, selectExternalTaskLinkSchema, selectPipelineManifestSchema, selectReleaseManifestSchema, selectSessionSchema, selectTaskSchema, sessionStatusSchema, syncDirectionSchema, taskPrioritySchema, taskRelationTypeSchema, taskSizeSchema, taskStatusSchema, taskTypeSchema, tokenUsageConfidenceSchema, tokenUsageMethodSchema, tokenUsageTransportSchema, } from './store/validation-schemas.js';
+export { createDataAccessor, getAccessor } from './store/data-accessor.js';
+export { queryAudit } from './audit.js';
+export { pruneAuditLog } from './audit-prune.js';
+export { getConfigValue, getRawConfig, getRawConfigValue, loadConfig, parseConfigValue, setConfigValue, } from './config.js';
+export { CORE_PROTECTED_FILES } from './constants.js';
+export type { EngineResult } from './engine-result.js';
+export type { ErrorDefinition } from './error-catalog.js';
+export { ERROR_CATALOG, getAllErrorDefinitions, getErrorDefinition, getErrorDefinitionByLafsCode, } from './error-catalog.js';
+export { getCleoErrorRegistry, getRegistryEntry, getRegistryEntryByLafsCode, isCleoRegisteredCode, } from './error-registry.js';
+export type { ProblemDetails } from './errors.js';
+export { CleoError } from './errors.js';
+export type { InitOptions, InitResult } from './init.js';
+export { ensureInitialized, getVersion, initProject } from './init.js';
+export { checkSchema, validateAgainstSchema } from './json-schema-validator.js';
+export type { LoggerConfig } from './logger.js';
+export { closeLogger, getLogDir, getLogger, initLogger } from './logger.js';
+export type { FormatOptions } from './output.js';
+export { formatError, formatOutput, formatSuccess, pushWarning } from './output.js';
+export { createPage, paginate } from './pagination.js';
+export { getCleoDir, getCleoDirAbsolute, getCleoHome, getConfigPath, getGlobalConfigPath, getProjectRoot, isProjectInitialized, resolveProjectPath, } from './paths.js';
+export type { Platform, SystemInfo } from './platform.js';
+export { detectPlatform, getIsoTimestamp, getSystemInfo, MINIMUM_NODE_MAJOR, PLATFORM, sha256, } from './platform.js';
+export type { ProjectInfo } from './project-info.js';
+export { getProjectInfo, getProjectInfoSync } from './project-info.js';
+export { ensureCleoStructure, ensureGlobalHome, ensureGlobalScaffold, ensureSqliteDb, fileExists, getCleoVersion, getPackageRoot, } from './scaffold.js';
+export { AdapterManager } from './adapters/index.js';
+export type { AdminAPI, CleoInitOptions, LifecycleAPI, MemoryAPI, NexusAPI, OrchestrationAPI, ReleaseAPI, SessionsAPI, StickyAPI, SyncAPI, TasksAPI, } from './cleo.js';
+export { Cleo } from './cleo.js';
+export { HookRegistry, hooks } from './hooks/registry.js';
+export { fetchBrainEntries, observeBrain, searchBrainCompact, timelineBrain, } from './memory/brain-retrieval.js';
+export { searchBrain } from './memory/brain-search.js';
+export { compareSemver, detectVersion, getMigrationStatus, runAllMigrations, runMigration, } from './migration/index.js';
+export { reconcile } from './reconciliation/index.js';
+export { endSession, listSessions, resumeSession, sessionStatus, startSession, } from './sessions/index.js';
+export { getMigrationStatus as getSystemMigrationStatus } from './system/migrate.js';
+export { checkStorageMigration } from './system/storage-preflight.js';
+export { currentTask, startTask, stopTask } from './task-work/index.js';
+export { addTask } from './tasks/add.js';
+export { archiveTasks } from './tasks/archive.js';
+export { completeTask } from './tasks/complete.js';
+export { deleteTask } from './tasks/delete.js';
+export { findTasks } from './tasks/find.js';
+export { normalizeTaskId } from './tasks/id-generator.js';
+export { listTasks } from './tasks/list.js';
+export { showTask } from './tasks/show.js';
+export { updateTask } from './tasks/update.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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