@opellen/opengoal 1.0.3 → 1.0.4

package/dist/platforms/codex.js

@@ -1,7 +1,29 @@
+import { dirname } from "node:path";
+const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+// Codex labels a skill from agents/openai.yaml when present; without it the
+// label is derived from the frontmatter name with the casing flattened
+// ("opengoal:go" shows as "Opengoal: Go").
+const commandLabel = (name) => `OpenGoal: ${capitalize(name)}`;
+function displayName(target) {
+    return target.kind === "command"
+        ? commandLabel(target.name)
+        : `OpenGoal ${capitalize(target.name.replace(/^opengoal-/, ""))}`;
+}
 export const codex = {
     id: "codex",
     displayName: "Codex",
     configDir: ".codex",
     commandPath: (name, prefix) => `.codex/skills/${prefix}-${name}/SKILL.md`,
     formatCommand: (body) => body,
+    // Skills are invoked from Codex's picker, so prose refers to them by the
+    // label the picker shows, not by a slash form.
+    commandRef: (name) => commandLabel(name),
+    companionFiles: (target) => [
+        {
+            dst: `${dirname(target.dst).replace(/\\/g, "/")}/agents/openai.yaml`,
+            content: "interface:\n" +
+                `  display_name: ${JSON.stringify(displayName(target))}\n` +
+                `  short_description: ${JSON.stringify(target.description)}\n`,
+        },
+    ],
 };

package/dist/platforms/types.d.ts

@@ -4,6 +4,21 @@ export interface CommandMeta {
     category?: string;
     tags?: string[];
 }
+/** An extra file a platform wants installed next to a command or skill. */
+export interface CompanionFile {
+    /** Install path relative to the project root. */
+    dst: string;
+    content: string;
+}
+export interface CompanionTarget {
+    kind: "command" | "skill";
+    /** Command name ("go") or skill name ("opengoal-flow"). */
+    name: string;
+    description: string;
+    /** Install path of the file the companions accompany. */
+    dst: string;
+    prefix: string;
+}
 export interface PlatformAdapter {
     id: string;
     displayName: string;
@@ -15,5 +30,18 @@ export interface PlatformAdapter {
     supportsCommands?: boolean;
     commandPath(name: string, prefix: string): string;
     formatCommand(body: string, meta: CommandMeta, prefix: string): string;
+    /**
+     * How an installed command is invoked on this platform, as written in the
+     * prose that templates emit ("run /opgl:go"). Platforms whose invocation
+     * differs from the Claude Code slash form `/<prefix>:<name>` override this;
+     * when omitted that form is used.
+     */
+    commandRef?(name: string, prefix: string): string;
+    /**
+     * Extra files the platform needs beside an installed command or skill, such
+     * as Codex's `agents/openai.yaml` display manifest. They are installed and
+     * uninstalled together with the file they accompany.
+     */
+    companionFiles?(target: CompanionTarget): CompanionFile[];
 }
 export declare const DEFAULT_PLATFORM = "claude";

package/dist/templates.d.ts

@@ -15,6 +15,8 @@ export interface TemplateEntry {
     adapter: PlatformAdapter;
     meta: CommandMeta;
     rawContent: string;
+    /** Companion file produced by the adapter; rawContent is final, no rendering. */
+    generated?: boolean;
 }
 export declare function resolveTemplates(config: OpenGoalConfig): TemplateEntry[];
 export declare function renderFile(entry: TemplateEntry, config: OpenGoalConfig): string;

package/dist/templates.js

@@ -18,6 +18,18 @@ const OPENGOAL_VERSION = (() => {
     }
 })();
 export const DEFAULT_PREFIX = "opgl";
+function companionEntries(adapter, target, meta) {
+    if (!adapter.companionFiles)
+        return [];
+    return adapter.companionFiles(target).map((file) => ({
+        src: `generated/${target.kind}/${target.name}`,
+        dst: file.dst,
+        adapter,
+        meta,
+        rawContent: file.content,
+        generated: true,
+    }));
+}
 const COMMAND_TEMPLATES = [
     "scout", "goal", "context", "design",
     "roadmap", "verify", "recap", "overview", "go",
@@ -64,32 +76,36 @@ export function resolveTemplates(config) {
     for (const adapter of adapters) {
         if (adapter.supportsCommands !== false) {
             for (const { cmd, src, rawContent, meta } of commandMetas) {
-                entries.push({ src, dst: adapter.commandPath(cmd, config.prefix), adapter, meta, rawContent });
+                const dst = adapter.commandPath(cmd, config.prefix);
+                entries.push({ src, dst, adapter, meta, rawContent });
+                entries.push(...companionEntries(adapter, { kind: "command", name: cmd, description: meta.description, dst, prefix: config.prefix }, meta));
             }
         }
         for (const skill of skillContents) {
-            entries.push({
-                src: skill.src,
-                dst: skillInstallPath(adapter, skill.skillName),
-                adapter,
-                meta: { name: skill.skillName, description: "" },
-                rawContent: skill.rawContent,
-            });
+            const dst = skillInstallPath(adapter, skill.skillName);
+            const description = skill.rawContent.replace(/\r\n/g, "\n").match(/^description:\s*(.+)$/m)?.[1]?.trim() ?? "";
+            const meta = { name: skill.skillName, description };
+            entries.push({ src: skill.src, dst, adapter, meta, rawContent: skill.rawContent });
+            entries.push(...companionEntries(adapter, { kind: "skill", name: skill.skillName, description, dst, prefix: config.prefix }, meta));
         }
     }
     return entries;
 }
 export function renderFile(entry, config) {
+    if (entry.generated)
+        return entry.rawContent;
     const content = entry.rawContent.replace(/\r\n/g, "\n");
     const rendered = renderTemplate(content, {
         conditions: {
             subagent: config.subagent,
         },
     });
+    const commandRef = entry.adapter.commandRef ?? ((name, prefix) => `/${prefix}:${name}`);
     const substituted = rendered
         .replace(/\$DocsDir/g, config.docsDir)
         .replace(/\$CodebaseDir/g, config.codebaseDir)
         .replace(/\$OpenGoalVersion/g, OPENGOAL_VERSION)
+        .replace(/\/\$CommandPrefix:([a-z-]+)/g, (_match, name) => commandRef(name, config.prefix))
         .replace(/\$CommandPrefix/g, config.prefix);
     if (entry.src.startsWith("skills/")) {
         return formatSkill(substituted);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opellen/opengoal",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Goal-centric AI harness. Plain markdown, zero runtime — nothing runs but your agent.",
   "type": "module",
   "license": "MIT",
@@ -48,4 +48,4 @@
     "chalk": "^5.6.2",
     "yaml": "^2.8.3"
   }
-}
+}