@hassangameryt/freeflow 0.7.3 → 0.8.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "freeflow",
       "description": "Feedback-based control for coding agents.",
-      "version": "0.7.3",
+      "version": "0.8.0",
       "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.3",
+  "version": "0.8.0",
   "author": {
     "name": "Hassan Mohiddin"
   },

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "freeflow",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Feedback-based control system for coding agents.",
   "author": {
     "name": "Hassan Mohiddin"

package/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "freeflow",
   "description": "Feedback-based control system for coding agents.",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "author": {
     "name": "Hassan Mohiddin"
   },

package/NOTICE

@@ -0,0 +1,14 @@
+Freeflow
+Copyright (c) 2026 Hassan Mohiddin. Licensed under the MIT License (see LICENSE).
+
+This product includes software derived from OpenAI Codex
+(https://github.com/openai/codex), Copyright 2025 OpenAI, licensed under the
+Apache License, Version 2.0 (see licenses/Apache-2.0.txt):
+
+- pi-extension/src/tool-execution/apply-patch/grammar.ts: the apply_patch Lark
+  grammar (codex-rs/core/assets/tools/apply_patch.lark), unmodified.
+- pi-extension/src/tool-execution/apply-patch/parser.ts and match.ts: ported
+  from codex-rs/apply-patch (parser and seek_sequence), with changes for Pi.
+
+Ported at upstream commit bcd6d9ab. The built files under pi-extension/dist/
+carry the same code and attribution.

package/README.md

@@ -11,6 +11,7 @@ The host agent still owns tools, permissions, and execution. Freeflow helps it u
 - **New to Freeflow?** Read [Using Freeflow Effectively](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/using-freeflow.md).
 - **Installing it?** Start with [Getting Started](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/getting-started.md).
 - **Using Cognitive Routing?** Read the detailed [Cognitive Routing reference](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/cognitive-routing.md).
+- **Using Freeflow on Pi?** Read [Tool Execution](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/tool-execution.md) and [Compaction](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/compaction.md).
 
 ## Memory · Context · Compute
 
@@ -18,20 +19,20 @@ The host agent still owns tools, permissions, and execution. Freeflow helps it u
 | --- | --- | --- |
 | **Memory — Track Work** | Working Records that preserve current context, one Current Slice, decisions, evidence limits, future work, and the next useful action. | Available through the shared skill surface. |
 | **Context — Context Control** | Planned source-aware residency, representation, and bounded recovery for admitted context. | Planned/in development; unavailable in this release. |
-| **Compute — Cognitive Routing** | Coordinator, Helper, and Executor profiles in one agent/session, with mode-aware work placement and optional worker-evidence projection. | Experimental native-Pi capability; current PiFlow adapter unavailable. |
+| **Compute — Cognitive Routing** | Coordinator, Helper, and Executor profiles in one agent/session, with mode-aware work placement and optional worker-evidence projection. | Experimental native-Pi capability; installed-host and model-behavior evidence remain separate. |
 
-Current optional **Context Virtualization** and **Conversation History** capabilities remain separate legacy Pi/PiFlow features. They are not Context Control v2, and their transforms are not qualified together with Cognitive Routing projection.
+The former Freeflow Context (`freeflow_context`, `/freeflow context`), Context Virtualization, and Conversation History surfaces are removed as a breaking change. Context Control v2 is planned but unavailable in this release; it does not replace those operations yet. See the Unreleased changelog for the required config-key cleanup.
 
-## Astra cache-aware reuse
+## Selected OpenAI model cache-aware reuse
 
-Freeflow's Pi extension includes cache-aware request history and a qualified Astra effort-history adapter:
+Freeflow's Pi extension includes cache-aware request history and a qualified effort-history adapter for selected GPT-6 models: `gpt-6-astra`, `gpt-6-luna`, and `gpt-6-sol`.
 
 - compatible Freeflow-generated state stays at stable historical positions where possible;
 - changed runtime state is appended instead of rewriting earlier generated context;
-- qualified `gpt-6-astra` routes can retain a request-level effort baseline and insert trusted effort changes at validated historical positions;
+- supported OpenAI Responses and OpenAI-Codex Responses routes can retain a request-level effort baseline and insert trusted effort changes at validated historical positions;
 - unsupported or uncertain requests fall back to the untouched native request.
 
-This is request-construction and compatibility behavior—not proof of a provider cache hit, billing reduction, model quality improvement, or universal provider support. See the [Pi cache reuse boundaries](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/integrations/pi.md#cache-reuse-boundaries).
+The adapter uses `freeflow-openai-effort-v1`. Older `freeflow-astra-effort-v1` entries remain in native session history but are not replayed; no migration is provided. This is request-construction and compatibility behavior—not proof of a provider cache hit, billing reduction, model quality improvement, or universal provider support. See the [Pi cache reuse boundaries](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/integrations/pi.md#cache-reuse-boundaries).
 
 ## Why Freeflow
 
@@ -46,7 +47,9 @@ Coding agents commonly fail at control boundaries:
 | A passing command becomes an unsupported completion claim. | Verify Work ties the claim to the actual observer and evidence boundary. |
 | Context loss erases decisions and partial work. | Track Work restores a complete Working Record and reconciles it with live state. |
 | Expensive models perform routine supporting work. | Cognitive Routing can place bounded support and substantive execution on configured profiles. |
-| Request history changes destroy reusable prefixes unnecessarily. | RequestHistory and qualified Astra adaptation preserve compatible request structure. |
+| Models flood their context with whole files and long command output, or lose edits to files that changed behind them. | Tool Execution teaches narrow reads and capped output, tracks what the model has read, and adds `apply_patch` and background commands. |
+| Pi's automatic compaction summarizes work the agent was in the middle of, and the next step drifts. | Compaction warns the agent first, so it compacts at a safe point from its own summary, Working Record and carried context. |
+| Request history changes destroy reusable prefixes unnecessarily. | RequestHistory and qualified selected-model effort adaptation preserve compatible request structure. |
 
 ## How it works
 
@@ -93,14 +96,13 @@ A comparatively economical but capable Helper can contribute much of Both mode's
 
 | Surface | Availability |
 | --- | --- |
-| Interaction Contract, Workflow, and 24 base skills | Shared supported package surface when Freeflow is effectively activated |
+| Interaction Contract, Workflow, and 25 base skills | Shared supported package surface when Freeflow is effectively activated |
 | Track Work / Working Records | Shared skill surface |
-| Context Virtualization | Optional Pi/PiFlow capability; legacy, separately gated |
-| Conversation History | Optional Pi/PiFlow capability; separately gated |
 | Context Control v2 | Planned/in development; not available in this release |
 | Cognitive Routing | Experimental native Pi source candidate |
-| Cognitive Routing on PiFlow | Explicitly unavailable in the current adapter |
-| Astra cache-aware effort history | Narrow source/fixture-qualified native Pi route; provider savings unverified |
+| Selected GPT-6 effort history | Narrow source/fixture-qualified native Pi route for Astra, Luna, and Sol; provider savings unverified |
+| Tool Execution | Experimental native Pi; off by default; native fixtures and live sessions exercise it, its effect on task results is unmeasured |
+| Compaction | Experimental native Pi; on by default; native fixtures and live sessions exercise it, summary quality against Pi's summarizer is unmeasured |
 
 Configuration or installation alone does not establish runtime delivery.
 
@@ -118,10 +120,9 @@ Freeflow is one package with different host boundaries:
 | Kiro | Agent Plugins 1.0 Power and shared skills | Not available; skills-only claim |
 | OpenCode v2 | Canonical `skills/` through a documented 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 native extension source entrypoint | Experimental source candidate; installed-user and model-behavior evidence remain separate |
-| PiFlow | PiFlow-hosted Freeflow package and shared surface | Explicitly unavailable in the current source adapter |
+| Pi | Shared skills and the native extension (core prompt, Compaction, Tool Execution) | Experimental; native fixtures and live Pi 1.0 sessions on GPT-6 Luna and Sol 6.1 |
 
-Freeflow owns workflow policy, portable prompts, skills, capability source, host adapters, and the Pi extension. Each host owns launch, package installation, session state, trust, and updates.
+Freeflow owns workflow policy, portable prompts, skills, capability source, host adapters, and the Pi extension. Each host owns launch, package installation, session state, trust, and updates. Freeflow's PiFlow integration was removed as a breaking change; use native Pi for the Freeflow extension. Freeflow does not change or uninstall a separate PiFlow installation. See the [Unreleased changelog](CHANGELOG.md#unreleased).
 
 ## Quick start
 
@@ -184,15 +185,6 @@ pi install git:github.com/hassan-mohiddin/freeflow
 
 Restart Pi or use `/reload` after installation or updates.
 
-### PiFlow
-
-```bash
-npm install -g --ignore-scripts @hassangameryt/piflow
-piflow install npm:@hassangameryt/freeflow
-```
-
-The current PiFlow adapter does not provide Cognitive Routing.
-
 ### Activate a repository
 
 Run:
@@ -232,6 +224,7 @@ Canonical Pi direct calls include:
 /write-spec
 /review-artifact
 /write-plan
+/write-docs
 /execute-work
 /simplify-code
 /migration-work
@@ -254,7 +247,7 @@ Contributor calls:
 /evaluate-skill
 ```
 
-Qualified native-Pi Cognitive Routing controls:
+Native Pi controls:
 
 ```text
 /freeflow
@@ -269,6 +262,7 @@ Qualified native-Pi Cognitive Routing controls:
 /freeflow profile auto
 /freeflow profile history
 /freeflow resume
+/freeflow compact
 ```
 
 Profile changes and resume require an idle host. These commands do not prove installed-host delivery or authorize task work.
@@ -292,18 +286,19 @@ Cognitive Routing remains experimental pending broader behavioral acceptance. Co
 - [Getting Started](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/getting-started.md)
 - [Workflow](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/workflow.md)
 - [Cognitive Routing](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/cognitive-routing.md)
+- [Tool Execution](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/tool-execution.md)
+- [Compaction](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/compaction.md)
 - [Pi integration](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/integrations/pi.md)
-- [PiFlow integration](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/integrations/piflow.md)
-- [Architecture](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/architecture.md)
-- [System prompt architecture](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/prompt-architecture.md)
-- [Skill routing](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/skill-routing.md)
+- [Architecture](https://github.com/hassan-mohiddin/freeflow/blob/main/dev-docs/README.md)
+- [System prompt architecture](https://github.com/hassan-mohiddin/freeflow/blob/main/dev-docs/subsystems/prompt-assembly.md)
+- [Skill routing](https://github.com/hassan-mohiddin/freeflow/blob/main/dev-docs/subsystems/skill-routing.md)
 - [Capabilities](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/capabilities/README.md)
-- [Release process](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/release.md)
+- [Release process](https://github.com/hassan-mohiddin/freeflow/blob/main/dev-docs/guides/release.md)
 - [Release evidence](https://github.com/hassan-mohiddin/freeflow/blob/main/plugin-docs/release-evidence/README.md)
 - [Changelog](CHANGELOG.md)
 - [Contributing](CONTRIBUTING.md)
 
-For local Pi/PiFlow development, refresh a development snapshot only from a committed Freeflow revision with `npm run snapshot:refresh`. A snapshot is not a production install or release.
+For local Pi extension development, refresh a development snapshot only from a committed Freeflow revision with `npm run snapshot:refresh`. A snapshot is not a production install or release.
 
 ## What Freeflow is not