openspec-playwright 0.3.72 → 0.3.74

package/dist/commands/editors/project-rules.js

@@ -0,0 +1,246 @@
+/**
+ * Project rules file management: OPENSPEC marker blocks inside
+ * AGENTS.md (single source of truth) and the thin CLAUDE.md wrapper for
+ * Claude Code (@AGENTS.md import + CodeGraph-first guidance).
+ */
+import { existsSync, lstatSync, rmSync, readFileSync, writeFileSync, } from "fs";
+import { join, basename } from "path";
+import chalk from "chalk";
+import { claudeAdapter } from "./adapters/claude.js";
+import { opencodeAdapter, readOpenCodeInstructions } from "./adapters/opencode.js";
+// ─── Project rules file (CLAUDE.md / AGENTS.md) ──────────────────────────
+/**
+ * Read the OPENSPEC marker block from a rules file, or `null` when the file
+ * is missing / has no markers. Used by drift detection and update to decide
+ * whether a rules file needs rewriting.
+ */
+export function readOpenSpecBlock(projectRoot, adapter) {
+    const dest = adapter.projectRulesPath(projectRoot);
+    if (!existsSync(dest))
+        return null;
+    const content = readFileSync(dest, "utf-8");
+    const startIdx = content.indexOf("<!-- OPENSPEC:START -->");
+    const endIdx = content.indexOf("<!-- OPENSPEC:END -->");
+    if (startIdx === -1 || endIdx === -1)
+        return null;
+    return content.slice(startIdx + "<!-- OPENSPEC:START -->".length, endIdx).trim();
+}
+/**
+ * Whether a rules file's OPENSPEC block matches the expected content.
+ * A missing file or absent/truncated markers counts as "does not match"
+ * (the caller will rewrite it), which keeps update idempotent but safe.
+ */
+export function blockMatchesExpected(projectRoot, adapter, expected) {
+    const block = readOpenSpecBlock(projectRoot, adapter);
+    if (block === null)
+        return false;
+    return block === expected.trim();
+}
+/**
+ * Install employee-grade standards into the editor's rules file
+ * (CLAUDE.md for Claude, AGENTS.md for OpenCode, Cline, and Cursor). Wraps content in
+ * `<!-- OPENSPEC:START -->` / `<!-- OPENSPEC:END -->` markers so future
+ * updates can replace the block without touching the rest of the file.
+ */
+export function installOpenSpecBlock(projectRoot, standardsContent, adapter = claudeAdapter) {
+    const dest = adapter.projectRulesPath(projectRoot);
+    const fileLabel = basename(dest);
+    const markerStart = "<!-- OPENSPEC:START -->";
+    const markerEnd = "<!-- OPENSPEC:END -->";
+    if (!existsSync(dest)) {
+        const projName = projectRoot.split("/").pop() ?? "Project";
+        const content = `# ${projName}\n\n${markerStart}\n\n${standardsContent.trim()}\n\n${markerEnd}\n`;
+        writeFileSync(dest, content);
+        console.log(chalk.green(`  ✓ ${fileLabel}: created with employee-grade standards`));
+        return;
+    }
+    const existing = readFileSync(dest, "utf-8");
+    const hasStart = existing.includes(markerStart);
+    const hasEnd = existing.includes(markerEnd);
+    if (hasStart && hasEnd) {
+        const startIdx = existing.indexOf(markerStart);
+        const endIdx = existing.indexOf(markerEnd) + markerEnd.length;
+        const before = existing.slice(0, startIdx).trimEnd();
+        const after = existing.slice(endIdx);
+        const updated = before +
+            "\n" +
+            markerStart +
+            "\n\n" +
+            standardsContent.trim() +
+            "\n\n" +
+            markerEnd +
+            after;
+        writeFileSync(dest, updated);
+        console.log(chalk.green(`  ✓ ${fileLabel}: updated employee-grade standards (markers preserved, content refreshed)`));
+    }
+    else if (!hasStart && !hasEnd) {
+        const updated = existing.trim() +
+            "\n\n" +
+            markerStart +
+            "\n\n" +
+            standardsContent.trim() +
+            "\n\n" +
+            markerEnd +
+            "\n";
+        writeFileSync(dest, updated);
+        console.log(chalk.green(`  ✓ ${fileLabel}: appended employee-grade standards with markers`));
+    }
+    else {
+        // Incomplete markers (only START, or only END) — corrupted tool territory.
+        // Keep everything before the first marker (user content), discard the
+        // truncated tool output after it, and write a clean complete block so
+        // `doctor`/`update` converge instead of dead-ending on a skipped file.
+        const firstIdx = hasStart
+            ? existing.indexOf(markerStart)
+            : existing.indexOf(markerEnd);
+        const header = existing.slice(0, firstIdx).trimEnd();
+        const updated = header +
+            "\n\n" +
+            markerStart +
+            "\n\n" +
+            standardsContent.trim() +
+            "\n\n" +
+            markerEnd +
+            "\n";
+        writeFileSync(dest, updated);
+        console.log(chalk.green(`  ✓ ${fileLabel}: repaired incomplete OPENSPEC markers with employee-grade standards`));
+    }
+}
+/**
+ * CodeGraph-first guidance prepended to the Claude wrapper so the model sees
+ * it in the main rules file instead of relying on the AGENTS.md import
+ * (imported content ranks lower and is treated as optional by the model).
+ */
+const CODE_GRAPH_FIRST_BLOCK = `## CodeGraph 优先 🔴
+
+有 \`.codegraph/\` 时：结构性任务（定义/调用链/影响面/流程）默认第一步用 \`codegraph_explore\`，直接用结果回答，别先 grep/read（仅字面文本、已打开文件、结果不足时补查）。不派子 agent 重建索引。无 \`.codegraph/\` 跳过。`;
+/**
+ * The expected OPENSPEC block content for a thin CLAUDE.md wrapper
+ * (CodeGraph-first guidance + workflow hint + `@AGENTS.md` import). Exported
+ * so drift detection / update can compare against it.
+ *
+ * The `@AGENTS.md` line is Claude Code's documented way to reuse AGENTS.md
+ * inside CLAUDE.md — AGENTS.md is NOT read by default ("Claude Code reads
+ * CLAUDE.md, not AGENTS.md"). Contract per
+ * https://code.claude.com/docs/en/memory.md:
+ * - Position is irrelevant — the doc says "@ ... anywhere in your CLAUDE.md"
+ *   (examples even inline it mid-sentence or in a list item). The one real
+ *   constraint: the `@` line must NOT sit inside a code span (backticks) or
+ *   a fenced code block — the resolver skips those. This wrapper keeps the
+ *   import at the end of the block as a bare line.
+ * - The path resolves relative to the importing CLAUDE.md; import recursion
+ *   is capped at 4 hops.
+ * - Block-level HTML comments (`<!-- ... -->`) are stripped before context
+ *   injection, so the OPENSPEC markers vanish while the live `@AGENTS.md`
+ *   line inside them is still honored.
+ */
+export function claudeWrapperStandardsContent() {
+    return `${CODE_GRAPH_FIRST_BLOCK}\n\n**工作流**：优先使用 OpenSpec 工作流（/opsx 命令），而非 plan mode。\n\n@AGENTS.md\n`;
+}
+/**
+ * Install a thin CLAUDE.md that imports AGENTS.md.
+ *
+ * Uses the same OPENSPEC:START/END markers as the full standards block so
+ * `cleanProjectRules` can remove it uniformly. The CodeGraph-first block is
+ * written directly into CLAUDE.md (before the @AGENTS.md import) so Claude
+ * Code picks it up without depending on the import.
+ *
+ * Also handles migration: if CLAUDE.md has an existing OPENSPEC:START block
+ * (old format that wrote standards directly to CLAUDE.md), calling
+ * `installOpenSpecBlock` replaces the content with the CodeGraph block +
+ * `@AGENTS.md` import.
+ */
+export function installClaudeWrapper(projectRoot) {
+    const dest = join(projectRoot, "CLAUDE.md");
+    // CLAUDE.md symlinked (typically → AGENTS.md, the officially documented
+    // reuse pattern): AGENTS.md itself is what Claude Code reads, and
+    // installProjectRules already keeps the full standards in it. Writing a
+    // wrapper here would overwrite them through the symlink (and the wrapper's
+    // @AGENTS.md import would self-reference). Skip instead.
+    if (existsSync(dest)) {
+        if (lstatSync(dest).isSymbolicLink()) {
+            console.log(chalk.gray("  - CLAUDE.md is a symlink to AGENTS.md — standards live there, no wrapper needed"));
+            return;
+        }
+    }
+    // No-op if our full wrapper (CodeGraph block + @AGENTS.md import) is already
+    // in place — content-equal, so a user edit inside the markers is detected.
+    // A bare @AGENTS.md without our markers (added by openspec CLI or the user)
+    // is left untouched — but tell the user CodeGraph-first won't be written.
+    if (existsSync(dest)) {
+        const existing = readFileSync(dest, "utf-8");
+        const hasMarkers = existing.includes("<!-- OPENSPEC:START -->");
+        if (!hasMarkers && /^@AGENTS\.md\r?$/m.test(existing)) {
+            console.log(chalk.yellow("  ⚠ CLAUDE.md 是裸 @AGENTS.md 导入（无 OPENSPEC 标记），CodeGraph 优先约束未写入。如需启用：删除该行后重跑 openspec-pw update。"));
+            return;
+        }
+        if (hasMarkers && blockMatchesExpected(projectRoot, claudeAdapter, claudeWrapperStandardsContent())) {
+            return;
+        }
+    }
+    // Delegate to installOpenSpecBlock which handles create/update/append
+    // with OPENSPEC:START/END markers.
+    installOpenSpecBlock(projectRoot, claudeWrapperStandardsContent(), claudeAdapter);
+}
+/**
+ * Route employee-grade standards into project rules files.
+ *
+ * AGENTS.md is always the single source of truth, regardless of which
+ * editors are detected. If Claude is in use, a thin CLAUDE.md wrapper
+ * with `@AGENTS.md` import is created so Claude loads AGENTS.md as
+ * its project rules. Cline and Cursor auto-detect AGENTS.md natively — no
+ * wrapper needed.
+ */
+export function installProjectRules(projectRoot, standardsContent, detected) {
+    if (detected.length === 0)
+        return;
+    // AGENTS.md is always the single source of truth
+    installOpenSpecBlock(projectRoot, standardsContent, opencodeAdapter);
+    // Thin CLAUDE.md with @AGENTS.md import if Claude is in use
+    if (detected.some((a) => a.id === "claude")) {
+        installClaudeWrapper(projectRoot);
+    }
+    // Register AGENTS.md in opencode.json for OpenCode
+    if (detected.some((a) => a.id === "opencode") && opencodeAdapter.registerInstructions) {
+        const existing = readOpenCodeInstructions(projectRoot);
+        const next = Array.from(new Set([...(existing ?? []), "AGENTS.md"]));
+        opencodeAdapter.registerInstructions(projectRoot, next);
+    }
+}
+/** Remove all OpenSpec marker blocks from AGENTS.md (always) and CLAUDE.md (for claude adapter). */
+export function cleanProjectRules(adapter, projectRoot) {
+    // AGENTS.md always has the employee standards (SSOT)
+    removeMarkersFromFile(join(projectRoot, "AGENTS.md"), "AGENTS.md");
+    // CLAUDE.md may have the wrapper import if Claude is detected
+    if (adapter.id === "claude") {
+        removeMarkersFromFile(adapter.projectRulesPath(projectRoot), basename(adapter.projectRulesPath(projectRoot)));
+    }
+}
+/** Remove OpenSpec marker blocks from a single file. Only edits within markers. */
+function removeMarkersFromFile(dest, fileLabel) {
+    if (!existsSync(dest)) {
+        console.log(chalk.gray(`  - ${fileLabel} not found, skipping`));
+        return;
+    }
+    const existing = readFileSync(dest, "utf-8");
+    if (!existing.includes("<!-- OPENSPEC:START -->")) {
+        console.log(chalk.gray(`  - No OpenSpec markers found in ${fileLabel}`));
+        return;
+    }
+    // Remove markers and their content, consuming surrounding whitespace.
+    // Then collapse runs of 3+ blank lines to at most 2 for a clean result.
+    let updated = existing.replace(/\s*<!-- OPENSPEC:START -->[\s\S]*?<!-- OPENSPEC:END -->\s*/g, "\n\n").replace(/\n{3,}/g, "\n\n").trim();
+    // Delete empty file rather than leaving a ghost.
+    if (updated === "") {
+        rmSync(dest);
+        console.log(chalk.green(`  ✓ Removed empty ${fileLabel}`));
+        return;
+    }
+    writeFileSync(dest, updated + "\n");
+    console.log(chalk.green(`  ✓ Removed OpenSpec markers from ${fileLabel}`));
+}
+/** Read the employee-grade standards source file (empty string if missing). */
+export function readEmployeeStandards(srcPath) {
+    return existsSync(srcPath) ? readFileSync(srcPath, "utf-8") : "";
+}
+//# sourceMappingURL=project-rules.js.map

package/dist/commands/editors/project-rules.js.map

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

package/dist/commands/editors/registry.d.ts

@@ -0,0 +1,12 @@
+import type { CommandMeta, EditorAdapter, EditorId } from "./types.js";
+export declare function getAdapter(id: EditorId): EditorAdapter | undefined;
+/** All registered editors, regardless of detection. */
+export declare function getAllAdapters(): EditorAdapter[];
+export declare function detectAdapters(projectRoot: string, homeDir?: string): EditorAdapter[];
+export declare function registerAdapter(adapter: EditorAdapter): void;
+/** Slash-command hint for user-facing messages. */
+export declare function slashCommandForAdapter(adapter: EditorAdapter): string;
+/** Relative paths installCommand writes for this adapter + meta. */
+export declare function listCommandArtifactPaths(adapter: EditorAdapter, meta: CommandMeta): string[];
+/** Install the command file (and optional extraArtifacts) for one adapter. */
+export declare function installCommand(adapter: EditorAdapter, meta: CommandMeta, projectRoot: string): void;

package/dist/commands/editors/registry.js

@@ -0,0 +1,59 @@
+/**
+ * Adapter registry: the ADAPTERS array plus lookup/detection/install
+ * helpers. Adapters self-register on module load (each adapters/*.ts
+ * calls registerAdapter); this module deliberately imports no adapter so
+ * the dependency graph stays acyclic (adapters -> registry).
+ *
+ * Registration order is load order and MUST stay:
+ *   claude, opencode, cline, cursor, pi, omp, dsh
+ * (editors.ts re-exports the adapter modules in exactly that order;
+ * tests/editors-tools.test.ts asserts it.)
+ */
+import { mkdirSync, writeFileSync } from "fs";
+import { dirname, resolve as pathResolve } from "path";
+import chalk from "chalk";
+// ─── Registry ────────────────────────────────────────────────────────────
+const ADAPTERS = [
+// Adapters are registered after const declarations at the bottom of this file.
+];
+export function getAdapter(id) {
+    return ADAPTERS.find((a) => a.id === id);
+}
+/** All registered editors, regardless of detection. */
+export function getAllAdapters() {
+    return [...ADAPTERS];
+}
+export function detectAdapters(projectRoot, homeDir) {
+    return ADAPTERS.filter((a) => a.detect(projectRoot, homeDir));
+}
+export function registerAdapter(adapter) {
+    ADAPTERS.push(adapter);
+}
+/** Slash-command hint for user-facing messages. */
+export function slashCommandForAdapter(adapter) {
+    return adapter.id === "claude" ? "/opsx:e2e" : "/opsx-e2e";
+}
+/** Relative paths installCommand writes for this adapter + meta. */
+export function listCommandArtifactPaths(adapter, meta) {
+    const paths = [adapter.commandFilePath(meta.id)];
+    for (const extra of adapter.extraArtifacts?.(meta) ?? []) {
+        paths.push(extra.relativePath);
+    }
+    return paths;
+}
+// ─── Install helpers ─────────────────────────────────────────────────────
+/** Install the command file (and optional extraArtifacts) for one adapter. */
+export function installCommand(adapter, meta, projectRoot) {
+    const relPath = adapter.commandFilePath(meta.id);
+    const absPath = pathResolve(projectRoot, relPath);
+    mkdirSync(dirname(absPath), { recursive: true });
+    writeFileSync(absPath, adapter.formatCommand(meta));
+    console.log(chalk.green(`  ✓ ${adapter.label}: ${relPath}`));
+    for (const extra of adapter.extraArtifacts?.(meta) ?? []) {
+        const extraAbs = pathResolve(projectRoot, extra.relativePath);
+        mkdirSync(dirname(extraAbs), { recursive: true });
+        writeFileSync(extraAbs, extra.contents);
+        console.log(chalk.green(`  ✓ ${adapter.label}: ${extra.relativePath}`));
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/editors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/commands/editors/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,4EAA4E;AAE5E,MAAM,QAAQ,GAAoB;AAChC,+EAA+E;CAChF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAY;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,OAAgB;IAEhB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CAAC,OAAsB;IAC3D,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,wBAAwB,CACtC,OAAsB,EACtB,IAAiB;IAEjB,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAE5E,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAC5B,OAAsB,EACtB,IAAiB,EACjB,WAAmB;IAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9D,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/commands/editors/shared.d.ts

@@ -0,0 +1,37 @@
+/** Escape a value for safe inclusion in a YAML frontmatter scalar. */
+export declare function escapeYamlValue(value: string): string;
+/** Format tags as a YAML inline array. */
+export declare function formatTagsArray(tags: string[]): string;
+/**
+ * OpenCode slash-command names are hyphenated (`/opsx-e2e`), Claude's are
+ * colon-prefixed (`/opsx:e2e`). Rewrite all `/opsx:` references in a
+ * command body for OpenCode installation.
+ */
+export declare function transformToHyphenCommands(text: string): string;
+export interface CommandMeta {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    body: string;
+}
+/** Build the command metadata for the /opsx:e2e command. */
+export declare function buildCommandMeta(body: string): CommandMeta;
+export interface McpStdioServer {
+    command: string;
+    args: string[];
+}
+export type McpServersFile = Record<string, unknown> & {
+    mcpServers: Record<string, McpStdioServer>;
+};
+/**
+ * Read an MCP config file with a top-level `mcpServers` map, or null if
+ * missing/unparseable. Preserves unknown top-level fields.
+ */
+export declare function readMcpServersFile(configPath: string): McpServersFile | null;
+/** Write an MCP config file, creating parent directories if needed. */
+export declare function writeMcpServersFile(configPath: string, config: McpServersFile): void;
+export declare function isMcpServerInFile(configPath: string, serverName: string): boolean;
+export declare function installMcpServerInFile(configPath: string, serverName: string, command: string[]): void;
+export declare function removeMcpServerFromFile(configPath: string, serverName: string): void;

package/dist/commands/editors/shared.js

@@ -0,0 +1,92 @@
+/**
+ * Cross-editor shared helpers: YAML frontmatter escaping, command body
+ * transforms, command metadata, and the mcpServers JSON file family
+ * (Cline / Cursor / Oh My Pi).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname } from "path";
+// ─── YAML helpers (shared by Claude frontmatter and elsewhere) ───────────
+/** Escape a value for safe inclusion in a YAML frontmatter scalar. */
+export function escapeYamlValue(value) {
+    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
+    if (needsQuoting) {
+        const escaped = value
+            .replace(/\\/g, "\\\\")
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, "\\n");
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/** Format tags as a YAML inline array. */
+export function formatTagsArray(tags) {
+    return `[${tags.map((t) => escapeYamlValue(t)).join(", ")}]`;
+}
+// ─── Body transform ──────────────────────────────────────────────────────
+/**
+ * OpenCode slash-command names are hyphenated (`/opsx-e2e`), Claude's are
+ * colon-prefixed (`/opsx:e2e`). Rewrite all `/opsx:` references in a
+ * command body for OpenCode installation.
+ */
+export function transformToHyphenCommands(text) {
+    return text.replace(/\/opsx:/g, "/opsx-");
+}
+/** Build the command metadata for the /opsx:e2e command. */
+export function buildCommandMeta(body) {
+    return {
+        id: "e2e",
+        name: "OPSX: E2E",
+        description: "Run Playwright E2E verification for an OpenSpec change",
+        category: "OpenSpec",
+        tags: ["openspec", "playwright", "e2e", "testing"],
+        body,
+    };
+}
+/**
+ * Read an MCP config file with a top-level `mcpServers` map, or null if
+ * missing/unparseable. Preserves unknown top-level fields.
+ */
+export function readMcpServersFile(configPath) {
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+        if (raw.mcpServers && typeof raw.mcpServers === "object") {
+            return raw;
+        }
+        raw.mcpServers = {};
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write an MCP config file, creating parent directories if needed. */
+export function writeMcpServersFile(configPath, config) {
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+export function isMcpServerInFile(configPath, serverName) {
+    const config = readMcpServersFile(configPath);
+    if (!config)
+        return false;
+    return config.mcpServers[serverName] !== undefined;
+}
+export function installMcpServerInFile(configPath, serverName, command) {
+    const config = readMcpServersFile(configPath) ?? { mcpServers: {} };
+    config.mcpServers[serverName] = {
+        command: command[0],
+        args: command.slice(1),
+    };
+    writeMcpServersFile(configPath, config);
+}
+export function removeMcpServerFromFile(configPath, serverName) {
+    const config = readMcpServersFile(configPath);
+    if (!config)
+        return;
+    if (config.mcpServers[serverName] === undefined)
+        return;
+    delete config.mcpServers[serverName];
+    writeMcpServersFile(configPath, config);
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/editors/shared.js.map

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

package/dist/commands/editors/tool-selection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `--tools` flag parsing for `openspec-pw init` — mirrors upstream
+ * OpenSpec semantics (all | none | comma-separated ids).
+ */
+import type { EditorId } from "./types.js";
+/**
+ * Parse the `--tools` flag value for `openspec-pw init`.
+ *
+ * Returns the selected editor ids, or `null` when the flag was not provided.
+ * Mirrors the upstream OpenSpec `openspec init --tools` semantics:
+ *   - "all" → every registered editor
+ *   - "none" → no editors
+ *   - comma-separated ids, case-insensitive; "oh-my-pi" aliases "omp"
+ *   - mixing "all"/"none" with specific ids, or unknown ids, throw
+ *   - duplicate ids are deduplicated preserving first-occurrence order
+ */
+export declare function resolveToolsArg(toolsArg: string | undefined): EditorId[] | null;

package/dist/commands/editors/tool-selection.js

@@ -0,0 +1,60 @@
+import { getAllAdapters } from "./registry.js";
+// ─── Tool selection (--tools flag) ───────────────────────────────────────
+/** Aliases accepted by `--tools` in addition to canonical EditorIds. */
+const TOOL_ID_ALIASES = {
+    "oh-my-pi": "omp",
+};
+const RESERVED_TOOLS = new Set(["all", "none"]);
+/**
+ * Parse the `--tools` flag value for `openspec-pw init`.
+ *
+ * Returns the selected editor ids, or `null` when the flag was not provided.
+ * Mirrors the upstream OpenSpec `openspec init --tools` semantics:
+ *   - "all" → every registered editor
+ *   - "none" → no editors
+ *   - comma-separated ids, case-insensitive; "oh-my-pi" aliases "omp"
+ *   - mixing "all"/"none" with specific ids, or unknown ids, throw
+ *   - duplicate ids are deduplicated preserving first-occurrence order
+ */
+export function resolveToolsArg(toolsArg) {
+    if (typeof toolsArg === "undefined")
+        return null;
+    const raw = toolsArg.trim();
+    if (raw.length === 0) {
+        throw new Error('The --tools option requires a value. Use "all", "none", or a comma-separated list of editor ids.');
+    }
+    const editorIds = getAllAdapters().map((a) => a.id);
+    const availableList = ["all", "none", ...editorIds].join(", ");
+    const lowerRaw = raw.toLowerCase();
+    if (lowerRaw === "all")
+        return [...editorIds];
+    if (lowerRaw === "none")
+        return [];
+    const tokens = raw
+        .split(",")
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+    if (tokens.length === 0) {
+        throw new Error('The --tools option requires at least one editor id when not using "all" or "none".');
+    }
+    const normalized = tokens.map((t) => {
+        const lower = t.toLowerCase();
+        return TOOL_ID_ALIASES[lower] ?? lower;
+    });
+    if (normalized.some((t) => RESERVED_TOOLS.has(t))) {
+        throw new Error('Cannot combine reserved values "all" or "none" with specific editor ids.');
+    }
+    const invalid = normalized.filter((t) => !editorIds.includes(t));
+    if (invalid.length > 0) {
+        throw new Error(`Invalid tool id(s): ${invalid.join(", ")}. Available values: ${availableList}`);
+    }
+    // Deduplicate while preserving order
+    const deduped = [];
+    for (const id of normalized) {
+        const editorId = id;
+        if (!deduped.includes(editorId))
+            deduped.push(editorId);
+    }
+    return deduped;
+}
+//# sourceMappingURL=tool-selection.js.map

package/dist/commands/editors/tool-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection.js","sourceRoot":"","sources":["../../../src/commands/editors/tool-selection.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,4EAA4E;AAE5E,wEAAwE;AACxE,MAAM,eAAe,GAA6B;IAChD,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA4B;IAE5B,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/D,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAG,GAAG;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAa,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAa,CAAC,CAAC,CAAC;IAC7E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,aAAa,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,EAAc,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/editors/types.d.ts

@@ -0,0 +1,82 @@
+export interface CommandMeta {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    body: string;
+}
+/** Build the command metadata for the /opsx:e2e command. */
+export declare function buildCommandMeta(body: string): CommandMeta;
+export type EditorId = "claude" | "opencode" | "cline" | "cursor" | "pi" | "omp" | "dsh";
+export interface ExtraArtifact {
+    relativePath: string;
+    contents: string;
+}
+export interface EditorAdapter {
+    id: EditorId;
+    /** Short label used in log messages. */
+    label: string;
+    /** Human-readable name used in user-facing messages. */
+    displayName: string;
+    /**
+     * True if this editor's config dir is present in the project.
+     * Some adapters (Pi, Oh My Pi) also treat a global config dir in the
+     * user's home as a detection signal — `homeDir` lets tests inject a
+     * fake home so detection stays hermetic.
+     */
+    detect(projectRoot: string, homeDir?: string): boolean;
+    /**
+     * True when this editor has an MCP client to configure. False skips all
+     * MCP install/check/remove phases (Pi has no MCP client).
+     */
+    supportsMcp?: boolean;
+    /** Relative path of the command file inside the project. */
+    commandFilePath(id: string): string;
+    /** Format command file contents (frontmatter + body). */
+    formatCommand(meta: CommandMeta): string;
+    /** Absolute path of the project rules file. */
+    projectRulesPath(projectRoot: string): string;
+    /** True if MCP server `serverName` is already configured. */
+    isMcpInstalled(projectRoot: string, serverName: string): boolean;
+    /** Install MCP server config in this editor. */
+    installMcp(projectRoot: string, serverName: string, command: string[]): void;
+    /** Remove MCP server config from this editor. */
+    removeMcp(projectRoot: string, serverName: string): void;
+    /** Optional: register project rules file path in editor config. */
+    registerInstructions?(projectRoot: string, instructions: string[]): void;
+    /** Optional: secondary files written alongside commandFilePath (Cursor skill). */
+    extraArtifacts?(meta: CommandMeta): ExtraArtifact[];
+}
+/**
+ * Input shape for `defineAdapter` — declares the contract for an editor
+ * adapter with sensible defaults for the no-MCP-client case (Pi, dsh).
+ * All required-by-behavior fields are still required; optional ones
+ * (supportsMcp, projectRulesPath, isMcpInstalled, installMcp, removeMcp)
+ * fall back to defaults.
+ */
+export interface EditorAdapterInit {
+    id: EditorId;
+    label: string;
+    displayName: string;
+    detect: EditorAdapter["detect"];
+    commandFilePath: EditorAdapter["commandFilePath"];
+    formatCommand: EditorAdapter["formatCommand"];
+    /** Optional: true by default; set false for editors without an MCP client. */
+    supportsMcp?: boolean;
+    /** Optional: defaults to `<root>/AGENTS.md`. Override for Claude (CLAUDE.md). */
+    projectRulesPath?: EditorAdapter["projectRulesPath"];
+    /** Required when supportsMcp !== false. Defaults to `() => false`. */
+    isMcpInstalled?: EditorAdapter["isMcpInstalled"];
+    /** Required when supportsMcp !== false. Defaults to a no-op. */
+    installMcp?: EditorAdapter["installMcp"];
+    /** Required when supportsMcp !== false. Defaults to a no-op. */
+    removeMcp?: EditorAdapter["removeMcp"];
+    registerInstructions?: EditorAdapter["registerInstructions"];
+    extraArtifacts?: EditorAdapter["extraArtifacts"];
+}
+/**
+ * Build an `EditorAdapter` from a partial init object. Fills in
+ * defaults so each adapter only declares what's actually different.
+ */
+export declare function defineAdapter(init: EditorAdapterInit): EditorAdapter;