@wrongstack/plugins 0.260.0 → 0.265.1

package/dist/auto-doc.js

@@ -50,32 +50,7 @@ function parseSource(content) {
   }
   return entities;
 }
-function generateJSDoc(entity, includeTypes) {
-  switch (entity.kind) {
-    case "function": {
-      const params = entity.params.map((p) => `   * @param ${p} - TODO: describe parameter`).join("\n");
-      const returns = entity.returnType ? `
-   * @returns ${includeTypes ? `{${entity.returnType}} ` : ""}TODO: describe return value` : "";
-      return `/**
-   * TODO: One-line description of ${entity.name}
-${params}${returns}
-   */`;
-    }
-    case "class":
-      return `/**
-   * TODO: Describe class ${entity.name}
-   */`;
-    case "type":
-      return `/**
-   * TODO: Describe type ${entity.name}
-   */`;
-    case "interface":
-      return `/**
-   * TODO: Describe interface ${entity.name}
-   */`;
-  }
-}
-function generateTSDoc(entity, includeTypes) {
+function generateDocComment(entity, includeTypes) {
   switch (entity.kind) {
     case "function": {
       const params = entity.params.map((p) => `   * @param ${p} - TODO: describe parameter`).join("\n");
@@ -112,7 +87,7 @@ function injectDocComment(content, entity, doc) {
   const idx = entity.startLine - 1;
   const codeLine = lines[idx] ?? "";
   const indent = codeLine.match(/^(\s*)/)?.[1] ?? "";
-  lines.splice(idx, 0, `${indent}${doc} ${codeLine.trim()}`);
+  lines.splice(idx, 0, `${indent}${doc}`);
   return lines.join("\n");
 }
 async function runAutoDoc(input, api) {
@@ -122,7 +97,6 @@ async function runAutoDoc(input, api) {
   if (input.files.length === 0) {
     return { ok: false, error: "input.files is empty \u2014 provide at least one file path", filesProcessed: 0, changes: [] };
   }
-  const style = input.style ?? "tsdoc";
   const includeTypes = api.config.extensions?.["auto-doc"]?.["includeTypes"] ?? false;
   const results = [];
   for (const file of input.files) {
@@ -139,7 +113,7 @@ async function runAutoDoc(input, api) {
       let modified = content;
       for (const entity of entities) {
         if (!input.force && !needsDocComment(modified, entity)) continue;
-        const doc = style === "jsdoc" ? generateJSDoc(entity, includeTypes) : generateTSDoc(entity, includeTypes);
+        const doc = generateDocComment(entity, includeTypes);
         modified = injectDocComment(modified, entity, doc);
         results.push({ file, entity: entity.name });
       }
@@ -160,7 +134,6 @@ async function runAutoDocPreview(input, api) {
   if (input.files.length === 0) {
     return { ok: false, error: "input.files is empty \u2014 provide at least one file path", previews: [] };
   }
-  const style = input.style ?? "tsdoc";
   const includeTypes = api.config.extensions?.["auto-doc"]?.["includeTypes"] ?? false;
   const previews = [];
   for (const file of input.files) {
@@ -168,7 +141,7 @@ async function runAutoDocPreview(input, api) {
       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) => style === "jsdoc" ? generateJSDoc(e, includeTypes) : generateTSDoc(e, includeTypes));
+      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}`);

package/dist/cost-tracker.js

@@ -164,9 +164,10 @@ var plugin = {
         const includeModel = input["includeModel"] ?? true;
         if (format === "csv") {
           const header = includeModel ? "model,timestamp,prompt_tokens,completion_tokens,total_tokens,cost_usd" : "timestamp,prompt_tokens,completion_tokens,total_tokens,cost_usd";
-          const rows = sessionCost.requests.map(
-            (r) => includeModel ? `${r.model},${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${r.costUsd ?? 0}` : `${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${r.costUsd ?? 0}`
-          );
+          const rows = sessionCost.requests.map((r) => {
+            const cost = r.costUsd ?? 0;
+            return includeModel ? `${r.model},${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${cost}` : `${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${cost}`;
+          });
           return {
             ok: true,
             format: "csv",

package/dist/git-autocommit.js

@@ -136,11 +136,11 @@ var plugin = {
     }
   },
   setup(api) {
-    const cwd = api.config.extensions?.["git-autocommit"];
+    const extConfig = api.config.extensions?.["git-autocommit"];
     const opts = {
-      conventionalCommits: cwd?.["conventionalCommits"] ?? true,
-      autoStage: cwd?.["autoStage"] ?? false,
-      defaultType: cwd?.["defaultType"] ?? "feat"
+      conventionalCommits: extConfig?.["conventionalCommits"] ?? true,
+      autoStage: extConfig?.["autoStage"] ?? false,
+      defaultType: extConfig?.["defaultType"] ?? "feat"
     };
     api.tools.register({
       name: "git_autocommit",
@@ -273,6 +273,7 @@ ${stagedDiff}
               hash: String(hash),
               commitType: type,
               scope: String(scope ?? ""),
+              /* v8 ignore next -- staged is always an array here; the : [] fallback is defensive. */
               files: Array.isArray(staged) ? staged : [],
               warning: warning ?? null
             });

package/dist/index.js

@@ -5,6 +5,7 @@ import { isAbsolute, join } from 'path';
 import { expectDefined, deepMerge as deepMerge$1, isPrivateIPv4, isPrivateIPv6 } from '@wrongstack/core';
 import { lookup } from 'dns/promises';
 import { isIPv4, isIPv6 } from 'net';
+import { toErrorMessage } from '@wrongstack/core/utils';
 
 // src/auto-doc/index.ts
 var AUTO_DOC_API_VERSION = "^0.1.10";
@@ -58,32 +59,7 @@ function parseSource(content) {
   }
   return entities;
 }
-function generateJSDoc(entity, includeTypes) {
-  switch (entity.kind) {
-    case "function": {
-      const params = entity.params.map((p) => `   * @param ${p} - TODO: describe parameter`).join("\n");
-      const returns = entity.returnType ? `
-   * @returns ${includeTypes ? `{${entity.returnType}} ` : ""}TODO: describe return value` : "";
-      return `/**
-   * TODO: One-line description of ${entity.name}
-${params}${returns}
-   */`;
-    }
-    case "class":
-      return `/**
-   * TODO: Describe class ${entity.name}
-   */`;
-    case "type":
-      return `/**
-   * TODO: Describe type ${entity.name}
-   */`;
-    case "interface":
-      return `/**
-   * TODO: Describe interface ${entity.name}
-   */`;
-  }
-}
-function generateTSDoc(entity, includeTypes) {
+function generateDocComment(entity, includeTypes) {
   switch (entity.kind) {
     case "function": {
       const params = entity.params.map((p) => `   * @param ${p} - TODO: describe parameter`).join("\n");
@@ -120,7 +96,7 @@ function injectDocComment(content, entity, doc) {
   const idx = entity.startLine - 1;
   const codeLine = lines[idx] ?? "";
   const indent = codeLine.match(/^(\s*)/)?.[1] ?? "";
-  lines.splice(idx, 0, `${indent}${doc} ${codeLine.trim()}`);
+  lines.splice(idx, 0, `${indent}${doc}`);
   return lines.join("\n");
 }
 async function runAutoDoc(input, api) {
@@ -130,7 +106,6 @@ async function runAutoDoc(input, api) {
   if (input.files.length === 0) {
     return { ok: false, error: "input.files is empty \u2014 provide at least one file path", filesProcessed: 0, changes: [] };
   }
-  const style = input.style ?? "tsdoc";
   const includeTypes = api.config.extensions?.["auto-doc"]?.["includeTypes"] ?? false;
   const results = [];
   for (const file of input.files) {
@@ -147,7 +122,7 @@ async function runAutoDoc(input, api) {
       let modified = content;
       for (const entity of entities) {
         if (!input.force && !needsDocComment(modified, entity)) continue;
-        const doc = style === "jsdoc" ? generateJSDoc(entity, includeTypes) : generateTSDoc(entity, includeTypes);
+        const doc = generateDocComment(entity, includeTypes);
         modified = injectDocComment(modified, entity, doc);
         results.push({ file, entity: entity.name });
       }
@@ -168,7 +143,6 @@ async function runAutoDocPreview(input, api) {
   if (input.files.length === 0) {
     return { ok: false, error: "input.files is empty \u2014 provide at least one file path", previews: [] };
   }
-  const style = input.style ?? "tsdoc";
   const includeTypes = api.config.extensions?.["auto-doc"]?.["includeTypes"] ?? false;
   const previews = [];
   for (const file of input.files) {
@@ -176,7 +150,7 @@ async function runAutoDocPreview(input, api) {
       const { readFileSync: readFileSync2 } = await import('fs');
       const content = readFileSync2(file, "utf-8");
       const entities = parseSource(content);
-      const generated = entities.filter((e) => !needsDocComment(content, e)).map((e) => style === "jsdoc" ? generateJSDoc(e, includeTypes) : generateTSDoc(e, includeTypes));
+      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}`);
@@ -377,11 +351,11 @@ var plugin2 = {
     }
   },
   setup(api) {
-    const cwd = api.config.extensions?.["git-autocommit"];
+    const extConfig = api.config.extensions?.["git-autocommit"];
     const opts = {
-      conventionalCommits: cwd?.["conventionalCommits"] ?? true,
-      autoStage: cwd?.["autoStage"] ?? false,
-      defaultType: cwd?.["defaultType"] ?? "feat"
+      conventionalCommits: extConfig?.["conventionalCommits"] ?? true,
+      autoStage: extConfig?.["autoStage"] ?? false,
+      defaultType: extConfig?.["defaultType"] ?? "feat"
     };
     api.tools.register({
       name: "git_autocommit",
@@ -514,6 +488,7 @@ ${stagedDiff}
               hash: String(hash),
               commitType: type,
               scope: String(scope ?? ""),
+              /* v8 ignore next -- staged is always an array here; the : [] fallback is defensive. */
               files: Array.isArray(staged) ? staged : [],
               warning: warning ?? null
             });
@@ -681,13 +656,8 @@ function runShellCheck(files, severity, cwd) {
     info: "info",
     style: "style"
   };
-  const args = [
-    "-f",
-    "json",
-    "-S",
-    levelMap[severity] ?? "warning",
-    ...files
-  ];
+  const severityFlag = levelMap[severity] ?? "warning";
+  const args = ["-f", "json", "-S", severityFlag, ...files];
   let raw;
   try {
     raw = execFileSync("shellcheck", args, {
@@ -1054,9 +1024,10 @@ var plugin4 = {
         const includeModel = input["includeModel"] ?? true;
         if (format === "csv") {
           const header = includeModel ? "model,timestamp,prompt_tokens,completion_tokens,total_tokens,cost_usd" : "timestamp,prompt_tokens,completion_tokens,total_tokens,cost_usd";
-          const rows = sessionCost.requests.map(
-            (r) => includeModel ? `${r.model},${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${r.costUsd ?? 0}` : `${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${r.costUsd ?? 0}`
-          );
+          const rows = sessionCost.requests.map((r) => {
+            const cost = r.costUsd ?? 0;
+            return includeModel ? `${r.model},${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${cost}` : `${r.timestamp},${r.promptTokens},${r.completionTokens},${r.totalTokens},${cost}`;
+          });
           return {
             ok: true,
             format: "csv",
@@ -1550,7 +1521,8 @@ var plugin6 = {
         }
         const deduplicated = [];
         for (const r of rawResults) {
-          const normalized = (r.url.split("?")[0] ?? r.url).split("#")[0] ?? r.url;
+          const noQuery = r.url.split("?")[0] ?? r.url;
+          const normalized = noQuery.split("#")[0] ?? r.url;
           if (!seenUrls.has(normalized) && r.url.startsWith("http")) {
             seenUrls.add(normalized);
             deduplicated.push(r);
@@ -1675,6 +1647,7 @@ function jmespathSearch(data, query) {
           return Number(itemVal) >= Number(cmpVal);
         case "<=":
           return Number(itemVal) <= Number(cmpVal);
+        /* v8 ignore next -- op is constrained to the six operators by the filter regex; default is unreachable. */
         default:
           return true;
       }
@@ -1701,6 +1674,7 @@ function jmespathSearch(data, query) {
         if (data === null) return "null";
         if (Array.isArray(data)) return "array";
         return typeof data;
+      /* v8 ignore next 2 -- fn is constrained to the four names by the function regex; default is unreachable. */
       default:
         return null;
     }
@@ -1743,7 +1717,9 @@ function validateJsonSchema(data, schema) {
       errors.push(`${path2}: above maximum ${s["maximum"]}`);
     }
     if (Array.isArray(value) && s["items"] && Array.isArray(s["items"])) {
-      value.forEach((item, i) => check(item, s["items"], `${path2}[${i}]`));
+      for (let i = 0; i < value.length; i++) {
+        check(value[i], s["items"], `${path2}[${i}]`);
+      }
     }
     if (typeof value === "object" && value !== null && !Array.isArray(value) && s["properties"]) {
       const props = s["properties"];
@@ -2154,12 +2130,12 @@ function expandLoops(template, variables) {
     }
   );
 }
-function renderTemplate(template, variables) {
+function renderTemplate(template, variables, escapeHtml = true) {
   let result = template;
   result = expandConditionals(result, variables);
   result = expandLoops(result, variables);
   result = expandTemplate(result, variables);
-  {
+  if (escapeHtml) {
     result = result.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
   }
   return result;
@@ -2192,6 +2168,7 @@ var plugin9 = {
   },
   setup(api) {
     const templates = /* @__PURE__ */ new Map();
+    const autoEscapeHtml = api.config.extensions?.["template-engine"]?.["autoEscapeHtml"] ?? true;
     api.tools.register({
       name: "template_expand",
       description: "Expand a template string with variable substitution. Supports {{variable}}, {{#if var}}...{{/if}} conditionals, and {{#each items}}...{{/each}} loops.",
@@ -2224,7 +2201,7 @@ var plugin9 = {
         }
         let result;
         try {
-          result = raw ? renderTemplateRaw(template, variables) : renderTemplate(template, variables);
+          result = raw ? renderTemplateRaw(template, variables) : renderTemplate(template, variables, autoEscapeHtml);
         } catch (err) {
           return { ok: false, error: String(err) };
         }
@@ -2288,7 +2265,7 @@ var plugin9 = {
         }
         let result;
         try {
-          result = raw ? renderTemplateRaw(content, variables) : renderTemplate(content, variables);
+          result = raw ? renderTemplateRaw(content, variables) : renderTemplate(content, variables, autoEscapeHtml);
         } catch (err) {
           return { ok: false, error: `Template rendering failed: ${err}` };
         }
@@ -2584,7 +2561,7 @@ var plugin10 = {
         try {
           commits = getRecentCommits(lastTag, cwd);
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = toErrorMessage(err);
           return { ok: false, error: `Git error: ${msg}`, bumpPart: "patch" };
         }
         bumpPart = determineBump(commits);
@@ -2615,7 +2592,7 @@ var plugin10 = {
             windowsHide: true
           });
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = toErrorMessage(err);
           return { ok: false, error: `bump script failed: ${msg}` };
         }
         for (const rel of ["package.json", "package-lock.json", "src/lib/utils.ts", "index.html"]) {

package/dist/json-path.js

@@ -61,6 +61,7 @@ function jmespathSearch(data, query) {
           return Number(itemVal) >= Number(cmpVal);
         case "<=":
           return Number(itemVal) <= Number(cmpVal);
+        /* v8 ignore next -- op is constrained to the six operators by the filter regex; default is unreachable. */
         default:
           return true;
       }
@@ -87,6 +88,7 @@ function jmespathSearch(data, query) {
         if (data === null) return "null";
         if (Array.isArray(data)) return "array";
         return typeof data;
+      /* v8 ignore next 2 -- fn is constrained to the four names by the function regex; default is unreachable. */
       default:
         return null;
     }
@@ -129,7 +131,9 @@ function validateJsonSchema(data, schema) {
       errors.push(`${path}: above maximum ${s["maximum"]}`);
     }
     if (Array.isArray(value) && s["items"] && Array.isArray(s["items"])) {
-      value.forEach((item, i) => check(item, s["items"], `${path}[${i}]`));
+      for (let i = 0; i < value.length; i++) {
+        check(value[i], s["items"], `${path}[${i}]`);
+      }
     }
     if (typeof value === "object" && value !== null && !Array.isArray(value) && s["properties"]) {
       const props = s["properties"];

package/dist/semver-bump.js

@@ -1,4 +1,5 @@
 import { expectDefined } from '@wrongstack/core';
+import { toErrorMessage } from '@wrongstack/core/utils';
 import { execFileSync } from 'child_process';
 import { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';
 import { join } from 'path';
@@ -197,7 +198,7 @@ var plugin = {
         try {
           commits = getRecentCommits(lastTag, cwd);
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = toErrorMessage(err);
           return { ok: false, error: `Git error: ${msg}`, bumpPart: "patch" };
         }
         bumpPart = determineBump(commits);
@@ -228,7 +229,7 @@ var plugin = {
             windowsHide: true
           });
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = toErrorMessage(err);
           return { ok: false, error: `bump script failed: ${msg}` };
         }
         for (const rel of ["package.json", "package-lock.json", "src/lib/utils.ts", "index.html"]) {

package/dist/shell-check.js

@@ -18,13 +18,8 @@ function runShellCheck(files, severity, cwd) {
     info: "info",
     style: "style"
   };
-  const args = [
-    "-f",
-    "json",
-    "-S",
-    levelMap[severity] ?? "warning",
-    ...files
-  ];
+  const severityFlag = levelMap[severity] ?? "warning";
+  const args = ["-f", "json", "-S", severityFlag, ...files];
   let raw;
   try {
     raw = execFileSync("shellcheck", args, {

package/dist/template-engine.js

@@ -34,12 +34,12 @@ function expandLoops(template, variables) {
     }
   );
 }
-function renderTemplate(template, variables) {
+function renderTemplate(template, variables, escapeHtml = true) {
   let result = template;
   result = expandConditionals(result, variables);
   result = expandLoops(result, variables);
   result = expandTemplate(result, variables);
-  {
+  if (escapeHtml) {
     result = result.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
   }
   return result;
@@ -72,6 +72,7 @@ var plugin = {
   },
   setup(api) {
     const templates = /* @__PURE__ */ new Map();
+    const autoEscapeHtml = api.config.extensions?.["template-engine"]?.["autoEscapeHtml"] ?? true;
     api.tools.register({
       name: "template_expand",
       description: "Expand a template string with variable substitution. Supports {{variable}}, {{#if var}}...{{/if}} conditionals, and {{#each items}}...{{/each}} loops.",
@@ -104,7 +105,7 @@ var plugin = {
         }
         let result;
         try {
-          result = raw ? renderTemplateRaw(template, variables) : renderTemplate(template, variables);
+          result = raw ? renderTemplateRaw(template, variables) : renderTemplate(template, variables, autoEscapeHtml);
         } catch (err) {
           return { ok: false, error: String(err) };
         }
@@ -168,7 +169,7 @@ var plugin = {
         }
         let result;
         try {
-          result = raw ? renderTemplateRaw(content, variables) : renderTemplate(content, variables);
+          result = raw ? renderTemplateRaw(content, variables) : renderTemplate(content, variables, autoEscapeHtml);
         } catch (err) {
           return { ok: false, error: `Template rendering failed: ${err}` };
         }

package/dist/web-search.js

@@ -190,7 +190,8 @@ var plugin = {
         }
         const deduplicated = [];
         for (const r of rawResults) {
-          const normalized = (r.url.split("?")[0] ?? r.url).split("#")[0] ?? r.url;
+          const noQuery = r.url.split("?")[0] ?? r.url;
+          const normalized = noQuery.split("#")[0] ?? r.url;
           if (!seenUrls.has(normalized) && r.url.startsWith("http")) {
             seenUrls.add(normalized);
             deduplicated.push(r);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/plugins",
-  "version": "0.260.0",
+  "version": "0.265.1",
   "description": "Official WrongStack plugin collection — auto-doc, git-autocommit, shell-check, cost-tracker, file-watcher, web-search, json-path, cron, template-engine, semver-bump",
   "license": "MIT",
   "author": "ECOSTACK TECHNOLOGY OÜ",
@@ -63,7 +63,7 @@
     "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@wrongstack/core": "0.260.0"
+    "@wrongstack/core": "0.265.1"
   },
   "scripts": {
     "build": "tsup",