@khoavu882/doflow 2.0.0-beta.4 → 2.0.0

package/core/registry/assets.json

@@ -6,17 +6,12 @@
       "kind": "guidance",
       "source": "core/shared/guidance/pointers/claude-gemini.md",
       "appliesTo": [
-        "claude",
-        "gemini"
+        "claude"
       ],
       "projection": {
         "claude": {
           "renderer": "claude-instructions",
           "capability": "instructions"
-        },
-        "gemini": {
-          "renderer": "gemini-instructions",
-          "capability": "instructions"
         }
       },
       "ownership": "managed-file-section"
@@ -63,7 +58,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "kiro",
         "antigravity",
         "opencode",
@@ -79,13 +73,10 @@
           "renderer": "copy-tree",
           "capability": "instructions"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "instructions"
-        },
         "kiro": {
           "renderer": "copy-tree",
-          "capability": "instructions"
+          "capability": "instructions",
+          "select": "guidance-manifest"
         },
         "antigravity": {
           "renderer": "copy-tree",
@@ -108,7 +99,6 @@
       "nativeDir": {
         "claude": "../.doflow/guidance",
         "codex": "../.doflow/guidance",
-        "gemini": "../.doflow/guidance",
         "kiro": "steering",
         "antigravity": "../.doflow/guidance",
         "opencode": "../.doflow/guidance",
@@ -141,7 +131,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -155,38 +144,39 @@
         },
         "codex": {
           "renderer": "copy-tree",
-          "capability": "skills"
-        },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-codex"
         },
         "opencode": {
           "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-opencode"
         },
         "pi": {
           "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-pi"
         },
         "copilot": {
           "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-copilot"
         },
         "kiro": {
           "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-kiro"
         },
         "antigravity": {
           "renderer": "copy-tree",
-          "capability": "skills"
+          "capability": "skills",
+          "transform": "skill-frontmatter-antigravity"
         }
       },
       "ownership": "managed-tree",
       "nativeDir": {
         "claude": "skills",
         "codex": "../.agents/skills",
-        "gemini": "skills",
         "opencode": "skills",
         "pi": "skills",
         "copilot": "skills",
@@ -201,7 +191,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "copilot",
         "kiro",
         "antigravity",
@@ -210,20 +199,18 @@
       "projection": {
         "claude": {
           "renderer": "copy-tree",
-          "capability": "agents"
+          "capability": "agents",
+          "transform": "claude-agents"
         },
         "codex": {
-          "renderer": "copy-tree",
-          "capability": "agents"
-        },
-        "gemini": {
           "renderer": "copy-tree",
           "capability": "agents",
-          "transform": "gemini-agents"
+          "transform": "codex-agents"
         },
         "copilot": {
           "renderer": "copilot-agents",
-          "capability": "agents"
+          "capability": "agents",
+          "transform": "copilot-agents"
         },
         "kiro": {
           "renderer": "kiro-agents",
@@ -234,7 +221,8 @@
         "antigravity": {
           "renderer": "copy-tree",
           "capability": "agents",
-          "layout": "dir-per-file:agent.md"
+          "layout": "dir-per-file:agent.md",
+          "transform": "antigravity-agents"
         },
         "opencode": {
           "renderer": "opencode-agents",
@@ -246,7 +234,6 @@
       "nativeDir": {
         "claude": "agents",
         "codex": "agents",
-        "gemini": "../.gemini/agents",
         "copilot": "agents",
         "kiro": "agents",
         "antigravity": ".agents/agents",
@@ -259,8 +246,7 @@
       "source": "core/shared/templates",
       "appliesTo": [
         "claude",
-        "codex",
-        "gemini"
+        "codex"
       ],
       "projection": {
         "claude": {
@@ -270,17 +256,12 @@
         "codex": {
           "renderer": "copy-tree",
           "capability": "templates"
-        },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "templates"
         }
       },
       "ownership": "managed-tree",
       "nativeDir": {
         "claude": "../.doflow/templates",
-        "codex": "../.doflow/templates",
-        "gemini": "../.doflow/templates"
+        "codex": "../.doflow/templates"
       }
     },
     {
@@ -290,7 +271,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -306,10 +286,6 @@
           "renderer": "copy-tree",
           "capability": "scripts"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "scripts"
-        },
         "opencode": {
           "renderer": "copy-tree",
           "capability": "scripts"
@@ -335,7 +311,6 @@
       "nativeDir": {
         "claude": "../.doflow/scripts",
         "codex": "../.doflow/scripts",
-        "gemini": "../.doflow/scripts",
         "opencode": "../.doflow/scripts",
         "pi": "../.doflow/scripts",
         "copilot": "../.doflow/scripts",
@@ -350,7 +325,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -366,10 +340,6 @@
           "renderer": "copy-tree",
           "capability": "scripts"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "scripts"
-        },
         "opencode": {
           "renderer": "copy-tree",
           "capability": "scripts"
@@ -395,7 +365,6 @@
       "nativeDir": {
         "claude": "../.doflow/runtime/bin",
         "codex": "../.doflow/runtime/bin",
-        "gemini": "../.doflow/runtime/bin",
         "opencode": "../.doflow/runtime/bin",
         "pi": "../.doflow/runtime/bin",
         "copilot": "../.doflow/runtime/bin",
@@ -410,7 +379,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -426,10 +394,6 @@
           "renderer": "copy-tree",
           "capability": "scripts"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "scripts"
-        },
         "opencode": {
           "renderer": "copy-tree",
           "capability": "scripts"
@@ -455,7 +419,6 @@
       "nativeDir": {
         "claude": "../.doflow/runtime/src",
         "codex": "../.doflow/runtime/src",
-        "gemini": "../.doflow/runtime/src",
         "opencode": "../.doflow/runtime/src",
         "pi": "../.doflow/runtime/src",
         "copilot": "../.doflow/runtime/src",
@@ -470,7 +433,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -486,10 +448,6 @@
           "renderer": "copy-tree",
           "capability": "scripts"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "scripts"
-        },
         "opencode": {
           "renderer": "copy-tree",
           "capability": "scripts"
@@ -515,7 +473,6 @@
       "nativeDir": {
         "claude": "../.doflow/runtime/core/registry",
         "codex": "../.doflow/runtime/core/registry",
-        "gemini": "../.doflow/runtime/core/registry",
         "opencode": "../.doflow/runtime/core/registry",
         "pi": "../.doflow/runtime/core/registry",
         "copilot": "../.doflow/runtime/core/registry",
@@ -530,7 +487,6 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
         "opencode",
         "pi",
         "copilot",
@@ -546,10 +502,6 @@
           "renderer": "copy-tree",
           "capability": "scripts"
         },
-        "gemini": {
-          "renderer": "copy-tree",
-          "capability": "scripts"
-        },
         "opencode": {
           "renderer": "copy-tree",
           "capability": "scripts"
@@ -575,7 +527,6 @@
       "nativeDir": {
         "claude": "bin",
         "codex": "bin",
-        "gemini": "bin",
         "opencode": "bin",
         "pi": "bin",
         "copilot": "bin",
@@ -637,6 +588,24 @@
         "kiro": "hooks"
       }
     },
+    {
+      "id": "copilot.hooks-scripts",
+      "kind": "hooks",
+      "source": "core/harnesses/copilot/hooks",
+      "appliesTo": [
+        "copilot"
+      ],
+      "projection": {
+        "copilot": {
+          "renderer": "copilot-hooks",
+          "capability": "hooks"
+        }
+      },
+      "ownership": "managed-tree",
+      "nativeDir": {
+        "copilot": "hooks"
+      }
+    },
     {
       "id": "claude.settings",
       "kind": "settings",
@@ -655,7 +624,7 @@
     {
       "id": "instructions.copilot",
       "kind": "instructions",
-      "source": "core/shared/guidance/rules",
+      "source": "core/shared/guidance",
       "appliesTo": [
         "copilot"
       ],
@@ -668,7 +637,8 @@
           "renderer": "copilot-rule-instructions",
           "capability": "instructions",
           "transform": "copilot-rule-instructions",
-          "layout": "instructions-md"
+          "layout": "instructions-md",
+          "select": "guidance-manifest"
         }
       }
     },
@@ -695,7 +665,7 @@
     {
       "id": "rules.antigravity",
       "kind": "guidance",
-      "source": "core/shared/guidance/rules",
+      "source": "core/shared/guidance",
       "appliesTo": [
         "antigravity"
       ],
@@ -706,7 +676,10 @@
       "projection": {
         "antigravity": {
           "renderer": "copy-tree",
-          "capability": "instructions"
+          "capability": "instructions",
+          "transform": "antigravity-always-on-rules",
+          "layout": "flat",
+          "select": "guidance-manifest"
         }
       }
     },
@@ -753,16 +726,18 @@
       "appliesTo": [
         "claude",
         "codex",
-        "gemini",
+        "pi",
         "kiro",
+        "copilot",
         "antigravity"
       ],
       "ownership": "managed-tree",
       "nativeDir": {
         "claude": "../.doflow/shared/hooks",
         "codex": "../.doflow/shared/hooks",
-        "gemini": "../.doflow/shared/hooks",
+        "pi": "../.doflow/shared/hooks",
         "kiro": "../.doflow/shared/hooks",
+        "copilot": "../.doflow/shared/hooks",
         "antigravity": "../.doflow/shared/hooks"
       },
       "projection": {
@@ -774,7 +749,7 @@
           "renderer": "copy-tree",
           "capability": "hooks"
         },
-        "gemini": {
+        "pi": {
           "renderer": "copy-tree",
           "capability": "hooks"
         },
@@ -782,11 +757,28 @@
           "renderer": "copy-tree",
           "capability": "hooks"
         },
+        "copilot": {
+          "renderer": "copy-tree",
+          "capability": "hooks"
+        },
         "antigravity": {
           "renderer": "copy-tree",
           "capability": "hooks"
         }
       }
+    },
+    {
+      "id": "pi.guard-extension",
+      "kind": "hooks",
+      "source": "core/harnesses/pi/extensions/doflow-guard.js",
+      "appliesTo": ["pi"],
+      "projection": {
+        "pi": {
+          "renderer": "pi-guard-extension",
+          "capability": "hooks"
+        }
+      },
+      "ownership": "ledger-owned-file"
     }
   ]
 }

package/core/registry/capabilities.json

@@ -115,6 +115,18 @@
           "sourceMode": "live"
         }
       ]
+    },
+    "document.extract": {
+      "description": "Extract plain text or structured key-value data from documents or images.",
+      "providers": []
+    },
+    "media.transcribe": {
+      "description": "Convert audio/media recording into text transcription with optional timestamps.",
+      "providers": []
+    },
+    "text.compress": {
+      "description": "Perform context-preserving semantic text compression.",
+      "providers": []
     }
   }
 }

package/core/registry/contracts.json

@@ -1,5 +1,11 @@
 {
   "version": 1,
+  "agentSkillsSpec": {
+    "skillFields": ["name", "description", "license", "compatibility", "metadata", "allowed-tools"],
+    "source": "https://agentskills.io/specification",
+    "verifiedOn": "2026-10-27",
+    "note": "The Agent Skills standard's SKILL.md keys; metadata is a map of string keys to string values. A projected SKILL.md keeps these and its harness's skillFields at the top level and carries every other key under metadata (src/adapters/copy-tree.js, skill-frontmatter-<harness>; G22). unknownSkillFields records what the vendor page says the harness does with a key it does not define."
+  },
   "contracts": [
     {
       "harness": "claude",
@@ -22,8 +28,14 @@
         "background",
         "hooks",
         "paths",
-        "shell"
+        "shell",
+        "metadata",
+        "license",
+        "compatibility"
       ],
+      "skillFieldsSource": "https://code.claude.com/docs/en/skills",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "ignored",
       "agentFields": [
         "name",
         "description",
@@ -40,7 +52,10 @@
         "effort",
         "isolation",
         "color",
-        "initialPrompt"
+        "initialPrompt",
+        "autoCompactWindow",
+        "omitClaudeMd",
+        "experimental"
       ],
       "hookEvents": [
         "SessionStart",
@@ -73,7 +88,9 @@
         "Notification",
         "MessageDisplay",
         "Elicitation",
-        "ElicitationResult"
+        "ElicitationResult",
+        "PreModelSwitch",
+        "PostModelSwitch"
       ],
       "evidence": [
         "https://code.claude.com/docs/en/skills",
@@ -85,7 +102,11 @@
     {
       "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.",
+      "note": "skillFields lists the SKILL.md keys Codex documents; the projected SKILL.md keeps only those and the Agent Skills spec keys at the top level (row 131). agentFields is deliberately absent: shared 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.",
+      "skillFields": ["name", "description"],
+      "skillFieldsSource": "https://learn.chatgpt.com/docs/build-skills",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "not-documented",
       "hookEvents": [
         "SessionStart",
         "SessionEnd",
@@ -103,27 +124,14 @@
         "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.",
+      "skillFields": ["name", "description", "license", "compatibility", "metadata"],
+      "skillFieldsSource": "https://opencode.ai/docs/skills",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "ignored",
       "hookEvents": [],
       "evidence": [
         "https://opencode.ai/docs/plugins",
@@ -134,8 +142,12 @@
     {
       "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": [],
+      "note": "DoFlow installs a user- or project-scope extension that registers tool_call through pi.on() and invokes the shared lifecycle bridge. Project scope requires project trust. The handler can block before tools execute; tool_execution_start remains observation-only. See https://pi.dev/docs/latest/extensions.",
+      "skillFields": ["name", "description", "license", "compatibility", "metadata", "allowed-tools", "disable-model-invocation"],
+      "skillFieldsSource": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/docs/skills.md",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "warned",
+      "hookEvents": ["tool_call"],
       "evidence": [
         "https://pi.dev/docs/latest/extensions",
         "https://pi.dev/docs/latest/settings",
@@ -145,8 +157,18 @@
     {
       "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": [],
+      "note": "hookEvents lists the events DoFlow wires through .github/hooks/doflow.json, under the PascalCase names the lifecycle registry uses: SessionStart (native sessionStart), PreToolUse (preToolUse), Stop (agentStop), SubagentStart (subagentStart) and SubagentStop (subagentStop). Event surface, payloads and the deny shape were read from https://docs.github.com/en/copilot/reference/hooks-reference and checked against a live Copilot CLI 1.0.103 capture on 2026-10-27 (verified_on 2026-10-27); where they disagree the capture wins (toolArgs is a JSON object, or a raw string for apply_patch, not the documented JSON string). Widen only alongside an added evidence URL.",
+      "skillFields": ["name", "description", "license", "allowed-tools"],
+      "skillFieldsSource": "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "not-documented",
+      "hookEvents": [
+        "SessionStart",
+        "PreToolUse",
+        "Stop",
+        "SubagentStart",
+        "SubagentStop"
+      ],
       "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",
@@ -157,32 +179,37 @@
     {
       "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.",
+      "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, plus SessionEnd on CLI V3 only \u2014 see kiro.dev/docs/hooks/types/). Widen this list only when DoFlow wires a hook to one of the unused confirmed events, alongside an added evidence URL.",
+      "skillFields": ["name", "description", "license", "compatibility", "metadata"],
+      "skillFieldsSource": "https://kiro.dev/docs/skills/",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "not-documented",
       "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/"
+        "https://kiro.dev/docs/hooks/actions/",
+        "https://kiro.dev/docs/hooks/types/"
       ]
     },
     {
       "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.",
+      "note": "hookEvents lists what DoFlow wires; widen only with added evidence. Antigravity documents six hook events (SessionStart added); DoFlow wires PreToolUse (pre-implementation gate) and Stop (stop check) today.",
+      "skillFields": ["name", "description"],
+      "skillFieldsSource": "https://www.antigravity.google/docs/skills",
+      "skillFieldsVerifiedOn": "2026-10-27",
+      "unknownSkillFields": "not-documented",
       "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/"
+        "https://antigravity.google/docs/mcp?tab=cli"
       ]
     }
   ]