thoth-plugin 1.1.2 → 1.2.0

package/dist/config/schema.d.ts

@@ -13,6 +13,8 @@ declare const HooksConfigSchema: z.ZodObject<{
     "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
     "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
     "frontmatter-enforcer": z.ZodOptional<z.ZodBoolean>;
+    "read-confirmation": z.ZodOptional<z.ZodBoolean>;
+    "write-confirmation": z.ZodOptional<z.ZodBoolean>;
     "todo-continuation": z.ZodOptional<z.ZodBoolean>;
     "session-recovery": z.ZodOptional<z.ZodBoolean>;
     "context-window-monitor": z.ZodOptional<z.ZodBoolean>;
@@ -67,6 +69,8 @@ export declare const ThothPluginConfigSchema: z.ZodObject<{
         "knowledge-persistence": z.ZodOptional<z.ZodBoolean>;
         "directory-agents-injector": z.ZodOptional<z.ZodBoolean>;
         "frontmatter-enforcer": z.ZodOptional<z.ZodBoolean>;
+        "read-confirmation": z.ZodOptional<z.ZodBoolean>;
+        "write-confirmation": z.ZodOptional<z.ZodBoolean>;
         "todo-continuation": z.ZodOptional<z.ZodBoolean>;
         "session-recovery": z.ZodOptional<z.ZodBoolean>;
         "context-window-monitor": z.ZodOptional<z.ZodBoolean>;

package/dist/hooks/index.d.ts

@@ -3,3 +3,5 @@ export { createTrustLevelTrackerHook, type TrustLevelTrackerHook, type TrustLeve
 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/hooks/read-confirmation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Read Confirmation Hook
+ *
+ * After file reads, injects a confirmation message into the conversation.
+ * This creates an audit trail and prevents hallucination about what was read.
+ *
+ * Value:
+ * - Prevents "I read file X" when it wasn't actually read
+ * - Creates audit trail of file access
+ * - Helps with context management
+ */
+export interface ReadConfirmationConfig {
+    knowledgeBasePath: string;
+    enabled?: boolean;
+    /** Only confirm reads within the knowledge base (default: true) */
+    kbOnly?: boolean;
+}
+export declare function createReadConfirmationHook(config: ReadConfirmationConfig): {
+    "tool.execute.before": (input: {
+        tool: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+} | null;
+export type ReadConfirmationHook = ReturnType<typeof createReadConfirmationHook>;

package/dist/hooks/write-confirmation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Write Confirmation Hook
+ *
+ * After file writes/edits, injects a confirmation message with reminders.
+ * This creates an audit trail and reinforces the Smart Merge protocol.
+ *
+ * Value:
+ * - Reminds about _index.md updates for new files
+ * - Creates audit trail of file modifications
+ * - Reinforces Smart Merge protocol
+ */
+export interface WriteConfirmationConfig {
+    knowledgeBasePath: string;
+    enabled?: boolean;
+    /** Only confirm writes within the knowledge base (default: true) */
+    kbOnly?: boolean;
+}
+export declare function createWriteConfirmationHook(config: WriteConfirmationConfig): {
+    "tool.execute.before": (input: {
+        tool: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    "tool.execute.after": (input: {
+        tool: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+} | null;
+export type WriteConfirmationHook = ReturnType<typeof createWriteConfirmationHook>;

package/dist/index.js

@@ -3554,6 +3554,91 @@ function createFrontmatterEnforcerHook(config) {
     }
   };
 }
+// src/hooks/read-confirmation.ts
+import * as path6 from "path";
+function createReadConfirmationHook(config) {
+  const { knowledgeBasePath, enabled = true, kbOnly = true } = config;
+  if (!enabled) {
+    return null;
+  }
+  const kbPath = expandPath(knowledgeBasePath);
+  const tracker = {
+    pendingReadPaths: new Map
+  };
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (input.tool !== "read")
+        return;
+      const filePath = output.args?.filePath;
+      if (filePath && input.callID) {
+        tracker.pendingReadPaths.set(input.callID, filePath);
+      }
+    },
+    "tool.execute.after": async (input, output) => {
+      if (input.tool !== "read")
+        return;
+      const filePath = tracker.pendingReadPaths.get(input.callID);
+      tracker.pendingReadPaths.delete(input.callID);
+      if (!filePath)
+        return;
+      if (kbOnly && !filePath.startsWith(kbPath)) {
+        return;
+      }
+      const lineCount = output.output?.split(`
+`).length || 0;
+      const relativePath = filePath.startsWith(kbPath) ? filePath.slice(kbPath.length + 1) : path6.basename(filePath);
+      log(`[Read confirmed: ${relativePath} (${lineCount} lines)]`);
+    }
+  };
+}
+// src/hooks/write-confirmation.ts
+import * as path7 from "path";
+function createWriteConfirmationHook(config) {
+  const { knowledgeBasePath, enabled = true, kbOnly = true } = config;
+  if (!enabled) {
+    return null;
+  }
+  const kbPath = expandPath(knowledgeBasePath);
+  const tracker = {
+    pendingWritePaths: new Map
+  };
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (input.tool !== "write" && input.tool !== "edit")
+        return;
+      const filePath = output.args?.filePath;
+      if (filePath && input.callID) {
+        tracker.pendingWritePaths.set(input.callID, {
+          filePath,
+          action: input.tool
+        });
+      }
+    },
+    "tool.execute.after": async (input, output) => {
+      if (input.tool !== "write" && input.tool !== "edit")
+        return;
+      const pending = tracker.pendingWritePaths.get(input.callID);
+      tracker.pendingWritePaths.delete(input.callID);
+      if (!pending)
+        return;
+      const { filePath, action } = pending;
+      if (kbOnly && !filePath.startsWith(kbPath)) {
+        return;
+      }
+      const relativePath = filePath.startsWith(kbPath) ? filePath.slice(kbPath.length + 1) : path7.basename(filePath);
+      const actionLabel = action === "write" ? "Created/Overwrote" : "Edited";
+      const isNewFile = action === "write";
+      const isMarkdownFile = filePath.endsWith(".md");
+      const isIndexFile = relativePath.includes("_index.md") || relativePath.includes("registry.md");
+      let message = `[${actionLabel}: ${relativePath}]`;
+      if (isNewFile && isMarkdownFile && !isIndexFile) {
+        message += `
+Reminder: Update _index.md if this is a new file. Check bidirectional links.`;
+      }
+      log(message);
+    }
+  };
+}
 // src/hooks/directory-agents-injector/index.ts
 import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import { dirname as dirname4, join as join9, resolve as resolve2 } from "path";
@@ -3678,8 +3763,8 @@ function createDirectoryAgentsInjectorHook(options) {
     }
     if (toInject.length === 0)
       return;
-    for (const { path: path6, content } of toInject) {
-      const relativePath = path6.replace(knowledgeBasePath, "").replace(/^\//, "");
+    for (const { path: path8, content } of toInject) {
+      const relativePath = path8.replace(knowledgeBasePath, "").replace(/^\//, "");
       output.output += `
 
 [Directory Context: ${relativePath}]
@@ -3766,8 +3851,8 @@ function findNearestMessageWithFields(messageDir) {
 // src/shared-hooks/utils/logger.ts
 import * as fs2 from "fs";
 import * as os2 from "os";
-import * as path6 from "path";
-var logFile = path6.join(os2.tmpdir(), "thoth-plugin.log");
+import * as path8 from "path";
+var logFile = path8.join(os2.tmpdir(), "thoth-plugin.log");
 function log2(message, data) {
   try {
     const timestamp = new Date().toISOString();
@@ -5567,10 +5652,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -5929,11 +6014,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path9, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -6101,7 +6186,7 @@ function treeifyError(error, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error2, path7 = []) => {
+  const processError = (error2, path9 = []) => {
     var _a, _b;
     for (const issue2 of error2.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -6111,7 +6196,7 @@ function treeifyError(error, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path7, ...issue2.path];
+        const fullpath = [...path9, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -6143,8 +6228,8 @@ function treeifyError(error, _mapper) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -17435,7 +17520,7 @@ Status: ${task.status}`;
 // src/tools/skill/tools.ts
 import { existsSync as existsSync11, readdirSync as readdirSync6, readFileSync as readFileSync9, lstatSync, readlinkSync } from "fs";
 import { homedir as homedir5 } from "os";
-import { join as join17, basename as basename3, resolve as resolve3, dirname as dirname5 } from "path";
+import { join as join17, basename as basename5, resolve as resolve3, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __filename3 = fileURLToPath2(import.meta.url);
 var __dirname3 = dirname5(__filename3);
@@ -17585,7 +17670,7 @@ async function parseSkillMd(skillPath) {
     const { data, body } = parseFrontmatter(content);
     const frontmatter = parseSkillFrontmatter(data);
     const metadata = {
-      name: frontmatter.name || basename3(skillPath),
+      name: frontmatter.name || basename5(skillPath),
       description: frontmatter.description,
       license: frontmatter.license,
       allowedTools: frontmatter["allowed-tools"],
@@ -18524,10 +18609,10 @@ function mergeDefs2(...defs) {
 function cloneDef2(schema) {
   return mergeDefs2(schema._zod.def);
 }
-function getElementAtPath2(obj, path7) {
-  if (!path7)
+function getElementAtPath2(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject2(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -18908,11 +18993,11 @@ function aborted2(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues2(path7, issues) {
+function prefixIssues2(path9, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -19095,7 +19180,7 @@ function formatError2(error45, mapper = (issue3) => issue3.message) {
 }
 function treeifyError2(error45, mapper = (issue3) => issue3.message) {
   const result = { errors: [] };
-  const processError = (error46, path7 = []) => {
+  const processError = (error46, path9 = []) => {
     var _a, _b;
     for (const issue3 of error46.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -19105,7 +19190,7 @@ function treeifyError2(error45, mapper = (issue3) => issue3.message) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path7, ...issue3.path];
+        const fullpath = [...path9, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -19137,8 +19222,8 @@ function treeifyError2(error45, mapper = (issue3) => issue3.message) {
 }
 function toDotPath2(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -30885,13 +30970,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path7 = ref.slice(1).split("/").filter(Boolean);
-  if (path7.length === 0) {
+  const path9 = ref.slice(1).split("/").filter(Boolean);
+  if (path9.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path7[0] === defsKey) {
-    const key = path7[1];
+  if (path9[0] === defsKey) {
+    const key = path9[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -31306,6 +31391,8 @@ var HooksConfigSchema = exports_external2.object({
   "knowledge-persistence": exports_external2.boolean().optional(),
   "directory-agents-injector": exports_external2.boolean().optional(),
   "frontmatter-enforcer": exports_external2.boolean().optional(),
+  "read-confirmation": exports_external2.boolean().optional(),
+  "write-confirmation": exports_external2.boolean().optional(),
   "todo-continuation": exports_external2.boolean().optional(),
   "session-recovery": exports_external2.boolean().optional(),
   "context-window-monitor": exports_external2.boolean().optional(),
@@ -31343,7 +31430,7 @@ var ThothPluginConfigSchema = exports_external2.object({
 }).strict();
 // src/index.ts
 import * as fs3 from "fs";
-import * as path7 from "path";
+import * as path9 from "path";
 var sessionSpecializations = new Map;
 function loadConfigFromPath(configPath) {
   try {
@@ -31375,8 +31462,8 @@ function mergeConfigs(base, override) {
   };
 }
 function loadPluginConfig(directory) {
-  const userConfigPath = path7.join(getUserConfigDir(), "opencode", "thoth-plugin.json");
-  const projectConfigPath = path7.join(directory, ".opencode", "thoth-plugin.json");
+  const userConfigPath = path9.join(getUserConfigDir(), "opencode", "thoth-plugin.json");
+  const projectConfigPath = path9.join(directory, ".opencode", "thoth-plugin.json");
   let config3 = loadConfigFromPath(userConfigPath) ?? {};
   const projectConfig = loadConfigFromPath(projectConfigPath);
   if (projectConfig) {
@@ -31390,15 +31477,15 @@ function resolveKnowledgeBasePath(config3, directory) {
     return expandPath(config3.knowledge_base);
   }
   const commonLocations = [
-    path7.join(process.env.HOME || "", "Repos", "thoth"),
-    path7.join(process.env.HOME || "", "repos", "thoth"),
-    path7.join(process.env.HOME || "", "Projects", "thoth"),
-    path7.join(process.env.HOME || "", "projects", "thoth"),
-    path7.join(process.env.HOME || "", "thoth"),
-    path7.join(directory, "thoth")
+    path9.join(process.env.HOME || "", "Repos", "thoth"),
+    path9.join(process.env.HOME || "", "repos", "thoth"),
+    path9.join(process.env.HOME || "", "Projects", "thoth"),
+    path9.join(process.env.HOME || "", "projects", "thoth"),
+    path9.join(process.env.HOME || "", "thoth"),
+    path9.join(directory, "thoth")
   ];
   for (const location of commonLocations) {
-    const kernelPath = path7.join(location, "kernel");
+    const kernelPath = path9.join(location, "kernel");
     if (fs3.existsSync(kernelPath)) {
       log(`Found knowledge base at: ${location}`);
       return location;
@@ -31420,6 +31507,8 @@ var ThothPlugin = async (ctx) => {
   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;
   const todoContinuationEnforcer = hooksConfig["todo-continuation"] !== false ? createTodoContinuationEnforcer(ctx) : null;
   const sessionRecoveryHook = hooksConfig["session-recovery"] !== false ? createSessionRecoveryHook(ctx, { experimental: { auto_resume: true } }) : null;
   const contextWindowMonitor = hooksConfig["context-window-monitor"] !== false ? createContextWindowMonitorHook(ctx) : null;
@@ -31525,11 +31614,15 @@ var ThothPlugin = async (ctx) => {
       await contextAperture?.["tool.execute.before"]?.(input, output);
       await trustLevelTracker?.["tool.execute.before"]?.(input, output);
       await frontmatterEnforcer?.["tool.execute.before"]?.(input, output);
+      await readConfirmation?.["tool.execute.before"]?.(input, output);
+      await writeConfirmation?.["tool.execute.before"]?.(input, output);
     },
     "tool.execute.after": async (input, output) => {
       await trustLevelTracker?.["tool.execute.after"]?.(input, output);
       await contextAperture?.["tool.execute.after"]?.(input, output);
       await frontmatterEnforcer?.["tool.execute.after"]?.(input, output);
+      await readConfirmation?.["tool.execute.after"]?.(input, output);
+      await writeConfirmation?.["tool.execute.after"]?.(input, output);
       await directoryAgentsInjector?.["tool.execute.after"]?.(input, output);
       await contextWindowMonitor?.["tool.execute.after"]?.(input, output);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-plugin",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Thoth - Root-level life orchestrator for OpenCode. Unified AI chief of staff combining Sisyphus execution quality, Personal-OS rhythms, and Thoth relationship model.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",