Skip to main content
API reference for the core package.

Functions & Classes

SymbolKindDescription
initLogger()functionInitialize the root logger. Call once at startup. Uses pino-roll for automat…
getLogger()functionGet a child logger bound to a subsystem name. Safe to call before initLogger…
getLogDir()functionGet the current log directory path. Useful for read APIs that need to scan lo…
closeLogger()functionFlush and close the logger. Call during graceful shutdown. Returns a Promise…
getPlatformPaths()functionGet OS-appropriate paths for CLEO’s global directories. Cached after first ca…
getSystemInfo()functionGet a cached system information snapshot. Captured once and reused for the pr…
_resetPlatformPathsCache()functionInvalidate the path and system info caches. Use in tests after mutating CLEO_…
isProjectInitialized()functionCheck if a CLEO project is initialized at the given root. Checks for tasks.db.
getCleoHome()functionGet the global CLEO home directory. Respects CLEO_HOME env var; otherwise use…
getCleoTemplatesDir()functionGet the global CLEO templates directory.
getCleoSchemasDir()functionGet the global CLEO schemas directory.
getCleoDocsDir()functionGet the global CLEO docs directory.
getCleoDir()functionGet the project CLEO data directory (relative). Respects CLEO_DIR env var, de…
getCleoDirAbsolute()functionGet the absolute path to the project CLEO directory.
getProjectRoot()functionGet the project root from the CLEO directory. Respects CLEO_ROOT env var, the…
resolveProjectPath()functionResolve a project-relative path to an absolute path.
getTaskPath()functionGet the path to the project’s tasks.db file (SQLite database).
getConfigPath()functionGet the path to the project’s config.json file.
getSessionsPath()functionGet the path to the project’s sessions.json file.
getArchivePath()functionGet the path to the project’s archive file.
getLogPath()functionGet the path to the project’s log file. Canonical structured runtime log path…
getBackupDir()functionGet the backup directory for operational backups.
getGlobalConfigPath()functionGet the global config file path.
getCleoGlobalRecipesDir()functionGet the Global Justfile Hub directory. The hub stores cross-project recipe l…
getCleoGlobalJustfilePath()functionGet the absolute path to the primary global justfile.
getCleoPiExtensionsDir()functionGet the Global Pi Extensions Hub directory. Houses the Pi extensions that dr…
getCleoCantWorkflowsDir()functionGet the Global CANT Workflows Hub directory. Stores compiled and parsed…
getCleoGlobalAgentsDir()functionGet the Global CLEO Agents directory. Holds globally-available CANT agent de…
getAgentOutputsDir()functionGet the agent outputs directory (relative path) from config or default. Conf…
getAgentOutputsAbsolute()functionGet the absolute path to the agent outputs directory.
getManifestPath()functionGet the absolute path to the legacy agent-outputs flat-file (deprecated per ADR-027). Checks config.agentOutputs…
getManifestArchivePath()functionGet the absolute path to the MANIFEST.archive.jsonl file.
isAbsolutePath()functionCheck if a path is absolute (POSIX or Windows).
getCleoLogDir()functionGet the OS log directory for CLEO global logs. Linux: ~/.local/state/cleo | m…
getCleoCacheDir()functionGet the OS cache directory for CLEO. Linux: ~/.cache/cleo | macOS: ~/Library/…
getCleoTempDir()functionGet the OS temp directory for CLEO ephemeral files.
getCleoConfigDir()functionGet the OS config directory for CLEO. Linux: ~/.config/cleo | macOS: ~/Librar…
getCleoTemplatesTildePath()functionGet the CLEO templates directory as a tilde-prefixed path for use in @ refe…
getAgentsHome()functionGet the global agents hub directory. Respects AGENTS_HOME env var, defaults t…
getClaudeAgentsDir()functionGet the Claude Code agents directory (~/.claude/agents by default).
getClaudeMemDbPath()functionGet the claude-mem SQLite database path.
tableExists()functionCheck whether a table exists in a SQLite database.
isSqliteBusy()functionCheck if an error is a SQLite BUSY error (database locked by another process)…
createSafetyBackup()functionCreate a pre-migration safety backup of the database file. Only creates the…
reconcileJournal()functionBootstrap and reconcile the Drizzle migration journal. Handles three scenari…
migrateWithRetry()function
ensureColumns()functionEnsure all required columns exist on a table. Uses PRAGMA table_info to insp…
vacuumIntoBackup()functionCreate a VACUUM INTO snapshot of the SQLite database. Debounced by default (…
listSqliteBackups()functionList existing SQLite backup snapshots, newest first.
getBrainDbPath()functionGet the path to the brain.db SQLite database file.
resolveBrainMigrationsFolder()functionResolve the path to the drizzle-brain migrations folder. Works from both src/…
isBrainVecLoaded()functionCheck whether the sqlite-vec extension is loaded for the current brain.db.
getBrainDb()functionInitialize the brain.db SQLite database (lazy, singleton). Creates the databa…
closeBrainDb()functionClose the brain.db database connection and release resources.
resetBrainDbState()functionReset brain.db singleton state without saving. Used during tests or when data…
getBrainNativeDb()functionGet the underlying node:sqlite DatabaseSync instance for brain.db. Useful for…
getNexusDbPath()functionGet the path to the nexus.db SQLite database file. nexus.db lives in the glob…
resolveNexusMigrationsFolder()functionResolve the path to the drizzle-nexus migrations folder. Works from both src/…
getNexusDb()functionInitialize the nexus.db SQLite database (lazy, singleton). Creates the databa…
closeNexusDb()functionClose the nexus.db database connection and release resources.
resetNexusDbState()functionReset nexus.db singleton state without saving. Used during tests or when data…
getNexusNativeDb()functionGet the underlying node:sqlite DatabaseSync instance for nexus.db. Useful for…
openNativeDatabase()functionOpen a node:sqlite DatabaseSync with CLEO standard pragmas. CRITICAL: WAL mo…
getDbPath()functionGet the path to the SQLite database file.
getDb()functionInitialize the SQLite database (lazy, singleton). Creates the database file a…
resolveMigrationsFolder()functionResolve the path to the drizzle migrations folder. Works from both src/ (dev…
closeDb()functionClose the database connection and release resources.
resetDbState()functionReset database singleton state without saving. Used during migrations when da…
getSchemaVersion()functionGet the schema version from the database.
dbExists()functionCheck if the database file exists.
getNativeDb()functionGet the underlying node:sqlite DatabaseSync instance. Useful for direct PRAGM…
getNativeTasksDb()functionGet the underlying node:sqlite DatabaseSync instance for tasks.db. Alias for…
closeAllDatabases()functionClose ALL database singletons (tasks.db, brain.db, nexus.db). Must be called…
safeParseJson()functionParse a JSON string, returning undefined on null/undefined input or parse error.
safeParseJsonArray()functionParse a JSON string expected to contain an array. Returns undefined for null/…
rowToTask()functionConvert a database TaskRow to a domain Task object.
taskToRow()functionConvert a domain Task to a database row for insert/upsert.
archivedTaskToRow()functionConvert a domain Task to a row suitable for archived tasks.
rowToSession()functionConvert a SessionRow to a domain Session.
getSignaldockDbPath()functionGet the path to the signaldock.db SQLite database file.
ensureSignaldockDb()functionEnsure signaldock.db exists and has the full schema applied. Idempotent — sa…
checkSignaldockDbHealth()functionCheck signaldock.db health — table count, WAL mode, schema version. Used by…
cleanupBrainRefsOnTaskDelete()functionClean up brain.db references after a task is deleted from tasks.db. Handles:…
cleanupBrainRefsOnSessionDelete()functionClean up brain.db references after a session is deleted from tasks.db. Handl…
taskExistsInTasksDb()functionVerify a task ID exists in tasks.db before writing a cross-DB reference to br…
reconcileOrphanedRefs()functionReconcile orphaned cross-DB references in brain.db. Scans brain.db for refer…
sessionExistsInTasksDb()function
agentExistsInSignaldockDb()functionVerify an agent exists in signaldock.db before creating cross-DB references…
getErrorDefinition()functionLook up an error definition by exit code.
getErrorDefinitionByLafsCode()functionLook up an error definition by LAFS string code.
getAllErrorDefinitions()functionGet all error definitions as an array.
CleoErrorclassStructured error class for CLEO operations. Carries an exit code, human-reada…
upsertTask()functionUpsert a single task row into the tasks table. Handles both active task upser…
upsertSession()functionUpsert a single session row into the sessions table.
updateDependencies()functionUpdate dependencies for a task: delete existing, then re-insert. Optionally f…
batchUpdateDependencies()functionBatch-update dependencies for multiple tasks in two bulk SQL operations. Repl…
loadDependenciesForTasks()functionBatch-load dependencies for a list of tasks and apply them in-place. Uses inA…
loadRelationsForTasks()functionBatch-load relations for a list of tasks and apply them in-place. Mirrors loa…
generateAgentId()functionGenerate a unique agent instance ID. Format: agt_{YYYYMMDDHHmmss}_{6hex}
registerAgent()functionRegister a new agent instance in the database. Sets initial status to ‘starti…
deregisterAgent()functionDeregister (stop) an agent instance. Sets status to ‘stopped’ and records the…
heartbeat()functionRecord a heartbeat for an agent instance. Updates last_heartbeat and return…
updateAgentStatus()functionUpdate agent status with optional error tracking. When status is ‘error’ or ’…
incrementTasksCompleted()functionIncrement the completed task count for an agent.
listAgentInstances()functionList agent instances with optional filters.
getAgentInstance()functionGet a single agent instance by ID.
classifyError()functionClassify an error as retriable, permanent, or unknown. Retriable errors are…
getAgentErrorHistory()functionGet the error history for a specific agent.
checkAgentHealth()functionCheck agent health by finding instances whose last heartbeat exceeds the thre…
markCrashed()functionMark an agent instance as crashed. Increments error count and sets status to…
getHealthReport()functionGenerate a health report summarizing all agent instances. Includes counts by…
setMetaValue()functionWrite a JSON blob to the schema_meta table by key.
createSqliteDataAccessor()functionCreate a SQLite-backed DataAccessor. Opens (or creates) the SQLite database…
atomicWrite()functionWrite data to a file atomically. Creates parent directories if they don’t exi…
safeReadFile()functionRead a file and return its contents. Returns null if the file does not exist.
atomicWriteJson()functionWrite JSON data atomically with consistent formatting.
atomicDatabaseMigration()functionPerform atomic database migration using rename operations. Pattern: 1. Wri…
restoreDatabaseFromBackup()functionRestore database from backup after failed migration.
cleanupMigrationArtifacts()functionClean up migration artifacts after successful migration.
validateSqliteDatabase()functionValidate SQLite database integrity by attempting to open it.
createBackup()functionCreate a numbered backup of a file. Rotates existing backups (file.1 - file.2…
listBackups()functionList existing backups for a file, sorted by number (newest first).
restoreFromBackup()functionRestore a file from its most recent backup. Returns the path of the backup th…
acquireLock()functionAcquire an exclusive lock on a file. Returns a release function that must be…
isLocked()functionCheck if a file is currently locked.
withLock()functionExecute a function while holding an exclusive lock on a file. The lock is aut…
isProviderHookEvent()functionType guard for CAAMP/provider-discoverable canonical hook events.
isInternalHookEvent()functionType guard for CLEO-local coordination hook events.
HookRegistryclassCentral registry for hook handlers. Manages registration, priority-based ord…
readJson()functionRead and parse a JSON file. Returns null if the file does not exist.
readJsonRequired()functionRead a JSON file, throwing if it doesn’t exist.
computeChecksum()functionCompute a truncated SHA-256 checksum of a value. Used for integrity verificat…
saveJson()functionSave JSON data with optional locking, backup, and validation. Follows the CLE…
appendJsonl()functionAppend a line to a JSONL file atomically. Used for manifest entries and audit…
readLogEntries()functionRead log entries from a hybrid JSON/JSONL file. Handles three formats: 1. P…
makeCleoGitEnv()functionBuild environment variables that point git at the isolated .cleo/.git repo…
cleoGitCommand()functionRun a git command against the isolated .cleo/.git repo, suppressing errors…
isCleoGitInitialized()functionCheck whether the isolated .cleo/.git repo has been initialized. T4872
loadStateFileAllowlist()functionLoad additional state file paths from config.json…
loadCheckpointConfig()functionLoad checkpoint configuration from config.json. T4552
shouldCheckpoint()functionCheck whether a checkpoint should be performed. Evaluates: enabled, .cleo/.gi…
gitCheckpoint()functionStage .cleo/ state files and commit to the isolated .cleo/.git repo. Never fa…
gitCheckpointStatus()functionShow checkpoint configuration and status. T4552 T4872
gitCheckpointDryRun()functionShow what files would be committed (dry-run). T4552 T4872
DataSafetyErrorclassSafety violation error
getSafetyStats()functionGet current safety statistics
resetSafetyStats()functionReset safety statistics (for testing)
safeSaveSessions()functionSafe wrapper for DataAccessor.saveSessions()
safeSaveArchive()functionSafe wrapper for DataAccessor.saveArchive()
safeSingleTaskWrite()functionSafe wrapper for single-task write operations (T5034). Performs: 1. Sequence…
safeAppendLog()functionSafe wrapper for DataAccessor.appendLog() Note: Log appends are fire-and-for…
runDataIntegrityCheck()functionRun comprehensive data integrity check. Validates all data files and sequence…
forceSafetyCheckpoint()functionForce immediate checkpoint. Use before destructive operations.
disableSafety()functionDisable all safety for current process. DANGEROUS - only use for recovery ope…
enableSafety()functionRe-enable safety after being disabled.
SafetyDataAccessorclassSafety-enabled DataAccessor wrapper. Wraps any DataAccessor implementation a…
wrapWithSafety()functionWrap a DataAccessor with safety. This is the internal factory helper that wr…
isSafetyEnabled()functionCheck if safety is currently enabled.
getSafetyStatus()functionGet safety status information.
createDataAccessor()functionCreate a DataAccessor for the given working directory. Always creates a SQLit…
getAccessor()functionConvenience: get a DataAccessor with auto-detected engine.
showSequence()functionShow current sequence state.
checkSequence()functionCheck sequence integrity.
repairSequence()functionRepair sequence if behind.
allocateNextTaskId()functionAtomically allocate the next task ID via SQLite. Uses BEGIN IMMEDIATE to gua…
SafetyErrorclassSafety violation error.
checkTaskExists()functionCheck if a task ID already exists (collision detection).
verifyTaskWrite()functionVerify a task was actually written to the database.
validateAndRepairSequence()functionValidate and repair sequence if necessary.
triggerCheckpoint()functionTrigger auto-checkpoint after successful write.
safeCreateTask()functionSafely create a task with all safety mechanisms. Wraps the actual createTask…
safeUpdateTask()functionSafely update a task with all safety mechanisms.
safeDeleteTask()functionSafely delete a task with all safety mechanisms.
verifySessionWrite()functionVerify session write.
safeCreateSession()functionSafely create a session with all safety mechanisms.
forceCheckpointBeforeOperation()functionForce a checkpoint before destructive operations. Use this before migrations,…
runDataIntegrityCheck()functionRun comprehensive data integrity check. Reports all issues found.
getTask()functionGet a task by ID, including its dependencies.
updateTask()functionUpdate an existing task.
deleteTask()functionDelete a task by ID.
listTasks()functionList tasks with optional filters.
findTasks()functionFind tasks by fuzzy text search.
archiveTask()functionArchive a task (sets status to ‘archived’ with metadata).
addDependency()functionAdd a dependency between tasks.
removeDependency()functionRemove a dependency.
addRelation()functionAdd a relation between tasks.
getRelations()functionGet relations for a task.
getBlockerChain()functionGet the dependency chain (blockers) for a task using recursive CTE.
getChildren()functionGet children of a task (hierarchy).
getSubtree()functionBuild a tree from a root task using recursive CTE.
countByStatus()functionCount tasks by status.
countTasks()functionGet total task count (excluding archived).
createTask()functionCreate a task with full safety protections. Includes: collision detection, wr…
updateTaskSafe()functionUpdate a task with full safety protections. Includes: write verification, aut…
deleteTaskSafe()functionDelete a task with full safety protections. Includes: delete verification, au…
taskShowNext()functionBuild _next directives for a full task detail result (tasks.show).
taskListItemNext()functionBuild _next directives for a task in a list or find result.
sessionListItemNext()functionBuild _next directives for a session in a list or find result.
sessionStartNext()functionBuild _next directives for a session start result.
memoryFindHitNext()functionBuild _next directives for a memory search (find) hit.
showTask()functionGet a task by ID with enriched details. Checks active tasks first, then archi…
createPage()functionCreate an LAFSPage object from pagination parameters. Returns mode:“none” wh…
paginate()functionApply pagination to an array of items and return the sliced result with page…
toCompact()functionConvert a full Task to compact representation with _next directives.
listTasks()functionList tasks with optional filtering and pagination. T4460
fuzzyScore()functionCalculate fuzzy match score between query and text. Higher score = better mat…
findTasks()functionSearch tasks by fuzzy matching, ID prefix, or exact title. Returns minimal fi…
extractAdrId()functionExtract ADR ID from filename (e.g., ‘ADR-007-domain-consolidation.md’ - ‘ADR-…
parseFrontmatter()functionParse bold-key frontmatter pattern: Key: value
extractTitle()functionExtract H1 title from markdown
parseAdrFile()functionParse a single ADR markdown file into an AdrRecord
linkPipelineAdr()functionLink ADRs to a pipeline task when the architecture_decision stage completes.
syncAdrsToDb()functionSync all ADR markdown files into the architecture_decisions table AND regener…
recordEvidence()functionRecord an evidence artifact linked to a lifecycle stage. Writes to the SQLit…
getEvidence()functionQuery evidence records for an epic, optionally filtered by stage.
linkProvenance()functionConvenience wrapper to record a file as provenance evidence. Converts the fi…
getEvidenceSummary()functionAggregate evidence counts per stage for an epic.
normalizeEpicId()functionStrip suffixes from epic directory names. E.g. T4881_install-channels -…
getRcasdBaseDir()functionGet the absolute path to the .cleo/rcasd/ base directory.
getEpicDir()functionGet the absolute path to .cleo/rcasd/{epicId}/. Uses the normalized epic ID…
findEpicDir()functionSearch both rcasd/ and legacy rcsd/ for an existing epic directory. Also…
getStagePath()functionGet the stage subdirectory path for an epic. Uses STAGE_SUBDIRS mapping, fall…
ensureStagePath()functionGet the stage subdirectory path, creating it if it does not exist.
getManifestPath()functionGet the manifest path for an epic under the default rcasd directory.
findManifestPath()functionSearch both rcasd/ and rcsd/ for an existing manifest file. Checks suffix…
getLooseResearchFiles()functionScan the rcasd root directory for loose T####_*.md files that are not insid…
listEpicDirs()functionList all epic directories across rcasd/ and rcsd/.
parseFrontmatter()functionParse YAML frontmatter from a markdown string. Finds the YAML block delimite…
serializeFrontmatter()functionConvert a FrontmatterMetadata object to a YAML frontmatter string. Output fo…
addFrontmatter()functionAdd or replace YAML frontmatter in markdown content. If the content already…
buildFrontmatter()functionConvenience builder for common frontmatter patterns. Auto-sets updated to…
getBacklinks()functionScan all markdown files in .cleo/rcasd/ for files that reference the given…
getStageOrder()functionGet the order/index of a stage (1-based).
isStageBefore()functionCheck if stage A comes before stage B in the pipeline.
isStageAfter()functionCheck if stage A comes after stage B in the pipeline.
getNextStage()functionGet the next stage in the pipeline.
getPreviousStage()functionGet the previous stage in the pipeline.
getStagesBetween()functionGet all stages between two stages (inclusive).
getPrerequisites()functionGet prerequisites for a stage.
isPrerequisite()functionCheck if one stage is a prerequisite of another.
getDependents()functionGet all stages that depend on a given stage.
isValidStage()functionCheck if a stage name is valid.
validateStage()functionValidate a stage name and throw if invalid.
isValidStageStatus()functionCheck if a stage status is valid.
getStagesByCategory()functionGet stages by category.
getSkippableStages()functionGet skippable stages.
checkTransition()functionCheck if a transition is allowed.
ensureStageArtifact()functionEnsure stage artifact exists and frontmatter/backlinks are up to date.
getSkillSearchPaths()functionBuild the CAAMP skill search paths in priority order. Uses CAAMP’s canonical…
getSkillsDir()functionGet the primary skills directory (app-embedded). T4516
getSharedDir()functionGet the shared skills resources directory. T4516
mapSkillName()functionMap a user-friendly skill name to the canonical ct-prefixed directory name. S…
listCanonicalSkillNames()functionList all known canonical skill names (unique values from the map). T4516
parseFrontmatter()functionParse YAML-like frontmatter from a SKILL.md file. Handles the --- delimited h…
discoverSkill()functionDiscover a single skill from a directory. Tries CAAMP’s parseSkillFile first,…
discoverSkillsInDir()functionDiscover all skills in a single directory. Scans for subdirectories containin…
discoverAllSkills()functionDiscover all skills across CAAMP search paths. Returns skills in priority ord…
findSkill()functionFind a specific skill by name across all search paths. T4516
toSkillSummary()functionConvert a Skill to a lightweight SkillSummary. T4516
generateManifest()functionGenerate a skill manifest from discovered skills. T4516
resolveTemplatePath()functionResolve a skill template path (SKILL.md) by name. T4516
loadPlaceholders()functionLoad token definitions from placeholders.json. T4521
buildDefaults()functionBuild the full default values map (merging placeholders.json with hardcoded d…
validateTokenValue()functionValidate a single token value against its pattern. T4521
validateRequired()functionValidate all required tokens are present and valid. T4521
validateAllTokens()functionValidate all tokens in a values map (required + optional). T4521
injectTokens()functionInject token values into a template string. Replaces all TOKEN_NAME patterns…
hasUnresolvedTokens()functionCheck if a template has unresolved tokens after injection. T4521
loadAndInject()functionLoad a skill template and inject tokens. T4521
setFullContext()functionBuild a complete TokenValues map from a task, resolving all standard tokens…
autoDispatch()functionAuto-dispatch a task to the most appropriate skill. Tries strategies in prior…
dispatchExplicit()functionDispatch with explicit skill override. Verifies the skill exists before retur…
getProtocolForDispatch()functionGet the protocol type for a dispatch result. T4517
prepareSpawnContext()functionPrepare spawn context for a dispatched skill. Returns the skill name and prot…
prepareSpawnMulti()functionCompose multiple skills into a single prompt with progressive disclosure. Por…
buildStageGuidance()functionBuild structured stage guidance for a given pipeline stage. Resolves the pri…
formatStageGuidance()functionFormat stage guidance as a Markdown-wrapped system prompt. Since…
renderStageGuidance()functionConvenience wrapper: build AND format in a single call.
getLifecycleState()functionGet the current lifecycle state for an epic. T4467
startStage()functionStart a lifecycle stage. T4467
completeStage()functionComplete a lifecycle stage. T4467
skipStage()functionSkip a lifecycle stage. T4467
checkGate()functionCheck lifecycle gate before starting a stage. T4467
getLifecycleStatus()functionGet lifecycle status for an epic from SQLite. Returns stage progress, current…
getLifecycleHistory()functionGet lifecycle history for an epic. Returns stage transitions and gate events…
getLifecycleGates()functionGet all gate statuses for an epic. T4785
getStagePrerequisites()functionGet prerequisites for a target stage. Pure data function, no I/O. T4785
checkStagePrerequisites()functionCheck if a stage’s prerequisites are met for an epic. T4785
recordStageProgress()functionRecord a stage status transition (progress/record). SQLite-native implementat…
skipStageWithReason()functionSkip a stage with a reason (engine-compatible). T4785
resetStage()functionReset a stage to pending (emergency). T4785
passGate()functionMark a gate as passed. SQLite-native implementation - T4801 T4785 T4801
failGate()functionMark a gate as failed. SQLite-native implementation - T4801 T4785 T4801
listEpicsWithLifecycle()functionList all epic IDs that have lifecycle data. T4785
getCurrentSessionId()functionGet the current session ID.
getContextStatePath()functionGet context state file path for a session.
readContextState()functionRead context state for a session. Returns null if stale or missing.
getThresholdLevel()functionDetermine the threshold level for a given percentage.
shouldAlert()functionDetermine if we should alert based on threshold crossing. Returns the alert l…
getRecommendedAction()functionGet recommended action for an alert level.
checkContextAlert()functionMain function to check and determine if an alert should fire. Non-blocking -…
pushWarning()functionPush a deprecation or informational warning into the current envelope. Warnin…
formatSuccess()functionFormat a successful result as a full LAFS-conformant envelope. Always produc…
formatError()functionFormat an error as a full LAFS-conformant envelope. Always produces the full…
formatOutput()functionFormat any result (success or error) as LAFS JSON.
getRegistryEntry()functionLook up a registry entry by CLEO exit code. T4671 T4663
getRegistryEntryByLafsCode()functionLook up a registry entry by LAFS string code. T4671 T4663
getCleoErrorRegistry()functionGet the full CLEO error registry for conformance testing. T4671 T4663
isCleoRegisteredCode()functionCheck if a LAFS code is registered in the CLEO error registry. T4671 T4663
createTestDb()functionCreate a temporary directory with an initialized tasks.db. Usage:
makeTasks()functionBuild full Task objects from a list of task partials. Useful for seeding test…
seedTasks()functionSeed tasks into the test database via the accessor. Uses a two-pass approach…
getChildren()functionGet direct children of a task.
getChildIds()functionGet direct child IDs.
getDescendants()functionGet all descendants of a task (recursive).
getDescendantIds()functionGet all descendant IDs (flat list).
getParentChain()functionGet the parent chain (ancestors) from a task up to the root. Returns ordered…
getParentChainIds()functionGet the parent chain as IDs.
getDepth()functionCalculate depth of a task in the hierarchy (0-based). Root tasks have depth 0…
getRootAncestor()functionGet the root ancestor of a task.
isAncestorOf()functionCheck if a task is an ancestor of another.
isDescendantOf()functionCheck if a task is a descendant of another.
getSiblings()functionGet sibling tasks (same parent).
validateHierarchy()function
wouldCreateCircle()functionDetect circular reference if parentId were set.
buildTree()function
flattenTree()functionFlatten a tree back to a list (depth-first).
resolveHierarchyPolicy()functionResolve a full HierarchyPolicy from config, starting with a profile preset an…
assertParentExists()functionAssert that a parent task exists in the task list. Returns an error result if…
assertNoCycle()functionAssert that re-parenting would not create a cycle. Returns an error result if…
countActiveChildren()functionCount active (non-done, non-cancelled, non-archived) children of a parent.
validateHierarchyPlacement()functionValidate whether a new task can be placed under the given parent according to…
loadConfig()functionLoad and merge configuration from all sources. Priority: defaults global con…
getConfigValue()functionGet a single config value with source tracking. Returns the value and which s…
getRawConfigValue()functionGet a raw config value from the project config file only (no cascade). Return…
getRawConfig()functionGet the full raw project config (no cascade). Returns null if no config file…
parseConfigValue()functionParse a string value into its appropriate JS type. Handles booleans, null, in…
setConfigValue()functionSet a config value in the project or global config file (dot-notation support…
applyStrictnessPreset()functionApply a strictness preset to the project (or global) config. Merges preset va…
listStrictnessPresets()functionList all available presets with their descriptions and values. Used by the CL…
isMissingBrainSchemaError()functionReturn true when the error is the “no such table: brain_*” SQLite error throw…
isAutoCaptureEnabled()functionReturn true when brain.autoCapture is enabled for the given project. Resol…
recordDecision()functionRecord a decision to the audit trail. Appends a JSON line to…
getDecisionLog()functionRead the decision log, optionally filtered by sessionId and/or taskId.
computeHandoff()functionCompute handoff data for a session. Gathers all session statistics and auto-c…
persistHandoff()functionPersist handoff data to a session.
getHandoff()functionGet handoff data for a session.
getLastHandoff()functionGet handoff data for the most recent ended session. Filters by scope if provi…
computeDebrief()functionCompute rich debrief data for a session. Builds on computeHandoff() and adds…
BrainDataAccessorclass
getBrainAccessor()functionFactory: get a BrainDataAccessor backed by the brain.db singleton.
typedAll()functionType-safe wrapper for StatementSync.all — centralizes the as unknown as c…
typedGet()functionType-safe wrapper for StatementSync.get — centralizes the as unknown as c…
LocalEmbeddingProviderclassLocal embedding provider backed by xenova/transformers. Produces 384-dimensi…
getLocalEmbeddingProvider()functionGet or create the shared LocalEmbeddingProvider singleton.
setEmbeddingProvider()functionRegister an embedding provider for the brain system. Validates that the provi…
getEmbeddingProvider()functionGet the currently registered embedding provider, or null.
clearEmbeddingProvider()functionClear the current embedding provider (useful for testing).
embedText()functionEmbed text into a float vector using the registered provider. Returns null wh…
isEmbeddingAvailable()functionCheck whether embedding is currently available.
initDefaultProvider()functionInitialize the default local embedding provider. Loads the LocalEmbeddingPro…
searchSimilar()functionSearch for entries similar to a query string using vector similarity. 1. Emb…
ensureFts5Tables()functionCreate FTS5 virtual tables and content-sync triggers if they don’t exist. Us…
rebuildFts5Index()functionRebuild FTS5 indexes from the content tables. Useful after bulk inserts that…
searchBrain()functionUnified search across all BRAIN memory tables. Uses FTS5 MATCH for full-text…
resetFts5Cache()functionReset the cached FTS5 availability flag. Used in tests to force re-detection.
hybridSearch()functionHybrid search across FTS5, vector similarity, and graph neighbors. 1. Runs F…
generateMemoryBridgeContent()functionGenerate memory bridge content from brain.db. Returns the markdown string (do…
writeMemoryBridge()functionWrite memory bridge content to .cleo/memory-bridge.md.
refreshMemoryBridge()functionBest-effort refresh: call from session.end, tasks.complete, or memory.observe…
generateContextAwareContent()functionGenerate context-aware memory bridge content and write to disk. When…
maybeRefreshMemoryBridge()functionRefresh the memory bridge if autoRefresh is enabled and the debounce window h…
searchBrainCompact()functionToken-efficient compact search across BRAIN tables. Returns index-level hits…
timelineBrain()functionGet chronological context around an anchor entry. Fetches the anchor’s full d…
fetchBrainEntries()functionBatch-fetch full details by IDs. Groups IDs by prefix to query the correct ta…
observeBrain()functionSave an observation to the BRAIN observations table. Replaces the external cl…
populateEmbeddings()functionBackfill embeddings for existing observations that lack them. Iterates throu…
queryAudit()functionQuery audit entries from SQLite audit_log table. Used by session-grade.ts for…
storeLearning()functionStore a new learning. T4769, T5241
searchLearnings()functionSearch learnings by criteria. Results sorted by confidence (highest first)…
learningStats()functionGet learning statistics. T4769, T5241
gradeSession()functionGrade a session by sessionId using the 5-dimension behavioral rubric.
readGrades()functionRead past grade results from .cleo/metrics/GRADES.jsonl
isValidAdapter()functionValidate that a loaded module export implements the CLEOProviderAdapter inter…
loadAdapterFromManifest()functionDynamically load and instantiate an adapter from its manifest. Uses the mani…
discoverAdapterManifests()functionScan the packages/adapters/ directory for adapter packages. Each adapter must…
detectProvider()functionDetect whether a provider is active in the current environment by checking it…
AdapterManagerclassCentral adapter manager. Singleton per process. Lifecycle: 1. discover() —…
bridgeSessionToMemory()functionBridge session end data to brain.db as an observation. Builds a summary text…
storeDecision()functionStore a new decision or update an existing one if a duplicate is found. Dupli…
recallDecision()functionRecall a specific decision by ID. T5155
searchDecisions()functionSearch decisions by type, confidence, outcome, and/or free-text query. Query…
listDecisions()functionList decisions with pagination. T5155
updateDecisionOutcome()functionUpdate the outcome of a decision after learning from results. T5155
storePattern()functionStore a new pattern. If a similar pattern already exists (same type + matchin…
searchPatterns()functionSearch patterns by criteria. T4768, T5241
patternStats()functionGet pattern statistics. T4768, T5241
extractTaskCompletionMemory()functionExtract and store memory entries when a task is completed. - Always stores a…
extractSessionEndMemory()functionExtract and store memory entries when a session ends. - Stores a process dec…
resolveTaskDetails()functionResolve an array of task IDs to their full Task objects. Tasks that cannot be…
extractFromTranscript()functionExtract key observations from a provider session transcript and store them in…
handleSessionStart()functionHandle SessionStart - capture initial session context T138: Refresh memory b…
handleSessionEnd()functionHandle SessionEnd - capture session summary T138: Refresh memory bridge afte…
handleToolStart()functionHandle PreToolUse (maps to task.start in CLEO, canonical: was onToolStart)
handleToolComplete()functionHandle PostToolUse (maps to task.complete in CLEO, canonical: was onToolCompl…
handleError()functionHandle PostToolUseFailure — capture operation errors to BRAIN. Includes an i…
handleFileChange()functionHandle Notification (file-change variant) - capture file changes to BRAIN Ga…
handleSystemNotification()functionHandle Notification — capture system notifications as BRAIN observations. On…
handleWorkPromptSubmit()functionHandle PromptSubmit — log incoming mutation intents to BRAIN. Only fires for…
handleWorkResponseComplete()functionHandle ResponseComplete — capture completed mutations to BRAIN. Only fires f…
handleSubagentStart()functionHandle SubagentStart — log subagent spawn as a BRAIN observation. Records th…
handleSubagentStop()functionHandle SubagentStop — log subagent completion result as a BRAIN observation…
handlePreCompact()functionHandle PreCompact — snapshot current session memory context to BRAIN. Fires…
handlePostCompact()functionHandle PostCompact — record compaction completion to BRAIN. Fires immediatel…
recordAssumption()functionRecord an assumption made during a session. Appends to .cleo/audit/assumption…
linkMemoryToTask()functionLink a memory entry to a task. T5156
unlinkMemoryFromTask()functionRemove a link between a memory entry and a task. T5156
getTaskLinks()functionGet all memory entries linked to a specific task. T5156
getMemoryLinks()functionGet all tasks linked to a specific memory entry. T5156
bulkLink()functionBatch create multiple links at once. T5156
getLinkedDecisions()functionGet all decisions linked to a task. Convenience method that fetches full deci…
getLinkedPatterns()functionGet all patterns linked to a task. Convenience method that fetches full patte…
getLinkedLearnings()functionGet all learnings linked to a task. Convenience method that fetches full lear…
extractMemoryItems()functionExtract memory-worthy items from debrief data. Pure function — no side effec…
persistSessionMemory()functionMain entry point — called from session.end handler. Extracts memory-worthy c…
buildSummarizationPrompt()functionBuild a summarization prompt from debrief data. Returns a formatted prompt s…
ingestStructuredSummary()functionIngest a structured session summary directly into brain.db. Stores each fiel…
getSessionMemoryContext()functionRetrieve session memory for a given scope. Used by briefing/handoff to enrich…
depsReady()functionCheck if all dependencies of a task are satisfied.
initializePipeline()functionInitialize a new pipeline for a task. Creates a new pipeline record in the d…
getPipeline()functionRetrieve a pipeline by task ID. Returns the complete pipeline state includin…
advanceStage()functionAdvance a pipeline to the next stage. Performs atomic stage transition with…
getCurrentStage()functionGet the current stage of a pipeline. Convenience method to quickly check whi…
listPipelines()functionList pipelines with optional filtering.
completePipeline()functionComplete a pipeline (mark all stages done). Marks the pipeline as completed…
cancelPipeline()functionCancel a pipeline before completion. Marks the pipeline as cancelled (user-i…
pipelineExists()functionCheck if a pipeline exists for a task.
getPipelineStatistics()functionGet pipeline statistics. Returns aggregate counts of pipelines by status and…
getPipelineStages()functionGet all stages for a pipeline.
computeBriefing()functionCompute the complete session briefing. Aggregates data from all 6+ sources.
findSessions()functionFind sessions with minimal field projection. Loads all sessions, applies fil…
archiveSessions()functionArchive old/ended sessions. Identifies ended and suspended sessions older tha…
cleanupSessions()functionRemove orphaned sessions, auto-end stale active sessions, and clean up stale…
getContextDrift()functionCompute context drift score for the current session. Compares session progres…
getSessionHistory()functionList session history with focus changes and completed tasks. If sessionId is…
showSession()functionShow a specific session. Looks in active sessions first, then session history…
getSessionStats()functionCompute session statistics, optionally for a specific session. Throws CleoErr…
suspendSession()functionSuspend an active session. Sets status to ‘suspended’ and records the reason…
switchSession()functionSwitch to a different session. Suspends the current active session and activa…
SessionViewclass
selectRuntimeProviderContext()function
detectRuntimeProviderContext()function
resetRuntimeProviderContextCache()function
parseScope()functionParse a scope string into a SessionScope. T4463
readSessions()functionRead sessions from accessor or JSON file. T4463
saveSessions()functionSave sessions via accessor or JSON file. T4463
startSession()functionStart a new session. T4463
endSession()functionEnd a session. T4463
sessionStatus()functionGet current session status. T4463
resumeSession()functionResume an existing session. T4463
listSessions()functionList sessions with optional filtering. T4463
gcSessions()functionGarbage collect old sessions. Marks orphaned sessions that have been active t…
getEnforcementMode()functionGet the current enforcement mode.
isSessionEnforcementEnabled()functionCheck if session enforcement is enabled.
getActiveSessionInfo()functionGet active session info. Returns null if no active session.
requireActiveSession()functionRequire an active session for write operations. In strict mode, throws if no…
validateTaskInScope()functionValidate that a task is within the current session’s scope. Only enforced whe…
createAcceptanceEnforcement()function
isValidPipelineStage()functionCheck whether a string is a valid pipeline stage name.
validatePipelineStage()functionValidate a pipeline stage name and throw a CleoError on failure.
resolveDefaultPipelineStage()functionDetermine the default pipeline stage for a new task. Rules (in priority orde…
getPipelineStageOrder()functionGet the numeric order of a pipeline stage (1-based).
isPipelineTransitionForward()functionCheck whether transitioning from currentStage to newStage is forward-only…
validatePipelineTransition()functionValidate a pipeline stage transition and throw if it would move backward.
getLifecycleMode()functionRead lifecycle.mode from config. Falls back to “strict” when unset (matche…
validateEpicCreation()functionValidate that a new epic satisfies creation requirements. In strict mode…
validateChildStageCeiling()functionValidate that a child task’s pipeline stage does not exceed its epic’s stage…
findEpicAncestor()functionFind the nearest epic ancestor for a given task. Walks the ancestor chain (r…
validateEpicStageAdvancement()functionValidate that an epic can advance its pipeline stage. An epic is blocked
buildDefaultVerification()functionBuild the default verification metadata applied to every new task. Gates are…
validateTitle()functionValidate a task title. T4460
validateStatus()functionValidate task status. T4460
normalizePriority()functionNormalize priority to canonical string format. Accepts both string names (“cr…
validatePriority()functionValidate task priority. T4460 T4572
validateTaskType()functionValidate task type. T4460
validateSize()functionValidate task size. T4460
validateLabels()functionValidate label format. T4460
validatePhaseFormat()functionValidate phase slug format. T4460
validateDepends()functionValidate dependency IDs exist. T4460
validateParent()functionValidate parent hierarchy constraints. T4460
getTaskDepth()functionGet the depth of a task in the hierarchy. T4460
inferTaskType()functionInfer task type from parent context. T4460
getNextPosition()functionGet the next position for a task within a parent scope. T4460
logOperation()functionLog an operation to the audit log. T4460
findRecentDuplicate()functionCheck for recent duplicate task. T4460
addTask()functionAdd a new task to the todo file. T4460
listPhases()functionList all phases with status summaries. T4464
showPhase()functionShow the current phase details. T4464
setPhase()functionSet the current project phase. T4464
startPhase()functionStart a phase (pending - active). T4464
completePhase()functionComplete a phase (active - completed). T4464
advancePhase()functionAdvance to the next phase. T4464
renamePhase()functionRename a phase and update all task references. T4464
deletePhase()functionDelete a phase with optional task reassignment. T4464
pruneAuditLog()functionPrune old audit_log rows from tasks.db. 1. If auditRetentionDays is 0 or und…
generateProjectHash()functionCanonical project identity hash. SHA-256 of absolute path, first 12 hex chars…
validateAgainstSchema()functionValidate data against a JSON Schema object. Throws CleoError on validation fa…
validateAgainstSchemaFile()functionLoad a JSON Schema file and validate data against it.
checkSchema()functionCheck if data is valid against a schema without throwing. Returns an array of…
resolveSchemaPath()functionResolve the absolute path to a schema file at runtime. Priority: 1. Global…
getSchemaVersion()functionRead the schema version from a resolved schema file. Checks schemaVersion
ensureGlobalSchemas()functionCopy ALL bundled schemas from package schemas/ to ~/.cleo/schemas/. - Create…
checkGlobalSchemas()functionVerify that global schemas are installed and not stale.
checkSchemaStaleness()functionCompare global schema versions against bundled package versions.
listInstalledSchemas()functionList all schemas installed in ~/.cleo/schemas/.
cleanProjectSchemas()functionBackup and remove deprecated .cleo/schemas/ directory from a project. Schema…
readSchemaVersionFromFile()functionRead the top-level schemaVersion field from a schema file. Delegates to the…
checkSchemaIntegrity()functionCheck integrity of all active JSON files in a CLEO project.
detectProjectType()functionDetect project type from directory contents. Returns a schema-compliant Proje…
getInjectionTemplateContent()functionGet the CLEO-INJECTION.md template content from the package templates/ direct…
ensureInjection()functionFull injection refresh: strip legacy blocks, inject CAAMP content, install gl…
buildContributorInjectionBlock()functionBuild a smart, contextual contributor block for AGENTS.md injection. Returns…
checkInjection()functionVerify injection health: AGENTS.md exists, has CAAMP markers, markers are bal…
fileExists()functionCheck if a file exists and is readable.
stripCLEOBlocks()functionStrip legacy CLEO:START/CLEO:END blocks from a file. Called before CAAMP inje…
removeCleoFromRootGitignore()functionRemove .cleo/ or .cleo entries from the project root .gitignore.
getPackageRoot()functionResolve the package root directory (where schemas/ and templates/ live). scaf…
getGitignoreContent()functionLoad the gitignore template from the package’s templates/ directory. Falls ba…
getCleoVersion()functionRead CLEO version from package.json.
createDefaultConfig()functionCreate default config.json content.
ensureCleoStructure()functionCreate .cleo/ directory and all required subdirectories. Idempotent: skips di…
ensureGitignore()functionCreate or repair .cleo/.gitignore from template. Idempotent: skips if file al…
ensureConfig()functionCreate default config.json if missing. Idempotent: skips if file already exists.
ensureProjectInfo()functionCreate or refresh project-info.json. Idempotent: skips if file already exists…
ensureContributorMcp()functionNo-op. Kept for API compatibility.
ensureProjectContext()functionDetect and write project-context.json. Idempotent: skips if file exists and i…
ensureCleoGitRepo()functionInitialize isolated .cleo/.git checkpoint repository. Idempotent: skips if .c…
ensureSqliteDb()functionCreate SQLite database if missing. Idempotent: skips if tasks.db already exists.
checkCleoStructure()functionVerify all required .cleo/ subdirectories exist.
checkGitignore()functionVerify .cleo/.gitignore exists and matches template.
checkConfig()functionVerify config.json exists and is valid JSON.
checkProjectInfo()functionVerify project-info.json exists with required fields.
checkProjectContext()functionVerify project-context.json exists and is not stale (default: 30 days).
checkCleoGitRepo()functionVerify .cleo/.git checkpoint repository exists.
checkSqliteDb()functionVerify .cleo/tasks.db exists and is non-empty.
ensureBrainDb()functionCreate brain.db if missing. Idempotent: skips if brain.db already exists.
checkBrainDb()functionVerify .cleo/brain.db exists and is non-empty.
checkMemoryBridge()functionVerify .cleo/memory-bridge.md exists. Warning level if missing (not failure)…
ensureGlobalHome()functionEnsure the global ~/.cleo/ home directory and its required subdirectories exi…
ensureGlobalTemplates()functionEnsure the global CLEO injection template is installed. Delegates to injectio…
ensureGlobalScaffold()functionPerform a complete global scaffold operation: ensure home and templates are a…
ensureCleoOsHub()functionEnsure the CleoOS Hub subdirectories exist under the global CLEO home, and se…
checkGlobalHome()functionCheck that the global ~/.cleo/ home and its required subdirectories exist. Re…
checkGlobalTemplates()functionCheck that the global injection template is present and current. Read-only: n…
checkLogDir()functionCheck that the project log directory exists. Read-only: no side effects.
classifyProject()functionClassify a project directory as greenfield or brownfield. Read-only — never…
ensureGitHooks()functionInstall or update managed git hooks from templates/git-hooks/ into .git/hooks…
checkGitHooks()functionVerify managed hooks are installed and current. Compares installed hooks in…
detectLegacyAgentOutputs()functionDetect legacy agent-output directories in a project. Read-only check — never…
migrateAgentOutputs()functionRun the full agent-outputs migration. Copies files from all legacy locations…
migrateJsonToSqlite()functionMigrate projects from legacy JSON registry to nexus.db. For each project ent…
getNexusHome()functionGet path to the NEXUS home directory (cache, etc.).
getNexusCacheDir()functionGet path to the NEXUS cache directory.
getRegistryPath()functionGet path to the legacy projects registry JSON file.
readRegistry()functionRead all projects from nexus.db and return as a NexusRegistryFile. Compatibil…
readRegistryRequired()functionRead the global registry, throwing if not initialized.
nexusInit()functionInitialize the NEXUS directory structure and nexus.db. Idempotent — safe to…
nexusRegister()functionRegister a project in the global registry (nexus.db).
nexusUnregister()functionUnregister a project from the global registry.
nexusList()functionList all registered projects.
nexusGetProject()functionGet a project by name or hash. Returns null if not found.
nexusProjectExists()functionCheck if a project exists in the registry.
nexusSync()functionSync project metadata (task count, labels) for a registered project.
nexusSyncAll()functionSync all registered projects.
nexusSetPermission()functionUpdate a project’s permission level in the registry. Used by permissions.ts t…
nexusReconcile()functionReconcile the current project’s identity with the global nexus registry. 4-s…
analyzeStack()function
analyzeArchitecture()function
analyzeStructure()function
analyzeConventions()function
analyzeTesting()function
analyzeIntegrations()function
analyzeConcerns()function
storeMapToBrain()function
mapCodebase()function
initAgentDefinition()functionInstall cleo-subagent agent definition to ~/.agents/agents/. T4685
initMcpServer()functionNo-op. Kept for API compatibility. T4706
initCoreSkills()functionInstall CLEO core skills to the canonical skills directory via CAAMP. T4707…
initNexusRegistration()functionRegister/reconcile project with NEXUS. Uses nexusReconcile for idempotent han…
installGitHubTemplates()functionInstall GitHub issue and PR templates to .github/ if a git repo exists but .g…
updateDocs()functionRun update-docs only: refresh all injections without reinitializing. Re-injec…
initProject()functionRun full project initialization. Creates the .cleo/ directory structure, ins…
isAutoInitEnabled()functionCheck if auto-init is enabled via environment variable. T4789
ensureInitialized()functionCheck if a project is initialized and auto-init if configured. Returns initi…
getVersion()functionGet the current CLEO/project version. Checks VERSION file, then package.json…
bootstrapGlobalCleo()functionBootstrap the global CLEO directory structure and install templates. Creates…
installMcpToProviders()functionNo-op. Kept for API compatibility.
installSkillsGlobally()functionInstall CLEO core skills globally via CAAMP.
bootstrapCaamp()function
exportTasks()functionExport tasks to a portable format. Returns the formatted content and metadata.
importTasks()functionImport tasks from an export file.
recordAgentExecution()functionRecord an agent execution event to brain_decisions. Each event becomes a…
_recordAgentExecutionWithAccessor()functionInternal implementation that accepts a pre-constructed accessor. Separated fo…
getAgentPerformanceHistory()functionRetrieve agent execution performance history from brain_decisions. Queries a…
_getAgentPerformanceHistoryWithAccessor()functionInternal implementation with injected accessor for testability.
recordFailurePattern()functionRecord a task failure pattern to brain_patterns. When a task fails, the (age…
_recordFailurePatternWithAccessor()functionInternal implementation with injected accessor.
storeHealingStrategy()functionStore a healing strategy observation to brain_observations. When a failure p…
_storeHealingStrategyWithAccessor()functionInternal implementation with injected accessor.
getSelfHealingSuggestions()functionGet self-healing suggestions for a given agent type and task type. Queries b…
_getSelfHealingSuggestionsWithAccessor()functionInternal implementation with injected accessor.
processAgentLifecycleEvent()functionFull agent lifecycle event processor. Convenience function that: 1. Records…
getAgentCapacity()functionGet task-count-based remaining capacity for an agent. Remaining capacity =…
getAgentsByCapacity()functionList all non-terminal agents sorted by remaining task capacity (descending)…
getAgentSpecializations()functionGet the specialization/skills list for an agent. Specializations are stored…
updateAgentSpecializations()functionUpdate the specializations list stored in an agent’s metadata. Merges the ne…
recordAgentPerformance()functionRecord agent performance metrics to the BRAIN execution history. Translates…
updateCapacity()functionUpdate the capacity value for an agent instance.
getAvailableCapacity()functionGet the total available capacity across all active agents. Only considers ag…
findLeastLoadedAgent()functionFind the agent with the most available capacity.
isOverloaded()functionCheck if the system is overloaded (total capacity below threshold).
getCapacitySummary()functionGet a capacity summary across the entire agent pool.
recordHeartbeat()functionRecord a heartbeat for an agent instance. Updates last_heartbeat to the cu…
checkAgentHealth()functionCheck the health of a specific agent instance by ID. Queries the agent’s cur…
detectStaleAgents()functionFind all non-terminal agents whose last heartbeat is older than thresholdMs
detectCrashedAgents()functionFind agents with status active whose heartbeat has been silent for longer t…
createRetryPolicy()functionCreate a retry policy by merging overrides with the default policy.
calculateDelay()functionCalculate the delay for a given retry attempt using exponential backoff.
shouldRetry()functionDetermine whether an error should be retried based on its classification and…
withRetry()functionWrap an async function with retry logic using configurable exponential backoff.
recoverCrashedAgents()functionAttempt to recover crashed agents. Finds all agents with status ‘crashed’ an…
calculateTaskRisk()functionCalculate the risk score for a task based on multiple contributing factors…
predictValidationOutcome()functionPredict the likelihood of a task passing a lifecycle validation gate. Combin…
gatherLearningContext()functionGather applicable learnings for a task from brain_learnings.
suggestGateFocus()functionSuggest which verification gates to focus on for a task, ordered by risk. Us…
scoreVerificationConfidence()functionCompute a confidence score for a completed verification round and persist it…
storePrediction()functionStore a validation prediction as a brain observation for future learning. Sa…
predictAndStore()functionCompute a prediction for a task and immediately persist it to brain. Conveni…
detectCircularDeps()functionDetect circular dependencies using DFS. Returns the cycle path if found, empt…
wouldCreateCycle()functionCheck if adding a dependency would create a cycle.
getBlockedTasks()functionGet tasks that are blocked (have unmet dependencies).
getReadyTasks()functionGet tasks that are ready (all dependencies met).
getDependents()functionGet tasks that depend on a given task.
getDependentIds()functionGet dependent IDs.
getUnresolvedDeps()functionGet unresolved dependencies for a task (deps that are not done/cancelled).
validateDependencyRefs()functionValidate dependencies for missing references.
validateDependencies()functionFull dependency graph validation.
topologicalSort()functionTopological sort of tasks by dependencies. Returns sorted task IDs or null if…
getTransitiveBlockers()functionWalk upstream recursively through a task’s dependency chain. Returns all non-…
getLeafBlockers()functionFrom the transitive blockers, return only “leaf” blockers — those whose own d…
computeDependencyWaves()functionCompute dependency waves for parallel execution. Tasks in the same wave can r…
getNextTask()functionGet the next task to work on (highest priority ready task).
getCriticalPath()functionCalculate the critical path (longest dependency chain). Returns task IDs alon…
getTaskOrder()functionGet task ordering by dependency + priority.
getParallelTasks()functionGet parallelizable tasks (tasks with no unmet dependencies).
analyzeTaskImpact()functionAnalyze the full downstream impact of a task. Computes direct and transitive…
analyzeChangeImpact()functionAnalyze the downstream effects of a specific change to a task. Predicts what…
calculateBlastRadius()functionCalculate the blast radius for a task. Quantifies how many tasks, epics, and…
predictImpact()functionPredict the downstream impact of a free-text change description. Uses fuzzy…
extractPatternsFromHistory()functionAnalyze brain_observations and task history to find recurring patterns. Dete…
matchPatterns()functionFind which known patterns from brain_patterns apply to a given task. Compare…
storeDetectedPattern()functionSave a detected pattern to the brain_patterns table. Uses the existing brain…
updatePatternStats()functionUpdate the frequency and success_rate of an existing pattern after an outcome…
validateSyntax()functionValidate a query string matches expected syntax.
parseQuery()functionParse a query string into its components.
getCurrentProject()functionGet the current project name from context. Reads .cleo/project-info.json or f…
resolveProjectPath()functionResolve a project name to its filesystem path. Handles special cases: ”.” (cu…
resolveTask()functionResolve a query to task data. For wildcard queries, returns an array of match…
getProjectFromQuery()functionExtract the project name from a query without full resolution. Useful for per…
extractKeywords()functionExtract meaningful keywords from text (filters stop words and short tokens).
discoverRelated()functionDiscover tasks related to a given task query across projects. Returns a stru…
searchAcrossProjects()functionSearch for tasks across all registered projects. Returns a structured result…
permissionLevel()functionConvert a permission string to its numeric level. Returns 0 for invalid/unkno…
getPermission()functionGet the permission level for a registered project. Returns ‘read’ as default…
checkPermission()functionCheck if a project has sufficient permissions (non-throwing). Uses hierarchic…
requirePermission()functionRequire a permission level or throw CleoError. Used as a guard at the start o…
checkPermissionDetail()functionFull permission check returning a structured result.
setPermission()functionSet the permission level for a project. Validates the permission value and up…
canRead()functionConvenience: check read access.
canWrite()functionConvenience: check write access.
canExecute()functionConvenience: check execute access.
matchesPattern()functionMatch a file path against a glob-like pattern. Supports: ’*’ (single segment…
getSharingStatus()functionGet the sharing status: which .cleo/ files are tracked vs ignored, plus git s…
syncGitignore()functionSync the project .gitignore to match the sharing config. Adds/updates a manag…
currentTask()functionShow current task work state. T4462 T4750
startTask()functionStart working on a specific task. T4462 T4750
stopTask()functionStop working on the current task. T4462 T4750
getWorkHistory()functionGet task work history from session notes. T4462 T4750
completeTask()functionComplete a task by ID. Handles dependency checking and optional auto-completi…
validateTitleDescription()functionValidate that title and description are both present and different. This is a…
validateTimestamps()functionValidate that timestamps are not in the future
validateIdUniqueness()functionValidate ID uniqueness across all tasks (todo + archive)
validateNoDuplicateDescription()functionValidate no duplicate task descriptions
validateHierarchy()functionValidate hierarchy constraints. Accepts optional limits to override defaults…
validateStatusTransition()functionValidate status transition
validateNewTask()functionRun all validation rules on a task being created
hasErrors()functionCheck if violations contain any errors (not just warnings)
updateTask()functionUpdate a task’s fields. T4461
parseDirective()functionParse a Conduit message into a structured directive. Extracts directive verb…
routeDirective()functionRoute a Conduit directive to the correct project’s CLEO instance. Resolves w…
workspaceStatus()functionGet aggregated task status across all registered projects. Returns per-proje…
workspaceAgents()functionGet all agents registered across all projects. Queries each project’s agent_…
invalidateDepsCache()functionInvalidate the cached TaskFile (call after writes). T4659 T4654
buildGraph()functionBuild an adjacency graph from task dependencies. T4464
getDepsOverview()functionGet dependency overview for all tasks. T4464
getTaskDeps()functionGet dependencies for a specific task. T4464
topologicalSort()functionTopological sort of tasks respecting dependencies. Returns tasks in execution…
getExecutionWaves()functionGroup tasks into parallelizable execution waves. T4464
getCriticalPath()functionFind the critical path (longest dependency chain) from a task. T4464
getImpact()functionFind all tasks affected by changes to a given task. T4464
detectCycles()functionDetect circular dependencies in the task graph. T4464
getTaskTree()functionBuild task hierarchy tree. T4464
addRelation()functionManage task relationships (relates/blocks). T4464
buildDependencyGraph()functionBuild a dependency graph for a set of tasks. Returns a Map from task ID to t…
detectCircularDependencies()functionDetect circular dependencies using DFS traversal.
findMissingDependencies()functionFind missing dependencies — deps that reference tasks outside the epic that a…
analyzeDependencies()functionPerform full dependency analysis for an epic’s children. Combines dependency…
countManifestEntries()functionCount manifest entries from pipeline_manifest (ADR-027).
estimateContext()functionEstimate context usage for orchestration.
OrchestrationHierarchyImplclassConcrete implementation of OrchestrationHierarchyAPI.
computeWaves()functionCompute execution waves using topological sort.
getEnrichedWaves()functionGet enriched wave data for an epic.
countByStatus()functionCount tasks by status.
computeEpicStatus()functionCompute epic-specific status.
computeOverallStatus()functionCompute overall orchestration status across all tasks.
computeProgress()functionCompute progress metrics for all tasks.
computeStartupSummary()functionCompute startup summary for an epic.
startOrchestration()functionStart an orchestrator session for an epic. T4466
analyzeEpic()functionAnalyze an epic’s dependency structure. T4466
getReadyTasks()functionGet parallel-safe ready tasks for an epic. T4466
getNextTask()functionGet the next task to work on for an epic. T4466
prepareSpawn()functionPrepare a spawn context for a subagent. T4466
validateSpawnOutput()functionValidate a subagent’s output. T4466
getOrchestratorContext()functionGet orchestrator context summary. T4466
autoDispatch()functionAuto-dispatch: determine the protocol for a task based on metadata. T4466
resolveTokens()functionResolve tokens in a prompt string. T4466
getLinksByProvider()functionFind all links for a given provider.
getLinkByExternalId()functionFind a link by provider + external ID.
getLinksByTaskId()functionFind all links for a given CLEO task.
createLink()functionCreate a new external task link.
touchLink()functionUpdate the lastSyncAt and optionally the title/metadata for an existing link.
removeLinksByProvider()functionRemove all links for a provider (used during provider deregistration).
reconcile()functionReconcile external task state with CLEO’s authoritative task store.
getArtifactHandler()functionGet handler for an artifact type. T4552
hasArtifactHandler()functionCheck if a handler is registered for an artifact type. T4552
buildArtifact()functionBuild an artifact using the appropriate handler. T4552
validateArtifact()functionValidate an artifact using the appropriate handler. T4552
publishArtifact()functionPublish an artifact using the appropriate handler. T4552
getSupportedArtifactTypes()functionGet all supported artifact types. T4552
parseChangelogBlocks()functionParse [custom-log]…[/custom-log] blocks from a CHANGELOG section. Returns t…
writeChangelogSection()functionWrite or update a CHANGELOG.md section for a specific version. - If ## [VERS…
loadReleaseConfig()functionLoad release configuration with defaults.
validateReleaseConfig()functionValidate release configuration.
getArtifactType()functionGet artifact type from config.
getReleaseGates()functionGet release gates from config.
getChangelogConfig()functionGet changelog configuration.
getDefaultGitFlowConfig()functionReturn the default GitFlow branch configuration.
getGitFlowConfig()functionMerge caller-supplied GitFlow config with defaults.
getDefaultChannelConfig()functionReturn the default channel configuration.
getChannelConfig()functionMerge caller-supplied channel config with defaults.
getPushMode()functionReturn the configured push mode, defaulting to ‘auto’.
getDefaultChannelConfig()functionReturn the default branch-to-channel mapping.
resolveChannelFromBranch()functionResolve the release channel for a given Git branch name. Resolution order: 1…
channelToDistTag()functionMap a release channel to its npm dist-tag string. Kept as an explicit functi…
validateVersionChannel()functionValidate that a version string satisfies the pre-release conventions for the…
describeChannel()functionReturn a human-readable description of the given release channel.
getPlatformPath()functionGet the output path for a CI platform.
detectCIPlatform()functionDetect the CI platform from the project.
generateCIConfig()functionGenerate CI config for a platform.
writeCIConfig()functionWrite CI config to the appropriate path.
validateCIConfig()functionValidate an existing CI config.
isGhCliAvailable()functionCheck if the gh CLI is available by attempting to run gh --version. Does…
extractRepoOwnerAndName()functionParse a GitHub remote URL (HTTPS or SSH) into owner and repo components. Retu…
detectBranchProtection()functionDetect whether a branch has protection rules enabled. Strategy 1 (preferred)…
buildPRBody()functionBuild the markdown body for a GitHub pull request.
formatManualPRInstructions()functionFormat human-readable instructions for creating a PR manually.
createPullRequest()functionCreate a GitHub pull request using the gh CLI, or return manual instruction…
checkEpicCompleteness()functionCheck epic completeness for a set of release task IDs. Verifies all children…
checkDoubleListing()functionCheck if any tasks are listed in multiple releases.
validateVersionFormat()functionValidate version format (semver X.Y.Z or CalVer YYYY.M.patch, with optional p…
isCalVer()functionCheck if a version string is CalVer format.
calculateNewVersion()functionCalculate new version from current + bump type.
getVersionBumpConfig()functionGet version bump configuration, mapping config field names to VersionBumpTarget.
isVersionBumpConfigured()functionCheck if version bump is configured.
bumpVersionFromConfig()functionBump version in all configured files.
prepareRelease()functionPrepare a release (create a release manifest entry). T4788
generateReleaseChangelog()functionGenerate changelog for a release. T4788
listManifestReleases()functionList all releases. T4788
showManifestRelease()functionShow release details. T4788
commitRelease()functionMark release as committed (metadata only). T4788
tagRelease()functionMark release as tagged (metadata only). T4788
runReleaseGates()functionRun release validation gates. T4788 T5586
cancelRelease()functionCancel and remove a release in draft or prepared state. Only releases that ha…
rollbackRelease()functionRollback a release. T4788
pushRelease()functionPush release to remote via git. Respects config.release.push policy: - remot…
markReleasePushed()functionUpdate release status after push, with optional provenance fields. T4788 T5580
migrateReleasesJsonToSqlite()functionOne-time migration: read .cleo/releases.json and insert each release into the…
serializeSession()functionSerialize a session into a complete snapshot. Captures the full session stat…
restoreSession()functionRestore a session from a snapshot. Hydrates a session from a previously seri…
archiveSticky()functionArchive a sticky note.
convertStickyToTask()functionConvert a sticky note to a task.
convertStickyToMemory()functionConvert a sticky note to a memory observation.
convertStickyToTaskNote()functionConvert a sticky note to a task note.
convertStickyToSessionNote()functionConvert a sticky note to a session note.
generateStickyId()functionGenerate the next sticky note ID. Finds the highest existing SN-XXX ID and i…
addSticky()functionCreate a new sticky note.
listStickies()functionList sticky notes with optional filters.
purgeSticky()functionPurge (permanently delete) a sticky note.
getSticky()functionGet a sticky note by ID.
archiveTasks()functionArchive completed (and optionally cancelled) tasks. Moves them from active ta…
deleteTask()functionDelete a task (soft delete - moves to archive). T4461
Cleoclass
calculateExportChecksum()functionCalculate SHA-256 checksum for export integrity (truncated to 16 hex chars).
verifyExportChecksum()functionVerify export package checksum.
buildIdMap()functionBuild ID map from tasks.
buildRelationshipGraph()functionBuild relationship graph from tasks.
buildExportPackage()functionBuild a complete export package.
exportSingle()functionExport a single task.
exportSubtree()functionExport a subtree (task + all descendants).
exportTasksPackage()functionExport tasks to a portable cross-project package.
getCostHint()functionDetermine cost hint for an operation based on domain and operation name.
groupOperationsByDomain()functionGroup operations by domain into a compact format.
buildVerboseOperations()functionBuild verbose operation entries with cost hints.
computeHelp()functionCompute the help result for the admin.help operation. Accepts the full OPERA…
getNextAvailableId()functionGet the next available task ID number from existing tasks.
generateRemapTable()functionGenerate a remap table for importing tasks. Maps source task IDs to new seque…
validateRemapTable()functionValidate that a remap table is complete and consistent.
remapTaskId()functionRemap a single task ID, returning original if not in table.
remapTaskReferences()functionRemap all ID references in a task.
detectDuplicateTitles()functionDetect duplicate titles between import and target.
resolveDuplicateTitle()functionResolve duplicate title by appending suffix.
importFromPackage()functionImport tasks from an in-memory ExportPackage with ID remapping. Core logic ex…
importTasksPackage()functionImport tasks from a cross-project export package file with ID remapping. Thin…
findAdrs()function
listAdrs()functionList ADRs from .cleo/adrs/ directory with optional status filter
showAdr()functionRetrieve a single ADR by ID (e.g., ‘ADR-007’)
validateAllAdrs()functionValidate all ADRs in .cleo/adrs/ against the schema
providerList()functionList all registered providers. T4332
providerGet()functionGet a single provider by ID or alias. T4332
providerDetect()functionDetect all providers installed on the system. T4332
providerInstalled()functionGet providers that are installed on the system. T4332
providerCount()functionGet count of registered providers. T4332
registryVersion()functionGet CAAMP registry version. T4332
injectionCheck()functionCheck injection status for a single file. T4332
injectionCheckAll()functionCheck injection status across all providers. T4332
injectionUpdate()functionInject or update content in a single file. T4332
injectionUpdateAll()functionInject content to all providers’ instruction files. T4332
batchInstallWithRollback()functionInstall multiple skills atomically with rollback on failure. T4705 T4663
checkProviderCapability()functionCheck if provider supports a specific capability
checkProviderCapabilities()functionCheck multiple capabilities at once
detectLanguage()functionDetect tree-sitter language from a file path.
grammarPackage()functionGet the npm grammar package name for a language.
isTreeSitterAvailable()functionCheck if tree-sitter CLI is available and executable. Cached after first call.
parseFile()functionParse a single file and extract code symbols.
batchParse()functionBatch-parse multiple files, grouping by language for efficiency. Files with…
smartOutline()functionGenerate a smart outline for a source file. Returns a tree of symbols with s…
smartSearch()functionSearch for symbols across a codebase. Walks the directory tree, batch-parses…
smartUnfold()functionExtract a symbol’s complete source from a file. Finds the symbol by name (su…
getComplianceJsonlPath()functionResolve COMPLIANCE.jsonl path for a project root.
readComplianceJsonl()functionRead COMPLIANCE.jsonl entries. Invalid JSON lines are skipped to preserve app…
appendComplianceJsonl()functionAppend one entry to COMPLIANCE.jsonl, creating directories as needed.
getComplianceSummary()functionGet compliance summary.
listComplianceViolations()functionList compliance violations.
getComplianceTrend()functionGet compliance trend.
auditEpicCompliance()functionAudit epic compliance.
syncComplianceMetrics()functionSync compliance metrics to a summary file.
getSkillReliability()functionGet skill reliability stats.
getValueMetrics()functionGet value metrics (T2833).
ConduitClientclassConduitClient wraps a Transport, adding high-level messaging semantics.
HttpTransportclassHTTP transport with automatic primary/fallback failover.
LocalTransportclassIn-process SQLite transport for fully offline agent messaging.
SseTransportclassSseTransport — real-time SSE with HTTP polling fallback.
resolveTransport()functionResolve the best available transport for a credential. Cloud-backed agents (…
createConduit()functionCreate a Conduit instance from the agent registry.
getContextStatus()functionGet context status.
checkContextThreshold()functionCheck context threshold (returns exit code info).
listContextSessions()functionList all context state files.
validatePayload()functionValidate a hook payload against its event-specific Zod schema. Falls back to…
injectTasks()functionInject tasks for external consumption.
collectDiagnostics()functionCollect system diagnostics for bug reports.
formatDiagnosticsTable()functionFormat diagnostics as markdown table.
parseIssueTemplates()functionParse all issue templates from available sources. Priority: 1. Packaged tem…
getTemplateConfig()functionGet template configuration - tries live parse, cache, then fallback.
getTemplateForSubcommand()functionGet the template for a specific subcommand (bug, feature, etc.).
cacheTemplates()functionCache parsed templates to .cleo/issue-templates.json.
validateLabelsExist()functionValidate that labels referenced in issue templates are consistent. Collects…
buildIssueBody()functionBuild structured issue body with template sections.
checkGhCli()functionCheck that gh CLI is installed and authenticated.
addIssue()functionAdd a GitHub issue for a given type (bug, feature, help). Returns structured…
withRetry()functionExecute an async function with automatic retry and exponential backoff.
computeDelay()functionCompute the wait time before the next attempt.
applyTemporalDecay()functionApply temporal decay to brain_learnings confidence values. Entries older tha…
consolidateMemories()functionConsolidate old observations by keyword similarity. Groups observations olde…
migrateBrainData()functionMigrate BRAIN memory data from JSONL files to brain.db. Reads: - .cleo/memor…
addResearch()functionAdd a research entry.
showResearch()functionShow a specific research entry.
listResearch()functionList research entries with optional filtering.
pendingResearch()functionList pending research entries.
linkResearch()functionLink a research entry to a task.
updateResearch()functionUpdate research findings.
statsResearch()functionGet research statistics.
linksResearch()functionGet research entries linked to a specific task.
archiveResearch()functionArchive old research entries by status. Moves ‘complete’ entries to an archiv…
readManifest()functionRead manifest entries from the legacy agent-outputs flat-file (deprecated per ADR-027).
appendManifest()functionAppend a manifest entry.
queryManifest()functionQuery manifest entries with filtering.
readExtendedManifest()functionRead all manifest entries as extended entries.
filterManifestEntries()functionFilter manifest entries by criteria.
showManifestEntry()functionShow a manifest entry by ID with optional file content.
searchManifest()functionSearch manifest entries by text with relevance scoring.
pendingManifestEntries()functionGet pending manifest entries (partial, blocked, or needing followup).
manifestStats()functionGet manifest-based research statistics.
linkManifestEntry()functionLink a manifest entry to a task (adds taskId to linked_tasks array).
appendExtendedManifest()functionAppend an extended manifest entry. Validates required fields before appending.
archiveManifestEntries()functionArchive manifest entries older than a date.
findContradictions()functionFind manifest entries with overlapping topics but conflicting key_findings.
findSuperseded()functionIdentify research entries replaced by newer work on same topic.
readProtocolInjection()functionRead protocol injection content for a given protocol type.
compactManifest()functionCompact the legacy agent-outputs flat-file by removing duplicate/stale entries.
validateManifestEntries()functionValidate research entries for a task.
ensureMetricsDir()functionEnsure metrics directory exists, returning its path.
getCompliancePath()functionGet compliance log path.
getViolationsPath()functionGet violations log path.
getSessionsMetricsPath()functionGet sessions metrics log path.
isoTimestamp()functionGenerate ISO 8601 UTC timestamp.
isoDate()functionGenerate ISO 8601 date only.
readJsonlFile()functionRead a JSONL file into an array of parsed objects.
getComplianceSummaryBase()functionGet compliance summary from log file.
isOtelEnabled()functionCheck if OTel telemetry is enabled.
getOtelSetupCommands()functionGet environment variable commands for OTel capture setup.
parseTokenMetrics()functionParse OTel token metrics from collected data.
getSessionTokens()functionGet aggregated token counts from OTel data.
recordSessionStart()functionRecord token counts at session start.
recordSessionEnd()functionRecord token counts at session end.
compareSessions()functionCompare token usage between two sessions.
getTokenStats()functionGet statistics about token usage across sessions.
logABEvent()functionLog an A/B test event.
startABTest()functionStart an A/B test session.
endABTest()functionEnd an A/B test session with summary.
getABTestResults()functionGet results for a specific test variant.
listABTests()functionList all A/B tests.
compareABTest()functionCompare two variants of the same test.
getABTestStats()functionGet aggregate statistics of all A/B tests.
syncMetricsToGlobal()functionSync project metrics to global aggregation file.
getProjectComplianceSummary()functionGet compliance summary for the current project.
getGlobalComplianceSummary()functionGet compliance summary across all projects.
getComplianceTrend()functionGet compliance trend over time.
getSkillReliability()functionGet reliability stats per skill/agent.
logSessionMetrics()functionLog session metrics to SESSIONS.jsonl.
getSessionMetricsSummary()functionGet summary of session metrics.
isValidEnumValue()functionValidate that a value is a member of a given enum.
estimateTokens()functionEstimate token count from text. ~4 characters per token.
estimateTokensFromFile()functionEstimate token count from a file.
logTokenEvent()functionLog a token usage event to the JSONL file.
trackFileRead()functionTrack a file read with token estimate.
trackManifestQuery()functionTrack a manifest query (partial read).
trackSkillInjection()functionTrack skill injection with tokens.
trackPromptBuild()functionTrack final prompt size.
trackSpawnOutput()functionTrack subagent output tokens.
trackSpawnComplete()functionTrack complete spawn cycle (prompt + output).
startTokenSession()functionStart tracking tokens for a session.
endTokenSession()functionEnd token tracking session with summary.
getTokenSummary()functionGet token usage summary for a time period.
compareManifestVsFull()functionCompare manifest vs full file token usage strategies.
getTrackingStatus()functionGet tracking status.
computeChecksum()functionCompute SHA-256 checksum of a file.
verifyBackup()functionVerify that a backup file matches the source file and is a valid SQLite datab…
compareChecksums()functionQuick checksum comparison without SQLite verification. Use when you only need…
MigrationLoggerclassStructured logger for migration operations
createMigrationLogger()functionCreate a migration logger for the given cleo directory. Convenience function…
readMigrationLog()functionRead and parse a migration log file.
logFileExists()functionCheck if a log file exists and is readable.
getLatestMigrationLog()functionGet the most recent migration log file for a cleo directory.
checkStorageMigration()functionCheck whether legacy JSON data needs to be migrated to SQLite. Returns a dia…
createMigrationState()functionCreate initial migration state at the start of migration. Captures source fi…
updateMigrationState()functionUpdate migration state with partial updates. Merges updates with existing st…
updateMigrationPhase()functionUpdate just the migration phase. Convenience wrapper for common phase transit…
updateMigrationProgress()functionUpdate progress counters during import.
addMigrationError()functionAdd an error to the migration state.
addMigrationWarning()functionAdd a warning to the migration state.
loadMigrationState()functionLoad existing migration state.
isMigrationInProgress()functionCheck if a migration is in progress.
canResumeMigration()functionCheck if migration can be resumed.
completeMigration()functionMark migration as complete.
failMigration()functionMark migration as failed with error details.
clearMigrationState()functionClear migration state file. Safe to call even if state doesn’t exist.
getMigrationSummary()functionGet a summary of migration state for display.
verifySourceIntegrity()functionVerify source files haven’t changed since migration started. Compares curren…
validateSourceFiles()functionValidate all JSON source files before migration. This function MUST be calle…
formatValidationResult()functionFormat validation result for human-readable output.
checkTaskCountMismatch()functionCheck for task count mismatch between existing database and JSON. This helps…
detectVersion()functionDetect schema version from a data file. T4468
compareSemver()functionCompare two version strings (X.Y.Z format, works for both semver and CalVer)…
getMigrationStatus()functionGet migration status for all data files. T4468
runMigration()functionRun migrations on a data file. T4468
runAllMigrations()functionRun all pending migrations. T4468
invalidateGraphCache()functionInvalidate the in-memory graph cache.
buildGlobalGraph()functionBuild the global dependency graph from all registered projects. Uses checksum…
nexusDeps()functionShow dependencies for a task across projects. Supports forward (what this dep…
resolveCrossDeps()functionResolve an array of dependencies (local or cross-project).
criticalPath()functionCalculate the critical path across project boundaries. Returns the longest de…
blockingAnalysis()functionAnalyze the blocking impact of a task across all projects. Uses BFS to find a…
orphanDetection()functionDetect orphaned cross-project dependencies. Finds tasks with dependency refer…
previewTransfer()functionPreview a transfer without writing any data. Validates projects, permissions,…
executeTransfer()functionExecute a cross-project task transfer. Pipeline: 1. Validate source/target…
compareLevels()functionCompare two pino levels numerically. Returns negative if a b, 0 if equal, po…
matchesFilter()functionCheck if a single entry matches the filter criteria. All specified fields mus…
filterEntries()functionFilter an array of parsed log entries against criteria. Returns entries match…
paginate()functionApply pagination (limit/offset) to a result set.
isValidLevel()functionValidate that a string is a valid PinoLevel.
parseLogLine()functionParse a single JSONL line into a PinoLogEntry. Returns null for empty lines,…
parseLogLines()functionParse multiple JSONL lines into PinoLogEntry array. Skips malformed lines.
getProjectLogDir()functionGet the project log directory path. Uses getLogDir() from logger if available…
getGlobalLogDir()functionGet the global log directory path (~/.cleo/logs/).
discoverLogFiles()functionDiscover all log files in the specified scope. Returns file info sorted by da…
readLogFileLines()functionRead all lines from a log file synchronously. Returns raw JSON strings (one p…
streamLogFileLines()functionCreate an async iterable over lines of a log file. Suitable for large files -…
queryLogs()functionHigh-level query: discover files, parse, filter, paginate. Convenience wrappe…
streamLogs()functionStream-based query for large log datasets. Yields matching entries one at a t…
getLogSummary()functionGet a summary of log activity (counts by level, date range, subsystems). Read…
getOtelStatus()functionGet token tracking status.
getOtelSummary()functionGet combined token usage summary.
getOtelSessions()functionGet session-level token data.
getOtelSpawns()functionGet spawn-level token data.
getRealTokenUsage()functionGet real token usage from Claude Code API.
clearOtelData()functionClear token tracking data with backup.
listPhases()functionList all phases with status summaries. T5326
showPhase()functionShow phase details by slug or current phase. T5326
getCurrentBranch()functionGet the current branch name in .cleo/.git. T4884
addRemote()functionAdd a git remote to .cleo/.git. T4884
removeRemote()functionRemove a git remote from .cleo/.git. T4884
listRemotes()functionList configured remotes in .cleo/.git. T4884
push()functionPush .cleo/.git to a remote. T4884
pull()functionPull from a remote into .cleo/.git. Uses rebase strategy to maintain clean hi…
getSyncStatus()functionGet the sync status between local .cleo/.git and remote. T4884
getRoadmap()functionGet roadmap from pending epics and CHANGELOG history.
getOperationMode()functionLookup the execution mode for a specific operation
canRunNatively()functionCheck if an operation can run natively (without CLI)
requiresCLI()functionCheck if an operation requires CLI
getNativeOperations()functionGet all native-capable operations for a domain
generateCapabilityReport()functionGenerate a capability report for system.doctor
getCapabilityMatrix()functionGet the full capability matrix (for testing/introspection)
findHighestId()functionFind the highest existing task ID number
generateNextIdFromSet()functionGenerate the next ID given an explicit set of existing IDs. Useful when calle…
isValidTaskId()functionValidate that a task ID matches the expected format
normalizeTaskId()functionNormalize a task ID input to canonical T#### format. Accepts various loose f…
SecurityErrorclassSecurity validation error thrown when input fails sanitization
sanitizeTaskId()functionSanitize and validate a task ID
sanitizePath()functionSanitize and validate a file path
sanitizeContent()functionSanitize content string
validateEnum()functionValidate that a value is in an allowed enum set
RateLimiterclassIn-memory sliding window rate limiter
ensureArray()functionNormalize a value to an array of strings. Handles external clients sending co…
sanitizeParams()functionSanitize all params in a request before routing
getAgentsDir()functionGet the agents directory path. T4518
parseAgentConfig()functionParse an AGENT.md file into an AgentConfig. AGENT.md uses the same YAML front…
loadAgentConfig()functionLoad agent configuration by name. Searches in the agents/ directory. T4518
getSubagentConfig()functionGet the cleo-subagent configuration (universal executor). T4518
agentExists()functionCheck if an agent definition exists. T4518
installAgent()functionInstall a single agent via symlink. T4518
installAllAgents()functionInstall all agents from the project agents/ directory. T4518
uninstallAgent()functionUninstall a single agent by removing its symlink. T4518
getRegistryPath()functionGet the agent registry file path. T4518
readRegistry()functionRead the agent registry, creating if needed. T4518
saveRegistry()functionSave the agent registry. T4518
registerAgent()functionRegister an agent in the registry. T4518
unregisterAgent()functionUnregister an agent from the registry. T4518
getAgent()functionGet an agent from the registry by name. T4518
listAgents()functionList all registered agents. T4518
syncRegistry()functionScan the agents/ directory and register all found agents. T4518
loadProtocolBase()functionLoad the subagent protocol base content. T4521
buildTaskContext()functionBuild task context block for injection into a subagent prompt. T4521
filterProtocolByTier()functionFilter protocol content by MVI tier. Extracts sections based on !— TIER:X —…
injectProtocol()functionInject the subagent protocol into skill content. Composes: skill content + pr…
orchestratorSpawnSkill()functionFull orchestrator spawn workflow (skill-based). High-level function that load…
prepareTokenValues()functionPrepare standard token values for a task spawn. T4521
installSkill()functionInstall a single skill via CAAMP.
generateContributionId()functionGenerate a unique contribution ID. T4520
validateContributionTask()functionValidate that a task is suitable for contribution protocol. T4520
getContributionInjection()functionGenerate the contribution injection block for a subagent prompt. T4520
detectConflicts()functionDetect conflicts between two sets of decisions. T4520
computeConsensus()functionCompute weighted consensus from multiple agent decisions. T4520
createContributionManifestEntry()functionCreate a manifest entry for a contribution. T4520
ensureOutputs()functionEnsure agent outputs directory and manifest file exist. T4520
readManifest()functionRead all manifest entries. T4520
appendManifest()functionAppend a manifest entry (atomic JSONL append). T4520
findEntry()functionFind a manifest entry by ID. T4520
filterEntries()functionFilter manifest entries by criteria. T4520
getPendingFollowup()functionGet entries with pending follow-ups. T4520
getFollowupTaskIds()functionGet unique follow-up task IDs from all manifest entries. T4520
taskHasResearch()functionCheck if a task has linked research. T4520
archiveEntry()functionArchive a manifest entry (move to archive status). T4520
rotateManifest()functionRotate manifest by archiving old entries. T4520
isCacheFresh()functionCheck if the cached manifest is fresh (within TTL). T4520
invalidateCache()functionInvalidate the cache (delete the cached manifest). T4520
resolveManifest()functionResolve the skills manifest. Returns a cached version if fresh, otherwise gen…
regenerateCache()functionForce regenerate the cache. T4520
loadConfig()functionLoad SkillsMP configuration from skillsmp.json. T4521
searchSkills()functionSearch the skills marketplace. Delegates to CAAMP’s searchSkills for the actu…
getSkill()functionGet a specific skill from the marketplace. Uses CAAMP’s MarketplaceClient for…
isEnabled()functionCheck if the marketplace is enabled and reachable. T4521
buildPrompt()functionBuild a fully-resolved prompt for spawning a subagent. T4519
spawn()functionGenerate full spawn command with metadata. T4519
canParallelize()functionCheck if tasks can be spawned in parallel (no inter-dependencies). T4519
spawnBatch()functionSpawn prompts for multiple tasks in a batch. Ports orchestrator_spawn_batch f…
getThresholds()functionGet orchestrator context thresholds from config or defaults. T4519
getContextState()functionRead the current context state from session-aware files. T4519
sessionInit()functionInitialize orchestrator session state. Determines the recommended action base…
shouldPause()functionCheck if orchestrator should pause based on context usage. T4519
analyzeDependencies()functionAnalyze dependency graph and compute execution waves. T4519
getNextTask()functionGet the next task ready to spawn for an epic. T4519
getReadyTasks()functionGet all tasks ready to spawn in parallel (no inter-dependencies). T4519
generateHitlSummary()functionGenerate a Human-in-the-Loop summary for session handoff. T4519
validateSubagentOutput()functionValidate a subagent’s manifest entry for protocol compliance. T4519
validateManifestIntegrity()functionValidate the entire manifest file integrity. T4519
verifyCompliance()functionVerify previous agent completed protocol compliance before spawning next. T4519
validateOrchestratorCompliance()functionValidate orchestrator compliance (post-hoc behavioral checks). T4519
getSkillSearchPaths()functionGet ordered skill search paths based on configuration. Priority: 1. CLEO_SKI…
resolveSkillPath()functionResolve a skill directory containing SKILL.md. Searches all paths from getSki…
resolveProtocolPath()functionResolve a protocol .md file. Search order: 1…
resolveSharedPath()functionResolve a shared resource .md file. Search order per base path:…
getSkillSourceType()functionClassify the source of a skill directory. Determines where a skill directory…
formatIsoDate()functionFormat a date string in ISO 8601 format. Converts a YYYY-MM-DD date string to…
getCurrentTimestamp()functionGet current timestamp in ISO 8601 format. Returns the current UTC time as an…
isValidIsoDate()functionValidate that a string is a valid ISO 8601 date. T4552
formatDateYMD()functionFormat a Date object to a YYYY-MM-DD string. T4552
validateSkill()functionValidate a skill directory structure and content. T4517
validateSkills()functionValidate multiple skills at once. T4517
validateReturnMessage()functionValidate a return message against protocol-compliant patterns. T4517
getInstalledVersionAsync()functionGet the installed version of a skill from CAAMP lock state.
checkSkillUpdateAsync()functionCheck if a specific skill needs an update via CAAMP.
checkAllSkillUpdatesAsync()functionCheck all installed skills for available updates via CAAMP.
exportSnapshot()functionExport current task state to a snapshot. T4882
writeSnapshot()functionWrite a snapshot to a file. T4882
readSnapshot()functionRead a snapshot from a file. T4882
getDefaultSnapshotPath()functionGenerate a default snapshot file path. T4882
importSnapshot()functionImport a snapshot into the local task database. Uses last-write-wins strategy…
SpawnAdapterRegistryclassRegistry to manage spawn adapters. Maintains mappings between adapter IDs, p…
getProvidersWithSpawnCapability()functionGet providers by specific spawn capability Queries CAAMP for providers that…
hasParallelSpawnProvider()functionCheck if any provider supports parallel spawn
initializeSpawnAdapters()functionInitialize spawn adapters dynamically from discovered adapter manifests. Sca…
initializeDefaultAdapters()functionInitialize the registry with default adapters. Legacy entry point that disco…
getWorkflowComplianceReport()functionCompute workflow compliance metrics from existing task, session, and audit da…
getProjectStats()functionGet project statistics.
rankBlockedTask()functionCompute a ranking score for a blocked task. Higher score = more urgent = sort…
getDashboard()functionGet project dashboard data.
getCompletionHistory()functionGet completion history data.
filterByDate()functionFilter tasks by date range on archivedAt.
summaryReport()functionGenerate summary statistics.
byPhaseReport()functionGroup tasks by phase with cycle time averages.
byLabelReport()functionGroup tasks by label frequency.
byPriorityReport()functionGroup tasks by priority with cycle time averages.
cycleTimesReport()functionCompute cycle time statistics with distribution buckets.
trendsReport()functionCompute archive trends by day and month.
analyzeArchive()functionAnalyze archived tasks and produce a report. This is the primary entry point…
getArchiveStats()functionGet archive statistics.
auditData()functionAudit data integrity.
createBackup()functionCreate a backup of CLEO data files.
listSystemBackups()functionList all available system backups (snapshot, safety, migration types). Reads…
restoreBackup()functionRestore from a backup.
cleanupSystem()functionCleanup stale data (sessions, backups, logs).
writeJsonFileAtomic()functionWrite a JSON file atomically with backup rotation. Pattern: write temp - bac…
readJsonFile()functionRead a JSON file, returning parsed content or null if not found.
getDataPath()functionGet the path to a CLEO data file within a project root.
resolveProjectRoot()functionResolve the project root directory. Checks CLEO_ROOT env, then falls back to…
withLock()functionRead and write a JSON file with exclusive locking. Acquires a cross-process…
withFileLock()functionAcquire a file lock and execute an operation. Unlike withLock, this doesn’t r…
withMultiLock()functionAcquire locks on multiple files in correct order. Used for operations that ne…
isProjectInitialized()functionCheck if a CLEO project directory exists at the given path
listBackups()functionList backup files for a given data file
detectPlatform()functionDetect the current platform.
commandExists()functionCheck if a command exists on PATH.
requireTool()functionRequire a tool to be available, returning an error message if missing.
checkRequiredTools()functionCheck all required tools.
getIsoTimestamp()functionGet ISO 8601 UTC timestamp.
isoToEpoch()functionConvert ISO timestamp to epoch seconds.
dateDaysAgo()functionGet ISO date for N days ago.
getFileSize()functionGet file size in bytes.
getFileMtime()functionGet file modification time as ISO string.
generateRandomHex()functionGenerate N random hex characters.
sha256()functionCompute SHA-256 checksum of a string.
createTempFilePath()functionCreate a temporary file path.
getNodeVersionInfo()functionGet Node.js version info.
getNodeUpgradeInstructions()functionGet platform-specific Node.js upgrade instructions. Returns actionable instal…
getSystemInfo()functionGather a snapshot of the host system. This is the SSoT for system informatio…
checkCliInstallation()functionT4525
checkCliVersion()functionT4525
checkDocsAccessibility()functionT4525
checkAtReferenceResolution()functionT4525
checkAgentsMdHub()functionCheck that AGENTS.md exists in project root and contains the CAAMP:START mark…
checkRootGitignore()functionCheck if project root .gitignore is blocking the entire .cleo/ directory. Thi…
checkCleoGitignore()functionCheck if .cleo/.gitignore exists and matches the template. T4700
checkVitalFilesTracked()functionCheck that vital CLEO configuration files are tracked by git. Only checks con…
checkCoreFilesNotIgnored()functionCheck that core CLEO files are not being ignored by .gitignore. Uses…
checkSqliteNotTracked()functionCheck that SQLite databases (.cleo/tasks.db) are NOT tracked by project git…
checkLegacyAgentOutputs()functionCheck if any legacy output directories still exist. Delegates detection to th…
checkCaampMarkerIntegrity()functionVerify balanced CAAMP:START/END markers in CLAUDE.md and AGENTS.md. T5153
checkAtReferenceTargetExists()functionParse references from AGENTS.md CAAMP block and verify each target file exis…
checkTemplateFreshness()functionCompare templates/CLEO-INJECTION.md vs ~/.cleo/templates/CLEO-INJECTION.md…
checkTierMarkersPresent()functionVerify all 3 tier markers exist with matching close tags in deployed template…
checkNodeVersion()functionCheck that Node.js meets the minimum required version. Provides OS-specific u…
checkGlobalSchemaHealth()functionCheck that global schemas at ~/.cleo/schemas/ are installed and not stale. De…
checkNoLocalSchemas()functionWarn if deprecated .cleo/schemas/ directory still exists in the project. Sche…
checkJsonSchemaIntegrity()functionCheck that active JSON files (config.json, project-info.json, etc.) are valid…
runAllGlobalChecks()functionRun all global health checks and return results array. T4525
calculateHealthStatus()functionCalculate overall status from check results. Returns: 0=passed, 50=warning, 5…
getSystemHealth()functionRun system health checks (SQLite-first per ADR-006).
getSystemDiagnostics()functionRun extended diagnostics with fix suggestions.
coreDoctorReport()functionRun comprehensive doctor diagnostics combining dependency checks, directory c…
runDoctorFixes()functionRun auto-fix for failed doctor checks by calling the corresponding ensure* fu…
startupHealthCheck()functionUnified startup health check for CLI entry points. This is the single entry…
generateInjection()functionGenerate Minimum Viable Injection (MVI) markdown.
getLabels()functionGet all labels with counts and task IDs per label.
getSystemMetrics()functionGet system metrics: token usage, compliance summary, session counts.
getMigrationStatus()functionCheck/report schema migration status.
getRuntimeDiagnostics()function
safestop()functionSafe stop: signal clean shutdown for agents.
uncancelTask()functionUncancel a cancelled task (restore to pending).
parseIssueTemplates()functionParse all templates from the repo’s .github/ISSUE_TEMPLATE/ directory. Reads…
getTemplateForSubcommand()functionGet template config for a specific subcommand (bug/feature/help). Performs a…
generateTemplateConfig()functionGenerate and cache the config as .cleo/issue-templates.json. Performs a live…
validateLabels()functionValidate that labels exist on a GitHub repo. Compares the template labels ag…
getCurrentShell()functionDetect the current shell.
getRcFilePath()functionGet the RC file path for a shell.
detectAvailableShells()functionDetect which shells are available on the system.
generateBashAliases()functionGenerate bash/zsh alias content.
generatePowershellAliases()functionGenerate PowerShell alias content.
hasAliasBlock()functionCheck if aliases are already injected in a file.
getInstalledVersion()functionGet the installed alias version from an RC file.
injectAliases()functionInject aliases into a shell RC file.
removeAliases()functionRemove aliases from a shell RC file.
checkAliasesStatus()functionGet alias status for the current shell.
discoverReleaseTasks()functionDiscover task IDs for a release from completed tasks. Optionally filtered by…
groupTasksIntoSections()functionGroup tasks into changelog sections.
generateChangelogMarkdown()functionGenerate changelog markdown for a version.
formatChangelogJson()functionFormat changelog data as JSON.
writeChangelogFile()functionWrite changelog content to a file.
appendToChangelog()functionAppend a new release section to an existing CHANGELOG.md.
generateChangelog()functionFull changelog generation: discover tasks, group, generate, write.
parseCommandHeader()functionParse a ###CLEO header block from a script file.
scanAllCommands()functionScan a scripts directory and build a command registry. Returns a map of comma…
validateHeader()functionValidate a command header has required fields.
getCommandScriptMap()functionGet command-to-script mapping.
getCommandsByCategory()functionGroup commands by category.
getCommandsByRelevance()functionFilter commands by relevance level.
defaultFlags()functionDefault flag values.
parseCommonFlags()functionParse common CLI flags from an argument array. Returns flags and remaining po…
resolveFormat()functionResolve output format based on flags and TTY detection. Returns ‘json’ for no…
isJsonOutput()functionCheck if output should be JSON.
checkManifestEntry()functionVerify a manifest entry for a task has valid required fields. T4524
checkReturnFormat()functionCheck if a response matches the expected return format. T4524
scoreSubagentCompliance()functionCalculate comprehensive compliance score for a subagent. T4524
calculateTokenEfficiency()functionCalculate token efficiency metrics. T4524
calculateOrchestrationOverhead()functionCalculate orchestration overhead metrics. T4524
getScriptCommands()functionGet command names from scripts directory. Returns sorted list of script basen…
getIndexScripts()functionGet script names from COMMANDS-INDEX.json. T4527
getIndexCommands()functionGet command names from COMMANDS-INDEX.json. T4527
checkCommandsSync()functionCheck commands index vs scripts directory for sync. T4527
checkWrapperSync()functionCheck wrapper template sync with COMMANDS-INDEX. T4527
detectDrift()functionRun full drift detection across scripts, index, wrapper, and README. T4527
shouldRunDriftDetection()functionCheck if drift detection should run automatically based on config. T4527
getCacheFilePath()functionGet cache file path. T4525
initCacheFile()functionInitialize empty cache file. T4525
loadCache()functionLoad cache file or return null if missing/invalid. T4525
getFileHash()functionGet file hash for cache invalidation. T4525
getCachedValidation()functionCheck if project validation is cached and valid. Returns the cache entry if v…
cacheValidationResult()functionCache project validation results. T4525
clearProjectCache()functionClear cache for a specific project. T4525
clearEntireCache()functionClear entire cache. T4525
isTempProject()functionCheck if a project path is a temporary/test directory. T4525
categorizeProjects()functionFilter projects into categories: active, temp, orphaned. T4525
getProjectCategoryName()functionGet human-readable project category name. T4525
formatProjectHealthSummary()functionFormat project health summary for display. T4525
getProjectGuidance()functionGet actionable guidance for project issues. T4525
getUserJourneyStage()functionCheck user journey stage based on system state. T4525
getJourneyGuidance()functionGet journey-specific guidance text. T4525
sanitizeFilePath()functionSanitize a file path for safe shell usage. Prevents command injection via mal…
validateTitle()functionValidate a task title. Checks for emptiness, newlines, invisible characters,…
validateDescription()functionT4523
validateNote()functionT4523
validateBlockedBy()functionT4523
validateSessionNote()functionT4523
validateCancelReason()functionValidate a cancellation reason. T4523
validateStatusTransition()functionValidate that a status transition is allowed. T4523
isValidStatus()functionCheck if a status string is valid. T4523
checkTimestampSanity()functionCheck timestamp format and sanity. T4523
isMetadataOnlyUpdate()functionCheck if an update contains only metadata fields (safe for done tasks). T4523
normalizeLabels()functionDeduplicate and normalize labels. T4523
checkIdUniqueness()functionCheck ID uniqueness within and across files. T4523
validateTask()functionValidate a single task object. T4523
validateNoCircularDeps()functionCheck for circular dependencies using DFS. T4523
validateSingleActivePhase()functionValidate only one phase is active. T4523
validateCurrentPhaseConsistency()functionValidate currentPhase matches an active phase. T4523
validatePhaseTimestamps()functionValidate phase timestamp ordering. T4523
validatePhaseStatusRequirements()functionValidate phase status requirements (e.g., active phases must have startedAt)…
validateAll()functionRun all validation checks on a TaskFile. T4523
parseManifest()functionParse a manifest JSONL content string into entries. Skips invalid JSON lines gracefully…
findReviewDocs()functionFind documents in review status. T4524
extractTopics()functionExtract markdown headings from file content. T4524
searchCanonicalCoverage()functionSearch for topic coverage in a docs directory. Returns count of matching file…
analyzeCoverage()functionAnalyze documentation coverage for review documents. T4524
formatGapReport()functionFormat a gap report for human-readable display. T4524
findManifestEntry()functionFind a manifest entry for a task ID in a JSONL file. T4526
validateManifestEntry()functionRun validation on a manifest entry for a specific task. T4526
logRealCompliance()functionLog validation results to the compliance JSONL file. T4526
validateAndLog()functionFind, validate, and log compliance for a task in one call. T4526
checkOutputFileExists()functionCheck if expected output file exists. T4527
checkDocumentationSections()functionCheck if file contains required documentation sections. T4527
checkReturnMessageFormat()functionCheck if return message follows protocol format. Expected: ” . See MANIFEST.j…
checkManifestFieldPresent()functionCheck if manifest entry has a required field (non-null, non-empty). T4527
checkManifestFieldType()functionCheck if manifest field has expected type. T4527
checkKeyFindingsCount()functionCheck if key_findings array has valid count (3-7). T4527
checkStatusValid()functionCheck if status is valid enum value. T4527
checkAgentType()functionCheck if agent_type matches expected value. T4527
checkLinkedTasksPresent()functionCheck if linked_tasks array contains required task IDs. T4527
checkProvenanceTags()functionCheck if file contains provenance tag. T4527
validateCommonManifestRequirements()functionValidate common manifest requirements across all protocols. When protocolTyp…
isValidGateName()functionT4526
isValidAgentName()functionT4526
getGateOrder()functionT4526
getGateIndex()functionT4526
getDownstreamGates()functionT4526
initVerification()functionInitialize a new verification object with default values. T4526
computePassed()functionCompute whether verification has passed based on required gates. T4526
setVerificationPassed()functionUpdate the passed field on a verification object. T4526
updateGate()functionUpdate a single gate value. T4526
resetDownstreamGates()functionReset all downstream gates to null after a gate failure. T4526
incrementRound()functionIncrement the round counter. Returns null if max rounds exceeded. T4526
logFailure()functionLog a failure to the failureLog array. T4526
checkAllGatesPassed()functionCheck if all required gates have passed. T4526
isVerificationComplete()functionCheck if verification is complete (passed = true). T4526
getVerificationStatus()functionGet verification status for display. T4526
shouldRequireVerification()functionCheck if a task type should require verification. T4526
getMissingGates()functionGet gate names that are not yet true. T4526
getGateSummary()functionGet gate summary for display. T4526
checkCircularValidation()functionCheck for circular validation (self-approval prevention). Prevents: creator v…
allEpicChildrenVerified()functionCheck if all children of an epic have verification.passed = true. T4526
allSiblingsVerified()functionCheck if all siblings of a task are verified. T4526
getProjectInfo()functionRead project-info.json and return a typed ProjectInfo. Falls back gracefully…
getProjectInfoSync()functionSynchronous variant for use in hot paths where async is not feasible. Returns…
updateProjectName()functionUpdate the project name in project-info.json. Used by cleo upgrade --name a…
generateAcFromDescription()functionGenerate 3 baseline acceptance criteria from a task description. Uses simple…
backfillTasks()functionRetroactively populate AC and verification metadata for tasks that lack them.
ProtocolEnforcerclassMain protocol enforcement class
getHookCapableProviders()functionGet all providers that support a specific hook event
getSharedHookEvents()functionGet hook events supported by all specified providers
toNativeHookEvent()functionTranslate a canonical hook event to a provider-native event name.
toCanonicalHookEvent()functionTranslate a provider-native event name back to its canonical equivalent.
providerSupportsHookEvent()functionCheck if a provider supports a specific canonical hook event.
validateChainShape()functionValidate the topology/DAG of a chain shape. Checks: - All link source/target…
validateGateSatisfiability()functionValidate that all gates in a chain reference valid stages and gate names. Ch…
validateChain()functionValidate a complete WarpChain definition. Orchestrates shape validation and…
addChain()functionStore a validated WarpChain definition. Validates the chain before storing…
showChain()functionRetrieve a WarpChain definition by ID. T5403
listChains()functionList all stored WarpChain definitions. T5403
findChains()functionFind WarpChain definitions by criteria. T5403
createInstance()functionCreate a chain instance binding a chain to an epic. T5403
showInstance()functionRetrieve a chain instance by ID. T5403
listInstanceGateResults()functionRead persisted gate results for a chain instance.
advanceInstance()functionAdvance a chain instance to the next stage, recording gate results. T5403
validateResearchProtocol()functionT4499
validateConsensusProtocol()functionT4499
validateSpecificationProtocol()functionT4499
validateDecompositionProtocol()functionT4499
validateImplementationProtocol()functionT4499
validateContributionProtocol()functionT4499
validateReleaseProtocol()functionT4499
validateArtifactPublishProtocol()functionT4499
validateProvenanceProtocol()functionT4499
validateArchitectureDecisionProtocol()functionValidate an Architecture Decision Record manifest entry. Enforces the 8 MUST…
validateValidationProtocol()functionValidate a manifest entry against the validation stage protocol. Enforces VA…
validateTestingProtocol()functionValidate a manifest entry against the testing protocol. This validator is **…
validateProtocol()functionValidate a manifest entry against a specific protocol. Throws CleoError with…
buildDefaultChain()functionBuild the canonical 9-stage RCASD-IVTR+C WarpChain. - Each PIPELINE_STAGE be…
buildDefaultTessera()functionBuild the default RCASD Tessera template. Wraps buildDefaultChain() with tem…
instantiateTessera()functionInstantiate a Tessera template into a concrete WarpChainInstance. Steps: 1…
listTesseraTemplates()functionList all registered Tessera templates. T5409
showTessera()functionFind a Tessera template by ID. T5409
runBrainMaintenance()functionRun a combined brain maintenance pass: decay, consolidation, and embeddings…
migrateClaudeMem()functionMigrate observations from claude-mem’s SQLite database into CLEO brain.db. R…
reasonWhy()functionBuild a causal trace for why a task is blocked. Walks upstream through…
reasonSimilar()functionFind entries similar to a given brain.db entry. 1. Loads the source entry’s…
memoryShow()functionLook up a brain.db entry by ID.
memoryBrainStats()functionAggregate stats from brain.db across all tables.
memoryDecisionFind()functionSearch decisions in brain.db.
memoryDecisionStore()functionStore a decision to brain.db.
memoryFind()functionToken-efficient brain search returning compact results.
memoryTimeline()functionChronological context around a brain entry anchor.
memoryFetch()functionBatch fetch brain entries by IDs.
memoryObserve()functionSave an observation to brain.db.
memoryPatternStore()functionStore a pattern to BRAIN memory.
memoryPatternFind()functionSearch patterns in BRAIN memory.
memoryPatternStats()functionGet pattern memory statistics.
memoryLearningStore()functionStore a learning to BRAIN memory.
memoryLearningFind()functionSearch learnings in BRAIN memory.
memoryLearningStats()functionGet learning memory statistics.
memoryContradictions()functionFind contradictory entries in brain.db.
memorySuperseded()functionFind superseded entries in brain.db. Identifies entries that have been super…
memoryLink()functionLink a brain entry to a task.
memoryUnlink()functionRemove a link between a brain entry and a task.
memoryGraphAdd()functionAdd a node or edge to the PageIndex graph.
memoryGraphShow()functionGet a node and its edges from the PageIndex graph.
memoryGraphNeighbors()functionGet neighbor nodes from the PageIndex graph.
memoryReasonWhy()functionCausal trace through task dependency chains.
memoryReasonSimilar()functionFind semantically similar entries.
memorySearchHybrid()functionHybrid search across FTS5, vector, and graph.
memoryGraphRemove()functionRemove a node or edge from the PageIndex graph.
pipelineManifestShow()functionpipeline.manifest.show - Get manifest entry details by ID
pipelineManifestList()functionpipeline.manifest.list - List manifest entries with filters
pipelineManifestFind()functionpipeline.manifest.find - Find manifest entries by text (LIKE search on conten…
pipelineManifestPending()functionpipeline.manifest.pending - Get pending manifest items
pipelineManifestStats()functionpipeline.manifest.stats - Manifest statistics
pipelineManifestRead()functionpipeline.manifest.read - Read manifest entries with optional filter
pipelineManifestAppend()functionpipeline.manifest.append - Append entry to pipeline_manifest table
pipelineManifestArchive()functionpipeline.manifest.archive - Archive old manifest entries by date
pipelineManifestCompact()functionpipeline.manifest.compact - Dedup by contentHash (keep newest by createdAt)
pipelineManifestValidate()functionpipeline.manifest.validate - Validate manifest entries for a task
pipelineManifestContradictions()functionpipeline.manifest.contradictions - Find entries with overlapping topics but c…
pipelineManifestSuperseded()functionpipeline.manifest.superseded - Identify entries replaced by newer work on sam…
pipelineManifestLink()functionpipeline.manifest.link - Link manifest entry to a task
readManifestEntries()functionRead all manifest entries from the pipeline_manifest table. Replaces readMani…
filterEntries()functionFilter manifest entries by criteria (alias for backward compatibility).
distillManifestEntry()functionDistill a manifest entry to brain.db observation (Phase 3, pending).
migrateManifestJsonlToSqlite()functionMigrate existing legacy flat-file entries into the pipeline_manifest table…
resolveProviderFromModelIndex()function
resolveProviderFromModelRegistry()function
resetModelsDevCache()function
measureTokenExchange()function
recordTokenExchange()function
showTokenUsage()function
listTokenUsage()function
summarizeTokenUsage()function
deleteTokenUsage()function
clearTokenUsage()function
autoRecordDispatchTokenUsage()function
getLatestTokenRecord()function
getTokenUsageAggregateSql()function
startParallelExecution()functionStart parallel execution for a wave.
endParallelExecution()functionEnd parallel execution for a wave.
getParallelStatus()functionGet current parallel execution state.
listSkills()functionList available skills from canonical and project-local directories.
getSkillContent()functionRead skill content for injection into agent context. Checks project-local ski…
getUnblockOpportunities()functionAnalyze dependency graph for unblocking opportunities.
validateSpawnReadiness()functionValidate spawn readiness for a task.
injectContext()functionRead protocol injection content for a given protocol type. Core logic for ses…
generateSessionId()functionGenerate a canonical session ID. Format: ses_YYYYMMDDHHmmss_6hex Example: se…
isValidSessionId()functionCheck if a string is a valid session ID (any format).
isCanonicalSessionId()functionCheck if a session ID uses the canonical format.
extractSessionTimestamp()functionExtract an approximate timestamp from any valid session ID format. Returns nu…
createSession()functionCreate a new session.
getSession()functionGet a session by ID.
updateSession()functionUpdate a session.
listSessions()functionList sessions with optional filters.
endSession()functionEnd a session.
startTask()functionStart working on a task within a session.
getCurrentTask()functionGet current task for a session.
stopTask()functionStop working on the current task for a session.
workHistory()functionGet work history for a session.
gcSessions()functionGarbage collect old sessions (mark ended sessions as orphaned after threshold).
getActiveSession()functionGet the currently active session (if any).
suggestRelated()functionSuggest related tasks based on shared attributes.
addRelation()functionAdd a relation between tasks.
discoverRelated()functionDiscover related tasks using various methods.
listRelations()functionList existing relations for a task.
canCancel()functionCheck if a task can be cancelled.
cancelTask()functionCancel a task in the tasks array (returns updated array). Does NOT handle chi…
cancelMultiple()functionBatch cancel multiple tasks.
coreTaskNext()functionSuggest next task to work on based on priority, phase, age, and deps.
coreTaskBlockers()functionShow blocked tasks and analyze blocking chains.
coreTaskTree()functionBuild hierarchy tree for tasks.
coreTaskDeps()functionShow dependencies for a task.
coreTaskRelates()functionShow task relations.
coreTaskRelatesAdd()functionAdd a relation between two tasks.
coreTaskAnalyze()functionAnalyze tasks for priority and leverage.
coreTaskRestore()functionRestore a cancelled task back to pending.
coreTaskCancel()functionCancel a task (sets status to ‘cancelled’, a soft terminal state). Use restor…
coreTaskUnarchive()functionMove an archived task back to active tasks.
coreTaskReorder()functionChange task position within its sibling group.
coreTaskReparent()functionMove task under a different parent.
coreTaskPromote()functionPromote a subtask to task or task to root.
coreTaskReopen()functionReopen a completed task.
coreTaskComplexityEstimate()functionDeterministic complexity scoring from task metadata.
coreTaskDepsOverview()functionOverview of all dependencies across the project.
coreTaskDepsCycles()functionDetect circular dependencies across the project.
coreTaskDepends()functionList dependencies for a task in a given direction.
coreTaskStats()functionCompute task statistics.
coreTaskExport()functionExport tasks as JSON or CSV.
coreTaskHistory()functionGet task history from the audit log.
coreTaskLint()functionLint tasks for common issues.
coreTaskBatchValidate()functionValidate multiple tasks at once.
coreTaskImport()functionImport tasks from a JSON source string.
analyzeTaskPriority()functionAnalyze task priority with leverage scoring.
listLabels()functionList all labels with task counts.
showLabelTasks()functionShow tasks with a specific label.
getLabelStats()functionGet detailed label statistics.
createStoreProvider()functionCreate a store provider. Always creates SQLite provider (ADR-006). T4647
getStore()functionGet a StoreProvider instance for the given working directory. Convenience wra…
countJsonRecords()functionCount records in JSON source files.
migrateJsonToSqliteAtomic()functionMigrate JSON data to SQLite with atomic rename pattern. Writes to a temporary…
migrateJsonToSqlite()function
exportToJson()functionExport SQLite data back to JSON format (for inspection or emergency recovery).
repairMissingSizes()functionSet size=‘medium’ on tasks that have no size value. Operates directly on the…
repairMissingCompletedAt()functionSet completedAt=now() on done/cancelled tasks that are missing a completedAt…
repairMissingColumns()functionDetect and add missing required columns on the tasks table. Uses PRAGMA table…
runAllRepairs()functionRun all repair functions. Returns all actions taken (or previewed in dry-run…
runUpgrade()functionRun a full upgrade pass on the project .cleo/ directory. Steps: 1. Pre-fli…
diagnoseUpgrade()functionDeep diagnostic inspection of schema and migration state. Unlike bare…
VerificationGateclassMain Verification Gate class Orchestrates 4-layer validation and determines…
createVerificationGate()functionFactory function for creating verification gates
WorkflowGateTrackerclassWorkflowGateTracker Tracks the status of all 6 workflow verification gates f…
isValidWorkflowGateName()functionValidate a workflow gate name string
getWorkflowGateDefinition()functionGet the definition for a workflow gate
validateLayer1Schema()functionLayer 1: Schema Validation Validates operation parameters against JSON Schem…
validateLayer2Semantic()functionLayer 2: Semantic Validation Validates business rules and logical constraints.
validateLayer3Referential()functionLayer 3: Referential Validation Validates cross-entity references and relati…
validateLayer4Protocol()functionLayer 4: Protocol Validation Validates RCASD-IVTR+C lifecycle compliance and…
isFieldRequired()functionHelper to check if a field is required for an operation
validateWorkflowGateName()functionValidate a workflow gate name T3141
validateWorkflowGateStatus()functionValidate a workflow gate status value per Section 7.3 T3141
validateWorkflowGateUpdate()functionValidate a gate update operation. T3141
buildMcpInputSchema()functionBuild a JSON Schema input_schema object from an OperationDef. Algorithm:…
buildCommanderArgs()functionSplit OperationDef.params into positional arguments and option flags, suita…
buildCommanderOptionString()functionBuild the Commander option string for a single non-positional ParamDef. Exam…
camelToKebab()functionConvert a camelCase string to kebab-case. e.g. ‘includeArchive’ → ‘include-ar…
validateRequiredParamsDef()functionValidates that all required parameters are present in the request. Returns an…
findManifestEntry()functionLocate the manifest line for a given task ID, reading from the end of the fil…
loadManifestEntryByTaskId()functionLoad a manifest entry by task ID from the canonical manifest file. T260
loadManifestEntryFromFile()functionLoad a manifest entry from an arbitrary JSON file (used by the manifest dis…
throwIfStrictFailed()functionThrow a CleoError with the protocol’s canonical exit code when strict validat…
validateArchitectureDecisionTask()functionValidate architecture-decision protocol for a task.
checkArchitectureDecisionManifest()functionValidate architecture-decision protocol from a manifest file.
validateArtifactPublishTask()functionValidate artifact-publish protocol for a task.
checkArtifactPublishManifest()functionValidate artifact-publish protocol from a manifest file.
validateConsensusTask()functionValidate consensus protocol for a task.
checkConsensusManifest()functionValidate consensus protocol from a manifest file.
validateContributionTask()functionValidate contribution protocol for a task.
checkContributionManifest()functionValidate contribution protocol from a manifest file.
validateDecompositionTask()functionValidate decomposition protocol for a task.
checkDecompositionManifest()functionValidate decomposition protocol from a manifest file.
validateImplementationTask()functionValidate implementation protocol for a task.
checkImplementationManifest()functionValidate implementation protocol from a manifest file.
validateProvenanceTask()functionValidate provenance protocol for a task.
checkProvenanceManifest()functionValidate provenance protocol from a manifest file.
validateReleaseTask()functionValidate release protocol for a task.
checkReleaseManifest()functionValidate release protocol from a manifest file.
validateResearchTask()functionValidate research protocol for a task.
checkResearchManifest()functionValidate research protocol from a manifest file.
validateSpecificationTask()functionValidate specification protocol for a task.
checkSpecificationManifest()functionValidate specification protocol from a manifest file.
validateTestingTask()functionValidate testing protocol for a task.
checkTestingManifest()functionValidate testing protocol from a manifest file.
validateValidationTask()functionValidate validation-stage protocol for a task.
checkValidationManifest()functionValidate validation-stage protocol from a manifest file.
validateSchema()functionValidate data against a CLEO schema
validateTask()functionValidate a single task object against the drizzle-zod insert schema. Uses dri…
clearSchemaCache()functionClear the schema cache (useful for testing)
coreValidateReport()functionRun comprehensive validation report on tasks database — checks business rules…
coreValidateAndFix()functionRun validation report, then apply data repairs for fixable issues. Calls runA…
coreValidateSchema()functionValidate data against a schema type. For SQLite-backed types (todo, archive,…
coreValidateTask()functionValidate a single task against anti-hallucination rules. T4786
coreValidateProtocol()functionCheck basic protocol compliance for a task. T4786
coreValidateManifest()functionValidate manifest JSONL entries for required fields. T4786
coreValidateOutput()functionValidate an output file for required sections. T4786
coreComplianceSummary()functionGet aggregated compliance metrics. T4786
coreComplianceViolations()functionList compliance violations. T4786
coreComplianceRecord()functionRecord a compliance check result to COMPLIANCE.jsonl. T4786
coreTestStatus()functionCheck test suite availability. T4786
coreCoherenceCheck()functionCross-validate task graph for consistency. T4786
coreTestRun()functionExecute test suite via subprocess. T4786
coreBatchValidate()functionBatch validate all tasks against schema and rules. T4786
coreTestCoverage()functionGet test coverage metrics. T4786
buildBrainState()functionBuild brain state for agent bootstrapping.
getCriticalPath()functionFind the critical path (longest dependency chain) in the task graph.
resolveSkillPathsForProvider()functionGet effective skill paths for a provider considering precedence
getProvidersWithPrecedence()functionGet all providers that use a specific precedence mode
getSkillsMapWithPrecedence()functionBuild complete skills map with precedence information
determineInstallationTargets()functionDetermine target installation paths for a skill
supportsAgentsPath()functionCheck if provider supports agents path
coreTaskPlan()functionBuild composite planning view. T4914
encrypt()functionEncrypt a plaintext string using AES-256-GCM with a per-project key. Output…
decrypt()functionDecrypt a base64-encoded ciphertext using AES-256-GCM with a per-project key.
AgentRegistryAccessorclasssignaldock.db implementation of the AgentRegistryAPI.
buildIndex()functionScan .cleo/rcasd/ and legacy .cleo/rcsd/ directories and build the RCASD inde…
writeIndex()functionWrite RCASD-INDEX.json to disk.
readIndex()functionRead RCASD-INDEX.json from disk.
rebuildIndex()functionRebuild and write the index from current disk state.
getTaskAnchor()functionGet task anchor by task ID.
findByStage()functionFind tasks by pipeline stage.
findByStatus()functionFind tasks by status.
getIndexTotals()functionGet index summary statistics.
ApprovalManagerclassManages approval tokens for CANT workflow gates. Tokens are stored in-memory…
createScope()functionCreates a new root execution scope with initial variable bindings.
createChildScope()functionCreates a child scope that inherits from a parent. Lookups in the child scop…
resolveVariable()functionResolves a variable name in the scope chain. Searches the current scope firs…
setVariable()functionSets a variable in the current scope (does not affect parent scopes).
resolveTemplate()functionResolves {variable} placeholders in a template string against the scope. P…
mergeStepOutput()functionMerges step output into the current scope. Binds <stepName>.stdout,…
flattenScope()functionCollects all variable bindings visible from the given scope (including parent…
DefaultDiscretionEvaluatorclassDefault discretion evaluator that always returns true. This is a stub impl…
MockDiscretionEvaluatorclassMock discretion evaluator with configurable responses for testing. Responses…
RateLimitedDiscretionEvaluatorclassWraps a discretion evaluator with rate limiting. Enforces a configurable max…
executeParallel()functionExecutes parallel arms according to the specified join strategy.
WorkflowExecutorclassExecutes CANT workflow definitions. The executor processes each statement in…
generateCodebaseMapSummary()function
sequenceChains()functionSequence two chains: connect A’s exit points to B’s entry point. B’s stage I…
parallelChains()functionCompose chains in parallel with a common fork entry and join stage. Creates…
resolveEpicFromContent()functionExtract an epic/task ID from file content by searching for: 1…
resolveEpicFromFilename()functionExtract an epic ID from a filename pattern like T####-* or T####_*.
normalizeDirectoryNames()functionRename suffixed epic directories (e.g. T4881_install-channelsT4881).
migrateConsensusFiles()functionMigrate .cleo/consensus/ files to appropriate epic’s consensus/ subdirector…
migrateContributionFiles()functionMigrate .cleo/contributions/ files to appropriate epic’s contributions/ sub…
migrateLooseFiles()functionMigrate loose T####_*.md files from .cleo/rcasd/ root into…
consolidateRcasd()functionConsolidate all provenance files into the unified .cleo/rcasd/{epicId}/ str…
findResumablePipelines()functionQuery active pipelines that can be resumed. Searches the lifecycle_pipelines…
loadPipelineContext()functionLoad complete pipeline context for session resume. Uses SQL JOINs to efficie…
resumeStage()functionResume a specific stage in a pipeline. Updates the stage status from ‘blocke…
autoResume()functionAuto-detect where to resume across all active pipelines. Finds the best cand…
checkSessionResume()functionCheck for resumable work on session start. Integrates with session initializ…
formatResumeSummary()functionGet resume summary for display to user. Formats resumable pipelines into a h…
handleCompletedStage()functionHandle completed stage edge case. If the current stage is completed, suggest…
handleBlockedStage()functionHandle blocked stage edge case. Provides information about why a stage is bl…
checkBlockedStageDetails()functionHandle blocked stage edge case - async version with database lookup.
checkPrerequisites()functionCheck if prerequisites are met for a stage. Validates that all prerequisite…
validateTransition()functionValidate a stage transition. Comprehensive validation that checks both trans…
executeTransition()functionExecute a state transition. Applies the transition to the state machine cont…
setStageStatus()functionSet the status of a stage. Updates stage status with validation of allowed s…
getStageStatus()functionGet the status of a stage.
isValidStatusTransition()functionCheck if a status transition is valid. State transitions: not_started → in…
createInitialContext()functionCreate initial state machine context for a pipeline.
getValidNextStages()functionGet stages that can be transitioned to from the current stage.
getCurrentStageState()functionGet the current stage state.
isTerminalState()functionCheck if the pipeline is in a terminal state.
isBlocked()functionCheck if the pipeline is blocked.
validateTransitions()functionValidate multiple transitions.
canSkipStage()functionCheck if a stage can be skipped.
skipStage()functionSkip a stage with validation.
EmbeddingQueueclassSingleton embedding queue. Batches embedding requests and processes them via…
getEmbeddingQueue()functionGet or create the shared EmbeddingQueue singleton. Registers a process…
resetEmbeddingQueue()functionReset the singleton (for testing only). Shuts down the existing queue before…
getContextStatusFromPercentage()functionDetermine status from percentage.
processContextInput()functionProcess context window input and write state file. Returns the status line st…
isHITLEnabled()functionCheck if HITL warnings are enabled.
generateHITLWarnings()functionGenerate HITL warnings based on lock state.
getHighestLevel()functionGet highest warning level from warnings.
getConcurrencyJson()functionGet concurrency data for analyze JSON output.
checkStatuslineIntegration()functionCheck if statusline integration is configured. Returns the current integratio…
getStatuslineConfig()functionGet the statusline setup command for Claude Code settings.
getSetupInstructions()functionGet human-readable setup instructions.
getPreferredChannel()functionLook up the preferred channel for a given domain + operation. Reads from the…
getRoutingForDomain()functionGet routing entries for a specific domain. Derives entries from the capabili…
getOperationsByChannel()functionGet all operations that prefer a specific channel. Derives entries from the…
generateMemoryProtocol()functionGenerate dynamic memory protocol instructions based on provider capabilities.
generateRoutingGuide()functionGenerate a dynamic routing guide based on operation preferences.
generateDynamicSkillContent()functionGenerate complete dynamic skill content for the current provider.
TaskCacheclassIn-memory cache for task indices with checksum-based staleness detection.
extractPackageMeta()functionExtract package metadata from an export file. T4552
logImportStart()functionLog import operation start with package metadata. T4552
logImportSuccess()functionLog import operation completion with full metadata. T4552
logImportError()functionLog import operation error with diagnostic details. T4552
logImportConflict()functionLog import conflict detection and resolution. T4552
topologicalSortTasks()functionTopological sort for task import order using Kahn’s algorithm. Ensures tasks…
detectCycles()functionDetect cycles in task dependency graph. Returns true if no cycles, false if c…
findActivePipelinesWithStagesAndTasks()functionFind active pipelines joined with their stages and tasks. Optionally filters…
findPipelineWithCurrentStageAndTask()functionFind a pipeline with its current stage and task by taskId. Matches stages whe…
findPipelineWithStage()functionFind a pipeline and a specific stage by taskId and stageName.
updatePipelineCurrentStage()functionUpdate pipeline’s currentStageId.
getStagesByPipelineId()functionGet all stages for a pipeline, ordered by sequence.
activateStage()functionUpdate a stage’s status to ‘in_progress’ and clear block fields.
findPipelineWithCurrentStage()functionFind pipeline with current stage (no task join) by taskId. Used by checkBlock…
getGateResultsByStageId()functionGet gate results for a stage, ordered by checkedAt descending.
getGateResultsByStageIdUnordered()functionGet gate results for a stage without ordering (for simple checks).
getEvidenceByStageId()functionGet evidence for a stage, ordered by recordedAt descending.
getRecentTransitions()functionGet recent transitions for a pipeline, ordered by createdAt descending.
insertTransition()functionInsert a new transition record.
checkAtomicity()functionCheck task atomicity using 6-point heuristic test. Default threshold: 4 (pass…
extractTaskRefs()functionExtract task IDs from text content. Scans for patterns like T1234, T001, T42…
createRelatesEntries()functionCreate relates entries from extracted task IDs.
mergeRelatesArrays()functionMerge new relates entries with existing ones. Existing entries take precedenc…
validateRelatesRefs()functionValidate that referenced task IDs exist. Returns array of invalid (non-existe…
extractAndCreateRelates()functionConvenience: extract task refs from text and create relates entries.
calculateAffectedTasks()functionCalculate which tasks would be affected by a delete operation.
calculateImpact()functionCalculate impact of deletion.
generateWarnings()functionGenerate warnings based on impact analysis.
previewDelete()functionMain preview function - coordinates all preview calculations.
isValidStrategy()functionValidate a strategy name.
handleChildren()functionHandle children using the specified strategy. Returns the modified tasks arra…
GraphCacheclassGraph cache for expensive dependency calculations. Automatically invalidates…
discoverByLabels()functionDiscover related tasks by shared labels.
discoverByDescription()functionDiscover related tasks by description similarity (keyword-based Jaccard).
discoverByFiles()functionDiscover related tasks by shared files.
discoverByHierarchy()functionDiscover related tasks by hierarchical proximity (siblings and cousins).
discoverRelatedTasks()functionDiscover related tasks using all methods combined.
suggestRelates()functionSuggest relates entries filtered by threshold.
getCurrentPhase()functionGet the current active phase from project metadata.
getTasksByPhase()functionGet tasks belonging to a specific phase.
calculatePhaseProgress()functionCalculate progress for a phase.
getAllPhaseProgress()functionGet progress for all phases.
validatePhaseTransition()function
createPhaseTransition()functionCreate a phase transition record.
applyPhaseTransition()functionApply a phase transition to project metadata. Returns updated project data.
getNextPhase()functionGet the next phase in order.
allPhasesComplete()functionCheck if all phases are complete.
getSizeWeight()functionGet weight for a task size.
getPriorityWeight()functionGet weight for a task priority.
calculateTaskScore()functionCalculate a composite score for task ordering. Higher score = should be worke…
sortByWeight()functionSort tasks by weighted score (highest first).
calculateTotalEffort()functionCalculate total weighted effort for a set of tasks.
calculateWeightedProgress()functionCalculate completion percentage by weight.
calculateRemainingEffort()functionEstimate remaining effort (weighted sum of non-complete tasks).
getLastActivity()functionGet the most recent activity timestamp for a task.
classifyStaleness()functionClassify staleness level for a task.
getStalenessInfo()functionGet staleness info for a single task.
findStaleTasks()functionFind all stale tasks (stale, critical, or abandoned).
getStalenessSummary()function

Types & Interfaces

SymbolKindDescription
LoggerConfiginterface
PlatformPathsinterfaceOS-appropriate paths for CLEO’s global directories.
SystemInfointerfaceImmutable system information snapshot, captured once per process.
RequiredColumninterfaceRequired column definition for ensureColumns().
VacuumOptionsinterface
AgentInstanceRowtype
NewAgentInstanceRowtype
AgentErrorLogRowtype
NewAgentErrorLogRowtype
AgentInstanceStatustype
AgentTypetype
AgentErrorTypetype
WarpChainRowtype
NewWarpChainRowtype
WarpChainInstanceRowtype
NewWarpChainInstanceRowtype
StatusRegistryRowtype
TaskRowtype
NewTaskRowtype
SessionRowtype
NewSessionRowtype
TaskDependencyRowtype
TaskRelationRowtype
WorkHistoryRowtype
LifecyclePipelineRowtype
NewLifecyclePipelineRowtype
LifecycleStageRowtype
NewLifecycleStageRowtype
LifecycleGateResultRowtype
NewLifecycleGateResultRowtype
LifecycleEvidenceRowtype
NewLifecycleEvidenceRowtype
LifecycleTransitionRowtype
NewLifecycleTransitionRowtype
AuditLogRowtype
NewAuditLogRowtype
TokenUsageRowtype
NewTokenUsageRowtype
ArchitectureDecisionRowtype
NewArchitectureDecisionRowtype
AdrTaskLinkRowtype
NewAdrTaskLinkRowtype
AdrRelationRowtype
NewAdrRelationRowtype
ManifestEntryRowtype
NewManifestEntryRowtype
PipelineManifestRowtype
NewPipelineManifestRowtype
ReleaseManifestRowtype
NewReleaseManifestRowtype
ExternalTaskLinkRowtype
NewExternalTaskLinkRowtype
BrainDecisionRowtype
NewBrainDecisionRowtype
BrainPatternRowtype
NewBrainPatternRowtype
BrainLearningRowtype
NewBrainLearningRowtype
BrainObservationRowtype
NewBrainObservationRowtype
BrainMemoryLinkRowtype
NewBrainMemoryLinkRowtype
BrainPageNodeRowtype
NewBrainPageNodeRowtype
BrainPageEdgeRowtype
NewBrainPageEdgeRowtype
BrainStickyNoteRowtype
NewBrainStickyNoteRowtype
ProjectRegistryRowtype
NewProjectRegistryRowtype
NexusAuditLogRowtype
NewNexusAuditLogRowtype
NexusSchemaMetaRowtype
NewNexusSchemaMetaRowtype
ErrorDefinitioninterfaceA single entry in the unified error catalog.
ProblemDetailsinterfaceRFC 9457 Problem Details object. Structured error representation for API resp…
ArchiveFieldsinterfaceArchive-specific fields for task upsert.
RegisterAgentOptionsinterfaceOptions for registering a new agent instance.
UpdateStatusOptionsinterfaceOptions for updating agent status.
ListAgentFiltersinterfaceFilters for listing agent instances.
AgentHealthReportinterfaceAgent health report summary.
AtomicMigrationResultinterfaceAtomic database migration result.
ReleaseFntypeA release function returned by acquireLock.
ProviderHookEventtypeCAAMP canonical hook event type. This is the normalized 16-event taxonomy fr…
InternalHookEventtype
HookEventtypeFull CLEO hook event union. CAAMP defines provider-facing canonical events;…
HookPayloadinterfaceBase interface for all hook payloads Provides common fields available across…
SessionStartPayloadinterfacePayload for SessionStart hook (canonical: was onSessionStart) Fired when a CL…
OnSessionStartPayloadtype
SessionEndPayloadinterfacePayload for SessionEnd hook (canonical: was onSessionEnd) Fired when a CLEO s…
OnSessionEndPayloadtype
PreToolUsePayloadinterfacePayload for PreToolUse hook (canonical: was onToolStart) Fired when a task/to…
OnToolStartPayloadtype
PostToolUsePayloadinterfacePayload for PostToolUse hook (canonical: was onToolComplete) Fired when a tas…
OnToolCompletePayloadtype
HookHandlertypeHandler function type for hook events Handlers receive project root and typed…
HookRegistrationinterfaceHook registration metadata Tracks registered handlers with priority and event…
HookConfiginterfaceConfiguration for the hook system Controls which events are enabled/disabled
NotificationPayloadinterfacePayload for Notification hook (canonical: was onFileChange) Fired when a trac…
OnFileChangePayloadtype
PostToolUseFailurePayloadinterfacePayload for PostToolUseFailure hook (canonical: was onError) Fired when an op…
OnErrorPayloadtype
PromptSubmitPayloadinterfacePayload for PromptSubmit hook (canonical: was onPromptSubmit) Fired when an a…
OnPromptSubmitPayloadtype
ResponseCompletePayloadinterfacePayload for ResponseComplete hook (canonical: was onResponseComplete) Fired w…
OnResponseCompletePayloadtype
SubagentStartPayloadinterfacePayload for SubagentStart hook Fired when a subagent process is launched
SubagentStopPayloadinterfacePayload for SubagentStop hook Fired when a subagent process completes
PreCompactPayloadinterfacePayload for PreCompact hook Fired before context compaction begins
PostCompactPayloadinterfacePayload for PostCompact hook Fired after context compaction completes
ConfigChangePayloadinterfacePayload for ConfigChange hook Fired when configuration is updated
OnWorkAvailablePayloadinterfacePayload for onWorkAvailable hook Fired when the system detects ready work on…
OnAgentSpawnPayloadinterfacePayload for onAgentSpawn hook Fired when a worker session/process is launched
OnAgentCompletePayloadinterfacePayload for onAgentComplete hook Fired when a worker finishes its assigned run
OnCascadeStartPayloadinterfacePayload for onCascadeStart hook Fired when autonomous execution begins flowin…
OnPatrolPayloadinterfacePayload for onPatrol hook Fired when a watcher performs a periodic health/swe…
CLEOLifecycleEventtypeType for CLEO lifecycle event names These are the internal events CLEO fires…
CLEOAutonomousLifecycleEventtypeType for autonomous CLEO lifecycle events.
SaveJsonOptionsinterfaceOptions for saveJson.
CheckpointConfiginterfaceCheckpoint configuration.
CheckpointStatusinterfaceCheckpoint status information.
ChangedFileinterfaceChanged file with its status.
SafetyOptionsinterfaceSafety configuration - can be overridden per-operation
RepairResultinterfaceRepair result with proper typing.
SafetyConfiginterfaceSafety configuration options.
NextDirectivestypeMap of follow-up operation names to CLI command strings.
TaskDetailinterfaceEnriched task with hierarchy info.
PaginateInputinterfaceInput parameters for paginating a result set. T4668 T4663
CompactTaskinterfaceCompact task representation — minimal fields for list responses.
ListTasksOptionsinterfaceFilter options for listing tasks.
ListTasksResultinterfaceResult of listing tasks.
FindResultinterfaceMinimal task info for search results.
FindTasksOptionsinterfaceOptions for finding tasks.
FindTasksResultinterfaceResult of finding tasks.
AdrFrontmatterinterfaceParsed ADR frontmatter from .md file
AdrRecordinterface
AdrSyncResultinterface
AdrListResultinterface
AdrFindResultinterface
PipelineAdrLinkResultinterface
EvidenceTypetype
EvidenceRecordinterface
RelatedLinkinterfaceRelated link in frontmatter.
FrontmatterMetadatainterfaceFrontmatter metadata for an RCASD artifact.
ParsedFrontmatterinterfaceResult of parsing frontmatter from a markdown file.
StagetypeStage type derived from canonical stage list. T4800
StageCategorytypeStage category for grouping related stages. T4800
StageDefinitioninterfaceStage metadata with descriptive information. T4800
TransitionRuleinterfaceTransition rule - defines if a transition is allowed. T4800
StageArtifactResultinterface
SkillFrontmatterinterfaceSkill frontmatter parsed from SKILL.md YAML header. This is CLEO’s extended…
SkillinterfaceSkill definition loaded from disk. CLEO-specific type that wraps a…
SkillSummaryinterfaceLightweight skill summary for manifest/listing. Projected from Skill for e…
SkillManifestinterfaceSkill manifest (cached aggregate of all discovered skills).
SkillProtocolTypetypeRCASD-IVTR+C protocol types.
AgentConfiginterfaceAgent configuration from AGENT.md or agent definition.
AgentRegistryEntryinterfaceAgent registry entry.
AgentRegistryinterfaceAgent registry (persisted).
SkillSearchScopetypeCAAMP search order for skill discovery.
SkillSearchPathinterfaceOrdered search path entry.
DispatchStrategytypeDispatch strategy for skill selection.
DispatchResultinterfaceDispatch result from skill_auto_dispatch.
TokenDefinitioninterfaceToken definition from placeholders.json.
TokenValidationResultinterfaceToken validation result.
TokenContextinterfaceToken injection context.
OrchestratorThresholdsinterfaceOrchestrator context thresholds.
PreSpawnCheckResultinterfacePre-spawn check result.
SpawnPromptResultinterfaceSpawn prompt result.
DependencyWaveinterfaceDependency wave for parallel execution.
DependencyAnalysisinterfaceDependency analysis result.
HitlSummaryinterfaceHITL summary for session handoff.
ManifestEntryinterfaceResearch manifest entry (pipeline_manifest table, ADR-027).
ManifestValidationResultinterfaceManifest validation result.
ComplianceResultinterfaceCompliance verification result.
InstalledSkillinterfaceInstalled skill tracking.
InstalledSkillsFileinterfaceInstalled skills file.
TokenValuestypeToken values map: TOKEN_NAME - value.
MultiSkillCompositioninterfaceResult of multi-skill composition.
StageGuidanceinterfaceStructured guidance for a single pipeline stage. Pi extensions consume the…
EnforcementModetypeLifecycle enforcement modes.
GateDatainterfaceGate data within a stage.
ManifestStageDatainterfaceStage data in an on-disk manifest.
RcasdManifestinterfaceCanonical RCASD manifest-shaped interface for compatibility payloads. Lifecyc…
GateCheckResultinterfaceGate check result.
StageTransitionResultinterfaceStage transition result.
LifecycleHistoryEntryinterfaceHistory entry for stage transitions.
AlertLeveltypeAlert level names.
AlertCheckResultinterfaceAlert result from check_context_alert.
FormatOptionsinterfaceOptions for envelope formatting. T4668 T4670 T4663
CleoRegistryEntryinterfaceEntry in the CLEO-to-LAFS error registry. T4671 T4663
TestDbEnvinterfaceResult of creating a test database environment.
HierarchyValidationinterfaceValidate that adding a child to a parent would not violate constraints.
TaskTreeNodeinterfaceBuild a tree structure from flat task list.
HierarchyPolicyinterface
HierarchyValidationResultinterface
StrictnessPresettypeValid preset names.
PresetDefinitioninterfaceA preset definition: the config keys it sets and a human description.
ApplyPresetResultinterfaceResult of applying a preset.
SessionRecordinterfaceSession object (engine-compatible).
TaskWorkStateExtinterfaceTask work state from the task store. Extends the strict contracts…
DecisionRecordinterfaceDecision record stored in decisions.jsonl.
AssumptionRecordinterfaceAssumption record stored in assumptions.jsonl.
RecordDecisionParamsinterface
DecisionLogParamsinterface
HandoffDatainterfaceHandoff data schema - structured state for session transition.
ComputeHandoffOptionsinterfaceOptions for computing handoff data.
GitStateinterfaceGit state snapshot captured at session end.
DebriefDecisioninterfaceDecision summary for debrief output.
DebriefDatainterfaceRich debrief data — superset of HandoffData. Captures comprehensive session s…
ComputeDebriefOptionsinterfaceOptions for computing debrief data.
BrainFtsRowinterfaceRow returned by FTS content_hash duplicate check (brain-retrieval.ts observeB…
BrainNarrativeRowinterfaceRow returned by narrative backfill query (brain-retrieval.ts populateEmbeddin…
BrainSearchHitinterfaceFlattened FTS hit used in hybrid search scoring (brain-search.ts hybridSearch).
BrainKnnRowinterfaceRow returned by KNN vector similarity query (brain-similarity.ts searchSimilar).
BrainDecisionNodeinterfaceDecision node attached to a blocker in causal traces (brain-reasoning.ts reas…
BrainAnchorinterfaceAnchor entry in a timeline result (brain-retrieval.ts timelineBrain).
BrainTimelineNeighborRowinterfaceRow returned by timeline UNION ALL neighbor queries (brain-retrieval.ts timel…
BrainConsolidationObservationRowinterfaceRow returned by the consolidation observation query (brain-lifecycle.ts conso…
BrainIdCheckRowinterfaceRow returned by ID existence check queries (claude-mem-migration.ts). Used b…
EmbeddingProviderinterfaceContract for embedding providers (local models, API services, etc.).
SimilarityResultinterface
BrainSearchResultinterfaceSearch result with BM25 rank.
BrainSearchOptionsinterfaceSearch options.
HybridResultinterfaceResult from hybridSearch combining multiple search signals.
HybridSearchOptionsinterfaceOptions for hybridSearch weighting and limits.
MemoryBridgeConfiginterfaceConfiguration for memory bridge content generation.
BrainCompactHitinterfaceCompact search hit — minimal fields for index-level results.
SearchBrainCompactParamsinterfaceParameters for searchBrainCompact.
SearchBrainCompactResultinterfaceResult from searchBrainCompact.
TimelineBrainParamsinterfaceParameters for timelineBrain.
TimelineNeighborinterfaceTimeline entry — compact id/type/date tuple.
TimelineBrainResultinterfaceResult from timelineBrain.
FetchBrainEntriesParamsinterfaceParameters for fetchBrainEntries.
FetchedBrainEntryinterfaceFetched entry with full data.
FetchBrainEntriesResultinterfaceResult from fetchBrainEntries.
BrainObservationTypetypeObservation type from schema.
BrainObservationSourceTypetypeObservation source type from schema.
ObserveBrainParamsinterfaceParameters for observeBrain.
ObserveBrainResultinterfaceResult from observeBrain.
PopulateEmbeddingsResultinterfaceResult from populateEmbeddings backfill.
PopulateEmbeddingsOptionsinterfaceOptions for the embedding backfill pipeline.
AuditEntryinterfaceAudit entry interface. Used by session-grade and system-engine for behavioral…
StoreLearningParamsinterfaceParameters for storing a new learning.
SearchLearningParamsinterfaceParameters for searching learnings.
DimensionScoreinterface
GradeResultinterface
AdapterInfointerfaceSummary info for an adapter without exposing the full instance.
SessionBridgeDatainterfaceSession data needed to create a memory bridge observation.
StoreDecisionParamsinterfaceParameters for storing a new decision.
SearchDecisionParamsinterfaceParameters for searching decisions.
ListDecisionParamsinterfaceParameters for listing decisions.
PatternTypetypePattern types from ADR-009.
PatternImpacttypeImpact level.
StorePatternParamsinterfaceParameters for storing a new pattern.
SearchPatternParamsinterfaceParameters for searching patterns.
RecordAssumptionParamsinterface
BulkLinkEntryinterfaceA link to be created in bulk.
SessionMemoryResultinterfaceResult of persisting session memory to brain.db.
MemoryIteminterfaceA memory item to be persisted to brain.db.
SessionMemoryContextinterfaceMemory context returned for session start/resume enrichment.
PipelineinterfacePipeline entity representing a task’s lifecycle state. T4800 T4799 - Unifi…
PipelineStageRecordinterfacePipeline stage record linking pipeline to individual stages. T4800 T4801 -…
PipelineTransitioninterfacePipeline transition record for audit trail. T4800 T4801 - Requires pipelin…
InitializePipelineOptionsinterfaceOptions for initializing a pipeline. T4800
AdvanceStageOptionsinterfaceOptions for advancing pipeline stage. T4800
PipelineQueryOptionsinterfacePipeline query options. T4800
BriefingTaskinterfaceTask summary for briefing output.
BriefingBuginterfaceBug summary for briefing output.
BriefingBlockedTaskinterfaceBlocked task summary for briefing output.
BriefingEpicinterfaceActive epic summary for briefing output.
PipelineStageInfointerfacePipeline stage data for briefing output.
LastSessionInfointerfaceLast session info with handoff data.
CurrentTaskInfointerfaceCurrently active task info.
SessionBriefinginterfaceSession briefing result.
BriefingOptionsinterfaceOptions for computing session briefing.
MinimalSessionRecordinterfaceMinimal session record returned by findSessions().
FindSessionsParamsinterfaceParameters for findSessions().
ContextDriftResultinterface
SessionHistoryEntryinterface
SessionHistoryParamsinterface
SessionStatsResultinterface
RuntimeProviderContextinterface
RuntimeProviderSnapshotinterface
StartSessionOptionsinterfaceOptions for starting a session.
EndSessionOptionsinterfaceOptions for ending a session.
ListSessionsOptionsinterfaceOptions for listing sessions.
EnforcementModetypeEnforcement modes.
ActiveSessionInfointerfaceSession info for enforcement checks.
EnforcementResultinterfaceEnforcement result.
ValidationResultinterface
AddTaskEnforcementOptionsinterface
UpdateTaskEnforcementOptionsinterface
AcceptanceEnforcementinterface
ResolvedParentinterfaceMinimal parent task shape needed for pipeline stage resolution. T060
TaskPipelineStagetypeUnion type of all valid pipeline stage names.
LifecycleModetypeThe resolved enforcement mode (from lifecycle.mode config key).
EpicEnforcementResultinterfaceResult of an enforcement check. warning is populated in advisory mode.
AddTaskOptionsinterfaceOptions for creating a task. description is required per CLEO’s anti-h…
AddTaskResultinterfaceResult of adding a task.
ListPhasesResultinterfaceOptions for listing phases.
SetPhaseOptionsinterfaceOptions for setting current phase.
SetPhaseResultinterfaceResult of a phase set operation.
ShowPhaseResultinterfacePhase show result.
AdvancePhaseResultinterfacePhase advance result.
RenamePhaseResultinterfacePhase rename result.
DeletePhaseResultinterfacePhase delete result.
PruneResultinterface
SchemaInstallResultinterface
StalenessReportinterface
InstalledSchemainterface
CheckResultinterface
JsonFileIntegrityResultinterfaceResult for a single file check.
SchemaIntegrityReportinterfaceFull integrity report for all JSON files.
ProjectTypetypeDetected project type.
TestFrameworktypeTest framework.
FileNamingConventiontype
ImportStyletype
ProjectContextinterfaceSchema-compliant project context for LLM agent consumption.
ScaffoldResultinterface
InjectionCheckResultinterface
ScaffoldResultinterfaceResult of an ensure* scaffolding operation.
CheckStatustypeStatus of a check* diagnostic.
CheckResultinterfaceResult of a check* diagnostic (compatible with doctor/checks.ts CheckResult).
ProjectClassificationinterfaceClassification result for a project directory.
ClassificationSignalinterfaceA single classification signal detected on the filesystem.
ScaffoldResultinterface
HookCheckResultinterface
EnsureGitHooksOptionsinterface
ManagedHooktype
LegacyDetectionResultinterfaceResult of detecting legacy agent-output directories.
AgentOutputsMigrationResultinterfaceResult of running the agent-outputs migration.
NexusPermissionLeveltype
NexusHealthStatustype
NexusProjectinterfaceDomain representation of a registered Nexus project.
NexusRegistryFileinterfaceLegacy registry file shape (pre-SQLite). Retained for migration compatibility.
StackAnalysisinterface
ArchAnalysisinterface
StructureAnalysisinterface
ConventionAnalysisinterface
TestingAnalysisinterface
IntegrationAnalysisinterface
ConcernAnalysisinterface
CodebaseMapResultinterface
MapCodebaseOptionsinterface
InitOptionsinterfaceOptions for the init operation.
InitResultinterfaceResult of the init operation.
BootstrapContextinterfaceResult tracking arrays passed through each bootstrap step.
BootstrapOptionsinterfaceOptions for bootstrapGlobalCleo.
ExportFormattype
ExportParamsinterface
ExportResultinterface
ImportParamsinterface
ImportResultinterface
AgentExecutionOutcometypeThe outcome of an agent’s execution attempt on a task.
AgentExecutionEventinterfaceContext recorded when an agent completes or fails a task.
AgentPerformanceSummaryinterfaceSummary of an agent type’s execution performance on a task type.
HealingSuggestioninterfaceA self-healing suggestion derived from failure pattern history.
AgentCapacityinterfaceTask-count-based capacity for a single agent instance.
AgentPerformanceMetricsinterfaceMetrics provided when recording agent performance.
CapacitySummaryinterfaceCapacity summary for reporting.
AgentHealthStatusinterfaceHealth status of a specific agent instance.
RetryPolicyinterfaceConfiguration for retry behavior.
RetryResultinterfaceResult of a retried operation.
AgentRecoveryResultinterfaceResult of a recovery attempt for a single agent.
RiskFactorinterfaceA single factor contributing to a task’s overall risk score. Each factor has…
RiskAssessmentinterfaceComplete risk assessment for a single task. Returned by calculateTaskRisk
ValidationPredictioninterfacePredicted outcome for a lifecycle validation gate. Returned by…
DetectedPatterninterfaceA pattern automatically detected from historical brain/task data. Detected p…
PatternMatchinterfaceResult of matching a task against known patterns from brain_patterns. Includ…
PatternExtractionOptionsinterfaceOptions for pattern extraction from historical data.
PatternStatsUpdateinterfaceResult of updating pattern statistics after an outcome.
LearningContextinterfaceSummary of applicable learnings for a task, used in prediction.
ImpactAssessmentinterfaceFull impact assessment for a task within its dependency graph. Captures dire…
ChangeTypetypeThe type of change being analyzed.
ChangeImpactinterfacePredicted downstream effects of a specific change to a task. Models what hap…
AffectedTaskinterfaceA single task affected by a change, with its predicted new state.
ImpactedTaskinterfaceA single task predicted to be affected by a free-text change description. Pr…
ImpactReportinterfaceFull impact prediction report for a free-text change description. Returned b…
BlastRadiusSeveritytypeSeverity classification for blast radius.
BlastRadiusinterfaceQuantified scope of a task’s impact across the project.
GateFocusRecommendationinterfaceA gate-level focus recommendation produced by adaptive validation.
AdaptiveValidationSuggestioninterfaceFull adaptive validation suggestion set for a task.
VerificationConfidenceScoreinterfaceResult of scoring and persisting a completed verification round.
StorePredictionOptionsinterfaceParameters for storing a quality prediction as a brain observation.
DependencyCheckResultinterfaceResult of a dependency validation check.
DependencyErrorinterfaceA dependency error.
DependencyWarninginterfaceA dependency warning.
DependencyWaveinterfaceA wave of parallelizable tasks.
NexusParsedQueryinterface
NexusResolvedTasktypeTask with project context annotation.
DiscoverResultinterface
NexusDiscoverResultinterface
SearchResultinterface
NexusSearchResultinterface
PermissionCheckResultinterface
SharingStatusinterfaceResult of a sharing status check.
TaskCurrentResultinterfaceResult of getting current task.
TaskStartResultinterfaceResult of starting work on a task.
TaskWorkHistoryEntryinterfaceTask work history entry.
CompleteTaskOptionsinterfaceOptions for completing a task.
CompleteTaskResultinterfaceResult of completing a task.
RuleViolationinterfaceValidation error from anti-hallucination checks
UpdateTaskOptionsinterfaceOptions for updating a task.
UpdateTaskResultinterfaceResult of updating a task.
ParsedDirectiveinterfaceParsed directive from a Conduit message.
RouteResultinterfaceResult of routing a directive to a project.
WorkspaceStatusinterfaceAggregated task status across all projects.
WorkspaceProjectSummaryinterfaceTask summary for a single project.
WorkspaceAgentinterfaceAgent info aggregated across projects.
ProjectACLinterfaceProject-level ACL entry.
DepNodeinterfaceA node in the dependency graph.
DepsOverviewResultinterfaceDependency overview result.
TaskDepsResultinterfaceSingle task dependency result.
ExecutionWaveinterfaceExecution wave (group of parallelizable tasks).
CriticalPathResultinterfaceCritical path result.
CycleResultinterfaceCycle detection result.
TreeNodeinterfaceTree node representation.
CircularDependencytypeA circular dependency cycle found via DFS traversal.
MissingDependencyinterfaceA missing dependency reference within an epic.
DependencyAnalysisinterfaceFull dependency analysis result for an epic.
ContextEstimationinterfaceContext estimation result.
Waveinterface
EnrichedWaveinterface
StatusCountsinterfaceStatus counts by task state.
EpicStatusinterfaceEpic-specific status result.
OverallStatusinterfaceOverall orchestration status (no specific epic).
ProgressMetricsinterfaceProgress metrics for orchestration check.
StartupSummaryinterfaceStartup summary for an epic.
OrchestratorSessioninterfaceOrchestrator session state.
SpawnContextinterfaceSpawn context for a subagent.
TaskReadinessinterfaceTask readiness assessment.
AnalysisResultinterfaceOrchestrator analysis result.
ArtifactTypetypeSupported artifact types.
ArtifactConfiginterfaceArtifact configuration from release config.
ArtifactResultinterfaceResult of an artifact operation.
ArtifactHandlerinterfaceArtifact handler interface.
ReleaseConfiginterfaceRelease configuration shape.
ReleaseGateinterfaceRelease gate definition.
GitFlowConfiginterfaceGitFlow branch configuration.
ChannelConfiginterfaceChannel-to-branch mapping for npm dist-tag resolution.
PushModetypePush mode: direct push vs PR creation vs auto-detect.
ReleaseChanneltypenpm dist-tag channel for a release.
ChannelValidationResultinterfaceResult of validating a version string against a channel’s expectations.
CIPlatformtypeSupported CI/CD platforms.
BranchProtectionResultinterface
PRCreateOptionsinterface
PRResultinterface
RepoIdentityinterface
EpicCompletenessResultinterfaceEpic completeness result.
DoubleListingResultinterfaceDouble-listing check result.
BumpTypetypeBump type for version calculation.
VersionBumpTargetinterfaceVersion bump target config from .cleo/config.json.
BumpResultinterfaceBump result for a single file.
ReleaseManifestinterfaceRelease manifest structure.
ReleaseListOptionsinterface
ReleaseTaskRecordinterfaceTask record shape needed for release operations.
ReleaseGateMetadatainterfaceMetadata captured during gate evaluation, returned alongside gate results. Do…
PushPolicyinterfacePush policy configuration from config.release.push.
SnapshotDecisioninterfaceA decision recorded during the session.
SnapshotObservationinterfaceBrain observation linked to this session.
SnapshotTaskContextinterfaceActive task context at snapshot time.
SessionSnapshotinterfaceComplete session snapshot — everything needed to resume. This is the seriali…
SerializeOptionsinterfaceOptions for serializing a session.
RestoreOptionsinterfaceOptions for restoring a session.
StickyNoteStatustypeSticky note status values.
StickyNoteColortypeSticky note color options.
StickyNotePrioritytypeSticky note priority levels.
ConvertedTargetTypetypeConverted target type.
ConvertedTargetinterfaceConverted target reference.
StickyNoteinterfaceCore sticky note interface.
CreateStickyParamsinterfaceParameters for creating a sticky note.
ListStickiesParamsinterfaceParameters for listing sticky notes.
ConvertStickyParamsinterfaceParameters for converting a sticky note.
ArchiveTasksOptionsinterfaceOptions for archiving tasks.
ArchiveTasksResultinterfaceResult of archiving tasks.
DeleteTaskOptionsinterfaceOptions for deleting a task.
DeleteTaskResultinterfaceResult of deleting a task.
EngineResultinterfaceCanonical EngineResult type used by all engines and core engine-compat modules.
ExportMetainterfaceExport package metadata.
ExportSelectioninterfaceExport selection criteria.
IdMapEntryinterfaceID map entry.
RelationshipGraphinterfaceRelationship graph.
ExportPackageinterfaceComplete export package.
ExportTasksParamsinterface
ExportTasksResultinterface
HelpOperationDefinterfaceMinimal operation definition consumed by help logic.
CostHinttypeCost hint classification for an operation.
GroupedOperationsinterfaceDomain-grouped operation format (compact).
VerboseOperationinterfaceVerbose operation entry with cost hints.
HelpResultinterfaceResult of the help computation.
TransferModetypeTransfer mode: copy keeps source tasks, move archives them.
TransferScopetypeTransfer scope: single task or full subtree.
TransferOnConflicttypeConflict resolution when target has tasks with duplicate titles.
TransferOnMissingDeptypeHow to handle missing dependencies in the target project.
TransferParamsinterfaceParameters for a cross-project transfer operation.
TransferManifestEntryinterfaceA single task entry in the transfer manifest.
TransferManifestinterfaceManifest describing what was (or would be) transferred.
TransferResultinterfaceResult of a transfer operation.
ImportFromPackageOptionsinterfaceOptions passed to importFromPackage (extracted from importTasksPackage).
ImportFromPackageResultinterfaceResult from importFromPackage.
RemapTableinterfaceForward and reverse remap tables.
ImportTasksParamsinterface
ImportTasksResultinterface
ValidationErrorinterface
ValidationResultinterface
AdrValidationErrortypeValidationError — canonical name per ADR-017 spec
AdrValidationResulttypeValidationResult — canonical name per ADR-017 spec
TreeSitterLanguagetypeSupported tree-sitter language identifiers.
OutlineNodeinterfaceA symbol node in the outline tree, with optional children.
SmartOutlineResultinterfaceResult of generating a smart outline for a file.
SmartSearchResultinterfaceA search result with relevance score.
SmartSearchOptionsinterfaceOptions for smart_search.
SmartUnfoldResultinterfaceResult of unfolding a single symbol.
ComplianceJsonlEntrytype
PayloadValidationResultinterfaceResult of payload validation.
BuildConfigtype
RepositoryConfigtype
IssueTemplateinterfaceParsed issue template.
AddIssueParamsinterface
AddIssueResultinterface
RetryablePredicatetypeA predicate or pattern used to decide whether an error is retryable. -…
RetryOptionsinterfaceOptions that control retry behavior for withRetry.
RetryContextinterfaceMetadata attached to errors thrown after all retry attempts are exhausted. T…
DecayResultinterfaceResult from applying temporal decay.
ConsolidationResultinterfaceResult from consolidating memories.
BrainMigrationResultinterfaceResult from a migration run.
ResearchEntryinterfaceResearch entry attached to a task.
ManifestEntryinterfaceManifest entry (JSONL line).
AddResearchOptionsinterfaceOptions for adding research.
ListResearchOptionsinterfaceOptions for listing research.
ManifestQueryOptionsinterfaceManifest query options.
ExtendedManifestEntryinterfaceExtended manifest entry with optional fields used by the engine.
ResearchFilterinterfaceResearch filter criteria used by the engine.
ContradictionDetailinterfaceContradiction detail between two manifest entries.
SupersededDetailinterfaceSuperseded entry detail.
ComplianceSummaryinterfaceCompliance summary shape.
OtelCaptureModetypeOTel capture mode.
OtelTokenDataPointinterfaceToken data point parsed from OTel metrics.
AggregatedTokensinterfaceAggregated token counts.
ABVarianttypeA/B test variant.
ABEventTypetypeA/B test event types.
ABTestSummaryinterfaceA/B test summary result.
SeverityenumViolation severity levels.
ManifestIntegrityenumManifest integrity states.
InstructionStabilityenumInstruction stability levels.
SessionDegradationenumSession degradation levels.
AgentReliabilityenumAgent reliability levels.
MetricCategoryenumMetric categories.
MetricSourceenumMetric sources.
AggregationPeriodenumAggregation periods.
TokenEventTypetypeToken event types.
TokenEventinterfaceA token usage event entry.
TokenSessionSummaryinterfaceToken session summary shape.
VerificationResultinterfaceResult of a backup verification operation.
LogLeveltypeLog entry severity level
MigrationLogEntryinterfaceSingle migration log entry
MigrationLoggerConfiginterfaceMigration logger configuration
PreflightResultinterfacePre-flight check result.
MigrationPhasetypeMigration phase - tracks current step in the migration process
SourceFileInfointerfaceSource file info with checksum for integrity verification
MigrationProgressinterfaceMigration progress tracking
MigrationStateinterfaceComplete migration state structure
JsonFileValidationinterfaceResult of validating a single JSON file.
JsonValidationResultinterfaceComplete validation result for all source files.
SchemaVersioninterfaceSchema version info.
MigrationFntypeMigration function signature.
MigrationDefinterfaceMigration definition.
MigrationResultinterfaceMigration run result.
MigrationStatusinterfaceStatus of all data files.
NexusGraphNodeinterface
NexusGraphEdgeinterface
NexusGlobalGraphinterface
DepsResultinterfaceResult of a dependency query.
DepsEntryinterfaceSingle dependency entry with resolution status.
CriticalPathResultinterfaceCritical path result.
BlockingAnalysisResultinterfaceBlocking analysis result.
OrphanEntryinterfaceOrphan detection result.
PinoLeveltypePino log levels as written by CLEO’s logger (uppercase).
PinoLogEntryinterfaceA parsed pino log entry from a CLEO log file. Core fields are always present;…
LogFileInfointerfaceMetadata about a discovered log file.
LogFilterinterfaceFilter criteria for log queries. All fields are optional; when multiple are p…
LogQueryResultinterfaceResult of a log query operation.
LogDiscoveryOptionsinterfaceOptions for discovering log files.
LogSummaryinterfaceSummary of log activity across files.
RemoteConfiginterfaceRemote configuration.
PushResultinterfaceResult of a push operation.
PullResultinterfaceResult of a pull operation.
RemoteInfointerfaceResult of a remote list operation.
ExecutionModetypeExecution mode for an operation
GatewayTypetypeGateway type
PreferredChanneltypePreferred communication channel for token efficiency. CLI is the only dispatc…
OperationCapabilityinterface
CapabilityReportinterfaceCapability report returned by system.doctor
RateLimitConfiginterfaceRate limiter configuration
RateLimitResultinterfaceRate limit check result
ContributionDecisioninterfaceA contribution decision from an agent.
ContributionConflictinterfaceConflict between two agent decisions.
ConsensusResultinterfaceConsensus result from weighted voting.
SkillsMpConfiginterfaceSkillsMP configuration.
MarketplaceSkillinterfaceMarketplace skill result (CLEO-specific shape).
BatchSpawnEntryinterfaceResult of a single spawn within a batch.
BatchSpawnResultinterfaceResult of a batch spawn operation.
SessionInitResultinterfaceSession init result.
PauseStatusinterfacePause status result.
SkillSourceTypetypeSource type classification for a skill directory.
SkillSourceModetypeSkill source mode.
SkillSearchPathinterfaceSearch path entry with its origin.
IssueSeveritytypeValidation issue severity.
ValidationIssueinterfaceSingle validation issue.
SkillValidationResultinterfaceValidation result for a skill.
SnapshotMetainterfaceSnapshot metadata.
SnapshotTaskinterfacePortable task representation (subset of Task, omitting local-only fields).
SnapshotinterfaceComplete snapshot package.
ImportResultinterfaceImport result summary.
SpawnCapabilitytypeSpawn capability type - subset of provider capabilities related to spawning
WorkflowRuleMetricinterfacePer-rule compliance breakdown.
WorkflowComplianceReportinterfaceFull workflow compliance report.
ArchiveMetadatainterfaceArchive metadata that may be attached to archived task records.
AnalyticsTaskinterfaceArchived task shape used internally for analytics.
ArchiveReportTypetype
SummaryReportDatainterfaceSummary report result.
PhaseGroupEntryinterfacePhase group entry.
LabelFrequencyEntryinterfaceLabel frequency entry.
PriorityGroupEntryinterfacePriority group entry.
CycleTimeDistributioninterfaceCycle time distribution buckets.
CycleTimePercentilesinterfaceCycle time percentiles.
CycleTimesReportDatainterfaceCycle times report result.
DailyArchiveEntryinterfaceDaily archive entry.
MonthlyArchiveEntryinterfaceMonthly archive entry.
TrendsReportDatainterfaceTrends report result.
EmptyArchiveDatainterfaceEmpty archive sentinel (when totalArchived is 0).
ArchiveReportDataMaptypeUnion type mapping report types to their data shapes.
ArchiveAnalyticsResultinterfaceThe envelope returned by analyzeArchive.
AnalyzeArchiveOptionsinterfaceOptions for analyzeArchive.
ArchiveStatsResultinterface
AuditIssueinterface
AuditResultinterface
BackupResultinterface
RestoreResultinterface
BackupEntryinterfaceA single backup entry returned by listSystemBackups.
CleanupResultinterface
PlatformtypeDetected platform.
SystemInfointerfaceStructured snapshot of the host system for diagnostics, error reports, and lo…
CheckStatustype
CheckResultinterface
HealthCheckinterface
HealthResultinterface
DiagnosticsCheckinterface
DiagnosticsResultinterface
DoctorCheckinterface
DoctorReportinterface
FixResultinterface
StartupStatetypeOutcome of a startup health check. Tells the caller exactly what state the sy…
StartupHealthCheckinterface
StartupHealthResultinterface
InjectGenerateResultinterface
LabelsResultinterface
SystemMetricsResultinterface
MigrateResultinterface
RuntimeDiagnosticsinterface
SafestopResultinterface
UncancelResultinterface
TemplateSectioninterfaceA single section/field within an issue template.
IssueTemplateinterfaceA parsed issue template.
TemplateConfiginterfaceThe full template config output.
TemplateResultinterfaceResult type for template parser operations.
ShellTypetypeSupported shell types.
ChangelogSectioninterfaceGrouped changelog sections.
CommandMetainterfaceParsed command metadata.
ParsedFlagsinterfaceParsed flag state.
InsertTasktype
SelectTasktype
InsertTaskDependencytype
SelectTaskDependencytype
InsertTaskRelationtype
SelectTaskRelationtype
InsertSessiontype
SelectSessiontype
InsertWorkHistorytype
SelectWorkHistorytype
InsertLifecyclePipelinetype
SelectLifecyclePipelinetype
InsertLifecycleStagetype
SelectLifecycleStagetype
InsertLifecycleGateResulttype
SelectLifecycleGateResulttype
InsertLifecycleEvidencetype
SelectLifecycleEvidencetype
InsertLifecycleTransitiontype
SelectLifecycleTransitiontype
InsertSchemaMetatype
SelectSchemaMetatype
InsertAuditLogtype
SelectAuditLogtype
AuditLogInserttypeCanonical type alias for audit log insert (T4848).
AuditLogSelecttypeCanonical type alias for audit log select (T4848).
InsertTokenUsagetype
SelectTokenUsagetype
InsertArchitectureDecisiontype
SelectArchitectureDecisiontype
InsertManifestEntrytype
SelectManifestEntrytype
InsertPipelineManifesttype
SelectPipelineManifesttype
InsertReleaseManifesttype
SelectReleaseManifesttype
InsertExternalTaskLinktype
SelectExternalTaskLinktype
InsertAgentInstancetype
SelectAgentInstancetype
InsertAgentErrorLogtype
SelectAgentErrorLogtype
ManifestIntegritytype
Severitytype
ComplianceMetricsinterface
ManifestEntryinterface
TokenMetricsinterface
TokenEfficiencyinterface
OrchestrationOverheadinterface
DriftIssueinterface
DriftReportinterface
CommandIndexEntryinterface
CommandIndexinterface
SchemaVersionsinterface
FileHashesinterface
ProjectCacheEntryinterface
DoctorProjectCacheinterface
ProjectDetailinterface
CategorizedProjectsinterface
UserJourneyStagetype
HealthSummaryinterface
ValidationErrorinterface
ValidationResultinterface
Taskinterface
TaskDatainterfaceTask data shape for validation functions.
ArchiveDatainterfaceArchive data shape for validation functions.
ComprehensiveValidationResultinterface
ManifestDocinterface
GapEntryinterface
CoverageEntryinterface
GapReportinterface
ManifestEntryinterface
ManifestViolationinterface
ManifestValidationResultinterface
ComplianceEntryinterface
ProtocolViolationinterface
ProtocolValidationResultinterface
GateNametype
AgentNametype
FailureLogEntryinterface
VerificationGatesinterface
Verificationinterface
VerificationStatustype
CircularValidationResultinterface
TaskForVerificationinterface
ProjectInfointerfaceFields consumed by logging, audit, and correlation subsystems.
BackfillOptionsinterfaceOptions for backfillTasks().
BackfillTaskChangeinterfaceSummary of what was (or would be) changed for a single task.
BackfillResultinterfaceOverall result returned by backfillTasks().
RequirementLeveltypeRFC 2119 requirement levels
ViolationSeveritytypeViolation severity
ProtocolRuleinterfaceProtocol rule definition
ProtocolViolationinterfaceProtocol violation result
ProtocolValidationResultinterfaceProtocol validation result
ErrorSeverityenumError severity levels for protocol/gate validation.
ErrorCategoryenumError category for grouping protocol/gate violations.
ProtocolExitCodeenumProtocol-specific exit codes used by the RCASD-IVTR+C enforcement system. Th…
ProtocolRequestinterfaceRequest shape used by the protocol enforcement system. Minimal interface matc…
ProtocolResponseinterfaceResponse shape used by the protocol enforcement system.
ProtocolTypeenumProtocol types aligned with RCASD-IVTR+C lifecycle
ViolationLogEntryinterfaceViolation log entry
ChainFindCriteriainterface
ProtocolViolationinterfaceProtocol violation entry.
ProtocolValidationResultinterfaceProtocol validation result.
ManifestEntryInputinterfaceManifest entry structure for validation.
ProtocolTypetype
VotingMatrixinterface
AdrStatustypeADR lifecycle status values. T260
ArchitectureDecisionOptionsinterfaceArchitecture decision options for validator.
ValidationStageOptionsinterfaceValidation-stage options for validator.
TestFrameworktypeProject-agnostic test framework identifiers. The testing protocol is deliber…
TestingOptionsinterfaceTesting-stage options for validator.
BrainMaintenanceDecayResultinterfaceTemporal decay step result subset used in maintenance output.
BrainMaintenanceConsolidationResultinterfaceMemory consolidation step result subset used in maintenance output.
BrainMaintenanceReconciliationResultinterfaceOrphaned reference reconciliation step result.
BrainMaintenanceEmbeddingsResultinterfaceEmbedding backfill step result.
BrainMaintenanceResultinterfaceAggregated result from a full brain maintenance run. All counts are zero whe…
BrainMaintenanceOptionsinterfaceOptions for runBrainMaintenance. All skip* flags default to false — th…
ClaudeMemMigrationResultinterfaceResult from a claude-mem migration run.
ClaudeMemMigrationOptionsinterfaceOptions for the claude-mem migration.
BlockerNodeinterface
CausalTraceinterface
SimilarEntryinterface
ManifestEntrytype
ModelProviderLookupinterface
TokenMethodtype
TokenConfidencetype
TokenTransporttype
TokenExchangeInputinterface
TokenMeasurementinterface
TokenUsageFiltersinterface
TokenUsageSummaryinterface
SkillEntryinterface
SkillContentinterface
HighImpactTaskinterface
SingleBlockerTaskinterface
CommonBlockerinterface
UnblockResultinterface
ValidationIssueinterface
SpawnValidationResultinterface
ContextInjectionDatainterfaceData returned by context injection.
CancelResultinterfaceResult of a cancel operation.
FlatTreeNodeinterfaceTree node representation for task hierarchy.
ComplexityFactorinterfaceComplexity factor contributing to a task’s size estimate.
AnalysisResultinterface
StoreEnginetypeStore engine type. SQLite is the only supported engine (ADR-006). T4647
TaskFiltersinterfaceCommon task filter options.
SessionFiltersinterfaceCommon session filter options.
StoreProviderinterfaceStore provider interface. Backed by SQLite (ADR-006 canonical storage).
MigrationResultinterfaceMigration result.
MigrationOptionsinterfaceOptions for migration.
RepairActioninterfaceA single repair action with status.
UpgradeActioninterfaceA single upgrade action with status.
UpgradeResultinterfaceFull upgrade result.
UpgradeSummaryinterfaceCounts of what upgrade checked/applied/skipped.
DiagnoseFindinginterfaceA single diagnostic finding from —diagnose.
DiagnoseResultinterfaceResult from diagnoseUpgrade().
GateLayerenumGate layer enumeration
GateStatusenumGate status for each layer
GateViolationinterfaceViolation detail for a specific gate layer
LayerResultinterfaceResult from a single gate layer validation
VerificationResultinterfaceComplete verification result across all 4 layers
OperationContextinterfaceOperation context for gate validation
WorkflowGateNameenumWorkflow gate names per protocol specification Section 7.1 T3141
WorkflowGateStatustypeWorkflow gate status values per Section 7.3
WorkflowGateAgenttypeAgent responsible for each gate per Section 7.2
WorkflowGateDefinitioninterfaceIndividual workflow gate definition per Section 7.2
WorkflowGateStateinterfaceState of a single workflow gate
JsonSchemaTypetype
JsonSchemaPropertyinterface
JSONSchemaObjectinterface
CommanderArgSplitinterface
ValidationResultinterfaceValidation result
ValidationErrorinterfaceIndividual validation error
SchemaTypetypeSchema types that can be validated via AJV/JSON Schema. SQLite-backed types (…
ComplianceEntryinterfaceCompliance entry stored in COMPLIANCE.jsonl
CoherenceIssueinterfaceCoherence issue found during graph validation.
ValidateCheckDetailinterface
ValidateReportResultinterface
ValidateAndFixResultinterfaceResult from validate + fix operation.
CriticalPathNodeinterface
CriticalPathResultinterface
SkillsPrecedenceConfiginterfaceConfiguration for skill precedence resolution across providers.
ResolvedSkillPathinterfaceA resolved skill path with full provenance metadata.
SkillInstallationContextinterfaceContext for a skill installation operation.
InProgressEpicinterfaceIn-progress epic entry.
ReadyTaskinterfaceReady task entry with leverage analysis.
BlockedTaskinterfaceBlocked task entry.
OpenBuginterfaceOpen bug entry.
PlanMetricsinterfacePlanning metrics.
PlanResultinterfaceComposite planning view result.
RcasdIndexinterfaceRCASD-INDEX.json top-level structure.
IndexMetainterfaceIndex metadata.
IndexTotalsinterfaceAggregate counts.
TaskAnchorinterfaceTask-anchored RCASD artifact reference.
SpecEntryinterfaceSpecification entry.
ReportEntryinterfaceReport entry.
PipelineStateinterfacePipeline state.
PipelineOperationinterfaceActive pipeline operation.
ChangeEntryinterfaceChange entry.
ExecutionResultinterfaceThe aggregate result of executing a CANT workflow.
StepResultinterfaceThe result of a single workflow statement execution.
DiscretionContextinterfaceContext provided to a discretion evaluator for AI-judged conditions.
ApprovalTokenStatustypeValid states for an approval token.
ApprovalTokeninterfaceAn approval token for human-in-the-loop workflow gates. Tokens are bound to…
TokenValidationinterfaceResult of validating an approval token.
JoinStrategytypeJoin strategy for parallel block execution.
SettleResultinterfaceResult of a parallel block execution with the settle strategy.
ExecutionScopeinterfaceVariable scope for workflow execution.
DiscretionEvaluatorinterfaceEvaluates a discretion condition and returns a boolean judgment.
ParallelArminterfaceA single parallel arm to execute.
ParallelResultinterfaceResult of a parallel block execution.
WorkflowExecutorConfiginterfaceConfiguration options for the workflow executor.
ResumablePipelineinterfaceResumable pipeline information returned to callers. T4805 T4798
PipelineContextinterfacePipeline context for session resume. T4805
StageContextinterfaceStage context within a pipeline. T4805
GateResultContextinterfaceGate result context. T4805 T4804
EvidenceContextinterfaceEvidence context. T4805 T4804
TransitionContextinterfaceTransition context. T4805
TaskContextinterfaceTask context. T4805
ResumeResultinterfaceResult of a resume operation. T4805
AutoResumeResultinterfaceAuto-resume detection result. T4805
FindResumableOptionsinterfaceOptions for finding resumable pipelines. T4805
SessionResumeCheckOptionsinterfaceOptions for session start with resume check. T4805
SessionResumeCheckResultinterfaceResult of session resume check. T4805
PrereqCheckinterfacePrerequisite check result. T4800
TransitionValidationinterfaceTransition validation result. T4800
StageStateinterfaceStage state snapshot for state machine. T4800
StateMachineContextinterfaceState machine context for a pipeline. T4800
StateTransitioninterfaceState transition request. T4800
StateTransitionResultinterfaceState transition result. T4800
ContextWindowInputinterfaceContext window input from Claude Code.
ContextStatustypeContext status derived from input.
HITLLeveltypeHITL warning level.
HITLWarninginterfaceHITL warning entry.
HITLWarningsResultinterfaceHITL warnings result.
StatuslineStatustypeStatusline integration status.
RoutingEntryinterfaceRouting entry describing the preferred channel for an operation. Derived fro…
ProviderContextinterfaceProvider capability context for dynamic skill generation.
IndexMaptypeCache index mapping labels/phases to task IDs.
ImportPackageMetainterfaceImport package metadata extracted from the export file.
ImportConflictTypetypeImport conflict types.
ImportConflictResolutiontypeImport conflict resolution strategies.
ImportOptionsinterfaceImport options for logging context.
SortableTaskinterfaceMinimal task shape needed for topological sorting.
PipelineStageTaskRowinterfaceRow shape for pipeline + stage + task JOIN.
PipelineStageRowinterfaceRow shape for pipeline + stage JOIN.
InsertProjectRegistrytype
SelectProjectRegistrytype
InsertNexusAuditLogtype
SelectNexusAuditLogtype
InsertNexusSchemaMetatype
SelectNexusSchemaMetatype
AtomicityResultinterface
AtomicityCriteriontype
RelatesTypetypeValid relationship types for relates entries.
RelatesEntryinterfaceA single relates entry.
SeveritytypeImpact severity levels.
DeleteWarninginterfaceAn impact warning.
AffectedTasksinterfaceAffected tasks info.
DeleteImpactinterfaceImpact analysis.
DeletePreviewinterfaceFull preview result.
ChildStrategytypeValid child handling strategies.
StrategyResultinterfaceResult from a strategy handler.
DiscoveryMethodtypeDiscovery method.
DiscoveryMatchinterfaceA single discovery match.
PhaseProgressinterfacePhase progress information.
PhaseTransitionValidationinterfaceValidate a phase transition.
StalenessThresholdsinterfaceStaleness thresholds in days.
StalenessLeveltypeStaleness classification.
StalenessInfointerfaceStaleness assessment for a single task.
StalenessSummaryinterfaceGet staleness summary statistics.

Other Exports

SymbolKindDescription
logger.tsfile
platform-paths.tsfile
paths.tsfile
migration-manager.tsfile
sqlite-backup.tsfile
status-registry.tsfile
AGENT_INSTANCE_STATUSESvariableAgent instance status values matching DB CHECK constraint.
AGENT_TYPESvariableAgent type values for classification.
agentInstancesvariable
agentErrorLogvariable
agent-schema.tsfile
WARP_CHAIN_INSTANCE_STATUSESvariableChain instance status values.
warpChainsvariableStored WarpChain definitions (serialized as JSON).
warpChainInstancesvariableRuntime chain instances bound to epics.
chain-schema.tsfile
TASK_PRIORITIESvariableTask priorities matching DB CHECK constraint on tasks.priority.
TASK_TYPESvariableTask types matching DB CHECK constraint on tasks.type.
TASK_SIZESvariableTask size values matching DB CHECK constraint on tasks.size.
LIFECYCLE_STAGE_NAMESvariableCanonical lifecycle stage names matching DB CHECK constraint on lifecycle_sta…
LIFECYCLE_GATE_RESULTSvariableGate result values matching DB CHECK constraint on lifecycle_gate_results.res…
LIFECYCLE_EVIDENCE_TYPESvariableEvidence type values matching DB CHECK constraint on lifecycle_evidence.type.
TOKEN_USAGE_METHODSvariableToken measurement methods for central token telemetry.
TOKEN_USAGE_CONFIDENCEvariableConfidence levels for token measurements.
TOKEN_USAGE_TRANSPORTSvariableTransport types for token telemetry.
TASK_RELATION_TYPESvariableTask relation types matching DB CHECK constraint on task_relations.relation_t…
LIFECYCLE_TRANSITION_TYPESvariableLifecycle transition types matching DB CHECK constraint on lifecycle_transiti…
EXTERNAL_LINK_TYPESvariableExternal task link types matching DB constraint on external_task_links.link_t…
SYNC_DIRECTIONSvariableSync direction types matching DB constraint on external_task_links.sync_direc…
tasksvariable
taskDependenciesvariable
taskRelationsvariable
sessionsvariable
taskWorkHistoryvariable
lifecyclePipelinesvariable
lifecycleStagesvariable
lifecycleGateResultsvariable
lifecycleEvidencevariable
lifecycleTransitionsvariable
manifestEntriesvariable
pipelineManifestvariable
releaseManifestsvariable
schemaMetavariable
auditLogvariableTask change audit log — stores every add/update/complete/delete/archive opera…
tokenUsagevariableCentral provider-aware token telemetry for CLI and external adapters. Stores…
architectureDecisionsvariableArchitecture Decision Records (ADRs) stored in the database. Corresponds to t…
adrTaskLinksvariableADR-to-Task links (soft FK — tasks can be purged)
adrRelationsvariableADR cross-reference relationships
externalTaskLinksvariableTracks links between CLEO tasks and external system tasks (Linear, Jira, GitH…
statusRegistryTablevariable
tasks-schema.tsfile
BRAIN_DECISION_TYPESvariableDecision types from ADR-009.
BRAIN_CONFIDENCE_LEVELSvariableConfidence levels for decisions.
BRAIN_OUTCOME_TYPESvariableOutcome types for decision tracking.
BRAIN_PATTERN_TYPESvariablePattern types for workflow analysis.
BRAIN_IMPACT_LEVELSvariableImpact levels for patterns.
BRAIN_LINK_TYPESvariableLink types for cross-referencing BRAIN entries with tasks.
BRAIN_OBSERVATION_TYPESvariableObservation types for claude-mem compatible observations.
BRAIN_OBSERVATION_SOURCE_TYPESvariableSource types for observations (how the observation was created).
BRAIN_MEMORY_TYPESvariableMemory entity types for the links table.
BRAIN_STICKY_STATUSESvariableSticky note status values.
BRAIN_STICKY_COLORSvariableSticky note colors.
BRAIN_STICKY_PRIORITIESvariableSticky note priority levels.
brainDecisionsvariable
brainPatternsvariable
brainLearningsvariable
brainObservationsvariableGeneral-purpose observations — replaces claude-mem’s observations table.
brainStickyNotesvariableEphemeral sticky notes for quick capture before formal classification.
brainMemoryLinksvariableCross-references between BRAIN entries and tasks in tasks.db.
brainSchemaMetavariable
BRAIN_NODE_TYPESvariableNode types for PageIndex graph.
BRAIN_EDGE_TYPESvariableEdge types for PageIndex graph.
brainPageNodesvariableDocuments/concepts as graph nodes for cross-document linking.
brainPageEdgesvariableDirected links between graph nodes.
brain-schema.tsfile
BRAIN_SCHEMA_VERSIONvariableSchema version for newly created brain databases. Single source of truth.
brain-sqlite.tsfile
projectRegistryvariableCentral registry of all CLEO projects known to the Nexus.
nexusAuditLogvariableAppend-only audit log for all Nexus operations across projects.
nexusSchemaMetavariableKey-value store for nexus.db schema versioning and metadata.
nexus-schema.tsfile
NEXUS_SCHEMA_VERSIONvariableSchema version for newly created nexus databases. Single source of truth.
nexus-sqlite.tsfile
SQLITE_SCHEMA_VERSIONvariableSchema version for newly created databases. Single source of truth.
sqlite.tsfile
parsers.tsfile
converters.tsfile
SIGNALDOCK_SCHEMA_VERSIONvariableSchema version for signaldock databases.
signaldock-sqlite.tsfile
cross-db-cleanup.tsfile
ERROR_CATALOGvariableThe unified error catalog. Keyed by numeric ExitCode value.
error-catalog.tsfile
errors.tsfile
db-helpers.tsfile
registry.tsfile
sqlite-data-accessor.tsfile
atomic.tsfile
backup.tsfile
lock.tsfile
INTERNAL_HOOK_EVENTSvariableCLEO-local coordination events used by the autonomous runtime. These are int…
CLEO_TO_CAAMP_HOOK_MAPvariableMapping from CLEO internal lifecycle events to CAAMP canonical hook event nam…
CLEO_INTERNAL_HOOK_MAPvariableInternal CLEO lifecycle events that drive autonomous coordination.
types.tsfile
hooksvariableSingleton instance of the HookRegistry. Use this instance for all hook opera…
registry.tsfile
json.tsfile
git-checkpoint.tsfile
data-safety-central.tsfile
safety-data-accessor.tsfile
data-accessor.tsfile
index.tsfile
data-safety.tsfile
task-store.tsfile
mvi-helpers.tsfile
show.tsfile
pagination.tsfile
list.tsfile
find.tsfile
types.tsfile
parse.tsfile
link-pipeline.tsfile
sync.tsfile
evidence.tsfile
rcasd-paths.tsfile
frontmatter.tsfile
PIPELINE_STAGESvariable
CONTRIBUTION_STAGEvariableCross-cutting contribution stage. Not part of the pipeline execution order, b…
STAGE_DEFINITIONSvariableCanonical stage definitions with complete metadata. T4800 T4799 - Replaces…
STAGE_ORDERvariableStage order mapping for quick lookups. T4800
STAGE_PREREQUISITESvariablePrerequisites for each stage - which stages must be completed before entering…
TRANSITION_RULESvariableAllowed transitions between stages. By default, stages progress linearly. Th…
STAGE_COUNTvariableTotal number of stages in the pipeline. T4800
FIRST_STAGEvariableFirst stage in the pipeline. T4800
LAST_STAGEvariableLast stage in the pipeline. T4800
PLANNING_STAGESvariablePlanning stages. T4800
DECISION_STAGESvariableDecision stages. T4800
EXECUTION_STAGESvariableExecution stages (canonical). T4800
VALIDATION_STAGESvariableValidation stages. T4800
DELIVERY_STAGESvariableDelivery stages. T4800
stages.tsfile
stage-artifacts.tsfile
SKILL_NAME_MAPvariableCanonical skill name mapping (user-friendly to ct-prefixed).
types.tsfile
discovery.tsfile
token.tsfile
dispatch.tsfile
STAGE_SKILL_MAPvariableCanonical mapping from RCASD-IVTR+C pipeline stages to the primary skill that…
TIER_0_SKILLSvariableTier 0 skills — always loaded alongside the stage-specific skill. -…
stage-guidance.tsfile
index.tsfile
THRESHOLDSvariableContext alert thresholds (percentage of context window).
context-alert.tsfile
output.tsfile
error-registry.tsfile
test-db-helper.tsfile
hierarchy.tsfile
ENFORCEMENT_PROFILESvariable
hierarchy-policy.tsfile
STRICTNESS_PRESETSvariableAll three strictness presets. strict — block on missing AC, require sessio…
config.tsfile
handler-helpers.tsfile
types.tsfile
decisions.tsfile
handoff.tsfile
brain-accessor.tsfile
typed-query.tsfile
brain-row-types.tsfile
embedding-local.tsfile
EMBEDDING_DIMENSIONSvariableMatches the brain_embeddings vec0 table: FLOAT[384].
brain-embedding.tsfile
brain-similarity.tsfile
brain-search.tsfile
memory-bridge.tsfile
memory-bridge-refresh.tsfile
brain-retrieval.tsfile
audit.tsfile
learnings.tsfile
session-grade.tsfile
adapter-registry.tsfile
discovery.tsfile
manager.tsfile
index.tsfile
session-memory-bridge.tsfile
decisions.tsfile
patterns.tsfile
auto-extract.tsfile
session-hooks.tsfile
task-hooks.tsfile
error-hooks.tsfile
file-hooks.tsfile
notification-hooks.tsfile
work-capture-hooks.tsfile
agent-hooks.tsfile
context-hooks.tsfile
index.tsfile
assumptions.tsfile
brain-links.tsfile
session-memory.tsfile
deps-ready.tsfile
pipeline.tsfile
briefing.tsfile
find.tsfile
session-archive.tsfile
session-cleanup.tsfile
session-drift.tsfile
session-history.tsfile
session-show.tsfile
session-stats.tsfile
session-suspend.tsfile
session-switch.tsfile
session-view.tsfile
provider-detection.tsfile
index.tsfile
session-enforcement.tsfile
enforcement.tsfile
TASK_PIPELINE_STAGESvariableOrdered pipeline stages (RCASD-IVTR+C). This matches lifecycle/stages.ts PIPE…
pipeline-stage.tsfile
EPIC_MIN_ACvariableMinimum acceptance criteria count required for epic creation in strict mode.
TASK_MIN_ACvariableMinimum acceptance criteria count for regular tasks.
epic-enforcement.tsfile
VALID_PRIORITIESvariableValid string priority values.
add.tsfile
index.tsfile
audit-prune.tsfile
hash.tsfile
json-schema-validator.tsfile
schema-management.tsfile
schema-integrity.tsfile
project-detect.tsfile
injection.tsfile
REQUIRED_CLEO_SUBDIRSvariableRequired subdirectories under .cleo/.
CLEO_GITIGNORE_FALLBACKvariableEmbedded fallback for .cleo/.gitignore content (deny-by-default).
REQUIRED_GLOBAL_SUBDIRSvariableRequired subdirectories under the global ~/.cleo/ home. These are infrastruct…
STALE_GLOBAL_ENTRIESvariableStale entries that must NOT exist at the global ~/.cleo/ level. These were pr…
scaffold.tsfile
discovery.tsfile
MANAGED_HOOKSvariableGit hooks managed by CLEO.
hooks.tsfile
agent-outputs.tsfile
migrate-json-to-sqlite.tsfile
registry.tsfile
stack.tsfile
architecture.tsfile
structure.tsfile
conventions.tsfile
testing.tsfile
integrations.tsfile
concerns.tsfile
store.tsfile
index.tsfile
init.tsfile
bootstrap.tsfile
caamp-init.tsfile
export.tsfile
import.tsfile
execution-learning.tsfile
MAX_TASKS_PER_AGENTvariableMaximum number of tasks that can be concurrently assigned to one agent. Used…
agent-registry.tsfile
capacity.tsfile
HEARTBEAT_INTERVAL_MSvariableDefault heartbeat interval (30 seconds) per BRAIN spec.
STALE_THRESHOLD_MSvariableDefault staleness threshold: 3 minutes without a heartbeat.
health-monitor.tsfile
DEFAULT_RETRY_POLICYvariableDefault retry policy matching the BRAIN specification.
retry.tsfile
index.tsfile
types.tsfile
prediction.tsfile
adaptive-validation.tsfile
dependency-check.tsfile
graph-ops.tsfile
impact.tsfile
patterns.tsfile
index.tsfile
query.tsfile
discover.tsfile
permissions.tsfile
index.tsfile
getTaskHistoryvariableGet task work history (canonical verb alias for dispatch layer). T5323
index.tsfile
complete.tsfile
validation-rules.tsfile
update.tsfile
workspace.tsfile
deps.tsfile
analyze.tsfile
context.tsfile
hierarchy.tsfile
waves.tsfile
status.tsfile
index.tsfile
link-store.tsfile
reconciliation-engine.tsfile
index.tsfile
artifacts.tsfile
changelog-writer.tsfile
release-config.tsfile
channel.tsfile
SUPPORTED_PLATFORMSvariableAll supported platforms.
ci.tsfile
github-pr.tsfile
guards.tsfile
version-bump.tsfile
release-manifest.tsfile
index.tsfile
SNAPSHOT_VERSIONvariableVersion of the snapshot schema. Increment on breaking changes.
snapshot.tsfile
types.tsfile
archive.tsfile
convert.tsfile
id.tsfile
create.tsfile
list.tsfile
purge.tsfile
show.tsfile
index.tsfile
archive.tsfile
delete.tsfile
cleo.tsfile
CORE_PROTECTED_FILESvariableConfiguration files relative to .cleo/ that MUST remain tracked by project gi…
constants.tsfile
engine-result.tsfile
export.tsfile
export-tasks.tsfile
help.tsfile
transfer-types.tsfile
import-remap.tsfile
import-tasks.tsfile
index.tsfile
find.tsfile
list.tsfile
show.tsfile
validate.tsfile
index.tsfile
adapter.tsfile
capability-check.tsfile
index.tsfile
SUPPORTED_EXTENSIONSvariableAll supported file extensions.
SUPPORTED_LANGUAGESvariableAll supported languages.
tree-sitter-languages.tsfile
parser.tsfile
outline.tsfile
search.tsfile
unfold.tsfile
index.tsfile
store.tsfile
index.tsfile
conduit-client.tsfile
http-transport.tsfile
local-transport.tsfile
sse-transport.tsfile
factory.tsfile
index.tsfile
index.tsfile
HookPayloadSchemavariableZod schema for HookPayload.
SessionStartPayloadSchemavariableZod schema for SessionStartPayload.
OnSessionStartPayloadSchemavariable
SessionEndPayloadSchemavariableZod schema for SessionEndPayload.
OnSessionEndPayloadSchemavariable
PreToolUsePayloadSchemavariableZod schema for PreToolUsePayload.
OnToolStartPayloadSchemavariable
PostToolUsePayloadSchemavariableZod schema for PostToolUsePayload.
OnToolCompletePayloadSchemavariable
NotificationPayloadSchemavariableZod schema for NotificationPayload.
OnFileChangePayloadSchemavariable
PostToolUseFailurePayloadSchemavariableZod schema for PostToolUseFailurePayload.
OnErrorPayloadSchemavariable
PromptSubmitPayloadSchemavariableZod schema for PromptSubmitPayload.
OnPromptSubmitPayloadSchemavariable
ResponseCompletePayloadSchemavariableZod schema for ResponseCompletePayload.
OnResponseCompletePayloadSchemavariable
SubagentStartPayloadSchemavariableZod schema for SubagentStartPayload.
SubagentStopPayloadSchemavariableZod schema for SubagentStopPayload.
PreCompactPayloadSchemavariableZod schema for PreCompactPayload.
PostCompactPayloadSchemavariableZod schema for PostCompactPayload.
ConfigChangePayloadSchemavariableZod schema for ConfigChangePayload.
OnWorkAvailablePayloadSchemavariableZod schema for OnWorkAvailablePayload.
OnAgentSpawnPayloadSchemavariableZod schema for OnAgentSpawnPayload.
OnAgentCompletePayloadSchemavariableZod schema for OnAgentCompletePayload.
OnCascadeStartPayloadSchemavariableZod schema for OnCascadeStartPayload.
OnPatrolPayloadSchemavariableZod schema for OnPatrolPayload.
payload-schemas.tsfile
index.tsfile
index.tsfile
BUILD_CONFIGvariableBUILD CONFIGURATION - AUTO-GENERATED FILE This file is generated by dev/gene…
build-config.tsfile
diagnostics.tsfile
template-parser.tsfile
create.tsfile
index.tsfile
retry.tsfile
index.tsfile
brain-lifecycle.tsfile
brain-migration.tsfile
index.tsfileResearch commands and manifest operations. T4465 T4454
common.tsfile
otel-integration.tsfile
ab-test.tsfile
aggregation.tsfile
enums.tsfile
token-estimation.tsfile
index.tsfile
checksum.tsfile
logger.tsfile
storage-preflight.tsfile
preflight.tsfile
state.tsfile
validate.tsfile
index.tsfile
deps.tsfile
transfer.tsfile
index.tsfile
PINO_LEVEL_VALUESvariableNumeric pino level values for comparison.
types.tsfile
log-filter.tsfile
log-parser.tsfile
log-reader.tsfile
index.tsfile
index.tsfile
phase.tsfile
index.tsfile
index.tsfile
index.tsfile
index.tsfile
capability-matrix.tsfile
index.tsfile
id-generator.tsfile
VALID_DOMAINSvariableKnown enum values for CLEO domains
VALID_GATEWAYSvariable
VALID_MANIFEST_STATUSESvariable
VALID_LIFECYCLE_STAGE_STATUSESvariable
ALL_VALID_STATUSESvariable
VALID_PRIORITIESvariable
DEFAULT_RATE_LIMITSvariableDefault rate limit configurations per operation type
input-sanitization.tsfile
index.tsfile
config.tsfile
install.tsfile
registry.tsfile
subagent.tsfile
install.tsfile
contribution.tsfile
research.tsfile
resolver.tsfile
marketplace.tsfile
spawn.tsfile
startup.tsfile
validator.tsfile
skill-paths.tsfile
test-utility.tsfile
validation.tsfile
version.tsfile
index.tsfile
index.tsfile
spawnRegistryvariableSingleton registry instance. Use this instance for all spawn adapter registr…
adapter-registry.tsfile
index.tsfile
workflow-telemetry.tsfile
index.tsfile
archive-analytics.tsfile
archive-stats.tsfile
audit.tsfile
backup.tsfile
cleanup.tsfile
file-utils.tsfile
PLATFORMvariableCached platform value.
MINIMUM_NODE_MAJORvariableMinimum required Node.js major version.
platform.tsfile
checks.tsfile
health.tsfile
inject-generate.tsfile
labels.tsfile
metrics.tsfile
migrate.tsfile
runtime.tsfile
safestop.tsfile
index.tsfile
index.tsfile
parser.tsfile
index.tsfile
ALIASES_VERSIONvariableCurrent alias version.
aliases.tsfile
changelog.tsfile
command-registry.tsfile
flags.tsfile
index.tsfile
taskStatusSchemavariableZod enum schema for task statuses.
taskPrioritySchemavariableZod enum schema for task priorities.
taskTypeSchemavariableZod enum schema for task types.
taskSizeSchemavariableZod enum schema for task sizes.
sessionStatusSchemavariableZod enum schema for session statuses.
lifecyclePipelineStatusSchemavariableZod enum schema for lifecycle pipeline statuses.
lifecycleStageStatusSchemavariableZod enum schema for lifecycle stage statuses.
lifecycleStageNameSchemavariableZod enum schema for lifecycle stage names.
lifecycleGateResultSchemavariableZod enum schema for lifecycle gate results.
lifecycleEvidenceTypeSchemavariableZod enum schema for lifecycle evidence types.
adrStatusSchemavariableZod enum schema for ADR statuses.
gateStatusSchemavariableZod enum schema for gate statuses.
manifestStatusSchemavariableZod enum schema for manifest statuses.
tokenUsageMethodSchemavariableZod enum schema for token usage measurement methods.
tokenUsageConfidenceSchemavariableZod enum schema for token usage confidence levels.
tokenUsageTransportSchemavariableZod enum schema for token usage transports.
taskRelationTypeSchemavariableZod enum schema for task relation types.
externalLinkTypeSchemavariableZod enum schema for external task link types.
syncDirectionSchemavariableZod enum schema for sync directions.
lifecycleTransitionTypeSchemavariableZod enum schema for lifecycle transition types.
brainObservationTypeSchemavariableZod enum schema for brain observation types.
brainObservationSourceTypeSchemavariableZod enum schema for brain observation source types.
brainDecisionTypeSchemavariableZod enum schema for brain decision types.
brainConfidenceLevelSchemavariableZod enum schema for brain confidence levels.
brainOutcomeTypeSchemavariableZod enum schema for brain outcome types.
brainPatternTypeSchemavariableZod enum schema for brain pattern types.
brainImpactLevelSchemavariableZod enum schema for brain impact levels.
brainLinkTypeSchemavariableZod enum schema for brain link types.
brainMemoryTypeSchemavariableZod enum schema for brain memory entity types.
brainStickyStatusSchemavariableZod enum schema for brain sticky note statuses.
brainStickyColorSchemavariableZod enum schema for brain sticky note colors.
brainStickyPrioritySchemavariableZod enum schema for brain sticky note priorities.
brainNodeTypeSchemavariableZod enum schema for brain page node types.
brainEdgeTypeSchemavariableZod enum schema for brain page edge types.
insertTaskSchemavariable
selectTaskSchemavariable
insertTaskDependencySchemavariable
selectTaskDependencySchemavariable
insertTaskRelationSchemavariable
selectTaskRelationSchemavariable
insertSessionSchemavariable
selectSessionSchemavariable
insertWorkHistorySchemavariable
selectWorkHistorySchemavariable
insertLifecyclePipelineSchemavariable
selectLifecyclePipelineSchemavariable
insertLifecycleStageSchemavariable
selectLifecycleStageSchemavariable
insertLifecycleGateResultSchemavariable
selectLifecycleGateResultSchemavariable
insertLifecycleEvidenceSchemavariable
selectLifecycleEvidenceSchemavariable
insertLifecycleTransitionSchemavariable
selectLifecycleTransitionSchemavariable
insertSchemaMetaSchemavariable
selectSchemaMetaSchemavariable
insertAuditLogSchemavariableZod schema for validating audit log insert payloads. T4848
AuditLogInsertSchemavariableCanonical named export for audit log insert schema (T4848). Alias for insertA…
selectAuditLogSchemavariable
AuditLogSelectSchemavariableCanonical named export for audit log select schema (T4848). Alias for selectA…
insertArchitectureDecisionSchemavariable
selectArchitectureDecisionSchemavariable
insertTokenUsageSchemavariable
selectTokenUsageSchemavariable
insertManifestEntrySchemavariable
selectManifestEntrySchemavariable
insertPipelineManifestSchemavariable
selectPipelineManifestSchemavariable
insertReleaseManifestSchemavariable
selectReleaseManifestSchemavariable
insertExternalTaskLinkSchemavariable
selectExternalTaskLinkSchemavariable
insertAgentInstanceSchemavariable
selectAgentInstanceSchemavariable
insertAgentErrorLogSchemavariable
selectAgentErrorLogSchemavariable
agentInstanceStatusSchemavariableZod enum schema for agent instance statuses.
agentTypeSchemavariableZod enum schema for agent types.
validation-schemas.tsfile
compliance.tsfile
docs-sync.tsfile
CACHE_VERSIONvariable
CACHE_TTL_SECONDSvariable
project-cache.tsfile
utils.tsfile
index.tsfile
VALID_OPERATIONSvariable
FIELD_LIMITSvariableField length limits matching the Bash implementation.
VAL_SUCCESSvariableValidation result exit codes.
VAL_SCHEMA_ERRORvariable
VAL_SEMANTIC_ERRORvariable
VAL_BOTH_ERRORSvariable
engine.tsfile
gap-check.tsfile
manifest.tsfile
protocol-common.tsfile
VERIFICATION_GATE_ORDERvariable
VERIFICATION_VALID_AGENTSvariable
verification.tsfile
index.tsfile
project-info.tsfile
index.tsfile
index.tsfileBackfill module: retroactively add AC and verification metadata to existing t…
PROTOCOL_RULESvariableProtocol rule registry
protocol-rules.tsfile
protocol-types.tsfile
protocolEnforcervariableDefault protocol enforcer instance
protocol-enforcement.tsfile
provider-hooks.tsfile
chain-validation.tsfile
chain-store.tsfile
PROTOCOL_TYPESvariableAll supported protocol types. The canonical set covers all 9 RCASD-IVTR pipe…
PROTOCOL_EXIT_CODESvariableMap protocol types to exit codes. Pipeline protocols use the 60-67 orchestra…
protocol-validators.tsfile
DEFAULT_CHAIN_IDvariable
DEFAULT_PROTOCOL_STAGE_MAPvariableStage mapping for protocol validation gates in the default chain. Cross-cutt…
default-chain.tsfile
tessera-engine.tsfile
brain-maintenance.tsfile
claude-mem-migration.tsfile
brain-reasoning.tsfile
engine-compat.tsfile
pipeline-manifest-sqlite.tsfile
model-provider-registry.tsfile
token-service.tsfile
parallel.tsfile
skill-ops.tsfile
unblock.tsfile
validate-spawn.tsfile
context-inject.tsfile
session-id.tsfile
session-store.tsfile
relates.tsfile
cancel-ops.tsfile
task-ops.tsfile
analyze.tsfile
labels.tsfile
provider.tsfile
index.tsfile
migration-sqlite.tsfile
repair.tsfile
upgrade.tsfile
GATE_SEQUENCEvariableExport gate layer sequence for external use
WORKFLOW_GATE_DEFINITIONSvariableComplete workflow gate definitions per Section 7.2
WORKFLOW_GATE_SEQUENCEvariableOrdered workflow gate sequence per Section 7.1
operation-verification-gates.tsfile
GATE_VALIDATION_RULESvariableValidation rule definitions for reuse
VALID_WORKFLOW_AGENTSvariableValid workflow gate agent names per Section 7.2
VALID_WORKFLOW_GATE_STATUSESvariableValid workflow gate status values per Section 7.3
operation-gate-validators.tsfile
param-utils.tsfile
_shared.tsfile
architecture-decision.tsfile
artifact-publish.tsfile
consensus.tsfile
contribution.tsfile
decomposition.tsfile
implementation.tsfile
provenance.tsfile
release.tsfile
research.tsfile
specification.tsfile
testing.tsfile
validation.tsfile
schema-validator.tsfile
validate-ops.tsfile
bootstrap.tsfile
critical-path.tsfile
precedence-types.tsfile
precedence-integration.tsfile
plan.tsfile
credentials.tsfile
agent-registry-accessor.tsfile
internal.tsfile
audit-prune.test.tsfile
caamp-skill-install.test.tsfile
cli-parity.test.tsfile
config.test.tsfile
error-catalog.test.tsfile
hooks.test.tsfile
human-output.test.tsfile
index-api-compat.test.tsfile
init-e2e.test.tsfile
injection-chain.test.tsfile
injection-mvi-tiers.test.tsfile
injection-shared.test.tsfile
logger.test.tsfile
paths.test.tsfile
project-info.test.tsfile
rcasd-index.tsfile
rcsd-pipeline-e2e.test.tsfile
remote.test.tsfile
scaffold.test.tsfile
schema-management.test.tsfile
schema.test.tsfile
sharing.test.tsfile
snapshot.test.tsfile
upgrade.test.tsfile
discovery.test.tsfile
manager.test.tsfile
agent-registry.test.tsfile
capacity.test.tsfile
execution-learning.test.tsfile
health-monitor.test.tsfile
registry.test.tsfile
retry.test.tsfile
types.tsfile
approval.tsfile
context-builder.tsfile
discretion.tsfile
parallel-runner.tsfile
workflow-executor.tsfile
index.tsfile
cant-agent-parse.test.tsfile
summary.tsfile
sync.test.tsfile
dual-api-e2e.test.tsfile
local-credential-flow.test.tsfile
local-transport.test.tsfile
sse-transport.test.tsfile
provider-hooks.test.tsfile
registry.test.tsfile
error-hooks.test.tsfile
file-hooks.test.tsfile
hook-automation-e2e.test.tsfile
session-hooks.test.tsfile
task-hooks.test.tsfile
adaptive-validation.test.tsfile
impact.test.tsfile
patterns.test.tsfile
prediction.test.tsfile
retry.test.tsfile
chain-composition.tsfile
consolidate-rcasd.tsfile
resume.tsfile
state-machine.tsfile
chain-store.test.tsfile
consolidate-rcasd.test.tsfile
default-chain.test.tsfile
frontmatter.test.tsfile
lifecycle.test.tsfile
pipeline.integration.test.tsfile
rcasd-paths.test.tsfile
resume-schema-contract.test.tsfile
stage-record-provenance.integration.test.tsfile
tessera-engine.test.tsfile
embedding-queue.tsfile
embedding-worker.tsfile
auto-extract.test.tsfile
brain-automation.test.tsfile
brain-embedding.test.tsfile
brain-links.test.tsfile
brain-migration.test.tsfile
brain-retrieval.test.tsfile
brain-search.test.tsfile
claude-mem-migration.test.tsfile
decisions.test.tsfile
engine-compat.test.tsfile
memory-bridge.test.tsfile
pipeline-manifest-sqlite.test.tsfile
session-memory.test.tsfile
model-provider-registry.test.tsfile
provider-detection.test.tsfile
checksum.test.tsfile
logger.test.tsfile
migration-failure.integration.test.tsfile
migration.test.tsfile
state.test.tsfile
validate.test.tsfile
deps.test.tsfile
nexus-e2e.test.tsfile
permissions.test.tsfile
query.test.tsfile
reconcile.test.tsfile
registry.test.tsfile
transfer.test.tsfile
index.test.tsfile
log-filter.test.tsfile
log-parser.test.tsfile
log-reader.test.tsfile
autonomous-spec.test.tsfile
orchestration.test.tsfile
protocol-validators.test.tsfile
deps.test.tsfile
phases.test.tsfile
artifacts.test.tsfile
cancel-release.test.tsfile
changelog-writer.test.tsfile
push-policy.test.tsfile
release.test.tsfile
allocate.test.tsfile
context-monitor.tsfile
hitl-warnings.tsfile
statusline-setup.tsfile
briefing-blocked.test.tsfile
briefing.test.tsfile
handoff-integration.test.tsfile
handoff.test.tsfile
index.test.tsfile
session-cleanup.test.tsfile
session-edge-cases.test.tsfile
session-find.test.tsfile
session-grade.integration.test.tsfile
session-grade.test.tsfile
session-memory-bridge.test.tsfile
sessions.test.tsfile
routing-table.tsfile
dynamic-skill-generator.tsfile
discovery.test.tsfile
dispatch.test.tsfile
dynamic-skill-generator.test.tsfile
manifests.test.tsfile
precedence.test.tsfile
routing-table.test.tsfile
skill-paths.test.tsfile
test-utility.test.tsfile
token.test.tsfile
validation.test.tsfile
version.test.tsfile
subagent.test.tsfile
spawn-tier.test.tsfile
adapter-registry.test.tsfile
stats.test.tsfile
purge.test.tsfile
cache.tsfile
import-logging.tsfile
import-sort.tsfile
lifecycle-store.tsfile
insertProjectRegistrySchemavariable
selectProjectRegistrySchemavariable
insertNexusAuditLogSchemavariable
selectNexusAuditLogSchemavariable
insertNexusSchemaMetaSchemavariable
selectNexusSchemaMetaSchemavariable
nexus-validation-schemas.tsfile
schema.tsfile
atomic.test.tsfile
backup.test.tsfile
brain-accessor-pageindex.test.tsfile
brain-accessor.test.tsfile
brain-pageindex.test.tsfile
brain-schema.test.tsfile
brain-vec.test.tsfile
collision-detection.test.tsfile
data-safety-central.test.tsfile
db-helpers.test.tsfile
e2e-safety-integration.test.tsfile
git-checkpoint.test.tsfile
idempotent-migration.test.tsfile
import-logging.test.tsfile
import-sort.test.tsfile
json.test.tsfile
lifecycle-schema-parity.test.tsfile
migration-integration.test.tsfile
migration-retry.test.tsfile
migration-safety.test.tsfile
migration-sqlite.test.tsfile
performance-safety.test.tsfile
project-detect.test.tsfile
project-registry.test.tsfile
provider.test.tsfile
relations.test.tsfile
safety-accessor.test.tsfile
sequence-validation.test.tsfile
session-store.test.tsfile
sqlite-backup.test.tsfile
sqlite.test.tsfile
task-store.test.tsfile
write-verification.test.tsfile
cleanup.test.tsfile
health.test.tsfile
start-deps.test.tsfile
ATOMICITY_CRITERIAvariable
atomicity.tsfile
crossref-extract.tsfile
delete-preview.tsfile
VALID_STRATEGIESvariable
deletion-strategy.tsfile
graph-cache.tsfile
graph-rag.tsfile
phase-tracking.tsfile
size-weighting.tsfile
DEFAULT_THRESHOLDSvariableDefault thresholds.
staleness.tsfile
add.test.tsfile
archive.test.tsfile
assignee.test.tsfile
atomicity.test.tsfile
cancel-ops.test.tsfile
complete-unblocks.test.tsfile
complete.test.tsfile
delete.test.tsfile
dependency-check.test.tsfile
deps-ready.test.tsfile
epic-enforcement.test.tsfile
find.test.tsfile
graph-ops.test.tsfile
hierarchy-policy.test.tsfile
hierarchy.test.tsfile
id-generator.test.tsfile
labels.test.tsfile
list.test.tsfile
minimal-test.test.tsfile
phase-tracking.test.tsfile
pipeline-stage.test.tsfile
plan-priority.test.tsfile
priority-normalization.test.tsfile
relates.test.tsfile
show-deps.test.tsfile
show.test.tsfile
staleness.test.tsfile
task-ops-depends.test.tsfile
update.test.tsfile
chain-validation.test.tsfile
compliance.test.tsfile
docs-sync.test.tsfile
doctor-gitignore.test.tsfile
doctor-injection.test.tsfile
doctor.test.tsfile
engine.test.tsfile
manifest.test.tsfile
protocol-common.test.tsfile
verification.test.tsfile