openspec-playwright 0.1.39 → 0.1.41

package/src/commands/editors.ts

@@ -1,4 +1,5 @@
 import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
 import { join, dirname } from 'path';
 import chalk from 'chalk';
 
@@ -12,11 +13,21 @@ export function escapeYamlValue(value: string): string {
   return value;
 }
 
-/** Format tags as YAML inline array */
+/** Format tags as YAML inline array (escaped) */
 export function formatTagsArray(tags: string[]): string {
   return `[${tags.map(t => escapeYamlValue(t)).join(', ')}]`;
 }
 
+/** Format tags as YAML inline array (plain, no escaping) */
+function formatTagsPlain(tags: string[]): string {
+  return `[${tags.join(', ')}]`;
+}
+
+/** Transform /opsx: to /opsx- for OpenCode */
+function transformToHyphenCommands(text: string): string {
+  return text.replace(/\/opsx:/g, '/opsx-');
+}
+
 /** Command metadata shared across editors */
 export interface CommandMeta {
   id: string;
@@ -29,23 +40,19 @@ export interface CommandMeta {
 
 /** Editor adapter — Strategy Pattern */
 export interface EditorAdapter {
-  /** Tool identifier */
   toolId: string;
-  /** Whether this editor supports SKILL.md */
   hasSkill: boolean;
-  /** Get the command file path relative to project root */
   getCommandPath(commandId: string): string;
-  /** Format the complete file content */
   formatCommand(meta: CommandMeta): string;
 }
 
+// ─── Claude Code ──────────────────────────────────────────────────────────────
+
 /** Claude Code: .claude/commands/opsx/<id>.md + SKILL.md */
 const claudeAdapter: EditorAdapter = {
   toolId: 'claude',
   hasSkill: true,
-  getCommandPath(id: string) {
-    return join('.claude', 'commands', 'opsx', `${id}.md`);
-  },
+  getCommandPath(id) { return join('.claude', 'commands', 'opsx', `${id}.md`); },
   formatCommand(meta) {
     return `---
 name: ${escapeYamlValue(meta.name)}
@@ -59,13 +66,13 @@ ${meta.body}
   },
 };
 
+// ─── Cursor ─────────────────────────────────────────────────────────────────
+
 /** Cursor: .cursor/commands/opsx-<id>.md */
 const cursorAdapter: EditorAdapter = {
   toolId: 'cursor',
   hasSkill: false,
-  getCommandPath(id: string) {
-    return join('.cursor', 'commands', `opsx-${id}.md`);
-  },
+  getCommandPath(id) { return join('.cursor', 'commands', `opsx-${id}.md`); },
   formatCommand(meta) {
     return `---
 name: /opsx-${meta.id}
@@ -79,13 +86,13 @@ ${meta.body}
   },
 };
 
+// ─── Windsurf ────────────────────────────────────────────────────────────────
+
 /** Windsurf: .windsurf/workflows/opsx-<id>.md */
 const windsurfAdapter: EditorAdapter = {
   toolId: 'windsurf',
   hasSkill: false,
-  getCommandPath(id: string) {
-    return join('.windsurf', 'workflows', `opsx-${id}.md`);
-  },
+  getCommandPath(id) { return join('.windsurf', 'workflows', `opsx-${id}.md`); },
   formatCommand(meta) {
     return `---
 name: ${escapeYamlValue(meta.name)}
@@ -99,13 +106,13 @@ ${meta.body}
   },
 };
 
+// ─── Cline ──────────────────────────────────────────────────────────────────
+
 /** Cline: .clinerules/workflows/opsx-<id>.md — markdown header only */
 const clineAdapter: EditorAdapter = {
   toolId: 'cline',
   hasSkill: false,
-  getCommandPath(id: string) {
-    return join('.clinerules', 'workflows', `opsx-${id}.md`);
-  },
+  getCommandPath(id) { return join('.clinerules', 'workflows', `opsx-${id}.md`); },
   formatCommand(meta) {
     return `# ${meta.name}
 
@@ -116,13 +123,13 @@ ${meta.body}
   },
 };
 
+// ─── Continue ────────────────────────────────────────────────────────────────
+
 /** Continue: .continue/prompts/opsx-<id>.prompt */
 const continueAdapter: EditorAdapter = {
   toolId: 'continue',
   hasSkill: false,
-  getCommandPath(id: string) {
-    return join('.continue', 'prompts', `opsx-${id}.prompt`);
-  },
+  getCommandPath(id) { return join('.continue', 'prompts', `opsx-${id}.prompt`); },
   formatCommand(meta) {
     return `---
 name: opsx-${meta.id}
@@ -135,13 +142,353 @@ ${meta.body}
   },
 };
 
-/** All supported adapters */
+// ─── amazon-q ─────────────────────────────────────────────────────────────
+
+/** Amazon Q: .amazonq/prompts/opsx-<id>.md */
+const amazonqAdapter: EditorAdapter = {
+  toolId: 'amazon-q',
+  hasSkill: false,
+  getCommandPath(id) { return join('.amazonq', 'prompts', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── antigravity ──────────────────────────────────────────────────────────
+
+/** Antigravity: .agent/workflows/opsx-<id>.md */
+const antigravityAdapter: EditorAdapter = {
+  toolId: 'antigravity',
+  hasSkill: false,
+  getCommandPath(id) { return join('.agent', 'workflows', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── auggie ────────────────────────────────────────────────────────────────
+
+/** Auggie: .augment/commands/opsx-<id>.md */
+const auggieAdapter: EditorAdapter = {
+  toolId: 'auggie',
+  hasSkill: false,
+  getCommandPath(id) { return join('.augment', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── codebuddy ─────────────────────────────────────────────────────────────
+
+/** CodeBuddy: .codebuddy/commands/opsx/<id>.md */
+const codebuddyAdapter: EditorAdapter = {
+  toolId: 'codebuddy',
+  hasSkill: false,
+  getCommandPath(id) { return join('.codebuddy', 'commands', 'opsx', `${id}.md`); },
+  formatCommand(meta) {
+    return `---
+name: ${meta.name}
+description: "${meta.description}"
+argument-hint: "[command arguments]"
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── codex ────────────────────────────────────────────────────────────────
+
+/** Codex: <CODEX_HOME>/prompts/opsx-<id>.md — global scope */
+const codexAdapter: EditorAdapter = {
+  toolId: 'codex',
+  hasSkill: false,
+  getCommandPath(id) {
+    const codexHome = process.env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+    return join(codexHome, 'prompts', `opsx-${id}.md`);
+  },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── costrict ─────────────────────────────────────────────────────────────
+
+/** CoStrict: .cospec/openspec/commands/opsx-<id>.md */
+const costrictAdapter: EditorAdapter = {
+  toolId: 'costrict',
+  hasSkill: false,
+  getCommandPath(id) { return join('.cospec', 'openspec', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: "${meta.description}"
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── crush ────────────────────────────────────────────────────────────────
+
+/** Crush: .crush/commands/opsx/<id>.md — raw values, no escaping */
+const crushAdapter: EditorAdapter = {
+  toolId: 'crush',
+  hasSkill: false,
+  getCommandPath(id) { return join('.crush', 'commands', 'opsx', `${id}.md`); },
+  formatCommand(meta) {
+    return `---
+name: ${meta.name}
+description: ${meta.description}
+category: ${meta.category}
+tags: ${formatTagsPlain(meta.tags)}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── factory ───────────────────────────────────────────────────────────────
+
+/** Factory Droid: .factory/commands/opsx-<id>.md */
+const factoryAdapter: EditorAdapter = {
+  toolId: 'factory',
+  hasSkill: false,
+  getCommandPath(id) { return join('.factory', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── gemini ────────────────────────────────────────────────────────────────
+
+/** Gemini CLI: .gemini/commands/opsx/<id>.toml */
+const geminiAdapter: EditorAdapter = {
+  toolId: 'gemini',
+  hasSkill: false,
+  getCommandPath(id) { return join('.gemini', 'commands', 'opsx', `${id}.toml`); },
+  formatCommand(meta) {
+    return `description = "${meta.description}"
+
+prompt = """
+${meta.body}
+"""
+`;
+  },
+};
+
+// ─── github-copilot ────────────────────────────────────────────────────────
+
+/** GitHub Copilot: .github/prompts/opsx-<id>.prompt.md */
+const githubcopilotAdapter: EditorAdapter = {
+  toolId: 'github-copilot',
+  hasSkill: false,
+  getCommandPath(id) { return join('.github', 'prompts', `opsx-${id}.prompt.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── iflow ────────────────────────────────────────────────────────────────
+
+/** iFlow: .iflow/commands/opsx-<id>.md */
+const iflowAdapter: EditorAdapter = {
+  toolId: 'iflow',
+  hasSkill: false,
+  getCommandPath(id) { return join('.iflow', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+name: /opsx-${meta.id}
+id: opsx-${meta.id}
+category: ${meta.category}
+description: ${meta.description}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── kilocode ────────────────────────────────────────────────────────────
+
+/** Kilo Code: .kilocode/workflows/opsx-<id>.md — body only */
+const kilocodeAdapter: EditorAdapter = {
+  toolId: 'kilocode',
+  hasSkill: false,
+  getCommandPath(id) { return join('.kilocode', 'workflows', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `${meta.body}
+`;
+  },
+};
+
+// ─── kiro ─────────────────────────────────────────────────────────────────
+
+/** Kiro: .kiro/prompts/opsx-<id>.prompt.md */
+const kiroAdapter: EditorAdapter = {
+  toolId: 'kiro',
+  hasSkill: false,
+  getCommandPath(id) { return join('.kiro', 'prompts', `opsx-${id}.prompt.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${meta.description}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── opencode ─────────────────────────────────────────────────────────────
+
+/** OpenCode: .opencode/commands/opsx-<id>.md — transforms /opsx: to /opsx- */
+const opencodeAdapter: EditorAdapter = {
+  toolId: 'opencode',
+  hasSkill: false,
+  getCommandPath(id) { return join('.opencode', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    const transformed = transformToHyphenCommands(meta.body);
+    return `---
+description: ${meta.description}
+---
+
+${transformed}
+`;
+  },
+};
+
+// ─── pi ──────────────────────────────────────────────────────────────────
+
+/** Pi: .pi/prompts/opsx-<id>.md */
+const piAdapter: EditorAdapter = {
+  toolId: 'pi',
+  hasSkill: false,
+  getCommandPath(id) { return join('.pi', 'prompts', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── qoder ────────────────────────────────────────────────────────────────
+
+/** Qoder: .qoder/commands/opsx/<id>.md — raw values, no escaping */
+const qoderAdapter: EditorAdapter = {
+  toolId: 'qoder',
+  hasSkill: false,
+  getCommandPath(id) { return join('.qoder', 'commands', 'opsx', `${id}.md`); },
+  formatCommand(meta) {
+    return `---
+name: ${meta.name}
+description: ${meta.description}
+category: ${meta.category}
+tags: ${formatTagsPlain(meta.tags)}
+---
+
+${meta.body}
+`;
+  },
+};
+
+// ─── qwen ────────────────────────────────────────────────────────────────
+
+/** Qwen Code: .qwen/commands/opsx-<id>.toml */
+const qwenAdapter: EditorAdapter = {
+  toolId: 'qwen',
+  hasSkill: false,
+  getCommandPath(id) { return join('.qwen', 'commands', `opsx-${id}.toml`); },
+  formatCommand(meta) {
+    return `description = "${meta.description}"
+
+prompt = """
+${meta.body}
+"""
+`;
+  },
+};
+
+// ─── roocode ─────────────────────────────────────────────────────────────
+
+/** RooCode: .roo/commands/opsx-<id>.md — markdown header */
+const roocodeAdapter: EditorAdapter = {
+  toolId: 'roocode',
+  hasSkill: false,
+  getCommandPath(id) { return join('.roo', 'commands', `opsx-${id}.md`); },
+  formatCommand(meta) {
+    return `# ${meta.name}
+
+${meta.description}
+
+${meta.body}
+`;
+  },
+};
+
+// ─── Detection map ───────────────────────────────────────────────────────
+
 const ALL_ADAPTERS: EditorAdapter[] = [
   claudeAdapter,
   cursorAdapter,
   windsurfAdapter,
   clineAdapter,
   continueAdapter,
+  amazonqAdapter,
+  antigravityAdapter,
+  auggieAdapter,
+  codebuddyAdapter,
+  codexAdapter,
+  costrictAdapter,
+  crushAdapter,
+  factoryAdapter,
+  geminiAdapter,
+  githubcopilotAdapter,
+  iflowAdapter,
+  kilocodeAdapter,
+  kiroAdapter,
+  opencodeAdapter,
+  piAdapter,
+  qoderAdapter,
+  qwenAdapter,
+  roocodeAdapter,
 ];
 
 /** Detect which editors are installed by checking their config directories */
@@ -152,6 +499,23 @@ export function detectEditors(projectRoot: string): EditorAdapter[] {
     ['.windsurf', windsurfAdapter],
     ['.clinerules', clineAdapter],
     ['.continue', continueAdapter],
+    ['.amazonq', amazonqAdapter],
+    ['.agent', antigravityAdapter],
+    ['.augment', auggieAdapter],
+    ['.codebuddy', codebuddyAdapter],
+    ['.cospec', costrictAdapter],
+    ['.crush', crushAdapter],
+    ['.factory', factoryAdapter],
+    ['.gemini', geminiAdapter],
+    ['.github', githubcopilotAdapter],
+    ['.iflow', iflowAdapter],
+    ['.kilocode', kilocodeAdapter],
+    ['.kiro', kiroAdapter],
+    ['.opencode', opencodeAdapter],
+    ['.pi', piAdapter],
+    ['.qoder', qoderAdapter],
+    ['.qwen', qwenAdapter],
+    ['.roo', roocodeAdapter],
   ];
 
   return checks
@@ -159,6 +523,16 @@ export function detectEditors(projectRoot: string): EditorAdapter[] {
     .map(([, adapter]) => adapter);
 }
 
+// ─── Codex is global — detect separately ─────────────────────────────────
+
+/** Detect Codex by checking if CODEX_HOME or ~/.codex exists */
+export function detectCodex(): EditorAdapter | null {
+  const codexHome = process.env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+  return existsSync(codexHome) ? codexAdapter : null;
+}
+
+// ─── Install helpers ───────────────────────────────────────────────────────
+
 /** Build the shared command metadata */
 export function buildCommandMeta(body: string): CommandMeta {
   return {

package/src/commands/init.ts

@@ -11,7 +11,7 @@ import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import { readFile } from 'fs/promises';
 import { syncMcpTools } from './mcpSync.js';
-import { detectEditors, installForAllEditors, installSkill, claudeAdapter } from './editors.js';
+import { detectEditors, detectCodex, installForAllEditors, installSkill, claudeAdapter } from './editors.js';
 
 const TEMPLATE_DIR = fileURLToPath(new URL('../../templates', import.meta.url));
 const SCHEMA_DIR = fileURLToPath(new URL('../../schemas', import.meta.url));
@@ -85,9 +85,11 @@ export async function init(options: InitOptions) {
   // 4. Install E2E commands for detected editors
   console.log(chalk.blue('\n─── Installing E2E Commands ───'));
   const detected = detectEditors(projectRoot);
-  if (detected.length > 0) {
+  const codex = detectCodex();
+  const adapters = codex ? [...detected, codex] : detected;
+  if (adapters.length > 0) {
     const body = await readFile(CMD_BODY_SRC, 'utf-8');
-    installForAllEditors(body, detected, projectRoot);
+    installForAllEditors(body, adapters, projectRoot);
   } else {
     const body = await readFile(CMD_BODY_SRC, 'utf-8');
     installForAllEditors(body, [claudeAdapter], projectRoot);

package/src/commands/update.ts

@@ -14,7 +14,7 @@ import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import * as tar from 'tar';
 import { syncMcpTools } from './mcpSync.js';
-import { detectEditors, installForAllEditors, installSkill } from './editors.js';
+import { detectEditors, detectCodex, installForAllEditors, installSkill } from './editors.js';
 
 const CMD_BODY_SRC = fileURLToPath(new URL('../../.claude/commands/opsx/e2e-body.md', import.meta.url));
 const SCHEMA_DIR = fileURLToPath(new URL('../../schemas', import.meta.url));
@@ -84,7 +84,9 @@ export async function update(options: UpdateOptions) {
       const schemaSrc = join(tmpDir, 'schemas', 'playwright-e2e');
 
       // Install commands for all detected editors
-      const adapters = detectEditors(projectRoot);
+      const detected = detectEditors(projectRoot);
+      const codex = detectCodex();
+      const adapters = codex ? [...detected, codex] : detected;
       if (adapters.length > 0 && existsSync(bodySrc)) {
         const body = readFileSync(bodySrc, 'utf-8');
         installForAllEditors(body, adapters, projectRoot);