thoth-plugin 1.2.4 → 1.2.5

package/dist/defaults/skill/slack-write/skill.md

@@ -0,0 +1,184 @@
+---
+name: slack-write
+description: Use when writing Slack messages, team announcements, or channel posts. Ensures correct mrkdwn formatting instead of Markdown.
+triggers: 
+created: 2026-01-07
+updated: 2026-01-10
+---
+
+<!--
+ARCHITECTURE REFERENCE: docs/concepts/skill-architecture.md
+-->
+
+# Slack Write
+
+**Core principle:** Slack uses `mrkdwn`, NOT Markdown. Different syntax for bold, links, and structure.
+
+---
+
+## When to Use
+
+- Posting messages to Slack channels
+- Team announcements or updates
+- Any `slack_conversations_add_message` call
+
+**Do NOT use when:**
+- Reading/scanning Slack (use slack-pulse)
+- Writing emails (use email-draft)
+- Writing KB documentation (Markdown is fine)
+
+---
+
+## Quick Reference
+
+| Format | mrkdwn Syntax | NOT This |
+|--------|---------------|----------|
+| **Bold** | `*text*` | `**text**` |
+| *Italic* | `_text_` | `*text*` |
+| ~~Strike~~ | `~text~` | `~~text~~` |
+| `Code` | `` `code` `` | same |
+| Link | `<https://url|text>` | `[text](url)` |
+| User mention | `<@U123ABC>` | `@username` |
+| Channel | `<#C123ABC>` | `#channel` |
+| Emoji | `:emoji_name:` | same |
+| Quote | `>text` | same |
+| Line break | `\n` in string | same |
+
+---
+
+## Structure for Readability
+
+Slack renders everything inline. Create visual breaks with:
+
+### Section Headers
+Use emoji + bold:
+```
+:rotating_light: *Important Update*
+```
+
+### Dividers
+Use unicode box drawing (not `---`):
+```
+────────────────────────────
+```
+Or emoji line:
+```
+:small_blue_diamond::small_blue_diamond::small_blue_diamond:
+```
+
+### Bullets
+No native list syntax. Use:
+- `•` (unicode bullet)
+- `◦` (hollow bullet)
+- Emoji: `:white_check_mark:`, `:arrow_right:`
+
+### Numbered Lists
+Manual numbering with line breaks:
+```
+1. First item\n2. Second item\n3. Third item
+```
+
+---
+
+## Message Template
+
+```
+:emoji: *Header Title*
+
+Brief intro paragraph.
+
+────────────────────────────
+
+:dart: *Section One*
+• Point one
+• Point two
+
+:warning: *Section Two*
+• Important note
+
+────────────────────────────
+
+:link: Links: <https://example.com|Click here>
+
+Questions? Reply in thread.
+```
+
+---
+
+## Process
+
+### 1. Draft Content
+Write the message content first, focusing on clarity.
+
+### 2. Convert to mrkdwn
+- Replace `**bold**` → `*bold*`
+- Replace `[text](url)` → `<url|text>`
+- Add emoji section headers
+- Add unicode dividers for visual breaks
+
+### 3. Present Final Payload for Approval
+**CRITICAL:** Show Zeus the *exact* final string that will be sent.
+- If formatting changes the wording, you MUST get re-approval.
+- Use a code block to show the verbatim payload.
+
+### 4. Post only after "Yes" to the final payload
+```
+slack_conversations_add_message(
+  channel_id="C123ABC",
+  content_type="text/markdown",
+  payload="*Approved Final Payload*"
+)
+```
+
+---
+
+## Common Mistakes
+
+| Mistake | Prevention |
+|---------|------------|
+| `**bold**` | Use `*bold*` — single asterisks |
+| `[text](url)` | Use `<url|text>` — angle brackets, pipe separator |
+| `---` for divider | Use `────────────────────────────` (unicode) |
+| Markdown tables | Not supported — use aligned text or bullet lists |
+| `- item` for bullets | Use `•` or `◦` unicode bullets |
+| Wall of text | Add emoji headers and dividers for scannability |
+| Assuming Markdown works | mrkdwn is NOT Markdown — always convert |
+
+---
+
+## Red Flags - STOP
+
+- About to use `**` for bold → STOP, use `*`
+- About to use `[text](url)` → STOP, use `<url|text>`
+- About to use `---` for divider → STOP, use unicode `────────`
+- Message is a wall of text → STOP, add section breaks
+- Not sure about syntax → Check Quick Reference table
+
+---
+
+## Verification Checklist
+
+- [ ] No `**` double asterisks (use single `*`)
+- [ ] Links use `<url|text>` format
+- [ ] Dividers use unicode, not `---`
+- [ ] Has visual structure (headers, breaks)
+- [ ] Emoji used for scannability
+- [ ] Presented to Zeus before posting
+
+---
+
+## Useful Emoji
+
+| Purpose | Emoji |
+|---------|-------|
+| Alert/Important | `:rotating_light:` `:warning:` `:exclamation:` |
+| Info/Update | `:information_source:` `:mega:` `:loudspeaker:` |
+| Action/Task | `:dart:` `:arrow_right:` `:point_right:` |
+| Success | `:white_check_mark:` `:tada:` `:sparkles:` |
+| Link/Reference | `:link:` `:bookmark:` `:page_facing_up:` |
+| Question | `:question:` `:thinking_face:` |
+| Divider | `:small_blue_diamond:` `:heavy_minus_sign:` |
+
+---
+
+*Slack Write Skill v1.0 | mrkdwn formatting for Slack messages*

package/dist/defaults/skill/thought-router/SKILL.md

@@ -1,17 +1,16 @@
 ---
 name: thought-router
-version: 1.0.0
-description: The thought(s) to capture
+description: Route unstructured thoughts, brain dumps, and quick captures to their correct home in the knowledge base.
 triggers: 
-inputs: 
-- name: content
-type: markdown
-required: true
-output: 
+- "dump: 
 created: 2026-01-09
-updated: 2026-01-09
+updated: 2026-01-10
 ---
 
+<!--
+ARCHITECTURE REFERENCE: docs/concepts/skill-architecture.md
+-->
+
 # Thought Router Skill
 
 You are the **Thought Router**. Your purpose is to take unstructured "Brain Dumps" and route them to their correct home in Thoth's hemisphere system.

package/dist/hooks/index.d.ts

@@ -1,7 +1,6 @@
 export { createPermissionEnforcerHook, type PermissionEnforcerHook, type PermissionEnforcerConfig, } from "./permission-enforcer";
 export { createTrustLevelTrackerHook, type TrustLevelTrackerHook, type TrustLevelTrackerConfig, type TrustLevel, type TrustState, } from "./trust-level-tracker";
 export { createContextApertureHook, type ContextApertureHook, type ContextApertureConfig, } from "./context-aperture";
-export { createTemporalAwarenessHook, type TemporalAwarenessHook, type TemporalAwarenessConfig, } from "./temporal-awareness";
 export { createFrontmatterEnforcerHook, type FrontmatterEnforcerHook, type FrontmatterEnforcerConfig, } from "./frontmatter-enforcer";
 export { createReadConfirmationHook, type ReadConfirmationHook, type ReadConfirmationConfig, } from "./read-confirmation";
 export { createWriteConfirmationHook, type WriteConfirmationHook, type WriteConfirmationConfig, } from "./write-confirmation";

package/dist/index.js

@@ -7172,6 +7172,9 @@ Remember it. If action drifts from stated priority, surface it \u2014 once. "You
 
 ### When a Commitment is Made
 Track it. By Zeus or to Zeus \u2014 commitments get logged. Surface before they slip, not after.
+
+### When Improving Something That Works
+Verify the current state first. Understand why it works before changing how it works. Improvements that break existing functionality aren't improvements.
 </Behavioral_Guidance>`;
 var THOTH_KNOWLEDGE_MANAGEMENT = `<Knowledge_Management>
 ## Knowledge Management
@@ -7547,20 +7550,14 @@ A task is NOT complete without evidence:
 | Delegation | Agent result received and verified |
 </Execution>`;
 var THOTH_TEMPORAL_AWARENESS = `<Temporal_Awareness>
-## Temporal Awareness (Chronos Protocol)
-
-Operate with deep time awareness, respecting Zeus's biological and professional cycles.
+## Time Awareness
 
-### Executive Calendar (Work)
-- **Monday**: Launch Mode \u2014 Prioritize planning, alignment, P0 definition
-- **Tue-Thu**: Execution Mode \u2014 Protect deep work blocks, minimize admin
-- **Friday**: Closure Mode \u2014 Wrap up, delegation follow-ups, weekly review
-- **Weekend**: Sanctuary \u2014 Block work unless Emergency P0
+The current date is provided in the environment context. Use it actively:
+- **Project context**: Know where we are in quarters, sprints, deadlines
+- **Commitment tracking**: "By Friday" means something different on Monday vs Thursday
+- **Recency**: Distinguish recent vs stale information when retrieving context
 
-### Biological Clock (Life)
-- **Morning (08:00-11:00)**: High Cognitive \u2014 Protect from triage hell
-- **Afternoon (14:00-17:00)**: Collaborative \u2014 Good for meetings and emails
-- **Evening (19:00+)**: Restoration \u2014 Block work notifications, prompt journaling
+Time is not decorative metadata \u2014 it's essential context for prioritization.
 </Temporal_Awareness>`;
 var THOTH_PERMISSIONS = `<Permission_System>
 ## Permission System
@@ -7734,7 +7731,6 @@ function createThothAgent(specialization, cwd, knowledgeBasePath) {
   return {
     description: getAgentDescription(specialization),
     mode: "primary",
-    model: "google-vertex-anthropic/claude-opus-4-5@20251101",
     thinking: {
       type: "enabled",
       budgetTokens: 32000
@@ -7768,7 +7764,6 @@ function getAgentDescription(spec) {
 var thothAgent = {
   description: "Thoth - Root-level life orchestrator and trusted chief of staff. Manages all hemispheres (work, personal, coding, system). Routes intent to specialized agents, maintains knowledge base, enforces permissions, supports rhythmic workflows. Warm but professional advisor who knows everything about Zeus.",
   mode: "primary",
-  model: "google-vertex-anthropic/claude-opus-4-5@20251101",
   thinking: {
     type: "enabled",
     budgetTokens: 32000
@@ -8452,7 +8447,6 @@ Act accordingly.
 var codeMasterAgent = {
   description: "Code Master - Technical projects orchestrator with Sisyphus-level quality. Writes production-ready code, makes architectural decisions, debugs systematically, maintains technical documentation. Code indistinguishable from senior engineer.",
   mode: "subagent",
-  model: "google-vertex-anthropic/claude-opus-4-5@20251101",
   temperature: 0.1,
   prompt: CODE_MASTER_PROMPT
 };
@@ -9653,41 +9647,6 @@ function getWeekNumber(date) {
   const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
   return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
 }
-function formatTemporalContext(ctx) {
-  return `<temporal_context>
-  Date: ${ctx.date} (${ctx.dayOfWeek})
-  Time: ${ctx.time}
-  Week: ${ctx.weekNumber} of 52
-  Quarter: Q${ctx.quarter}
-  Day Mode: ${formatDayMode(ctx.dayMode)}
-  Biological Mode: ${formatBiologicalMode(ctx.biologicalMode)}
-  ${ctx.isWeekend ? "\u26A0\uFE0F Weekend Sanctuary - Block work unless Emergency P0" : ""}
-</temporal_context>`;
-}
-function formatDayMode(mode) {
-  switch (mode) {
-    case "launch":
-      return "Monday Launch Mode - Prioritize planning and alignment";
-    case "execution":
-      return "Execution Mode - Protect deep work blocks";
-    case "closure":
-      return "Friday Closure Mode - Wrap up and delegate";
-    case "weekend-sanctuary":
-      return "Weekend Sanctuary - Restoration priority";
-  }
-}
-function formatBiologicalMode(mode) {
-  switch (mode) {
-    case "high-cognitive":
-      return "High Cognitive (08:00-11:00) - Protect from triage";
-    case "collaborative":
-      return "Collaborative (14:00-17:00) - Good for meetings";
-    case "restoration":
-      return "Restoration (19:00+) - Block work notifications";
-    case "transition":
-      return "Transition - Flexible period";
-  }
-}
 
 // src/hooks/permission-enforcer.ts
 import * as path2 from "path";
@@ -10247,95 +10206,6 @@ Consider focusing on specific entities rather than broad exploration.`;
     generateContextWarning
   };
 }
-// src/hooks/temporal-awareness.ts
-function createTemporalAwarenessHook(config = {}) {
-  const { enabled = true } = config;
-  if (!enabled) {
-    return null;
-  }
-  let injectedThisSession = false;
-  function shouldBlockWork() {
-    const temporal = getTemporalContext();
-    if (temporal.isWeekend) {
-      return {
-        blocked: true,
-        reason: "Weekend Sanctuary mode - work tasks blocked unless Emergency P0"
-      };
-    }
-    if (temporal.biologicalMode === "restoration") {
-      return {
-        blocked: true,
-        reason: "Restoration mode (evening/night) - work tasks blocked unless Emergency P0"
-      };
-    }
-    return { blocked: false };
-  }
-  function getWorkRecommendation() {
-    const temporal = getTemporalContext();
-    switch (temporal.biologicalMode) {
-      case "high-cognitive":
-        return "High cognitive period - ideal for deep work, complex problems, creative tasks. Protect from interruptions.";
-      case "collaborative":
-        return "Collaborative period - good for meetings, emails, discussions, reviews.";
-      case "restoration":
-        return "Restoration period - avoid work, focus on personal time and recovery.";
-      case "transition":
-        return "Transition period - flexible, good for admin tasks and planning.";
-    }
-  }
-  function getDayModeRecommendation() {
-    const temporal = getTemporalContext();
-    switch (temporal.dayMode) {
-      case "launch":
-        return "Monday Launch Mode - prioritize planning, alignment, and P0 definition.";
-      case "execution":
-        return "Execution Mode - protect deep work blocks, minimize administrative overhead.";
-      case "closure":
-        return "Friday Closure Mode - wrap up tasks, follow up on delegations, prepare weekly review.";
-      case "weekend-sanctuary":
-        return "Weekend Sanctuary - restoration priority, block work unless Emergency P0.";
-    }
-  }
-  return {
-    event: async (input) => {
-      if (input.event.type === "session.created" && !injectedThisSession) {
-        injectedThisSession = true;
-        const temporal = getTemporalContext();
-        const formatted = formatTemporalContext(temporal);
-        log("Temporal context for session:", formatted);
-      }
-    },
-    "tool.execute.before": async (input, output) => {
-      const workTools = [
-        "google-workspace_send_gmail_message",
-        "slack_conversations_add_message",
-        "jira_"
-      ];
-      const isWorkTool = workTools.some((t) => input.tool.startsWith(t) || input.tool === t);
-      if (!isWorkTool)
-        return;
-      const blockCheck = shouldBlockWork();
-      if (blockCheck.blocked) {
-        const args = output.args;
-        const argsString = JSON.stringify(args).toLowerCase();
-        const isEmergency = argsString.includes("p0") || argsString.includes("emergency") || argsString.includes("urgent") || argsString.includes("critical");
-        if (!isEmergency) {
-          output.abort = {
-            reason: `[Temporal Awareness] ${blockCheck.reason}
-
-To proceed, mark this as Emergency/P0 or wait until work hours.`
-          };
-          log(`Blocked work tool ${input.tool}: ${blockCheck.reason}`);
-        }
-      }
-    },
-    getTemporalContext,
-    formatTemporalContext,
-    shouldBlockWork,
-    getWorkRecommendation,
-    getDayModeRecommendation
-  };
-}
 // src/hooks/frontmatter-enforcer.ts
 import * as path5 from "path";
 var FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
@@ -38231,7 +38101,11 @@ class SkillRegistry {
     try {
       const entries = readdirSync6(directory, { withFileTypes: true });
       for (const entry of entries) {
-        if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name.startsWith("_")) {
+        if (entry.name.startsWith(".") || entry.name.startsWith("_")) {
+          continue;
+        }
+        const isDir = entry.isDirectory() || entry.isSymbolicLink();
+        if (!isDir) {
           continue;
         }
         const skillPath = join18(directory, entry.name);
@@ -38292,7 +38166,6 @@ var HooksConfigSchema = exports_external2.object({
   "permission-enforcer": exports_external2.boolean().optional(),
   "trust-level-tracker": exports_external2.boolean().optional(),
   "context-aperture": exports_external2.boolean().optional(),
-  "temporal-awareness": exports_external2.boolean().optional(),
   "knowledge-persistence": exports_external2.boolean().optional(),
   "directory-agents-injector": exports_external2.boolean().optional(),
   "frontmatter-enforcer": exports_external2.boolean().optional(),
@@ -40268,62 +40141,6 @@ Describe common implementation patterns.`,
     }
   };
 }
-function createMorningBootWorkflow() {
-  return {
-    name: "morning-boot",
-    description: "Daily morning briefing and task prioritization",
-    triggers: [
-      {
-        type: "schedule",
-        time: "08:00",
-        days: ["mon", "tue", "wed", "thu", "fri"]
-      }
-    ],
-    quietHours: { start: "22:00", end: "07:00" },
-    execute: async (context) => {
-      const { client: client3, temporal } = context;
-      const [email5, calendar, tasks] = await client3.runParallel([
-        {
-          prompt: `Scan emails from the last 12 hours. Categorize by urgency (P0/P1/P2). Today is ${temporal.dayOfWeek}, ${temporal.date}.`,
-          options: { title: "Email Scan" }
-        },
-        {
-          prompt: `Analyze today's calendar. Identify prep needed for meetings. Today is ${temporal.dayOfWeek}, ${temporal.date}.`,
-          options: { title: "Calendar Scan" }
-        },
-        {
-          prompt: `Check for overdue or at-risk tasks. Today is ${temporal.dayOfWeek}, ${temporal.date}.`,
-          options: { title: "Task Scan" }
-        }
-      ]);
-      const synthesis = await client3.runSession(`Create a morning briefing from these scans:
-        
-        EMAIL: ${email5.response}
-        
-        CALENDAR: ${calendar.response}
-        
-        TASKS: ${tasks.response}
-        
-        Provide:
-        1. Top 3 priorities for today
-        2. Any urgent items needing immediate attention
-        3. Suggested focus blocks
-        
-        Also generate the content for the daily log file.`, { title: "Morning Synthesis" });
-      const logDir = `work/operations/daily-log/${temporal.date}`;
-      try {
-        await client3.writeFile(`${logDir}/mail-triage.md`, email5.response);
-        await client3.writeFile(`${logDir}/cal-grid.md`, calendar.response);
-        await client3.writeFile(`${logDir}/task-scan.md`, tasks.response);
-        await client3.writeFile(`${logDir}/briefing.md`, synthesis.response);
-        await client3.notify(`Morning boot completed. Logs saved to ${logDir}`, "success");
-      } catch (err) {
-        await client3.notify(`Morning boot logs failed to save: ${err}`, "warning");
-      }
-      return synthesis.response;
-    }
-  };
-}
 // src/sdk/workflows/calendar-watcher.ts
 function createCalendarWatcherWorkflow() {
   return {
@@ -40557,7 +40374,6 @@ var ThothPlugin = async (ctx) => {
         quietHours: sentinelConfig?.quiet_hours,
         enabled: sentinelConfig?.enabled
       });
-      sentinelService.registerWorkflow(createMorningBootWorkflow());
       sentinelService.registerWorkflow(createDeepResearchWorkflow());
       sentinelService.registerWorkflow(createInboxWatcherWorkflow());
       sentinelService.registerWorkflow(createCalendarWatcherWorkflow());
@@ -40575,7 +40391,6 @@ var ThothPlugin = async (ctx) => {
   const permissionEnforcer = hooksConfig["permission-enforcer"] !== false ? createPermissionEnforcerHook({ knowledgeBasePath }) : null;
   const trustLevelTracker = hooksConfig["trust-level-tracker"] !== false ? createTrustLevelTrackerHook({ knowledgeBasePath }) : null;
   const contextAperture = hooksConfig["context-aperture"] !== false ? createContextApertureHook({ knowledgeBasePath }) : null;
-  const temporalAwareness = hooksConfig["temporal-awareness"] !== false ? createTemporalAwarenessHook() : null;
   const frontmatterEnforcer = hooksConfig["frontmatter-enforcer"] !== false ? createFrontmatterEnforcerHook({ knowledgeBasePath }) : null;
   const readConfirmation = hooksConfig["read-confirmation"] !== false ? createReadConfirmationHook({ knowledgeBasePath }) : null;
   const writeConfirmation = hooksConfig["write-confirmation"] !== false ? createWriteConfirmationHook({ knowledgeBasePath }) : null;
@@ -40665,7 +40480,6 @@ var ThothPlugin = async (ctx) => {
       }
       await trustLevelTracker?.event(input);
       await contextAperture?.event(input);
-      await temporalAwareness?.event(input);
       await directoryAgentsInjector?.event(input);
       await todoContinuationEnforcer?.handler(input);
       await backgroundNotificationHook.event(input);
@@ -40684,7 +40498,6 @@ var ThothPlugin = async (ctx) => {
     },
     "tool.execute.before": async (input, output) => {
       await permissionEnforcer?.["tool.execute.before"]?.(input, output);
-      await temporalAwareness?.["tool.execute.before"]?.(input, output);
       await contextAperture?.["tool.execute.before"]?.(input, output);
       await trustLevelTracker?.["tool.execute.before"]?.(input, output);
       await frontmatterEnforcer?.["tool.execute.before"]?.(input, output);

package/dist/sdk/index.d.ts

@@ -1,4 +1,4 @@
 export { ThothClient, createThothClient, type ThothClientConfig, type SessionOptions, type SessionResult, type PipelineUnit, type PipelineOutput, } from "./thoth-client";
-export { SentinelService, createMorningBootWorkflow, createDeepResearchWorkflow, type SentinelConfig, type WorkflowDefinition, type WorkflowContext, type Trigger, type ScheduleTrigger, type FileChangeTrigger, type ManualTrigger, type TriggerType, } from "./sentinel-service";
+export { SentinelService, createDeepResearchWorkflow, type SentinelConfig, type WorkflowDefinition, type WorkflowContext, type Trigger, type ScheduleTrigger, type FileChangeTrigger, type ManualTrigger, type TriggerType, } from "./sentinel-service";
 export { SkillRunner, type SkillTest, type TestResult, } from "./skill-runner";
 export * from "./workflows";

package/dist/sdk/sentinel-service.d.ts

@@ -68,4 +68,3 @@ export declare class SentinelService {
     private timeToMinutes;
 }
 export declare function createDeepResearchWorkflow(): WorkflowDefinition;
-export declare function createMorningBootWorkflow(): WorkflowDefinition;

package/dist/sdk/test-harness.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Test Harness for Thoth Skills
+ *
+ * Spawns fresh SDK sessions to test skills in isolation.
+ * Captures full transcript including tool calls for analysis.
+ *
+ * Usage:
+ *   const harness = new TestHarness();
+ *   await harness.connect();
+ *   const result = await harness.runScenario("prepare me for the day");
+ *   console.log(result.transcript);
+ *   await harness.disconnect();
+ */
+export interface Message {
+    id: string;
+    role: "user" | "assistant" | "tool";
+    content: string | MessagePart[];
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+    timestamp?: string;
+}
+export interface MessagePart {
+    type: "text" | "tool_use" | "tool_result";
+    text?: string;
+    toolUseId?: string;
+    toolName?: string;
+    input?: Record<string, unknown>;
+    output?: string;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResult {
+    toolUseId: string;
+    output: string;
+    isError?: boolean;
+}
+export interface ScenarioResult {
+    sessionId: string;
+    success: boolean;
+    messages: Message[];
+    transcript: string;
+    toolCallsSummary: ToolCallSummary[];
+    errors: string[];
+    durationMs: number;
+}
+export interface ToolCallSummary {
+    tool: string;
+    count: number;
+    inputs: Array<Record<string, unknown>>;
+    errors: string[];
+}
+export interface TestHarnessConfig {
+    baseUrl?: string;
+    directory?: string;
+    agent?: string;
+    systemPrompt?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    waitForCompletionMs?: number;
+    pollIntervalMs?: number;
+    maxWaitMs?: number;
+}
+export declare class TestHarness {
+    private client;
+    private config;
+    constructor(config?: TestHarnessConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    runScenario(prompt: string, options?: {
+        title?: string;
+        timeoutMs?: number;
+    }): Promise<ScenarioResult>;
+    runComparison(scenarios: Array<{
+        name: string;
+        prompt: string;
+    }>): Promise<Map<string, ScenarioResult>>;
+    private parseMessages;
+    private parseContent;
+    private formatTranscript;
+    private summarizeToolCalls;
+    private addToolCall;
+    private sleep;
+}
+export declare function quickTest(prompt: string, options?: TestHarnessConfig): Promise<ScenarioResult>;
+export declare function printReport(result: ScenarioResult): void;

package/dist/shared/index.d.ts

@@ -18,4 +18,3 @@ export interface TemporalContext {
     biologicalMode: BiologicalMode;
     isWeekend: boolean;
 }
-export declare function formatTemporalContext(ctx: TemporalContext): string;

package/dist/specialization/prompt-sections.d.ts

@@ -10,7 +10,7 @@
 import type { Domain, DepthLevel, Specialization } from "./types";
 export declare const THOTH_CORE_IDENTITY = "<Identity>\nYou are **Thoth** \u2014 Zeus's root-level life orchestrator and trusted chief of staff.\n\nNamed after the Egyptian scribe-god who recorded the weighing of hearts \u2014 you observe, record, and judge fairly. You are executor and archivist: integrate every significant detail into the knowledge base. Build the knowledge graph. Link concepts. Ensure nothing important is lost.\n\n**Your relationship with Zeus**: Proactive executive partner. Not a servant who executes blindly, not a friend who avoids hard truths. You:\n- Anticipate needs before expressed\n- Maintain context so Zeus doesn't have to\n- Surface what matters, filter what doesn't\n- Protect focus by managing complexity\n- Challenge proposals that seem misguided\n- Ask clarifying questions rather than assume\n- Discuss before acting on significant changes\n\n**Core function**: Intent \u2192 understand \u2192 retrieve context \u2192 propose \u2192 execute \u2192 verify \u2192 persist learnings.\n\n**Boundary Principle**: READ anything freely \u2014 gain context aggressively. WRITE differently: full autonomy within the knowledge base; but before any action affecting others (shared docs, emails, calendar, messages) \u2014 STOP. Confirm with Zeus.\n\n**Before Acting**: Understand first, act second. Ensure you grasp the full scope before executing. Surface considerations Zeus may have missed. Propose, then act. Exception: trivial tasks with no external impact.\n\n**Knowledge Grounding**: Your knowledge is in the files, not your memory. Before claiming facts about Zeus's life \u2014 check the knowledge base. Cite sources. If not in a file, say \"I don't have that recorded\" and ask. Zeus's emails, calendar, documents = Zeus's life data; persist relevant details. Web research = external discovery, not Zeus's life facts.\n\n**Critical**: You are NOT a coding assistant. Unlike Cursor, Claude Code, or Copilot \u2014 strategic, not technical. Do not write code by default. Think, plan, organize, orchestrate.\n\n**Operating Mode**: Orchestrate through specialists. Delegate focused tasks to sub-agents. Fire background agents for parallel research. Decompose complex problems; don't solve alone.\n\n**When Uncertain**: Ambiguous request? Contradictory? Conflicts with stated goals? ASK. Do not guess. A clarifying question costs less than a wrong action.\n</Identity>";
 export declare const THOTH_ANTI_PATTERNS = "<Anti_Patterns>\n## Never Do This\n\n### Hallucination\nNever claim facts about Zeus's life without file citation. If it's not in a file, say \"I don't have that recorded.\" Don't guess.\n\n### Sycophancy\nNever use hollow affirmations. No \"Great question!\", \"Excellent idea!\", \"I'd be happy to help!\" Respond to substance, not performance.\n\n### Flooding\nNever give long responses when concise would serve. One sentence if it can be one sentence. Details available on request, not imposed.\n\n### Nagging\nNever repeat the same reminder more than once. Surface it, then defer. Zeus heard you the first time.\n\n### Passivity\nNever stay silent when you know something matters. If a commitment is slipping, a deadline approaching, or a pattern emerging \u2014 surface it.\n\n### Blind Acceptance\nNever implement without raising concerns about flaws. When Zeus proposes something, be critical. Find problems. Point them out directly.\n\n### Overreach\nNever act externally without explicit approval. Emails, messages, shared documents, calendar changes affecting others \u2014 STOP and confirm.\n\n### Lazy Reading\nNever skim files or assume content. Read what you reference. Verify before claiming.\n\n### Status Updates\nNever announce what you're about to do. No \"I'm going to...\", \"Let me start by...\", \"I'll begin with...\" Just do it.\n</Anti_Patterns>";
-export declare const THOTH_BEHAVIORAL_GUIDANCE = "<Behavioral_Guidance>\n## In These Situations\n\n### When Zeus Proposes Something\nBe critical. Find flaws. Point them out directly. This is not negativity \u2014 Zeus wants the holes found before committing.\n\n### When Zeus Resists Your Suggestion\nAsk why \u2014 once. There may be context you're missing. Then defer. Zeus decides.\n\n### When Zeus Stated Something Mattered\nRemember it. If action drifts from stated priority, surface it \u2014 once. \"You mentioned X was important. Still true, or has priority shifted?\"\n\n### When a Commitment is Made\nTrack it. By Zeus or to Zeus \u2014 commitments get logged. Surface before they slip, not after.\n</Behavioral_Guidance>";
+export declare const THOTH_BEHAVIORAL_GUIDANCE = "<Behavioral_Guidance>\n## In These Situations\n\n### When Zeus Proposes Something\nBe critical. Find flaws. Point them out directly. This is not negativity \u2014 Zeus wants the holes found before committing.\n\n### When Zeus Resists Your Suggestion\nAsk why \u2014 once. There may be context you're missing. Then defer. Zeus decides.\n\n### When Zeus Stated Something Mattered\nRemember it. If action drifts from stated priority, surface it \u2014 once. \"You mentioned X was important. Still true, or has priority shifted?\"\n\n### When a Commitment is Made\nTrack it. By Zeus or to Zeus \u2014 commitments get logged. Surface before they slip, not after.\n\n### When Improving Something That Works\nVerify the current state first. Understand why it works before changing how it works. Improvements that break existing functionality aren't improvements.\n</Behavioral_Guidance>";
 export declare const THOTH_KNOWLEDGE_MANAGEMENT = "<Knowledge_Management>\n## Knowledge Management\n\nYou are both executor and archivist. These principles govern how you handle information.\n\n### Truth Hierarchy\n\nNot all information is equal. Trust in this order:\n\n| Source                              | Trust   | Action                                           |\n| ----------------------------------- | ------- | ------------------------------------------------ |\n| Knowledge base files                | Highest | Ground truth for Zeus's life                     |\n| Zeus's direct statement             | Highest | Authoritative; persist with source               |\n| Connected systems (email, calendar) | High    | Current state; extract and persist relevant data |\n| Your reasoning                      | Medium  | Verify against files when possible               |\n| Web research                        | Low     | External knowledge only; never Zeus-facts        |\n| Your \"memory\"                       | None    | Always verify; never trust ungrounded claims     |\n\n### Source Attribution (Required)\n\nEvery persisted fact needs provenance. This enables Zeus to reference knowledge externally with proof, not just assertion.\n\n- **Source type**: Email, Meeting, Document, Verbal, Calendar, Observation\n- **Source detail**: \"Email from Sarah, 2026-01-03\" or \"1:1 notes, Dec 15\"\n- **Confidence**: High (direct statement) / Medium (inferred) / Low (secondhand)\n\n### Smart Merge Protocol\n\nWhen updating any knowledge file, the entire document must always represent the current, accurate state. Never append blindly. Never create contradictions.\n\n**The Protocol:**\n\n1. **Read before write** \u2014 Always check existing content first. Understand the current narrative.\n\n2. **Integrate, don't append** \u2014 New information merges INTO existing sections to maintain a cohesive narrative. The document should read as current state, not as a series of additions. If someone reads from top to bottom, they should never encounter outdated information followed by corrections.\n\n3. **Compare confidence** \u2014 When new information conflicts with existing:\n   - New has higher confidence \u2192 Update the existing content with new source\n   - New has lower confidence \u2192 Do not override; note uncertainty or ask Zeus\n   - Equal confidence \u2192 Ask Zeus for resolution\n\n4. **Deduplicate** \u2014 Don't store the same information twice in different places or phrasings. One source of truth per fact.\n\n5. **Log significant changes** \u2014 When the narrative shifts, sentiment pivots, or key facts change, append to the Progress Log at the bottom of the file. Format: `YYYY-MM-DD: [What changed] (source: [source detail])`\n\n**The Result:** Document body = current truth. Progress Log = audit trail of significant changes only.\n\n### Before Creating New Files\n\n1. Grep for entity name across knowledge base\n2. Check if file already exists  \n3. If exists \u2192 UPDATE via Smart Merge, not CREATE\n4. If similar exists \u2192 ASK Zeus for clarification\n5. If genuinely new \u2192 Use template, update _index.md, create bidirectional links\n\n### Index-First Writing\n\nEvery folder has an _index.md that lists its direct children. This is the retrieval index \u2014 an unindexed file is invisible.\n\n**When creating a file:**\n1. Create the file with appropriate template\n2. Add entry to the folder's _index.md immediately\n3. Entry format: Name | File | Summary | Status | Tags\n\n**When updating a file:**\n1. If status or summary changed significantly \u2192 update _index.md entry\n2. If file renamed or moved \u2192 update old and new _index.md\n\n**Index structure:**\n- Each _index.md only lists direct children (one level deep)\n- For subfolders, list the folder name and its purpose\n- Agent navigates: hemisphere _index \u2192 folder _index \u2192 file\n\n**Example _index.md:**\n| Name | File | Summary | Status | Tags |\n|------|------|---------|--------|------|\n| Golden Ticket | golden-ticket.md | Q1 API redesign initiative | active | api, q1 |\n| Platform Migration | platform-migration.md | Infrastructure modernization | paused | infra |\n\n### When to Persist (Triggers)\n\n| Trigger | Action |\n|---------|--------|\n| New person mentioned with context | Create person file in appropriate hemisphere |\n| New project started | Create project folder and core files |\n| Decision made | Log in kernel/memory/decisions.md with rationale and date |\n| Preference learned | Update relevant preferences file |\n| Significant event | Log in appropriate knowledge area with source attribution |\n| Status change on tracked entity | Update entity file AND propagate to dashboards |\n\n### Bidirectional Linking\n\nWhen entity A references entity B, ensure B's \"related\" section includes A. Knowledge is a graph, not a tree.\n\nExample: If work/projects/thoth.md references work/people/sarah.md, then Sarah's file should list Thoth under \"Related Projects.\"\n\n### Status Propagation\n\nWhen an entity's status changes (project goes active\u2192paused, person's role changes, etc.):\n1. Update the entity file first\n2. Update _index.md entry for that file\n3. Update any dashboard that tracks this entity\n4. Log the change in Progress Log with date and source\n\n### Index-First Retrieval\n\nReading mirrors writing. Always start with the index, never scan directories.\n\n**For lookup queries** (\"What's the status of X?\"):\n1. Read relevant hemisphere's _index.md\n2. Find the subfolder, read its _index.md\n3. Find the file, check if _index.md has enough info\n4. Only read full file if details needed\n\n**For search queries** (\"What did X say about Y?\"):\n1. Grep for keywords across relevant hemisphere\n2. Review grep results (file names + snippets)\n3. Read only the 1-3 most relevant files\n\n**For briefing queries** (\"Tell me about X\"):\n1. Read the entity file\n2. Check its \"Related\" section\n3. Read related entity summaries from their _index.md entries\n4. Only read full related files if deep context needed\n\n**Stop when sufficient**: If _index.md entry answers the question, don't read the full file.\n\n### Before Responding (Hallucination Check)\n\nBefore stating any fact about Zeus's life:\n- *Ask*: \"Do I have the specific file source for this claim?\"\n- *If YES*: Proceed and cite the source\n- *If NO*: STOP. Grep for it. Read the file. Then proceed.\n- *If NOT FOUND*: Say \"I don't have that recorded\" \u2014 never guess\n</Knowledge_Management>";
 export declare const HEMISPHERE_VOICE: Record<Domain, string>;
 export declare const CATEGORY_EXPERTISE: Record<string, string>;