goalbuddy 0.2.13 → 0.2.15

package/.agents/plugins/marketplace.json

@@ -11,7 +11,7 @@
         "path": "./plugins/goalbuddy"
       },
       "policy": {
-        "installation": "AVAILABLE",
+        "installation": "INSTALLED_BY_DEFAULT",
         "authentication": "ON_INSTALL"
       },
       "category": "Coding"

package/README.md

@@ -22,7 +22,13 @@ GoalBuddy is a local Codex companion for work that is too broad to trust to a si
 npx goalbuddy
 ```
 
-Then invoke the installed skill inside Codex:
+Or install it globally:
+
+```bash
+npm i -g goalbuddy
+```
+
+Then restart Codex and invoke the installed skill:
 
 ```text
 $goalbuddy
@@ -72,10 +78,17 @@ The default agents are installed with the skill:
 
 ## Install And Check Readiness
 
-Install or refresh the Codex skill and bundled agents:
+Install and enable the native Codex plugin:
 
 ```bash
 npx goalbuddy
+npm i -g goalbuddy
+```
+
+Use the skill-only fallback if your Codex build does not support plugins:
+
+```bash
+npx goalbuddy install
 npx goalbuddy update
 ```
 
@@ -102,10 +115,10 @@ npx goalbuddy doctor
 Use a non-default Codex home:
 
 ```bash
-npx goalbuddy install --codex-home /path/to/.codex
+npx goalbuddy --codex-home /path/to/.codex
 ```
 
-`install`, `update`, and `doctor` also support `--json` when an agent or script needs structured output.
+`plugin install`, `install`, `update`, and `doctor` also support `--json` when an agent or script needs structured output.
 
 ## Run A Goal
 

package/internal/cli/goal-maker.mjs

@@ -36,6 +36,7 @@ const optionsWithValues = new Set([
   "--catalog-url",
   "--codex-home",
   "--kind",
+  "--source",
 ]);
 
 const args = process.argv.slice(2);
@@ -43,7 +44,7 @@ const command = args[0] === "--help" || args[0] === "-h"
   ? "help"
   : args[0] && !args[0].startsWith("-")
     ? args[0]
-    : "install";
+    : "default";
 const invokedAs = invokedCommandName();
 
 main().catch((error) => {
@@ -54,6 +55,9 @@ main().catch((error) => {
 async function main() {
   maybePrintLegacyNotice();
   switch (command) {
+    case "default":
+      installPlugin();
+      break;
     case "install":
     case "update":
       await installAll();
@@ -64,6 +68,9 @@ async function main() {
     case "doctor":
       doctor();
       break;
+    case "plugin":
+      plugin();
+      break;
     case "extend":
       await extend();
       break;
@@ -129,6 +136,8 @@ function usage() {
   console.log(`Codex ${canonicalProductName}
 
 Usage:
+  ${canonicalCliName} [--codex-home <path>] [--json]
+  ${canonicalCliName} plugin install [--source <marketplace-source>] [--codex-home <path>] [--json]
   ${canonicalCliName} install [--codex-home <path>] [--force] [--json]
   ${canonicalCliName} update [--codex-home <path>] [--json]
   ${canonicalCliName} agents [--codex-home <path>] [--force]
@@ -140,7 +149,10 @@ Usage:
   ${canonicalCliName} extend doctor [<id>] [--codex-home <path>] [--json]
 
 Default:
-  ${canonicalCliName}  Installs the skill and bundled agent definitions.
+  ${canonicalCliName}  Installs and enables the native Codex plugin.
+
+Skill-only fallback:
+  ${canonicalCliName} install  Installs the legacy skill payload and bundled agent definitions.
 
 Compatibility:
   ${legacyCliName} remains a temporary alias and prints the new npx command for human-facing use.
@@ -321,6 +333,123 @@ function doctor() {
   process.exit(installOk && goalReadyOk ? 0 : 1);
 }
 
+function plugin() {
+  const subcommand = positional(1) || "";
+  switch (subcommand) {
+    case "install":
+      installPlugin();
+      break;
+    case "help":
+    case "--help":
+    case "-h":
+      pluginUsage();
+      break;
+    default:
+      console.error(`Unknown plugin command: ${subcommand || "<missing>"}`);
+      pluginUsage();
+      process.exit(2);
+  }
+}
+
+function pluginUsage() {
+  console.log(`${canonicalProductName} Plugin
+
+Usage:
+  ${canonicalCliName} plugin install [--source <marketplace-source>] [--codex-home <path>] [--json]
+
+Default source:
+  tolibear/goalbuddy
+`);
+}
+
+function installPlugin() {
+  const source = optionValue("--source") || "tolibear/goalbuddy";
+  const pluginSource = join(packageRoot, "plugins", canonicalSkillName);
+  const pluginManifestPath = join(pluginSource, ".codex-plugin", "plugin.json");
+  if (!existsSync(pluginManifestPath)) {
+    throw new Error(`Plugin manifest not found: ${pluginManifestPath}`);
+  }
+
+  const pluginManifest = JSON.parse(readFileSync(pluginManifestPath, "utf8"));
+  const pluginCachePath = pluginCacheRoot(pluginManifest.version);
+  const marketplace = runCodex(["plugin", "marketplace", "add", source]);
+  if (!marketplace.ok) {
+    throw new Error(`Failed to add Codex plugin marketplace: ${firstLine(marketplace.stderr || marketplace.stdout)}`);
+  }
+
+  mkdirSync(dirname(pluginCachePath), { recursive: true });
+  rmSync(pluginCachePath, { recursive: true, force: true });
+  cpSync(pluginSource, pluginCachePath, { recursive: true });
+  const configPath = enablePluginConfig();
+
+  const report = {
+    installed: true,
+    plugin: `${canonicalSkillName}@${canonicalSkillName}`,
+    version: pluginManifest.version,
+    codex_home: codexHome(),
+    marketplace_source: source,
+    cache_path: pluginCachePath,
+    config_path: configPath,
+  };
+
+  if (hasFlag("--json")) {
+    printJson(report);
+    return;
+  }
+
+  console.log(`Installed ${canonicalProductName} Codex plugin ${pluginManifest.version}`);
+  console.log(`Marketplace: ${source}`);
+  console.log(`Cache: ${pluginCachePath}`);
+  console.log(`Config: ${configPath}`);
+  console.log("");
+  console.log("Restart Codex, then use:");
+  console.log(`  $${canonicalSkillName}`);
+}
+
+function pluginCacheRoot(version) {
+  return join(codexHome(), "plugins", "cache", canonicalSkillName, canonicalSkillName, version);
+}
+
+function enablePluginConfig() {
+  const configPath = join(codexHome(), "config.toml");
+  mkdirSync(dirname(configPath), { recursive: true });
+  const header = `[plugins."${canonicalSkillName}@${canonicalSkillName}"]`;
+  const existing = existsSync(configPath) ? readFileSync(configPath, "utf8") : "";
+  const updated = upsertTomlEnabled(existing, header);
+  writeFileSync(configPath, updated);
+  return configPath;
+}
+
+function upsertTomlEnabled(text, header) {
+  const normalized = text.endsWith("\n") || text.length === 0 ? text : `${text}\n`;
+  const lines = normalized.split("\n");
+  const start = lines.findIndex((line) => line.trim() === header);
+  if (start === -1) {
+    const prefix = normalized.trim() ? `${normalized}\n` : "";
+    return `${prefix}${header}\nenabled = true\n`;
+  }
+
+  let end = lines.length;
+  for (let index = start + 1; index < lines.length; index += 1) {
+    if (/^\s*\[/.test(lines[index])) {
+      end = index;
+      break;
+    }
+  }
+
+  let sawEnabled = false;
+  for (let index = start + 1; index < end; index += 1) {
+    if (/^\s*enabled\s*=/.test(lines[index])) {
+      lines[index] = "enabled = true";
+      sawEnabled = true;
+      break;
+    }
+  }
+  if (!sawEnabled) lines.splice(start + 1, 0, "enabled = true");
+
+  return lines.join("\n").replace(/\n*$/, "\n");
+}
+
 function codexGoalRuntimeStatus() {
   const version = runCodex(["--version"]);
   const login = version.ok ? runCodex(["login", "status"]) : { ok: false, stdout: "", stderr: "codex CLI unavailable" };

package/internal/cli/postinstall.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, "goal-maker.mjs");
+const globalInstall = process.env.npm_config_global === "true"
+  || process.env.npm_config_location === "global";
+
+if (!globalInstall || process.env.GOALBUDDY_SKIP_POSTINSTALL) {
+  process.exit(0);
+}
+
+const result = spawnSync(process.execPath, [cliPath, "plugin", "install"], {
+  encoding: "utf8",
+  env: process.env,
+  stdio: "inherit",
+});
+
+if (result.status === 0) {
+  process.exit(0);
+}
+
+console.error("");
+console.error("GoalBuddy installed globally, but Codex plugin setup did not complete.");
+console.error("Run this after Codex is available:");
+console.error("  goalbuddy");
+process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Turn open-ended Codex goals into a GoalBuddy Scout/Judge/Worker board with receipts, verification, and optional extensions.",
   "type": "module",
   "bin": {
@@ -21,9 +21,10 @@
     "goalbuddy/templates"
   ],
   "scripts": {
-    "check": "node --check internal/cli/goal-maker.mjs goalbuddy/scripts/*.mjs && node --test internal/test/*.test.mjs",
+    "check": "node --check internal/cli/*.mjs goalbuddy/scripts/*.mjs && node --test internal/test/*.test.mjs",
     "test": "node --test internal/test/*.test.mjs",
     "pack:dry-run": "npm pack --dry-run",
+    "postinstall": "node internal/cli/postinstall.mjs",
     "publish:check": "node internal/cli/check-publish-version.mjs && npm run pack:dry-run",
     "prepublishOnly": "node internal/cli/check-publish-version.mjs"
   },

package/plugins/goalbuddy/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Turn broad Codex work into verified GoalBuddy boards with Scout, Judge, Worker, receipts, and optional extensions.",
   "author": {
     "name": "tolibear",

package/plugins/goalbuddy/README.md

@@ -19,18 +19,24 @@ npx goalbuddy doctor
 
 ## Native Codex Install
 
-Add the repository as a Codex plugin marketplace:
+Install and enable GoalBuddy:
 
 ```bash
-codex plugin marketplace add tolibear/goalbuddy
+npx goalbuddy
 ```
 
-Then enable the `goalbuddy` plugin from that marketplace in Codex. The npm CLI remains useful for `doctor`, project-local agent setup, and optional GoalBuddy extension management.
+Or install the npm package globally:
+
+```bash
+npm i -g goalbuddy
+```
+
+The marketplace manifest is included for Codex discovery, but current Codex CLI builds only register the marketplace with `codex plugin marketplace add`; the npm CLI also caches and enables the plugin.
 
 For local CLI testing before npm publish:
 
 ```bash
-node internal/cli/goal-maker.mjs install --catalog-url extend/catalog.json
+node internal/cli/goal-maker.mjs --catalog-url extend/catalog.json
 node internal/cli/goal-maker.mjs doctor
 ```