shortcuts-playground 1.2.2 → 1.2.3

package/README.md

@@ -14,18 +14,29 @@ OpenCode now supports plugin-bundled hooks via `tool.execute.after`. This packag
 
 ## Installation
 
-For published npm distribution:
+For published npm distribution (native for generic `tool` plugins — `opencode plugin` is `tui`/`server` only):
+
+```json
+// opencode.json (project or ~/.config/opencode/opencode.jsonc)
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["shortcuts-playground"]
+}
+```
+
+Bun installs the validator on next startup to `~/.cache/opencode`. Skills/commands/agents are installed automatically on `npm i` via `postinstall`, or manually:
 
 ```bash
-opencode plugin shortcuts-playground  # installs via npm and updates opencode.json
-# or globally
-opencode plugin shortcuts-playground --global
+npx shortcuts-playground        # project .opencode/
+npx shortcuts-playground --global  # ~/.config/opencode/
 ```
 
+Pin with `shortcuts-playground@1.2.3`.
+
 For local development from a checkout:
 
 ```bash
-# option A: via opencode.json (recommended)
+# via opencode.json (recommended)
 # add to opencode.json: { "plugin": ["./opencode/plugin/validator.ts"] }
 # then copy skills/commands/agents:
 mkdir -p .opencode/plugins .opencode/skills .opencode/commands .opencode/agents
@@ -33,9 +44,6 @@ cp opencode/plugin/validator.ts .opencode/plugins/shortcuts-playground.ts
 cp -R opencode/skills/shortcuts-playground .opencode/skills/
 cp opencode/commands/*.md .opencode/commands/
 cp opencode/agents/*.md .opencode/agents/
-
-# option B: npm link / file path (no clone needed after publish)
-opencode plugin ./opencode
 ```
 
 The bundled skill uses direct script paths:

package/bin/install.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+// shortcuts-playground installer for OpenCode
+// Copies skills/commands/agents from the npm package into .opencode/
+// Usage: npx shortcuts-playground  or  npx shortcuts-playground --global
+
+import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+const isGlobal = process.argv.includes("--global") || process.argv.includes("-g");
+
+function findProjectRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 10; i++) {
+    if (existsSync(join(dir, ".git"))) return dir;
+    if (existsSync(join(dir, "opencode.json")) || existsSync(join(dir, ".opencode"))) return dir;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return start;
+}
+
+const destRoot = isGlobal
+  ? join(process.env.HOME || "~", ".config", "opencode")
+  : findProjectRoot(process.cwd());
+
+const destBase = join(destRoot, ".opencode");
+if (isGlobal) {
+  // global directly uses ~/.config/opencode
+  // destRoot already is that
+}
+
+function copyDir(src, dest) {
+  if (!existsSync(src)) return 0;
+  mkdirSync(dest, { recursive: true });
+  let count = 0;
+  for (const entry of readdirSync(src, { withFileTypes: true })) {
+    const s = join(src, entry.name);
+    const d = join(dest, entry.name);
+    if (entry.isDirectory()) {
+      cpSync(s, d, { recursive: true, force: true });
+      count++;
+    } else {
+      cpSync(s, d, { force: true });
+      count++;
+    }
+  }
+  return count;
+}
+
+const skillsSrc = join(pkgRoot, "skills", "shortcuts-playground");
+const skillsDest = isGlobal
+  ? join(destRoot, "skills", "shortcuts-playground")
+  : join(destBase, "skills", "shortcuts-playground");
+
+const commandsSrc = join(pkgRoot, "commands");
+const commandsDest = isGlobal
+  ? join(destRoot, "commands")
+  : join(destBase, "commands");
+
+const agentsSrc = join(pkgRoot, "agents");
+const agentsDest = isGlobal
+  ? join(destRoot, "agents")
+  : join(destBase, "agents");
+
+mkdirSync(skillsDest, { recursive: true });
+mkdirSync(commandsDest, { recursive: true });
+mkdirSync(agentsDest, { recursive: true });
+
+cpSync(skillsSrc, skillsDest, { recursive: true, force: true });
+for (const f of readdirSync(commandsSrc)) {
+  if (f.endsWith(".md")) cpSync(join(commandsSrc, f), join(commandsDest, f), { force: true });
+}
+for (const f of readdirSync(agentsSrc)) {
+  if (f.endsWith(".md")) cpSync(join(agentsSrc, f), join(agentsDest, f), { force: true });
+}
+
+console.log(`✓ Installed skills → ${skillsDest}`);
+console.log(`✓ Installed commands → ${commandsDest} (/build-shortcut, /remix-shortcut)`);
+console.log(`✓ Installed agents → ${agentsDest} (shortcut-builder, shortcut-remixer)`);
+console.log(`\nPlugin already registered via opencode.json "plugin": ["shortcuts-playground"] — restart OpenCode TUI and run /build-shortcut`);
+if (!isGlobal) console.log(`(global: npx shortcuts-playground --global)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shortcuts-playground",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Build, validate, sign, and archive macOS/iOS Shortcuts from OpenCode — thin skill wrapper over ToolKit v78 catalog, /build-shortcut and /remix-shortcut commands, and tool.execute.after validator",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,11 @@
     "plugin"
   ],
   "main": "plugin/validator.ts",
+  "bin": {
+    "shortcuts-playground": "./bin/install.js"
+  },
   "files": [
+    "bin/",
     "plugin/",
     "skills/",
     "commands/",
@@ -40,6 +44,9 @@
   "peerDependencies": {
     "@opencode-ai/plugin": "^1.17.0"
   },
+  "scripts": {
+    "postinstall": "node ./bin/install.js || true"
+  },
   "engines": {
     "node": ">=18"
   },