goalbuddy 0.2.17 → 0.2.19

package/README.md

@@ -82,7 +82,19 @@ Install and enable the native Codex plugin:
 
 ```bash
 npx goalbuddy
+```
+
+Restart Codex, then use `$goal-prep`. To add the optional extension bundle:
+
+```bash
+npx goalbuddy extend install --all
+```
+
+If you prefer a global executable, install the npm package globally and run `goalbuddy`:
+
+```bash
 npm i -g goalbuddy
+goalbuddy
 ```
 
 Use the skill-only fallback if your Codex build does not support plugins:
@@ -175,7 +187,7 @@ npx goalbuddy extend install --all --dry-run
 npx goalbuddy extend install --all
 ```
 
-`goalbuddy extend` shows available extensions plus local install state, activation state, credential requirements, safe-by-default status, and missing environment variables.
+`goalbuddy extend` shows available extensions and detail commands. `goalbuddy extend <id>` shows local install state, activation state, credential requirements, safe-by-default status, and missing environment variables.
 
 Current catalog examples include:
 

package/internal/cli/goal-maker.mjs

@@ -572,17 +572,9 @@ async function extendCatalog() {
   for (const extension of extensions) {
     console.log(extension.name || extension.id);
     if (extension.summary) console.log(`  ${extension.summary}`);
-    console.log(`  id: ${extension.id}`);
-    console.log(`  kind: ${extension.kind} | activation: ${extension.activation || "unspecified"}`);
-    console.log(`  state: ${extension.state.installed ? "installed" : "available"} | configured: ${extension.state.configured ? "yes" : "no"}`);
-    console.log(`  safe by default: ${extension.safe_by_default ? "yes" : "no"} | requires approval: ${extension.requires_approval ? "yes" : "no"}`);
-    if (extension.state.missing_env.length) {
-      console.log(`  missing env: ${extension.state.missing_env.join(", ")}`);
-    }
+    console.log(`  Details: npx ${canonicalCliName} extend ${extension.id}`);
     console.log("");
   }
-  console.log("View details:");
-  console.log(`  npx ${canonicalCliName} extend ${extensions[0].id}`);
   console.log("Install all:");
   console.log(`  npx ${canonicalCliName} extend install --all`);
 }
@@ -803,12 +795,34 @@ function installedSkillRoot() {
   return join(codexHome(), "skills", canonicalSkillDirectory);
 }
 
+function installedPluginSkillRoot() {
+  const root = join(codexHome(), "plugins", "cache", pluginName, pluginName);
+  if (!existsSync(root)) return "";
+  const versions = readdirSync(root, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort(compareVersions)
+    .reverse();
+  for (const version of versions) {
+    const skillPath = join(root, version, "skills", canonicalSkillDirectory);
+    if (existsSync(join(skillPath, "SKILL.md"))) return skillPath;
+  }
+  return "";
+}
+
+function activeSkillRoot() {
+  if (existsSync(join(installedSkillRoot(), "SKILL.md"))) return installedSkillRoot();
+  const pluginSkillRoot = installedPluginSkillRoot();
+  if (pluginSkillRoot) return pluginSkillRoot;
+  return installedSkillRoot();
+}
+
 function legacyInstalledSkillRoot() {
   return join(codexHome(), "skills", legacySkillName);
 }
 
 function extendRoot() {
-  return join(installedSkillRoot(), "extend");
+  return join(activeSkillRoot(), "extend");
 }
 
 function extensionTarget(id) {
@@ -1109,9 +1123,20 @@ function summarizeStatuses(items) {
 }
 
 function assertSkillInstalledForExtensionInstall() {
-  if (!existsSync(join(installedSkillRoot(), "SKILL.md"))) {
-    throw new Error(`${canonicalProductName} skill is not installed at ${installedSkillRoot()}. Run: npx ${canonicalCliName}`);
+  if (!existsSync(join(activeSkillRoot(), "SKILL.md"))) {
+    throw new Error(`${canonicalProductName} skill is not installed. Run: npx ${canonicalCliName}`);
+  }
+}
+
+function compareVersions(left, right) {
+  const leftParts = left.split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const rightParts = right.split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index += 1) {
+    const diff = (leftParts[index] || 0) - (rightParts[index] || 0);
+    if (diff !== 0) return diff;
   }
+  return left.localeCompare(right);
 }
 
 function installedExtensions() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "description": "Turn open-ended Codex goals into a GoalBuddy Scout/Judge/Worker board with receipts, verification, and optional extensions.",
   "type": "module",
   "bin": {

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

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "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

@@ -25,10 +25,17 @@ Install and enable GoalBuddy:
 npx goalbuddy
 ```
 
+Restart Codex, then use `$goal-prep`. Optional extensions can be installed with:
+
+```bash
+npx goalbuddy extend install --all
+```
+
 Or install the npm package globally:
 
 ```bash
 npm i -g goalbuddy
+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.