open-wiki-spec 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-06-01
+
+### Added
+- **Codex compatibility.** `ows init` now generates OpenAI Codex integration alongside
+  Claude Code: `.agents/skills/ows-*/SKILL.md` skills (one per workflow) plus an
+  idempotent, clearly-marked `AGENTS.md` managed block. The Codex skills shell out to
+  the same `ows` CLI and carry no Claude-specific syntax (`$ows-*` invocation, no
+  `/ows-*` slash refs).
+- **`ows init --agent claude|codex|both|auto`** selector (default `auto`). Auto-detect
+  uses project markers (`.claude/`, `CLAUDE.md` → Claude; `.codex/`, `.agents/`,
+  `AGENTS.md` → Codex), then host signals, then falls back to Claude. Fully
+  backward-compatible: Claude-only projects produce byte-identical output to 0.3.x.
+
+### Changed
+- Refactored the init delivery layer into an agent-neutral adapter architecture
+  (`WORKFLOW_DEFINITIONS` is the single source of truth; `ClaudeAdapter` /
+  `CodexAdapter` render it). Claude command output is unchanged (verified
+  byte-for-byte). `InitResult` gains `agents` and `agentArtifacts`.
+
+### Safeguards
+- `ows init` warns when `AGENTS.override.md` shadows the generated `AGENTS.md`, and
+  when the merged `AGENTS.md` would exceed Codex's ~32 KiB `project_doc_max_bytes`.
+
 ## [0.3.1] - 2026-04-19
 
 ### Fixed

package/README.md

@@ -200,7 +200,11 @@ ows status
 ows verify
 ```
 
-`ows init` creates the vault structure and generates 12 Claude Code skill files (`.claude/commands/ows-*.md`) so you can invoke workflows directly:
+`ows init` creates the vault structure and generates agent integration files for
+whichever coding agent(s) it detects (override with `--agent claude|codex|both|auto`):
+
+- **Claude Code** → 12 slash commands in `.claude/commands/ows-*.md`
+- **Codex** → 12 skills in `.agents/skills/ows-*/SKILL.md` + an `AGENTS.md` managed block
 
 ```
 /ows-propose    /ows-continue    /ows-apply    /ows-verify
@@ -208,6 +212,33 @@ ows verify
 /ows-init       /ows-migrate     /ows-explore  /ows-onboard
 ```
 
+In Codex these same workflows are skills — mention one inline as `$ows-propose` or
+pick it from the `/skills` menu. See **[Agent runtime support](#agent-runtime-support)**.
+
+### Agent runtime support
+
+`ows` is the engine; coding agents drive it through generated integration files.
+The workflow logic is shared — only the delivery format differs per agent.
+
+| Agent | Files generated by `ows init` | How you invoke a workflow |
+|-------|-------------------------------|---------------------------|
+| **Claude Code** | `.claude/commands/ows-*.md` (12 slash commands) | `/ows-propose`, `/ows-continue`, … |
+| **Codex** | `.agents/skills/ows-*/SKILL.md` (12 skills) + `AGENTS.md` block | `$ows-propose` inline, the `/skills` menu, or implicit selection |
+
+`ows init` auto-detects which agent(s) to generate for:
+
+- **Project markers** first — `.claude/` or `CLAUDE.md` → Claude; `.codex/`, `.agents/`, or `AGENTS.md` → Codex.
+- Otherwise, whichever agent is installed on your machine.
+- Otherwise, Claude Code.
+
+Override anytime with `--agent claude|codex|both|auto` (default `auto`). The
+generated `AGENTS.md` carries an idempotent, clearly-marked block; your own content
+outside the markers is never touched. Re-running `ows init` is safe and idempotent.
+
+> **Codex note:** the skills shell out to the `ows` CLI, so run Codex in a sandbox
+> mode that permits executing it (`workspace-write` or `danger-full-access`), and make
+> sure `ows` is installed (`ows --version`).
+
 ### Vault structure
 
 ```
@@ -389,7 +420,7 @@ npm test          # 805+ tests should pass
 
 - **Semantic search improvements** — better embedding models, multilingual support
 - **Obsidian plugin** — native Obsidian integration for graph view, Dataview queries
-- **Additional agent runtime support** — Cursor, Codex, Gemini CLI adapters
+- **Additional agent runtime support** — Cursor and Gemini CLI adapters (Codex shipped in 0.4.0)
 - **Documentation** — tutorials, examples, translations
 - **Testing** — edge cases, performance benchmarks, real-world usage reports
 

package/dist/cli/commands/init.d.ts

@@ -1,3 +1,3 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
 export declare function registerInitCommand(program: Command): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD1D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKjD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8D1D"}

package/dist/cli/commands/init.js

@@ -3,6 +3,7 @@ import { handleCliError } from "./error-handler.js";
  * CLI handler for `ows init`.
  */
 import * as path from 'node:path';
+import { Option } from 'commander';
 import { initVault } from '../init/init-engine.js';
 import { jsonEnvelope } from '../json-envelope.js';
 export function registerInitCommand(program) {
@@ -11,10 +12,18 @@ export function registerInitCommand(program) {
         .description('Initialize a new open-wiki-spec vault')
         .option('--force', 'Force re-initialization, recreating meta files')
         .option('--skip-seed', 'Skip creating seed notes')
+        .addOption(new Option('--agent <agent>', 'Agent integration to generate')
+        .choices(['claude', 'codex', 'both', 'auto'])
+        .default('auto'))
         .option('--json', 'Output result as JSON')
         .action(async (targetPath, opts) => {
         try {
-            const result = await initVault({ path: targetPath, force: opts.force, skipSeed: opts.skipSeed });
+            const result = await initVault({
+                path: targetPath,
+                force: opts.force,
+                skipSeed: opts.skipSeed,
+                agent: opts.agent,
+            });
             if (opts.json) {
                 console.log(jsonEnvelope('init', result));
             }
@@ -28,7 +37,10 @@ export function registerInitCommand(program) {
                 console.log(`  Directories: ${result.directoriesCreated.length} created`);
                 console.log(`  Meta files: ${result.metaFilesCreated.length} created`);
                 console.log(`  Seed notes: ${result.seedFilesCreated.length} created`);
-                console.log(`  Skill files: ${result.skillFilesGenerated.length} generated`);
+                console.log(`  Agents: ${result.agents.join(', ')}`);
+                for (const id of result.agents) {
+                    console.log(`    ${id}: ${result.agentArtifacts[id]?.length ?? 0} files`);
+                }
                 if (result.warnings.length > 0) {
                     for (const w of result.warnings)
                         console.log(`  Warning: ${w}`);

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/agents/agents-md.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The ows-managed block injected into a project's `AGENTS.md` (Codex's always-on
+ * guidance file), plus a pure idempotent merge helper.
+ */
+export declare const BEGIN = "<!-- ows:begin (managed by open-wiki-spec; edits inside this block are overwritten) -->";
+export declare const END = "<!-- ows:end -->";
+/** Codex's combined AGENTS.md cap (`project_doc_max_bytes`, ~32 KiB). */
+export declare const AGENTS_MAX_BYTES: number;
+export declare const OWS_AGENTS_BLOCK = "<!-- ows:begin (managed by open-wiki-spec; edits inside this block are overwritten) -->\n## open-wiki-spec (ows) \u2014 agent knowledge layer\n\nThis project keeps a persistent, typed knowledge layer in `wiki/` (a markdown\n\"vault\"). Prefer reading and maintaining that vault over re-scanning the filesystem\nfrom scratch each session. The `ows` CLI is the engine; it emits structured JSON\n(`--json`) that you parse and act on.\n\n### Setup check\nRun `ows --version` before using these skills. If it is missing, install with\n`npm i -g open-wiki-spec`. Codex must run in a sandbox mode that permits executing\n`ows` (`workspace-write` or `danger-full-access`).\n\n### Golden rule (deterministic preflight)\nBefore creating any Feature or Change, ALWAYS run the preflight and act on its\n`classification`:\n```bash\nows propose \"<summary>\" --keywords \"<k1>,<k2>\" --dry-run --json\n```\nNever decide \"does something similar already exist?\" by free-form reasoning \u2014 the\nCLI is the retrieval engine. Classifications: `existing_change`, `existing_feature`,\n`new_feature`, `needs_confirmation` (stop and ask the user).\n\n### Note types\nFeature (canonical current behavior) \u00B7 Change (a unit of proposed work) \u00B7 System\n(component boundary) \u00B7 Decision (rationale) \u00B7 Source (evidence) \u00B7 Query (investigation).\n\n### Lifecycle\n`proposed -> planned -> in_progress -> applied -> (archived)`. Use `ows continue <id>`\nto advance, `ows apply <id>` to fold a Change into Feature notes, `ows verify` to\ncheck consistency (4 dimensions), `ows archive <id>` when done.\n\n### Skills (in `.agents/skills/`)\n`ows-propose`, `ows-continue`, `ows-apply`, `ows-verify`, `ows-query`,\n`ows-status`, `ows-retrieve`, `ows-archive`, `ows-init`, `ows-explore`,\n`ows-onboard`, `ows-migrate`. Mention one inline as `$ows-<name>` or pick it\nfrom `/skills`. Each skill drives the matching `ows` subcommand.\n\n### Guardrails\nAlways `--dry-run` destructive or creative steps first. Never auto-resolve\n`needs_confirmation` or `stale_base` \u2014 ask the user. Show `ows` JSON reasoning\n(classification, scores) so decisions stay explainable.\n<!-- ows:end -->\n";
+/**
+ * Insert or replace the ows managed block in an `AGENTS.md` body. Pure and
+ * convergent — any input yields a body with exactly one well-formed block.
+ *
+ * - empty existing → just the block
+ * - exactly one well-formed block → replace it IN PLACE (surrounding order kept)
+ * - no markers → append the block after the existing content
+ * - malformed/duplicate markers (BEGIN-only, END-only, END-before-BEGIN, multiple
+ *   pairs) → strip every managed region and stray marker, then append one clean block
+ *
+ * Whitespace is normalized only at the join boundaries, never across the whole
+ * document, so user-authored blank-line runs elsewhere are preserved.
+ */
+export declare function mergeAgentsMd(existing: string, block: string): string;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/cli/init/agents/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,KAAK,4FAA4F,CAAC;AAC/G,eAAO,MAAM,GAAG,qBAAqB,CAAC;AAEtC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,woEA2C5B,CAAC;AAUF;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8BrE"}

package/dist/cli/init/agents/agents-md.js

@@ -0,0 +1,100 @@
+/**
+ * The ows-managed block injected into a project's `AGENTS.md` (Codex's always-on
+ * guidance file), plus a pure idempotent merge helper.
+ */
+export const BEGIN = '<!-- ows:begin (managed by open-wiki-spec; edits inside this block are overwritten) -->';
+export const END = '<!-- ows:end -->';
+/** Codex's combined AGENTS.md cap (`project_doc_max_bytes`, ~32 KiB). */
+export const AGENTS_MAX_BYTES = 32 * 1024;
+export const OWS_AGENTS_BLOCK = `${BEGIN}
+## open-wiki-spec (ows) — agent knowledge layer
+
+This project keeps a persistent, typed knowledge layer in \`wiki/\` (a markdown
+"vault"). Prefer reading and maintaining that vault over re-scanning the filesystem
+from scratch each session. The \`ows\` CLI is the engine; it emits structured JSON
+(\`--json\`) that you parse and act on.
+
+### Setup check
+Run \`ows --version\` before using these skills. If it is missing, install with
+\`npm i -g open-wiki-spec\`. Codex must run in a sandbox mode that permits executing
+\`ows\` (\`workspace-write\` or \`danger-full-access\`).
+
+### Golden rule (deterministic preflight)
+Before creating any Feature or Change, ALWAYS run the preflight and act on its
+\`classification\`:
+\`\`\`bash
+ows propose "<summary>" --keywords "<k1>,<k2>" --dry-run --json
+\`\`\`
+Never decide "does something similar already exist?" by free-form reasoning — the
+CLI is the retrieval engine. Classifications: \`existing_change\`, \`existing_feature\`,
+\`new_feature\`, \`needs_confirmation\` (stop and ask the user).
+
+### Note types
+Feature (canonical current behavior) · Change (a unit of proposed work) · System
+(component boundary) · Decision (rationale) · Source (evidence) · Query (investigation).
+
+### Lifecycle
+\`proposed -> planned -> in_progress -> applied -> (archived)\`. Use \`ows continue <id>\`
+to advance, \`ows apply <id>\` to fold a Change into Feature notes, \`ows verify\` to
+check consistency (4 dimensions), \`ows archive <id>\` when done.
+
+### Skills (in \`.agents/skills/\`)
+\`ows-propose\`, \`ows-continue\`, \`ows-apply\`, \`ows-verify\`, \`ows-query\`,
+\`ows-status\`, \`ows-retrieve\`, \`ows-archive\`, \`ows-init\`, \`ows-explore\`,
+\`ows-onboard\`, \`ows-migrate\`. Mention one inline as \`$ows-<name>\` or pick it
+from \`/skills\`. Each skill drives the matching \`ows\` subcommand.
+
+### Guardrails
+Always \`--dry-run\` destructive or creative steps first. Never auto-resolve
+\`needs_confirmation\` or \`stale_base\` — ask the user. Show \`ows\` JSON reasoning
+(classification, scores) so decisions stay explainable.
+${END}
+`;
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function countOccurrences(haystack, needle) {
+    return haystack.split(needle).length - 1;
+}
+/**
+ * Insert or replace the ows managed block in an `AGENTS.md` body. Pure and
+ * convergent — any input yields a body with exactly one well-formed block.
+ *
+ * - empty existing → just the block
+ * - exactly one well-formed block → replace it IN PLACE (surrounding order kept)
+ * - no markers → append the block after the existing content
+ * - malformed/duplicate markers (BEGIN-only, END-only, END-before-BEGIN, multiple
+ *   pairs) → strip every managed region and stray marker, then append one clean block
+ *
+ * Whitespace is normalized only at the join boundaries, never across the whole
+ * document, so user-authored blank-line runs elsewhere are preserved.
+ */
+export function mergeAgentsMd(existing, block) {
+    const normBlock = block.trimEnd() + '\n';
+    if (!existing.trim())
+        return normBlock;
+    const begins = countOccurrences(existing, BEGIN);
+    const ends = countOccurrences(existing, END);
+    const b = existing.indexOf(BEGIN);
+    const e = existing.indexOf(END);
+    // Exactly one well-formed pair → replace in place, preserving surrounding order.
+    if (begins === 1 && ends === 1 && b !== -1 && e > b) {
+        const before = existing.slice(0, b).replace(/\s+$/, '');
+        const after = existing.slice(e + END.length).replace(/^\s+/, '');
+        const parts = [before, normBlock.trimEnd(), after].filter((p) => p.length > 0);
+        return parts.join('\n\n').replace(/\s+$/, '') + '\n';
+    }
+    // No markers at all → append after the existing content.
+    if (begins === 0 && ends === 0) {
+        return existing.replace(/\s+$/, '') + '\n\n' + normBlock;
+    }
+    // Malformed/duplicate markers → strip all managed regions + stray markers, append clean.
+    let base = existing.replace(new RegExp(escapeRe(BEGIN) + '[\\s\\S]*?' + escapeRe(END), 'g'), '');
+    base = base
+        .split('\n')
+        .filter((line) => !line.includes(BEGIN) && !line.includes(END))
+        .join('\n')
+        .replace(/\s+$/, '');
+    return base ? base + '\n\n' + normBlock : normBlock;
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/cli/init/agents/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../../../src/cli/init/agents/agents-md.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/agents/claude.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowDefinition } from '../workflow-definitions.js';
+import type { AgentAdapter, AgentArtifact } from './types.js';
+/**
+ * Renders ows workflows as Claude Code slash commands at `.claude/commands/ows-*.md`.
+ * Output is byte-identical to historical releases (transform is identity).
+ */
+export declare class ClaudeAdapter implements AgentAdapter {
+    readonly id: "claude";
+    render(defs: WorkflowDefinition[]): AgentArtifact[];
+    writeAll(projectPath: string, defs: WorkflowDefinition[]): string[];
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/cli/init/agents/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/claude.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG9D;;;GAGG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAEhC,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE;IAOnD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE;CAmBpE"}

package/dist/cli/init/agents/claude.js

@@ -0,0 +1,38 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { toClaude } from './transform.js';
+/**
+ * Renders ows workflows as Claude Code slash commands at `.claude/commands/ows-*.md`.
+ * Output is byte-identical to historical releases (transform is identity).
+ */
+export class ClaudeAdapter {
+    id = 'claude';
+    render(defs) {
+        return defs.map((d) => ({
+            path: path.join('.claude', 'commands', `${d.name}.md`),
+            contents: `---\nname: ${d.name}\ndescription: ${toClaude(d.description)}\n---\n\n${toClaude(d.body)}\n`,
+        }));
+    }
+    writeAll(projectPath, defs) {
+        const written = [];
+        for (const art of this.render(defs)) {
+            const abs = path.join(projectPath, art.path);
+            fs.mkdirSync(path.dirname(abs), { recursive: true });
+            // If an existing file was customized, back it up before overwriting.
+            if (fs.existsSync(abs)) {
+                try {
+                    const existing = fs.readFileSync(abs, 'utf-8');
+                    if (existing !== art.contents)
+                        fs.writeFileSync(`${abs}.bak`, existing);
+                }
+                catch {
+                    // best-effort backup — don't block init if read fails
+                }
+            }
+            fs.writeFileSync(abs, art.contents);
+            written.push(abs);
+        }
+        return written;
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/cli/init/agents/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../src/cli/init/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,EAAE,GAAG,QAAiB,CAAC;IAEhC,MAAM,CAAC,IAA0B;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC;YACtD,QAAQ,EAAE,cAAc,CAAC,CAAC,IAAI,kBAAkB,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;SACxG,CAAC,CAAC,CAAC;IACN,CAAC;IAED,QAAQ,CAAC,WAAmB,EAAE,IAA0B;QACtD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,qEAAqE;YACrE,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBAC/C,IAAI,QAAQ,KAAK,GAAG,CAAC,QAAQ;wBAAE,EAAE,CAAC,aAAa,CAAC,GAAG,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC1E,CAAC;gBAAC,MAAM,CAAC;oBACP,sDAAsD;gBACxD,CAAC;YACH,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/cli/init/agents/codex.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowDefinition } from '../workflow-definitions.js';
+import type { AgentAdapter, AgentArtifact } from './types.js';
+/** The `## Invocation` header prepended to every Codex skill body. Exported so tests
+ *  can assert each skill's full content by identity. */
+export declare function invocationSection(name: string): string;
+/**
+ * Renders ows workflows as OpenAI Codex skills under `.agents/skills/ows-<key>/`
+ * (one `SKILL.md` each) and maintains an idempotent ows block in `AGENTS.md`.
+ */
+export declare class CodexAdapter implements AgentAdapter {
+    readonly id: "codex";
+    render(defs: WorkflowDefinition[]): AgentArtifact[];
+    writeAll(projectPath: string, defs: WorkflowDefinition[], warnings?: string[]): string[];
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/init/agents/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/codex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI9D;wDACwD;AACxD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAE/B,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE;IAUnD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE;CA0C7F"}

package/dist/cli/init/agents/codex.js

@@ -0,0 +1,68 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { toCodex } from './transform.js';
+import { OWS_AGENTS_BLOCK, mergeAgentsMd, AGENTS_MAX_BYTES } from './agents-md.js';
+/** The `## Invocation` header prepended to every Codex skill body. Exported so tests
+ *  can assert each skill's full content by identity. */
+export function invocationSection(name) {
+    const mention = '`$' + name + '`'; // e.g. `$ows-propose`
+    return (`## Invocation\n\nImplicitly selected when your task matches the description above, ` +
+        `or invoke it explicitly: mention ${mention} inline, or pick \`${name}\` from \`/skills\`. ` +
+        `This skill drives the \`ows\` CLI - run the commands below directly.\n\n`);
+}
+/**
+ * Renders ows workflows as OpenAI Codex skills under `.agents/skills/ows-<key>/`
+ * (one `SKILL.md` each) and maintains an idempotent ows block in `AGENTS.md`.
+ */
+export class CodexAdapter {
+    id = 'codex';
+    render(defs) {
+        const arts = defs.map((d) => ({
+            path: `.agents/skills/${d.name}/SKILL.md`,
+            contents: `---\nname: ${d.name}\ndescription: ${toCodex(d.description)}\n---\n\n${invocationSection(d.name)}${toCodex(d.body)}\n`,
+        }));
+        // AGENTS.md artifact carries ONLY the managed block; writeAll merges it.
+        arts.push({ path: 'AGENTS.md', contents: OWS_AGENTS_BLOCK });
+        return arts;
+    }
+    writeAll(projectPath, defs, warnings = []) {
+        const written = [];
+        for (const art of this.render(defs)) {
+            const abs = path.join(projectPath, art.path);
+            if (art.path === 'AGENTS.md') {
+                // Safeguard: AGENTS.override.md fully supersedes AGENTS.md in Codex.
+                if (fs.existsSync(path.join(projectPath, 'AGENTS.override.md'))) {
+                    warnings.push('AGENTS.override.md exists — Codex ignores the generated AGENTS.md while it is present.');
+                }
+                const existing = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf-8') : '';
+                const merged = mergeAgentsMd(existing, art.contents);
+                if (Buffer.byteLength(merged, 'utf8') > AGENTS_MAX_BYTES) {
+                    warnings.push(`AGENTS.md exceeds ${AGENTS_MAX_BYTES} bytes — Codex may truncate it.`);
+                }
+                if (merged !== existing) {
+                    if (existing)
+                        fs.writeFileSync(`${abs}.bak`, existing);
+                    fs.writeFileSync(abs, merged);
+                    written.push(abs);
+                }
+                continue;
+            }
+            // skill files
+            fs.mkdirSync(path.dirname(abs), { recursive: true });
+            if (fs.existsSync(abs)) {
+                try {
+                    const cur = fs.readFileSync(abs, 'utf-8');
+                    if (cur !== art.contents)
+                        fs.writeFileSync(`${abs}.bak`, cur);
+                }
+                catch {
+                    // best-effort backup
+                }
+            }
+            fs.writeFileSync(abs, art.contents);
+            written.push(abs);
+        }
+        return written;
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/cli/init/agents/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../src/cli/init/agents/codex.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/agents/detect.d.ts

@@ -0,0 +1,19 @@
+import type { AgentId, AgentSelector } from './types.js';
+export interface DetectDeps {
+    /** Host-level signal provider (injectable for tests). */
+    host?: () => AgentId[];
+}
+/**
+ * Decide which agent integration(s) to generate.
+ *
+ * - explicit `claude`/`codex`/`both` → deterministic, no scan (hermetic).
+ * - `auto`/undefined → project markers first, then host signals, then `['claude']`.
+ *
+ * Directory markers (`.claude`, `.codex`, `.agents`) must be directories and file
+ * markers (`CLAUDE.md`, `AGENTS.md`) must be files, so a stray regular file named
+ * `.agents` does not mislead detection into a path the adapters can't write to.
+ *
+ * Always returns a de-duped, stable-ordered, non-empty list.
+ */
+export declare function detectAgents(projectPath: string, explicit?: AgentSelector, deps?: DetectDeps): AgentId[];
+//# sourceMappingURL=detect.d.ts.map

package/dist/cli/init/agents/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/detect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,OAAO,EAAE,CAAC;CACxB;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,EAAE,CAqB5G"}

package/dist/cli/init/agents/detect.js

@@ -0,0 +1,78 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+function onPath(bin) {
+    try {
+        execSync(process.platform === 'win32' ? `where ${bin}` : `command -v ${bin}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Default host signals: agent home dir present OR agent binary on PATH. */
+function hostSignals() {
+    const out = [];
+    const home = os.homedir();
+    if (fs.existsSync(path.join(home, '.claude')) || onPath('claude'))
+        out.push('claude');
+    if (fs.existsSync(path.join(home, '.codex')) || onPath('codex'))
+        out.push('codex');
+    return out;
+}
+/** Directory marker: must resolve to a real directory (broken symlink/perm → false). */
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** File marker: must resolve to a real file. */
+function isFile(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Decide which agent integration(s) to generate.
+ *
+ * - explicit `claude`/`codex`/`both` → deterministic, no scan (hermetic).
+ * - `auto`/undefined → project markers first, then host signals, then `['claude']`.
+ *
+ * Directory markers (`.claude`, `.codex`, `.agents`) must be directories and file
+ * markers (`CLAUDE.md`, `AGENTS.md`) must be files, so a stray regular file named
+ * `.agents` does not mislead detection into a path the adapters can't write to.
+ *
+ * Always returns a de-duped, stable-ordered, non-empty list.
+ */
+export function detectAgents(projectPath, explicit, deps = {}) {
+    if (explicit === 'claude')
+        return ['claude'];
+    if (explicit === 'codex')
+        return ['codex'];
+    if (explicit === 'both')
+        return ['claude', 'codex'];
+    const found = [];
+    const claudeMarker = isDir(path.join(projectPath, '.claude')) ||
+        isFile(path.join(projectPath, 'CLAUDE.md')) ||
+        isFile(path.join(projectPath, 'claude.md'));
+    const codexMarker = isDir(path.join(projectPath, '.codex')) ||
+        isDir(path.join(projectPath, '.agents')) ||
+        isFile(path.join(projectPath, 'AGENTS.md'));
+    if (claudeMarker)
+        found.push('claude');
+    if (codexMarker)
+        found.push('codex');
+    if (found.length)
+        return found;
+    const host = (deps.host ?? hostSignals)();
+    const ordered = ['claude', 'codex'].filter((a) => host.includes(a));
+    return ordered.length ? ordered : ['claude'];
+}
+//# sourceMappingURL=detect.js.map

package/dist/cli/init/agents/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../../src/cli/init/agents/detect.ts"],"names":[],"mappings":"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"}

package/dist/cli/init/agents/index.d.ts

@@ -0,0 +1,15 @@
+import type { AgentAdapter, AgentId, AgentSelector } from './types.js';
+import type { WorkflowDefinition } from '../workflow-definitions.js';
+import { detectAgents } from './detect.js';
+export declare const ADAPTERS: Record<AgentId, AgentAdapter>;
+export interface RunAdaptersResult {
+    agents: AgentId[];
+    agentArtifacts: Partial<Record<AgentId, string[]>>;
+    allFiles: string[];
+    warnings: string[];
+}
+/** Detect (or honor explicit) agents, run each adapter, aggregate results. */
+export declare function runAdapters(projectPath: string, defs: WorkflowDefinition[], explicit?: AgentSelector): RunAdaptersResult;
+export { detectAgents };
+export type { AgentId, AgentSelector, AgentAdapter, AgentArtifact } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/init/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAGlD,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,kBAAkB,EAAE,EAC1B,QAAQ,CAAC,EAAE,aAAa,GACvB,iBAAiB,CAWnB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/init/agents/index.js

@@ -0,0 +1,22 @@
+import { ClaudeAdapter } from './claude.js';
+import { CodexAdapter } from './codex.js';
+import { detectAgents } from './detect.js';
+export const ADAPTERS = {
+    claude: new ClaudeAdapter(),
+    codex: new CodexAdapter(),
+};
+/** Detect (or honor explicit) agents, run each adapter, aggregate results. */
+export function runAdapters(projectPath, defs, explicit) {
+    const agents = detectAgents(projectPath, explicit);
+    const agentArtifacts = {};
+    const allFiles = [];
+    const warnings = [];
+    for (const id of agents) {
+        const files = ADAPTERS[id].writeAll(projectPath, defs, warnings);
+        agentArtifacts[id] = files;
+        allFiles.push(...files);
+    }
+    return { agents, agentArtifacts, allFiles, warnings };
+}
+export { detectAgents };
+//# sourceMappingURL=index.js.map

package/dist/cli/init/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/init/agents/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAkC;IACrD,MAAM,EAAE,IAAI,aAAa,EAAE;IAC3B,KAAK,EAAE,IAAI,YAAY,EAAE;CAC1B,CAAC;AASF,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CACzB,WAAmB,EACnB,IAA0B,EAC1B,QAAwB;IAExB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,cAAc,GAAuC,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjE,cAAc,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/cli/init/agents/transform.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Per-agent rendering transforms applied to workflow bodies/descriptions.
+ *
+ * Source text is authored in Claude form. The Claude render is identity (so output
+ * stays byte-identical to historical releases); the Codex render rewrites
+ * Claude-specific slash syntax and wording into Codex-idiomatic form.
+ */
+export declare function toClaude(text: string): string;
+export declare function toCodex(text: string): string;
+//# sourceMappingURL=transform.d.ts.map

package/dist/cli/init/agents/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../src/cli/init/agents/transform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAGD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C"}