build: package JavaScript plugin for npm publishing

.opencode/package.json

@@ -1,5 +1,6 @@
 {
+    "type": "module",
     "dependencies": {
-        "@opencode-ai/plugin": "1.4.9"
+        "@opencode-ai/plugin": "1.4.10"
     }
 }

.opencode/plugins/propulsion.ts → .opencode/plugins/propulsion.js

@@ -2,8 +2,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import type { Plugin } from '@opencode-ai/plugin';
-
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const skillsDir = path.resolve(__dirname, '../../skills');
 const additionalSkillsDir = path.resolve(__dirname, '../../additional/skills');
@@ -17,35 +15,7 @@ const propulsionWorkflowPath = path.join(
     'SKILL.md',
 );
 
-type PropulsionHooks = Awaited<ReturnType<Plugin>>;
-type PropulsionConfig = Parameters<
-    NonNullable<PropulsionHooks['config']>
->[0] & {
-    skills?: {
-        paths?: string[];
-    };
-    command?: Record<string, CommandDefinition>;
-};
-type CommandFrontmatter = {
-    description?: string;
-    agent?: string;
-    model?: string;
-    subtask?: boolean;
-};
-
-type CommandDefinition = {
-    template: string;
-    description?: string;
-    agent?: string;
-    model?: string;
-    subtask?: boolean;
-};
-
-type PropulsionOptions = {
-    additional?: boolean;
-};
-
-const parseFrontmatterValue = (value: string): string | boolean => {
+const parseFrontmatterValue = (value) => {
     const trimmed = value.trim();
 
     if (
@@ -66,19 +36,14 @@ const parseFrontmatterValue = (value: string): string | boolean => {
     return trimmed;
 };
 
-const extractFrontmatter = (
-    raw: string,
-): {
-    frontmatter: CommandFrontmatter;
-    content: string;
-} => {
+const extractFrontmatter = (raw) => {
     const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
 
     if (!match) {
         return { frontmatter: {}, content: raw };
     }
 
-    const frontmatter: CommandFrontmatter = {};
+    const frontmatter = {};
     const frontmatterBlock = match[1] ?? '';
     const content = match[2] ?? '';
 
@@ -129,7 +94,7 @@ const extractFrontmatter = (
     return { frontmatter, content };
 };
 
-const addSkillsPath = (config: PropulsionConfig, skillsPath: string) => {
+const addSkillsPath = (config, skillsPath) => {
     config.skills = config.skills ?? {};
     config.skills.paths = config.skills.paths ?? [];
 
@@ -138,12 +103,12 @@ const addSkillsPath = (config: PropulsionConfig, skillsPath: string) => {
     }
 };
 
-const loadAdditionalCommands = (): Record<string, CommandDefinition> => {
+const loadAdditionalCommands = () => {
     if (!fs.existsSync(additionalCommandsDir)) {
         return {};
     }
 
-    const commands: Record<string, CommandDefinition> = {};
+    const commands = {};
 
     for (const entry of fs.readdirSync(additionalCommandsDir, {
         withFileTypes: true,
@@ -176,10 +141,7 @@ const loadAdditionalCommands = (): Record<string, CommandDefinition> => {
     return commands;
 };
 
-const mergeAdditionalCommands = (
-    config: PropulsionConfig,
-    additionalCommands: Record<string, CommandDefinition>,
-) => {
+const mergeAdditionalCommands = (config, additionalCommands) => {
     if (Object.keys(additionalCommands).length === 0) {
         return;
     }
@@ -194,7 +156,7 @@ const mergeAdditionalCommands = (
     }
 };
 
-const getBootstrapContent = (): string | null => {
+const getBootstrapContent = () => {
     if (!fs.existsSync(propulsionWorkflowPath)) {
         return null;
     }
@@ -213,8 +175,8 @@ ${content}
 </EXTREMELY_IMPORTANT>`;
 };
 
-export const PropulsionPlugin: Plugin = async (_pluginInput, options = {}) => {
-    const { additional = false } = options as PropulsionOptions;
+export const PropulsionPlugin = async (_pluginInput, options = {}) => {
+    const { additional = false } = options;
     const additionalCommands = additional ? loadAdditionalCommands() : {};
 
     return {

package.json

@@ -1,27 +1,46 @@
 {
     "name": "propulsion",
-    "version": "0.8.0",
+    "version": "0.9.0",
+    "description": "Compact workflow skills for agentic coding in OpenCode.",
+    "homepage": "https://github.com/moonpixels/propulsion#readme",
+    "bugs": {
+        "url": "https://github.com/moonpixels/propulsion/issues"
+    },
+    "license": "ISC",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/moonpixels/propulsion.git"
+    },
+    "files": [
+        ".opencode/package.json",
+        ".opencode/plugins/propulsion.js",
+        "skills",
+        "additional/commands",
+        "additional/skills",
+        "README.md",
+        "additional/README.md"
+    ],
     "type": "module",
-    "main": ".opencode/plugins/propulsion.ts",
+    "main": "./.opencode/plugins/propulsion.js",
+    "exports": {
+        ".": "./.opencode/plugins/propulsion.js"
+    },
     "scripts": {
         "checks": "bun run lint && bun run format && bun run test",
         "format": "oxfmt .",
         "format:check": "oxfmt --check .",
-        "lint": "oxlint && bun run typecheck",
+        "lint": "oxlint",
         "test": "bun test ./tests && bash tests/opencode/run-tests.sh",
         "test:opencode": "bash tests/opencode/run-tests.sh",
-        "test:unit": "bun test ./tests",
-        "typecheck": "tsc --noEmit"
+        "test:unit": "bun test ./tests"
     },
     "dependencies": {
         "@opencode-ai/plugin": "^1.4.0"
     },
     "devDependencies": {
-        "@types/node": "^25.5.2",
         "oxfmt": "^0.44.0",
         "oxlint": "^1.59.0",
-        "oxlint-tsgolint": "^0.20.0",
-        "typescript": "^6.0.2"
+        "oxlint-tsgolint": "^0.20.0"
     },
     "packageManager": "bun@1.3.11"
 }

tests/opencode/test-skill-loading.sh

@@ -3,62 +3,29 @@ set -euo pipefail
 
 REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 
-child_pids() {
-    ps -ax -o pid=,ppid= | awk -v parent="$1" '$2 == parent { print $1 }'
-}
-
-kill_descendants() {
-    local child
-
-    for child in $(child_pids "$1"); do
-        kill_descendants "$child"
-        kill "$child" 2>/dev/null || true
-    done
-}
-
 skills_output="$(mktemp)"
 pure_output="$(mktemp)"
-trap 'rm -f "$skills_output" "$pure_output"' EXIT
+config_home="$(mktemp -d)"
+trap 'rm -f "$skills_output" "$pure_output"; rm -rf "$config_home"' EXIT
 
 cd "$REPO_ROOT"
-(script -q "$skills_output" opencode debug skill | /bin/cat >/dev/null) &
-skills_pid=$!
-
-attempt=0
-while [ "$attempt" -lt 20 ]; do
-    if /usr/bin/grep -a -q '"name": "propulsion-workflow"' "$skills_output"; then
-        break
-    fi
-
-    sleep 1
-    attempt=$((attempt + 1))
-done
-
-kill "$skills_pid" 2>/dev/null || true
-kill_descendants "$skills_pid"
-wait "$skills_pid" 2>/dev/null || true
-
-(script -q "$pure_output" opencode debug skill --pure | /bin/cat >/dev/null) &
-pure_pid=$!
-sleep 2
-kill "$pure_pid" 2>/dev/null || true
-kill_descendants "$pure_pid"
-wait "$pure_pid" 2>/dev/null || true
-
 workflow_skill='"name": "propulsion-workflow"'
 workflow_path="$REPO_ROOT/skills/propulsion-workflow/SKILL.md"
 
-if ! /usr/bin/grep -a -q "$workflow_skill" "$skills_output"; then
+XDG_CONFIG_HOME="$config_home" opencode debug skill >"$skills_output" 2>&1
+XDG_CONFIG_HOME="$config_home" opencode debug skill --pure >"$pure_output" 2>&1
+
+if ! /usr/bin/grep -F -a -q "$workflow_skill" "$skills_output"; then
     echo "Expected propulsion-workflow skill in plugin-backed skill list"
     exit 1
 fi
 
-if ! /usr/bin/grep -a -q "$workflow_path" "$skills_output"; then
+if ! /usr/bin/grep -F -a -q "$workflow_path" "$skills_output"; then
     echo "Expected propulsion-workflow skill path in plugin-backed skill list"
     exit 1
 fi
 
-if /usr/bin/grep -a -q "$workflow_skill" "$pure_output"; then
+if /usr/bin/grep -F -a -q "$workflow_skill" "$pure_output"; then
     echo "Pure skill listing should not expose propulsion-workflow"
     exit 1
 fi

tests/propulsion-plugin.test.js

@@ -1,8 +1,11 @@
 import { describe, expect, test } from 'bun:test';
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { PropulsionPlugin } from '../.opencode/plugins/propulsion.ts';
+import { PropulsionPlugin } from '../.opencode/plugins/propulsion.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(__dirname, '..');
@@ -107,3 +110,83 @@ describe('PropulsionPlugin transform', () => {
         ).toHaveLength(1);
     });
 });
+
+describe('published package contract', () => {
+    test('imports from node_modules under plain Node after npm pack', () => {
+        const tempRoot = fs.mkdtempSync(
+            path.join(os.tmpdir(), 'propulsion-plugin-test-'),
+        );
+        const packDir = path.join(tempRoot, 'pack');
+
+        try {
+            fs.mkdirSync(packDir);
+
+            const tarballName = execFileSync(
+                'npm',
+                ['pack', '--quiet', '--pack-destination', packDir],
+                {
+                    cwd: repoRoot,
+                    encoding: 'utf8',
+                },
+            ).trim();
+            const tarballPath = path.join(packDir, tarballName);
+            const appDir = path.join(tempRoot, 'app');
+
+            fs.mkdirSync(appDir);
+
+            execFileSync('npm', ['init', '-y'], {
+                cwd: appDir,
+                stdio: 'ignore',
+            });
+            execFileSync('npm', ['install', tarballPath], {
+                cwd: appDir,
+                stdio: 'ignore',
+            });
+
+            const output = execFileSync(
+                'node',
+                [
+                    '--input-type=module',
+                    '-e',
+                    "import('propulsion').then(() => console.log('IMPORT_OK'))",
+                ],
+                {
+                    cwd: appDir,
+                    encoding: 'utf8',
+                },
+            );
+
+            expect(output).toContain('IMPORT_OK');
+        } finally {
+            fs.rmSync(tempRoot, { recursive: true, force: true });
+        }
+    }, 30000);
+
+    test('opencode smoke test ignores ambient global config', () => {
+        const tempRoot = fs.mkdtempSync(
+            path.join(os.tmpdir(), 'propulsion-opencode-config-test-'),
+        );
+
+        try {
+            const configDir = path.join(tempRoot, 'config', 'opencode');
+            fs.mkdirSync(configDir, { recursive: true });
+            fs.writeFileSync(
+                path.join(configDir, 'opencode.json'),
+                '{ invalid json\n',
+            );
+
+            expect(() =>
+                execFileSync('bash', ['tests/opencode/test-skill-loading.sh'], {
+                    cwd: repoRoot,
+                    env: {
+                        ...process.env,
+                        XDG_CONFIG_HOME: path.join(tempRoot, 'config'),
+                    },
+                    stdio: 'pipe',
+                }),
+            ).not.toThrow();
+        } finally {
+            fs.rmSync(tempRoot, { recursive: true, force: true });
+        }
+    }, 30000);
+});