thoth-plugin 1.2.3 → 1.2.5

package/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/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/cli.js

@@ -2,10 +2,19 @@
 // @bun
 
 // src/cli.ts
-import { existsSync, mkdirSync, cpSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, cpSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve } from "path";
 import { homedir } from "os";
 var __dirname = "/Users/davidhelmus/Repos/thoth/thoth-core/src";
+var GLOBAL_CONFIG_DIR = join(homedir(), ".config", "opencode");
+var GLOBAL_CONFIG_PATH = join(GLOBAL_CONFIG_DIR, "thoth.json");
+function getSystemTimezone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    return "UTC";
+  }
+}
 var KNOWLEDGE_BASE_TEMPLATE = `
 # Thoth Knowledge Base
 
@@ -75,23 +84,148 @@ function init() {
       console.warn("Warning: Could not find defaults directory. Skills will not be pre-populated.");
     }
     writeFileSync(join(targetDir, "README.md"), KNOWLEDGE_BASE_TEMPLATE.trim());
+    writeFileSync(join(targetDir, ".thoth-root"), `# Thoth Knowledge Base Root Marker
+# This file helps context-discovery locate the KB
+`);
+    const projectConfig = {
+      type: "thoth-kb",
+      version: "1.0",
+      hemispheres: ["kernel", "work", "life"],
+      created: new Date().toISOString().split("T")[0]
+    };
+    mkdirSync(join(targetDir, ".opencode"), { recursive: true });
+    writeFileSync(join(targetDir, ".opencode", "thoth.json"), JSON.stringify(projectConfig, null, 2) + `
+`);
+    mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+    const globalConfig = {
+      kb_root: targetDir,
+      default_hemisphere: "work",
+      timezone: getSystemTimezone(),
+      created: new Date().toISOString().split("T")[0],
+      version: "1.0"
+    };
+    writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(globalConfig, null, 2) + `
+`);
+    console.log(`\u2713 Global config created: ${GLOBAL_CONFIG_PATH}`);
     console.log("\u2713 Knowledge base created!");
     console.log("");
+    console.log("Created:");
+    console.log(`  - KB root: ${targetDir}`);
+    console.log(`  - Global config: ${GLOBAL_CONFIG_PATH}`);
+    console.log(`  - Project marker: ${join(targetDir, ".opencode", "thoth.json")}`);
+    console.log("");
     console.log("Next steps:");
     console.log(`1. cd ${targetDir}`);
     console.log("2. Start OpenCode");
-    console.log("3. Ask Thoth: 'Help me onboard'");
+    console.log("3. Run '/morning-boot' to start your day");
+    console.log("");
+    console.log("Note: First run will prompt for Google OAuth to access email/calendar.");
   } catch (err) {
     console.error("Failed to initialize knowledge base:", err);
     process.exit(1);
   }
 }
+function link() {
+  const targetDir = resolve(process.cwd());
+  const hasKernel = existsSync(join(targetDir, "kernel"));
+  const hasWork = existsSync(join(targetDir, "work"));
+  const hasLife = existsSync(join(targetDir, "life"));
+  if (!hasKernel && !hasWork && !hasLife) {
+    console.log("Warning: Current directory doesn't look like a Thoth KB.");
+    console.log("Expected directories: kernel/, work/, or life/");
+    console.log("");
+    console.log("Continue anyway? This will create config files pointing to this directory.");
+    console.log("(Run 'thoth init' to create a new KB instead)");
+    console.log("");
+  }
+  try {
+    const projectConfigPath = join(targetDir, ".opencode", "thoth.json");
+    if (!existsSync(projectConfigPath)) {
+      const projectConfig = {
+        type: "thoth-kb",
+        version: "1.0",
+        hemispheres: ["kernel", "work", "life"].filter((h) => existsSync(join(targetDir, h))),
+        created: new Date().toISOString().split("T")[0]
+      };
+      mkdirSync(join(targetDir, ".opencode"), { recursive: true });
+      writeFileSync(projectConfigPath, JSON.stringify(projectConfig, null, 2) + `
+`);
+      console.log(`\u2713 Project marker created: ${projectConfigPath}`);
+    } else {
+      console.log(`\u2713 Project marker exists: ${projectConfigPath}`);
+    }
+    const markerPath = join(targetDir, ".thoth-root");
+    if (!existsSync(markerPath)) {
+      writeFileSync(markerPath, `# Thoth Knowledge Base Root Marker
+`);
+      console.log(`\u2713 Root marker created: ${markerPath}`);
+    }
+    mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+    let globalConfig = {};
+    if (existsSync(GLOBAL_CONFIG_PATH)) {
+      try {
+        globalConfig = JSON.parse(readFileSync(GLOBAL_CONFIG_PATH, "utf-8"));
+      } catch {}
+    }
+    globalConfig.kb_root = targetDir;
+    globalConfig.default_hemisphere = globalConfig.default_hemisphere || "work";
+    globalConfig.timezone = globalConfig.timezone || getSystemTimezone();
+    globalConfig.updated = new Date().toISOString().split("T")[0];
+    globalConfig.version = "1.0";
+    writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(globalConfig, null, 2) + `
+`);
+    console.log(`\u2713 Global config updated: ${GLOBAL_CONFIG_PATH}`);
+    console.log("");
+    console.log(`Linked ${targetDir} as your Thoth KB.`);
+    console.log("Context-discovery will now find this KB from any directory.");
+  } catch (err) {
+    console.error("Failed to link knowledge base:", err);
+    process.exit(1);
+  }
+}
+function status() {
+  console.log("Thoth Configuration Status");
+  console.log("===========================");
+  console.log("");
+  if (existsSync(GLOBAL_CONFIG_PATH)) {
+    try {
+      const config = JSON.parse(readFileSync(GLOBAL_CONFIG_PATH, "utf-8"));
+      console.log(`Global config: ${GLOBAL_CONFIG_PATH}`);
+      console.log(`  kb_root: ${config.kb_root}`);
+      console.log(`  timezone: ${config.timezone}`);
+      console.log(`  default_hemisphere: ${config.default_hemisphere}`);
+      if (config.kb_root && existsSync(config.kb_root)) {
+        console.log(`  status: \u2713 KB exists`);
+        const projectMarker = join(config.kb_root, ".opencode", "thoth.json");
+        if (existsSync(projectMarker)) {
+          console.log(`  project marker: \u2713 exists`);
+        } else {
+          console.log(`  project marker: \u2717 missing (run 'thoth link' from KB directory)`);
+        }
+      } else {
+        console.log(`  status: \u2717 KB not found at path`);
+      }
+    } catch {
+      console.log(`Global config: ${GLOBAL_CONFIG_PATH} (invalid JSON)`);
+    }
+  } else {
+    console.log("Global config: not found");
+    console.log("  Run 'thoth init' to create a new KB, or");
+    console.log("  Run 'thoth link' from an existing KB directory");
+  }
+}
 var command = process.argv[2];
 if (command === "init") {
   init();
+} else if (command === "link") {
+  link();
+} else if (command === "status") {
+  status();
 } else {
   console.log("Thoth - Life Orchestrator for OpenCode");
   console.log("");
   console.log("Commands:");
-  console.log("  thoth init [path]  Create knowledge base (default: ~/thoth)");
+  console.log("  thoth init [path]  Create new knowledge base (default: ~/thoth)");
+  console.log("  thoth link         Link current directory as KB root");
+  console.log("  thoth status       Show current configuration");
 }

package/dist/config/schema.d.ts

@@ -9,7 +9,6 @@ declare const HooksConfigSchema: z.ZodObject<{
     "permission-enforcer": z.ZodOptional<z.ZodBoolean>;
     "trust-level-tracker": z.ZodOptional<z.ZodBoolean>;
     "context-aperture": z.ZodOptional<z.ZodBoolean>;
-    "temporal-awareness": z.ZodOptional<z.ZodBoolean>;
     "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
     "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
     "frontmatter-enforcer": z.ZodOptional<z.ZodBoolean>;
@@ -81,7 +80,6 @@ export declare const ThothPluginConfigSchema: z.ZodObject<{
         "permission-enforcer": z.ZodOptional<z.ZodBoolean>;
         "trust-level-tracker": z.ZodOptional<z.ZodBoolean>;
         "context-aperture": z.ZodOptional<z.ZodBoolean>;
-        "temporal-awareness": z.ZodOptional<z.ZodBoolean>;
         "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
         "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
         "frontmatter-enforcer": z.ZodOptional<z.ZodBoolean>;

package/dist/defaults/skill/cal-grid/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: cal-grid
+description: Map the daily calendar grid identifying meetings, deep work slots, and preparation needs.
+triggers: 
+template: cal-grid-template.md
+created: 2026-01-09
+updated: 2026-01-09
+---
+
+<!--
+ARCHITECTURE REFERENCE: docs/concepts/skill-architecture.md
+This skill can be invoked standalone OR as a subagent context template.
+-->
+
+# Calendar Grid Skill
+
+You are the Daily Grid Architect. Your mission is to scan today's calendar and produce a high-resolution grid of the day.
+
+---
+
+## Context Requirements (EXECUTE FIRST)
+
+This skill requires the user's email address for API calls.
+
+**Step 0 — Get Identity:**
+
+1. **Check if passed in context**: If you received `context.identity.email`, use it directly.
+
+2. **If not passed, invoke context-discovery skill**: Call `skill({ name: "context-discovery" })` and use the returned `email` value.
+
+3. **Store as `EMAIL`** for use in all API calls below.
+
+**If discovery fails**: Stop and report the error from context-discovery.
+
+---
+
+## When to Use
+
+- Morning boot calendar scan
+- "What's on my calendar today?"
+- "Any meetings I need to prepare for?"
+- Before planning focus time
+
+---
+
+## Tools Required
+
+| Action       | Tool                        | Parameters                                                             |
+| ------------ | --------------------------- | ---------------------------------------------------------------------- |
+| Get events   | google-workspace_get_events | `user_google_email: {EMAIL}`, `time_min`, `time_max`, `detailed: true` |
+| Write output | write                       | `work/operations/daily-log/YYYY-MM-DD/cal-grid.md`                                     |
+
+---
+
+## Execution Protocol
+
+### Phase 1: Scan Calendar
+
+```
+google-workspace_get_events(
+  user_google_email={EMAIL},
+  time_min="YYYY-MM-DDT00:00:00Z",  # Today start
+  time_max="YYYY-MM-DDT23:59:59Z",  # Today end
+  detailed=true
+)
+```
+
+Also scan tomorrow for preparation awareness:
+```
+google-workspace_get_events(
+  user_google_email={EMAIL},
+  time_min="YYYY-MM-DD+1T00:00:00Z",  # Tomorrow start
+  time_max="YYYY-MM-DD+1T23:59:59Z",  # Tomorrow end
+  detailed=true
+)
+```
+
+### Phase 2: Analyze Each Meeting
+
+For each event, determine:
+
+| Field | Analysis |
+|-------|----------|
+| **Time** | Start-end in local time |
+| **Event** | Title (clean up noise) |
+| **Attendees** | Who's attending, any VIPs? |
+| **Prep Needed** | What preparation is required? |
+| **Classification** | 1:1, Team, External, Focus, Admin |
+
+**Classification Guide:**
+
+| Type | Signal |
+|------|--------|
+| 1:1 | Two attendees, recurring |
+| Team | 3+ internal attendees |
+| External | External domain attendees |
+| Focus | Blocked time, no attendees |
+| Admin | Recurring admin tasks |
+
+### Phase 3: Identify Focus Blocks
+
+Find gaps between meetings that could be used for deep work:
+
+| Block Quality | Duration |
+|---------------|----------|
+| Deep Work | 90+ minutes |
+| Shallow Work | 30-90 minutes |
+| Buffer | <30 minutes |
+
+### Phase 4: Flag Preparation Needs
+
+For each meeting, assess:
+- Do I need to review anything beforehand?
+- Are there action items I committed to?
+- Is this a high-stakes meeting (skip-level, external)?
+
+---
+
+## Output Format
+
+**Template:** Read `cal-grid-template.md` from this skill folder.
+
+**Output path:** `work/operations/daily-log/YYYY-MM-DD/cal-grid.md`
+
+Fill the template placeholders with scan results:
+
+| Placeholder | Value |
+|-------------|-------|
+| `{{DATE}}` | Today's date (YYYY-MM-DD) |
+| `{{TIME}}` | Scan completion time (HH:MM) |
+| `{{CALENDAR_ID}}` | Calendar scanned (usually "primary") |
+| `{{MEETING_COUNT}}` | Total meetings today |
+| `{{MEETING_HOURS}}` | Total hours in meetings |
+| `{{FOCUS_HOURS}}` | Available focus time |
+| `{{COMPLEXITY}}` | Light/Medium/Heavy |
+| `{{TODAY_MEETINGS_TABLE}}` | Table rows for today's meetings |
+| `{{FOCUS_BLOCKS_TABLE}}` | Table rows for focus blocks |
+| `{{PREP_REQUIRED_TABLE}}` | Table rows for meetings needing prep |
+| `{{CONFLICTS_TABLE}}` | Table rows for conflicts (if any) |
+| `{{TOMORROW_TABLE}}` | Table rows for tomorrow preview |
+| `{{HIGH_PRIORITY_PREP}}` | Urgent prep items |
+| `{{STANDARD_PREP}}` | Standard prep items |
+| `{{DEEP_WORK_STRATEGY}}` | Recommended focus block usage |
+
+**Critical:** Output MUST include `## SCAN_DATA_START` and `## SCAN_DATA_END` markers for parsing.
+
+---
+
+## Completion Checklist
+
+- [ ] Context discovery completed (have EMAIL)
+- [ ] Today's events scanned
+- [ ] Tomorrow's events scanned for prep
+- [ ] Each meeting classified
+- [ ] Focus blocks identified
+- [ ] Preparation needs flagged
+- [ ] Output written to `work/operations/daily-log/YYYY-MM-DD/cal-grid.md`
+- [ ] SCAN_DATA markers included
+
+---
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| No calendar access | Report OAuth needed, stop |
+| Empty calendar | Report "No meetings scheduled", still output focus blocks |
+| API rate limit | Wait and retry once |

package/dist/defaults/skill/cal-grid/cal-grid-template.md

@@ -0,0 +1,106 @@
+---
+type: operations
+hemisphere: work
+created: {{DATE}}
+updated: 2026-01-09
+tags: [cal-grid, daily-log]
+summary: Calendar Grid — {{DATE}}
+---
+
+# Calendar Grid — {{DATE}}
+
+**Scan Time:** {{TIME}}  
+**Calendar:** {{CALENDAR_ID}}
+
+---
+
+## Day Summary
+
+| Metric | Value |
+|--------|-------|
+| **Total meetings** | {{MEETING_COUNT}} |
+| **Meeting hours** | {{MEETING_HOURS}} |
+| **Focus time available** | {{FOCUS_HOURS}} hours |
+| **Complexity** | {{COMPLEXITY}} |
+
+---
+
+## SCAN_DATA_START
+
+### TODAY_MEETINGS
+
+| Time | Event | Attendees | Prep | Type |
+|------|-------|-----------|------|------|
+{{TODAY_MEETINGS_TABLE}}
+
+### FOCUS_BLOCKS
+
+| Block | Duration | Quality |
+|-------|----------|---------|
+{{FOCUS_BLOCKS_TABLE}}
+
+### PREP_REQUIRED
+
+| Time | Meeting | Preparation Needed |
+|------|---------|-------------------|
+{{PREP_REQUIRED_TABLE}}
+
+### CONFLICTS
+
+| Issue | Meetings Affected | Recommendation |
+|-------|-------------------|----------------|
+{{CONFLICTS_TABLE}}
+
+### TOMORROW_PREVIEW
+
+| Time | Event | Prep Needed |
+|------|-------|-------------|
+{{TOMORROW_TABLE}}
+
+## SCAN_DATA_END
+
+---
+
+## Complexity Budget
+
+**Meeting Load: {{COMPLEXITY}}**
+
+{{#if COMPLEXITY == "Light"}}
+- 0-2 meetings scheduled
+- Capacity: 2-3 Heavy tasks, multiple Light tasks
+- Recommendation: Use today for deep work
+{{/if}}
+
+{{#if COMPLEXITY == "Medium"}}
+- 3-4 meetings scheduled
+- Capacity: 1-2 Heavy tasks, few Light tasks
+- Recommendation: Protect focus blocks aggressively
+{{/if}}
+
+{{#if COMPLEXITY == "Heavy"}}
+- 5+ meetings scheduled
+- Capacity: 1 Light task maximum
+- Recommendation: Focus on meetings, defer other work
+{{/if}}
+
+---
+
+## Preparation Alerts
+
+### High Priority
+
+{{HIGH_PRIORITY_PREP}}
+
+### Standard
+
+{{STANDARD_PREP}}
+
+---
+
+## Deep Work Strategy
+
+{{DEEP_WORK_STRATEGY}}
+
+---
+
+*Generated by cal-grid skill at {{TIME}}*