grok-taskflow 0.2.7 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +37 -12
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  <div align="center">
2
2
 
3
- <img src="https://raw.githubusercontent.com/heggria/taskflow/main/assets/hero.png" alt="taskflow: compile, verify, and run multi-agent DAGs across five coding-agent hosts" width="100%">
3
+ <img src="https://raw.githubusercontent.com/heggria/taskflow/main/assets/hero.png" alt="taskflow: compile, verify, and run multi-agent DAGs across six coding-agent hosts" width="100%">
4
4
 
5
5
  <br />
6
6
 
@@ -8,12 +8,12 @@
8
8
  [![CI](https://img.shields.io/github/actions/workflow/status/heggria/taskflow/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/heggria/taskflow/actions/workflows/ci.yml)
9
9
  [![Node](https://img.shields.io/badge/node-%E2%89%A522.19-35C99A?style=flat-square)](https://nodejs.org)
10
10
  [![License](https://img.shields.io/badge/license-MIT-35C99A?style=flat-square)](https://github.com/heggria/taskflow/blob/main/LICENSE)
11
- [![Hosts](https://img.shields.io/badge/hosts-5-7775FF?style=flat-square)](#install-on-your-host)
11
+ [![Hosts](https://img.shields.io/badge/hosts-6-7775FF?style=flat-square)](#install-on-your-host)
12
12
  [![Tests](https://img.shields.io/badge/tests-1%2C500%2B-7775FF?style=flat-square)](#built-to-survive-real-work)
13
13
 
14
14
  **English** · [简体中文](https://github.com/heggria/taskflow/blob/main/README.zh-CN.md)
15
15
 
16
- [Install](#install-on-your-host) · [Quickstart](#60-second-start) · [What's new in 0.2.7](#027-plan-before-spend--close-the-loop) · [0.2 compiler turn](#02-is-the-compiler-turn) · [Docs](https://heggria.github.io/taskflow/en/docs) · [Examples](https://github.com/heggria/taskflow/blob/main/examples)
16
+ [Install](#install-on-your-host) · [Quickstart](#60-second-start) · [What's new in 0.2.9](#029-hermes-agent--verify-parity) · [0.2 compiler turn](#02-is-the-compiler-turn) · [Docs](https://heggria.github.io/taskflow/en/docs) · [Examples](https://github.com/heggria/taskflow/blob/main/examples)
17
17
 
18
18
  </div>
19
19
 
@@ -25,7 +25,7 @@
25
25
 
26
26
  It runs on the coding agent you already use:
27
27
 
28
- **Pi · Codex · Claude Code · OpenCode · Grok Build**
28
+ **Pi · Codex · Claude Code · OpenCode · Grok Build · Hermes Agent**
29
29
 
30
30
  ```text
31
31
  JSON or .tf.ts
@@ -54,7 +54,7 @@ Built-in subagent tools are excellent for one turn. The moment the work branches
54
54
  | **Intermediate output** | Floods the host context | **Stays isolated in the runtime** |
55
55
  | **Failure** | Start over or reconstruct state | **Resume from persisted phase state** |
56
56
  | **Changed input** | Re-run broadly | **Explain staleness and re-run the affected frontier** |
57
- | **Portability** | Coupled to one agent | **One JSON contract across five hosts** |
57
+ | **Portability** | Coupled to one agent | **One JSON contract across six hosts** |
58
58
 
59
59
  The trade is deliberate: less arbitrary orchestration code, more **verifiability, observability, recovery, and reuse**.
60
60
 
@@ -131,7 +131,7 @@ Save it as `.pi/taskflows/audit-api.json`, then run:
131
131
  /tf:audit-api dir=src/api
132
132
  ```
133
133
 
134
- On Codex, Claude Code, OpenCode, and Grok Build, run the same saved definition by name through `taskflow_run`. For long DAGs, use `mode: "background"`, then manage the durable run with `taskflow_runs` (`list` / `status` / `wait` / `cancel`); list output reports active concurrency and can filter `running` or `terminal` runs.
134
+ On Codex, Claude Code, OpenCode, Grok Build, and Hermes Agent, run the same saved definition by name through `taskflow_run`. For long DAGs, use `mode: "background"`, then manage the durable run with `taskflow_runs` (`list` / `status` / `wait` / `cancel`); list output reports active concurrency and can filter `running` or `terminal` runs.
135
135
 
136
136
  [Follow the full quickstart →](https://heggria.github.io/taskflow/en/docs/getting-started)
137
137
 
@@ -152,6 +152,18 @@ This is real output from a Pi run—not a mock dashboard:
152
152
 
153
153
  The layout **is** the DAG. Parallel rails expose concurrency; long edges expose dependencies; the gate explains why downstream work stopped. No separate control plane is required to understand the run.
154
154
 
155
+ ## 0.2.9: Hermes Agent + verify parity
156
+
157
+ Taskflow now ships on **Hermes Agent** as `hermes-taskflow`, bringing the same MCP control plane to a sixth host. Hermes children run with an ephemeral home, explicit toolsets, cwd-confined local reads, provider-only credential material, and an explicit opt-in for mutating `--yolo` phases.
158
+
159
+ Pi's advertised `/tf verify <name>` command now matches the tool surface, including saved flow names containing spaces. Project discovery also stops at canonical home/temp boundaries, so ambient `/tmp/.pi` state cannot become a project by accident. [Full 0.2.9 notes →](https://github.com/heggria/taskflow/blob/main/CHANGELOG.md#029--2026-08-11)
160
+
161
+ ## 0.2.8: review, then confirm
162
+
163
+ Pi approvals now separate **selection** from **commit**. Choose Reject, Edit guidance, or Approve with `R` / `E` / `A`, arrows, or Tab; press Enter to confirm. The safe default is Reject, and Escape or Ctrl-C still rejects immediately.
164
+
165
+ Long proposals start collapsed. Press `V` to open an inline scrollable preview while the decision footer stays visible; short proposals remain open by default. Full notes: [CHANGELOG 0.2.8](https://github.com/heggria/taskflow/blob/main/CHANGELOG.md#028--2026-08-10).
166
+
155
167
  ## 0.2.7: plan before spend · close the loop
156
168
 
157
169
  The 0.2 line made graphs **compiled and inspectable**. **0.2.7** makes the day-to-day loop feel finished: you can see the plan *before* any model call, and you can hear about the run *after* it finishes — without stuffing transcripts into the host.
@@ -343,7 +355,7 @@ claude plugin install claude-taskflow@taskflow
343
355
 
344
356
  ```bash
345
357
  opencode mcp add taskflow -- \
346
- npx -y -p opencode-taskflow@0.2.7 opencode-taskflow-mcp
358
+ npx -y -p opencode-taskflow@0.2.9 opencode-taskflow-mcp
347
359
  ```
348
360
 
349
361
  [OpenCode guide →](https://heggria.github.io/taskflow/en/docs/guides/opencode)
@@ -352,18 +364,31 @@ opencode mcp add taskflow -- \
352
364
 
353
365
  ```bash
354
366
  grok mcp add taskflow -- \
355
- npx -y -p grok-taskflow@0.2.7 grok-taskflow-mcp
367
+ npx -y -p grok-taskflow@0.2.9 grok-taskflow-mcp
356
368
  ```
357
369
 
358
370
  Grok Build support is new in 0.2. Its CLI stream does not report token/cost usage, so budget-declaring flows are rejected rather than silently running without enforcement.
359
371
 
360
372
  [Grok Build guide →](https://heggria.github.io/taskflow/en/docs/guides/grok-build)
361
373
 
374
+ ### Hermes Agent
375
+
376
+ ```bash
377
+ hermes mcp add taskflow --command npx --args -y -p hermes-taskflow@0.2.9 hermes-taskflow-mcp
378
+ # Prefer env in config.yaml (not CLI --env after args — can be stuffed into argv):
379
+ # mcp_servers.taskflow.env.PI_TASKFLOW_HERMES_UNSAFE_YOLO: "1" # mutating only
380
+ ```
381
+
382
+ Hermes quiet mode does not report token/cost usage, so budget-declaring flows are rejected rather than silently running without enforcement. Child agents use an ephemeral HERMES_HOME with only non-secret model/fallback routing, a routed-provider-only inference `auth.json`, and provider-allowlisted dotenv keys; parent MCP, skills, memory, sessions, and rules are not inherited. RO local-read → `taskflow_readonly_files`; else `taskflow_model_only` (never omit `-t`).
383
+
384
+ [Hermes guide →](https://github.com/heggria/taskflow/blob/main/docs/hermes-mcp.md)
385
+
386
+
362
387
  ## Built to survive real work
363
388
 
364
389
  <div align="center">
365
390
 
366
- **9 packages** · **5 hosts** · **12 phase types** · **18 built-in agents** · **1,500+ tests** · **MIT**
391
+ **10 packages** · **6 hosts** · **12 phase types** · **18 built-in agents** · **1,500+ tests** · **MIT**
367
392
 
368
393
  </div>
369
394
 
@@ -375,10 +400,10 @@ Grok Build support is new in 0.2. Its CLI stream does not report token/cost usag
375
400
  taskflow-hosts ─────┼─ codex-taskflow
376
401
  ├─ claude-taskflow
377
402
  ├─ opencode-taskflow
378
- └─ grok-taskflow
403
+ └─ grok-taskflow / hermes-taskflow
379
404
  ```
380
405
 
381
- `taskflow-core` is host-neutral and imports no host SDK. `taskflow-mcp-core` implements stdio JSON-RPC without an MCP SDK dependency; `taskflow-hosts` owns the shared host process runners. The four MCP delivery packages bind both layers (and core), while Pi keeps its native adapter.
406
+ `taskflow-core` is host-neutral and imports no host SDK. `taskflow-mcp-core` implements stdio JSON-RPC without an MCP SDK dependency; `taskflow-hosts` owns the shared host process runners. The five MCP delivery packages bind both layers (and core), while Pi keeps its native adapter.
382
407
 
383
408
  The test suite covers orchestration semantics, persistence and file-lock races, cache freshness, path traversal, dynamic graph hardening, cancellation, budgets, all 12 phase kinds, FlowIR/replay/recompute, TypeScript DSL erasure, host argv contracts, MCP servers, and packed consumer imports.
384
409
 
@@ -390,7 +415,7 @@ The test suite covers orchestration semantics, persistence and file-lock races,
390
415
  | [Concepts](https://heggria.github.io/taskflow/en/docs/concepts/) | DAGs, isolation, verification, resume, shared context |
391
416
  | [Syntax](https://heggria.github.io/taskflow/en/docs/syntax/) | Phase fields, control flow, budgets, caching, scorers |
392
417
  | [Compiler & Runtime](https://heggria.github.io/taskflow/en/docs/compiler-runtime/) | TypeScript DSL, FlowIR, replay, recompute, background runs |
393
- | [Host Guides](https://heggria.github.io/taskflow/en/docs/guides/) | Pi, Codex, Claude Code, OpenCode, and Grok setup |
418
+ | [Host Guides](https://heggria.github.io/taskflow/en/docs/guides/) | Pi, Codex, Claude Code, OpenCode, Grok, and Hermes setup |
394
419
  | [Reference](https://heggria.github.io/taskflow/en/docs/reference/) | Commands, shorthand, and exact tool surfaces |
395
420
  | [Showcase](https://heggria.github.io/taskflow/en/docs/showcase/) | Real flows and case studies |
396
421
  | [0.2.0 Frontier Assessment](https://github.com/heggria/taskflow/blob/main/docs/taskflow-0.2.0-frontier-assessment.zh-CN.md) | Independent, evidence-based technical assessment (Chinese) |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "grok-taskflow",
3
- "version": "0.2.7",
4
- "description": "Run taskflow on Grok Build: a Grok subagent runner plus an MCP server (and a plug-and-play Grok plugin) that exposes the taskflow_* tools to Grok Build users.",
3
+ "version": "0.2.9",
4
+ "description": "Run taskflow on Grok Build: the npm tarball provides the Grok subagent runner and MCP server; the plugin is distributed through the repository marketplace.",
5
5
  "keywords": [
6
6
  "grok",
7
7
  "grok-build",
@@ -49,9 +49,9 @@
49
49
  "access": "public"
50
50
  },
51
51
  "dependencies": {
52
- "taskflow-core": "0.2.7",
53
- "taskflow-hosts": "0.2.7",
54
- "taskflow-mcp-core": "0.2.7"
52
+ "taskflow-core": "0.2.9",
53
+ "taskflow-hosts": "0.2.9",
54
+ "taskflow-mcp-core": "0.2.9"
55
55
  },
56
56
  "scripts": {
57
57
  "build": "rm -rf dist && tsc -p tsconfig.build.json && node ../../scripts/copy-readme.mjs grok-taskflow"