@wrongstack/plugins 0.275.0 → 0.276.2

package/dist/auto-doc.d.ts

@@ -4,8 +4,9 @@ import { Plugin } from '@wrongstack/core';
  * auto-doc plugin — Auto-generates JSDoc/TSDoc comments for source files.
  *
  * Tools registered:
- * - auto_doc: Generate and inject doc comments into JS/TS files
- * - auto_doc_preview: Preview doc comments without writing them
+ * - auto_doc: Generate and inject doc comments into JS/TS files.
+ *   Pass `dry_run: true` to preview without writing (replaces the former
+ *   `auto_doc (dry_run)` tool).
  */
 
 declare const plugin: Plugin;

package/dist/auto-doc.js

@@ -117,7 +117,7 @@ async function runAutoDoc(input, api) {
         modified = injectDocComment(modified, entity, doc);
         results.push({ file, entity: entity.name });
       }
-      if (!input.dryRun && results.length > 0) {
+      if (!input.dry_run && results.length > 0) {
         writeFileSync(file, modified, "utf-8");
         api.log.info(`auto-doc: updated ${file}`);
       }
@@ -127,31 +127,9 @@ async function runAutoDoc(input, api) {
   }
   return { ok: true, filesProcessed: input.files.length, changes: results };
 }
-async function runAutoDocPreview(input, api) {
-  if (!input.files || typeof input.files !== "object" || !Array.isArray(input.files)) {
-    return { ok: false, error: "input.files must be an array of file paths", previews: [] };
-  }
-  if (input.files.length === 0) {
-    return { ok: false, error: "input.files is empty \u2014 provide at least one file path", previews: [] };
-  }
-  const includeTypes = api.config.extensions?.["auto-doc"]?.["includeTypes"] ?? false;
-  const previews = [];
-  for (const file of input.files) {
-    try {
-      const { readFileSync } = await import('fs');
-      const content = readFileSync(file, "utf-8");
-      const entities = parseSource(content);
-      const generated = entities.filter((e) => needsDocComment(content, e)).map((e) => generateDocComment(e, includeTypes));
-      previews.push({ file, entities: generated });
-    } catch {
-      api.log.warn(`auto-doc-preview: could not read file ${file}`);
-    }
-  }
-  return { ok: true, previews };
-}
 var plugin = {
   name: "auto-doc",
-  version: "0.1.0",
+  version: "0.2.0",
   description: "Auto-generates JSDoc/TSDoc comments for functions, classes, types, and interfaces",
   apiVersion: AUTO_DOC_API_VERSION,
   capabilities: { tools: true, pipelines: ["toolCall"] },
@@ -167,41 +145,25 @@ var plugin = {
   setup(api) {
     api.tools.register({
       name: "auto_doc",
-      description: "Auto-generate JSDoc/TSDoc comments for functions, classes, types, and interfaces in source files",
+      description: "Auto-generate JSDoc/TSDoc comments for functions, classes, types, and interfaces in source files. Set `dry_run: true` to preview without writing.",
       inputSchema: {
         type: "object",
         properties: {
           files: { type: "array", items: { type: "string" }, description: "Source files to document" },
           style: { type: "string", enum: ["jsdoc", "tsdoc"], default: "tsdoc", description: "Comment style" },
           force: { type: "boolean", default: false, description: "Overwrite existing docstrings" },
-          dryRun: { type: "boolean", default: false, description: "Preview without writing" }
+          dry_run: { type: "boolean", default: false, description: "Preview generated comments without writing to files" }
         },
         required: ["files"]
       },
       permission: "auto",
       mutating: true,
+      category: "Project",
       async execute(input) {
         return runAutoDoc(input, api);
       }
     });
-    api.tools.register({
-      name: "auto_doc_preview",
-      description: "Preview what JSDoc/TSDoc comments would be generated for files, without writing",
-      inputSchema: {
-        type: "object",
-        properties: {
-          files: { type: "array", items: { type: "string" }, description: "Source files to preview" },
-          style: { type: "string", enum: ["jsdoc", "tsdoc"], default: "tsdoc" }
-        },
-        required: ["files"]
-      },
-      permission: "auto",
-      mutating: false,
-      async execute(input) {
-        return runAutoDocPreview(input, api);
-      }
-    });
-    api.log.info("auto-doc plugin loaded", { version: "0.1.0", capabilities: ["auto_doc", "auto_doc_preview"] });
+    api.log.info("auto-doc plugin loaded", { version: "0.2.0", capabilities: ["auto_doc"] });
   },
   teardown(api) {
     api.log.info("auto-doc plugin unloaded");

package/dist/cost-tracker.js

@@ -91,6 +91,7 @@ var plugin = {
       description: "Returns the current session's token usage breakdown by model, total cost estimate, and budget status.",
       inputSchema: { type: "object", properties: {} },
       permission: "auto",
+      category: "Meta",
       mutating: false,
       async execute() {
         const { budgetLimit, warningThreshold } = readCostTrackerConfig(

package/dist/cron.js

@@ -119,6 +119,7 @@ var plugin = {
         required: ["name", "intervalMs", "action"]
       },
       permission: "confirm",
+      category: "Session",
       mutating: false,
       capabilities: [COORDINATION_CRON_CAPABILITY],
       async execute(input) {

package/dist/file-watcher.js

@@ -3,9 +3,9 @@ import * as path from 'path';
 
 // src/file-watcher/index.ts
 var API_VERSION = "^0.1.10";
-var watchIdCounter = 0;
+var watch_idCounter = 0;
 function nextId() {
-  return `watch_${++watchIdCounter}_${Date.now().toString(36)}`;
+  return `watch_${++watch_idCounter}_${Date.now().toString(36)}`;
 }
 var watches = /* @__PURE__ */ new Map();
 var debounceTimers = /* @__PURE__ */ new Map();
@@ -90,7 +90,7 @@ var plugin = {
           const key = `${handle.id}:${fullPath}:${eventType}`;
           debounceEvent(key, () => {
             api.emitCustom("file-watcher:changed", {
-              watchId: handle.id,
+              watch_id: handle.id,
               path: fullPath,
               event: eventType,
               filename,
@@ -151,15 +151,16 @@ var plugin = {
         required: ["paths"]
       },
       permission: "confirm",
+      category: "Filesystem",
       mutating: false,
       async execute(input) {
         const rawPaths = input["paths"];
         if (!rawPaths || typeof rawPaths !== "object" || !Array.isArray(rawPaths)) {
-          return { ok: false, error: "paths must be an array of file/directory paths", watchId: null };
+          return { ok: false, error: "paths must be an array of file/directory paths", watch_id: null };
         }
         const paths = rawPaths;
         if (paths.length === 0) {
-          return { ok: false, error: "paths array is empty \u2014 provide at least one path", watchId: null };
+          return { ok: false, error: "paths array is empty \u2014 provide at least one path", watch_id: null };
         }
         const events = input["events"] ?? ["change", "add", "delete"];
         const recursive = input["recursive"] ?? true;
@@ -179,7 +180,7 @@ var plugin = {
         api.metrics.gauge("active_watches", watches.size);
         return {
           ok: true,
-          watchId: id,
+          watch_id: id,
           paths,
           events,
           recursive,
@@ -193,17 +194,17 @@ var plugin = {
       inputSchema: {
         type: "object",
         properties: {
-          watchId: { type: "string", description: "Watch ID returned by watch_start" }
+          watch_id: { type: "string", description: "Watch ID returned by watch_start" }
         },
-        required: ["watchId"]
+        required: ["watch_id"]
       },
       permission: "auto",
       mutating: false,
       async execute(input) {
-        const watchId = input["watchId"];
-        const handle = watches.get(watchId);
+        const watch_id = input["watch_id"];
+        const handle = watches.get(watch_id);
         if (!handle) {
-          return { ok: false, error: `No active watch with ID: ${watchId}` };
+          return { ok: false, error: `No active watch with ID: ${watch_id}` };
         }
         for (const w of handle.watchers) {
           try {
@@ -211,12 +212,12 @@ var plugin = {
           } catch {
           }
         }
-        watches.delete(watchId);
+        watches.delete(watch_id);
         api.metrics.gauge("active_watches", watches.size);
         return {
           ok: true,
-          watchId,
-          message: `Stopped watch ${watchId}. ${watches.size} watch(es) remaining.`
+          watch_id,
+          message: `Stopped watch ${watch_id}. ${watches.size} watch(es) remaining.`
         };
       }
     });

package/dist/git-autocommit.d.ts

@@ -4,9 +4,12 @@ import { Plugin } from '@wrongstack/core';
  * git-autocommit plugin — AI-powered git staging and commit message generation.
  *
  * Tools registered:
- * - git_autocommit: Generate and create a commit with AI-written messages
- * - git_stage: Stage specific files for commit
- * - git_status_summary: Show a summary of current git status
+ * - git_autocommit: Stage files and create a commit with AI-written conventional commit messages.
+ *   Supports `files` for specific staging and `dry_run` for preview.
+ *
+ * Note: The former `git_autocommit` and `git_autocommit` tools have been removed.
+ * - For staging: use `git_autocommit` with `files` (it stages automatically), or `bash` with `git add`.
+ * - For status: use the built-in `git` tool with `command: "status"` or `command: "diff"`.
  */
 
 declare const plugin: Plugin;

package/dist/git-autocommit.js

@@ -42,19 +42,6 @@ function stageFiles(files, cwd) {
 function commitWithMessage(message, cwd) {
   return runGit(["commit", "-m", message], cwd);
 }
-function getCommitHistory(since, cwd) {
-  const range = `${since}..HEAD` ;
-  const output = runGit(["log", range, "--format=%H %s"], cwd);
-  if (!output) return [];
-  return output.split("\n").filter(Boolean).map((line) => {
-    const spaceIdx = line.indexOf(" ");
-    const hash = line.slice(0, spaceIdx);
-    const message = line.slice(spaceIdx + 1);
-    const typeMatch = message.match(/^(\w+)(!)?:\s/);
-    const type = typeMatch?.[1] ?? "chore";
-    return { hash, message, type };
-  });
-}
 function getWorktrees(cwd) {
   try {
     const out = runGit(["worktree", "list", "--porcelain"], cwd);
@@ -118,7 +105,7 @@ ${body}` : "";
 }
 var plugin = {
   name: "git-autocommit",
-  version: "0.1.0",
+  version: "0.2.0",
   description: "AI-powered git staging and conventional commit message generation",
   apiVersion: API_VERSION,
   capabilities: { tools: true },
@@ -161,10 +148,11 @@ var plugin = {
           scope: { type: "string", description: "Commit scope (e.g. auth, api, ui)" },
           message: { type: "string", description: "Commit summary message" },
           body: { type: "string", description: "Optional commit body/description" },
-          dryRun: { type: "boolean", default: false, description: "Show what would be committed without committing" }
+          dry_run: { type: "boolean", default: false, description: "Show what would be committed without committing" }
         }
       },
       permission: "confirm",
+      category: "Git",
       mutating: true,
       async execute(input, _ctx) {
         try {
@@ -172,13 +160,13 @@ var plugin = {
           const scope = input["scope"];
           const summary = input["message"] ?? "";
           const body = input["body"];
-          const dryRun = input["dryRun"] ?? false;
+          const dryRun = input["dry_run"] ?? false;
           const validTypes = ["feat", "fix", "docs", "style", "refactor", "test", "chore", "perf", "ci", "build", "revert"];
           if (!type || !validTypes.includes(type)) {
             if (dryRun) {
               return {
                 ok: true,
-                dryRun: true,
+                dry_run: true,
                 message: `Would create: ${summary || "update code"}`
               };
             }
@@ -239,7 +227,7 @@ var plugin = {
           if (dryRun) {
             return {
               ok: true,
-              dryRun: true,
+              dry_run: true,
               message: `Would create: ${msg}`,
               warning: warning ?? void 0,
               stagedDiff: `
@@ -301,126 +289,8 @@ ${preCommitDiff}
         }
       }
     });
-    api.tools.register({
-      name: "git_stage",
-      description: "Stage specific files for commit. Shows what would be staged without staging if dryRun is true.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          files: { type: "array", items: { type: "string" }, description: "Files to stage" },
-          dryRun: { type: "boolean", default: false }
-        },
-        required: ["files"]
-      },
-      permission: "confirm",
-      mutating: true,
-      async execute(input) {
-        try {
-          let files;
-          try {
-            files = input["files"] ?? [];
-          } catch {
-            files = [];
-          }
-          const dryRun = input["dryRun"] ?? false;
-          if (!Array.isArray(files) || files.length === 0) {
-            return { ok: false, error: "files must be a non-empty array of file paths" };
-          }
-          if (dryRun) {
-            return { ok: true, dryRun: true, files, message: `Would stage: ${files.join(", ")}` };
-          }
-          try {
-            stageFiles(files);
-          } catch (err) {
-            return { ok: false, error: `Failed to stage files: ${err instanceof Error ? err.message : String(err)}` };
-          }
-          let stillChanged = [];
-          try {
-            stillChanged = getChangedFiles();
-          } catch {
-            stillChanged = [];
-          }
-          return {
-            ok: true,
-            staged: files,
-            stillChanged,
-            message: `Staged ${files.length} file(s). ${stillChanged.length} file(s) still changed.`
-          };
-        } catch (err) {
-          return { ok: false, error: `git_stage error: ${err instanceof Error ? err.message : String(err)}` };
-        }
-      }
-    });
-    api.tools.register({
-      name: "git_status_summary",
-      description: "Returns a summary of the current git repository status: changed files, staged files, current branch, and recent commits.",
-      inputSchema: { type: "object", properties: {} },
-      permission: "auto",
-      mutating: false,
-      async execute() {
-        let branch = "";
-        let changed = [];
-        let staged = [];
-        let aheadBehind = "";
-        const recentCommits = [];
-        let worktrees = [];
-        let worktreeWarn = null;
-        let externalChanges = null;
-        try {
-          branch = runGit(["branch", "--show-current"]);
-        } catch {
-        }
-        try {
-          changed = getChangedFiles();
-        } catch {
-        }
-        try {
-          staged = getStagedFiles();
-        } catch {
-        }
-        try {
-          aheadBehind = runGit(["status", "-sb"]).split("\n")[0] ?? "";
-        } catch {
-        }
-        try {
-          recentCommits.push(...getCommitHistory("-3", void 0).map((c) => ({ hash: (c.hash ?? "").slice(0, 7), message: c.message })));
-        } catch {
-        }
-        try {
-          worktrees = getWorktrees();
-        } catch {
-        }
-        try {
-          worktreeWarn = simultaneousEditWarning();
-        } catch {
-        }
-        try {
-          const out = runGit(["status", "--porcelain"]);
-          const unstaged = out.split("\n").filter((l) => {
-            const idx = l[0] ?? " ";
-            return idx === " " || idx === "?";
-          }).map((l) => l.slice(3).trim()).filter(Boolean);
-          externalChanges = unstaged.length > 0 ? unstaged : null;
-        } catch {
-        }
-        return {
-          ok: true,
-          branch,
-          changedFiles: changed,
-          stagedFiles: staged,
-          aheadBehind,
-          recentCommits,
-          worktrees: worktrees.length > 0 ? worktrees.map((w) => ({
-            path: w.path,
-            branch: w.branch.replace("refs/heads/", "")
-          })) : [],
-          worktreeWarning: worktreeWarn ?? void 0,
-          externalChanges: externalChanges ?? void 0
-        };
-      }
-    });
     api.log.info("git-autocommit plugin loaded", {
-      version: "0.1.0",
+      version: "0.2.0",
       conventionalCommits: opts.conventionalCommits
     });
   }