@sabaiway/agent-workflow-engine 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to the methodology engine. Versions are this **package's** n
 they are distinct from the **deployment-lineage** stamp written into a project's `docs/ai/`
 (which tracks the shared `agent-workflow` lineage, head `1.3.0`).
 
+## 1.6.0 — Loosen the agy Issue-001 caveat (grounded review is sound)
+
+A **feature** release. `references/orchestration.md` §5 reframes the `agy` health advisory: the grounded
+`agy-review` contract removes agy's stale-model / partial-diff **false positives**, so `agy` is a **sound**
+second opinion now — no longer something to merely avoid. The real **service-stall** caveat (Issue-001) is
+kept — it is a separate risk that grounding does not remove — as is the codex-before-agy tie-break for
+large / latency-sensitive substantive reviews and the `--add-dir` escalation path. The deployment-lineage
+head stays **`1.3.0`** (no `docs/ai` structural change).
+
 ## 1.5.0 — Right-altitude & code-grounded folds in the canon
 
 A **feature** release. The planning canon (`references/planning.md`, read **live** by the composition

package/SKILL.md

@@ -3,7 +3,7 @@ name: agent-workflow-engine
 description: Canonical home of the agent-workflow planning methodology — the Plan→Phase→Step→Substep vocabulary, plan lifecycle, queue.md series index, mandatory Cleanup phase, the bounded methodology slot fragment, the orchestration-recipe vocabulary (Solo / Reviewed / Council / Delegated), and the activity-procedures canon (plan-authoring / plan-execution, with typed recipe slots). A published, installable npm package (available:true) that *provides* the methodology text; it mutates nothing. The composition root (agent-workflow-kit) reads this canon LIVE from the installed engine and injects the bounded slots from it — one source of truth, no bundled mirror; `npx @sabaiway/agent-workflow-kit@latest init` installs the engine.
 disable-model-invocation: true
 metadata:
-  version: '1.5.0'
+  version: '1.6.0'
 ---
 
 # agent-workflow-engine

package/capability.json

@@ -3,7 +3,7 @@
   "schema": 1,
   "name": "agent-workflow-engine",
   "kind": "methodology-engine",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "available": true,
   "provides": ["plan"],
   "roles": {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sabaiway/agent-workflow-engine",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Canonical home of the agent-workflow planning methodology — the Plan→Phase→Step vocabulary, plan lifecycle, queue.md series index, and mandatory Cleanup phase, consumed by the kit (composition root). The methodology engine of the agent-workflow family.",
   "keywords": [
     "ai-agents",

package/references/orchestration.md

@@ -22,8 +22,8 @@ Each backend declares what it can do in its `capability.json` `provides` / `role
 - **`codex-cli-bridge`** (`codex`) — `provides: ["execute", "review"]`. It can run a bounded
   execution sub-task (`codex-exec`, output: a diff) and give an advisory review (`codex-review`,
   modes `plan` / `code`).
-- **`antigravity-cli-bridge`** (`agy`) — `provides: ["review", "probe"]`. It can give an advisory
-  review and answer a bounded probe (both via `agy-run`).
+- **`antigravity-cli-bridge`** (`agy`) — `provides: ["review", "probe"]`. It gives an advisory,
+  grounded review via `agy-review` (modes `code` / `plan` / `diff`) and answers a bounded probe via `agy-run`.
 
 Both are **subscription** backends with a **finite quota** — spend deliberately.
 
@@ -78,9 +78,14 @@ cheapest model that fits the task; not reach for a top-tier model by reflex; and
 A **standing health advisory** applies to `agy`: the Antigravity service can **stall on substantive
 prompts** (a long hang that returns nothing — an external service issue, not a setup problem;
 tracked as **Issue-001** in the kit's known issues). It is **invisible to file-presence detection**,
-so it is *not* a readiness signal — it is a static caveat attached whenever a recipe would use `agy`. While it lasts, **prefer `codex`** for substantive
-reviews (this is the Reviewed tie-break in §3). The recipe machinery **never runs a subscription
-CLI** to check — detection stays read-only.
+so it is *not* a readiness signal — only a standing caveat. The **grounded** `agy-review` contract
+makes `agy` a **sound** second opinion — it removes the stale-model / partial-diff **false positives**
+that the old ungrounded, `--add-dir`-roaming reviews produced — so `agy` is no longer something to
+merely avoid. But the *service* stall is a **separate, real** risk that grounding does **not** remove,
+so keep reviews **focused** (the inherited hard timeout is the guard) and **prefer `codex`** for large
+or latency-sensitive substantive reviews and for the `--add-dir` escalation path (the deterministic
+Reviewed tie-break in §3). The recipe machinery **never runs a subscription CLI** to check — detection
+stays read-only.
 
 ## 6. The orchestrator always commits