@hassangameryt/freeflow 0.7.0 → 0.7.2

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "freeflow",
       "description": "Feedback-based control for coding agents.",
-      "version": "0.7.0",
+      "version": "0.7.2",
       "category": "development",
       "source": "./",
       "author": {

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "freeflow",
   "description": "Freeflow gives coding agents an Interaction Contract, adaptive Workflow, focused methods, and durable task memory.",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "author": {
     "name": "Hassan Mohiddin"
   },
@@ -9,6 +9,7 @@
   "repository": "https://github.com/hassan-mohiddin/freeflow",
   "license": "MIT",
   "skills": "./skills/",
+  "hooks": "./hooks/claude/hooks.json",
   "keywords": [
     "workflow",
     "skills",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "freeflow",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Feedback-based control system for coding agents.",
   "author": {
     "name": "Hassan Mohiddin"
@@ -21,7 +21,7 @@
     "claude"
   ],
   "skills": "./skills/",
-  "hooks": "./hooks/hooks.json",
+  "hooks": "./hooks/codex/hooks.json",
   "interface": {
     "displayName": "Freeflow",
     "shortDescription": "Feedback-based control for coding agents.",

package/.cursor-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "freeflow",
+  "description": "Feedback-based control system for coding agents.",
+  "version": "0.7.2",
+  "author": {
+    "name": "Hassan Mohiddin"
+  },
+  "homepage": "https://github.com/hassan-mohiddin/freeflow",
+  "repository": "https://github.com/hassan-mohiddin/freeflow",
+  "license": "MIT",
+  "skills": "./skills/",
+  "hooks": "./hooks/cursor/hooks.json",
+  "logo": "assets/freeflow-plugin-icon-transparent.png",
+  "keywords": [
+    "workflow",
+    "skills",
+    "agents",
+    "feedback-loop",
+    "task-memory",
+    "planning",
+    "verification",
+    "review",
+    "cursor"
+  ]
+}

package/README.md

@@ -41,16 +41,14 @@ Freeflow uses one active agent, one shared context, and nested feedback loops:
 Interaction Lifecycle
 └─ Workflow Feedback Loop
    ├─ establishes authority, owner, and slice
-   └─ Cognitive Execution Routes — automatic control only
-      ├─ Reasoning chooses one route
-      │  ├─ YIELD → Standard leads ordinary work → YIELD HANDOFF → Reasoning
-      │  ├─ DELEGATE → open model-written boundary → Standard executes
-      │  │  └─ RETURN → Reasoning assesses; boundary remains open until CLOSE
-      │  └─ TASK ACT → Reasoning performs narrow direct OBSERVE or ACT_BOUNDED
-      └─ Action Selection guides uncertain environment interactions
+   └─ Cognitive Routing — experimental, when a qualified host is available
+      ├─ Coordinator assigns a decision-complete assignment
+      ├─ Executor performs it and returns an actual report
+      └─ Coordinator assesses evidence, continues, or closes the unit
+         └─ Action Selection bounds uncertain environment interactions
 ```
 
-Under automatic Cognitive Routing control, each new user interaction begins in Reasoning. Under manual control, the selected compute profile runs the ordinary unsplit Workflow. Cognitive Routing changes compute placement only. It never changes authority, ownership, task scope, evidence requirements, or review independence.
+Under automatic Cognitive Routing control, Coordinator owns new user direction; input reaching an already prepared Executor request requires an interrupted return before task tools. Under manual control, the selected profile runs the ordinary unsplit Workflow. Cognitive Routing changes compute and context placement only. It never changes authority, ownership, task scope, evidence requirements, or review independence.
 
 The Workflow owner may be Discuss, Track Work, Execute Work, Verify Work, Review Work, Review Artifact, Diagnose Failure, or another focused method. These methods compose when their conditions apply; they are not a mandatory phase pipeline.
 
@@ -60,12 +58,18 @@ Freeflow is one package with different host boundaries:
 
 | Host | Freeflow support | Cognitive Routing |
 | --- | --- | --- |
-| Codex | Shared skills and lifecycle hook | Not available; Pi/PiFlow capabilities are not delivered |
-| Claude Code | Shared skills and lifecycle hook | Not available; Pi/PiFlow capabilities are not delivered |
-| Pi | Shared skills, Pi extension, optional context capabilities, and native host controls | Available when configured and the official model-state APIs are present |
-| PiFlow | Freeflow package hosted by the separate PiFlow distribution | Available when configured |
-
-Freeflow owns workflow policy, prompt fragments, skills, capabilities, and the Pi extension. Each host owns its launch, package installation, session state, updates, and native model-state control; PiFlow remains a supported host integration.
+| Codex | Shared skills and Codex `SessionStart` hook | Not available; Pi/PiFlow capabilities are not delivered |
+| Claude Code | Shared skills and Claude Code `SessionStart` hook | Not available; Pi/PiFlow capabilities are not delivered |
+| Gemini CLI | Gemini extension manifest, shared skills, and Gemini `SessionStart` hook | Not available; Pi/PiFlow capabilities are not delivered |
+| Cursor | Agent Plugins 1.0 skills plus Cursor-specific hook delivery | Not available; Pi/PiFlow capabilities are not delivered |
+| GitHub Copilot / VS Code | Agent Plugins 1.0 skills plus Copilot-specific hook delivery | Not available; Pi/PiFlow capabilities are not delivered |
+| Kiro | Agent Plugins 1.0 Power and shared skills | Not available; no Kiro-specific runtime adapter is claimed |
+| OpenCode v2 | Canonical `skills/` through OpenCode’s project skill source | Not available; skills-only support |
+| Hermes Agent | Agent Plugins 1.0 package and canonical skills | Not available; skills-only support |
+| Pi | Shared skills and the Pi extension source entrypoint | Cognitive Routing is an unreleased experimental candidate; native SDK and bundled-CLI dispatch are exercised by isolated local fixtures; installed-user and model-behavior acceptance remain separate |
+| PiFlow | Freeflow package can be hosted by the separate PiFlow distribution | Cognitive Routing is explicitly unavailable in the current source adapter |
+
+Freeflow owns workflow policy, portable prompt fragments, the 24-skill distribution kernel, host adapters, capability source, and the Pi extension. Each host owns its launch, package installation, session state, and updates. Native host behavior and model quality require separate installed-host evidence; PiFlow routing is not currently available.
 
 ## Capabilities
 
@@ -78,7 +82,7 @@ Freeflow owns workflow policy, prompt fragments, skills, capabilities, and the P
 
 ### Optional host capabilities
 
-- **[Cognitive Routing](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/cognitive-routing.md)** places compute between Reasoning and Standard under automatic control in Pi and PiFlow. It remains experimental.
+- **[Cognitive Routing](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/cognitive-routing.md)** places compute between Coordinator and Executor in one agent under automatic control. The current source path is experimental and host availability is not established by installation alone.
 - **[Context Virtualization](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/context-virtualization.md)** classifies consumed tool evidence as Full, Retained, or Reference-only for future context while leaving canonical history unchanged.
 - **[Conversation History](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/conversation-history.md)** performs bounded retrieval of exact missing prior-conversation evidence from the current active branch.
 
@@ -106,6 +110,24 @@ Trust the Freeflow hook from `/hooks`, then start a new session.
 /reload-plugins
 ```
 
+### Gemini CLI
+
+```bash
+gemini extensions install https://github.com/hassan-mohiddin/freeflow
+```
+
+Restart Gemini CLI after installation or updates. The extension uses the root `gemini-extension.json`, shared `skills/`, and its Gemini-specific `SessionStart` hook adapter.
+
+### Cursor, GitHub Copilot, VS Code, Kiro, OpenCode, and Hermes Agent
+
+These hosts consume the root Agent Plugins 1.0 manifest and the same `skills/` directory. Cursor also reads `.cursor-plugin/plugin.json` for its host-specific hook surface; GitHub Copilot and VS Code read the `com.github.copilot/` extension namespace. Install from each host’s documented plugin source or marketplace UI. For Copilot CLI, the direct repository form is:
+
+```bash
+copilot plugin install hassan-mohiddin/freeflow
+```
+
+VS Code provides **Chat: Install Plugin From Source**. Kiro exposes compatible Agent Plugins as Powers and can import a GitHub source through its Powers UI. OpenCode v2 can add the checkout or package’s `skills/` directory to the documented `skills` array in `opencode.json`; it does not receive a native Freeflow plugin runtime. Hermes can install the root portable package with `hermes plugins install hassan-mohiddin/freeflow --no-enable`, then enable it with `hermes plugins enable freeflow`, or use its documented skills source workflow. A host’s install/trust UI and marketplace availability are external to this repository’s deterministic checks.
+
 ### Pi
 
 ```bash
@@ -118,7 +140,7 @@ Or:
 pi install git:github.com/hassan-mohiddin/freeflow
 ```
 
-The full normal-Pi integration targets Pi 0.84.3 or newer; Pi 0.84.4 is the current Cognitive Routing test target.
+The repository's current development dependency is Pi 0.85.1. The native entrypoint is wired in the source tree, but local fixtures exercise native SDK and bundled-CLI integration without installing this candidate into the user’s host; version-specific host acceptance belongs to separate release evidence.
 
 ### PiFlow
 
@@ -135,6 +157,8 @@ For a Git source:
 piflow install git:github.com/hassan-mohiddin/freeflow
 ```
 
+The current source entrypoint explicitly marks the redesigned PiFlow Cognitive Routing adapter unavailable. Installing the package still does not establish routing availability.
+
 In the target repository, run:
 
 ```text
@@ -166,8 +190,8 @@ Freeflow’s model-facing surface has four coordinated parts:
 
 1. **Core guidance** in `runtime/prompts/core.md` contains identity, shared terms, loops, Workflow, Action Selection, and Supported Exit cues.
 2. **Interaction Contract** in `runtime/prompts/interaction-contract.md` remains a separate mandatory fragment so its behavior can be revised independently.
-3. **Runtime State** reports current capability availability and Cognitive Routing `Control`/`Profile` at session start, after context reconstruction or loss, and when displayed state changes; unchanged state remains in the current provider context.
-4. **Discoverable skills and tools** provide the 25 base methods and individually gated optional capability operations.
+3. **Runtime State** reports current capability availability and v2 Cognitive Routing `Control`/`Profile` at session start, after context reconstruction or loss, and when displayed state changes; unchanged state remains in the current provider context.
+4. **Discoverable skills and tools** provide the 24 base methods and individually gated optional capability operations.
 
 The core guidance and Interaction Contract are always delivered together when Freeflow is enabled. Optional capability content is omitted and reported unavailable rather than fabricated. One effective-state snapshot determines prompt assembly, discovery, tools, and projection.
 
@@ -178,6 +202,8 @@ Read the full [System Prompt Architecture](https://github.com/hassan-mohiddin/fr
 Freeflow is explicit about what its checks prove:
 
 - deterministic checks prove structure, assembly, package boundaries, and selected delivery behavior;
+- host-manifest and adapter checks prove the Agent Plugins 1.0, Gemini, Cursor, and Copilot/VS Code package shapes, not native host dispatch;
+- OpenCode and Hermes compatibility checks cover the canonical Agent Skills/Agent Plugins package shape, not native host plugin APIs or runtime prompt delivery;
 - release evidence is versioned and records source, checks, artifacts, deferred evidence, and limits;
 - local installation does not prove remote host installation or registry propagation;
 - deterministic skill/runtime checks do not prove model behavior or universal skill readiness;
@@ -220,24 +246,29 @@ Contributor calls:
 /evaluate-skill
 ```
 
-Pi and PiFlow Cognitive Routing controls:
+Cognitive Routing controls on a qualified native host:
 
 ```text
 /freeflow
 /freeflow settings
 /freeflow settings session
+/freeflow settings local
 /freeflow settings repo
-/freeflow profile standard
-/freeflow profile reasoning
+/freeflow profile coordinator
+/freeflow profile executor
 /freeflow profile auto
+/freeflow profile history
+/freeflow resume
 ```
 
-`/freeflow settings` edits personal overrides, `/freeflow settings session` manages temporary enablement and optional-context overrides, and `/freeflow settings repo` edits shared repository settings. Profile changes require an idle host with the required model-state APIs.
+`/freeflow settings` edits personal overrides, `/freeflow settings session` manages temporary core/context overrides, and `/freeflow settings repo` edits shared repository settings. Cognitive Routing configuration is repository/personal configuration, not a session override. Profile changes and resume require an idle host with the required native model-state APIs.
+
+When the source adapter exposes the native controls and the host is idle:
 
-In Pi or PiFlow, while the host is idle:
+- `Ctrl+Shift+R` cycles the manual Coordinator/Executor hold.
+- `Ctrl+Shift+A` releases a manual hold to automatic Coordinator control; repeating it while already automatic is idempotent.
 
-- `Ctrl+Shift+R` cycles the manual standard/reasoning hold.
-- `Ctrl+Shift+A` sets automatic control; from a manual hold, it releases the hold and moves to Reasoning when necessary. Repeating it while already automatic is idempotent.
+These commands are host controls, not proof of installed-host delivery or model evaluation.
 
 ## Documentation and development
 
@@ -252,7 +283,7 @@ In Pi or PiFlow, while the host is idle:
 - [Changelog](CHANGELOG.md)
 - [Contributing](CONTRIBUTING.md)
 
-For local development, use committed Freeflow snapshots with `npm run snapshot:refresh`. Do not treat an uncommitted working tree as a production package source. PiFlow owns the host development launcher and state synchronization.
+For local development, use committed Freeflow snapshots with `npm run snapshot:refresh`. A snapshot identifies a committed Freeflow revision; an installed package is a separate host artifact and identity. Do not treat an uncommitted working tree as a production package source. Snapshot handling does not patch host files, claim `fsync`, or promise exactly-once delivery. PiFlow owns any host development launcher and state synchronization.
 
 ## What Freeflow is not