@cleocode/contracts 2026.4.30 → 2026.4.35

package/dist/brain.d.ts

@@ -6,6 +6,39 @@
  *
  * @task T5800
  */
+/**
+ * Memory retention tier values for the tiered cognitive memory model (T549).
+ *
+ * - `short`  — Session-scoped working context. Auto-evicted after TTL if not promoted.
+ * - `medium` — Project-scoped verified facts. Retained for weeks.
+ * - `long`   — Architectural bedrock. Permanent; supersession-only eviction.
+ */
+export type BrainMemoryTier = 'short' | 'medium' | 'long';
+/**
+ * Cognitive type taxonomy for brain entries (T549).
+ *
+ * NOTE: Named `BrainCognitiveType` (not `BrainMemoryType`) to avoid collision
+ * with the brain_memory_links entity type enum.
+ *
+ * - `semantic`   — Declarative facts: brain_decisions, brain_learnings (default)
+ * - `episodic`   — Event records: brain_observations, brain_learnings (transcript-derived)
+ * - `procedural` — Process knowledge: brain_patterns
+ */
+export type BrainCognitiveType = 'semantic' | 'episodic' | 'procedural';
+/**
+ * Source reliability levels for brain entries (T549 §3.1.5).
+ *
+ * Separate dimension from content `quality_score`. Each level drives a quality
+ * multiplier applied at scoring time:
+ *
+ * | Level         | Quality multiplier |
+ * |---------------|--------------------|
+ * | `owner`       | 1.0                |
+ * | `task-outcome`| 0.90               |
+ * | `agent`       | 0.70               |
+ * | `speculative` | 0.40               |
+ */
+export type BrainSourceConfidence = 'owner' | 'task-outcome' | 'agent' | 'speculative';
 /** Compact brain entry reference used in contradiction analysis. */
 export interface BrainEntryRef {
     /** Brain.db entry identifier. */

package/dist/brain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,iDAAiD;IACjD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,CAAC;AAEvF,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,iDAAiD;IACjD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/config.d.ts

@@ -164,6 +164,43 @@ export interface BrainSummarizationConfig {
     /** Whether session summarization is enabled (default: false). */
     enabled: boolean;
 }
+/**
+ * Brain tiered + typed memory configuration (T549).
+ *
+ * Controls the tiered cognitive memory model: tier promotion, eviction TTLs,
+ * and the sleep-time consolidator. All fields default to disabled/conservative
+ * values — the system requires explicit opt-in.
+ *
+ * @epic T549
+ */
+export interface BrainTieringConfig {
+    /**
+     * Enable write-time tier/type/source_confidence assignment and updated quality scoring.
+     * When false (default), new entries receive column defaults without routing logic overhead.
+     */
+    enabled: boolean;
+    /**
+     * Enable the sleep-time consolidator: runs tier promotion, eviction, and contradiction
+     * detection at session end (after VACUUM INTO backup). Fires as setImmediate — non-blocking.
+     * Requires `enabled: true` to take effect.
+     */
+    autoPromote: boolean;
+    /**
+     * Hours before unverified short-term entries are soft-evicted (default: 48).
+     * Set invalidAt on entries older than this threshold that were not promoted.
+     */
+    shortTermTtlHours: number;
+    /**
+     * Days before unverified medium-term entries are soft-evicted (default: 30).
+     * Medium-term entries with quality_score below the medium decay threshold are evicted.
+     */
+    mediumTermTtlDays: number;
+    /**
+     * Minimum citations for medium→long promotion via citation gate (default: 5).
+     * An entry at medium tier with citationCount >= promotionThreshold qualifies for long-term.
+     */
+    promotionThreshold: number;
+}
 /**
  * Brain (BRAIN memory system) configuration.
  * Controls automated memory capture, embedding generation, memory bridge
@@ -185,6 +222,14 @@ export interface BrainConfig {
     memoryBridge: BrainMemoryBridgeConfig;
     /** Session summarization settings. */
     summarization: BrainSummarizationConfig;
+    /**
+     * Tiered + typed memory settings (T549).
+     * Controls tier routing, sleep-time consolidation, and TTL-based eviction.
+     * All fields default to disabled. Opt-in required.
+     *
+     * @defaultValue { enabled: false, autoPromote: false, shortTermTtlHours: 48, mediumTermTtlDays: 30, promotionThreshold: 5 }
+     */
+    tiering?: BrainTieringConfig;
 }
 /**
  * Structured session summary input for ingestStructuredSummary().

package/dist/config.d.ts.map

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

package/dist/dependency.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+/**
+ * Classification of a CLEO dependency by necessity.
+ *
+ * - `required` — CLEO cannot function without this dependency.
+ * - `optional` — CLEO works without this but specific features are disabled.
+ * - `feature` — A bundled or internally-managed dependency (e.g. native addons).
+ */
+export type DependencyCategory = 'required' | 'optional' | 'feature';
+/**
+ * Static specification describing a single CLEO dependency.
+ *
+ * This is the registry entry — it does NOT carry check results.
+ * Use {@link DependencyCheckResult} for runtime check outcomes.
+ */
+export interface DependencySpec {
+    /** Canonical identifier used as a lookup key (e.g. `"git"`, `"gh"`). */
+    name: string;
+    /** Classification of the dependency by necessity. */
+    category: DependencyCategory;
+    /** Human-readable description of what the dependency is used for. */
+    description: string;
+    /** Semver-style constraint string (e.g. `">=24.0.0"`). Optional. */
+    versionConstraint?: string;
+    /** URL pointing to installation or documentation for this dependency. */
+    documentationUrl?: string;
+    /** Shell command to install the dependency (informational only). */
+    installCommand?: string;
+    /**
+     * Platforms on which this dependency applies.
+     * When absent the dependency is considered applicable on all platforms.
+     */
+    platforms?: ('linux' | 'darwin' | 'win32')[];
+}
+/**
+ * Runtime check result for a single CLEO dependency.
+ *
+ * Produced by `checkDependency()` and collected into a {@link DependencyReport}.
+ */
+export interface DependencyCheckResult {
+    /** Canonical identifier matching the corresponding {@link DependencySpec}. */
+    name: string;
+    /** Classification of the dependency (copied from its spec). */
+    category: DependencyCategory;
+    /** Whether the dependency is present on the system. */
+    installed: boolean;
+    /** Detected version string, if available (e.g. `"2.43.0"`). */
+    version?: string;
+    /** Filesystem path where the dependency was found (e.g. `/usr/bin/git`). */
+    location?: string;
+    /**
+     * Whether the dependency passes all health criteria.
+     *
+     * For `required` dependencies this means installed AND the version satisfies
+     * `versionConstraint`. For `optional` and `feature` dependencies a missing
+     * dependency is still considered healthy (the feature is simply disabled).
+     */
+    healthy: boolean;
+    /** Human-readable error or diagnostic message when `healthy` is `false`. */
+    error?: string;
+    /** Actionable fix suggestion to show the user when `healthy` is `false`. */
+    suggestedFix?: string;
+}
+/**
+ * Full dependency report produced by `checkAllDependencies()`.
+ *
+ * Intended for consumption by `coreDoctorReport()` and any CLI output layer.
+ */
+export interface DependencyReport {
+    /** ISO 8601 timestamp of when the report was generated. */
+    timestamp: string;
+    /** `process.platform` value at check time (e.g. `"linux"`, `"darwin"`). */
+    platform: string;
+    /** Node.js version string without the `v` prefix (e.g. `"24.0.0"`). */
+    nodeVersion: string;
+    /** Per-dependency check results. */
+    results: DependencyCheckResult[];
+    /**
+     * `true` when every `required` dependency is healthy.
+     * Optional and feature dependencies do not affect this flag.
+     */
+    allRequiredMet: boolean;
+    /** Non-fatal advisory messages (e.g. optional dep missing, feature unavailable). */
+    warnings: string[];
+}
+//# sourceMappingURL=dependency.d.ts.map

package/dist/dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../src/dependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/dependency.js

@@ -0,0 +1,11 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+export {};
+//# sourceMappingURL=dependency.js.map

package/dist/dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.js","sourceRoot":"","sources":["../src/dependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/graph.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+/**
+ * All supported symbol node kinds in the code intelligence graph.
+ *
+ * Covers file/folder structural nodes plus every symbol-level construct
+ * that tree-sitter can identify across TypeScript, JavaScript, and future
+ * language providers. Includes synthetic graph-level nodes produced by
+ * analysis phases (community detection, process detection, route extraction).
+ *
+ * @since T529 — expanded from T512 baseline with 17 new kinds
+ */
+export type GraphNodeKind = 'file' | 'folder' | 'module' | 'namespace' | 'function' | 'method' | 'constructor' | 'class' | 'interface' | 'struct' | 'trait' | 'impl' | 'type_alias' | 'enum' | 'property' | 'constant' | 'variable' | 'static' | 'record' | 'delegate' | 'macro' | 'union' | 'typedef' | 'annotation' | 'template' | 'community' | 'process' | 'route' | 'tool' | 'section' | 'import' | 'export' | 'type';
+/**
+ * All supported directed relationship types between graph nodes.
+ *
+ * Types are intentionally lowercase to match CLEO convention.
+ * Each type carries semantic meaning about the nature of the dependency.
+ *
+ * @since T529 — expanded from T512 baseline with 10 new relation types
+ */
+export type GraphRelationType = 'contains' | 'defines' | 'imports' | 'accesses' | 'calls' | 'extends' | 'implements' | 'method_overrides' | 'method_implements' | 'has_method' | 'has_property' | 'member_of' | 'step_in_process' | 'handles_route' | 'fetches' | 'handles_tool' | 'entry_point_of' | 'wraps' | 'queries' | 'documents' | 'applies_to';
+/**
+ * A node in the code intelligence graph representing a symbol or structural
+ * element extracted from source code.
+ *
+ * The `id` field is a stable identifier for the node, typically derived from
+ * the file path and symbol name (e.g., `src/foo.ts::parseFile`).
+ */
+export interface GraphNode {
+    /** Unique, stable node identifier. Typically `<filePath>::<name>`. */
+    id: string;
+    /** Kind of code element this node represents. */
+    kind: GraphNodeKind;
+    /** Symbol name as it appears in source code. */
+    name: string;
+    /** File path relative to the project root. */
+    filePath: string;
+    /** Start line in the source file (1-based). */
+    startLine: number;
+    /** End line in the source file (1-based). */
+    endLine: number;
+    /** Language of the source file (e.g., "typescript", "javascript"). */
+    language: string;
+    /** Whether the symbol is publicly exported from its module. */
+    exported: boolean;
+    /** Parent node ID, if this symbol is nested (e.g., method inside class). */
+    parent?: string;
+    /** Parameter names or signatures for functions and methods. */
+    parameters?: string[];
+    /** Return type annotation text, if available. */
+    returnType?: string;
+    /** First line of the TSDoc/JSDoc comment for this symbol, if present. */
+    docSummary?: string;
+    /** Community ID this node belongs to (set after Phase 5 community detection). */
+    communityId?: string;
+    /** Execution flow process IDs this node participates in (set after Phase 6). */
+    processIds?: string[];
+    /** Kind-specific metadata blob (matches nexus_nodes.meta_json). */
+    meta?: Record<string, unknown>;
+}
+/**
+ * A directed relationship between two nodes in the code intelligence graph.
+ *
+ * The `source` and `target` fields reference node IDs (see {@link GraphNode.id}).
+ * Confidence reflects how certain the extractor is about this relationship,
+ * from 0.0 (speculative) to 1.0 (statically verified).
+ */
+export interface GraphRelation {
+    /** ID of the originating node. */
+    source: string;
+    /** ID of the target node. */
+    target: string;
+    /** Semantic type of the relationship. */
+    type: GraphRelationType;
+    /**
+     * Extractor confidence for this relationship (0.0 to 1.0).
+     *
+     * Common values by type:
+     * - `calls` / `imports`: 0.9 (direct, strongly typed)
+     * - `extends` / `implements`: 0.85 (statically verifiable)
+     * - `has_method` / `has_property`: 0.95 (structural containment)
+     * - `accesses`: 0.8 (field read/write, may be indirect)
+     */
+    confidence: number;
+    /** Human-readable note explaining why this relation was emitted. */
+    reason?: string;
+}
+/**
+ * Result of a BFS-based impact analysis starting from a named symbol.
+ *
+ * Affected nodes are grouped into three depth tiers that reflect the
+ * likelihood and urgency of breakage:
+ *
+ * - **depth1_willBreak** (d=1): Direct callers/importers — WILL break.
+ *   Must be updated whenever the target changes.
+ * - **depth2_likelyAffected** (d=2): Indirect dependants — LIKELY affected.
+ *   Should be tested.
+ * - **depth3_mayNeedTesting** (d=3): Transitive dependants — MAY need testing.
+ *   Test if the symbol is on a critical path.
+ */
+export interface ImpactResult {
+    /** Name or ID of the symbol that was analyzed. */
+    target: string;
+    /**
+     * Overall risk classification based on the number and type of affected nodes.
+     *
+     * - `low`: 0–3 direct dependants, no cross-module spread
+     * - `medium`: 4–9 direct dependants, or limited cross-module spread
+     * - `high`: 10+ direct dependants, or significant cross-module spread
+     * - `critical`: Exported symbol with high cross-module usage
+     */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Human-readable summary of the impact analysis outcome. */
+    summary: string;
+    /** Nodes affected at each traversal depth. */
+    affectedByDepth: {
+        /** d=1: Direct dependants — WILL BREAK. */
+        depth1_willBreak: GraphNode[];
+        /** d=2: Indirect dependants — LIKELY AFFECTED. */
+        depth2_likelyAffected: GraphNode[];
+        /** d=3: Transitive dependants — MAY NEED TESTING. */
+        depth3_mayNeedTesting: GraphNode[];
+    };
+    /** Total number of affected nodes across all depths. */
+    totalAffected: number;
+}
+/**
+ * An in-memory symbol table entry tracking all files where a name appears.
+ * Used during ingestion to resolve cross-file call targets.
+ */
+export interface SymbolIndex {
+    /** Symbol name as it appears in source (e.g., "parseFile"). */
+    name: string;
+    /** All node IDs that define this name across the project. */
+    nodeIds: string[];
+    /** All file paths that export this name. */
+    exportingFiles: string[];
+}
+/**
+ * The in-memory KnowledgeGraph assembled during a single ingestion run.
+ * Flushed to nexus_nodes + nexus_relations after all phases complete.
+ */
+export interface KnowledgeGraph {
+    /** Primary node store: nodeId → GraphNode. */
+    nodes: Map<string, GraphNode>;
+    /** All directed edges (appended during ingestion, deduplicated at flush). */
+    relations: GraphRelation[];
+    /** Indexes for fast lookup during resolution phases. */
+    symbolTable: SymbolIndex[];
+    /** Files that changed since last index (incremental mode only). */
+    changedFiles?: Set<string>;
+}
+/**
+ * A community (module cluster) identified by Louvain community detection
+ * during Phase 5. Represents a group of cohesive symbols within the graph.
+ */
+export interface CommunityNode {
+    /** Node ID format: `community:<n>` */
+    id: string;
+    /** Inferred label from the top folder name. */
+    label: string;
+    /** Number of member symbols in this community. */
+    memberCount: number;
+    /** Top-level folders contributing most members. */
+    topFolders: string[];
+}
+/**
+ * A detected execution flow (process) from BFS entry point analysis
+ * during Phase 6. Represents a named sequence of function calls.
+ */
+export interface ProcessNode {
+    /** Node ID format: `process:<slug>` */
+    id: string;
+    /** Entry point function name used as the process label. */
+    label: string;
+    /** Node ID of the entry point function. */
+    entryPointId: string;
+    /** Ordered node IDs representing each step in the flow. */
+    stepIds: string[];
+    /** Total number of steps in this execution flow. */
+    stepCount: number;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

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

package/dist/graph.js

@@ -0,0 +1,12 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+export {};
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/index.d.ts

@@ -9,18 +9,20 @@ export type { AdapterHealthStatus, CLEOProviderAdapter } from './adapter.js';
 export type { AgentCredential, AgentListFilter, AgentRegistryAPI, AgentWithProjectOverride, ProjectAgentRef, TransportConfig, } from './agent-registry.js';
 export type { ArchiveCycleTimesReport, ArchiveDailyTrend, ArchivedTask, ArchiveLabelEntry, ArchiveMetadata, ArchiveMonthlyTrend, ArchivePhaseEntry, ArchivePriorityEntry, ArchiveReportType, ArchiveStatsEnvelope, ArchiveSummaryReport, ArchiveTrendsReport, CycleTimeDistribution, CycleTimePercentiles, } from './archive.js';
 export type { BackupDatabaseEntry, BackupGlobalFileEntry, BackupIntegrity, BackupJsonEntry, BackupManifest, BackupMetadata, BackupScope, } from './backup-manifest.js';
-export type { BrainEntryRef, BrainEntrySummary, ContradictionDetail, SupersededEntry, } from './brain.js';
+export type { BrainCognitiveType, BrainEntryRef, BrainEntrySummary, BrainMemoryTier, BrainSourceConfidence, ContradictionDetail, SupersededEntry, } from './brain.js';
 export type { AdapterCapabilities } from './capabilities.js';
 export type { BatchParseResult, CodeSymbol, CodeSymbolKind, ParseResult, } from './code-symbol.js';
 export type { Conduit, ConduitConfig, ConduitMessage, ConduitSendOptions, ConduitSendResult, ConduitState, ConduitStateChange, ConduitUnsubscribe, } from './conduit.js';
-export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, OutputConfig, OutputFormat, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
+export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, BrainTieringConfig, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, OutputConfig, OutputFormat, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
 export type { AdapterContextMonitorProvider } from './context-monitor.js';
 export type { ArchiveFields, ArchiveFile, DataAccessor, DataAccessorAgentInstance, QueryTasksResult, TaskFieldUpdates, TaskQueryFilters, TransactionAccessor, } from './data-accessor.js';
+export type { DependencyCategory, DependencyCheckResult, DependencyReport, DependencySpec, } from './dependency.js';
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
 export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
 export { ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
 export type { AdminAPI, AgentCapacity, AgentHealthStatus, AgentInstanceRow, AgentInstanceStatus, AgentsAPI, AgentType, BlastRadius, BlastRadiusSeverity, BrainObservationType, CleoInitOptions, DuplicateStrategy, HybridSearchOptions, ImpactedTask, ImpactReport, ImportParams, IntelligenceAPI, LifecycleAPI, MemoryAPI, NexusAPI, OrchestrationAPI, RegisterAgentOptions, ReleaseAPI, SessionsAPI, StickyAPI, SyncAPI, TaskStartResult, TasksAPI, } from './facade.js';
 export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from './facade.js';
+export type { CommunityNode, GraphNode, GraphNodeKind, GraphRelation, GraphRelationType, ImpactResult, KnowledgeGraph, ProcessNode, SymbolIndex, } from './graph.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type { CleoResponse, ConformanceReport, FlagInput, GatewayEnvelope, GatewayError, GatewayMeta, GatewaySuccess, LAFSEnvelope, LAFSError, LAFSErrorCategory, LAFSMeta, LAFSPage, LAFSPageNone, LAFSPageOffset, LAFSTransport, LafsAlternative, LafsEnvelope, LafsError, LafsErrorDetail, LafsSuccess, MVILevel, Warning, } from './lafs.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAE1E,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,aAAa,EACb,KAAK,UAAU,EACf,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,cAAc,EAEnB,qBAAqB,EACrB,KAAK,cAAc,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,EAChB,yBAAyB,EACzB,2BAA2B,EAE3B,aAAa,EAEb,KAAK,UAAU,EACf,0BAA0B,EAC1B,uBAAuB,EAEvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,QAAQ,EACR,KAAK,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,aAAa,EACb,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,wBAAwB,EACxB,SAAS,EACT,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,UAAU,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyGH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AA2BrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoHH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.4.30",
+  "version": "2026.4.35",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/brain.ts

@@ -7,6 +7,46 @@
  * @task T5800
  */
 
+// ============================================================
+// T549: Tiered + Typed Memory Architecture types
+// ============================================================
+
+/**
+ * Memory retention tier values for the tiered cognitive memory model (T549).
+ *
+ * - `short`  — Session-scoped working context. Auto-evicted after TTL if not promoted.
+ * - `medium` — Project-scoped verified facts. Retained for weeks.
+ * - `long`   — Architectural bedrock. Permanent; supersession-only eviction.
+ */
+export type BrainMemoryTier = 'short' | 'medium' | 'long';
+
+/**
+ * Cognitive type taxonomy for brain entries (T549).
+ *
+ * NOTE: Named `BrainCognitiveType` (not `BrainMemoryType`) to avoid collision
+ * with the brain_memory_links entity type enum.
+ *
+ * - `semantic`   — Declarative facts: brain_decisions, brain_learnings (default)
+ * - `episodic`   — Event records: brain_observations, brain_learnings (transcript-derived)
+ * - `procedural` — Process knowledge: brain_patterns
+ */
+export type BrainCognitiveType = 'semantic' | 'episodic' | 'procedural';
+
+/**
+ * Source reliability levels for brain entries (T549 §3.1.5).
+ *
+ * Separate dimension from content `quality_score`. Each level drives a quality
+ * multiplier applied at scoring time:
+ *
+ * | Level         | Quality multiplier |
+ * |---------------|--------------------|
+ * | `owner`       | 1.0                |
+ * | `task-outcome`| 0.90               |
+ * | `agent`       | 0.70               |
+ * | `speculative` | 0.40               |
+ */
+export type BrainSourceConfidence = 'owner' | 'task-outcome' | 'agent' | 'speculative';
+
 /** Compact brain entry reference used in contradiction analysis. */
 export interface BrainEntryRef {
   /** Brain.db entry identifier. */

package/src/config.ts

@@ -186,6 +186,44 @@ export interface BrainSummarizationConfig {
   enabled: boolean;
 }
 
+/**
+ * Brain tiered + typed memory configuration (T549).
+ *
+ * Controls the tiered cognitive memory model: tier promotion, eviction TTLs,
+ * and the sleep-time consolidator. All fields default to disabled/conservative
+ * values — the system requires explicit opt-in.
+ *
+ * @epic T549
+ */
+export interface BrainTieringConfig {
+  /**
+   * Enable write-time tier/type/source_confidence assignment and updated quality scoring.
+   * When false (default), new entries receive column defaults without routing logic overhead.
+   */
+  enabled: boolean;
+  /**
+   * Enable the sleep-time consolidator: runs tier promotion, eviction, and contradiction
+   * detection at session end (after VACUUM INTO backup). Fires as setImmediate — non-blocking.
+   * Requires `enabled: true` to take effect.
+   */
+  autoPromote: boolean;
+  /**
+   * Hours before unverified short-term entries are soft-evicted (default: 48).
+   * Set invalidAt on entries older than this threshold that were not promoted.
+   */
+  shortTermTtlHours: number;
+  /**
+   * Days before unverified medium-term entries are soft-evicted (default: 30).
+   * Medium-term entries with quality_score below the medium decay threshold are evicted.
+   */
+  mediumTermTtlDays: number;
+  /**
+   * Minimum citations for medium→long promotion via citation gate (default: 5).
+   * An entry at medium tier with citationCount >= promotionThreshold qualifies for long-term.
+   */
+  promotionThreshold: number;
+}
+
 /**
  * Brain (BRAIN memory system) configuration.
  * Controls automated memory capture, embedding generation, memory bridge
@@ -207,6 +245,14 @@ export interface BrainConfig {
   memoryBridge: BrainMemoryBridgeConfig;
   /** Session summarization settings. */
   summarization: BrainSummarizationConfig;
+  /**
+   * Tiered + typed memory settings (T549).
+   * Controls tier routing, sleep-time consolidation, and TTL-based eviction.
+   * All fields default to disabled. Opt-in required.
+   *
+   * @defaultValue { enabled: false, autoPromote: false, shortTermTtlHours: 48, mediumTermTtlDays: 30, promotionThreshold: 5 }
+   */
+  tiering?: BrainTieringConfig;
 }
 
 /**

package/src/dependency.ts

@@ -0,0 +1,97 @@
+/**
+ * Dependency registry contracts for CLEO runtime dependency verification.
+ *
+ * This is the single source of truth (SSoT) for all CLEO dependency types.
+ * All health check systems that inspect external dependencies MUST use these
+ * contracts rather than defining inline or ad-hoc types.
+ *
+ * @task T507
+ */
+
+/**
+ * Classification of a CLEO dependency by necessity.
+ *
+ * - `required` — CLEO cannot function without this dependency.
+ * - `optional` — CLEO works without this but specific features are disabled.
+ * - `feature` — A bundled or internally-managed dependency (e.g. native addons).
+ */
+export type DependencyCategory = 'required' | 'optional' | 'feature';
+
+/**
+ * Static specification describing a single CLEO dependency.
+ *
+ * This is the registry entry — it does NOT carry check results.
+ * Use {@link DependencyCheckResult} for runtime check outcomes.
+ */
+export interface DependencySpec {
+  /** Canonical identifier used as a lookup key (e.g. `"git"`, `"gh"`). */
+  name: string;
+  /** Classification of the dependency by necessity. */
+  category: DependencyCategory;
+  /** Human-readable description of what the dependency is used for. */
+  description: string;
+  /** Semver-style constraint string (e.g. `">=24.0.0"`). Optional. */
+  versionConstraint?: string;
+  /** URL pointing to installation or documentation for this dependency. */
+  documentationUrl?: string;
+  /** Shell command to install the dependency (informational only). */
+  installCommand?: string;
+  /**
+   * Platforms on which this dependency applies.
+   * When absent the dependency is considered applicable on all platforms.
+   */
+  platforms?: ('linux' | 'darwin' | 'win32')[];
+}
+
+/**
+ * Runtime check result for a single CLEO dependency.
+ *
+ * Produced by `checkDependency()` and collected into a {@link DependencyReport}.
+ */
+export interface DependencyCheckResult {
+  /** Canonical identifier matching the corresponding {@link DependencySpec}. */
+  name: string;
+  /** Classification of the dependency (copied from its spec). */
+  category: DependencyCategory;
+  /** Whether the dependency is present on the system. */
+  installed: boolean;
+  /** Detected version string, if available (e.g. `"2.43.0"`). */
+  version?: string;
+  /** Filesystem path where the dependency was found (e.g. `/usr/bin/git`). */
+  location?: string;
+  /**
+   * Whether the dependency passes all health criteria.
+   *
+   * For `required` dependencies this means installed AND the version satisfies
+   * `versionConstraint`. For `optional` and `feature` dependencies a missing
+   * dependency is still considered healthy (the feature is simply disabled).
+   */
+  healthy: boolean;
+  /** Human-readable error or diagnostic message when `healthy` is `false`. */
+  error?: string;
+  /** Actionable fix suggestion to show the user when `healthy` is `false`. */
+  suggestedFix?: string;
+}
+
+/**
+ * Full dependency report produced by `checkAllDependencies()`.
+ *
+ * Intended for consumption by `coreDoctorReport()` and any CLI output layer.
+ */
+export interface DependencyReport {
+  /** ISO 8601 timestamp of when the report was generated. */
+  timestamp: string;
+  /** `process.platform` value at check time (e.g. `"linux"`, `"darwin"`). */
+  platform: string;
+  /** Node.js version string without the `v` prefix (e.g. `"24.0.0"`). */
+  nodeVersion: string;
+  /** Per-dependency check results. */
+  results: DependencyCheckResult[];
+  /**
+   * `true` when every `required` dependency is healthy.
+   * Optional and feature dependencies do not affect this flag.
+   */
+  allRequiredMet: boolean;
+  /** Non-fatal advisory messages (e.g. optional dep missing, feature unavailable). */
+  warnings: string[];
+}

package/src/graph.ts

@@ -0,0 +1,297 @@
+/**
+ * Graph type contracts for CLEO code intelligence.
+ *
+ * Defines the node types, relationship types, and structures that form the
+ * foundation of the code intelligence graph. Ported from GitNexus graph
+ * primitives and adapted for CLEO's lightweight, in-process use case.
+ *
+ * @task T512
+ * @module contracts/graph
+ */
+
+// ---------------------------------------------------------------------------
+// Node kinds
+// ---------------------------------------------------------------------------
+
+/**
+ * All supported symbol node kinds in the code intelligence graph.
+ *
+ * Covers file/folder structural nodes plus every symbol-level construct
+ * that tree-sitter can identify across TypeScript, JavaScript, and future
+ * language providers. Includes synthetic graph-level nodes produced by
+ * analysis phases (community detection, process detection, route extraction).
+ *
+ * @since T529 — expanded from T512 baseline with 17 new kinds
+ */
+export type GraphNodeKind =
+  // Structural
+  | 'file'
+  | 'folder'
+  // Module-level
+  | 'module'
+  | 'namespace'
+  // Callable
+  | 'function'
+  | 'method'
+  | 'constructor'
+  // Type hierarchy
+  | 'class'
+  | 'interface'
+  | 'struct'
+  | 'trait'
+  | 'impl'
+  | 'type_alias'
+  | 'enum'
+  // Value-level
+  | 'property'
+  | 'constant'
+  | 'variable'
+  | 'static'
+  | 'record'
+  | 'delegate'
+  // Language-specific constructs
+  | 'macro'
+  | 'union'
+  | 'typedef'
+  | 'annotation'
+  | 'template'
+  // Graph-level (synthetic, from analysis phases)
+  | 'community'
+  | 'process'
+  | 'route'
+  | 'tool'
+  | 'section'
+  // Legacy (kept for T506 compatibility)
+  | 'import'
+  | 'export'
+  | 'type';
+
+// ---------------------------------------------------------------------------
+// Relationship types
+// ---------------------------------------------------------------------------
+
+/**
+ * All supported directed relationship types between graph nodes.
+ *
+ * Types are intentionally lowercase to match CLEO convention.
+ * Each type carries semantic meaning about the nature of the dependency.
+ *
+ * @since T529 — expanded from T512 baseline with 10 new relation types
+ */
+export type GraphRelationType =
+  // Structural
+  | 'contains'
+  // Definition / usage
+  | 'defines'
+  | 'imports'
+  | 'accesses'
+  // Callable
+  | 'calls'
+  // Type hierarchy
+  | 'extends'
+  | 'implements'
+  | 'method_overrides'
+  | 'method_implements'
+  // Class structure
+  | 'has_method'
+  | 'has_property'
+  // Graph-level (synthetic, from analysis phases)
+  | 'member_of' // symbol → community node
+  | 'step_in_process' // symbol → process node
+  // Web / API
+  | 'handles_route' // function → route node
+  | 'fetches' // function → external URL
+  // Tool / agent
+  | 'handles_tool'
+  | 'entry_point_of' // function → process node
+  // Wrapping / delegation
+  | 'wraps'
+  // Data access
+  | 'queries'
+  // Cross-graph (brain integration)
+  | 'documents' // brain node → nexus node
+  | 'applies_to'; // brain decision/learning → nexus node
+
+// ---------------------------------------------------------------------------
+// Node interface
+// ---------------------------------------------------------------------------
+
+/**
+ * A node in the code intelligence graph representing a symbol or structural
+ * element extracted from source code.
+ *
+ * The `id` field is a stable identifier for the node, typically derived from
+ * the file path and symbol name (e.g., `src/foo.ts::parseFile`).
+ */
+export interface GraphNode {
+  /** Unique, stable node identifier. Typically `<filePath>::<name>`. */
+  id: string;
+  /** Kind of code element this node represents. */
+  kind: GraphNodeKind;
+  /** Symbol name as it appears in source code. */
+  name: string;
+  /** File path relative to the project root. */
+  filePath: string;
+  /** Start line in the source file (1-based). */
+  startLine: number;
+  /** End line in the source file (1-based). */
+  endLine: number;
+  /** Language of the source file (e.g., "typescript", "javascript"). */
+  language: string;
+  /** Whether the symbol is publicly exported from its module. */
+  exported: boolean;
+  /** Parent node ID, if this symbol is nested (e.g., method inside class). */
+  parent?: string;
+  /** Parameter names or signatures for functions and methods. */
+  parameters?: string[];
+  /** Return type annotation text, if available. */
+  returnType?: string;
+  /** First line of the TSDoc/JSDoc comment for this symbol, if present. */
+  docSummary?: string;
+  /** Community ID this node belongs to (set after Phase 5 community detection). */
+  communityId?: string;
+  /** Execution flow process IDs this node participates in (set after Phase 6). */
+  processIds?: string[];
+  /** Kind-specific metadata blob (matches nexus_nodes.meta_json). */
+  meta?: Record<string, unknown>;
+}
+
+// ---------------------------------------------------------------------------
+// Relation interface
+// ---------------------------------------------------------------------------
+
+/**
+ * A directed relationship between two nodes in the code intelligence graph.
+ *
+ * The `source` and `target` fields reference node IDs (see {@link GraphNode.id}).
+ * Confidence reflects how certain the extractor is about this relationship,
+ * from 0.0 (speculative) to 1.0 (statically verified).
+ */
+export interface GraphRelation {
+  /** ID of the originating node. */
+  source: string;
+  /** ID of the target node. */
+  target: string;
+  /** Semantic type of the relationship. */
+  type: GraphRelationType;
+  /**
+   * Extractor confidence for this relationship (0.0 to 1.0).
+   *
+   * Common values by type:
+   * - `calls` / `imports`: 0.9 (direct, strongly typed)
+   * - `extends` / `implements`: 0.85 (statically verifiable)
+   * - `has_method` / `has_property`: 0.95 (structural containment)
+   * - `accesses`: 0.8 (field read/write, may be indirect)
+   */
+  confidence: number;
+  /** Human-readable note explaining why this relation was emitted. */
+  reason?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Impact analysis result
+// ---------------------------------------------------------------------------
+
+/**
+ * Result of a BFS-based impact analysis starting from a named symbol.
+ *
+ * Affected nodes are grouped into three depth tiers that reflect the
+ * likelihood and urgency of breakage:
+ *
+ * - **depth1_willBreak** (d=1): Direct callers/importers — WILL break.
+ *   Must be updated whenever the target changes.
+ * - **depth2_likelyAffected** (d=2): Indirect dependants — LIKELY affected.
+ *   Should be tested.
+ * - **depth3_mayNeedTesting** (d=3): Transitive dependants — MAY need testing.
+ *   Test if the symbol is on a critical path.
+ */
+export interface ImpactResult {
+  /** Name or ID of the symbol that was analyzed. */
+  target: string;
+  /**
+   * Overall risk classification based on the number and type of affected nodes.
+   *
+   * - `low`: 0–3 direct dependants, no cross-module spread
+   * - `medium`: 4–9 direct dependants, or limited cross-module spread
+   * - `high`: 10+ direct dependants, or significant cross-module spread
+   * - `critical`: Exported symbol with high cross-module usage
+   */
+  riskLevel: 'low' | 'medium' | 'high' | 'critical';
+  /** Human-readable summary of the impact analysis outcome. */
+  summary: string;
+  /** Nodes affected at each traversal depth. */
+  affectedByDepth: {
+    /** d=1: Direct dependants — WILL BREAK. */
+    depth1_willBreak: GraphNode[];
+    /** d=2: Indirect dependants — LIKELY AFFECTED. */
+    depth2_likelyAffected: GraphNode[];
+    /** d=3: Transitive dependants — MAY NEED TESTING. */
+    depth3_mayNeedTesting: GraphNode[];
+  };
+  /** Total number of affected nodes across all depths. */
+  totalAffected: number;
+}
+
+// ---------------------------------------------------------------------------
+// Pipeline interfaces (T529)
+// ---------------------------------------------------------------------------
+
+/**
+ * An in-memory symbol table entry tracking all files where a name appears.
+ * Used during ingestion to resolve cross-file call targets.
+ */
+export interface SymbolIndex {
+  /** Symbol name as it appears in source (e.g., "parseFile"). */
+  name: string;
+  /** All node IDs that define this name across the project. */
+  nodeIds: string[];
+  /** All file paths that export this name. */
+  exportingFiles: string[];
+}
+
+/**
+ * The in-memory KnowledgeGraph assembled during a single ingestion run.
+ * Flushed to nexus_nodes + nexus_relations after all phases complete.
+ */
+export interface KnowledgeGraph {
+  /** Primary node store: nodeId → GraphNode. */
+  nodes: Map<string, GraphNode>;
+  /** All directed edges (appended during ingestion, deduplicated at flush). */
+  relations: GraphRelation[];
+  /** Indexes for fast lookup during resolution phases. */
+  symbolTable: SymbolIndex[];
+  /** Files that changed since last index (incremental mode only). */
+  changedFiles?: Set<string>;
+}
+
+/**
+ * A community (module cluster) identified by Louvain community detection
+ * during Phase 5. Represents a group of cohesive symbols within the graph.
+ */
+export interface CommunityNode {
+  /** Node ID format: `community:<n>` */
+  id: string;
+  /** Inferred label from the top folder name. */
+  label: string;
+  /** Number of member symbols in this community. */
+  memberCount: number;
+  /** Top-level folders contributing most members. */
+  topFolders: string[];
+}
+
+/**
+ * A detected execution flow (process) from BFS entry point analysis
+ * during Phase 6. Represents a named sequence of function calls.
+ */
+export interface ProcessNode {
+  /** Node ID format: `process:<slug>` */
+  id: string;
+  /** Entry point function name used as the process label. */
+  label: string;
+  /** Node ID of the entry point function. */
+  entryPointId: string;
+  /** Ordered node IDs representing each step in the flow. */
+  stepIds: string[];
+  /** Total number of steps in this execution flow. */
+  stepCount: number;
+}

package/src/index.ts

@@ -46,8 +46,11 @@ export type {
 } from './backup-manifest.js';
 // === Brain/Memory Types ===
 export type {
+  BrainCognitiveType,
   BrainEntryRef,
   BrainEntrySummary,
+  BrainMemoryTier,
+  BrainSourceConfidence,
   ContradictionDetail,
   SupersededEntry,
 } from './brain.js';
@@ -77,6 +80,7 @@ export type {
   BrainEmbeddingConfig,
   BrainMemoryBridgeConfig,
   BrainSummarizationConfig,
+  BrainTieringConfig,
   CleoConfig,
   ConfigSource,
   DateFormat,
@@ -108,6 +112,13 @@ export type {
   TaskQueryFilters,
   TransactionAccessor,
 } from './data-accessor.js';
+// === Dependency Registry Contracts ===
+export type {
+  DependencyCategory,
+  DependencyCheckResult,
+  DependencyReport,
+  DependencySpec,
+} from './dependency.js';
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
 // === Error Utilities ===
 export {
@@ -164,6 +175,18 @@ export {
   AGENT_TYPES,
   BRAIN_OBSERVATION_TYPES,
 } from './facade.js';
+// === Graph Intelligence Types (T512, T529) ===
+export type {
+  CommunityNode,
+  GraphNode,
+  GraphNodeKind,
+  GraphRelation,
+  GraphRelationType,
+  ImpactResult,
+  KnowledgeGraph,
+  ProcessNode,
+  SymbolIndex,
+} from './graph.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type {