cognitive-core 0.1.0 → 0.1.2

package/dist/types/dataclaw.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+// ============================================================================
+// DataClaw — types for the dataclaw JSONL trajectory export format
+// https://github.com/peteromallet/dataclaw
+//
+// DataClaw exports conversation histories from AI coding assistants
+// (Claude Code, Codex, Gemini CLI, OpenCode, etc.) into structured JSONL
+// datasets. Each line is one complete coding session.
+// ============================================================================
+/**
+ * A tool invocation within a dataclaw assistant message.
+ */
+export const DataclawToolUseSchema = z.object({
+    /** Tool name (e.g. "bash", "Read", "Write", "Grep", "exec_command") */
+    tool: z.string(),
+    /** Structured arguments passed to the tool */
+    input: z.record(z.unknown()).default({}),
+    /** Execution result — shape varies by source */
+    output: z.record(z.unknown()).default({}),
+    /** "success" or "error" */
+    status: z.string().default('success'),
+});
+/**
+ * A single conversation turn in a dataclaw session.
+ */
+export const DataclawMessageSchema = z.object({
+    /** "user" or "assistant" */
+    role: z.enum(['user', 'assistant']),
+    /** The text content of the message */
+    content: z.string().default(''),
+    /** Extended reasoning / chain-of-thought (optional, Claude-specific) */
+    thinking: z.string().nullable().optional(),
+    /** Tool invocations on assistant messages */
+    tool_uses: z.array(DataclawToolUseSchema).optional(),
+    /** ISO 8601 timestamp */
+    timestamp: z.string().nullable().optional(),
+});
+/**
+ * Aggregate statistics for a dataclaw session.
+ */
+export const DataclawStatsSchema = z.object({
+    user_messages: z.number().default(0),
+    assistant_messages: z.number().default(0),
+    tool_uses: z.number().default(0),
+    input_tokens: z.number().default(0),
+    output_tokens: z.number().default(0),
+});
+/**
+ * A complete coding session — one line of the dataclaw JSONL export.
+ */
+export const DataclawSessionSchema = z.object({
+    /** Unique session identifier */
+    session_id: z.string(),
+    /** Project/directory name (anonymized) */
+    project: z.string().default(''),
+    /** AI model used (e.g. "claude-opus-4-6") */
+    model: z.string().default(''),
+    /** Source tool ("claude", "codex", "gemini", "opencode", "openclaw", "kimi", "custom") */
+    source: z.string().default(''),
+    /** Git branch active during the session */
+    git_branch: z.string().nullable().optional(),
+    /** ISO 8601 start time */
+    start_time: z.string().nullable().optional(),
+    /** ISO 8601 end time */
+    end_time: z.string().nullable().optional(),
+    /** Ordered conversation turns */
+    messages: z.array(DataclawMessageSchema).default([]),
+    /** Aggregate session stats */
+    stats: DataclawStatsSchema.optional(),
+});
+/**
+ * Export-level metadata (metadata.json companion file).
+ */
+export const DataclawMetadataSchema = z.object({
+    sessions: z.number().default(0),
+    skipped: z.number().default(0),
+    redactions: z.number().default(0),
+    models: z.record(z.number()).default({}),
+    projects: z.array(z.string()).default([]),
+    total_input_tokens: z.number().default(0),
+    total_output_tokens: z.number().default(0),
+    exported_at: z.string().optional(),
+});
+//# sourceMappingURL=dataclaw.js.map

package/dist/types/dataclaw.js.map

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

package/dist/types/index.d.ts

@@ -5,5 +5,12 @@ export { type Trajectory, TrajectorySchema, createTrajectory, isSuccessful, getK
 export { type Experience, type CodeConcept, type Strategy, type Skill, ExperienceSchema, CodeConceptSchema, StrategySchema, SkillSchema, createExperience, createConcept, createStrategy, createSkill, } from './memory.js';
 export { type Playbook, type PlaybookApplicability, type PlaybookGuidance, type PlaybookVerification, type PlaybookEvolution, type PlaybookProvenance, type PlaybookOrigin, type FailureRecord, type Refinement, type PlaybookComplexity, createPlaybook, bumpPlaybookVersion, getPlaybookSuccessRate, hasReliableStats, } from './playbook.js';
 export { type MetaObservation, type RoutingObservation, type RoutingDecisionType, type MemoryUsageObservation, type RetrievalQuality, type ExecutionObservation, type OutcomeObservation, type OutcomeQuality, type LessonsLearned, type MetaStrategy, type MetaStrategyCondition, type MetaStrategyAdjustment, type RoutingAnalysis, type RetrievalAnalysis, type MetaStats, type MetaContext, createMetaObservation, createMetaStrategy, } from './meta.js';
-export { type CreditStrategy, type PatternExtractor, type LearningConfig, type RouterConfig, type MemoryConfig, type MemoryCapacityConfig, type StorageConfig, type EmbeddingProviderType, type EmbeddingConfig, type ExecutionBackend, type ExecutionConfig, type RefinementConfig, type SkillPromotionConfig, type SkillLimitsConfig, type SkillContextConfig, type SkillDemotionConfig, type SkillLibraryConfig, type MCPServerConfig, type AtlasConfig, CreditStrategySchema, PatternExtractorSchema, LearningConfigSchema, RouterConfigSchema, MemoryConfigSchema, MemoryCapacityConfigSchema, StorageConfigSchema, EmbeddingProviderTypeSchema, EmbeddingConfigSchema, ExecutionBackendSchema, ExecutionConfigSchema, RefinementConfigSchema, SkillPromotionConfigSchema, SkillLimitsConfigSchema, SkillContextConfigSchema, SkillDemotionConfigSchema, SkillLibraryConfigSchema, MCPServerConfigSchema, AtlasConfigSchema, createDefaultConfig, mergeConfig, } from './config.js';
+export { type TeamTrajectory, type TeamEvent, type TeamEventType, type InteractionEdge, type CoordinationMetrics, type MemberOutcome, type TeamOutcome, type InteractionType, type InteractionTag, type ExpectedInteractionPattern, type TeamTrajectoryInput, type MemberTrajectoryInput, type MemberTrajectory, type AgentInteraction, type GraphStructuralMetrics, createTeamTrajectory, isTeamSuccessful, buildInteractionGraph, buildTeamTrajectory, } from './team-trajectory.js';
+export { type TeamPlaybook, type TeamPlaybookApplicability, type TeamCompositionGuidance, type TeamRoleSpec, type TeamCoordinationGuidance, type TeamChannelSpec, type InteractionPattern, type TeamPlaybookVerification, type TeamPlaybookEvolution, type TeamRefinement, type RolePlaybook, type RoleTeamContext, type RoleGuidance, type RoleInteractionGuidance, type RoleDecisionFramework, type RolePlaybookEvolution, type RolePlaybookReference, type RelatedTaskPlaybook, createTeamPlaybook, createRolePlaybook, getTeamPlaybookSuccessRate, getRolePlaybookSuccessRate, } from './team-playbook.js';
+export { type TeamMetaObservation, type FormationObservation, type CompositionObservation, type CoordinationObservation, type TeamOutcomeObservation, type TeamLessonsLearned, type TeamMetaStrategy, type TeamMetaCondition, type TeamMetaAdjustment, createTeamMetaObservation, createTeamMetaStrategy, } from './team-meta.js';
+export { type KnowledgeNoteFrontmatter, type KnowledgeNote, type KnowledgeMatch, type KnowledgeSource, type KnowledgeLink, type NoteType, type LinkRelation, type SourceOrigin, type GraphLayerName, type EntityUpdate, type Contradiction, type PlaybookLink as KnowledgePlaybookLink, type NewLink, type ExtractedKnowledge, type InboxResult, type DefragResult, type DecayResult, type KnowledgeStats, KnowledgeNoteFrontmatterSchema, NoteTypeSchema, LinkRelationSchema, GraphLayerNameSchema, AllLinkRelations, inferLayerFromRelation, createObservation, createEntityNote, createDomainSummary, } from './knowledge.js';
+export { type GraphNode, type GraphEdge, type GraphLayer, type KnowledgeMultiGraph, type GraphLayerOperations, type GraphNodeFilter, type NeighborOptions, type KnowledgeGraphManagerInterface, type GraphConfig, DEFAULT_GRAPH_CONFIG, SEMANTIC_RELATIONS, TEMPORAL_RELATIONS, CAUSAL_RELATIONS, ENTITY_RELATIONS, } from './knowledge-graph.js';
+export { type TrajectorySource, type TrajectoryWithAnalysis, type TrajectoryLoadOptions, } from './trajectory-source.js';
+export { type DataclawSession, type DataclawMessage, type DataclawToolUse, type DataclawStats, type DataclawMetadata, DataclawSessionSchema, DataclawMessageSchema, DataclawToolUseSchema, DataclawStatsSchema, DataclawMetadataSchema, } from './dataclaw.js';
+export { type CreditStrategy, type PatternExtractor, type LearningConfig, type RouterConfig, type MemoryConfig, type MemoryCapacityConfig, type StorageConfig, type EmbeddingProviderType, type EmbeddingConfig, type ExecutionBackend, type ExecutionConfig, type RefinementConfig, type SkillPromotionConfig, type SkillLimitsConfig, type SkillContextConfig, type SkillDemotionConfig, type SkillLibraryConfig, type MCPServerConfig, type CompressionConfig, type TeamLearningConfig, type AgenticTaskRunnerConfig, type KnowledgeBankConfig, type KnowledgeExtractionConfig, type KnowledgeSurfacingConfig, type ConfidenceConfig, type GraphConfigType, type DefragConfig, type SkillTreeConfig, type SessionBankConfig, type AtlasConfig, SessionBankConfigSchema, KnowledgeBankConfigSchema, KnowledgeExtractionConfigSchema, KnowledgeSurfacingConfigSchema, ConfidenceConfigSchema, GraphConfigSchema, DefragConfigSchema, CreditStrategySchema, PatternExtractorSchema, LearningConfigSchema, RouterConfigSchema, MemoryConfigSchema, MemoryCapacityConfigSchema, StorageConfigSchema, EmbeddingProviderTypeSchema, EmbeddingConfigSchema, ExecutionBackendSchema, ExecutionConfigSchema, RefinementConfigSchema, SkillPromotionConfigSchema, SkillLimitsConfigSchema, SkillContextConfigSchema, SkillDemotionConfigSchema, SkillLibraryConfigSchema, MCPServerConfigSchema, CompressionConfigSchema, TeamLearningConfigSchema, AgenticTaskRunnerConfigSchema, SkillTreeConfigSchema, AtlasConfigSchema, createDefaultConfig, mergeConfig, } from './config.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,UAAU,EACV,sBAAsB,EACtB,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,IAAI,EACT,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,OAAO,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -9,6 +9,18 @@ export { ExperienceSchema, CodeConceptSchema, StrategySchema, SkillSchema, creat
 export { createPlaybook, bumpPlaybookVersion, getPlaybookSuccessRate, hasReliableStats, } from './playbook.js';
 // Meta-learning types
 export { createMetaObservation, createMetaStrategy, } from './meta.js';
+// Team trajectory types
+export { createTeamTrajectory, isTeamSuccessful, buildInteractionGraph, buildTeamTrajectory, } from './team-trajectory.js';
+// Team playbook types
+export { createTeamPlaybook, createRolePlaybook, getTeamPlaybookSuccessRate, getRolePlaybookSuccessRate, } from './team-playbook.js';
+// Team meta-learning types
+export { createTeamMetaObservation, createTeamMetaStrategy, } from './team-meta.js';
+// Knowledge types
+export { KnowledgeNoteFrontmatterSchema, NoteTypeSchema, LinkRelationSchema, GraphLayerNameSchema, AllLinkRelations, inferLayerFromRelation, createObservation, createEntityNote, createDomainSummary, } from './knowledge.js';
+// Knowledge graph types
+export { DEFAULT_GRAPH_CONFIG, SEMANTIC_RELATIONS, TEMPORAL_RELATIONS, CAUSAL_RELATIONS, ENTITY_RELATIONS, } from './knowledge-graph.js';
+// DataClaw types (dataclaw JSONL trajectory exports)
+export { DataclawSessionSchema, DataclawMessageSchema, DataclawToolUseSchema, DataclawStatsSchema, DataclawMetadataSchema, } from './dataclaw.js';
 // Configuration types
-export { CreditStrategySchema, PatternExtractorSchema, LearningConfigSchema, RouterConfigSchema, MemoryConfigSchema, MemoryCapacityConfigSchema, StorageConfigSchema, EmbeddingProviderTypeSchema, EmbeddingConfigSchema, ExecutionBackendSchema, ExecutionConfigSchema, RefinementConfigSchema, SkillPromotionConfigSchema, SkillLimitsConfigSchema, SkillContextConfigSchema, SkillDemotionConfigSchema, SkillLibraryConfigSchema, MCPServerConfigSchema, AtlasConfigSchema, createDefaultConfig, mergeConfig, } from './config.js';
+export { SessionBankConfigSchema, KnowledgeBankConfigSchema, KnowledgeExtractionConfigSchema, KnowledgeSurfacingConfigSchema, ConfidenceConfigSchema, GraphConfigSchema, DefragConfigSchema, CreditStrategySchema, PatternExtractorSchema, LearningConfigSchema, RouterConfigSchema, MemoryConfigSchema, MemoryCapacityConfigSchema, StorageConfigSchema, EmbeddingProviderTypeSchema, EmbeddingConfigSchema, ExecutionBackendSchema, ExecutionConfigSchema, RefinementConfigSchema, SkillPromotionConfigSchema, SkillLimitsConfigSchema, SkillContextConfigSchema, SkillDemotionConfigSchema, SkillLibraryConfigSchema, MCPServerConfigSchema, CompressionConfigSchema, TeamLearningConfigSchema, AgenticTaskRunnerConfigSchema, SkillTreeConfigSchema, AtlasConfigSchema, createDefaultConfig, mergeConfig, } from './config.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAGL,UAAU,EACV,sBAAsB,EACtB,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EAKL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,6CAA6C;AAC7C,OAAO,EAWL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EAiBL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,sBAAsB;AACtB,OAAO,EAoBL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAGL,UAAU,EACV,sBAAsB,EACtB,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EAKL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,6CAA6C;AAC7C,OAAO,EAWL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EAiBL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,wBAAwB;AACxB,OAAO,EAgBL,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EAmBL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,2BAA2B;AAC3B,OAAO,EAUL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,kBAAkB;AAClB,OAAO,EAmBL,8BAA8B,EAC9B,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EAUL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAS9B,qDAAqD;AACrD,OAAO,EAML,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EA+BL,uBAAuB,EACvB,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/types/knowledge-graph.d.ts

@@ -0,0 +1,148 @@
+import type { GraphLayerName, KnowledgeNote, LinkRelation } from './knowledge.js';
+export interface GraphNode {
+    /** Knowledge note ID */
+    id: string;
+    /** Relative file path from memory root */
+    file: string;
+    /** Note type */
+    type: 'observation' | 'entity' | 'domain-summary';
+    /** Domains for fast filtering */
+    domains: string[];
+    /** Entities for fast filtering */
+    entities: string[];
+    /** Tags for fast filtering */
+    tags: string[];
+    /** Current confidence */
+    confidence: number;
+    /** Last updated timestamp (ISO 8601) */
+    updated: string;
+}
+export interface GraphEdge {
+    /** Source note ID */
+    from: string;
+    /** Target note ID */
+    to: string;
+    /** Relationship type */
+    relation: string;
+    /** Edge weight (0-1, for ranked traversal) */
+    weight: number;
+    /** When this edge was established (ISO 8601) */
+    created: string;
+    /** Whether this edge crosses into another system */
+    crossSystem?: 'playbook' | 'experience';
+    /** Source trajectory that produced this edge, if any */
+    sourceTrajectory?: string;
+}
+export interface GraphLayer {
+    /** Layer identifier */
+    name: GraphLayerName;
+    /** Whether this layer is currently enabled */
+    enabled: boolean;
+    /** Edges in this layer */
+    edges: GraphEdge[];
+}
+export interface KnowledgeMultiGraph {
+    /** Schema version for migration */
+    version: number;
+    /** Last rebuild timestamp */
+    lastRebuilt: string;
+    /** Shared node registry */
+    nodes: Record<string, GraphNode>;
+    /** Graph layers — each independently toggleable */
+    layers: Record<GraphLayerName, GraphLayer>;
+}
+export interface GraphLayerOperations {
+    /** Layer name */
+    readonly name: GraphLayerName;
+    /** Whether this layer is enabled */
+    readonly enabled: boolean;
+    /** Get edges from/to a node in this layer */
+    getEdges(nodeId: string, direction?: 'outgoing' | 'incoming' | 'both'): GraphEdge[];
+    /** BFS neighbors within this layer */
+    neighbors(nodeId: string, depth?: number): string[];
+    /** Shortest path between two nodes within this layer */
+    pathBetween(fromId: string, toId: string): string[] | null;
+    /** Add an edge to this layer */
+    addEdge(edge: GraphEdge): void;
+    /** Remove an edge from this layer */
+    removeEdge(fromId: string, toId: string, relation: string): void;
+    /** Get all edges in this layer */
+    getAllEdges(): GraphEdge[];
+    /** Get edge count */
+    edgeCount(): number;
+    /** Rebuild this layer from knowledge notes */
+    rebuild(notes: KnowledgeNote[]): void;
+    /** Clear all edges */
+    clear(): void;
+}
+export interface GraphNodeFilter {
+    domains?: string[];
+    entities?: string[];
+    tags?: string[];
+    type?: GraphNode['type'];
+    minConfidence?: number;
+}
+export interface NeighborOptions {
+    depth?: number;
+    layers?: GraphLayerName[];
+    minWeight?: number;
+}
+export interface KnowledgeGraphManagerInterface {
+    /** Get a specific layer */
+    getLayer(name: GraphLayerName): GraphLayerOperations | null;
+    /** Query across all enabled layers (union of edges) */
+    neighbors(nodeId: string, options?: NeighborOptions): GraphNode[];
+    /** Cross-layer path: can traverse edges from any enabled layer */
+    pathBetween(fromId: string, toId: string, options?: {
+        layers?: GraphLayerName[];
+    }): Array<{
+        node: GraphNode;
+        edge: GraphEdge;
+        layer: GraphLayerName;
+    }> | null;
+    /** Filter nodes by criteria */
+    filterNodes(filter: GraphNodeFilter): GraphNode[];
+    /** Get cross-system links (to playbooks/experiences) */
+    crossSystemLinks(nodeId: string): GraphEdge[];
+    /** Add a node to the shared registry */
+    addNode(node: GraphNode): void;
+    /** Remove a node from the shared registry and all layers */
+    removeNode(nodeId: string): void;
+    /** Get a node by ID */
+    getNode(nodeId: string): GraphNode | undefined;
+    /** Get all nodes */
+    getAllNodes(): GraphNode[];
+    /** Rebuild all enabled layers from notes */
+    rebuildAll(notes: KnowledgeNote[]): void;
+    /** Load graph from disk */
+    loadFromDisk(dir: string): Promise<void>;
+    /** Save graph to disk */
+    saveToDisk(dir: string): Promise<void>;
+    /** Get statistics */
+    getStats(): {
+        nodeCount: number;
+        edgeCountByLayer: Record<string, number>;
+        enabledLayers: string[];
+    };
+}
+export interface GraphConfig {
+    /** Which graph layers to enable */
+    enabledLayers: GraphLayerName[];
+    /** Whether to auto-infer temporal edges from timestamps */
+    inferTemporalEdges: boolean;
+    /** Whether to auto-infer causal edges from failure-recovery patterns */
+    inferCausalEdges: boolean;
+    /** Whether to auto-infer entity edges from shared entity tags */
+    inferEntityEdges: boolean;
+    /** Split layer files by domain when node count exceeds this */
+    domainSplitThreshold: number;
+    /** Promote to SQLite when total edge count exceeds this */
+    sqlitePromotionThreshold: number;
+}
+/** Default graph configuration */
+export declare const DEFAULT_GRAPH_CONFIG: GraphConfig;
+export declare const SEMANTIC_RELATIONS: readonly LinkRelation[];
+export declare const TEMPORAL_RELATIONS: readonly LinkRelation[];
+export declare const CAUSAL_RELATIONS: readonly LinkRelation[];
+export declare const ENTITY_RELATIONS: readonly LinkRelation[];
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/types/knowledge-graph.d.ts.map

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

package/dist/types/knowledge-graph.js

@@ -0,0 +1,40 @@
+/** Default graph configuration */
+export const DEFAULT_GRAPH_CONFIG = {
+    enabledLayers: ['semantic'],
+    inferTemporalEdges: true,
+    inferCausalEdges: true,
+    inferEntityEdges: true,
+    domainSplitThreshold: 500,
+    sqlitePromotionThreshold: 10000,
+};
+// ============================================================================
+// Valid relation sets per layer (for layer implementations)
+// ============================================================================
+export const SEMANTIC_RELATIONS = [
+    'related-to',
+    'depends-on',
+    'specializes',
+    'generalizes',
+    'supports',
+];
+export const TEMPORAL_RELATIONS = [
+    'observed-before',
+    'observed-after',
+    'co-occurred',
+    'supersedes',
+];
+export const CAUSAL_RELATIONS = [
+    'caused-by',
+    'led-to',
+    'broke',
+    'enabled',
+    'prevented',
+];
+export const ENTITY_RELATIONS = [
+    'uses',
+    'part-of',
+    'interacts-with',
+    'contradicts',
+    'created-by',
+];
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/types/knowledge-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.js","sourceRoot":"","sources":["../../src/types/knowledge-graph.ts"],"names":[],"mappings":"AA0MA,kCAAkC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,aAAa,EAAE,CAAC,UAAU,CAAC;IAC3B,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,GAAG;IACzB,wBAAwB,EAAE,KAAK;CAChC,CAAC;AAEF,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;IACb,UAAU;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;IACT,WAAW;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD,MAAM;IACN,SAAS;IACT,gBAAgB;IAChB,aAAa;IACb,YAAY;CACb,CAAC"}

package/dist/types/knowledge.d.ts

@@ -0,0 +1,280 @@
+import { z } from 'zod';
+export declare const AllLinkRelations: readonly ["related-to", "depends-on", "specializes", "generalizes", "supports", "observed-before", "observed-after", "co-occurred", "supersedes", "caused-by", "led-to", "broke", "enabled", "prevented", "uses", "part-of", "interacts-with", "contradicts", "created-by"];
+export declare const LinkRelationSchema: z.ZodEnum<["related-to", "depends-on", "specializes", "generalizes", "supports", "observed-before", "observed-after", "co-occurred", "supersedes", "caused-by", "led-to", "broke", "enabled", "prevented", "uses", "part-of", "interacts-with", "contradicts", "created-by"]>;
+export type LinkRelation = z.infer<typeof LinkRelationSchema>;
+/** Map relation to its natural graph layer */
+export declare function inferLayerFromRelation(relation: LinkRelation): 'semantic' | 'temporal' | 'causal' | 'entity';
+export declare const NoteTypeSchema: z.ZodEnum<["observation", "entity", "domain-summary"]>;
+export type NoteType = z.infer<typeof NoteTypeSchema>;
+export declare const SourceOriginSchema: z.ZodEnum<["extracted", "agent-authored", "imported"]>;
+export type SourceOrigin = z.infer<typeof SourceOriginSchema>;
+export declare const GraphLayerNameSchema: z.ZodEnum<["semantic", "temporal", "causal", "entity"]>;
+export type GraphLayerName = z.infer<typeof GraphLayerNameSchema>;
+export declare const KnowledgeLinkSchema: z.ZodObject<{
+    target: z.ZodString;
+    relation: z.ZodEnum<["related-to", "depends-on", "specializes", "generalizes", "supports", "observed-before", "observed-after", "co-occurred", "supersedes", "caused-by", "led-to", "broke", "enabled", "prevented", "uses", "part-of", "interacts-with", "contradicts", "created-by"]>;
+    layer: z.ZodOptional<z.ZodEnum<["semantic", "temporal", "causal", "entity"]>>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+    layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+}, {
+    target: string;
+    relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+    layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+}>;
+export type KnowledgeLink = z.infer<typeof KnowledgeLinkSchema>;
+export declare const KnowledgeSourceSchema: z.ZodObject<{
+    origin: z.ZodEnum<["extracted", "agent-authored", "imported"]>;
+    trajectories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    playbooks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    origin: "extracted" | "imported" | "agent-authored";
+    agentId?: string | undefined;
+    trajectories?: string[] | undefined;
+    playbooks?: string[] | undefined;
+}, {
+    origin: "extracted" | "imported" | "agent-authored";
+    agentId?: string | undefined;
+    trajectories?: string[] | undefined;
+    playbooks?: string[] | undefined;
+}>;
+export type KnowledgeSource = z.infer<typeof KnowledgeSourceSchema>;
+export declare const KnowledgeNoteFrontmatterSchema: z.ZodObject<{
+    /** Unique identifier (kebab-case, prefixed with k- for observations) */
+    id: z.ZodString;
+    /** Note type determines organization and lifecycle */
+    type: z.ZodEnum<["observation", "entity", "domain-summary"]>;
+    /** Knowledge domains this note belongs to */
+    domain: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Specific entities (tools, libraries, patterns) referenced */
+    entities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Freeform tags for additional categorization */
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Confidence in this knowledge (0-1) */
+    confidence: z.ZodDefault<z.ZodNumber>;
+    /** Where this knowledge came from */
+    source: z.ZodObject<{
+        origin: z.ZodEnum<["extracted", "agent-authored", "imported"]>;
+        trajectories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        playbooks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        agentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        origin: "extracted" | "imported" | "agent-authored";
+        agentId?: string | undefined;
+        trajectories?: string[] | undefined;
+        playbooks?: string[] | undefined;
+    }, {
+        origin: "extracted" | "imported" | "agent-authored";
+        agentId?: string | undefined;
+        trajectories?: string[] | undefined;
+        playbooks?: string[] | undefined;
+    }>;
+    /** Explicit links to other knowledge notes */
+    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        target: z.ZodString;
+        relation: z.ZodEnum<["related-to", "depends-on", "specializes", "generalizes", "supports", "observed-before", "observed-after", "co-occurred", "supersedes", "caused-by", "led-to", "broke", "enabled", "prevented", "uses", "part-of", "interacts-with", "contradicts", "created-by"]>;
+        layer: z.ZodOptional<z.ZodEnum<["semantic", "temporal", "causal", "entity"]>>;
+    }, "strip", z.ZodTypeAny, {
+        target: string;
+        relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+        layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+    }, {
+        target: string;
+        relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+        layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+    }>, "many">>;
+    /** ISO 8601 creation timestamp */
+    created: z.ZodString;
+    /** ISO 8601 last updated timestamp */
+    updated: z.ZodString;
+    /** If this note replaces a previous one (contradiction resolution) */
+    supersedes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "observation" | "entity" | "domain-summary";
+    id: string;
+    domain: string[];
+    source: {
+        origin: "extracted" | "imported" | "agent-authored";
+        agentId?: string | undefined;
+        trajectories?: string[] | undefined;
+        playbooks?: string[] | undefined;
+    };
+    confidence: number;
+    entities: string[];
+    tags: string[];
+    links: {
+        target: string;
+        relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+        layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+    }[];
+    created: string;
+    updated: string;
+    supersedes?: string | null | undefined;
+}, {
+    type: "observation" | "entity" | "domain-summary";
+    id: string;
+    source: {
+        origin: "extracted" | "imported" | "agent-authored";
+        agentId?: string | undefined;
+        trajectories?: string[] | undefined;
+        playbooks?: string[] | undefined;
+    };
+    created: string;
+    updated: string;
+    domain?: string[] | undefined;
+    confidence?: number | undefined;
+    supersedes?: string | null | undefined;
+    entities?: string[] | undefined;
+    tags?: string[] | undefined;
+    links?: {
+        target: string;
+        relation: "related-to" | "depends-on" | "specializes" | "generalizes" | "supports" | "observed-before" | "observed-after" | "co-occurred" | "supersedes" | "caused-by" | "led-to" | "broke" | "enabled" | "prevented" | "uses" | "part-of" | "interacts-with" | "contradicts" | "created-by";
+        layer?: "semantic" | "temporal" | "causal" | "entity" | undefined;
+    }[] | undefined;
+}>;
+export type KnowledgeNoteFrontmatter = z.infer<typeof KnowledgeNoteFrontmatterSchema>;
+export interface KnowledgeNote {
+    /** Parsed frontmatter */
+    frontmatter: KnowledgeNoteFrontmatter;
+    /** Markdown body content (after frontmatter) */
+    body: string;
+    /** Resolved file path (derived from type + name, not stored in frontmatter) */
+    filePath: string;
+}
+export interface KnowledgeMatch {
+    note: KnowledgeNote;
+    score: number;
+    matchType?: 'domain' | 'entity' | 'semantic' | 'graph';
+}
+export interface EntityUpdate {
+    /** Entity note ID to update */
+    entityId: string;
+    /** Section to append */
+    section: string;
+    /** Evidence source trajectory ID */
+    trajectoryId: string;
+}
+export interface Contradiction {
+    /** Existing note that is contradicted */
+    existingNoteId: string;
+    /** New observation that contradicts it */
+    newObservation: KnowledgeNote;
+    /** How they conflict */
+    conflictDescription: string;
+    /** Recommendation */
+    resolution: 'supersede' | 'coexist' | 'review';
+}
+export interface PlaybookLink {
+    /** Knowledge note ID */
+    noteId: string;
+    /** Playbook ID */
+    playbookId: string;
+    /** Relationship direction */
+    relation: 'supports' | 'contradicts' | 'contextualizes';
+}
+export interface NewLink {
+    from: string;
+    to: string;
+    relation: LinkRelation;
+    layer?: GraphLayerName;
+    weight?: number;
+}
+export interface ExtractedKnowledge {
+    /** New observations to create */
+    observations: KnowledgeNote[];
+    /** Updates to existing entity notes (append sections) */
+    entityUpdates: EntityUpdate[];
+    /** Contradictions detected with existing knowledge */
+    contradictions: Contradiction[];
+    /** New links to add to the graph */
+    links: NewLink[];
+    /** Cross-references to playbooks */
+    playbookLinks: PlaybookLink[];
+}
+export interface InboxResult {
+    /** Total files processed */
+    processed: number;
+    /** Files that failed to parse/move */
+    failed: number;
+    /** Files moved to observations/ */
+    movedToObservations: number;
+    /** Files moved to entities/ */
+    movedToEntities: number;
+    /** Files moved to domains/ */
+    movedToDomains: number;
+}
+export interface DefragResult {
+    /** Inbox processing results */
+    inbox: InboxResult;
+    /** Number of observations consolidated into entity notes */
+    consolidated: number;
+    /** Number of contradictions detected */
+    contradictions: number;
+    /** Whether the graph was rebuilt */
+    graphRebuilt: boolean;
+    /** Number of domain summaries regenerated */
+    domainSummariesRegenerated: number;
+    /** Decay results */
+    decay: DecayResult;
+}
+export interface DecayResult {
+    /** Notes with reduced confidence */
+    decayed: number;
+    /** Notes newly marked as stale */
+    newlyStale: number;
+    /** Notes already marked stale */
+    alreadyStale: number;
+}
+export interface KnowledgeStats {
+    observationCount: number;
+    entityCount: number;
+    domainCount: number;
+    inboxCount: number;
+    graph: {
+        nodeCount: number;
+        edgeCountByLayer: Record<string, number>;
+        enabledLayers: string[];
+    };
+    avgConfidence: number;
+    staleCount: number;
+    domainBreakdown: Record<string, number>;
+}
+/**
+ * Create a new observation note
+ */
+export declare function createObservation(input: {
+    id?: string;
+    title: string;
+    body: string;
+    domain: string[];
+    entities: string[];
+    tags?: string[];
+    confidence?: number;
+    source: KnowledgeSource;
+    links?: KnowledgeLink[];
+}): KnowledgeNote;
+/**
+ * Create a new entity note
+ */
+export declare function createEntityNote(input: {
+    entityName: string;
+    body: string;
+    domain: string[];
+    tags?: string[];
+    confidence?: number;
+    source: KnowledgeSource;
+    links?: KnowledgeLink[];
+}): KnowledgeNote;
+/**
+ * Create a new domain summary note
+ */
+export declare function createDomainSummary(input: {
+    domainName: string;
+    body: string;
+    entities?: string[];
+    tags?: string[];
+    source: KnowledgeSource;
+}): KnowledgeNote;
+//# sourceMappingURL=knowledge.d.ts.map