thoth-plugin 1.2.0 → 1.2.2

package/dist/cli.js

@@ -2,462 +2,96 @@
 // @bun
 
 // src/cli.ts
-import {
-  existsSync,
-  mkdirSync,
-  cpSync,
-  writeFileSync,
-  readFileSync,
-  readdirSync
-} from "fs";
-import { join, dirname } from "path";
+import { existsSync, mkdirSync, cpSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
 import { homedir } from "os";
-import { fileURLToPath } from "url";
-import { createInterface } from "readline";
-import { createHash } from "crypto";
-var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = dirname(__filename2);
-var NPM_DEFAULTS_PATH = join(__dirname2, "defaults");
-function prompt(question) {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim().toLowerCase());
-    });
-  });
-}
-function hashFile(filePath) {
-  if (!existsSync(filePath))
-    return "";
-  const content = readFileSync(filePath, "utf-8");
-  return createHash("md5").update(content).digest("hex");
-}
-function countLines(filePath) {
-  if (!existsSync(filePath))
-    return 0;
-  return readFileSync(filePath, "utf-8").split(`
-`).length;
-}
-var README_TEMPLATE = `# Thoth Knowledge Base
+var __dirname = "/Users/davidhelmus/Repos/thoth/thoth-core/src";
+var KNOWLEDGE_BASE_TEMPLATE = `
+# Thoth Knowledge Base
 
-Welcome to your personal Thoth knowledge base - your AI chief of staff for life orchestration.
+Welcome to your personal Thoth knowledge base.
 
 ## Structure
 
-| Hemisphere | Purpose |
-|------------|---------|
-| \`work/\` | Professional life - projects, colleagues, career |
-| \`life/\` | Personal life - health, relationships, home, finance |
-| \`coding/\` | Technical projects and development |
-| \`kernel/\` | System configuration and preferences |
-
-## Getting Started
-
-1. Start OpenCode in this directory:
-   \`\`\`bash
-   cd ${process.argv[3] || "~/thoth"}
-   opencode
-   \`\`\`
-
-2. Ask Thoth to help you onboard:
-   \`\`\`
-   Help me set up my knowledge base
-   \`\`\`
-
-3. Or run the onboarding skill:
-   \`\`\`
-   /system-init
-   \`\`\`
+- **work/** - Professional life (projects, people, logs)
+- **life/** - Personal life (health, finance, home)
+- **coding/** - Technical projects and inventory
+- **kernel/** - System configuration and agents
 
-## Available Skills
+## Operating Modes
 
-Run these skills to automate common workflows:
+Thoth adapts based on where you start the session:
 
-| Skill | Description |
-|-------|-------------|
-| \`/morning-boot\` | Start your day with inbox triage and calendar review |
-| \`/evening-close\` | End-of-day summary and overflow extraction |
-| \`/mail-triage\` | Process Gmail inbox systematically |
-| \`/slack-pulse\` | Scan Slack for mentions and important messages |
-| \`/thought-router\` | Quick capture and route thoughts |
-| \`/post-meeting-drill\` | Process meeting notes into action items |
+- **Root Mode**: \`cd ~/thoth\`
+  - Generic orchestrator, routing, system maintenance.
+- **Work Mode**: \`cd ~/thoth/work\`
+  - Professional Chief of Staff. P0 focus. Deep work context.
+- **Life Mode**: \`cd ~/thoth/life\`
+  - Personal consultant. Health, finance, relationships.
+- **Code Mode**: \`cd ~/thoth/coding\`
+  - Technical architect. Codebase analysis.
 
-## Configuration
-
-Configure Thoth in \`.opencode/thoth-plugin.json\`:
-
-\`\`\`json
-{
-  "knowledge_base": "${process.argv[3] || "~/thoth"}"
-}
-\`\`\`
+## Getting Started
 
-## Learn More
+1. Start OpenCode in the desired context:
+   \`cd ~/thoth && opencode\`
 
-- Ask: "What can you help me with?"
-- Ask: "Explain how Thoth works"
-- Ask: "What skills are available?"
+2. Ask Thoth: "Help me onboard"
 `;
-function copyDefaultSkills(targetSkillDir) {
-  const sourceSkillDir = join(NPM_DEFAULTS_PATH, "skill");
-  if (!existsSync(sourceSkillDir)) {
-    console.log("  (No default skills found in package)");
-    return;
-  }
-  const skills = readdirSync(sourceSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
-  for (const skill of skills) {
-    const source = join(sourceSkillDir, skill);
-    const target = join(targetSkillDir, skill);
-    cpSync(source, target, { recursive: true });
-  }
-  console.log(`  Copied ${skills.length} default skills`);
-}
-function init(targetPath) {
-  const targetDir = targetPath || join(homedir(), "thoth");
+function init() {
+  const targetDir = process.argv[3] || join(homedir(), "thoth");
   if (existsSync(targetDir)) {
-    console.log(`
-Error: Directory already exists: ${targetDir}`);
-    console.log("Use a different path or remove the existing directory.");
-    console.log(`
-Example:`);
-    console.log(`  npx thoth-plugin init ~/my-thoth`);
+    console.log(`Directory already exists: ${targetDir}`);
+    console.log("Use a different path or remove existing directory.");
     process.exit(1);
   }
-  console.log(`
-Creating Thoth knowledge base at: ${targetDir}
-`);
-  const dirs = [
-    "work/projects",
-    "work/people",
-    "work/inbox",
-    "work/logs",
-    "life/inbox",
-    "life/health",
-    "life/relationships",
-    "life/finances",
-    "coding/projects",
-    "coding/references",
-    "kernel/config",
-    "kernel/templates",
-    "kernel/memory",
-    "kernel/Personas",
-    ".opencode/skill"
-  ];
-  for (const dir of dirs) {
-    mkdirSync(join(targetDir, dir), { recursive: true });
-  }
-  console.log("  Created directory structure");
-  const defaultAgentsMd = join(NPM_DEFAULTS_PATH, "AGENTS.md");
-  if (existsSync(defaultAgentsMd)) {
-    cpSync(defaultAgentsMd, join(targetDir, "AGENTS.md"));
-    console.log("  Copied root AGENTS.md");
-  }
-  copyDefaultSkills(join(targetDir, ".opencode", "skill"));
-  writeFileSync(join(targetDir, "README.md"), README_TEMPLATE);
-  console.log("  Created README.md");
-  writeFileSync(join(targetDir, "kernel", "config", "preferences.md"), `---
-type: config
-hemisphere: kernel
-created: ${new Date().toISOString().split("T")[0]}
-updated: ${new Date().toISOString().split("T")[0]}
----
-
-# Preferences
-
-Your personal preferences for Thoth.
-
-## Communication Style
-
-- Default: balanced (not too verbose, not too terse)
-
-## Timezone
-
-- Default: auto-detect
-
-## Work Hours
-
-- Default: 9:00 - 18:00
-
----
-
-*Edit this file to customize Thoth's behavior.*
-`);
-  console.log("  Created kernel/config/preferences.md");
-  const hemispheres = ["work", "life", "coding", "kernel"];
-  for (const hemi of hemispheres) {
-    writeFileSync(join(targetDir, hemi, "registry.md"), `---
-type: registry
-hemisphere: ${hemi}
-created: ${new Date().toISOString().split("T")[0]}
-updated: ${new Date().toISOString().split("T")[0]}
----
-
-# ${hemi.charAt(0).toUpperCase() + hemi.slice(1)} Registry
-
-Index of all knowledge in the ${hemi} hemisphere.
-
-## Contents
-
-*This registry will be populated as you add knowledge.*
-`);
-  }
-  console.log("  Created hemisphere registries");
-  console.log(`
-\u2713 Knowledge base created!
-`);
-  console.log("Next steps:");
-  console.log(`  1. cd ${targetDir}`);
-  console.log("  2. opencode");
-  console.log(`  3. Ask: "Help me onboard"
-`);
-}
-function findKbPath(startPath) {
-  const searchPaths = [
-    startPath,
-    process.cwd(),
-    join(process.cwd(), ".."),
-    join(homedir(), "thoth")
-  ].filter(Boolean);
-  for (const basePath of searchPaths) {
-    const skillPath = join(basePath, ".opencode", "skill");
-    if (existsSync(skillPath)) {
-      return basePath;
+  console.log(`Creating Thoth knowledge base at: ${targetDir}`);
+  try {
+    mkdirSync(join(targetDir, "work", "projects"), { recursive: true });
+    mkdirSync(join(targetDir, "work", "people"), { recursive: true });
+    mkdirSync(join(targetDir, "work", "inbox"), { recursive: true });
+    mkdirSync(join(targetDir, "work", "logs"), { recursive: true });
+    mkdirSync(join(targetDir, "life", "inbox"), { recursive: true });
+    mkdirSync(join(targetDir, "life", "areas"), { recursive: true });
+    mkdirSync(join(targetDir, "coding", "projects"), { recursive: true });
+    mkdirSync(join(targetDir, "coding", "inbox"), { recursive: true });
+    mkdirSync(join(targetDir, "kernel", "config"), { recursive: true });
+    mkdirSync(join(targetDir, "kernel", "templates"), { recursive: true });
+    mkdirSync(join(targetDir, "kernel", "Agents"), { recursive: true });
+    let npmDefaultsPath = resolve(__dirname, "..", "defaults");
+    if (!existsSync(npmDefaultsPath)) {
+      npmDefaultsPath = resolve(__dirname, "..", "..", "defaults");
     }
-  }
-  return null;
-}
-function compareSkills(localSkillDir) {
-  const packageSkillDir = join(NPM_DEFAULTS_PATH, "skill");
-  const results = [];
-  if (!existsSync(packageSkillDir)) {
-    console.log("Error: No skills found in package");
-    return results;
-  }
-  const packageSkills = existsSync(packageSkillDir) ? readdirSync(packageSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
-  const localSkills = existsSync(localSkillDir) ? readdirSync(localSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
-  const allSkills = [...new Set([...packageSkills, ...localSkills])].sort();
-  for (const skill of allSkills) {
-    const localPath = join(localSkillDir, skill);
-    const packagePath = join(packageSkillDir, skill);
-    const localExists = existsSync(localPath);
-    const packageExists = existsSync(packagePath);
-    const localFile = localExists ? existsSync(join(localPath, "SKILL.md")) ? join(localPath, "SKILL.md") : join(localPath, "skill.md") : "";
-    const packageFile = packageExists ? existsSync(join(packagePath, "SKILL.md")) ? join(packagePath, "SKILL.md") : join(packagePath, "skill.md") : "";
-    const localHash = localFile ? hashFile(localFile) : "";
-    const packageHash = packageFile ? hashFile(packageFile) : "";
-    const localLines = localFile ? countLines(localFile) : 0;
-    const packageLines = packageFile ? countLines(packageFile) : 0;
-    let status;
-    if (!localExists && packageExists) {
-      status = "package-only";
-    } else if (localExists && !packageExists) {
-      status = "local-only";
-    } else if (localHash === packageHash) {
-      status = "identical";
-    } else if (localLines > packageLines) {
-      status = "local-newer";
+    if (existsSync(npmDefaultsPath)) {
+      console.log("Copying default skills and agents...");
+      const skillDest = join(targetDir, ".opencode", "skill");
+      mkdirSync(skillDest, { recursive: true });
+      cpSync(join(npmDefaultsPath, "skill"), skillDest, { recursive: true });
+      const agentsSrc = join(npmDefaultsPath, "AGENTS.md");
+      if (existsSync(agentsSrc)) {
+        cpSync(agentsSrc, join(targetDir, "AGENTS.md"));
+      }
     } else {
-      status = "package-newer";
+      console.warn("Warning: Could not find defaults directory. Skills will not be pre-populated.");
     }
-    results.push({
-      name: skill,
-      status,
-      localLines: localLines || undefined,
-      packageLines: packageLines || undefined,
-      localHash: localHash || undefined,
-      packageHash: packageHash || undefined
-    });
-  }
-  return results;
-}
-async function skillUpdate(kbPath) {
-  const basePath = findKbPath(kbPath);
-  if (!basePath) {
-    console.log(`
-Error: Could not find Thoth knowledge base.`);
-    console.log("Run this command from your knowledge base directory, or specify the path:");
-    console.log(`  npx thoth-plugin skill update ~/thoth
-`);
+    writeFileSync(join(targetDir, "README.md"), KNOWLEDGE_BASE_TEMPLATE.trim());
+    console.log("\u2713 Knowledge base created!");
+    console.log("");
+    console.log("Next steps:");
+    console.log(`1. cd ${targetDir}`);
+    console.log("2. Start OpenCode");
+    console.log("3. Ask Thoth: 'Help me onboard'");
+  } catch (err) {
+    console.error("Failed to initialize knowledge base:", err);
     process.exit(1);
   }
-  const localSkillDir = join(basePath, ".opencode", "skill");
-  const packageSkillDir = join(NPM_DEFAULTS_PATH, "skill");
-  console.log(`
-Comparing skills in: ${localSkillDir}
-`);
-  const comparisons = compareSkills(localSkillDir);
-  const identical = comparisons.filter((c) => c.status === "identical");
-  const packageNewer = comparisons.filter((c) => c.status === "package-newer");
-  const localNewer = comparisons.filter((c) => c.status === "local-newer");
-  const packageOnly = comparisons.filter((c) => c.status === "package-only");
-  const localOnly = comparisons.filter((c) => c.status === "local-only");
-  console.log("Skill Status Summary:");
-  console.log("\u2500".repeat(60));
-  if (identical.length > 0) {
-    console.log(`
-\u2713 Up to date (${identical.length}):`);
-    identical.forEach((s) => console.log(`  ${s.name}`));
-  }
-  if (packageNewer.length > 0) {
-    console.log(`
-\u2193 Updates available (${packageNewer.length}):`);
-    packageNewer.forEach((s) => console.log(`  ${s.name} (local: ${s.localLines} lines \u2192 package: ${s.packageLines} lines)`));
-  }
-  if (localNewer.length > 0) {
-    console.log(`
-\u2191 Local is more advanced (${localNewer.length}):`);
-    localNewer.forEach((s) => console.log(`  ${s.name} (local: ${s.localLines} lines vs package: ${s.packageLines} lines)`));
-  }
-  if (packageOnly.length > 0) {
-    console.log(`
-+ New skills available (${packageOnly.length}):`);
-    packageOnly.forEach((s) => console.log(`  ${s.name}`));
-  }
-  if (localOnly.length > 0) {
-    console.log(`
-\u25CB Local only (${localOnly.length}):`);
-    localOnly.forEach((s) => console.log(`  ${s.name}`));
-  }
-  console.log(`
-` + "\u2500".repeat(60));
-  const toUpdate = [...packageNewer, ...packageOnly];
-  if (toUpdate.length === 0) {
-    console.log(`
-\u2713 All skills are up to date!
-`);
-    return;
-  }
-  console.log(`
-${toUpdate.length} skill(s) can be updated.
-`);
-  for (const skill of toUpdate) {
-    const action = skill.status === "package-only" ? "install" : "update";
-    const answer = await prompt(`${action === "install" ? "Install" : "Update"} ${skill.name}? [y/N/q] `);
-    if (answer === "q") {
-      console.log(`
-Aborted.
-`);
-      return;
-    }
-    if (answer === "y" || answer === "yes") {
-      const source = join(packageSkillDir, skill.name);
-      const target = join(localSkillDir, skill.name);
-      cpSync(source, target, { recursive: true });
-      console.log(`  \u2713 ${skill.name} ${action}d`);
-    } else {
-      console.log(`  \u25CB ${skill.name} skipped`);
-    }
-  }
-  if (localNewer.length > 0) {
-    console.log(`
-` + "\u2500".repeat(60));
-    console.log(`
-You have skills that are more advanced than the package.`);
-    console.log(`Consider contributing them back to Thoth!
-`);
-    for (const skill of localNewer) {
-      const answer = await prompt(`Would you like to contribute ${skill.name} back to Thoth? [y/N] `);
-      if (answer === "y" || answer === "yes") {
-        console.log(`
-  To contribute ${skill.name}:`);
-        console.log(`  1. Fork https://github.com/davidhelmus/thoth-core`);
-        console.log(`  2. Copy your skill to defaults/skill/${skill.name}/`);
-        console.log(`  3. Open a Pull Request
-`);
-      }
-    }
-  }
-  console.log(`
-\u2713 Done!
-`);
-}
-function skillList(kbPath) {
-  const basePath = findKbPath(kbPath);
-  if (!basePath) {
-    console.log(`
-Showing skills from package only (no knowledge base found).
-`);
-  }
-  const packageSkillDir = join(NPM_DEFAULTS_PATH, "skill");
-  const localSkillDir = basePath ? join(basePath, ".opencode", "skill") : null;
-  const packageSkills = existsSync(packageSkillDir) ? readdirSync(packageSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
-  const localSkills = localSkillDir && existsSync(localSkillDir) ? readdirSync(localSkillDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
-  const allSkills = [...new Set([...packageSkills, ...localSkills])].sort();
-  console.log(`
-Available Skills:`);
-  console.log("\u2500".repeat(40));
-  for (const skill of allSkills) {
-    const inPackage = packageSkills.includes(skill);
-    const inLocal = localSkills.includes(skill);
-    let status = "";
-    if (inPackage && inLocal)
-      status = "\u2713";
-    else if (inLocal)
-      status = "\u25CB (local only)";
-    else
-      status = "+ (available)";
-    console.log(`  ${status} ${skill}`);
-  }
-  console.log(`
-`);
-}
-function showHelp() {
-  console.log(`
-Thoth - Life Orchestrator for OpenCode
-
-Usage:
-  npx thoth-plugin <command> [options]
-
-Commands:
-  init [path]           Create a new knowledge base (default: ~/thoth)
-  skill update [path]   Update skills from the latest package
-  skill list            List available skills
-
-Examples:
-  npx thoth-plugin init                # Create at ~/thoth
-  npx thoth-plugin init ~/my-thoth     # Create at custom path
-  npx thoth-plugin skill update        # Update skills in current KB
-  npx thoth-plugin skill list          # List all available skills
-
-Learn more: https://github.com/davidhelmus/thoth-core
-`);
 }
 var command = process.argv[2];
-var subcommand = process.argv[3];
-switch (command) {
-  case "init":
-    init(process.argv[3]);
-    break;
-  case "skill":
-    switch (subcommand) {
-      case "update":
-        skillUpdate(process.argv[4]);
-        break;
-      case "list":
-        skillList(process.argv[4]);
-        break;
-      default:
-        console.log(`
-Unknown skill command: ${subcommand}`);
-        console.log(`Available: skill update, skill list
-`);
-        process.exit(1);
-    }
-    break;
-  case "help":
-  case "--help":
-  case "-h":
-    showHelp();
-    break;
-  default:
-    showHelp();
-    if (command && command !== "help") {
-      console.log(`Unknown command: ${command}
-`);
-      process.exit(1);
-    }
+if (command === "init") {
+  init();
+} else {
+  console.log("Thoth - Life Orchestrator for OpenCode");
+  console.log("");
+  console.log("Commands:");
+  console.log("  thoth init [path]  Create knowledge base (default: ~/thoth)");
 }

package/dist/config/index.d.ts

@@ -1 +1 @@
-export { ThothPluginConfigSchema, type ThothPluginConfig, type AgentOverride, type HooksConfig, type SkillsConfig, type IntegrationsConfig, type HookName, type SkillName, type AgentName, } from "./schema";
+export { ThothPluginConfigSchema, type ThothPluginConfig, type AgentOverride, type HooksConfig, type SkillsConfig, type SentinelConfig, type IntegrationsConfig, type HookName, type SkillName, type AgentName, } from "./schema";

package/dist/config/schema.d.ts

@@ -32,9 +32,25 @@ declare const IntegrationsConfigSchema: z.ZodObject<{
     jira: z.ZodOptional<z.ZodBoolean>;
     drive_sync: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+declare const SentinelConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    poll_interval_ms: z.ZodOptional<z.ZodNumber>;
+    quiet_hours: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
 export declare const ThothPluginConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     knowledge_base: z.ZodOptional<z.ZodString>;
+    sentinel: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        poll_interval_ms: z.ZodOptional<z.ZodNumber>;
+        quiet_hours: z.ZodOptional<z.ZodObject<{
+            start: z.ZodString;
+            end: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>;
     agents: z.ZodOptional<z.ZodObject<{
         thoth: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -98,6 +114,7 @@ export type ThothPluginConfig = z.infer<typeof ThothPluginConfigSchema>;
 export type AgentOverride = z.infer<typeof AgentOverrideSchema>;
 export type HooksConfig = z.infer<typeof HooksConfigSchema>;
 export type SkillsConfig = z.infer<typeof SkillsConfigSchema>;
+export type SentinelConfig = z.infer<typeof SentinelConfigSchema>;
 export type IntegrationsConfig = z.infer<typeof IntegrationsConfigSchema>;
 export type HookName = keyof NonNullable<ThothPluginConfig["hooks"]>;
 export type SkillName = keyof NonNullable<ThothPluginConfig["skills"]>;

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

@@ -0,0 +1,16 @@
+---
+name: cal-grid
+description: Map Zeus's daily calendar grid using the Thoth standard protocol. Identifies deep work slots and critical preparation needs.
+---
+
+# Calendar Grid Skill
+
+You are the Daily Grid Architect for Zeus's Chief of Staff.
+
+## Protocol Execution
+
+1.  **Read Master Instructions**: Load the full protocol from `kernel/Agents/cal-grid.md`.
+2.  **Execute**: Follow the protocol exactly as defined in the master file.
+3.  **Synthesize**: Provide the high-resolution grid and the required raw data block.
+
+**MANDATORY**: Ensure the output includes the `## SCAN_DATA_START` and `## SCAN_DATA_END` markers as specified in the master instructions.