@pumblus/okf-harness 0.6.0

package/README.md

@@ -0,0 +1,27 @@
+# OKF Harness Native Integration
+
+This package exposes the global `okf-harness-bootstrap` integration for Pi, OpenCode, and OpenClaw.
+
+## Install
+
+```bash
+pi install npm:@pumblus/okf-harness
+```
+
+```bash
+opencode plugin @pumblus/okf-harness --global
+```
+
+```bash
+openclaw skills install @pumblus/okf-harness --global
+```
+
+The package does not install or update the OKF Harness runtime. If `okfh` is missing, run Universal setup:
+
+```bash
+npx @okf-harness/setup@latest
+```
+
+## Scope
+
+The native package only exposes `okf-harness-bootstrap`. Daily workspace-local OKF Harness skills remain installed by the runtime when a workspace supports that agent adapter.

package/dist/opencode.d.ts

@@ -0,0 +1,3 @@
+declare const OkfHarnessBootstrapPlugin: () => Promise<{}>;
+
+export { OkfHarnessBootstrapPlugin, OkfHarnessBootstrapPlugin as default };

package/dist/opencode.js

@@ -0,0 +1,54 @@
+// src/opencode.ts
+import { copyFile, mkdir, readFile } from "fs/promises";
+import { homedir } from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+var skillName = "okf-harness-bootstrap";
+var managedMarker = 'okf-harness-managed: "true"';
+var OkfHarnessBootstrapPlugin = async () => {
+  await syncGlobalBootstrapSkill();
+  return {};
+};
+var opencode_default = OkfHarnessBootstrapPlugin;
+async function syncGlobalBootstrapSkill() {
+  const source = path.resolve(packageRoot(), "skills", skillName, "SKILL.md");
+  const targetDir = path.join(resolveOpenCodeConfigDir(), "skills", skillName);
+  const target = path.join(targetDir, "SKILL.md");
+  const sourceContents = await readFile(source, "utf8");
+  if (await hasUserOwnedSkill(target)) {
+    return;
+  }
+  await mkdir(targetDir, { recursive: true });
+  await copyFile(source, target);
+  const targetContents = await readFile(target, "utf8");
+  if (targetContents !== sourceContents) {
+    throw new Error(`Failed to verify synced ${skillName} skill contents.`);
+  }
+}
+async function hasUserOwnedSkill(target) {
+  try {
+    const contents = await readFile(target, "utf8");
+    return !contents.includes(managedMarker);
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+function packageRoot() {
+  return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+function resolveOpenCodeConfigDir() {
+  if (process.env.OPENCODE_CONFIG_DIR) {
+    return process.env.OPENCODE_CONFIG_DIR;
+  }
+  if (process.env.XDG_CONFIG_HOME) {
+    return path.join(process.env.XDG_CONFIG_HOME, "opencode");
+  }
+  return path.join(homedir(), ".config", "opencode");
+}
+export {
+  OkfHarnessBootstrapPlugin,
+  opencode_default as default
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@pumblus/okf-harness",
+  "version": "0.6.0",
+  "description": "Pi, OpenCode, and OpenClaw native bootstrap integration for OKF Harness.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "author": "Eric Zhou",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "homepage": "https://github.com/pumblus/okf-harness#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pumblus/okf-harness.git",
+    "directory": "packages/native-integration"
+  },
+  "bugs": {
+    "url": "https://github.com/pumblus/okf-harness/issues"
+  },
+  "keywords": [
+    "okf",
+    "open-knowledge-format",
+    "llm-wiki",
+    "agent-skills",
+    "pi",
+    "pi-package",
+    "opencode",
+    "openclaw",
+    "clawhub"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/opencode.js",
+  "types": "./dist/opencode.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/opencode.d.ts",
+      "import": "./dist/opencode.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  },
+  "scripts": {
+    "build": "tsup src/opencode.ts --format esm --dts --clean",
+    "prepublishOnly": "pnpm run build"
+  }
+}

package/skills/okf-harness-bootstrap/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: okf-harness-bootstrap
+description: Bootstrap OKF Harness from Pi, OpenCode, or OpenClaw before a workspace-local OKF skill exists. Use when the user asks to create, find, select, repair, or enter an OKF Harness workspace. If okfh is missing, point to Universal setup. Do not use for daily workspace answers, generic Markdown editing, or non-OKF knowledge-base work.
+license: Apache-2.0
+compatibility: pi, opencode, openclaw
+metadata:
+  openclaw:
+    homepage: "https://github.com/pumblus/okf-harness"
+  okf-harness-managed: "true"
+  okf-harness-entrypoint: "bootstrap"
+  okf-harness-package: "@pumblus/okf-harness"
+---
+
+# OKF Harness Bootstrap
+
+Use this skill only as the global bootstrap entrypoint for OKF Harness.
+
+## Runtime Check
+
+1. Check whether `okfh` is available before planning workspace actions.
+2. If `okfh` is missing, stop and tell the user to run `npx @okf-harness/setup@latest`.
+3. Do not install, update, or replace the runtime from this skill.
+
+## Scope
+
+- This package exposes only `okf-harness-bootstrap`.
+- Do not claim that Pi, OpenCode, or OpenClaw workspace-local daily adapters are installed by this package.
+- Once `okfh` is available, use `okfh --json` commands to inspect, create, select, or repair OKF Harness workspaces.
+- Before changing a workspace, prefer JSON-capable checks such as `okfh doctor --json` and workspace status commands when available.
+
+## Response Contract
+
+- State the runtime status first.
+- If blocked by a missing runtime, give only the exact setup command: `npx @okf-harness/setup@latest`.
+- If continuing, keep actions limited to OKF Harness bootstrap work.