openspec-playwright 0.3.73 → 0.3.75

package/dist/commands/editors/adapters/cursor.d.ts

@@ -0,0 +1,15 @@
+import { type EditorAdapter, type CommandMeta } from "../types.js";
+/**
+ * Cursor slash commands are plain markdown (no frontmatter); the filename
+ * is the command name. `$1` is the change-name argument.
+ */
+export declare function formatCursorCommand(meta: CommandMeta): string;
+export declare function getCursorCommandPath(id: string): string;
+export declare function getCursorSkillPath(id: string): string;
+/**
+ * Cursor Agent Skill — explicit invocation only (`disable-model-invocation`).
+ * No `$1` placeholders (those belong to the slash command file).
+ */
+export declare function formatCursorSkill(meta: CommandMeta): string;
+export declare function hasCursor(projectRoot: string): boolean;
+export declare const cursorAdapter: EditorAdapter;

package/dist/commands/editors/adapters/cursor.js

@@ -0,0 +1,79 @@
+/**
+ * Cursor adapter: slash command at `.cursor/commands/opsx-<id>.md` (plain
+ * markdown) plus an Agent Skill at `.cursor/skills/opsx-<id>/SKILL.md`;
+ * MCP lives in `.cursor/mcp.json`. Cursor auto-detects AGENTS.md.
+ */
+import { existsSync } from "fs";
+import { join } from "path";
+import { defineAdapter } from "../types.js";
+import { escapeYamlValue, transformToHyphenCommands, isMcpServerInFile, installMcpServerInFile, removeMcpServerFromFile, } from "../shared.js";
+import { registerAdapter } from "../registry.js";
+// ─── Cursor adapter (format / paths) ─────────────────────────────────────
+/**
+ * Cursor slash commands are plain markdown (no frontmatter); the filename
+ * is the command name. `$1` is the change-name argument.
+ */
+export function formatCursorCommand(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    return `<!-- Change name: $1 (e.g. /opsx-${meta.id} my-change) -->
+
+${body}
+`;
+}
+export function getCursorCommandPath(id) {
+    return join(".cursor", "commands", `opsx-${id}.md`);
+}
+export function getCursorSkillPath(id) {
+    return join(".cursor", "skills", `opsx-${id}`, "SKILL.md");
+}
+/**
+ * Cursor Agent Skill — explicit invocation only (`disable-model-invocation`).
+ * No `$1` placeholders (those belong to the slash command file).
+ */
+export function formatCursorSkill(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    const skillName = `opsx-${meta.id}`;
+    return `---
+name: ${escapeYamlValue(skillName)}
+description: ${escapeYamlValue(meta.description)}
+disable-model-invocation: true
+---
+
+${body}
+`;
+}
+export function hasCursor(projectRoot) {
+    return existsSync(join(projectRoot, ".cursor"));
+}
+export const cursorAdapter = defineAdapter({
+    id: "cursor",
+    label: "cursor",
+    displayName: "Cursor",
+    detect: hasCursor,
+    commandFilePath: getCursorCommandPath,
+    formatCommand: formatCursorCommand,
+    // Cursor auto-detects AGENTS.md — that's the default.
+    isMcpInstalled(projectRoot, serverName) {
+        return isMcpServerInFile(cursorMcpPath(projectRoot), serverName);
+    },
+    installMcp(projectRoot, serverName, command) {
+        installMcpServerInFile(cursorMcpPath(projectRoot), serverName, command);
+    },
+    removeMcp(projectRoot, serverName) {
+        removeMcpServerFromFile(cursorMcpPath(projectRoot), serverName);
+    },
+    extraArtifacts(meta) {
+        return [
+            {
+                relativePath: getCursorSkillPath(meta.id),
+                contents: formatCursorSkill(meta),
+            },
+        ];
+    },
+});
+/** Path to the project-level MCP config file for Cursor. */
+function cursorMcpPath(projectRoot) {
+    return join(projectRoot, ".cursor", "mcp.json");
+}
+registerAdapter(cursorAdapter);
+//# sourceMappingURL=cursor.js.map

package/dist/commands/editors/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../../src/commands/editors/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAwC,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,4EAA4E;AAE5E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAiB;IACnD,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,oCAAoC,IAAI,CAAC,EAAE;;EAElD,IAAI;CACL,CAAC;AACF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;IACpC,OAAO;QACD,eAAe,CAAC,SAAS,CAAC;eACnB,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;;;;EAI9C,IAAI;CACL,CAAC;AACF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB,aAAa,CAAC;IACxD,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,oBAAoB;IACrC,aAAa,EAAE,mBAAmB;IAClC,sDAAsD;IACtD,cAAc,CAAC,WAAW,EAAE,UAAU;QACpC,OAAO,iBAAiB,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IACD,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO;QACzC,sBAAsB,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IACD,SAAS,CAAC,WAAW,EAAE,UAAU;QAC/B,uBAAuB,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IACD,cAAc,CAAC,IAAI;QACjB,OAAO;YACL;gBACE,YAAY,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC;aAClC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,4DAA4D;AAC5D,SAAS,aAAa,CAAC,WAAmB;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,eAAe,CAAC,aAAa,CAAC,CAAC"}

package/dist/commands/editors/adapters/dsh.d.ts

@@ -0,0 +1,27 @@
+import { type EditorAdapter, type CommandMeta } from "../types.js";
+/**
+ * DeepSeek Harness (dsh) stores project skills in `.dsh/skills/` — the
+ * `project-dsh` local provider root, rank 100 (highest local priority).
+ * Skills are directory bundles (`<name>/SKILL.md`) with YAML frontmatter
+ * (name + description); the kebab-case name becomes the model-invocable
+ * skill name (`opsx-e2e`).
+ *
+ * Conventions follow the dsh skills subsystem (docs/subsystems/skills.md):
+ *   - Skills:   `.dsh/skills/<name>/SKILL.md`, invoked via the `skill` tool.
+ *   - Rules:    dsh reads `AGENTS.md` / `CLAUDE.md` natively (default
+ *               instructionFileCandidates) — no wrapper file needed.
+ *   - MCP:      dsh configures MCP via `cordis.yml` plugin config
+ *               (@deepseek-ai/dsh-mcp-client), not a simple mcpServers file —
+ *               the adapter declares `supportsMcp: false` so shared MCP phases
+ *               skip it (configure Playwright MCP manually in cordis.yml).
+ *   - Detected via `.dsh/` or the global `~/.dsh/` (DSH_HOME).
+ */
+export declare function formatDshCommand(meta: CommandMeta): string;
+export declare function getDshCommandPath(id: string): string;
+/**
+ * True when DeepSeek Harness is in use: a project `.dsh/` dir, or the global
+ * dsh home (`~/.dsh/`, DSH_HOME). The home signal lets `openspec-pw init`
+ * detect dsh in a fresh project that has no `.dsh/` yet.
+ */
+export declare function hasDsh(projectRoot: string, homeDir?: string): boolean;
+export declare const dshAdapter: EditorAdapter;

package/dist/commands/editors/adapters/dsh.js

@@ -0,0 +1,67 @@
+/**
+ * DeepSeek Harness adapter: skill bundle at `.dsh/skills/opsx-<id>/SKILL.md`
+ * (project-dsh root, rank 100). NO simple MCP file — cordis.yml plugin
+ * config instead, so `supportsMcp: false`. Detected via `.dsh/` or
+ * global `~/.dsh/` (DSH_HOME).
+ */
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { defineAdapter } from "../types.js";
+import { escapeYamlValue, transformToHyphenCommands } from "../shared.js";
+import { registerAdapter } from "../registry.js";
+// ─── DeepSeek Harness adapter ────────────────────────────────────────────
+/**
+ * DeepSeek Harness (dsh) stores project skills in `.dsh/skills/` — the
+ * `project-dsh` local provider root, rank 100 (highest local priority).
+ * Skills are directory bundles (`<name>/SKILL.md`) with YAML frontmatter
+ * (name + description); the kebab-case name becomes the model-invocable
+ * skill name (`opsx-e2e`).
+ *
+ * Conventions follow the dsh skills subsystem (docs/subsystems/skills.md):
+ *   - Skills:   `.dsh/skills/<name>/SKILL.md`, invoked via the `skill` tool.
+ *   - Rules:    dsh reads `AGENTS.md` / `CLAUDE.md` natively (default
+ *               instructionFileCandidates) — no wrapper file needed.
+ *   - MCP:      dsh configures MCP via `cordis.yml` plugin config
+ *               (@deepseek-ai/dsh-mcp-client), not a simple mcpServers file —
+ *               the adapter declares `supportsMcp: false` so shared MCP phases
+ *               skip it (configure Playwright MCP manually in cordis.yml).
+ *   - Detected via `.dsh/` or the global `~/.dsh/` (DSH_HOME).
+ */
+export function formatDshCommand(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    const skillName = `opsx-${meta.id}`;
+    return `---
+name: ${escapeYamlValue(skillName)}
+description: ${escapeYamlValue(meta.description)}
+---
+
+${body}
+`;
+}
+export function getDshCommandPath(id) {
+    return join(".dsh", "skills", `opsx-${id}`, "SKILL.md");
+}
+/**
+ * True when DeepSeek Harness is in use: a project `.dsh/` dir, or the global
+ * dsh home (`~/.dsh/`, DSH_HOME). The home signal lets `openspec-pw init`
+ * detect dsh in a fresh project that has no `.dsh/` yet.
+ */
+export function hasDsh(projectRoot, homeDir = homedir()) {
+    return (existsSync(join(projectRoot, ".dsh")) ||
+        existsSync(join(homeDir, ".dsh")));
+}
+export const dshAdapter = defineAdapter({
+    id: "dsh",
+    label: "dsh",
+    displayName: "DeepSeek Harness",
+    detect: hasDsh,
+    // dsh configures MCP via cordis.yml plugin config, not a simple file —
+    // shared MCP phases skip this adapter (configure Playwright MCP manually).
+    supportsMcp: false,
+    commandFilePath: getDshCommandPath,
+    formatCommand: formatDshCommand,
+    // dsh reads AGENTS.md natively — that's the default.
+});
+registerAdapter(dshAdapter);
+//# sourceMappingURL=dsh.js.map

package/dist/commands/editors/adapters/dsh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh.js","sourceRoot":"","sources":["../../../../src/commands/editors/adapters/dsh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAwC,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,4EAA4E;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;IACpC,OAAO;QACD,eAAe,CAAC,SAAS,CAAC;eACnB,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;;;EAG9C,IAAI;CACL,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACpB,WAAmB,EACnB,OAAO,GAAG,OAAO,EAAE;IAEnB,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACrC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB,aAAa,CAAC;IACrD,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,kBAAkB;IAC/B,MAAM,EAAE,MAAM;IACd,uEAAuE;IACvE,2EAA2E;IAC3E,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,gBAAgB;IAC/B,qDAAqD;CACtD,CAAC,CAAC;AAEH,eAAe,CAAC,UAAU,CAAC,CAAC"}

package/dist/commands/editors/adapters/omp.d.ts

@@ -0,0 +1,24 @@
+import { type EditorAdapter, type CommandMeta } from "../types.js";
+/**
+ * Oh My Pi (omp) stores project slash commands in `.omp/commands/*.md`
+ * (non-recursive scan, project before user). Native commands are parsed
+ * with FATAL frontmatter parsing, so the YAML must be valid; `name`
+ * overrides the filename and `description` feeds autocomplete. `$1` /
+ * `$ARGUMENTS` placeholders expand at prompt time.
+ *
+ * Conventions follow the omp docs (docs/slash-command-internals.md,
+ * docs/mcp-config.md):
+ *   - Commands:  `.omp/commands/*.md`, invoked via `/name`.
+ *   - MCP:       `.omp/mcp.json` with `{ "mcpServers": { ... } }` — same
+ *                shape as Cline/Cursor. omp also inherits `.claude/` /
+ *                `.cursor/` / opencode MCP configs when present.
+ *   - Rules:     omp reads `AGENTS.md` natively — no wrapper file needed.
+ */
+export declare function formatOmpCommand(meta: CommandMeta): string;
+export declare function getOmpCommandPath(id: string): string;
+/**
+ * True when Oh My Pi is in use: a project `.omp/` dir, or a global omp
+ * config dir (`~/.omp/agent/`, created by omp on first run).
+ */
+export declare function hasOmp(projectRoot: string, homeDir?: string): boolean;
+export declare const ompAdapter: EditorAdapter;

package/dist/commands/editors/adapters/omp.js

@@ -0,0 +1,73 @@
+/**
+ * Oh My Pi adapter: native command at `.omp/commands/opsx-<id>.md`
+ * (FATAL frontmatter parsing — keep YAML valid); MCP in `.omp/mcp.json`.
+ * Detected via `.omp/` or global `~/.omp/agent/`.
+ */
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { defineAdapter } from "../types.js";
+import { escapeYamlValue, transformToHyphenCommands, isMcpServerInFile, installMcpServerInFile, removeMcpServerFromFile, } from "../shared.js";
+import { registerAdapter } from "../registry.js";
+// ─── Oh My Pi adapter ────────────────────────────────────────────────────
+/**
+ * Oh My Pi (omp) stores project slash commands in `.omp/commands/*.md`
+ * (non-recursive scan, project before user). Native commands are parsed
+ * with FATAL frontmatter parsing, so the YAML must be valid; `name`
+ * overrides the filename and `description` feeds autocomplete. `$1` /
+ * `$ARGUMENTS` placeholders expand at prompt time.
+ *
+ * Conventions follow the omp docs (docs/slash-command-internals.md,
+ * docs/mcp-config.md):
+ *   - Commands:  `.omp/commands/*.md`, invoked via `/name`.
+ *   - MCP:       `.omp/mcp.json` with `{ "mcpServers": { ... } }` — same
+ *                shape as Cline/Cursor. omp also inherits `.claude/` /
+ *                `.cursor/` / opencode MCP configs when present.
+ *   - Rules:     omp reads `AGENTS.md` natively — no wrapper file needed.
+ */
+export function formatOmpCommand(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    const cmdName = `opsx-${meta.id}`;
+    return `---
+name: ${escapeYamlValue(cmdName)}
+description: ${escapeYamlValue(meta.description)}
+---
+
+${body}
+`;
+}
+export function getOmpCommandPath(id) {
+    return join(".omp", "commands", `opsx-${id}.md`);
+}
+/**
+ * True when Oh My Pi is in use: a project `.omp/` dir, or a global omp
+ * config dir (`~/.omp/agent/`, created by omp on first run).
+ */
+export function hasOmp(projectRoot, homeDir = homedir()) {
+    return (existsSync(join(projectRoot, ".omp")) ||
+        existsSync(join(homeDir, ".omp", "agent")));
+}
+export const ompAdapter = defineAdapter({
+    id: "omp",
+    label: "omp",
+    displayName: "Oh My Pi",
+    detect: hasOmp,
+    commandFilePath: getOmpCommandPath,
+    formatCommand: formatOmpCommand,
+    // omp reads AGENTS.md natively — that's the default.
+    isMcpInstalled(projectRoot, serverName) {
+        return isMcpServerInFile(ompMcpPath(projectRoot), serverName);
+    },
+    installMcp(projectRoot, serverName, command) {
+        installMcpServerInFile(ompMcpPath(projectRoot), serverName, command);
+    },
+    removeMcp(projectRoot, serverName) {
+        removeMcpServerFromFile(ompMcpPath(projectRoot), serverName);
+    },
+});
+/** Path to the project-level MCP config file for Oh My Pi. */
+function ompMcpPath(projectRoot) {
+    return join(projectRoot, ".omp", "mcp.json");
+}
+registerAdapter(ompAdapter);
+//# sourceMappingURL=omp.js.map

package/dist/commands/editors/adapters/omp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omp.js","sourceRoot":"","sources":["../../../../src/commands/editors/adapters/omp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAwC,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,4EAA4E;AAE5E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;IAClC,OAAO;QACD,eAAe,CAAC,OAAO,CAAC;eACjB,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;;;EAG9C,IAAI;CACL,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,WAAmB,EACnB,OAAO,GAAG,OAAO,EAAE;IAEnB,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACrC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB,aAAa,CAAC;IACrD,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,MAAM;IACd,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,gBAAgB;IAC/B,qDAAqD;IACrD,cAAc,CAAC,WAAW,EAAE,UAAU;QACpC,OAAO,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IACD,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO;QACzC,sBAAsB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IACD,SAAS,CAAC,WAAW,EAAE,UAAU;QAC/B,uBAAuB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;CACF,CAAC,CAAC;AAEH,8DAA8D;AAC9D,SAAS,UAAU,CAAC,WAAmB;IACrC,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,eAAe,CAAC,UAAU,CAAC,CAAC"}

package/dist/commands/editors/adapters/opencode.d.ts

@@ -0,0 +1,8 @@
+import { type EditorAdapter, type CommandMeta } from "../types.js";
+export declare function formatOpenCodeCommand(meta: CommandMeta): string;
+export declare function getOpenCodeCommandPath(id: string): string;
+export declare function hasOpenCode(projectRoot: string): boolean;
+/** Read the current `instructions` array from opencode.json(c), or undefined. */
+declare function readOpenCodeInstructions(projectRoot: string): string[] | undefined;
+export declare const opencodeAdapter: EditorAdapter;
+export { readOpenCodeInstructions };

package/dist/commands/editors/adapters/opencode.js

@@ -0,0 +1,133 @@
+/**
+ * OpenCode adapter: `.opencode/commands/opsx-<id>.md`, description-only
+ * frontmatter; edits `opencode.json(c)` for both MCP (`mcp.playwright`)
+ * and the `instructions` list that routes AGENTS.md into context.
+ */
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { modify, applyEdits, parseTree as parseJsonc, findNodeAtLocation, getNodeValue, } from "jsonc-parser";
+import { defineAdapter } from "../types.js";
+import { escapeYamlValue, transformToHyphenCommands } from "../shared.js";
+import { registerAdapter } from "../registry.js";
+// ─── OpenCode adapter ────────────────────────────────────────────────────
+export function formatOpenCodeCommand(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${body}
+`;
+}
+export function getOpenCodeCommandPath(id) {
+    return join(".opencode", "commands", `opsx-${id}.md`);
+}
+export function hasOpenCode(projectRoot) {
+    return existsSync(join(projectRoot, ".opencode"));
+}
+const JSONC_FORMAT = { tabSize: 2, insertSpaces: true };
+/** Find the first existing opencode.json(c), or null. */
+function findOpenCodeConfig(projectRoot) {
+    for (const name of ["opencode.jsonc", "opencode.json"]) {
+        const p = join(projectRoot, name);
+        if (existsSync(p))
+            return { path: p, text: readFileSync(p, "utf-8") };
+    }
+    return null;
+}
+/**
+ * Set a value at a JSON path inside opencode.json(c), creating the file
+ * with a `$schema` scaffold if it doesn't exist. Replaces any existing
+ * value at the path (does not merge arrays).
+ */
+function setOpenCodeValue(projectRoot, keySegments, value) {
+    const existing = findOpenCodeConfig(projectRoot);
+    const targetPath = existing?.path ?? join(projectRoot, "opencode.jsonc");
+    if (!existing) {
+        const scaffold = {
+            $schema: "https://opencode.ai/config.json",
+        };
+        // Build nested scaffold for multi-segment keys (e.g. ["mcp", "playwright"])
+        let cursor = scaffold;
+        for (let i = 0; i < keySegments.length - 1; i++) {
+            const k = String(keySegments[i]);
+            cursor[k] = {};
+            cursor = cursor[k];
+        }
+        cursor[String(keySegments[keySegments.length - 1])] = value;
+        // ponytail: new file uses 2-space indent; modify branch preserves existing formatting.
+        writeFileSync(targetPath, JSON.stringify(scaffold, null, 2) + "\n");
+        return;
+    }
+    const edits = modify(existing.text, keySegments, value, {
+        formattingOptions: JSONC_FORMAT,
+    });
+    writeFileSync(targetPath, applyEdits(existing.text, edits));
+}
+/** Read the current value at a JSON path (returns undefined if missing). */
+function readOpenCodeValue(text, keySegments) {
+    try {
+        const tree = parseJsonc(text);
+        if (!tree)
+            return undefined;
+        const node = findNodeAtLocation(tree, keySegments);
+        return node ? getNodeValue(node) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Read the current `instructions` array from opencode.json(c), or undefined. */
+function readOpenCodeInstructions(projectRoot) {
+    const config = findOpenCodeConfig(projectRoot);
+    if (!config)
+        return undefined;
+    const value = readOpenCodeValue(config.text, ["instructions"]);
+    if (Array.isArray(value) && value.every((v) => typeof v === "string")) {
+        return value;
+    }
+    return undefined;
+}
+export const opencodeAdapter = defineAdapter({
+    id: "opencode",
+    label: "opencode",
+    displayName: "OpenCode",
+    detect: hasOpenCode,
+    commandFilePath: getOpenCodeCommandPath,
+    formatCommand: formatOpenCodeCommand,
+    // AGENTS.md is the default; not declared explicitly.
+    isMcpInstalled(projectRoot, serverName) {
+        const config = findOpenCodeConfig(projectRoot);
+        if (!config)
+            return false;
+        const value = readOpenCodeValue(config.text, ["mcp", serverName]);
+        return value !== undefined;
+    },
+    installMcp(projectRoot, serverName, command) {
+        setOpenCodeValue(projectRoot, ["mcp", serverName], {
+            type: "local",
+            command,
+        });
+    },
+    removeMcp(projectRoot, serverName) {
+        // Read current mcp map, rebuild without this server, write back
+        const config = findOpenCodeConfig(projectRoot);
+        if (!config)
+            return;
+        const value = readOpenCodeValue(config.text, ["mcp", serverName]);
+        if (value === undefined)
+            return;
+        const current = readOpenCodeValue(config.text, ["mcp"]);
+        if (current && typeof current === "object") {
+            const next = { ...current };
+            delete next[serverName];
+            setOpenCodeValue(projectRoot, ["mcp"], next);
+        }
+    },
+    registerInstructions(projectRoot, instructions) {
+        setOpenCodeValue(projectRoot, ["instructions"], instructions);
+    },
+});
+export { readOpenCodeInstructions };
+registerAdapter(opencodeAdapter);
+//# sourceMappingURL=opencode.js.map

package/dist/commands/editors/adapters/opencode.js.map

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

package/dist/commands/editors/adapters/pi.d.ts

@@ -0,0 +1,27 @@
+import { type EditorAdapter, type CommandMeta } from "../types.js";
+/**
+ * Pi stores project resources in `.pi/` (skills/, prompts/, extensions/).
+ * Prompt templates are Markdown with optional YAML frontmatter; the
+ * filename becomes the slash command name (`opsx-e2e.md` → `/opsx-e2e`),
+ * `description` feeds autocomplete, and `argument-hint` shows expected
+ * arguments. `$1` / `$ARGUMENTS` placeholders expand at prompt time.
+ *
+ * Conventions follow the Pi docs (packages/coding-agent/docs):
+ *   - Prompts:   `.pi/prompts/*.md`, invoked via `/name`.
+ *   - Skills:    `.pi/skills/` (root `.md` files or `SKILL.md` dirs),
+ *                invoked via `/skill:name`.
+ *   - Rules:     Pi loads `AGENTS.md` (or `CLAUDE.md`) walking up from cwd
+ *                natively — no wrapper file needed.
+ *   - MCP:       Pi has NO MCP client (built-in tools only). The adapter
+ *                still implements the interface with no-ops and declares
+ *                `supportsMcp: false` so shared MCP phases skip it.
+ */
+export declare function formatPiCommand(meta: CommandMeta): string;
+export declare function getPiCommandPath(id: string): string;
+/**
+ * True when Pi is in use: a project `.pi/` dir, or a global Pi config dir
+ * (`~/.pi/agent/`, created by Pi on first run). The home signal lets
+ * `openspec-pw init` detect Pi in a fresh project that has no `.pi/` yet.
+ */
+export declare function hasPi(projectRoot: string, homeDir?: string): boolean;
+export declare const piAdapter: EditorAdapter;

package/dist/commands/editors/adapters/pi.js

@@ -0,0 +1,64 @@
+/**
+ * Pi adapter: prompt template at `.pi/prompts/opsx-<id>.md` (filename =
+ * slash command). NO MCP client — `supportsMcp: false` makes shared MCP
+ * phases skip it. Detected via `.pi/` or global `~/.pi/agent/`.
+ */
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { defineAdapter } from "../types.js";
+import { escapeYamlValue, transformToHyphenCommands } from "../shared.js";
+import { registerAdapter } from "../registry.js";
+// ─── Pi adapter ──────────────────────────────────────────────────────────
+/**
+ * Pi stores project resources in `.pi/` (skills/, prompts/, extensions/).
+ * Prompt templates are Markdown with optional YAML frontmatter; the
+ * filename becomes the slash command name (`opsx-e2e.md` → `/opsx-e2e`),
+ * `description` feeds autocomplete, and `argument-hint` shows expected
+ * arguments. `$1` / `$ARGUMENTS` placeholders expand at prompt time.
+ *
+ * Conventions follow the Pi docs (packages/coding-agent/docs):
+ *   - Prompts:   `.pi/prompts/*.md`, invoked via `/name`.
+ *   - Skills:    `.pi/skills/` (root `.md` files or `SKILL.md` dirs),
+ *                invoked via `/skill:name`.
+ *   - Rules:     Pi loads `AGENTS.md` (or `CLAUDE.md`) walking up from cwd
+ *                natively — no wrapper file needed.
+ *   - MCP:       Pi has NO MCP client (built-in tools only). The adapter
+ *                still implements the interface with no-ops and declares
+ *                `supportsMcp: false` so shared MCP phases skip it.
+ */
+export function formatPiCommand(meta) {
+    const body = transformToHyphenCommands(meta.body);
+    return `---
+description: ${escapeYamlValue(meta.description)}
+argument-hint: "<change-name>"
+---
+
+${body}
+`;
+}
+export function getPiCommandPath(id) {
+    return join(".pi", "prompts", `opsx-${id}.md`);
+}
+/**
+ * True when Pi is in use: a project `.pi/` dir, or a global Pi config dir
+ * (`~/.pi/agent/`, created by Pi on first run). The home signal lets
+ * `openspec-pw init` detect Pi in a fresh project that has no `.pi/` yet.
+ */
+export function hasPi(projectRoot, homeDir = homedir()) {
+    return (existsSync(join(projectRoot, ".pi")) ||
+        existsSync(join(homeDir, ".pi", "agent")));
+}
+export const piAdapter = defineAdapter({
+    id: "pi",
+    label: "pi",
+    displayName: "Pi",
+    detect: hasPi,
+    // Pi has no MCP client — shared MCP phases skip this adapter.
+    supportsMcp: false,
+    commandFilePath: getPiCommandPath,
+    formatCommand: formatPiCommand,
+    // Pi loads AGENTS.md natively (walking up from cwd) — that's the default.
+});
+registerAdapter(piAdapter);
+//# sourceMappingURL=pi.js.map

package/dist/commands/editors/adapters/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../../../../src/commands/editors/adapters/pi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAwC,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,4EAA4E;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAiB;IAC/C,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO;eACM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;;;;EAI9C,IAAI;CACL,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CACnB,WAAmB,EACnB,OAAO,GAAG,OAAO,EAAE;IAEnB,OAAO,CACL,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAkB,aAAa,CAAC;IACpD,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,KAAK;IACb,8DAA8D;IAC9D,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,eAAe;IAC9B,0EAA0E;CAC3E,CAAC,CAAC;AAEH,eAAe,CAAC,SAAS,CAAC,CAAC"}

package/dist/commands/editors/project-rules.d.ts

@@ -0,0 +1,69 @@
+import type { EditorAdapter } from "./types.js";
+/**
+ * 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 declare function readOpenSpecBlock(projectRoot: string, adapter: EditorAdapter): string | null;
+/**
+ * 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 declare function blockMatchesExpected(projectRoot: string, adapter: EditorAdapter, expected: string): boolean;
+/**
+ * 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 declare function installOpenSpecBlock(projectRoot: string, standardsContent: string, adapter?: EditorAdapter): void;
+/**
+ * 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 declare function claudeWrapperStandardsContent(): string;
+/**
+ * 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 declare function installClaudeWrapper(projectRoot: string): void;
+/**
+ * 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 declare function installProjectRules(projectRoot: string, standardsContent: string, detected: EditorAdapter[]): void;
+/** Remove all OpenSpec marker blocks from AGENTS.md (always) and CLAUDE.md (for claude adapter). */
+export declare function cleanProjectRules(adapter: EditorAdapter, projectRoot: string): void;
+/** Read the employee-grade standards source file (empty string if missing). */
+export declare function readEmployeeStandards(srcPath: string): string;