@khoavu882/doflow 0.0.0-stage → 2.0.0-beta.3

package/core/registry/capabilities.json

@@ -0,0 +1,120 @@
+{
+  "version": 1,
+  "capabilities": {
+    "code.exact-search": {
+      "description": "Find exact symbols, strings, file paths, or regex patterns.",
+      "providers": [
+        {
+          "id": "native.rg",
+          "name": "Ripgrep Native Search",
+          "kind": "native",
+          "binary": "rg",
+          "checkCommand": ["rg", "--version"],
+          "costTier": "free",
+          "sourceMode": "live"
+        }
+      ]
+    },
+    "code.semantic-search": {
+      "description": "Find code by natural language concept, behavior, or intent.",
+      "providers": [
+        {
+          "id": "semble.search",
+          "name": "Semble Semantic Search",
+          "kind": "cli",
+          "binary": "semble",
+          "checkCommand": ["semble", "--version"],
+          "costTier": "local-index",
+          "sourceMode": "index",
+          "mcp": { "server": "semble", "tool": "search" }
+        },
+        {
+          "id": "native.rg",
+          "name": "Ripgrep Regex Fallback",
+          "kind": "native",
+          "binary": "rg",
+          "costTier": "free",
+          "sourceMode": "live"
+        }
+      ]
+    },
+    "code.relationships": {
+      "description": "Query structural call graphs, caller/callee trees, and dependencies.",
+      "providers": [
+        {
+          "id": "graphify.query",
+          "name": "Graphify Knowledge Graph",
+          "kind": "cli",
+          "binary": "graphify",
+          "checkCommand": ["graphify", "--version"],
+          "costTier": "local-graph",
+          "sourceMode": "index",
+          "mcp": { "server": "graphify", "tool": "query_graph" }
+        },
+        {
+          "id": "native.rg",
+          "name": "Ripgrep Reference Fallback",
+          "kind": "native",
+          "binary": "rg",
+          "costTier": "free",
+          "sourceMode": "live"
+        }
+      ]
+    },
+    "code.impact-analysis": {
+      "description": "Determine blast radius and affected dependents of a symbol or component.",
+      "providers": [
+        {
+          "id": "graphify.query",
+          "name": "Graphify Blast Radius",
+          "kind": "cli",
+          "binary": "graphify",
+          "checkCommand": ["graphify", "--version"],
+          "costTier": "local-graph",
+          "sourceMode": "index",
+          "mcp": { "server": "graphify", "tool": "query_graph" }
+        }
+      ]
+    },
+    "history.search": {
+      "description": "Inspect git commit history, commit rationale, diffs, and blame.",
+      "providers": [
+        {
+          "id": "git.native",
+          "name": "Git CLI",
+          "kind": "native",
+          "binary": "git",
+          "checkCommand": ["git", "--version"],
+          "costTier": "free",
+          "sourceMode": "live"
+        }
+      ]
+    },
+    "behavior.verify": {
+      "description": "Execute automated test suites and behavioral assertions.",
+      "providers": [
+        {
+          "id": "native.test",
+          "name": "Project Test Runner",
+          "kind": "native",
+          "costTier": "compute",
+          "sourceMode": "live"
+        }
+      ]
+    },
+    "command.compress": {
+      "description": "Preserve agent context by compressing CLI stdout/stderr.",
+      "providers": [
+        {
+          "id": "rtk",
+          "name": "Rust Token Killer",
+          "kind": "cli",
+          "binary": "rtk",
+          "checkCommand": ["rtk", "--version"],
+          "costTier": "free",
+          "sourceMode": "live"
+        }
+      ]
+    }
+  }
+}

package/core/registry/contracts.json

@@ -0,0 +1,189 @@
+{
+  "version": 1,
+  "contracts": [
+    {
+      "harness": "claude",
+      "completeness": "verified",
+      "note": "Field lists and hook events verified against current Claude Code documentation. A frontmatter key or hook event absent here is rejected by the guards, not silently tolerated.",
+      "skillFields": [
+        "name",
+        "description",
+        "when_to_use",
+        "argument-hint",
+        "arguments",
+        "disable-model-invocation",
+        "user-invocable",
+        "allowed-tools",
+        "disallowed-tools",
+        "model",
+        "effort",
+        "context",
+        "agent",
+        "background",
+        "hooks",
+        "paths",
+        "shell"
+      ],
+      "agentFields": [
+        "name",
+        "description",
+        "tools",
+        "disallowedTools",
+        "model",
+        "permissionMode",
+        "maxTurns",
+        "skills",
+        "mcpServers",
+        "hooks",
+        "memory",
+        "background",
+        "effort",
+        "isolation",
+        "color",
+        "initialPrompt"
+      ],
+      "hookEvents": [
+        "SessionStart",
+        "Setup",
+        "SessionEnd",
+        "UserPromptSubmit",
+        "UserPromptExpansion",
+        "Stop",
+        "StopFailure",
+        "PreToolUse",
+        "PermissionRequest",
+        "PermissionDenied",
+        "PostToolUse",
+        "PostToolUseFailure",
+        "PostToolBatch",
+        "SubagentStart",
+        "SubagentStop",
+        "TeammateIdle",
+        "TaskCreated",
+        "TaskCompleted",
+        "InstructionsLoaded",
+        "ConfigChange",
+        "CwdChanged",
+        "FileChanged",
+        "DirectoryAdded",
+        "PreCompact",
+        "PostCompact",
+        "WorktreeCreate",
+        "WorktreeRemove",
+        "Notification",
+        "MessageDisplay",
+        "Elicitation",
+        "ElicitationResult"
+      ],
+      "evidence": [
+        "https://code.claude.com/docs/en/skills",
+        "https://code.claude.com/docs/en/sub-agents",
+        "https://code.claude.com/docs/en/hooks",
+        "https://code.claude.com/docs/en/settings"
+      ]
+    },
+    {
+      "harness": "codex",
+      "completeness": "lower-bound",
+      "note": "Frontmatter field lists are deliberately absent: shared skills and agent specs are byte-identical across harnesses, so a per-harness list could only restate a subset of claude's and would change no guard outcome \u2014 an inert declaration of exactly the kind these guards exist to remove. hookEvents IS per-harness and lists the events DoFlow actually wires; widen it only with an added evidence URL.",
+      "hookEvents": [
+        "SessionStart",
+        "SessionEnd",
+        "UserPromptSubmit",
+        "Stop",
+        "PreToolUse",
+        "PostToolUse",
+        "SubagentStart",
+        "SubagentStop",
+        "PreCompact"
+      ],
+      "evidence": [
+        "https://learn.chatgpt.com/docs/agent-configuration/agents-md",
+        "https://learn.chatgpt.com/docs/hooks",
+        "https://learn.chatgpt.com/docs/agent-configuration/subagents"
+      ]
+    },
+    {
+      "harness": "gemini",
+      "completeness": "lower-bound",
+      "note": "Frontmatter field lists are deliberately absent: shared skills and agent specs are byte-identical across harnesses, so a per-harness list could only restate a subset of claude's and would change no guard outcome \u2014 an inert declaration of exactly the kind these guards exist to remove. hookEvents IS per-harness and lists the events DoFlow actually wires; widen it only with an added evidence URL.",
+      "hookEvents": [
+        "SessionStart",
+        "SessionEnd",
+        "BeforeTool",
+        "AfterTool",
+        "PreCompress"
+      ],
+      "evidence": [
+        "https://geminicli.com/docs/cli/skills/",
+        "https://geminicli.com/docs/hooks/",
+        "https://geminicli.com/docs/cli/settings/"
+      ]
+    },
+    {
+      "harness": "opencode",
+      "completeness": "lower-bound",
+      "note": "hookEvents is empty by design, not by omission: OpenCode implements lifecycle handlers as JavaScript/TypeScript plugin modules exporting named hooks such as tool.execute.before, while DoFlow ships shell scripts invoked by a command string. The events exist natively and are recorded under capabilities.hooks.events with status \"different\"; wiring them would mean shipping executable code into the user's agent, which is a distribution decision rather than a projection. Widen this list only alongside that decision and an added evidence URL. See https://opencode.ai/docs/plugins.",
+      "hookEvents": [],
+      "evidence": [
+        "https://opencode.ai/docs/plugins",
+        "https://opencode.ai/docs/rules",
+        "https://opencode.ai/docs/config"
+      ]
+    },
+    {
+      "harness": "pi",
+      "completeness": "lower-bound",
+      "note": "hookEvents is empty by design, not by omission: Pi implements lifecycle handlers as TypeScript extension modules registering handlers through pi.on(), executing with full system permissions, while DoFlow ships shell scripts invoked by a command string. The events exist natively and are recorded under capabilities.hooks.events with status \"different\"; wiring them would mean shipping executable code into the user's agent, which is a distribution decision rather than a projection. Widen this list only alongside that decision and an added evidence URL. See https://pi.dev/docs/latest/extensions.",
+      "hookEvents": [],
+      "evidence": [
+        "https://pi.dev/docs/latest/extensions",
+        "https://pi.dev/docs/latest/settings",
+        "https://pi.dev/docs/latest/skills"
+      ]
+    },
+    {
+      "harness": "copilot",
+      "completeness": "lower-bound",
+      "note": "Copilot CLI now documents a full hook surface (use-hooks / hooks-reference, 2026): .github/hooks/*.json and ~/.copilot/hooks/, shape {version:1,hooks:{camelCaseEvent:[entries]}}. DoFlow wires none of it: the shipped scripts are Claude-payload-coupled (tool names, .session_id/.transcript_path stdin fields, CLAUDE_* envs) and Copilot's payload schemas are unverified here. hookEvents stays empty until that verification lands; widen only alongside it and an added evidence URL.",
+      "hookEvents": [],
+      "evidence": [
+        "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills",
+        "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli",
+        "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-hooks",
+        "https://docs.github.com/en/copilot/reference/hooks-reference"
+      ]
+    },
+    {
+      "harness": "kiro",
+      "completeness": "lower-bound",
+      "note": "hookEvents lists only the events DoFlow actually installs a doflow.json entry for (session-context on SessionStart, pre-implementation-gate, pre-bash-guard and mcp-tool-guard all on PreToolUse \u2014 hence PreToolUse appearing once, not twice \u2014 and stop-check on Stop), not the full set of trigger names Kiro's docs confirm (SessionStart, Stop, PreToolUse, PostToolUse, UserPromptSubmit, PreTaskExec, PostTaskExec, PostFileSave, PostFileCreate, PostFileDelete \u2014 see kiro.dev/docs/hooks/actions/). Widen this list only when DoFlow wires a hook to one of the unused confirmed events, alongside an added evidence URL.",
+      "hookEvents": [
+        "SessionStart",
+        "PreToolUse",
+        "Stop"
+      ],
+      "evidence": [
+        "https://kiro.dev/docs/steering/",
+        "https://kiro.dev/docs/mcp/configuration/",
+        "https://kiro.dev/docs/hooks/",
+        "https://kiro.dev/docs/hooks/actions/"
+      ]
+    },
+    {
+      "harness": "antigravity",
+      "completeness": "lower-bound",
+      "note": "hookEvents lists what DoFlow wires; widen only with added evidence. Antigravity documents five hook events; DoFlow wires PreToolUse (pre-implementation gate) and Stop (stop check) today.",
+      "hookEvents": [
+        "PreToolUse",
+        "Stop"
+      ],
+      "evidence": [
+        "https://antigravity.google/docs/cli/gcli-migration",
+        "https://antigravity.google/docs/hooks",
+        "https://antigravity.google/docs/cli/mcp",
+        "https://antigravity.google/docs/hooks/"
+      ]
+    }
+  ]
+}

package/core/registry/external-tools.json

@@ -0,0 +1,191 @@
+{
+  "version": 1,
+  "tools": [
+    {
+      "id": "rtk",
+      "displayName": "RTK (Rust Token Killer)",
+      "officialEvidence": [
+        "https://github.com/rtk-ai/rtk/blob/develop/INSTALL.md",
+        "https://www.rtk-ai.app/docs/getting-started/installation/"
+      ],
+      "status": {
+        "commands": [
+          [
+            "rtk",
+            "--version"
+          ],
+          [
+            "rtk",
+            "gain"
+          ]
+        ]
+      },
+      "install": {
+        "command": [
+          "cargo",
+          "install",
+          "--git",
+          "https://github.com/rtk-ai/rtk",
+          "--branch",
+          "master",
+          "rtk"
+        ]
+      },
+      "uninstall": {
+        "command": [
+          "cargo",
+          "uninstall",
+          "rtk"
+        ]
+      }
+    },
+    {
+      "id": "graphify",
+      "displayName": "Graphify",
+      "officialEvidence": [
+        "https://github.com/Graphify-Labs/graphify/blob/v8/README.md",
+        "https://docs.astral.sh/uv/guides/tools/",
+        "https://docs.astral.sh/uv/reference/cli/"
+      ],
+      "prerequisites": [
+        "uv"
+      ],
+      "status": {
+        "commands": [
+          [
+            "graphify",
+            "--version"
+          ]
+        ]
+      },
+      "install": {
+        "command": [
+          "uv",
+          "tool",
+          "install",
+          "graphifyy"
+        ]
+      },
+      "update": {
+        "command": [
+          "uv",
+          "tool",
+          "upgrade",
+          "graphifyy"
+        ]
+      },
+      "uninstall": {
+        "command": [
+          "uv",
+          "tool",
+          "uninstall",
+          "graphifyy"
+        ]
+      }
+    },
+    {
+      "id": "semble",
+      "displayName": "Semble",
+      "officialEvidence": [
+        "https://github.com/MinishLab/semble"
+      ],
+      "prerequisites": [
+        "uv"
+      ],
+      "status": {
+        "commands": [
+          [
+            "semble",
+            "--version"
+          ]
+        ]
+      },
+      "install": {
+        "command": [
+          "uv",
+          "tool",
+          "install",
+          "semble"
+        ]
+      },
+      "update": {
+        "command": [
+          "uv",
+          "tool",
+          "upgrade",
+          "semble"
+        ]
+      },
+      "uninstall": {
+        "command": [
+          "uv",
+          "tool",
+          "uninstall",
+          "semble"
+        ]
+      }
+    },
+    {
+      "id": "mermaid-cli",
+      "displayName": "Mermaid CLI",
+      "officialEvidence": [
+        "https://github.com/mermaid-js/mermaid-cli/blob/master/README.md",
+        "https://github.com/mermaid-js/mermaid/blob/develop/docs/config/usage.md"
+      ],
+      "status": {
+        "commands": [
+          [
+            "mmdc",
+            "--version"
+          ]
+        ]
+      },
+      "install": {
+        "command": [
+          "npm",
+          "install",
+          "-g",
+          "@mermaid-js/mermaid-cli"
+        ]
+      },
+      "uninstall": {
+        "command": [
+          "npm",
+          "uninstall",
+          "-g",
+          "@mermaid-js/mermaid-cli"
+        ]
+      }
+    },
+    {
+      "id": "plantuml",
+      "displayName": "PlantUML",
+      "officialEvidence": [
+        "https://plantuml.com/starting",
+        "https://github.com/plantuml-stdlib/C4-PlantUML/blob/master/README.md"
+      ],
+      "status": {
+        "commands": [
+          [
+            "plantuml",
+            "-version"
+          ]
+        ]
+      },
+      "install": {
+        "command": [
+          "brew",
+          "install",
+          "plantuml"
+        ]
+      },
+      "uninstall": {
+        "command": [
+          "brew",
+          "uninstall",
+          "plantuml"
+        ]
+      }
+    }
+  ]
+}