@opellen/opengoal 1.0.3 → 1.0.5

package/README.ja.md

@@ -332,13 +332,13 @@ AI:  ✓ サブゴールをアーカイブしました。Goal Aに戻ります
 
 - [Planura](https://github.com/opellen/Planura) — ネイティブなダイレクトモデリング3Dアプリケーション(C++20 / Qt 6 / OpenGL): half-edgeジオメトリカーネル、CSGソリッドモデリング、推論駆動の描画を、専用フレームワーク [Ordo](https://github.com/opellen/Ordo) の上に実装。
 - [Ordo](https://github.com/opellen/Ordo) — Planura から切り出された C++20 の型付きイベント・アプリケーションフレームワークです。イベントはただの構造体で、型がアイデンティティ、フィールドがペイロードです。
+- [OrdoStateDesigner](https://github.com/opellen/OrdoStateDesigner) — Ordo の上に構築したステートチャート・デザイナー(C++20 / Qt 6)です。キャンバスに状態機械を描き、その場でシミュレートし、それを動かす C++ を生成します。
 - リバースエンジニアリングのキャンペーン — OpenGoalが設計された本来の領域であり、ゴールは大きく、道筋は不明で、進捗が細かく分割できるかどうかにかかっています。
 
 **アプリケーションとツール**
 
 - [SeedNote](https://github.com/opellen/Seed-Note) — Android向けの構造化ブロックエディタ(Kotlin / Jetpack Compose)
 - [ScreenUse](https://github.com/opellen/Screen-Use) — 実際のアプリを操作・記録する、シナリオ駆動のUIリプレイ&検証ツール
-- [OpenIllust](https://github.com/opellen/OpenIllust) — Claude Code と Codex のためのキャンペーン駆動型 AI ベクター素材制作ツールです。このリポジトリのロゴ一式も OpenIllust で制作しました。
 
 **特化ツール**
 

package/README.ko.md

@@ -333,6 +333,8 @@ AI:  ✓ 서브골 아카이브 완료. Goal A로 복귀 — 포인터 태스크
   자체 프레임워크인 [Ordo](https://github.com/opellen/Ordo) 기반으로 구현했습니다.
 - [Ordo](https://github.com/opellen/Ordo) — Planura에서 추출된 C++20용 타입 이벤트 애플리케이션 프레임워크입니다.
   이벤트는 평범한 구조체이며, 타입이 곧 정체성이고 필드가 곧 페이로드입니다.
+- [OrdoStateDesigner](https://github.com/opellen/OrdoStateDesigner) — Ordo 기반의 상태차트 디자이너입니다
+  (C++20 / Qt 6). 캔버스에 상태 머신을 그리고, 실시간으로 시뮬레이션하고, 그것을 실행하는 C++ 코드를 생성합니다.
 - 리버스엔지니어링 캠페인 — OpenGoal이 처음 고안된 도메인입니다. 목표는 거대하고 길은
   보이지 않아서, 목표를 잘게 쪼갤 수 있을 때에만 전진할 수 있는 영역입니다.
 
@@ -340,8 +342,6 @@ AI:  ✓ 서브골 아카이브 완료. Goal A로 복귀 — 포인터 태스크
 
 - [SeedNote](https://github.com/opellen/Seed-Note) — Android용 구조화 블록 에디터 (Kotlin / Jetpack Compose)
 - [ScreenUse](https://github.com/opellen/Screen-Use) — 시나리오 기반 UI 재생 및 검증 도구 (실제 앱을 구동해 녹화)
-- [OpenIllust](https://github.com/opellen/OpenIllust) — Claude Code와 Codex를 위한 캠페인 기반 AI 벡터 에셋 제작
-  도구입니다. 이 저장소의 로고 세트도 OpenIllust로 제작했습니다.
 
 **집중형 도구**
 

package/README.md

@@ -341,6 +341,8 @@ That range is the point.
   drawing, on [Ordo](https://github.com/opellen/Ordo), its purpose-built application framework.
 - [Ordo](https://github.com/opellen/Ordo) — a typed-event application framework for C++20, extracted from
   Planura. An event is a plain struct: the type is the identity, the fields are the payload.
+- [OrdoStateDesigner](https://github.com/opellen/OrdoStateDesigner) — a statechart designer built on Ordo
+  (C++20 / Qt 6): draw a state machine on a canvas, simulate it live, and generate the C++ that runs it.
 - Reverse-engineering campaigns — the domain OpenGoal was designed in, where the goal is
   large, the path is unknown, and progress depends on splitting it finely.
 
@@ -348,8 +350,6 @@ That range is the point.
 
 - [SeedNote](https://github.com/opellen/Seed-Note) — a structured block editor for Android (Kotlin / Jetpack Compose)
 - [ScreenUse](https://github.com/opellen/Screen-Use) — a scenario-driven UI replay and verification tool that drives a real app and records it
-- [OpenIllust](https://github.com/opellen/OpenIllust) — campaign-driven AI vector asset production for Claude Code and
-  Codex; the logo set in this repository was produced with it
 
 **Focused tools**
 

package/README.zh-CN.md

@@ -356,6 +356,8 @@ AI:  ✓ sub-goal 已归档。回到目标 A —— 对应的指针任务已勾
   绘图，构建在自研框架 [Ordo](https://github.com/opellen/Ordo) 之上。
 - [Ordo](https://github.com/opellen/Ordo) — 从 Planura 中提取出来的 C++20 类型化事件应用框架。
   事件就是一个普通的结构体：类型即身份，字段即载荷。
+- [OrdoStateDesigner](https://github.com/opellen/OrdoStateDesigner) — 构建在 Ordo 之上的状态图设计器
+  （C++20 / Qt 6）：在画布上绘制状态机，实时模拟，并生成运行它的 C++ 代码。
 - 逆向工程项目 — OpenGoal 最初就是为这类场景设计的：目标庞大、路径未知，
   进展全靠把任务拆得足够细。
 
@@ -363,8 +365,6 @@ AI:  ✓ sub-goal 已归档。回到目标 A —— 对应的指针任务已勾
 
 - [SeedNote](https://github.com/opellen/Seed-Note) — 一款面向 Android 的结构化块编辑器（Kotlin / Jetpack Compose）
 - [ScreenUse](https://github.com/opellen/Screen-Use) — 一款场景驱动的 UI 回放与验证工具，能驱动真实应用并录制过程
-- [OpenIllust](https://github.com/opellen/OpenIllust) — 面向 Claude Code 与 Codex 的、以 campaign 为单位的 AI
-  矢量素材生产工具。本仓库的 logo 套件正是用它制作的。
 
 **专注型工具**
 

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.5",
   "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"
   }
-}
+}