compound-workflow 1.8.0 → 1.9.1

package/.claude-plugin/plugin.json

@@ -1,7 +0,0 @@
-{
-  "name": "compound-workflow",
-  "description": "Clarify -> plan -> execute -> verify -> capture workflow: commands, skills, and agents for Claude Code",
-  "author": {
-    "name": "Compound Workflow"
-  }
-}

package/.cursor-plugin/plugin.json

@@ -1,20 +0,0 @@
-{
-  "name": "compound-workflow",
-  "version": "1.8.0",
-  "description": "Clarify -> plan -> execute -> verify -> capture workflow for Cursor",
-  "author": {
-    "name": "Compound Workflow"
-  },
-  "keywords": [
-    "workflow",
-    "cursor",
-    "agents",
-    "commands",
-    "skills"
-  ],
-  "license": "MIT",
-  "repository": "https://github.com/cjerochim/compound-workflow",
-  "commands": "./src/.agents/commands",
-  "agents": "./src/.agents/agents",
-  "skills": "./src/.agents/skills"
-}

package/.cursor-plugin/registration.json

@@ -1,5 +0,0 @@
-{
-  "pluginId": "compound-workflow@local",
-  "scope": "user",
-  "installPath": "/Users/cjerochim/Documents/DEVELOPMENT/compound-workflow"
-}

package/scripts/check-version-parity.mjs

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-/**
- * Exit 0 if package.json version matches .cursor-plugin/plugin.json and .claude-plugin/plugin.json.
- * Used in CI to validate release artifact sync.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const root = path.resolve(__dirname, "..");
-
-const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
-const cursorPlugin = JSON.parse(
-  fs.readFileSync(path.join(root, ".cursor-plugin", "plugin.json"), "utf8")
-);
-const claudePlugin = JSON.parse(
-  fs.readFileSync(path.join(root, ".claude-plugin", "plugin.json"), "utf8")
-);
-
-const expected = pkg.version;
-
-// Claude Code's plugin.json is intentionally minimal (see scripts/generate-platform-artifacts.mjs)
-// and may not include a version field. When absent, treat it as not applicable.
-const claudeVersion = claudePlugin.version;
-const claudeOk = claudeVersion == null || claudeVersion === expected;
-
-if (cursorPlugin.version !== expected || !claudeOk) {
-  console.error(
-    "Version mismatch: package.json=%s, .cursor-plugin/plugin.json=%s, .claude-plugin/plugin.json=%s",
-    expected,
-    cursorPlugin.version,
-    claudeVersion
-  );
-  process.exit(1);
-}

package/scripts/generate-platform-artifacts.mjs

@@ -1,230 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const repoRoot = path.resolve(__dirname, "..");
-const agentsRoot = path.join(repoRoot, "src", ".agents");
-
-function loadRegistry() {
-  const registryPath = path.join(agentsRoot, "registry.json");
-  if (!fs.existsSync(registryPath)) {
-    throw new Error(`Registry not found at ${registryPath}`);
-  }
-  return JSON.parse(fs.readFileSync(registryPath, "utf8"));
-}
-
-function walkFiles(dirAbs, predicate) {
-  const out = [];
-  const stack = [dirAbs];
-  while (stack.length) {
-    const cur = stack.pop();
-    let entries;
-    try {
-      entries = fs.readdirSync(cur, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const e of entries) {
-      const p = path.join(cur, e.name);
-      if (e.isDirectory()) stack.push(p);
-      else if (e.isFile() && predicate(p)) out.push(p);
-    }
-  }
-  out.sort();
-  return out;
-}
-
-function parseFrontmatter(md) {
-  if (!md.startsWith("---\n") && !md.startsWith("---\r\n")) return {};
-  const end = md.indexOf("\n---", 4);
-  if (end === -1) return {};
-  const block = md.slice(4, end + 1);
-  const out = {};
-  for (const line of block.split(/\r?\n/)) {
-    const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)\s*$/);
-    if (!match) continue;
-    out[match[1]] = (match[2] ?? "").replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1");
-  }
-  return out;
-}
-
-/**
- * Resolve id from frontmatter and config. idFrom = list of frontmatter keys; idFallback = "basename" | "dirname".
- */
-function resolveId(frontmatter, fileAbs, dirAbs, config) {
-  for (const key of config.idFrom || []) {
-    if (key === "dirname") {
-      const relDir = path.relative(dirAbs, path.dirname(fileAbs));
-      return (relDir ? relDir.replaceAll(path.sep, "/") : path.basename(path.dirname(fileAbs))).trim();
-    }
-    const v = frontmatter[key];
-    if (typeof v === "string" && v.trim()) return v.trim();
-  }
-  if (config.idFallback === "basename") return path.basename(fileAbs, ".md").trim();
-  if (config.idFallback === "dirname") return path.basename(path.dirname(fileAbs)).trim();
-  return path.basename(fileAbs, ".md").trim();
-}
-
-function resolveDescription(frontmatter, config, id) {
-  const key = config.descriptionFrom;
-  if (key && frontmatter[key] != null) return String(frontmatter[key]).trim();
-  if (config.descriptionFallback === "id") return id || "";
-  return id || "";
-}
-
-/**
- * Discover assets of one type from registry config. Returns array of { id, description, rel }.
- */
-function discoverByType(agentsRootAbs, typeKey, config) {
-  const dirAbs = path.join(agentsRootAbs, config.dir);
-  if (!fs.existsSync(dirAbs)) return [];
-
-  let files = [];
-  if (config.glob === "**/*.md") {
-    files = walkFiles(dirAbs, (p) => p.endsWith(".md"));
-  } else if (config.glob === "*/SKILL.md") {
-    const entries = fs.readdirSync(dirAbs, { withFileTypes: true });
-    for (const e of entries) {
-      if (e.isDirectory()) {
-        const skillMd = path.join(dirAbs, e.name, "SKILL.md");
-        if (fs.existsSync(skillMd)) files.push(skillMd);
-      }
-    }
-    files.sort();
-  } else {
-    files = walkFiles(dirAbs, (p) => p.endsWith(".md"));
-  }
-
-  const out = [];
-  for (const fileAbs of files) {
-    const rel = path.relative(dirAbs, fileAbs).replaceAll(path.sep, "/");
-    const raw = fs.readFileSync(fileAbs, "utf8");
-    const frontmatter = parseFrontmatter(raw);
-    const id = resolveId(frontmatter, fileAbs, dirAbs, config);
-    if (!id) continue;
-    const description = resolveDescription(frontmatter, config, id);
-    out.push({ id, description, rel });
-  }
-  return out.sort((a, b) => a.id.localeCompare(b.id));
-}
-
-function normalizeRepoUrl(repoValue) {
-  const raw = typeof repoValue === "string" ? repoValue : repoValue?.url;
-  if (typeof raw !== "string" || raw.trim().length === 0) return "";
-  return raw.replace(/^git\+/, "").replace(/\.git$/, "");
-}
-
-function writeJson(absPath, value, checkOnly, changed) {
-  const next = JSON.stringify(value, null, 2) + "\n";
-  let prev = null;
-  if (fs.existsSync(absPath)) prev = fs.readFileSync(absPath, "utf8");
-
-  if (prev !== next) {
-    changed.push(absPath);
-    if (!checkOnly) {
-      fs.mkdirSync(path.dirname(absPath), { recursive: true });
-      fs.writeFileSync(absPath, next, "utf8");
-      console.log("Wrote:", path.relative(repoRoot, absPath));
-    }
-  }
-}
-
-function main() {
-  const checkOnly = process.argv.includes("--check");
-  const registry = loadRegistry();
-  const roots = registry.roots?.consumer || {};
-  const assetTypes = registry.assetTypes || {};
-
-  const commands =
-    assetTypes.command != null
-      ? discoverByType(agentsRoot, "command", assetTypes.command)
-      : [];
-  const agents =
-    assetTypes.agent != null ? discoverByType(agentsRoot, "agent", assetTypes.agent) : [];
-
-  const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, "package.json"), "utf8"));
-  const repositoryUrl = normalizeRepoUrl(pkg.repository);
-  const changed = [];
-
-  const commandRoot = roots.commands || "node_modules/compound-workflow/src/.agents/commands";
-  const agentRoot = roots.agents || "node_modules/compound-workflow/src/.agents/agents";
-  const skillsPath = roots.skills || "node_modules/compound-workflow/src/.agents/skills";
-
-  // Claude Code only accepts name, description, author in plugin.json.
-  // Agents are discovered from the adjacent agents/ directory (must be flat .md files).
-  const claudePlugin = {
-    name: pkg.name,
-    description: "Clarify -> plan -> execute -> verify -> capture workflow: commands, skills, and agents for Claude Code",
-    author: { name: "Compound Workflow" },
-  };
-
-  const cursorPlugin = {
-    name: pkg.name,
-    version: pkg.version,
-    description: "Clarify -> plan -> execute -> verify -> capture workflow for Cursor",
-    author: { name: "Compound Workflow" },
-    keywords: ["workflow", "cursor", "agents", "commands", "skills"],
-    license: pkg.license,
-    repository: repositoryUrl,
-    commands: "./src/.agents/commands",
-    agents: "./src/.agents/agents",
-    skills: "./src/.agents/skills",
-  };
-
-  const openCodeManaged = {
-    $schema: "https://opencode.ai/config.json",
-    skillsPath,
-    commandRoot,
-    agentRoot,
-    commands,
-    agents,
-  };
-
-  writeJson(path.join(repoRoot, ".claude-plugin", "plugin.json"), claudePlugin, checkOnly, changed);
-  writeJson(path.join(repoRoot, ".cursor-plugin", "plugin.json"), cursorPlugin, checkOnly, changed);
-  writeJson(path.join(repoRoot, "src", "generated", "opencode.managed.json"), openCodeManaged, checkOnly, changed);
-
-  // Generate flat agent symlinks in .claude-plugin/agents/ so Claude Code discovers them.
-  // Claude Code only scans the root of the agents/ directory (not subdirectories).
-  const claudeAgentsDir = path.join(repoRoot, ".claude-plugin", "agents");
-  const agentsDirAbs = path.join(agentsRoot, "agents");
-  if (!checkOnly) {
-    fs.mkdirSync(claudeAgentsDir, { recursive: true });
-    // Prune stale symlinks no longer in the agent list
-    const agentBasenames = new Set(agents.map((a) => path.basename(a.rel)));
-    if (fs.existsSync(claudeAgentsDir)) {
-      for (const entry of fs.readdirSync(claudeAgentsDir, { withFileTypes: true })) {
-        if (!agentBasenames.has(entry.name)) {
-          fs.rmSync(path.join(claudeAgentsDir, entry.name), { force: true });
-        }
-      }
-    }
-    for (const agent of agents) {
-      const linkPath = path.join(claudeAgentsDir, path.basename(agent.rel));
-      const targetPath = path.relative(claudeAgentsDir, path.join(agentsDirAbs, agent.rel));
-      try {
-        if (fs.existsSync(linkPath) || fs.lstatSync(linkPath).isSymbolicLink()) {
-          fs.rmSync(linkPath, { force: true });
-        }
-      } catch { /* doesn't exist */ }
-      fs.symlinkSync(targetPath, linkPath);
-    }
-    if (agents.length) {
-      console.log(`Synced ${agents.length} agent symlinks to .claude-plugin/agents/`);
-    }
-  }
-
-  if (checkOnly && changed.length) {
-    console.error("Generated artifacts are stale:");
-    for (const abs of changed) console.error("-", path.relative(repoRoot, abs));
-    process.exit(1);
-  }
-
-  if (!changed.length) {
-    console.log(checkOnly ? "Generated artifacts are up-to-date." : "No artifact updates required.");
-  }
-}
-
-main();

package/src/.agents/commands/install.md

@@ -1,51 +0,0 @@
----
-name: install
-invocation: install
-description: Install compound-workflow in this project (native mode): writes opencode.json, merges AGENTS.md, and creates docs/todo dirs.
-argument-hint: "[--dry-run] [--root <path>] [--no-config] [--no-register-cursor] [--register-cursor]"
----
-
-# /install
-
-Install or update compound-workflow in this project with **one action**.
-
-## When to use
-
-- First-time setup in a repository.
-- After updating `compound-workflow` to refresh generated OpenCode command/agent mappings and AGENTS template content.
-
-## Prerequisites
-
-- The project must have `compound-workflow` installed: `npm install compound-workflow`.
-
-## Instructions for the agent
-
-Run in the workspace root (or user-provided root):
-
-```bash
-npx compound-workflow install
-npx compound-workflow install --root /path/to/project
-npx compound-workflow install --dry-run
-npx compound-workflow install --no-config
-```
-
-- `--dry-run`: Print planned changes only; no writes.
-- `--root <path>`: Target project directory (default: current directory).
-- `--no-config`: Skip Repo Config Block reminder; still writes opencode.json, AGENTS.md, and dirs.
-- `--no-register-cursor`: Do not register the plugin with Cursor (skip writing to ~/.claude/).
-- `--register-cursor`: Force registration with Cursor even if Cursor is not detected in the default location.
-
-After running, suggest `opencode debug config` in the project to verify OpenCode resolution.
-
-## Cursor
-
-One command installs and registers the plugin with Cursor when Cursor is detected (`~/.cursor` exists). Restart Cursor after install; if skills or commands do not appear, enable "Include third-party Plugins, Skills, and other configs" in Cursor Settings > Features. Use `--no-register-cursor` to skip registration (e.g. in CI).
-
-## What Install does
-
-1. Ensures `compound-workflow` is installed in the project.
-2. Writes/merges `opencode.json` so OpenCode resolves commands/agents/skills directly from `node_modules/compound-workflow/src/.agents`.
-3. Creates/merges `AGENTS.md` using the package template while preserving an existing Repo Config Block.
-4. Creates missing directories: `docs/brainstorms`, `docs/plans`, `docs/solutions`, `docs/metrics/daily|weekly|monthly`, `todos`.
-
-No setup/sync compatibility paths are supported in this cutover.