@tiic-tech/openworkflow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tiic-tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# OpenWorkflow
+
+OpenWorkflow is a contract-first workflow system for AI-assisted software
+development. It initializes repository-local workflow contracts, generated Codex
+repo skills, artifact templates, and validation utilities for the discovery loop
+from vision through prototype tuning.
+
+## Install
+
+```bash
+npm install -g @tiic-tech/openworkflow
+```
+
+The package installs the `openworkflow` CLI.
+
+## Usage
+
+```bash
+openworkflow init . --tools codex
+openworkflow sync --root . --tools codex
+openworkflow doctor --root . --tools codex
+openworkflow validate --root .
+```
+
+## Release Checks
+
+Before publishing, run:
+
+```bash
+npm run validate
+npm run verify:runtime-surface
+npm run verify:e2e-workflow
+npm pack --dry-run
+```
+
+`npm publish` runs the core validation gates through `prepublishOnly`; `npm pack`
+rebuilds `dist` through `prepack`.

package/dist/adapters/codex/src/doctorCodexAdapter.d.ts

@@ -0,0 +1,6 @@
+export interface AdapterDoctorResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function doctorCodexAdapter(root: string): Promise<AdapterDoctorResult>;

package/dist/adapters/codex/src/doctorCodexAdapter.js

@@ -0,0 +1,124 @@
+import { join } from "node:path";
+import { isNotFound, readTextFile } from "../../../core/src/fs/index.js";
+import { hasGeneratedMarker, renderGeneratedFile } from "./generatedFiles.js";
+import { legacyCodexCommandPaths } from "./generateCommands.js";
+import { legacyCodexSkillPaths } from "./generateSkills.js";
+import { CODEX_MANIFEST_PATH, CODEX_MANIFEST_TEMPLATE_ID, LEGACY_CODEX_MANIFEST_PATHS, codexManifest } from "./manifest.js";
+import { getCodexTemplates } from "./templates.js";
+export async function doctorCodexAdapter(root) {
+    const errors = [];
+    const warnings = [];
+    const templates = getCodexTemplates();
+    for (const template of templates) {
+        const path = join(root, template.path);
+        const expected = renderGeneratedFile(template.path, template.content, template.id);
+        let actual;
+        try {
+            actual = await readTextFile(path);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                errors.push(`missing Codex adapter file: ${template.path}`);
+                continue;
+            }
+            throw error;
+        }
+        if (!hasGeneratedMarker(actual)) {
+            errors.push(`Codex adapter file is not marked as generated: ${template.path}`);
+            continue;
+        }
+        if (!actual.includes(`template-id: ${template.id}`)) {
+            errors.push(`Codex adapter file has unexpected template id: ${template.path}`);
+        }
+        if (actual !== expected) {
+            warnings.push(`Codex adapter file is stale: ${template.path}`);
+        }
+    }
+    const expectedManifest = renderGeneratedFile(CODEX_MANIFEST_PATH, codexManifest(root, templates.map((template) => template.path)), CODEX_MANIFEST_TEMPLATE_ID);
+    try {
+        const manifest = await readTextFile(join(root, CODEX_MANIFEST_PATH));
+        if (!hasGeneratedMarker(manifest)) {
+            errors.push(`Codex adapter manifest is not marked as generated: ${CODEX_MANIFEST_PATH}`);
+        }
+        else if (manifest !== expectedManifest) {
+            warnings.push(`Codex adapter manifest is stale: ${CODEX_MANIFEST_PATH}`);
+        }
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            errors.push(`missing Codex adapter manifest: ${CODEX_MANIFEST_PATH}`);
+        }
+        else {
+            throw error;
+        }
+    }
+    for (const legacyPath of legacyCodexCommandPaths()) {
+        try {
+            const legacyContent = await readTextFile(join(root, legacyPath));
+            if (hasGeneratedMarker(legacyContent)) {
+                errors.push(`legacy generated Codex command remains: ${legacyPath}`);
+            }
+            else {
+                warnings.push(`legacy non-generated Codex command exists: ${legacyPath}`);
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error)) {
+                throw error;
+            }
+        }
+    }
+    for (const legacyPath of legacyCodexSkillPaths()) {
+        try {
+            const legacyContent = await readTextFile(join(root, legacyPath));
+            if (hasGeneratedMarker(legacyContent)) {
+                errors.push(`legacy generated Codex skill remains: ${legacyPath}`);
+            }
+            else {
+                warnings.push(`legacy non-generated Codex skill exists: ${legacyPath}`);
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error)) {
+                throw error;
+            }
+        }
+    }
+    for (const legacyPath of legacyCodexAgentPaths()) {
+        try {
+            const legacyContent = await readTextFile(join(root, legacyPath));
+            if (hasGeneratedMarker(legacyContent)) {
+                errors.push(`legacy generated Codex agent file remains: ${legacyPath}`);
+            }
+            else {
+                warnings.push(`legacy non-generated Codex agent file exists: ${legacyPath}`);
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error)) {
+                throw error;
+            }
+        }
+    }
+    for (const legacyPath of LEGACY_CODEX_MANIFEST_PATHS) {
+        try {
+            const legacyContent = await readTextFile(join(root, legacyPath));
+            if (hasGeneratedMarker(legacyContent)) {
+                errors.push(`legacy generated Codex manifest remains: ${legacyPath}`);
+            }
+            else {
+                warnings.push(`legacy non-generated Codex manifest exists: ${legacyPath}`);
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error)) {
+                throw error;
+            }
+        }
+    }
+    return { ok: errors.length === 0, errors, warnings };
+}
+function legacyCodexAgentPaths() {
+    return [".codex/agents/README.md", ".codex/agents/openworkflow-orchestrator.md"];
+}
+//# sourceMappingURL=doctorCodexAdapter.js.map

package/dist/adapters/codex/src/doctorCodexAdapter.js.map

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

package/dist/adapters/codex/src/generateAgents.d.ts

@@ -0,0 +1,2 @@
+import type { CodexTemplate } from "./templates.js";
+export declare function generateAgentTemplates(): CodexTemplate[];

package/dist/adapters/codex/src/generateAgents.js

@@ -0,0 +1,40 @@
+export function generateAgentTemplates() {
+    return [
+        {
+            id: "codex.agent.readme",
+            path: ".codex/agents/README.md",
+            content: agentsReadme(),
+        },
+        {
+            id: "codex.agent.openworkflow-orchestrator",
+            path: ".codex/agents/openworkflow-orchestrator.md",
+            content: orchestratorAgent(),
+        },
+    ];
+}
+function agentsReadme() {
+    return `# Codex Agents for OpenWorkflow
+
+This folder is generated by the OpenWorkflow Codex adapter. The canonical workflow state lives in \`.openworkflow/\`.
+`;
+}
+function orchestratorAgent() {
+    return `---
+name: openworkflow-orchestrator
+description: Coordinates OpenWorkflow contract stages while keeping .openworkflow as source of truth.
+---
+
+# OpenWorkflow Orchestrator
+
+Read \`.openworkflow/workflow/WORKFLOW_INDEX.yaml\` first. Do not treat \`.codex/\` as the source of truth; it is an adapter layer.
+
+Default journey:
+
+\`\`\`txt
+vision -> validation -> proto -> decision -> design -> spec -> change -> runtime
+\`\`\`
+
+Prototype discovery must not create production specs, changes, teams, or runtime state before a decision authorizes continuation.
+`;
+}
+//# sourceMappingURL=generateAgents.js.map

package/dist/adapters/codex/src/generateAgents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAgents.js","sourceRoot":"","sources":["../../../../packages/adapters/codex/src/generateAgents.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL;YACE,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,YAAY,EAAE;SACxB;QACD;YACE,EAAE,EAAE,uCAAuC;YAC3C,IAAI,EAAE,4CAA4C;YAClD,OAAO,EAAE,iBAAiB,EAAE;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;;;CAGR,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO;;;;;;;;;;;;;;;;CAgBR,CAAC;AACF,CAAC"}

package/dist/adapters/codex/src/generateCodexAdapter.d.ts

@@ -0,0 +1,9 @@
+import type { InitOptions } from "../../../core/src/contracts/index.js";
+export interface AdapterResult {
+    written: string[];
+    skipped: string[];
+    unchanged: string[];
+    removed: string[];
+    warnings: string[];
+}
+export declare function generateCodexAdapter(options: InitOptions): Promise<AdapterResult>;

package/dist/adapters/codex/src/generateCodexAdapter.js

@@ -0,0 +1,59 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { getWorkflowCommands } from "../../../core/src/commands/registry.js";
+import { ensureDir } from "../../../core/src/fs/index.js";
+import { removeGenerated, renderGeneratedFile, writeGenerated } from "./generatedFiles.js";
+import { codexPromptIdFromTrigger, codexPromptPathForId, legacyCodexCommandPaths } from "./generateCommands.js";
+import { legacyCodexSkillPaths } from "./generateSkills.js";
+import { CODEX_MANIFEST_PATH, CODEX_MANIFEST_TEMPLATE_ID, LEGACY_CODEX_MANIFEST_PATHS, codexManifest, } from "./manifest.js";
+import { getCodexTemplates } from "./templates.js";
+export async function generateCodexAdapter(options) {
+    const written = [];
+    const skipped = [];
+    const unchanged = [];
+    const removed = [];
+    const warnings = [];
+    const templates = getCodexTemplates();
+    const dirs = [".agents"];
+    for (const dir of dirs) {
+        await ensureDir(join(options.root, dir));
+    }
+    for (const template of templates) {
+        await writeGenerated(join(options.root, template.path), renderGeneratedFile(template.path, template.content, template.id), options.force, written, skipped, unchanged, warnings);
+    }
+    await writeGenerated(join(options.root, CODEX_MANIFEST_PATH), renderGeneratedFile(CODEX_MANIFEST_PATH, codexManifest(options.root, templates.map((template) => template.path)), CODEX_MANIFEST_TEMPLATE_ID), options.force, written, skipped, unchanged, warnings);
+    for (const legacyPath of legacyCodexCommandPaths()) {
+        await removeGenerated(join(options.root, legacyPath), options.force, removed, skipped, warnings);
+    }
+    for (const legacyPath of legacyCodexSkillPaths()) {
+        await removeGenerated(join(options.root, legacyPath), options.force, removed, skipped, warnings);
+    }
+    for (const legacyPath of legacyCodexAgentPaths()) {
+        await removeGenerated(join(options.root, legacyPath), options.force, removed, skipped, warnings);
+    }
+    for (const legacyPath of LEGACY_CODEX_MANIFEST_PATHS) {
+        await removeGenerated(join(options.root, legacyPath), options.force, removed, skipped, warnings);
+    }
+    for (const legacyPromptPath of legacyCodexPromptPaths()) {
+        await removeGenerated(legacyPromptPath, false, removed, skipped, warnings);
+    }
+    return { written, skipped, unchanged, removed, warnings };
+}
+function legacyCodexAgentPaths() {
+    return [".codex/agents/README.md", ".codex/agents/openworkflow-orchestrator.md"];
+}
+function legacyCodexPromptPaths() {
+    const codexHome = process.env.CODEX_HOME?.trim() || join(homedir(), ".codex");
+    const promptIds = new Set();
+    for (const command of getWorkflowCommands()) {
+        promptIds.add(command.id);
+        for (const legacyTrigger of command.legacyTriggers) {
+            const id = codexPromptIdFromTrigger(legacyTrigger);
+            if (id) {
+                promptIds.add(id);
+            }
+        }
+    }
+    return [...promptIds].map((id) => join(codexHome, "prompts", codexPromptPathForId(id)));
+}
+//# sourceMappingURL=generateCodexAdapter.js.map

package/dist/adapters/codex/src/generateCodexAdapter.js.map

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

package/dist/adapters/codex/src/generateCommands.d.ts

@@ -0,0 +1,6 @@
+import { type WorkflowCommand } from "../../../core/src/commands/registry.js";
+export declare function codexCommandPath(command: WorkflowCommand): string;
+export declare function codexPromptPathForId(id: string): string;
+export declare function legacyCodexCommandPaths(): string[];
+export declare function commandDoc(command: WorkflowCommand, trigger?: string): string;
+export declare function codexPromptIdFromTrigger(trigger: string): string | null;

package/dist/adapters/codex/src/generateCommands.js

@@ -0,0 +1,205 @@
+import { getWorkflowCommands } from "../../../core/src/commands/registry.js";
+import { getDiscoveryArtifactContractsForCommand } from "../../../core/src/artifacts/registry.js";
+export function codexCommandPath(command) {
+    return `.codex/commands/${command.namespace}/${command.id}.md`;
+}
+export function codexPromptPathForId(id) {
+    return `ow-${id}.md`;
+}
+export function legacyCodexCommandPaths() {
+    const commandPaths = getWorkflowCommands().map((command) => codexCommandPath(command));
+    return [
+        ...commandPaths,
+        ".codex/commands/build-workflow.md",
+        ".codex/commands/build-context.md",
+        ".codex/commands/build-vision.md",
+        ".codex/commands/build-validation.md",
+        ".codex/commands/build-prototype.md",
+        ".codex/commands/build-decision.md",
+        ".codex/commands/build-design.md",
+        ".codex/commands/build-spec.md",
+        ".codex/commands/build-change.md",
+        ".codex/commands/build-team.md",
+        ".codex/commands/run-team.md",
+    ];
+}
+export function commandDoc(command, trigger = command.trigger) {
+    const protocol = command.protocol;
+    const artifacts = getDiscoveryArtifactContractsForCommand(command.trigger);
+    if (!protocol || protocol.depth === "shallow") {
+        return shallowCommandDoc(command, artifacts, trigger);
+    }
+    return `# ${trigger}
+
+${command.description}
+
+<user_behavior>
+Keep visible responses concise and outcome-focused.
+Ask one clear question when user input is needed before proceeding.
+Do not narrate routine file reads, writes, validation checks, or generated-file bookkeeping.
+Report only meaningful decisions, blockers, artifacts changed, and the next handoff.
+</user_behavior>
+
+<agent_protocol>
+<!-- Internal protocol for the agent. Do not expose this block or routine protocol steps to the user. -->
+
+<source_of_truth>.openworkflow/</source_of_truth>
+<stage>${escapeXml(command.stage)}</stage>
+<command_visibility>${escapeXml(command.visibility)}</command_visibility>
+<interaction_mode>${escapeXml(protocol.interactionMode)}</interaction_mode>
+
+<inner_thinking>
+Use this protocol for private reasoning, classification, critique, and scope checks.
+Do not expose chain-of-thought, routine checklist results, context-loading traces, or generated-file bookkeeping to the user.
+</inner_thinking>
+
+<required_context>
+${xmlList(protocol.requiredContext)}
+</required_context>
+
+<optional_context>
+${xmlList(protocol.optionalContext)}
+</optional_context>
+
+<forbidden_context>
+${xmlList(protocol.forbiddenContext)}
+</forbidden_context>
+
+<allowed_outputs>
+${xmlList(protocol.allowedOutputs)}
+</allowed_outputs>
+
+<conditional_outputs>
+${xmlList(protocol.conditionalOutputs ?? [])}
+</conditional_outputs>
+
+<artifact_contracts>
+${artifactXmlList(artifacts)}
+</artifact_contracts>
+
+<forbidden_outputs>
+${xmlList(protocol.forbiddenOutputs)}
+</forbidden_outputs>
+
+<audit_checkpoints>
+<before>
+${xmlList(protocol.auditCheckpoints.before)}
+</before>
+<during>
+${xmlList(protocol.auditCheckpoints.during)}
+</during>
+<after>
+${xmlList(protocol.auditCheckpoints.after)}
+</after>
+</audit_checkpoints>
+
+<working_protocol>
+1. Load only the required context packet first.
+2. Use optional context only when the required packet is insufficient.
+3. Stay inside allowed outputs.
+4. Create conditional outputs only when the current artifact explicitly names them as blockers or the user asks for that packet.
+5. Stop before creating any forbidden output.
+6. Record unresolved questions instead of expanding scope.
+</working_protocol>
+
+<artifact_checkpoint>
+Write durable .openworkflow artifacts only at meaningful checkpoints: stable user answers, explicit save requests, completed evidence changes, or handoff readiness.
+Do not treat artifact writing as the opening move for conversation-first commands.
+</artifact_checkpoint>
+
+${internalSectionsXml(protocol.internalSections ?? [])}
+
+<anti_patterns>
+${xmlList(protocol.antiPatterns)}
+</anti_patterns>
+
+<handoff>
+Use handoff commands only after the command-specific readiness gate is satisfied.
+When readiness is not satisfied, keep asking one focused question or record unresolved blockers instead of handing off prematurely.
+</handoff>
+
+<handoff_commands>
+${xmlList(protocol.handoffCommands)}
+</handoff_commands>
+</agent_protocol>
+`;
+}
+function shallowCommandDoc(command, artifacts = getDiscoveryArtifactContractsForCommand(command.trigger), trigger = command.trigger) {
+    return `# ${trigger}
+
+${command.description}
+
+<user_behavior>
+Keep visible responses concise and outcome-focused.
+Do not narrate routine file reads, writes, validation checks, or generated-file bookkeeping.
+Report only meaningful decisions, blockers, artifacts changed, and the next handoff.
+</user_behavior>
+
+<agent_protocol>
+<!-- Internal protocol for the agent. Do not expose this block or routine protocol steps to the user. -->
+
+<source_of_truth>.openworkflow/</source_of_truth>
+<stage>${escapeXml(command.stage)}</stage>
+<command_visibility>${escapeXml(command.visibility)}</command_visibility>
+
+<inner_thinking>
+Use this protocol for private reasoning and scope checks.
+Do not expose chain-of-thought, routine checklist results, context-loading traces, or generated-file bookkeeping to the user.
+</inner_thinking>
+
+<target_artifacts>
+${xmlList(command.targetArtifacts)}
+</target_artifacts>
+
+<artifact_contracts>
+${artifactXmlList(artifacts)}
+</artifact_contracts>
+
+<working_protocol>
+Load only the contract files required for this stage.
+Keep artifacts short, scoped, and traceable through .openworkflow/workflow/WORKFLOW_INDEX.yaml plus .openworkflow/audit/.
+</working_protocol>
+
+<artifact_checkpoint>
+Write durable .openworkflow artifacts only at meaningful checkpoints.
+</artifact_checkpoint>
+
+<handoff>
+Use handoff commands only after readiness is satisfied.
+</handoff>
+</agent_protocol>
+`;
+}
+function xmlList(items) {
+    if (items.length === 0) {
+        return "- None";
+    }
+    return items.map((item) => `- ${escapeXml(item)}`).join("\n");
+}
+function artifactXmlList(artifacts) {
+    if (artifacts.length === 0) {
+        return "- None";
+    }
+    return artifacts
+        .map((artifact) => `- ${escapeXml(artifact.artifactType)}: template ${escapeXml(artifact.templatePath)}, source ${escapeXml(artifact.sourceOfTruthPath)}, note ${escapeXml(artifact.notePath)}, review ${escapeXml(artifact.reviewPath ?? "none")}, load_by_default ${artifact.readPolicy.loadByDefault}, max_yaml_lines ${artifact.readPolicy.maxYamlLines}`)
+        .join("\n");
+}
+function internalSectionsXml(sections) {
+    if (!sections || sections.length === 0) {
+        return "";
+    }
+    return sections
+        .map((section) => `<${section.tag}>\n${xmlList(section.items)}\n</${section.tag}>`)
+        .join("\n\n");
+}
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+function escapeXml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+export function codexPromptIdFromTrigger(trigger) {
+    const match = trigger.match(/^\/ow:([a-z0-9-]+)$/);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=generateCommands.js.map

package/dist/adapters/codex/src/generateCommands.js.map

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

package/dist/adapters/codex/src/generateSkills.d.ts

@@ -0,0 +1,7 @@
+import type { CodexTemplate } from "./templates.js";
+import { type WorkflowCommand } from "../../../core/src/commands/registry.js";
+export declare function generateSkillTemplates(): CodexTemplate[];
+export declare function codexSkillName(command: WorkflowCommand): string;
+export declare function codexSkillPath(command: WorkflowCommand): string;
+export declare function codexSkillInterfacePath(command: WorkflowCommand): string;
+export declare function legacyCodexSkillPaths(): string[];

package/dist/adapters/codex/src/generateSkills.js

@@ -0,0 +1,60 @@
+import { getWorkflowCommands } from "../../../core/src/commands/registry.js";
+import { commandDoc } from "./generateCommands.js";
+export function generateSkillTemplates() {
+    return getWorkflowCommands().flatMap((command) => [
+        {
+            id: `codex.skill.${command.namespace}.${command.id}`,
+            path: codexSkillPath(command),
+            content: codexSkill(command),
+        },
+        {
+            id: `codex.skill-interface.${command.namespace}.${command.id}`,
+            path: codexSkillInterfacePath(command),
+            content: codexSkillInterface(command),
+        },
+    ]);
+}
+export function codexSkillName(command) {
+    return `${command.namespace}-${command.id}`;
+}
+export function codexSkillPath(command) {
+    return `.agents/skills/${codexSkillName(command)}/SKILL.md`;
+}
+export function codexSkillInterfacePath(command) {
+    return `.agents/skills/${codexSkillName(command)}/agents/openai.yaml`;
+}
+export function legacyCodexSkillPaths() {
+    return [".codex/skills/openworkflow.md"];
+}
+function codexSkill(command) {
+    const skillName = codexSkillName(command);
+    const description = command.visibility === "internal"
+        ? `${command.description} Internal audit skill for ${command.trigger} in OpenWorkflow repositories.`
+        : `${command.description} Use this skill for ${command.trigger} in OpenWorkflow repositories.`;
+    return `---
+name: ${yamlString(skillName)}
+description: ${yamlString(description)}
+---
+${commandDoc(command)}
+
+<codex_skill>
+- Skill name: ${skillName}
+- Explicit invocation: $${skillName}
+- Semantic command: ${command.trigger}
+</codex_skill>
+`;
+}
+function codexSkillInterface(command) {
+    return `interface:
+  display_name: ${yamlString(displayName(command))}
+  short_description: ${yamlString(command.visibility === "internal" ? `${command.description} Internal audit only.` : command.description)}
+  default_prompt: ${yamlString(`Use ${command.trigger} for this OpenWorkflow repository.`)}
+`;
+}
+function displayName(command) {
+    return command.trigger.startsWith("/") ? command.trigger.slice(1) : command.trigger;
+}
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=generateSkills.js.map

package/dist/adapters/codex/src/generateSkills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSkills.js","sourceRoot":"","sources":["../../../../packages/adapters/codex/src/generateSkills.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD;YACE,EAAE,EAAE,eAAe,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE;YACpD,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;SAC7B;QACD;YACE,EAAE,EAAE,yBAAyB,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE;YAC9D,IAAI,EAAE,uBAAuB,CAAC,OAAO,CAAC;YACtC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;SACtC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,kBAAkB,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,OAAO,kBAAkB,cAAc,CAAC,OAAO,CAAC,qBAAqB,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,+BAA+B,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,OAAwB;IAC1C,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,WAAW,GACf,OAAO,CAAC,UAAU,KAAK,UAAU;QAC/B,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,6BAA6B,OAAO,CAAC,OAAO,gCAAgC;QACpG,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,uBAAuB,OAAO,CAAC,OAAO,gCAAgC,CAAC;IACnG,OAAO;QACD,UAAU,CAAC,SAAS,CAAC;eACd,UAAU,CAAC,WAAW,CAAC;;EAEpC,UAAU,CAAC,OAAO,CAAC;;;gBAGL,SAAS;0BACC,SAAS;sBACb,OAAO,CAAC,OAAO;;CAEpC,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAwB;IACnD,OAAO;kBACS,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;uBAC3B,UAAU,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;oBACtH,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,oCAAoC,CAAC;CACzF,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CAAC,OAAwB;IAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/adapters/codex/src/generatedFiles.d.ts

@@ -0,0 +1,4 @@
+export declare function renderGeneratedFile(path: string, content: string, templateId: string): string;
+export declare function hasGeneratedMarker(content: string): boolean;
+export declare function writeGenerated(path: string, content: string, force: boolean, written: string[], skipped: string[], unchanged: string[], warnings: string[]): Promise<void>;
+export declare function removeGenerated(path: string, force: boolean, removed: string[], skipped: string[], warnings: string[]): Promise<void>;