@entelligentsia/forgecli 0.6.6 → 0.7.6

package/node_modules/yargs-parser/CHANGELOG.md

@@ -0,0 +1,263 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [20.2.9](https://www.github.com/yargs/yargs-parser/compare/yargs-parser-v20.2.8...yargs-parser-v20.2.9) (2021-06-20)
+
+
+### Bug Fixes
+
+* **build:** fixed automated release pipeline ([1fe9135](https://www.github.com/yargs/yargs-parser/commit/1fe9135884790a083615419b2861683e2597dac3))
+
+### [20.2.8](https://www.github.com/yargs/yargs-parser/compare/yargs-parser-v20.2.7...yargs-parser-v20.2.8) (2021-06-20)
+
+
+### Bug Fixes
+
+* **locale:** Turkish camelize and decamelize issues with toLocaleLowerCase/toLocaleUpperCase ([2617303](https://www.github.com/yargs/yargs-parser/commit/261730383e02448562f737b94bbd1f164aed5143))
+* **perf:** address slow parse when using unknown-options-as-args ([#394](https://www.github.com/yargs/yargs-parser/issues/394)) ([441f059](https://www.github.com/yargs/yargs-parser/commit/441f059d585d446551068ad213db79ac91daf83a))
+* **string-utils:** detect [0,1] ranged values as numbers ([#388](https://www.github.com/yargs/yargs-parser/issues/388)) ([efcc32c](https://www.github.com/yargs/yargs-parser/commit/efcc32c2d6b09aba31abfa2db9bd947befe5586b))
+
+### [20.2.7](https://www.github.com/yargs/yargs-parser/compare/v20.2.6...v20.2.7) (2021-03-10)
+
+
+### Bug Fixes
+
+* **deno:** force release for Deno ([6687c97](https://www.github.com/yargs/yargs-parser/commit/6687c972d0f3ca7865a97908dde3080b05f8b026))
+
+### [20.2.6](https://www.github.com/yargs/yargs-parser/compare/v20.2.5...v20.2.6) (2021-02-22)
+
+
+### Bug Fixes
+
+* **populate--:** -- should always be array ([#354](https://www.github.com/yargs/yargs-parser/issues/354)) ([585ae8f](https://www.github.com/yargs/yargs-parser/commit/585ae8ffad74cc02974f92d788e750137fd65146))
+
+### [20.2.5](https://www.github.com/yargs/yargs-parser/compare/v20.2.4...v20.2.5) (2021-02-13)
+
+
+### Bug Fixes
+
+* do not lowercase camel cased string ([#348](https://www.github.com/yargs/yargs-parser/issues/348)) ([5f4da1f](https://www.github.com/yargs/yargs-parser/commit/5f4da1f17d9d50542d2aaa206c9806ce3e320335))
+
+### [20.2.4](https://www.github.com/yargs/yargs-parser/compare/v20.2.3...v20.2.4) (2020-11-09)
+
+
+### Bug Fixes
+
+* **deno:** address import issues in Deno ([#339](https://www.github.com/yargs/yargs-parser/issues/339)) ([3b54e5e](https://www.github.com/yargs/yargs-parser/commit/3b54e5eef6e9a7b7c6eec7c12bab3ba3b8ba8306))
+
+### [20.2.3](https://www.github.com/yargs/yargs-parser/compare/v20.2.2...v20.2.3) (2020-10-16)
+
+
+### Bug Fixes
+
+* **exports:** node 13.0 and 13.1 require the dotted object form _with_ a string fallback ([#336](https://www.github.com/yargs/yargs-parser/issues/336)) ([3ae7242](https://www.github.com/yargs/yargs-parser/commit/3ae7242040ff876d28dabded60ac226e00150c88))
+
+### [20.2.2](https://www.github.com/yargs/yargs-parser/compare/v20.2.1...v20.2.2) (2020-10-14)
+
+
+### Bug Fixes
+
+* **exports:** node 13.0-13.6 require a string fallback ([#333](https://www.github.com/yargs/yargs-parser/issues/333)) ([291aeda](https://www.github.com/yargs/yargs-parser/commit/291aeda06b685b7a015d83bdf2558e180b37388d))
+
+### [20.2.1](https://www.github.com/yargs/yargs-parser/compare/v20.2.0...v20.2.1) (2020-10-01)
+
+
+### Bug Fixes
+
+* **deno:** update types for deno ^1.4.0 ([#330](https://www.github.com/yargs/yargs-parser/issues/330)) ([0ab92e5](https://www.github.com/yargs/yargs-parser/commit/0ab92e50b090f11196334c048c9c92cecaddaf56))
+
+## [20.2.0](https://www.github.com/yargs/yargs-parser/compare/v20.1.0...v20.2.0) (2020-09-21)
+
+
+### Features
+
+* **string-utils:** export looksLikeNumber helper ([#324](https://www.github.com/yargs/yargs-parser/issues/324)) ([c8580a2](https://www.github.com/yargs/yargs-parser/commit/c8580a2327b55f6342acecb6e72b62963d506750))
+
+
+### Bug Fixes
+
+* **unknown-options-as-args:** convert positionals that look like numbers ([#326](https://www.github.com/yargs/yargs-parser/issues/326)) ([f85ebb4](https://www.github.com/yargs/yargs-parser/commit/f85ebb4face9d4b0f56147659404cbe0002f3dad))
+
+## [20.1.0](https://www.github.com/yargs/yargs-parser/compare/v20.0.0...v20.1.0) (2020-09-20)
+
+
+### Features
+
+* adds parse-positional-numbers configuration ([#321](https://www.github.com/yargs/yargs-parser/issues/321)) ([9cec00a](https://www.github.com/yargs/yargs-parser/commit/9cec00a622251292ffb7dce6f78f5353afaa0d4c))
+
+
+### Bug Fixes
+
+* **build:** update release-please; make labels kick off builds ([#323](https://www.github.com/yargs/yargs-parser/issues/323)) ([09f448b](https://www.github.com/yargs/yargs-parser/commit/09f448b4cd66e25d2872544718df46dab8af062a))
+
+## [20.0.0](https://www.github.com/yargs/yargs-parser/compare/v19.0.4...v20.0.0) (2020-09-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* do not ship type definitions (#318)
+
+### Bug Fixes
+
+* only strip camel case if hyphenated ([#316](https://www.github.com/yargs/yargs-parser/issues/316)) ([95a9e78](https://www.github.com/yargs/yargs-parser/commit/95a9e785127b9bbf2d1db1f1f808ca1fb100e82a)), closes [#315](https://www.github.com/yargs/yargs-parser/issues/315)
+
+
+### Code Refactoring
+
+* do not ship type definitions ([#318](https://www.github.com/yargs/yargs-parser/issues/318)) ([8fbd56f](https://www.github.com/yargs/yargs-parser/commit/8fbd56f1d0b6c44c30fca62708812151ca0ce330))
+
+### [19.0.4](https://www.github.com/yargs/yargs-parser/compare/v19.0.3...v19.0.4) (2020-08-27)
+
+
+### Bug Fixes
+
+* **build:** fixing publication ([#310](https://www.github.com/yargs/yargs-parser/issues/310)) ([5d3c6c2](https://www.github.com/yargs/yargs-parser/commit/5d3c6c29a9126248ba601920d9cf87c78e161ff5))
+
+### [19.0.3](https://www.github.com/yargs/yargs-parser/compare/v19.0.2...v19.0.3) (2020-08-27)
+
+
+### Bug Fixes
+
+* **build:** switch to action for publish ([#308](https://www.github.com/yargs/yargs-parser/issues/308)) ([5c2f305](https://www.github.com/yargs/yargs-parser/commit/5c2f30585342bcd8aaf926407c863099d256d174))
+
+### [19.0.2](https://www.github.com/yargs/yargs-parser/compare/v19.0.1...v19.0.2) (2020-08-27)
+
+
+### Bug Fixes
+
+* **types:** envPrefix should be optional ([#305](https://www.github.com/yargs/yargs-parser/issues/305)) ([ae3f180](https://www.github.com/yargs/yargs-parser/commit/ae3f180e14df2de2fd962145f4518f9aa0e76523))
+
+### [19.0.1](https://www.github.com/yargs/yargs-parser/compare/v19.0.0...v19.0.1) (2020-08-09)
+
+
+### Bug Fixes
+
+* **build:** push tag created for deno ([2186a14](https://www.github.com/yargs/yargs-parser/commit/2186a14989749887d56189867602e39e6679f8b0))
+
+## [19.0.0](https://www.github.com/yargs/yargs-parser/compare/v18.1.3...v19.0.0) (2020-08-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* adds support for ESM and Deno (#295)
+* **ts:** projects using `@types/yargs-parser` may see variations in type definitions.
+* drops Node 6. begin following Node.js LTS schedule (#278)
+
+### Features
+
+* adds support for ESM and Deno ([#295](https://www.github.com/yargs/yargs-parser/issues/295)) ([195bc4a](https://www.github.com/yargs/yargs-parser/commit/195bc4a7f20c2a8f8e33fbb6ba96ef6e9a0120a1))
+* expose camelCase and decamelize helpers ([#296](https://www.github.com/yargs/yargs-parser/issues/296)) ([39154ce](https://www.github.com/yargs/yargs-parser/commit/39154ceb5bdcf76b5f59a9219b34cedb79b67f26))
+* **deps:** update to latest camelcase/decamelize ([#281](https://www.github.com/yargs/yargs-parser/issues/281)) ([8931ab0](https://www.github.com/yargs/yargs-parser/commit/8931ab08f686cc55286f33a95a83537da2be5516))
+
+
+### Bug Fixes
+
+* boolean numeric short option ([#294](https://www.github.com/yargs/yargs-parser/issues/294)) ([f600082](https://www.github.com/yargs/yargs-parser/commit/f600082c959e092076caf420bbbc9d7a231e2418))
+* raise permission error for Deno if config load fails ([#298](https://www.github.com/yargs/yargs-parser/issues/298)) ([1174e2b](https://www.github.com/yargs/yargs-parser/commit/1174e2b3f0c845a1cd64e14ffc3703e730567a84))
+* **deps:** update dependency decamelize to v3 ([#274](https://www.github.com/yargs/yargs-parser/issues/274)) ([4d98698](https://www.github.com/yargs/yargs-parser/commit/4d98698bc6767e84ec54a0842908191739be73b7))
+* **types:** switch back to using Partial types ([#293](https://www.github.com/yargs/yargs-parser/issues/293)) ([bdc80ba](https://www.github.com/yargs/yargs-parser/commit/bdc80ba59fa13bc3025ce0a85e8bad9f9da24ea7))
+
+
+### Build System
+
+* drops Node 6. begin following Node.js LTS schedule ([#278](https://www.github.com/yargs/yargs-parser/issues/278)) ([9014ed7](https://www.github.com/yargs/yargs-parser/commit/9014ed722a32768b96b829e65a31705db5c1458a))
+
+
+### Code Refactoring
+
+* **ts:** move index.js to TypeScript ([#292](https://www.github.com/yargs/yargs-parser/issues/292)) ([f78d2b9](https://www.github.com/yargs/yargs-parser/commit/f78d2b97567ac4828624406e420b4047c710b789))
+
+### [18.1.3](https://www.github.com/yargs/yargs-parser/compare/v18.1.2...v18.1.3) (2020-04-16)
+
+
+### Bug Fixes
+
+* **setArg:** options using camel-case and dot-notation populated twice ([#268](https://www.github.com/yargs/yargs-parser/issues/268)) ([f7e15b9](https://www.github.com/yargs/yargs-parser/commit/f7e15b9800900b9856acac1a830a5f35847be73e))
+
+### [18.1.2](https://www.github.com/yargs/yargs-parser/compare/v18.1.1...v18.1.2) (2020-03-26)
+
+
+### Bug Fixes
+
+* **array, nargs:** support -o=--value and --option=--value format ([#262](https://www.github.com/yargs/yargs-parser/issues/262)) ([41d3f81](https://www.github.com/yargs/yargs-parser/commit/41d3f8139e116706b28de9b0de3433feb08d2f13))
+
+### [18.1.1](https://www.github.com/yargs/yargs-parser/compare/v18.1.0...v18.1.1) (2020-03-16)
+
+
+### Bug Fixes
+
+* \_\_proto\_\_ will now be replaced with \_\_\_proto\_\_\_ in parse ([#258](https://www.github.com/yargs/yargs-parser/issues/258)), patching a potential 
+prototype pollution vulnerability. This was reported by the Snyk Security Research Team.([63810ca](https://www.github.com/yargs/yargs-parser/commit/63810ca1ae1a24b08293a4d971e70e058c7a41e2))
+
+## [18.1.0](https://www.github.com/yargs/yargs-parser/compare/v18.0.0...v18.1.0) (2020-03-07)
+
+
+### Features
+
+* introduce single-digit boolean aliases ([#255](https://www.github.com/yargs/yargs-parser/issues/255)) ([9c60265](https://www.github.com/yargs/yargs-parser/commit/9c60265fd7a03cb98e6df3e32c8c5e7508d9f56f))
+
+## [18.0.0](https://www.github.com/yargs/yargs-parser/compare/v17.1.0...v18.0.0) (2020-03-02)
+
+
+### ⚠ BREAKING CHANGES
+
+* the narg count is now enforced when parsing arrays.
+
+### Features
+
+* NaN can now be provided as a value for nargs, indicating "at least" one value is expected for array ([#251](https://www.github.com/yargs/yargs-parser/issues/251)) ([9db4be8](https://www.github.com/yargs/yargs-parser/commit/9db4be81417a2c7097128db34d86fe70ef4af70c))
+
+## [17.1.0](https://www.github.com/yargs/yargs-parser/compare/v17.0.1...v17.1.0) (2020-03-01)
+
+
+### Features
+
+* introduce greedy-arrays config, for specifying whether arrays consume multiple positionals ([#249](https://www.github.com/yargs/yargs-parser/issues/249)) ([60e880a](https://www.github.com/yargs/yargs-parser/commit/60e880a837046314d89fa4725f923837fd33a9eb))
+
+### [17.0.1](https://www.github.com/yargs/yargs-parser/compare/v17.0.0...v17.0.1) (2020-02-29)
+
+
+### Bug Fixes
+
+* normalized keys were not enumerable ([#247](https://www.github.com/yargs/yargs-parser/issues/247)) ([57119f9](https://www.github.com/yargs/yargs-parser/commit/57119f9f17cf27499bd95e61c2f72d18314f11ba))
+
+## [17.0.0](https://www.github.com/yargs/yargs-parser/compare/v16.1.0...v17.0.0) (2020-02-10)
+
+
+### ⚠ BREAKING CHANGES
+
+* this reverts parsing behavior of booleans to that of yargs@14
+* objects used during parsing are now created with a null
+prototype. There may be some scenarios where this change in behavior
+leaks externally.
+
+### Features
+
+* boolean arguments will not be collected into an implicit array ([#236](https://www.github.com/yargs/yargs-parser/issues/236)) ([34c4e19](https://www.github.com/yargs/yargs-parser/commit/34c4e19bae4e7af63e3cb6fa654a97ed476e5eb5))
+* introduce nargs-eats-options config option ([#246](https://www.github.com/yargs/yargs-parser/issues/246)) ([d50822a](https://www.github.com/yargs/yargs-parser/commit/d50822ac10e1b05f2e9643671ca131ac251b6732))
+
+
+### Bug Fixes
+
+* address bugs with "uknown-options-as-args" ([bc023e3](https://www.github.com/yargs/yargs-parser/commit/bc023e3b13e20a118353f9507d1c999bf388a346))
+* array should take precedence over nargs, but enforce nargs ([#243](https://www.github.com/yargs/yargs-parser/issues/243)) ([4cbc188](https://www.github.com/yargs/yargs-parser/commit/4cbc188b7abb2249529a19c090338debdad2fe6c))
+* support keys that collide with object prototypes ([#234](https://www.github.com/yargs/yargs-parser/issues/234)) ([1587b6d](https://www.github.com/yargs/yargs-parser/commit/1587b6d91db853a9109f1be6b209077993fee4de))
+* unknown options terminated with digits now handled by unknown-options-as-args ([#238](https://www.github.com/yargs/yargs-parser/issues/238)) ([d36cdfa](https://www.github.com/yargs/yargs-parser/commit/d36cdfa854254d7c7e0fe1d583818332ac46c2a5))
+
+## [16.1.0](https://www.github.com/yargs/yargs-parser/compare/v16.0.0...v16.1.0) (2019-11-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* populate error if incompatible narg/count or array/count options are used (#191)
+
+### Features
+
+* options that have had their default value used are now tracked ([#211](https://www.github.com/yargs/yargs-parser/issues/211)) ([a525234](https://www.github.com/yargs/yargs-parser/commit/a525234558c847deedd73f8792e0a3b77b26e2c0))
+* populate error if incompatible narg/count or array/count options are used ([#191](https://www.github.com/yargs/yargs-parser/issues/191)) ([84a401f](https://www.github.com/yargs/yargs-parser/commit/84a401f0fa3095e0a19661670d1570d0c3b9d3c9))
+
+
+### Reverts
+
+* revert 16.0.0 CHANGELOG entry ([920320a](https://www.github.com/yargs/yargs-parser/commit/920320ad9861bbfd58eda39221ae211540fc1daf))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entelligentsia/forgecli",
-  "version": "0.6.6",
+  "version": "0.7.6",
   "description": "Forge SDLC ported onto @earendil-works/pi-coding-agent \u2014 production launcher with three bin aliases (forge/forgecli/4ge).",
   "license": "MIT",
   "author": "Entelligentsia",
@@ -27,6 +27,7 @@
     "registry",
     "skills",
     "themes",
+    "workflows",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -66,13 +67,15 @@
     "@entelligentsia/pi-coding-agent",
     "@entelligentsia/pi-agent-core",
     "@entelligentsia/pi-ai",
-    "@entelligentsia/pi-tui"
+    "@entelligentsia/pi-tui",
+    "js-yaml"
   ],
   "dependencies": {
     "@entelligentsia/pi-coding-agent": "file:./vendor-pi/entelligentsia-pi-coding-agent-0.75.0.tgz",
     "@entelligentsia/pi-agent-core": "file:./vendor-pi/entelligentsia-pi-agent-core-0.75.0.tgz",
     "@entelligentsia/pi-ai": "file:./vendor-pi/entelligentsia-pi-ai-0.75.0.tgz",
     "@entelligentsia/pi-tui": "file:./vendor-pi/entelligentsia-pi-tui-0.75.0.tgz",
+    "js-yaml": "^4.1.0",
     "typebox": "^1.1.24"
   },
   "peerDependencies": {
@@ -80,6 +83,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.5",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.3.0",
     "typescript": "^5.7.3",
     "vitest": "^3.2.4"

package/workflows/lead-qualifier/prompts/digest.md

@@ -0,0 +1,44 @@
+# Role
+You are the `digest` node — the final summary after the per-lead pipeline finishes.
+
+# Inputs
+- ICP: `state.entryPrompt`
+- Full state JSON:
+{{state}}
+
+# Your remit
+Produce `artifacts/BRIEF.md` containing:
+
+- **TL;DR** — 2–3 sentences: how many leads, how many warm vs cold, top recommended target.
+- **Warm leads** — table: id, company, industry, score, decision_maker_title, link to
+  `outreach/<id>.md`.
+- **Cold leads** — table: id, company, score, rationale.
+- **Notes** — any patterns observed across the cohort (e.g. "most warm leads are series-b
+  manufacturing").
+
+# Output protocol (MANDATORY)
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Digest written — <W> warm, <C> cold",
+    "writes": {
+      "artifact": {
+        "path": "artifacts/BRIEF.md",
+        "content": "# Lead Qualifier Brief\n\n## TL;DR\n..."
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "cannot-synthesize", "details": "<why>" }
+]
+```

package/workflows/lead-qualifier/prompts/draft-outreach.md

@@ -0,0 +1,44 @@
+# Role
+You are the `draft-outreach` node. You only run for warm leads (score >= 4).
+You draft a personalized outreach email and tag the lead's outcome.
+
+# Inputs
+- ICP: `state.entryPrompt`
+- Lead (with enrichment + score):
+{{loop.item}}
+
+# Your remit
+1. Draft a short (≤180 word) outreach email tailored to the lead's industry, signal, and
+   decision-maker title. Subject line on the first line, then a blank line, then the body.
+2. Write it to `artifacts/outreach/{{loop.item.id}}.md`.
+3. Set `leads.{{loop.item.id}}.outcome` to `{ "status": "warm", "next_step": "send-outreach" }`.
+
+# Output protocol (MANDATORY)
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Drafted outreach for {{loop.item.id}}",
+    "writes": {
+      "artifact": {
+        "path": "artifacts/outreach/{{loop.item.id}}.md",
+        "content": "Subject: ...\n\nHi <name>,\n\n..."
+      },
+      "state": {
+        "leads.{{loop.item.id}}.outcome": { "status": "warm", "next_step": "send-outreach" }
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "cannot-draft", "details": "<why>" }
+]
+```

package/workflows/lead-qualifier/prompts/enrich.md

@@ -0,0 +1,52 @@
+# Role
+You are the `enrich` node — the head of the per-lead pipeline.
+You enrich ONE lead at a time with plausible firmographic detail.
+
+# Inputs
+- Your node exec id: {{node.execId}}
+- Current lead (loop item):
+{{loop.item}}
+
+# Your remit
+Produce an `enriched` object for this lead with:
+
+- `revenue_band`: one of "<$1M", "$1-10M", "$10-100M", "$100M-1B", ">$1B"
+- `tech_stack`: array of 2–5 product/tech names that this kind of company likely uses
+- `decision_maker_title`: the role most likely to own this purchase
+- `region`: short geographic descriptor (e.g. "US-NE", "EU-DACH", "APAC-IN")
+- `funding_stage`: one of "bootstrapped" | "seed" | "series-a" | "series-b" | "growth" | "public"
+
+You may invent details — this is synthetic data. Just be internally consistent with the
+lead's industry and headcount.
+
+# Output protocol (MANDATORY)
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Enriched {{loop.item.id}}",
+    "writes": {
+      "state": {
+        "leads.{{loop.item.id}}.enriched": {
+          "revenue_band": "$10-100M",
+          "tech_stack": ["..."],
+          "decision_maker_title": "...",
+          "region": "...",
+          "funding_stage": "..."
+        }
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "cannot-enrich", "details": "<why>" }
+]
+```

package/workflows/lead-qualifier/prompts/intake.md

@@ -0,0 +1,48 @@
+# Role
+You are the `intake` node of the `lead-qualifier` workflow.
+
+# Inputs
+- Workflow instance: {{wf.instanceId}}
+- Your node exec id: {{node.execId}}
+- Current state JSON:
+{{state}}
+
+# Your remit
+Read `state.entryPrompt` — the user's description of an ideal customer profile (ICP) or a
+target market. Produce 3 to 5 plausible **synthetic** leads that fit. Each lead must have:
+
+- `id`: short kebab-case identifier (e.g. "acme-corp", "globex-ai")
+- `company`: human-readable company name
+- `domain`: a plausible-looking domain
+- `industry`: short label
+- `employees`: integer headcount estimate
+- `signal`: one-line reason this lead might be a fit
+
+# Output protocol (MANDATORY)
+End your reply with a fenced ```json events block. The engine parses ONLY this block.
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Identified <N> leads for <ICP>",
+    "writes": {
+      "state": {
+        "leads": [
+          { "id": "acme-corp",  "company": "Acme Corp",  "domain": "acme.example", "industry": "manufacturing", "employees": 420, "signal": "..." }
+        ]
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "unintelligible-prompt", "details": "..." }
+]
+```

package/workflows/lead-qualifier/prompts/mark-cold.md

@@ -0,0 +1,38 @@
+# Role
+You are the `mark-cold` node. You run for leads with score < 4.
+You record a brief disposition note and tag the outcome as cold.
+
+# Inputs
+- Lead (with score and enrichment):
+{{loop.item}}
+
+# Your remit
+Write a 1-sentence rationale for why this lead is being deprioritized (e.g. "Industry
+mismatch", "Headcount too small", "Tech stack misalignment"). Set
+`leads.{{loop.item.id}}.outcome` to `{ "status": "cold", "rationale": "<one sentence>" }`.
+
+# Output protocol (MANDATORY)
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Marked {{loop.item.id}} cold",
+    "writes": {
+      "state": {
+        "leads.{{loop.item.id}}.outcome": { "status": "cold", "rationale": "..." }
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "cannot-disposition", "details": "<why>" }
+]
+```

package/workflows/lead-qualifier/prompts/score.md

@@ -0,0 +1,45 @@
+# Role
+You are the `score` node of the per-lead pipeline.
+You assign a single integer fit score 1–5 to ONE lead.
+
+# Inputs
+- ICP / target description (from intake): see `state.entryPrompt`
+- Current lead (with enrichment already applied):
+{{loop.item}}
+
+# Your remit
+Score the lead's fit on a 1–5 integer scale:
+- 5 = ideal-fit, prioritize immediately
+- 4 = strong-fit, worth outreach
+- 3 = marginal, might warm up later
+- 2 = poor-fit
+- 1 = exclude
+
+The number MUST be a plain integer at `loop.item.score`. Downstream branching depends on
+this exact path. Do not nest it inside an object.
+
+# Output protocol (MANDATORY)
+
+```json events
+[
+  { "type": "started" },
+  {
+    "type": "success",
+    "summary": "Scored {{loop.item.id}} = <N>",
+    "writes": {
+      "state": {
+        "leads.{{loop.item.id}}.score": 4
+      }
+    }
+  }
+]
+```
+
+On failure:
+
+```json events
+[
+  { "type": "started" },
+  { "type": "failure", "reason": "cannot-score", "details": "<why>" }
+]
+```

package/workflows/lead-qualifier/workflow.yaml

@@ -0,0 +1,95 @@
+id: lead-qualifier
+version: 1
+description: >
+  Per-lead pipeline demo. For each lead in state.leads: enrich → score → branch on score
+  (>=4: draft outreach; else: mark cold) → next lead. Final digest summarizes the cohort.
+  Exercises: (a) `loop.group` per-item pipeline, (b) `when:` conditional edges.
+
+nodes:
+  - id: intake
+    prompt: prompts/intake.md
+    expects:
+      success:
+        writes:
+          state: [leads]
+      failure: {}
+
+  - id: enrich
+    prompt: prompts/enrich.md
+    loop:
+      over:  leads
+      alias: loop.item
+      group: per-lead
+      head:  true
+    expects:
+      success:
+        writes:
+          state: ["leads.{loop.item.id}.enriched"]
+      failure: {}
+
+  - id: score
+    prompt: prompts/score.md
+    loop:
+      over:  leads
+      alias: loop.item
+      group: per-lead
+    expects:
+      success:
+        writes:
+          state: ["leads.{loop.item.id}.score"]
+      failure: {}
+
+  - id: draft-outreach
+    prompt: prompts/draft-outreach.md
+    loop:
+      over:  leads
+      alias: loop.item
+      group: per-lead
+    expects:
+      success:
+        writes:
+          artifact: { pattern: "artifacts/outreach/{loop.item.id}.md" }
+          state:    ["leads.{loop.item.id}.outcome"]
+      failure: {}
+
+  - id: mark-cold
+    prompt: prompts/mark-cold.md
+    loop:
+      over:  leads
+      alias: loop.item
+      group: per-lead
+    expects:
+      success:
+        writes:
+          state: ["leads.{loop.item.id}.outcome"]
+      failure: {}
+
+  - id: digest
+    prompt: prompts/digest.md
+    expects:
+      success:
+        writes:
+          artifact: { pattern: "artifacts/BRIEF.md" }
+      failure: {}
+
+edges:
+  - { from: intake,         on: success,    to: enrich }
+  - { from: intake,         on: failure,    halt: intake-failed }
+
+  - { from: enrich,         on: success,    to: score }
+  - { from: enrich,         on: failure,    advance: loop-or-next }
+  - { from: enrich,         on: exhausted,  to: digest }
+
+  # Conditional: warm leads (score >= 4) get an outreach draft; everyone else is marked cold.
+  - { from: score,          on: success,    when: "loop.item.score >= 4", to: draft-outreach }
+  - { from: score,          on: success,    to: mark-cold }
+  - { from: score,          on: failure,    advance: loop-or-next }
+
+  - { from: draft-outreach, on: success,    advance: loop-or-next }
+  - { from: draft-outreach, on: failure,    advance: loop-or-next }
+
+  - { from: mark-cold,      on: success,    advance: loop-or-next }
+  - { from: mark-cold,      on: failure,    advance: loop-or-next }
+
+  - { from: digest,         on: success,    terminal: complete }
+  - { from: digest,         on: failure,    halt: digest-failed }