@yattalo/task-system-core 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @yattalo/task-system-core
 
-Shared types, config helpers, and Zod validators for `@yattalo/task-system`.
+Shared types, config helpers, Zod validators, and context tier logic for `@yattalo/task-system`.
 
 ## Install
 
@@ -10,39 +10,146 @@ npm install @yattalo/task-system-core
 
 ## API
 
-### `defineConfig(config)`
+### Configuration
 
-Type-safe configuration builder with defaults.
+#### `defineConfig(config)`
+
+Type-safe configuration builder with defaults for the task system scaffold.
 
 ```ts
 import { defineConfig } from "@yattalo/task-system-core";
 
 const config = defineConfig({
   projectName: "my-project",
-  agents: { claude: { label: "Claude", icon: "C", color: "#6B5CE7" } },
+  agents: { claude: { label: "Claude", icon: "C", color: "#D97706" } },
   categories: ["backend", "frontend"],
   phases: [{ id: "foundation", label: "Foundation", wave: 1 }],
+  taskIdPattern: "[C]\\d{1,3}",
+  extensions: { commitTracking: true },
+});
+```
+
+#### `defineRuntimeConfig(config)`
+
+Runtime configuration for UCA features (NLM, drift detection, context tiers).
+
+```ts
+import { defineRuntimeConfig } from "@yattalo/task-system-core";
+
+const runtime = defineRuntimeConfig({
+  projectId: "my-project",
+  convexUrl: "https://my-project.convex.cloud",
+  nlm: { enabled: true, globalNotebookId: "abc123" },
+  drift: { checkpointInterval: 50, timeOverrunMultiplier: 1.5 },
+  context: { autoPromoteThreshold: 2 },
 });
 ```
 
-### `validateConfig(raw)`
+### Context Tier Logic
+
+#### `canPromote(entry, targetTier, promoterAgent)`
+
+Check if a context entry can be promoted to the target tier.
+
+```ts
+import { canPromote } from "@yattalo/task-system-core";
+
+// AI can promote draft->reviewed if confidence > 3
+canPromote(entry, "reviewed", "claude");   // true if entry.confidenceScore > 3
+
+// Only humans can promote reviewed->curated
+canPromote(entry, "curated", "human");     // true
+canPromote(entry, "curated", "claude");    // false
+```
+
+#### `canAutoPromote(entry)`
+
+Check if an entry qualifies for automatic promotion (draft -> reviewed only). Requires 2+ validations from different agents.
+
+```ts
+import { canAutoPromote } from "@yattalo/task-system-core";
+
+// entry.validatedBy = ["claude", "codex"]
+canAutoPromote(entry); // true — 2 unique validators
+```
+
+#### `getNextTier(currentTier)`
+
+Returns the next tier in the hierarchy, or `null` if already at top.
+
+```ts
+getNextTier("draft");    // "reviewed"
+getNextTier("reviewed"); // "curated"
+getNextTier("curated");  // null
+```
+
+#### `createPromotionRecord(from, to, promotedBy, reason?)`
+
+Create a timestamped promotion record for tracking history.
 
-Validates a `TaskSystemConfig` object using Zod. Throws on invalid input.
+### Validators
 
-### `validateTaskDefinitions(raw)`
+All validators use Zod and throw on invalid input.
 
-Validates a `TaskDefinition[]` array using Zod.
+```ts
+import {
+  validateConfig,
+  validateTaskDefinitions,
+  validateContextEntry,
+  validateKnowledgeEntry,
+  validateDriftEvent,
+  validateAgentRegistryEntry,
+} from "@yattalo/task-system-core";
+
+// Validates and returns typed object, or throws ZodError
+const entry = validateContextEntry(rawData);
+```
 
-### Helper Functions
+Zod schemas are also exported for custom composition:
+
+```ts
+import {
+  contextEntrySchema,
+  knowledgeEntrySchema,
+  driftEventSchema,
+  agentRegistryEntrySchema,
+} from "@yattalo/task-system-core";
+```
+
+### Config Helpers
+
+| Function | Description |
+|----------|-------------|
+| `getActiveExtensions(config)` | List enabled extension keys |
+| `hasSoftwareExtensions(config)` | Check if software extensions enabled |
+| `hasResearchExtensions(config)` | Check if research extensions enabled |
+| `getAgentKeys(config)` | Array of agent key strings |
+| `getTableName(config)` | Convex table name (default: `"agentTasks"`) |
+
+### Constants
+
+```ts
+import {
+  TASK_STATUSES,         // ["backlog","todo","in_progress","blocked","review","done","archived"]
+  TASK_PRIORITIES,       // ["critical","high","medium","low"]
+  CONTEXT_TIERS,         // ["draft","reviewed","curated"]
+  CONTEXT_ENTRY_TYPES,   // ["task_output","decision","learning","insight",...]
+  DRIFT_TYPES,           // ["scope_creep","time_overrun","context_switch",...]
+  DRIFT_SEVERITIES,      // ["low","medium","high"]
+  DRIFT_STATUSES,        // ["open","acknowledged","resolved","dismissed"]
+  KNOWLEDGE_CATEGORIES,  // ["pattern","decision","lesson_learned",...]
+  AGENT_TYPES,           // ["ai","human"]
+  AGENT_STATUSES,        // ["active","idle","offline"]
+  JOB_STATUSES,          // ["active","paused","completed","failed"]
+  RUN_STATUSES,          // ["queued","running","completed","failed","cancelled","timeout"]
+} from "@yattalo/task-system-core";
+```
 
-- `getActiveExtensions(config)` - List enabled extension keys
-- `hasSoftwareExtensions(config)` / `hasResearchExtensions(config)` - Boolean checks
-- `getAgentKeys(config)` - Array of agent key strings
-- `getTableName(config)` - Convex table name (default: `"agentTasks"`)
+### Types
 
-## Types
+**Task System**: `TaskSystemConfig`, `TaskDefinition`, `TaskStatus`, `TaskPriority`, `AgentConfig`, `PhaseConfig`, `ExtensionsConfig`, `GeneratorContext`, `ProjectDetection`, `CommitRecord`, `ScopeCreepFlag`, `EvidenceRecord`, `HandoffRecord`, `CheckpointEntry`, `AgentOpsJob`, `AgentOpsRun`
 
-Key exports: `TaskSystemConfig`, `TaskDefinition`, `GeneratorContext`, `ProjectDetection`, `ExtensionsConfig`, `AgentConfig`, `PhaseConfig`.
+**UCA**: `ContextTier`, `ContextEntryType`, `ContextEntry`, `PromotionRecord`, `DriftType`, `DriftSeverity`, `DriftStatus`, `DriftEvent`, `KnowledgeCategory`, `KnowledgeEntry`, `AgentRegistryType`, `AgentRegistryStatus`, `AgentRegistryEntry`, `RuntimeConfig`, `NlmConfig`, `DriftConfig`, `ContextConfig`
 
 ## License
 

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from "vitest";
+import { defineConfig, defineRuntimeConfig } from "../config.js";
+describe("defineRuntimeConfig", () => {
+    it("returns config with defaults", () => {
+        const config = defineRuntimeConfig({
+            projectId: "uca-main",
+            convexUrl: "https://example.convex.cloud",
+        });
+        expect(config.projectId).toBe("uca-main");
+        expect(config.convexUrl).toBe("https://example.convex.cloud");
+        expect(config.nlm.enabled).toBe(false);
+        expect(config.drift.checkpointInterval).toBe(50);
+        expect(config.drift.timeOverrunMultiplier).toBe(1.5);
+        expect(config.context.autoPromoteThreshold).toBe(2);
+    });
+    it("allows overriding defaults", () => {
+        const config = defineRuntimeConfig({
+            projectId: "test",
+            convexUrl: "https://test.convex.cloud",
+            nlm: { enabled: true, binaryPath: "/usr/local/bin/nlm", globalNotebookId: "abc" },
+            drift: { checkpointInterval: 30 },
+        });
+        expect(config.nlm.enabled).toBe(true);
+        expect(config.nlm.binaryPath).toBe("/usr/local/bin/nlm");
+        expect(config.drift.checkpointInterval).toBe(30);
+        expect(config.drift.timeOverrunMultiplier).toBe(1.5);
+    });
+});
+describe("defineConfig (existing)", () => {
+    it("still works unchanged", () => {
+        const config = defineConfig({
+            projectName: "test",
+            agents: { claude: { label: "Claude", icon: "C", color: "#7C3AED" } },
+            categories: ["backend"],
+            phases: [{ id: "foundation", label: "Foundation", wave: 1 }],
+            taskIdPattern: "[C]\\d{1,3}",
+            extensions: {},
+        });
+        expect(config.projectName).toBe("test");
+        expect(config.tableName).toBe("agentTasks");
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,8BAA8B;SAC1C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,2BAA2B;YACtC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,KAAK,EAAE;YACjF,KAAK,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACpE,UAAU,EAAE,CAAC,SAAS,CAAC;YACvB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,aAAa,EAAE,aAAa;YAC5B,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/context-tiers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-tiers.test.d.ts.map

package/dist/__tests__/context-tiers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tiers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context-tiers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/context-tiers.test.js

@@ -0,0 +1,92 @@
+import { describe, it, expect } from "vitest";
+import { canPromote, canAutoPromote, getNextTier, createPromotionRecord, } from "../context-tiers.js";
+const makeEntry = (overrides = {}) => ({
+    entryId: "ctx-1",
+    projectId: "proj-1",
+    type: "decision",
+    content: "test",
+    tier: "draft",
+    promotionHistory: [],
+    linksTo: [],
+    propagateTo: [],
+    tags: [],
+    createdBy: "claude",
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+    ...overrides,
+});
+describe("canPromote", () => {
+    it("allows draft -> reviewed by human", () => {
+        const entry = makeEntry({ tier: "draft" });
+        expect(canPromote(entry, "reviewed", "human")).toBe(true);
+    });
+    it("allows draft -> reviewed by AI with confidence > 3", () => {
+        const entry = makeEntry({ tier: "draft", confidenceScore: 4 });
+        expect(canPromote(entry, "reviewed", "claude")).toBe(true);
+    });
+    it("rejects draft -> reviewed by AI with low confidence", () => {
+        const entry = makeEntry({ tier: "draft", confidenceScore: 2 });
+        expect(canPromote(entry, "reviewed", "claude")).toBe(false);
+    });
+    it("allows reviewed -> curated only by human", () => {
+        const entry = makeEntry({ tier: "reviewed" });
+        expect(canPromote(entry, "curated", "human")).toBe(true);
+    });
+    it("rejects reviewed -> curated by AI", () => {
+        const entry = makeEntry({ tier: "reviewed" });
+        expect(canPromote(entry, "curated", "claude")).toBe(false);
+    });
+    it("rejects skipping tiers (draft -> curated)", () => {
+        const entry = makeEntry({ tier: "draft" });
+        expect(canPromote(entry, "curated", "human")).toBe(false);
+    });
+    it("rejects same tier promotion", () => {
+        const entry = makeEntry({ tier: "draft" });
+        expect(canPromote(entry, "draft", "human")).toBe(false);
+    });
+});
+describe("canAutoPromote", () => {
+    it("auto-promotes draft -> reviewed with 2+ different validators", () => {
+        const entry = makeEntry({
+            tier: "draft",
+            validatedBy: ["claude", "gemini"],
+        });
+        expect(canAutoPromote(entry)).toBe(true);
+    });
+    it("does not auto-promote with < 2 validators", () => {
+        const entry = makeEntry({
+            tier: "draft",
+            validatedBy: ["claude"],
+        });
+        expect(canAutoPromote(entry)).toBe(false);
+    });
+    it("never auto-promotes to curated", () => {
+        const entry = makeEntry({
+            tier: "reviewed",
+            validatedBy: ["claude", "gemini", "codex"],
+        });
+        expect(canAutoPromote(entry)).toBe(false);
+    });
+});
+describe("getNextTier", () => {
+    it("draft -> reviewed", () => {
+        expect(getNextTier("draft")).toBe("reviewed");
+    });
+    it("reviewed -> curated", () => {
+        expect(getNextTier("reviewed")).toBe("curated");
+    });
+    it("curated -> null (no next tier)", () => {
+        expect(getNextTier("curated")).toBeNull();
+    });
+});
+describe("createPromotionRecord", () => {
+    it("creates a valid record", () => {
+        const record = createPromotionRecord("draft", "reviewed", "human", "verified by tests");
+        expect(record.from).toBe("draft");
+        expect(record.to).toBe("reviewed");
+        expect(record.promotedBy).toBe("human");
+        expect(record.reason).toBe("verified by tests");
+        expect(record.timestamp).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=context-tiers.test.js.map

package/dist/__tests__/context-tiers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tiers.test.js","sourceRoot":"","sources":["../../src/__tests__/context-tiers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,SAAS,GAAG,CAAC,YAAmC,EAAE,EAAgB,EAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,OAAO;IACb,gBAAgB,EAAE,EAAE;IACpB,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,EAAE;IACf,IAAI,EAAE,EAAE;IACR,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;IACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;IACrB,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,CAAC,QAAQ,CAAC;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/context-types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-types.test.d.ts.map

package/dist/__tests__/context-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context-types.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/context-types.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from "vitest";
+import { CONTEXT_TIERS, CONTEXT_ENTRY_TYPES, DRIFT_TYPES, DRIFT_SEVERITIES, DRIFT_STATUSES, KNOWLEDGE_CATEGORIES, AGENT_TYPES, AGENT_STATUSES, } from "../types.js";
+describe("context tier constants", () => {
+    it("exports CONTEXT_TIERS", () => {
+        expect(CONTEXT_TIERS).toEqual(["draft", "reviewed", "curated"]);
+    });
+    it("exports CONTEXT_ENTRY_TYPES with 9 types", () => {
+        expect(CONTEXT_ENTRY_TYPES).toContain("task_output");
+        expect(CONTEXT_ENTRY_TYPES).toContain("decision");
+        expect(CONTEXT_ENTRY_TYPES).toContain("learning");
+        expect(CONTEXT_ENTRY_TYPES).toContain("drift_event");
+        expect(CONTEXT_ENTRY_TYPES.length).toBe(9);
+    });
+    it("exports DRIFT_TYPES with 5 types", () => {
+        expect(DRIFT_TYPES).toContain("scope_creep");
+        expect(DRIFT_TYPES).toContain("time_overrun");
+        expect(DRIFT_TYPES).toContain("context_switch");
+        expect(DRIFT_TYPES).toContain("quality_drop");
+        expect(DRIFT_TYPES).toContain("assumption_introduced");
+        expect(DRIFT_TYPES.length).toBe(5);
+    });
+    it("exports DRIFT_SEVERITIES", () => {
+        expect(DRIFT_SEVERITIES).toEqual(["low", "medium", "high"]);
+    });
+    it("exports DRIFT_STATUSES", () => {
+        expect(DRIFT_STATUSES).toEqual(["open", "acknowledged", "resolved", "dismissed"]);
+    });
+    it("exports KNOWLEDGE_CATEGORIES with 6 categories", () => {
+        expect(KNOWLEDGE_CATEGORIES).toContain("pattern");
+        expect(KNOWLEDGE_CATEGORIES).toContain("decision");
+        expect(KNOWLEDGE_CATEGORIES).toContain("lesson_learned");
+        expect(KNOWLEDGE_CATEGORIES).toContain("best_practice");
+        expect(KNOWLEDGE_CATEGORIES).toContain("anti_pattern");
+        expect(KNOWLEDGE_CATEGORIES).toContain("reference");
+        expect(KNOWLEDGE_CATEGORIES.length).toBe(6);
+    });
+    it("exports AGENT_TYPES", () => {
+        expect(AGENT_TYPES).toEqual(["ai", "human"]);
+    });
+    it("exports AGENT_STATUSES", () => {
+        expect(AGENT_STATUSES).toEqual(["active", "idle", "offline"]);
+    });
+});
+//# sourceMappingURL=context-types.test.js.map

package/dist/__tests__/context-types.test.js.map

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

package/dist/__tests__/interfaces.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.test.d.ts.map

package/dist/__tests__/interfaces.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/interfaces.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/interfaces.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect } from "vitest";
+describe("UCA interfaces", () => {
+    it("ContextEntry has required fields", () => {
+        const entry = {
+            entryId: "ctx-1",
+            projectId: "proj-1",
+            type: "decision",
+            content: "chose Convex over Supabase",
+            tier: "draft",
+            promotionHistory: [],
+            linksTo: [],
+            propagateTo: [],
+            tags: ["architecture"],
+            createdBy: "claude",
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        };
+        expect(entry.tier).toBe("draft");
+        expect(entry.promotionHistory).toEqual([]);
+    });
+    it("PromotionRecord tracks tier changes", () => {
+        const record = {
+            from: "draft",
+            to: "reviewed",
+            promotedBy: "human",
+            timestamp: Date.now(),
+        };
+        expect(record.from).toBe("draft");
+        expect(record.to).toBe("reviewed");
+    });
+    it("KnowledgeEntry requires confidence score", () => {
+        const entry = {
+            entryId: "kb-1",
+            title: "Use Convex for real-time",
+            content: "Convex subscriptions are better than polling for dashboards",
+            category: "best_practice",
+            confidenceScore: 4,
+            sourceEntryIds: ["ctx-1"],
+            tags: ["convex", "performance"],
+            createdBy: "claude",
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            usageCount: 0,
+        };
+        expect(entry.confidenceScore).toBe(4);
+        expect(entry.category).toBe("best_practice");
+    });
+    it("DriftEvent tracks scope creep", () => {
+        const event = {
+            eventId: "drift-1",
+            projectId: "proj-1",
+            agent: "claude",
+            driftType: "scope_creep",
+            description: "Added auth when task was about UI",
+            severity: "medium",
+            status: "open",
+            detectedAt: Date.now(),
+        };
+        expect(event.driftType).toBe("scope_creep");
+        expect(event.status).toBe("open");
+    });
+    it("AgentRegistryEntry supports human type", () => {
+        const agent = {
+            agentId: "human",
+            label: "Human Operator",
+            type: "human",
+            capabilities: ["review", "curation", "strategy"],
+            preferredCategories: ["architecture", "design"],
+            currentStatus: "active",
+            currentTaskIds: ["HU1"],
+            totalTasksCompleted: 42,
+            totalHoursLogged: 120,
+            avgCompletionRate: 0.85,
+            driftEventsTriggered: 3,
+            taskIdPrefix: "HU",
+            color: "#10B981",
+            icon: "P",
+        };
+        expect(agent.type).toBe("human");
+        expect(agent.capabilities).toContain("curation");
+    });
+});
+//# sourceMappingURL=interfaces.test.js.map

package/dist/__tests__/interfaces.test.js.map

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

package/dist/__tests__/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/__tests__/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/types.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/types.test.js

@@ -0,0 +1,15 @@
+import { describe, it, expect } from "vitest";
+import { TASK_STATUSES, TASK_PRIORITIES } from "../types.js";
+describe("existing types", () => {
+    it("exports TASK_STATUSES", () => {
+        expect(TASK_STATUSES).toContain("backlog");
+        expect(TASK_STATUSES).toContain("done");
+        expect(TASK_STATUSES.length).toBe(7);
+    });
+    it("exports TASK_PRIORITIES", () => {
+        expect(TASK_PRIORITIES).toContain("critical");
+        expect(TASK_PRIORITIES).toContain("low");
+        expect(TASK_PRIORITIES.length).toBe(4);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/__tests__/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/__tests__/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/validators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validators.test.d.ts.map

package/dist/__tests__/validators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validators.test.ts"],"names":[],"mappings":""}