opencode-agent-skills-md 1.0.0 → 1.0.1

package/README.md

@@ -52,9 +52,30 @@ Both packages live in this repo as a pnpm workspace. From the repo root, `pnpm i
 
 ## Installation
 
-### OpenCode plugin
+### Quick install (recommended)
 
-Add the plugin to your OpenCode config at `~/.config/opencode/opencode.json`:
+```bash
+npx opencode-agent-skills-md install
+```
+
+This registers the plugin in your global OpenCode config and verifies the installation. Restart OpenCode to activate.
+
+### CLI commands
+
+After installing, the following commands are available:
+
+- `oas install` — register the plugin in the global OpenCode config
+- `oas uninstall` — remove the plugin from the global OpenCode config
+- `oas status` — check whether the plugin is currently installed
+- `oas doctor` — validate the OpenCode configuration health
+
+### From npm (alternative)
+
+```bash
+npm install -g opencode-agent-skills-md
+```
+
+Then add the plugin to `~/.config/opencode/opencode.json`:
 
 ```json
 {
@@ -70,6 +91,16 @@ To pin a specific version:
 }
 ```
 
+### Manual configuration (fallback)
+
+If you prefer not to use the CLI, add the plugin entry manually to `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-agent-skills-md"]
+}
+```
+
 Restart OpenCode after updating the config.
 
 ### Custom harness (standalone engine)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-skills-md",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
   "description": "pnpm workspace root for opencode-agent-skills-md. The user-facing OpenCode plugin lives at packages/opencode-agent-skills-md and the portable engine at packages/core. This manifest exists only to wire the workspace — it has no exports of its own; consumers install one of the workspace packages directly.",
   "author": "Josh Thomas <josh@joshthomas.dev>",
@@ -23,7 +23,7 @@
     "@types/node": "^25.9.1",
     "tsx": "^4.22.3",
     "typescript": "^6.0.3",
-    "opencode-agent-skills-md": "0.7.0",
+    "opencode-agent-skills-md": "1.0.1",
     "opencode-agent-skills-md-core": "0.0.0"
   },
   "scripts": {

package/packages/opencode-agent-skills-md/package.json

@@ -2,7 +2,6 @@
   "name": "opencode-agent-skills-md",
   "version": "0.7.0",
   "description": "OpenCode adapter for the opencode-agent-skills-md workspace: plugin factory, host, and the four skill tools.",
-  "private": true,
   "type": "module",
   "main": "src/index.ts",
   "exports": {
@@ -14,29 +13,54 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "README.md",
+    "LICENSE"
   ],
   "bin": {
     "oas": "./dist/cli.mjs"
   },
   "scripts": {
     "build": "rm -rf dist && rolldown -c && tsc -p tsconfig.build.json",
+    "prepack": "pnpm run build",
     "pretest": "npm run build",
     "test": "node --import tsx --test \"tests/**/*.test.ts\"",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.15.11",
-    "opencode-agent-skills-md-core": "workspace:*",
     "yaml": "^2.9.0"
   },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
   "devDependencies": {
     "@types/node": "^25.9.1",
+    "opencode-agent-skills-md-core": "workspace:*",
     "rolldown": "^1.0.3",
     "tsx": "^4.22.3",
     "typescript": "^6.0.3"
   },
   "engines": {
     "node": ">=18.0.0"
-  }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetalbolicX/opencode-agent-skills-md.git"
+  },
+  "homepage": "https://github.com/MetalbolicX/opencode-agent-skills-md",
+  "bugs": {
+    "url": "https://github.com/MetalbolicX/opencode-agent-skills-md/issues"
+  },
+  "author": {
+    "name": "Josh Thomas",
+    "url": "https://github.com/joshjoshthomas"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "skills",
+    "agent",
+    "ai"
+  ]
 }

package/packages/opencode-agent-skills-md/rolldown.config.js

@@ -6,9 +6,9 @@ import { defineConfig } from 'rolldown';
  *   - `dist/plugin.mjs`   — the OpenCode host adapter + default-export plugin factory.
  *   - `dist/cli.mjs`      — the `oas` CLI entry point (shebang + parseArgs dispatch).
  *
- * The core engine (`opencode-agent-skills-md-core`) is consumed as a workspace
- * package dependency, so it is treated as an external — the plugin bundle
- * keeps a runtime import for it instead of inlining the sources.
+ * The core engine (`opencode-agent-skills-md-core`) is inlined into the plugin
+ * bundle — it is removed from externals so rolldown treeshakes and bundles it
+ * directly. The plugin stays self-contained at runtime.
  *
  * `node:util` (parseArgs) and `node:url` (pathToFileURL for entry-point
  * detection) are only used by the CLI; the plugin entry doesn't need them,
@@ -17,7 +17,6 @@ import { defineConfig } from 'rolldown';
  */
 const sharedExternal = [
   '@opencode-ai/plugin',
-  'opencode-agent-skills-md-core',
   'node:fs',
   'node:fs/promises',
   'node:os',

package/packages/opencode-agent-skills-md/src/cli/main.ts

@@ -16,6 +16,7 @@
 // ---------------------------------------------------------------------------
 
 import { pathToFileURL } from "node:url";
+import { realpathSync } from "node:fs";
 import { parseArgs } from "node:util";
 import { runInstall } from "./install";
 import { runDoctor, runStatus } from "./status";
@@ -186,15 +187,30 @@ export const runMain = (argv: readonly string[] = process.argv): MainResult => {
  * cli.mjs`), `false` when it was imported from a test harness. We avoid
  * `import.meta.main` because the package floor is Node 18 and that field
  * only landed in Node 22.
+ *
+ * Symlink-aware: when the script is invoked through a symlink (e.g. the
+ * pnpm global store, where `node_modules/<pkg>` is a symlink into a
+ * content-addressable store), `process.argv[1]` carries the symlink path
+ * while `import.meta.url` carries the real path after symlink resolution.
+ * Comparing the two verbatim would always be `false` under pnpm, causing
+ * the CLI to silently exit. We resolve both sides through `realpathSync`
+ * before comparing.
  */
-const invokedAsMain = ((): boolean => {
+const checkInvokedAsMain = (): boolean => {
   if (!process.argv[1]) return false;
   try {
-    return import.meta.url === pathToFileURL(process.argv[1]).href;
+    const realArgv = pathToFileURL(realpathSync(process.argv[1])).href;
+    return import.meta.url === realArgv;
   } catch {
-    return false;
+    try {
+      return import.meta.url === pathToFileURL(process.argv[1]).href;
+    } catch {
+      return false;
+    }
   }
-})();
+};
+
+const invokedAsMain = checkInvokedAsMain();
 
 if (invokedAsMain) {
   runMain(process.argv);

package/packages/opencode-agent-skills-md/tests/package-boundary.test.ts

@@ -41,36 +41,35 @@ const TESTS_DIR = path.join(PKG_DIR, "tests");
 const REPO_ROOT = path.resolve(PKG_DIR, "..", "..");
 
 describe("opencode-agent-skills-md package boundary", () => {
-  test("manifest declares the plugin as `opencode-agent-skills-md`, ESM, and private", async () => {
+  test("manifest declares the plugin as `opencode-agent-skills-md`, ESM, and publishable", async () => {
     const pkgPath = path.join(PKG_DIR, "package.json");
     const raw = await readFile(pkgPath, "utf8");
     const manifest = JSON.parse(raw) as Record<string, unknown>;
 
     assert.equal(manifest.name, "opencode-agent-skills-md", "package name preserves the existing install surface");
     assert.equal(manifest.type, "module", "package type must be ESM");
-    assert.equal(
-      manifest.private,
-      true,
-      "package must be private until publishing is wired in a later PR",
-    );
+    assert.equal(manifest.private, undefined, "package must not be private — it is published to npm");
   });
 
-  test("manifest depends on the workspace core package and on @opencode-ai/plugin", async () => {
+  test("manifest has the correct dependency shape for publishing", async () => {
     const raw = await readFile(path.join(PKG_DIR, "package.json"), "utf8");
     const manifest = JSON.parse(raw) as Record<string, unknown>;
 
     const dependencies = (manifest.dependencies ?? {}) as Record<string, string>;
+    const devDependencies = (manifest.devDependencies ?? {}) as Record<string, string>;
+    const peerDependencies = (manifest.peerDependencies ?? {}) as Record<string, string>;
+
     assert.ok(
-      "opencode-agent-skills-md-core" in dependencies,
-      "dependencies must declare the workspace core package",
+      "yaml" in dependencies,
+      "dependencies must include yaml (runtime dependency for the core engine)",
     );
     assert.ok(
-      "@opencode-ai/plugin" in dependencies,
-      "dependencies must include @opencode-ai/plugin (this is the OpenCode adapter package)",
+      "@opencode-ai/plugin" in peerDependencies,
+      "@opencode-ai/plugin must be a peerDependency (provided by the OpenCode host)",
     );
     assert.ok(
-      "yaml" in dependencies,
-      "dependencies must include yaml (transitively required by the core)",
+      "opencode-agent-skills-md-core" in devDependencies,
+      "opencode-agent-skills-md-core must be a devDependency (bundled into the plugin at build time)",
     );
   });