@xberg-io/opencode-xberg 1.3.7 → 1.3.8

package/README.md

@@ -17,6 +17,30 @@ Self-host:
 /plugin install xberg@xberg
 ```
 
+### Pi
+
+From a checkout of this repository, run:
+
+```bash
+pi install ./plugin
+```
+
+Once a plugin release includes Pi support, use the shared OpenCode/Pi npm package:
+
+```bash
+pi install npm:@xberg-io/opencode-xberg
+```
+
+Pi discovers skills from `.pi/skills` and prompt templates from `.pi/prompts`.
+Use `/xberg-extract` and `/xberg-ocr` to start a task.
+Install the CLI separately using the instructions below. The Pi package does not
+register MCP servers, hooks, or executable extensions. The MCP integration
+sections below apply to clients with MCP support.
+
+Git installs use the repository root's `package.json` resource paths. GitHub
+hosts the checkout resources; the existing npm plugin release publishes the same
+Pi content alongside the OpenCode adapter. No separate Pi release job is needed.
+
 ### Binary requirement
 
 Install the `xberg` CLI:
@@ -118,6 +142,22 @@ xberg extract data.xlsx --format json
 
 The plugin version tracks the xberg core release (`Cargo.toml`). See [CHANGELOG.md](../CHANGELOG.md) for release notes.
 
+## Maintaining the plugin
+
+Edit `plugin/.ai-rulez` sources, then run these commands from the repository root
+with a Pi-capable ai-rulez v5 binary installed:
+
+```bash
+task plugin:generate
+task plugin:verify
+task plugin:test
+```
+
+CI builds the generator from a pinned source revision and verifies the generated
+bundles, OpenCode tools, and actual npm archive before publication. The shared
+npm package publishes both OpenCode and Pi resources; Hermes uses its existing
+PyPI release job. GitHub hosts the remaining plugin bundles and marketplace indexes.
+
 ## License
 
 MIT. The skill content uses Elastic-2.0 references to the upstream [xberg](https://github.com/xberg-io/xberg) repository.

package/package.json

@@ -1,31 +1,84 @@
 {
-  "name": "@xberg-io/opencode-xberg",
-  "version": "1.3.7",
+  "dependencies": {
+    "@opencode/plugin": "^2.0.20"
+  },
   "description": "Local document extraction: text, tables, metadata, images from 107 formats with optional OCR.",
+  "exports": {
+    ".": "./.opencode/plugins/xberg.js"
+  },
+  "files": [
+    ".opencode/ai-rulez-bundle.json",
+    ".opencode/ai-rulez-content.js",
+    ".opencode/commands/xberg-extract.md",
+    ".opencode/commands/xberg-ocr.md",
+    ".opencode/plugins/xberg.js",
+    ".opencode/skills/batch-extraction/SKILL.md",
+    ".opencode/skills/chunking/SKILL.md",
+    ".opencode/skills/extracting-keywords/SKILL.md",
+    ".opencode/skills/extracting-tables/SKILL.md",
+    ".opencode/skills/extracting-with-ocr/SKILL.md",
+    ".opencode/skills/picking-a-format/SKILL.md",
+    ".opencode/skills/xberg/SKILL.md",
+    ".opencode/skills/xberg/references/advanced-features.md",
+    ".opencode/skills/xberg/references/cli-reference.md",
+    ".opencode/skills/xberg/references/configuration.md",
+    ".opencode/skills/xberg/references/nodejs-api.md",
+    ".opencode/skills/xberg/references/other-bindings.md",
+    ".opencode/skills/xberg/references/python-api.md",
+    ".opencode/skills/xberg/references/rust-api.md",
+    ".opencode/skills/xberg/references/supported-formats.md",
+    ".pi/prompts/xberg-extract.md",
+    ".pi/prompts/xberg-ocr.md",
+    ".pi/skills/batch-extraction/SKILL.md",
+    ".pi/skills/chunking/SKILL.md",
+    ".pi/skills/extracting-keywords/SKILL.md",
+    ".pi/skills/extracting-tables/SKILL.md",
+    ".pi/skills/extracting-with-ocr/SKILL.md",
+    ".pi/skills/picking-a-format/SKILL.md",
+    ".pi/skills/xberg/SKILL.md",
+    ".pi/skills/xberg/references/advanced-features.md",
+    ".pi/skills/xberg/references/cli-reference.md",
+    ".pi/skills/xberg/references/configuration.md",
+    ".pi/skills/xberg/references/nodejs-api.md",
+    ".pi/skills/xberg/references/other-bindings.md",
+    ".pi/skills/xberg/references/python-api.md",
+    ".pi/skills/xberg/references/rust-api.md",
+    ".pi/skills/xberg/references/supported-formats.md",
+    "README.md",
+    "assets/",
+    "scripts/"
+  ],
+  "homepage": "https://xberg.io",
   "keywords": [
     "document-intelligence",
     "extraction",
     "ocr",
     "pdf",
+    "pi-package",
     "tables"
   ],
-  "homepage": "https://xberg.io",
+  "license": "MIT",
+  "main": ".opencode/plugins/xberg.js",
+  "name": "@xberg-io/opencode-xberg",
+  "pi": {
+    "prompts": [
+      "./.pi/prompts/xberg-extract.md",
+      "./.pi/prompts/xberg-ocr.md"
+    ],
+    "skills": [
+      "./.pi/skills/batch-extraction",
+      "./.pi/skills/chunking",
+      "./.pi/skills/extracting-keywords",
+      "./.pi/skills/extracting-tables",
+      "./.pi/skills/extracting-with-ocr",
+      "./.pi/skills/picking-a-format",
+      "./.pi/skills/xberg"
+    ]
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/xberg-io/xberg"
   },
-  "license": "MIT",
   "type": "module",
-  "main": ".opencode/plugins/xberg.js",
-  "exports": {
-    ".": "./.opencode/plugins/xberg.js"
-  },
-  "files": [
-    ".opencode/",
-    "assets/",
-    "README.md"
-  ],
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.17.8"
-  }
+  "version": "1.3.8"
 }

package/scripts/mcp-launch.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NPM_PKG="@xberg-io/xberg-cli"
+PYPI_PKG="xberg-cli"
+
+log() { printf 'xberg-launch: %s\n' "$*" >&2; }
+die() {
+  log "error: $*"
+  exit 1
+}
+
+LAUNCHER="${XBERG_LAUNCHER:-auto}"
+case "$LAUNCHER" in
+auto | npx | uvx | brew | download) ;;
+*) die "invalid XBERG_LAUNCHER='$LAUNCHER' (expected auto|npx|uvx|brew|download)" ;;
+esac
+
+want() { [ "$LAUNCHER" = "auto" ] || [ "$LAUNCHER" = "$1" ]; }
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-}"
+if [ -z "$PLUGIN_ROOT" ]; then
+  PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
+
+BINARY_NAME="xberg"
+case "$(uname -s)" in
+MINGW* | MSYS* | CYGWIN* | Windows_NT) BINARY_NAME="xberg.exe" ;;
+esac
+BIN_DIR="$PLUGIN_ROOT/bin"
+BIN="$BIN_DIR/$BINARY_NAME"
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+runnable() { [ -x "$1" ] && "$1" --version >/dev/null 2>&1; }
+
+if runnable "$BIN"; then
+  log "using cached xberg at $BIN"
+  exec "$BIN" "$@"
+fi
+if have "$BINARY_NAME"; then
+  PATH_BIN="$(command -v "$BINARY_NAME")"
+  if runnable "$PATH_BIN"; then
+    log "using xberg on PATH ($PATH_BIN)"
+    exec "$PATH_BIN" "$@"
+  fi
+fi
+
+if want npx && have npx; then
+  log "probing npx $NPM_PKG@latest ..."
+  scratch="$(mktemp -d)"
+  if (cd "$scratch" && npx -y "$NPM_PKG@latest" --version >/dev/null 2>&1); then
+    log "launching via npx $NPM_PKG@latest"
+    cd "$scratch"
+    exec npx -y "$NPM_PKG@latest" "$@"
+  fi
+  rm -rf "$scratch"
+  log "npx $NPM_PKG not available (no CLI bin yet); falling through"
+fi
+
+if want uvx && have uvx; then
+  log "probing uvx --from $PYPI_PKG $BINARY_NAME ..."
+  if uvx --from "$PYPI_PKG" "$BINARY_NAME" --version >/dev/null 2>&1; then
+    log "launching via uvx --from $PYPI_PKG $BINARY_NAME"
+    exec uvx --from "$PYPI_PKG" "$BINARY_NAME" "$@"
+  fi
+  log "uvx $PYPI_PKG not available (no CLI entry point yet); falling through"
+fi
+
+if want brew && have brew; then
+  log "installing via 'brew install xberg-io/tap/xberg' ..."
+  if brew install xberg-io/tap/xberg >&2; then
+    if have "$BINARY_NAME"; then
+      BREW_BIN="$(command -v "$BINARY_NAME")"
+      runnable "$BREW_BIN" && exec "$BREW_BIN" "$@"
+    fi
+    log "brew install reported success but xberg is not on PATH; falling through"
+  else
+    log "brew install failed; falling through"
+  fi
+fi
+
+try_download() {
+  local arch triple ext base_url asset asset_url tmp ex src_dir
+  arch="$(uname -m)"
+  case "$(uname -s)" in
+  Darwin)
+    case "$arch" in
+    arm64 | aarch64) triple="aarch64-apple-darwin" ;;
+    x86_64 | amd64) triple="x86_64-apple-darwin" ;;
+    *)
+      log "no prebuilt macOS archive for $arch; falling through"
+      return 1
+      ;;
+    esac
+    ;;
+  Linux)
+    case "$arch" in
+    aarch64 | arm64) triple="aarch64-unknown-linux-gnu" ;;
+    x86_64) triple="x86_64-unknown-linux-gnu" ;;
+    *)
+      log "no prebuilt Linux archive for $arch; falling through"
+      return 1
+      ;;
+    esac
+    ;;
+  MINGW* | MSYS* | CYGWIN* | Windows_NT) triple="x86_64-pc-windows-msvc" ;;
+  *)
+    log "no prebuilt archive for $(uname -s)/$arch; falling through"
+    return 1
+    ;;
+  esac
+  case "$triple" in
+  *windows*) ext="zip" ;;
+  *) ext="tar.gz" ;;
+  esac
+
+  base_url="https://github.com/xberg-io/xberg/releases/latest/download"
+  asset="xberg-cli-${triple}.${ext}"
+  asset_url="${base_url}/${asset}"
+
+  if have curl; then
+    fetch() { curl -fsSL --retry 3 -o "$2" "$1"; }
+  elif have wget; then
+    fetch() { wget -q -O "$2" "$1"; }
+  else
+    log "no curl or wget available for download; falling through"
+    return 1
+  fi
+
+  tmp="$(mktemp -d)"
+  # shellcheck disable=SC2064  # expand $tmp now so the trap removes this exact dir
+  trap "rm -rf '$tmp'" RETURN
+
+  log "downloading $asset from latest release ..."
+  if ! fetch "$asset_url" "$tmp/$asset"; then
+    log "download failed or asset not found: $asset_url; falling through"
+    return 1
+  fi
+
+  log "warning: no published checksum for $asset; integrity is verified by HTTPS/TLS only, not a content hash"
+
+  ex="$tmp/extracted"
+  mkdir -p "$ex"
+  case "$ext" in
+  tar.gz) tar -xzf "$tmp/$asset" -C "$ex" || {
+    log "extraction failed; falling through"
+    return 1
+  } ;;
+  zip)
+    if have unzip; then
+      unzip -qo "$tmp/$asset" -d "$ex" || {
+        log "extraction failed; falling through"
+        return 1
+      }
+    else
+      log "need unzip to extract $asset; falling through"
+      return 1
+    fi
+    ;;
+  esac
+
+  src_dir="$ex/xberg-cli-${triple}"
+  [ -d "$src_dir" ] || src_dir="$ex"
+  if [ ! -f "$src_dir/$BINARY_NAME" ]; then
+    log "binary $BINARY_NAME not found inside $asset; falling through"
+    return 1
+  fi
+
+  rm -rf "$BIN_DIR"
+  mkdir -p "$BIN_DIR"
+  mv "$src_dir"/* "$BIN_DIR"/
+  chmod +x "$BIN"
+  log "installed xberg to $BIN"
+  return 0
+}
+
+if want download; then
+  if try_download; then
+    exec "$BIN" "$@"
+  fi
+fi
+
+die "could not locate or install xberg. Install it manually with one of:
+  brew install xberg-io/tap/xberg
+  cargo install xberg-cli
+  or download a prebuilt archive from https://github.com/xberg-io/xberg/releases/latest
+then ensure 'xberg' is on PATH and retry."