@tacuchi/agent-workflow-cli 20.22.0 → 20.24.0

package/skills/w/context/MANIFEST.json

@@ -0,0 +1,486 @@
+{
+  "version": 1,
+  "$comment": "Context graph of the w bundle. Single source for BOTH measurement (aw context-budget) and resolution (aw context-plan). It lives inside the bundle on purpose: a hand-installed tree carries the manifest that describes IT, so a receipt can never describe a bundle other than the one the agent actually reads. Paths are relative to the bundle root. `core` is loaded always, in order; a module is loaded only when its signal is observed.",
+  "signals": {
+    "plan-mode": "the host reports it is planning, so the command describes instead of acting",
+    "adopted": "the conversation already produced the analysis, plan or answers the run needs",
+    "probe": "the run rests on a runnable assumption that reading cannot settle",
+    "db": "the run reads or writes a database",
+    "ui": "the run produces or changes a user interface",
+    "split": "the deliverable may have to become more than one document",
+    "shape": "the investigation may have changed what kind of document this is",
+    "input": "the argument is not plainly the document this command expects",
+    "resume": "a prior run over this same input may exist",
+    "replan": "work already executed has to be re-planned around",
+    "simulation": "the change carries temporary behavior with a boundary to declare",
+    "compaction": "the run is long enough that context pressure governs its pacing",
+    "sessions": "a session other than this run's own has to be located, named or reopened",
+    "web": "the run needs evidence from outside the workspace",
+    "reconnaissance": "a draft is being cut from a raw prompt over unfamiliar terrain",
+    "detection": "the CLI's automatic detection was wrong or ambiguous",
+    "scaffold": "the target folder already carries a workspace",
+    "classification": "in-conversation work has to be classified before it is written",
+    "authoring": "the deliverable's own notation, structure or ordering is not obvious from the material"
+  },
+  "commands": {
+    "quick": {
+      "core": [
+        "commands/quick.md",
+        "loops/quick-loop/LOOP.md",
+        "loops/CHASSIS.md",
+        "loops/CODE-POLICIES.md"
+      ],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        },
+        {
+          "path": "modules/PROBE.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/DB-RESEARCH-RULE.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/DB-SCRIPTS-ONLY.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/COMPACTION.md",
+          "signal": "compaction",
+          "requires": "compaction"
+        },
+        {
+          "path": "modules/SESSION-NUMBERING.md",
+          "signal": "sessions"
+        },
+        {
+          "path": "modules/PROMPT-CONTINUITY.md",
+          "signal": "resume"
+        }
+      ]
+    },
+    "spec-new": {
+      "core": ["commands/spec-new.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/RECONNAISSANCE.md",
+          "signal": "reconnaissance"
+        },
+        {
+          "path": "modules/SPLIT-GATE.md",
+          "signal": "split"
+        }
+      ]
+    },
+    "spec-refine": {
+      "core": ["commands/spec-refine.md", "loops/spec-refine-loop/LOOP.md", "loops/CHASSIS.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/SPEC-CHANGE-SHAPE.md",
+          "signal": "shape"
+        },
+        {
+          "path": "modules/SPEC-REFINE-KEYS.md",
+          "signal": "resume"
+        },
+        {
+          "path": "modules/IDEATION-GATE.md",
+          "signal": "web",
+          "requires": "web-research"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        },
+        {
+          "path": "modules/PROBE.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/DB-RESEARCH-RULE.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/COMPACTION.md",
+          "signal": "compaction",
+          "requires": "compaction"
+        },
+        {
+          "path": "modules/SESSION-NUMBERING.md",
+          "signal": "sessions"
+        }
+      ]
+    },
+    "plan-new": {
+      "core": ["commands/plan-new.md", "loops/plan-new-loop/LOOP.md", "loops/CHASSIS.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/PLAN-INPUT.md",
+          "signal": "input"
+        },
+        {
+          "path": "modules/PLAN-SPLIT-GATE.md",
+          "signal": "split"
+        },
+        {
+          "path": "modules/INCREMENTAL-STRATEGY.md",
+          "signal": "split"
+        },
+        {
+          "path": "modules/PLAN-DESIGN-SPECS.md",
+          "signal": "ui"
+        },
+        {
+          "path": "modules/PLAN-PROBE-TASKS.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/PROBE.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        },
+        {
+          "path": "modules/DB-RESEARCH-RULE.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/COMPACTION.md",
+          "signal": "compaction",
+          "requires": "compaction"
+        },
+        {
+          "path": "modules/SESSION-NUMBERING.md",
+          "signal": "sessions"
+        }
+      ]
+    },
+    "plan-refine": {
+      "core": [
+        "commands/plan-refine.md",
+        "loops/plan-refine-loop/LOOP.md",
+        "loops/plan-new-loop/LOOP.md",
+        "loops/CHASSIS.md"
+      ],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/PLAN-INPUT.md",
+          "signal": "input"
+        },
+        {
+          "path": "modules/PLAN-REFINE-KEYS.md",
+          "signal": "resume"
+        },
+        {
+          "path": "modules/PLAN-REFINE-SPLIT.md",
+          "signal": "split"
+        },
+        {
+          "path": "modules/PLAN-SPLIT-GATE.md",
+          "signal": "split"
+        },
+        {
+          "path": "modules/INCREMENTAL-STRATEGY.md",
+          "signal": "split"
+        },
+        {
+          "path": "modules/PLAN-REFINE-DESIGN-SPECS.md",
+          "signal": "ui"
+        },
+        {
+          "path": "modules/PLAN-DESIGN-SPECS.md",
+          "signal": "ui"
+        },
+        {
+          "path": "modules/REPLANNING.md",
+          "signal": "replan"
+        },
+        {
+          "path": "modules/SIMULATION-LIFECYCLE.md",
+          "signal": "simulation"
+        },
+        {
+          "path": "modules/PLAN-PROBE-TASKS.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/PROBE.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        },
+        {
+          "path": "modules/DB-RESEARCH-RULE.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/COMPACTION.md",
+          "signal": "compaction",
+          "requires": "compaction"
+        },
+        {
+          "path": "modules/SESSION-NUMBERING.md",
+          "signal": "sessions"
+        }
+      ]
+    },
+    "plan-exec": {
+      "core": [
+        "commands/plan-exec.md",
+        "loops/plan-exec-loop/LOOP.md",
+        "loops/CHASSIS.md",
+        "loops/CODE-POLICIES.md"
+      ],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/EXEC-PROBE-TASKS.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/PROBE.md",
+          "signal": "probe"
+        },
+        {
+          "path": "modules/EXEC-DB-POLICY.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/DB-SCRIPTS-ONLY.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/DB-RESEARCH-RULE.md",
+          "signal": "db",
+          "requires": "external-data"
+        },
+        {
+          "path": "modules/SIMULATION-LIFECYCLE.md",
+          "signal": "simulation"
+        },
+        {
+          "path": "modules/PLAN-DESIGN-SPECS.md",
+          "signal": "ui"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        },
+        {
+          "path": "modules/COMPACTION.md",
+          "signal": "compaction",
+          "requires": "compaction"
+        },
+        {
+          "path": "modules/SESSION-NUMBERING.md",
+          "signal": "sessions"
+        }
+      ]
+    },
+    "status": {
+      "core": ["commands/status.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        }
+      ]
+    },
+    "resume": {
+      "core": ["commands/resume.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        }
+      ]
+    },
+    "persist": {
+      "core": ["commands/persist.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/PERSIST-ROUTING.md",
+          "signal": "classification"
+        },
+        {
+          "path": "modules/ADOPTED-CONTEXT.md",
+          "signal": "adopted"
+        }
+      ]
+    },
+    "fix-git": {
+      "core": ["commands/fix-git.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        }
+      ]
+    },
+    "generate-launch": {
+      "core": ["commands/generate-launch.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/LAUNCH-DETECTION.md",
+          "signal": "detection"
+        }
+      ]
+    },
+    "workspace-init": {
+      "core": ["commands/workspace-init.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "modules/WORKSPACE-SCAFFOLD.md",
+          "signal": "scaffold"
+        }
+      ]
+    },
+    "export-diagrams": {
+      "core": ["commands/export-diagrams.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "exports/export-diagrams/EXPORT.md",
+          "signal": "authoring"
+        }
+      ]
+    },
+    "export-manuals": {
+      "core": ["commands/export-manuals.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "exports/export-manuals/EXPORT.md",
+          "signal": "authoring"
+        }
+      ]
+    },
+    "export-reports": {
+      "core": ["commands/export-reports.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "exports/export-reports/EXPORT.md",
+          "signal": "authoring"
+        }
+      ]
+    },
+    "export-scripts": {
+      "core": ["commands/export-scripts.md"],
+      "modules": [
+        {
+          "path": "modules/PLAN-MODE.md",
+          "signal": "plan-mode"
+        },
+        {
+          "path": "exports/export-scripts/EXPORT.md",
+          "signal": "authoring"
+        }
+      ]
+    }
+  },
+  "journeys": [
+    {
+      "id": "spec",
+      "label": "SPEC",
+      "command": "spec-refine",
+      "signals": []
+    },
+    {
+      "id": "plan-doc",
+      "label": "PLAN documental",
+      "command": "plan-new",
+      "signals": []
+    },
+    {
+      "id": "code-exec",
+      "label": "ejecucion de codigo",
+      "command": "plan-exec",
+      "signals": []
+    },
+    {
+      "id": "quick",
+      "label": "QUICK",
+      "command": "quick",
+      "signals": []
+    },
+    {
+      "id": "transversal",
+      "label": "transversal",
+      "command": "persist",
+      "signals": []
+    },
+    {
+      "id": "export",
+      "label": "export",
+      "command": "export-scripts",
+      "signals": []
+    }
+  ],
+  "budget_policy": {
+    "$comment": "Ratios of the frozen baseline (spec 009 \u00a7 Decisions: -30% discovery, -40% median and -20% minimum activation, -25% median execution, +5% ceiling per journey). Absolute targets are DERIVED from baseline x ratio, never written by hand. The +5% ceiling also caps modules.total, the conditional tree as one figure: a representative journey carries no signal, so no journey line ever prices a module, and without that line the modules would grow unwatched.",
+    "discovery_max_ratio": 0.7,
+    "activation_median_max_ratio": 0.6,
+    "activation_each_max_ratio": 0.8,
+    "execution_median_max_ratio": 0.75,
+    "journey_max_ratio": 1.05
+  }
+}

package/skills/w/harness/HARNESS.md

@@ -67,7 +67,7 @@ Concrete mechanism per harness (**Jul-2026**, verified against official docs; `~
 
 > **Oz (Warp's cloud sibling).** `oz agent run` is a cloud agent orchestrator that **reuses Warp's surfaces**: same skills (`.agents/skills`, top-level dirs like Warp) and `AGENTS.md`, with `structured-choice` equally degraded to numbered markdown. It differs in three points: **detection** via `OZ_RUN_ID` (takes priority over Warp when both markers coexist); **MCP without a config file** — the JSON is passed via the `--mcp` flag of `oz agent run` (or the `OZ_MCP_CONFIG` env), it never writes `.warp/.mcp.json`; and **no plugin or hooks** (advisory enforcement, like Warp). Hence it shares the **Warp / Oz** column with that MCP caveat.
 
-> **compaction (signal & self-regulation).** The chassis' *Self-regulation (proactive compaction)* doctrine (`../loops/CHASSIS.md` § *Compact / resume*) needs two per-host facts: the **context-pressure signal** (does the host surface one the agent can read?) and **`auto`-mode viability** (can compaction fire **without user interaction**?). Claude Code: the signal is the harness' own context warnings; `/compact` is user-invoked — the agent cannot run it itself, so `auto` **degrades to `confirm`** there (the native auto-compact is already cushioned by the PreCompact/PostCompact hooks: checkpoint-write + resume-summary). Hosts with compaction hooks/events (Codex Pre/PostCompact, OpenCode `session.compacted`) cushion resume the same way; hosts with neither signal nor mechanism run the universal fallback (CHECKPOINT + restart + resume) and `auto` likewise degrades. Mode semantics (`[compaction]` config, default, consent): the chassis' subsection — single source.
+> **compaction (signal & self-regulation).** The chassis' *Self-regulation (proactive compaction)* doctrine (`../modules/COMPACTION.md`, loaded under the `compaction` signal) needs two per-host facts: the **context-pressure signal** (does the host surface one the agent can read?) and **`auto`-mode viability** (can compaction fire **without user interaction**?). Claude Code: the signal is the harness' own context warnings; `/compact` is user-invoked — the agent cannot run it itself, so `auto` **degrades to `confirm`** there (the native auto-compact is already cushioned by the PreCompact/PostCompact hooks: checkpoint-write + resume-summary). Hosts with compaction hooks/events (Codex Pre/PostCompact, OpenCode `session.compacted`) cushion resume the same way; hosts with neither signal nor mechanism run the universal fallback (CHECKPOINT + restart + resume) and `auto` likewise degrades. Mode semantics (`[compaction]` config, default, consent): the chassis' subsection — single source.
 
 > **host-memory (tiers & consumers).** Two tiers: *cheap* (structured, bounded — on Claude Code the auto-memory `MEMORY.md` + `CLAUDE.md`) and *deep* (transcript / `--resume` search, expensive). Consumers: **`/status`** reads only the *cheap* tier, **opportunistically and additively** (a `CONTEXTO DEL HOST` section when available; it **never asks** — a read-only dashboard — and silently omits the section on degrade); **`/resume`** **composes `/status`** and escalates a host-only finding **to a proposal only when the workline level does not explain the pending work** (the spec's fixed order governs the proposals, not the summary), optionally using the *deep* tier or asking as fallback. It is *enhancement*, never a `must`.
 

package/skills/w/hooks/README.md

@@ -11,8 +11,27 @@
 | `PreToolUse` (`execute_sql`) | `hook sql-mutation-guard` | Blocks DML/DDL over MCP — reads only (DB scripts-only invariant). |
 | `PreToolUse` (Bash) | `hook git-commit-advisor` | **Advisory (does not block)**: warns if a `git commit` message lacks the active session's `sessionNNN` tag (traceability). Does **not** inspect `push`/`--amend`/`--no-verify`. |
 | `SessionEnd` | `auto-compact-on-close` | Writes `CHECKPOINT.md` on close — the resume key (*CHECKPOINT always* — chassis § Convergence / exit). |
-| `PreCompact` | `checkpoint-write` | Writes `CHECKPOINT.md` before the host compacts. |
-| `PostCompact` | `resume-summary` | Recovers the active loop state after a compact. |
+| `PreCompact` | `checkpoint-write --can-pause` | Writes `CHECKPOINT.md` before the host compacts. |
+| `PostCompact` | `resume-summary` | Recovers **the conversation's own** loop state after a compact. |
+
+> **Conversation identity (spec 011).** The three lifecycle hooks act on **one**
+> session — the conversation's own — never on "the first active one" and never
+> on all of them. They resolve it with the canonical precedence: explicit
+> `--code` → the conversation's durable association → the sole active session.
+> The identity travels in the hook payload's `session_id` (read from stdin) or
+> in `AW_CONTEXT_ID`; two signals naming different conversations fail with
+> `CONTEXT_ID_CONFLICT` instead of picking one. The association lives in
+> `.workflow/sessions/.bindings.json` keyed by the SHA-256 of that id — the raw
+> value is never persisted.
+>
+> **Ambiguity is a capability question, not a guess.** `--can-pause` declares
+> that *this host* can hold its compaction: Claude Code can, so the template
+> passes it and `checkpoint-write` exits **2** with the candidate list instead of
+> writing to an arbitrary session. A host that cannot pause omits the flag —
+> its native compaction completes, and Workline reports
+> `continuity: "degraded"` with `primary_session: null`, having written nothing.
+> The flag is never inferred: guessing it produces false blocks. Per-host
+> installation and transport belong to spec 010.
 
 > **What they enforce (host-level, blocking):** invariant **#4** (DB scripts-only) via `sql-mutation-guard` (blocks DML/DDL over MCP), and the *expected-branch* clause of **#5** via `branch-check` (blocks edits on the wrong branch). The rest of git-safe (`push`/`--amend`/`--no-verify`/`--force`) is **doctrinal** — `git-commit-advisor` only **warns**, it does not block; a host may add its own deny hook if it wants hard enforcement.
 >

package/skills/w/hooks/hooks.template.json

@@ -62,7 +62,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "agent-workflow checkpoint-write",
+            "command": "agent-workflow checkpoint-write --can-pause",
             "statusMessage": "Escribiendo CHECKPOINT.md antes de compactar...",
             "timeout": 10
           }
@@ -81,7 +81,7 @@
           },
           {
             "type": "prompt",
-            "prompt": "Contexto compactado. El JSON anterior es output de `agent-workflow resume-summary`. Si hay `active_sessions`, reanudá el loop activo desde su CHECKPOINT.md y presentá un resumen. Si está vacío, terminá."
+            "prompt": "Contexto compactado. El JSON anterior es output de `agent-workflow resume-summary`. Si `continuity` es `ok`, reanudá el loop de `primary_session` desde su CHECKPOINT.md y presentá un resumen. Si `continuity` es `degraded`, NO reanudes ninguna sesión: `active_sessions` es un listado, no una identidad — mostrá `candidates` con su `action` y pedí al usuario que elija (después reintentá con `--code <NNN>`). Si no hay sesiones, terminá."
           }
         ]
       }