@operatorstack/yield 0.2.0 → 0.3.0

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 +14 -9
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -30,6 +30,9 @@ programs. The canonical workflow stays inside your repository beside the code
30
30
  and dependencies it uses. Generated `SKILL.md` files only help coding agents
31
31
  discover it.
32
32
 
33
+ Write the workflow in code. Use `AgentTask` only where a bounded step needs
34
+ coding-agent judgment, then continue with structured data in normal code.
35
+
33
36
  Verified with Cursor, Codex, and Claude Code. Registry-backed project paths are
34
37
  available for 73 more coding agents.
35
38
 
@@ -71,7 +74,9 @@ A release skill often starts as prose:
71
74
  > Run the tests. Review the release. Stop if the review finds a critical issue.
72
75
  > Ask me before publishing. Publish the package, then verify the registry.
73
76
 
74
- Yield makes the order and stopping rules executable:
77
+ Yield makes the order and stopping rules executable. The coding agent reviews
78
+ what the deterministic check may miss; the program still owns the gate,
79
+ approval, publish, and verification steps:
75
80
 
76
81
  <!-- release-example:start -->
77
82
 
@@ -91,7 +96,7 @@ defineSkill((ctx) => {
91
96
  // coding agent's response at runtime before this workflow can continue.
92
97
  const review = ctx.agentTask<Review>(
93
98
  "review-release",
94
- "Review this release. Report critical findings and a short summary.",
99
+ "Review this release for correctness problems that the test command may miss. Report critical findings and a short summary.",
95
100
  { stdout: tests.stdout, stderr: tests.stderr },
96
101
  {
97
102
  type: "object",
@@ -236,13 +241,13 @@ The agent follows the generated adapter, runs the canonical workflow in
236
241
  If replay produces a different operation, the run fails instead of silently
237
242
  forking. Every side effect crosses one of these primitives:
238
243
 
239
- | Primitive | Purpose |
240
- | --------------------- | ------------------------------------------------------ |
241
- | `runCommand` | Execute a command and record its exit code and output. |
242
- | `agentTask` | Ask the coding agent for schema-valid JSON. |
243
- | `askUser` | Request an explicit human decision. |
244
- | `require` | Bind a required claim to recorded evidence. |
245
- | `blocked` / `refused` | Stop honestly when work cannot or must not continue. |
244
+ | Primitive | Purpose |
245
+ | --------------------- | ----------------------------------------------------------------------- |
246
+ | `runCommand` | Execute a command and record its exit code and output. |
247
+ | `agentTask` | Delegate one bounded judgment; an optional schema validates the result. |
248
+ | `askUser` | Request an explicit human decision. |
249
+ | `require` | Bind a required claim to recorded evidence. |
250
+ | `blocked` / `refused` | Stop honestly when work cannot or must not continue. |
246
251
 
247
252
  See the [primitive guides](https://github.com/operatorstack/yield/blob/main/docs/primitives/README.md) and
248
253
  [runtime reference](https://github.com/operatorstack/yield/blob/main/docs/reference/cli.md) for the full contract.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@operatorstack/yield",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "Yield skill-program SDK for TypeScript: turn SKILL.md workflows into resumable programs.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -50,11 +50,11 @@
50
50
  "registry": "https://registry.npmjs.org/"
51
51
  },
52
52
  "optionalDependencies": {
53
- "@operatorstack/yield-darwin-amd64": "0.2.0",
54
- "@operatorstack/yield-darwin-arm64": "0.2.0",
55
- "@operatorstack/yield-linux-amd64": "0.2.0",
56
- "@operatorstack/yield-linux-arm64": "0.2.0",
57
- "@operatorstack/yield-windows-amd64": "0.2.0",
58
- "@operatorstack/yield-windows-arm64": "0.2.0"
53
+ "@operatorstack/yield-darwin-amd64": "0.3.0",
54
+ "@operatorstack/yield-darwin-arm64": "0.3.0",
55
+ "@operatorstack/yield-linux-amd64": "0.3.0",
56
+ "@operatorstack/yield-linux-arm64": "0.3.0",
57
+ "@operatorstack/yield-windows-amd64": "0.3.0",
58
+ "@operatorstack/yield-windows-arm64": "0.3.0"
59
59
  }
60
60
  }