@xberg-io/opencode-html-to-markdown 0.2.3 → 3.10.1

package/.opencode/plugins/html-to-markdown.js

@@ -1,29 +1,31 @@
 // AI-RULEZ :: GENERATED FILE — DO NOT EDIT
-// Content-Hash: blake3:61b767fe4fa393813e733e6c20f5889905baac84a4a56c09b503b19cb6025eab
-// Source-Hash: blake3:94b6596172fbbfb9af67d0c25d7ae807c6faec78760a9728a8b59aaf917234df
+// Content-Hash: blake3:a6fa2bc34f3c3e8e95bd74acc79163d573b3c7d544c54ad82b5ca81e21f0f39c
+// Source-Hash: blake3:52a9e795318c65309bedf23c4148a244ae457abb074800a546ad13641285c9c3
 // Schema-Version: v1
 
-import { spawn } from "node:child_process";
-import { tool } from "@opencode-ai/plugin";
+import {tool} from "@opencode-ai/plugin";
+import {spawn} from "node:child_process";
 
 const schema = tool.schema;
 
-const headingStyle = schema
-  .enum(["atx", "underlined", "atx-closed"])
-  .optional()
-  .describe("Markdown heading style. Default: atx.");
+const headingStyle = schema.enum([ "atx", "underlined", "atx-closed" ])
+                         .optional()
+                         .describe("Markdown heading style. Default: atx.");
 
-const codeBlockStyle = schema
-  .enum(["backticks", "indented", "tildes"])
-  .optional()
-  .describe("Code block fence style. Default: backticks.");
+const codeBlockStyle =
+    schema.enum([ "backticks", "indented", "tildes" ])
+        .optional()
+        .describe("Code block fence style. Default: backticks.");
 
-const outputFormat = schema.enum(["markdown", "djot"]).optional().describe("Output markup format. Default: markdown.");
+const outputFormat = schema.enum([ "markdown", "djot" ])
+                         .optional()
+                         .describe("Output markup format. Default: markdown.");
 
-const preset = schema
-  .enum(["minimal", "standard", "aggressive"])
-  .optional()
-  .describe("Preprocessing aggressiveness. Requires `preprocess`. Default: standard.");
+const preset =
+    schema.enum([ "minimal", "standard", "aggressive" ])
+        .optional()
+        .describe(
+            "Preprocessing aggressiveness. Requires `preprocess`. Default: standard.");
 
 function hasValue(value) {
   return value !== undefined && value !== null && value !== "";
@@ -46,10 +48,10 @@ function runCli(args, context, stdin) {
 
   return new Promise((resolve, reject) => {
     const child = spawn("html-to-markdown", args, {
-      cwd: directory,
-      env: process.env,
-      signal: context?.abort,
-      stdio: [stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+      cwd : directory,
+      env : process.env,
+      signal : context?.abort,
+      stdio : [ stdin === undefined ? "ignore" : "pipe", "pipe", "pipe" ],
     });
 
     const stdout = [];
@@ -60,10 +62,10 @@ function runCli(args, context, stdin) {
     child.on("error", (error) => {
       if (error.code === "ENOENT") {
         resolve({
-          title: "html-to-markdown CLI not found",
-          output:
-            "Install the html-to-markdown CLI with `brew install xberg-io/tap/html-to-markdown`, or run it via `npx html-to-markdown` / `uvx --from html-to-markdown html-to-markdown`.",
-          metadata: { exitCode: 127, command: "html-to-markdown" },
+          title : "html-to-markdown CLI not found",
+          output :
+              "Install the html-to-markdown CLI with `brew install xberg-io/tap/html-to-markdown`, or run it via `npx -y @xberg-io/html-to-markdown-cli` / `uvx --from html-to-markdown-cli html-to-markdown`.",
+          metadata : {exitCode : 127, command : "html-to-markdown"},
         });
         return;
       }
@@ -72,12 +74,14 @@ function runCli(args, context, stdin) {
     child.on("close", (exitCode, signal) => {
       const stdoutText = Buffer.concat(stdout).toString("utf8").trim();
       const stderrText = Buffer.concat(stderr).toString("utf8").trim();
-      const output = [stdoutText, stderrText && `stderr:\n${stderrText}`].filter(Boolean).join("\n\n");
+      const output = [
+        stdoutText, stderrText && `stderr:\n${stderrText}`
+      ].filter(Boolean).join("\n\n");
 
       resolve({
-        title: exitCode === 0 ? "html-to-markdown" : "html-to-markdown failed",
-        output: output || "(no output)",
-        metadata: { exitCode, signal, command: "html-to-markdown" },
+        title : exitCode === 0 ? "html-to-markdown" : "html-to-markdown failed",
+        output : output || "(no output)",
+        metadata : {exitCode, signal, command : "html-to-markdown"},
       });
     });
 
@@ -97,17 +101,20 @@ function styleArgs(args, params) {
 }
 
 export const HtmlToMarkdownPlugin = async () => ({
-  tool: {
-    html_to_markdown_convert: tool({
-      description:
-        "Convert an HTML file or HTML string to Markdown (or Djot) with the html-to-markdown CLI. Provide either `path` or `html`.",
-      args: {
-        path: schema.string().min(1).optional().describe("Path to a local HTML file."),
-        html: schema.string().min(1).optional().describe("Inline HTML to convert (used when `path` is omitted)."),
-        heading_style: headingStyle,
-        code_block_style: codeBlockStyle,
-        output_format: outputFormat,
-        preprocess: schema.boolean().optional().describe("Strip navigation, ads, and forms before converting."),
+  tool : {
+    html_to_markdown_convert : tool({
+      description :
+          "Convert an HTML file or HTML string to Markdown (or Djot) with the html-to-markdown CLI. Provide either `path` or `html`.",
+      args : {
+        path : schema.string().min(1).optional().describe(
+            "Path to a local HTML file."),
+        html : schema.string().min(1).optional().describe(
+            "Inline HTML to convert (used when `path` is omitted)."),
+        heading_style : headingStyle,
+        code_block_style : codeBlockStyle,
+        output_format : outputFormat,
+        preprocess : schema.boolean().optional().describe(
+            "Strip navigation, ads, and forms before converting."),
         preset,
       },
       async execute(args, context) {
@@ -124,46 +131,44 @@ export const HtmlToMarkdownPlugin = async () => ({
         throw new Error("Provide either `path` or `html`.");
       },
     }),
-    html_to_markdown_fetch_url: tool({
-      description: "Fetch a URL and convert its HTML to Markdown (or Djot) with the html-to-markdown CLI.",
-      args: {
-        url: schema.string().min(1).describe("URL to fetch and convert."),
-        heading_style: headingStyle,
-        code_block_style: codeBlockStyle,
-        output_format: outputFormat,
-        preprocess: schema.boolean().optional().describe("Strip navigation, ads, and forms before converting."),
+    html_to_markdown_fetch_url : tool({
+      description :
+          "Fetch a URL and convert its HTML to Markdown (or Djot) with the html-to-markdown CLI.",
+      args : {
+        url : schema.string().min(1).describe("URL to fetch and convert."),
+        heading_style : headingStyle,
+        code_block_style : codeBlockStyle,
+        output_format : outputFormat,
+        preprocess : schema.boolean().optional().describe(
+            "Strip navigation, ads, and forms before converting."),
         preset,
-        user_agent: schema.string().min(1).optional().describe("Custom User-Agent header for the fetch."),
+        user_agent : schema.string().min(1).optional().describe(
+            "Custom User-Agent header for the fetch."),
       },
       async execute(args, context) {
-        const cliArgs = ["--url", args.url];
+        const cliArgs = [ "--url", args.url ];
         pushOption(cliArgs, "--user-agent", args.user_agent);
         styleArgs(cliArgs, args);
         return runCli(cliArgs, context);
       },
     }),
-    html_to_markdown_extract: tool({
-      description:
-        "Extract structured metadata, tables, and (optionally) document structure from HTML as JSON. Returns the full ConversionResult. Provide `path`, `html`, or `url`.",
-      args: {
-        path: schema.string().min(1).optional().describe("Path to a local HTML file."),
-        html: schema
-          .string()
-          .min(1)
-          .optional()
-          .describe("Inline HTML to analyze (used when `path` and `url` are omitted)."),
-        url: schema.string().min(1).optional().describe("URL to fetch and analyze."),
-        include_structure: schema
-          .boolean()
-          .optional()
-          .describe("Include the document structure tree in the JSON output."),
-        no_content: schema
-          .boolean()
-          .optional()
-          .describe("Suppress the Markdown content field — return metadata/tables/images only."),
+    html_to_markdown_extract : tool({
+      description :
+          "Extract structured metadata, tables, and (optionally) document structure from HTML as JSON. Returns the full ConversionResult. Provide `path`, `html`, or `url`.",
+      args : {
+        path : schema.string().min(1).optional().describe(
+            "Path to a local HTML file."),
+        html : schema.string().min(1).optional().describe(
+            "Inline HTML to analyze (used when `path` and `url` are omitted)."),
+        url : schema.string().min(1).optional().describe(
+            "URL to fetch and analyze."),
+        include_structure : schema.boolean().optional().describe(
+            "Include the document structure tree in the JSON output."),
+        no_content : schema.boolean().optional().describe(
+            "Suppress the Markdown content field — return metadata/tables/images only."),
       },
       async execute(args, context) {
-        const cliArgs = ["--json"];
+        const cliArgs = [ "--json" ];
         pushFlag(cliArgs, "--include-structure", args.include_structure);
         pushFlag(cliArgs, "--no-content", args.no_content);
 

package/README.md

@@ -13,8 +13,8 @@ Pending review for official Claude marketplace.
 Self-host:
 
 ```text
-/plugin marketplace add xberg-io/plugins
-/plugin install html-to-markdown@xberg
+/plugin marketplace add xberg-io/html-to-markdown
+/plugin install html-to-markdown@html-to-markdown
 ```
 
 ### Binary requirement
@@ -162,7 +162,7 @@ html-to-markdown input.html --output-format djot --heading-style underlined
 
 ## Versioning
 
-The plugin version tracks the marketplace `VERSION` file. See [CHANGELOG.md](../../CHANGELOG.md) for release notes.
+The plugin version tracks the html-to-markdown core release (`Cargo.toml`). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
 
 ## License
 
@@ -170,6 +170,5 @@ MIT. The skill content references the upstream [html-to-markdown](https://github
 
 ## See also
 
-- **Marketplace**: [xberg-io/plugins](https://github.com/xberg-io/plugins)
+- **Marketplace**: this repo — `/plugin marketplace add xberg-io/html-to-markdown`
 - **Upstream**: [xberg-io/html-to-markdown](https://github.com/xberg-io/html-to-markdown)
-- **Sibling plugins**: [xberg](../xberg/README.md), [crawlberg](../crawlberg/README.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xberg-io/opencode-html-to-markdown",
-  "version": "0.2.3",
+  "version": "3.10.1",
   "description": "Fast, lossless HTML→Markdown conversion with structured metadata, tables, and document-structure extraction.",
   "keywords": [
     "html-to-markdown",
@@ -12,7 +12,7 @@
   "homepage": "https://xberg.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/xberg-io/plugins"
+    "url": "https://github.com/xberg-io/html-to-markdown"
   },
   "license": "MIT",
   "type": "module",