@calmo/task-runner 3.8.3 → 4.0.4

package/.agent/workflows/openspec-apply.md

@@ -0,0 +1,20 @@
+---
+description: Implement an approved OpenSpec change and keep tasks in sync.
+---
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+
+**Steps**
+Track these steps as TODOs and complete them one by one.
+1. Read `changes/<id>/proposal.md`, `design.md` (if present), and `tasks.md` to confirm scope and acceptance criteria.
+2. Work through tasks sequentially, keeping edits minimal and focused on the requested change.
+3. Confirm completion before updating statuses—make sure every item in `tasks.md` is finished.
+4. Update the checklist after all work is done so each task is marked `- [x]` and reflects reality.
+5. Reference `openspec list` or `openspec show <item>` when additional context is required.
+
+**Reference**
+- Use `openspec show <id> --json --deltas-only` if you need additional context from the proposal while implementing.
+<!-- OPENSPEC:END -->

package/.agent/workflows/openspec-archive.md

@@ -0,0 +1,24 @@
+---
+description: Archive a deployed OpenSpec change and update specs.
+---
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+
+**Steps**
+1. Determine the change ID to archive:
+   - If this prompt already includes a specific change ID (for example inside a `<ChangeId>` block populated by slash-command arguments), use that value after trimming whitespace.
+   - If the conversation references a change loosely (for example by title or summary), run `openspec list` to surface likely IDs, share the relevant candidates, and confirm which one the user intends.
+   - Otherwise, review the conversation, run `openspec list`, and ask the user which change to archive; wait for a confirmed change ID before proceeding.
+   - If you still cannot identify a single change ID, stop and tell the user you cannot archive anything yet.
+2. Validate the change ID by running `openspec list` (or `openspec show <id>`) and stop if the change is missing, already archived, or otherwise not ready to archive.
+3. Run `openspec archive <id> --yes` so the CLI moves the change and applies spec updates without prompts (use `--skip-specs` only for tooling-only work).
+4. Review the command output to confirm the target specs were updated and the change landed in `changes/archive/`.
+5. Validate with `openspec validate --strict --no-interactive` and inspect with `openspec show <id>` if anything looks off.
+
+**Reference**
+- Use `openspec list` to confirm change IDs before archiving.
+- Inspect refreshed specs with `openspec list --specs` and address any validation issues before handing off.
+<!-- OPENSPEC:END -->

package/.agent/workflows/openspec-proposal.md

@@ -0,0 +1,25 @@
+---
+description: Scaffold a new OpenSpec change and validate strictly.
+---
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+- Identify any vague or ambiguous details and ask the necessary follow-up questions before editing files.
+- Do not write any code during the proposal stage. Only create design documents (proposal.md, tasks.md, design.md, and spec deltas). Implementation happens in the apply stage after approval.
+
+**Steps**
+1. Review `openspec/project.md`, run `openspec list` and `openspec list --specs`, and inspect related code or docs (e.g., via `rg`/`ls`) to ground the proposal in current behaviour; note any gaps that require clarification.
+2. Choose a unique verb-led `change-id` and scaffold `proposal.md`, `tasks.md`, and `design.md` (when needed) under `openspec/changes/<id>/`.
+3. Map the change into concrete capabilities or requirements, breaking multi-scope efforts into distinct spec deltas with clear relationships and sequencing.
+4. Capture architectural reasoning in `design.md` when the solution spans multiple systems, introduces new patterns, or demands trade-off discussion before committing to specs.
+5. Draft spec deltas in `changes/<id>/specs/<capability>/spec.md` (one folder per capability) using `## ADDED|MODIFIED|REMOVED Requirements` with at least one `#### Scenario:` per requirement and cross-reference related capabilities when relevant.
+6. Draft `tasks.md` as an ordered list of small, verifiable work items that deliver user-visible progress, include validation (tests, tooling), and highlight dependencies or parallelizable work.
+7. Validate with `openspec validate <id> --strict --no-interactive` and resolve every issue before sharing the proposal.
+
+**Reference**
+- Use `openspec show <id> --json --deltas-only` or `openspec show <spec> --type spec` to inspect details when validation fails.
+- Search existing requirements with `rg -n "Requirement:|Scenario:" openspec/specs` before writing new ones.
+- Explore the codebase with `rg <keyword>`, `ls`, or direct file reads so proposals align with current implementation realities.
+<!-- OPENSPEC:END -->

package/.github/workflows/release-please.yml

@@ -0,0 +1,46 @@
+name: release-please
+
+on:
+    push:
+        branches:
+            - main
+
+permissions:
+    contents: write
+    pull-requests: write
+    id-token: write
+
+jobs:
+    release-please:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: googleapis/release-please-action@v4
+              id: release
+              with:
+                  token: ${{ secrets.GITHUB_TOKEN }}
+                  target-branch: main
+
+            - uses: actions/checkout@v4
+              if: ${{ steps.release.outputs.release_created }}
+
+            - name: Setup pnpm
+              uses: pnpm/action-setup@v4
+              with:
+                  version: 10.28.0
+              if: ${{ steps.release.outputs.release_created }}
+
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: "lts/*"
+                  registry-url: "https://registry.npmjs.org"
+                  cache: "pnpm"
+              if: ${{ steps.release.outputs.release_created }}
+
+            - run: pnpm install --frozen-lockfile
+              if: ${{ steps.release.outputs.release_created }}
+
+            - run: pnpm build
+              if: ${{ steps.release.outputs.release_created }}
+
+            - run: pnpm publish --no-git-checks
+              if: ${{ steps.release.outputs.release_created }}

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "4.0.4"
+}

package/AGENTS.md

@@ -1,21 +1,17 @@
 <!-- OPENSPEC:START -->
-
 # OpenSpec Instructions
 
 These instructions are for AI assistants working in this project.
 
 Always open `@/openspec/AGENTS.md` when the request:
-
 - Mentions planning or proposals (words like proposal, spec, change, plan)
 - Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
 - Sounds ambiguous and you need the authoritative spec before coding
 
 Use `@/openspec/AGENTS.md` to learn:
-
 - How to create and apply change proposals
 - Spec format and conventions
 - Project structure and guidelines
-- When creating specs or docs, add a prefix "docs:" to your commit to avoid triggering a new module version
 
 Keep this managed block so 'openspec update' can refresh the instructions.
 
@@ -27,6 +23,8 @@ Keep this managed block so 'openspec update' can refresh the instructions.
 - Avoid using 'any' type at all costs.
 - Always prefer to add more tests instead of simply bypassing coverage validation with comments.
 - Its forbidden to have coverage drop below 100%, thats non negotiable.
+- **Strict Null Safety:** Do not use `??` or optional chaining `?.` when you can guarantee existence via prior validation. Use non-null assertions `!` only when the invariant is locally provable or enforced by a validator.
+- **Dead Code Elimination:** Avoid `v8 ignore` comments. If code is unreachable, restructure the logic to prove it is unreachable to the compiler, or remove the branch if the invariant is guaranteed.
 
 ## Operational Protocols
 

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## <small>3.8.4 (2026-01-21)</small>
+
+* fix: 🛰️ Sonar Specialist: Fix dead code in `TaskGraphValidator` (#93) ([b760765](https://github.com/thalesraymond/task-runner/commit/b760765)), closes [#93](https://github.com/thalesraymond/task-runner/issues/93)
+* docs: add Continue On Error feature proposal (#94) ([2a658fb](https://github.com/thalesraymond/task-runner/commit/2a658fb)), closes [#94](https://github.com/thalesraymond/task-runner/issues/94)
+
 ## <small>3.8.3 (2026-01-21)</small>
 
 * fix: 🐛 trigger ci ([27f6121](https://github.com/thalesraymond/task-runner/commit/27f6121))
@@ -13,6 +18,110 @@
 * refactor: Refactor TaskRunner to reduce cognitive complexity (#89) ([95c67d9](https://github.com/thalesraymond/task-runner/commit/95c67d9)), closes [#89](https://github.com/thalesraymond/task-runner/issues/89)
 * Refactor TaskGraphValidator to address SonarCloud issues (#88) ([77c1538](https://github.com/thalesraymond/task-runner/commit/77c1538)), closes [#88](https://github.com/thalesraymond/task-runner/issues/88)
 
+## [4.0.4](https://github.com/thalesraymond/task-runner/compare/task-runner-v4.0.3...task-runner-v4.0.4) (2026-01-22)
+
+
+### Bug Fixes
+
+* 🐛 id-token: writ ([39fbc2b](https://github.com/thalesraymond/task-runner/commit/39fbc2bc83d448cd2385a2c71089832f61f4b3e3))
+
+## [4.0.3](https://github.com/thalesraymond/task-runner/compare/task-runner-v4.0.2...task-runner-v4.0.3) (2026-01-22)
+
+
+### Bug Fixes
+
+* 🐛 remove npm token (depoys is based on trust setting) ([872d42a](https://github.com/thalesraymond/task-runner/commit/872d42ad35524757f0974e5b46b54b9abf10d7c8))
+
+## [4.0.2](https://github.com/thalesraymond/task-runner/compare/task-runner-v4.0.1...task-runner-v4.0.2) (2026-01-22)
+
+
+### Bug Fixes
+
+* 🐛 using new action (remove deprecated warning) ([6238bbd](https://github.com/thalesraymond/task-runner/commit/6238bbdfd7689468e4eb650c427848fae8f2d674))
+
+## [4.0.1](https://github.com/thalesraymond/task-runner/compare/task-runner-v4.0.0...task-runner-v4.0.1) (2026-01-22)
+
+
+### Bug Fixes
+
+* 🐛 test ci ([0137225](https://github.com/thalesraymond/task-runner/commit/013722547a31d5429f3024ba21eeefba0fbfc426))
+
+## [4.0.0](https://github.com/thalesraymond/task-runner/compare/task-runner-v3.8.4...task-runner-v4.0.0) (2026-01-22)
+
+
+### ⚠ BREAKING CHANGES
+
+* 🧨 Major refactor in the engine, added strategy pattern support
+* **security:** none
+* **security:** none
+* **security:** none
+
+### Features
+
+* 🎸 Generating 3.0.0 since automation wrongly skiped ([c545f25](https://github.com/thalesraymond/task-runner/commit/c545f25be8c689d4a0b518f71635d5b6303b2c64))
+* 🎸 new conditional execution feature ([e936ad7](https://github.com/thalesraymond/task-runner/commit/e936ad71acf5fa3c744b4fa7984f6c7665f75e32))
+* add CI workflow and restore dependabot ([57ae940](https://github.com/thalesraymond/task-runner/commit/57ae940d3dde2adf2de362a48b635def7de2fa7a))
+* add CI workflow and restore dependabot ([48ec98b](https://github.com/thalesraymond/task-runner/commit/48ec98b075feb4bb7e8d339105afdbcb0b5f0fa3))
+* add CI workflow and restore dependabot ([9263c43](https://github.com/thalesraymond/task-runner/commit/9263c43466ee43dd5e07a4edbd9f2ca0b49015e6))
+* add CI workflow for build, lint, and test ([6f97dc0](https://github.com/thalesraymond/task-runner/commit/6f97dc0ee6d1f09de5ddedc64aca73d257e4bc65))
+* add CI workflow for build, lint, and test ([a03422e](https://github.com/thalesraymond/task-runner/commit/a03422ea9ab18cb9f38d8fde58a64c4ce982ff7f))
+* add concurrency control to TaskRunner ([90c2b6f](https://github.com/thalesraymond/task-runner/commit/90c2b6fc7466d9b63820c190e73cc4e96f557335))
+* add concurrency control to TaskRunner ([2a8dfd2](https://github.com/thalesraymond/task-runner/commit/2a8dfd2e825f4802030723c26cf83a51037b99c7))
+* add issue templates ([6ff97f1](https://github.com/thalesraymond/task-runner/commit/6ff97f1140f4de2f3c4a02bd98579474af0893fe))
+* add task priority for concurrency scheduling ([#87](https://github.com/thalesraymond/task-runner/issues/87)) ([43bb6b4](https://github.com/thalesraymond/task-runner/commit/43bb6b4e381dd822358f0e573bfd414a5356d8a5))
+* add task retry policy ([81d4bd3](https://github.com/thalesraymond/task-runner/commit/81d4bd3567a7c4542ba35e311a1a19dd7da7b904))
+* add workflow preview and dry-run capabilities ([e1ccda9](https://github.com/thalesraymond/task-runner/commit/e1ccda9f23e13befd4221cd95b7acfd5500d0e66))
+* add workflow preview and dry-run capabilities ([138f4ae](https://github.com/thalesraymond/task-runner/commit/138f4ae2761d992f111cc108612f4d81b06f6a41))
+* add workflow state persistence proposal ([b62769e](https://github.com/thalesraymond/task-runner/commit/b62769ed128f3c77efb88532c2d2a5d971f0f751))
+* configure semantic-release for automated releases ([fa13bf5](https://github.com/thalesraymond/task-runner/commit/fa13bf5a42f9eb4a4c65aebca28c1b11ff36b618))
+* Implement generic task runner with dependency management and parallel execution ([e0c8bf9](https://github.com/thalesraymond/task-runner/commit/e0c8bf9d3fe8bd7aa14ebb442752e02600c7332e))
+* implement Observer Pattern event system in TaskRunner ([d682983](https://github.com/thalesraymond/task-runner/commit/d682983ebb2aa72eefb05ec06382b206f35473cc))
+* implement Observer Pattern event system in TaskRunner ([48bd3d0](https://github.com/thalesraymond/task-runner/commit/48bd3d0c83bf76dacceee4bb105beb0365816f1c))
+* **implement:** complete file structure refactor ([7764e43](https://github.com/thalesraymond/task-runner/commit/7764e4336effdb8098d4c29c7df5ab10df3d0997))
+* **implement:** complete file structure refactor and cleanup ([372ca8b](https://github.com/thalesraymond/task-runner/commit/372ca8b3703f5e4b3aa14754165ab0fff9451c05))
+* initialize project with TypeScript, Vitest, and basic sum function ([02dd759](https://github.com/thalesraymond/task-runner/commit/02dd75989bfc7a4e9d1f1360fe334284dafd021a))
+* **plan:** create technical plan for file refactor ([29d2a97](https://github.com/thalesraymond/task-runner/commit/29d2a97e0b8b1d98caa27467bf4e865c987e5371))
+* pre-validation of task graph for cycles and missing deps ([4680c1b](https://github.com/thalesraymond/task-runner/commit/4680c1b076abcbd5349129b2ac5db19b4585eec7)), closes [#004](https://github.com/thalesraymond/task-runner/issues/004)
+* **specs:** add spec for file structure refactor ([884c551](https://github.com/thalesraymond/task-runner/commit/884c5512cf9267b4c10a42053019a72abf624650))
+* **tasks:** create tasks for file structure refactor ([3b99e22](https://github.com/thalesraymond/task-runner/commit/3b99e2269220d740ca552733c4bcb41b74bc8108))
+* throw TaskGraphValidationError on validation failure ([35a4e91](https://github.com/thalesraymond/task-runner/commit/35a4e91e66beb7d0660b4059740f4067ab4f2af2))
+
+
+### Bug Fixes
+
+* 🐛 fix sanitization of mermaid function ([b09db63](https://github.com/thalesraymond/task-runner/commit/b09db63b2fdad55c5cfb197ce6009cb81a8604f5))
+* 🐛 fixing commit script and adding a fix to test auto relea ([97cedf4](https://github.com/thalesraymond/task-runner/commit/97cedf4acda6c84db02be4549bf0eb7cbc3a4c16))
+* 🐛 trigger ci ([27f6121](https://github.com/thalesraymond/task-runner/commit/27f61216f6aad326409ac4ded114e79c8b9fbd61))
+* 🛡️ Sentinel: Fix Mermaid graph identifier sanitization ([#81](https://github.com/thalesraymond/task-runner/issues/81)) ([a8bebe3](https://github.com/thalesraymond/task-runner/commit/a8bebe3577e2b3f96aaa759bc6eff91b173b5785))
+* 🛰️ Sonar Specialist: Fix dead code in `TaskGraphValidator` ([#93](https://github.com/thalesraymond/task-runner/issues/93)) ([b760765](https://github.com/thalesraymond/task-runner/commit/b76076593cb80f414868872248fad4a8e503f8bd))
+* add file extensions and types to test file to fix CI errors ([54b186f](https://github.com/thalesraymond/task-runner/commit/54b186f7e1bce6e79e2e8ef3b7a501d1be28b467))
+* address PR comments on sonar config ([6eab0b5](https://github.com/thalesraymond/task-runner/commit/6eab0b52fa420bcb26f64737f2915fe20867603d))
+* address PR comments on sonar config ([156eea0](https://github.com/thalesraymond/task-runner/commit/156eea041a1713de20cea3f0e4bac132e4f81649))
+* address pr feedback ([4a23576](https://github.com/thalesraymond/task-runner/commit/4a2357650012fe9e48baa98222576346a2ce1f79))
+* address pr feedback ([97cf83f](https://github.com/thalesraymond/task-runner/commit/97cf83ffa22dba3972a275f99b7eb4da4c012878))
+* change singleQuote option to false in Prettier configuration ([94625a3](https://github.com/thalesraymond/task-runner/commit/94625a3084ee1d6ae218990bf3e9bb5138002415))
+* correct syntax errors in README.md examples and improve context hydration explanation ([98e3a5a](https://github.com/thalesraymond/task-runner/commit/98e3a5abd25e8856aa0c4458e8b7c8555b01a887))
+* **EventBus:** fix lint errors in test file ([86b3ad8](https://github.com/thalesraymond/task-runner/commit/86b3ad86584372552c757ecaf9e47b8ffdec3cb5))
+* **EventBus:** handle floating promises ([#90](https://github.com/thalesraymond/task-runner/issues/90)) ([9872c37](https://github.com/thalesraymond/task-runner/commit/9872c376b912014a73ef180e426d2de5ca771c76))
+* **EventBus:** handle unhandled promise rejections in event listeners ([5f5235a](https://github.com/thalesraymond/task-runner/commit/5f5235adde48f4ce738fe89cad27ddc1023a4445))
+* Fix missing event emission on task cancellation ([#92](https://github.com/thalesraymond/task-runner/issues/92)) ([3d7e7aa](https://github.com/thalesraymond/task-runner/commit/3d7e7aa191686520f0f6d2e721cf1ec2bf7ac983))
+* remove any type usage in TaskRunner to satisfy linter ([b0a21a7](https://github.com/thalesraymond/task-runner/commit/b0a21a748bdf8fb71e14f7ea3a83937b5a36cb2f))
+* remove unreachable code and verify single execution in concurrency logic ([7255cee](https://github.com/thalesraymond/task-runner/commit/7255cee7c686431a4cac0db5e26f2f12e85ea849))
+* resolve linting errors and verify concurrency control ([9ed2585](https://github.com/thalesraymond/task-runner/commit/9ed2585fb2f712c7210fae84dba70152b9ab7169))
+* revert unauthorized changes to package.json and tsconfig.test.json ([cd44f9e](https://github.com/thalesraymond/task-runner/commit/cd44f9e38451a608a73d201624e675612e7b93af))
+* **security:** replace recursive cycle detection with iterative DFS ([2d2e395](https://github.com/thalesraymond/task-runner/commit/2d2e395aab9306610af03ba4b1305ad448d69d63))
+* **security:** replace recursive cycle detection with iterative DFS ([1e2d7ca](https://github.com/thalesraymond/task-runner/commit/1e2d7ca1704ae288fc54258df698621ecab2eceb))
+* **security:** replace recursive cycle detection with iterative DFS ([292947f](https://github.com/thalesraymond/task-runner/commit/292947f67aa8e64adf62bd23c56f1ce06766c16f))
+* standardize quotes and formatting in dependabot configuration ([ab2d7fa](https://github.com/thalesraymond/task-runner/commit/ab2d7fa2bb14c17b300bca64d0c29711bcc0d5f5))
+
+
+### Performance Improvements
+
+* **executor:** optimize processQueue loop using pending set ([2924700](https://github.com/thalesraymond/task-runner/commit/2924700cfc161af1500190395d5043a9249388f8))
+* Make event listeners async to prevent blocking ([1f8728f](https://github.com/thalesraymond/task-runner/commit/1f8728f4bd9735868c942223548f13ffc9fb98d5))
+* Make event listeners async to prevent blocking ([a52f8d0](https://github.com/thalesraymond/task-runner/commit/a52f8d09827c27b78a07f342a56c392460f89668))
+* optimize task scheduling to prevent pipeline stalls ([37c52f7](https://github.com/thalesraymond/task-runner/commit/37c52f7ce78b1ee1d8483d4b2c33bd73e585850f))
+
 ## 3.8.0 (2026-01-21)
 
 * feat: add task priority for concurrency scheduling (#87) ([43bb6b4](https://github.com/thalesraymond/task-runner/commit/43bb6b4)), closes [#87](https://github.com/thalesraymond/task-runner/issues/87) [#74](https://github.com/thalesraymond/task-runner/issues/74)

package/README.md

@@ -120,7 +120,7 @@ When calling `execute`, you can provide a configuration object:
 - **signal**: Accepts an `AbortSignal` to cancel the workflow programmatically.
 - **dryRun**: Overrides the current strategy with `DryRunExecutionStrategy` for this execution.
 
-```typescript
+```typescript 
 await runner.execute(steps, {
     concurrency: 2,
     dryRun: true

package/dist/TaskGraphValidator.js

@@ -103,8 +103,7 @@ export class TaskGraphValidator {
         stack.push({
             taskId: startTaskId,
             index: 0,
-            /* v8 ignore next */
-            dependencies: adjacencyList.get(startTaskId) ?? [],
+            dependencies: adjacencyList.get(startTaskId),
         });
         while (stack.length > 0) {
             const frame = stack[stack.length - 1];
@@ -124,8 +123,7 @@ export class TaskGraphValidator {
                     stack.push({
                         taskId: dependenceId,
                         index: 0,
-                        /* v8 ignore next */
-                        dependencies: adjacencyList.get(dependenceId) ?? [],
+                        dependencies: adjacencyList.get(dependenceId),
                     });
                 }
             }

package/dist/TaskGraphValidator.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskGraphValidator.js","sourceRoot":"","sources":["../src/TaskGraphValidator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TaskGraphValidator.js","sourceRoot":"","sources":["../src/TaskGraphValidator.ts"],"names":[],"mappings":"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"}

package/openspec/changes/adopt-release-pr/design.md

@@ -0,0 +1,40 @@
+# Design: Release PR Pattern
+
+## Context
+The current system uses `semantic-release` within a GitHub Actions workflow (`release.yml`). This workflow triggers on every push to `main`, executing an immediate release (version bump, changelog, git tag, npm publish, github release). This leads to high frequency "version explosion" in a trunk-based high-velocity environment.
+
+## Solution
+We will adopt the **Release PR Pattern** using **Release Please**.
+
+### Architecture
+- **Tool**: `googleapis/release-please-action`.
+- **Trigger**: Pushes to `main`.
+- **Mechanism**:
+    1.  **Analysis**: The action analyzes commits since the last tagged version.
+    2.  **PR Creation**: It creates (or updates) a special Pull Request containing:
+        -   The proposed next version numbers.
+        -   The generated CHANGELOG entry.
+    3.  **Release**:
+        -   When the Release PR is **merged**, the action runs again.
+        -   It detects the accidental merge of the release commit.
+        -   It creates the GitHub Release and Tags.
+        -   It outputs a `release_created` boolean.
+    4.  **Publish**:
+        -   A downstream step in the same workflow listens for `if: ${{ steps.release.outputs.release_created }}`.
+        -   If true, it executes the build and publish commands (e.g., `pnpm publish`).
+
+### Migration Strategy
+1.  **Cleanup**: Completely remove `semantic-release` configuration and workflow to prevent dual-release mechanisms or conflicts.
+2.  **Configuration**:
+    -   `release-please-config.json`: Defines the release type (`node`), packages (for monorepo support, though this is seemingly a single package config, using the root as the package is standard).
+    -   `.release-please-manifest.json`: Stores the current version (source of truth for Release Please). We will initialize it with the current version from `package.json`.
+3.  **Workflow**:
+    -   Replace `.github/workflows/release.yml` with `.github/workflows/release-please.yml`.
+
+### Key Differences
+| Feature       | Old (Semantic Release) | New (Release Please)                |
+| :------------ | :--------------------- | :---------------------------------- |
+| **Trigger**   | Every push to `main`   | Merge of Release PR                 |
+| **Changelog** | Generated on commit    | Previewed in PR, committed on merge |
+| **Version**   | Bumped on commit       | Bumped in PR, committed on merge    |
+| **Control**   | Automated              | Manual approval via Merge           |

package/openspec/changes/adopt-release-pr/proposal.md

@@ -0,0 +1,47 @@
+# Proposal: Adopt Release PR Pattern
+
+## Goal
+Switch from "continuous deployment on every commit" to the **Release PR Pattern** (Google Style) using [Release Please](https://github.com/google-github-actions/release-please-action).
+This ensures that releases are batched, version explosion is prevented, and human control is restored via PR merges, while maintaining automation.
+
+## User Review Required
+> [!IMPORTANT]
+> This is a breaking change to the release process.
+> - **Current Behavior**: Every commit to `main` triggers a release/publish.
+> - **New Behavior**: Commits to `main` update a "Release PR". A release only happens when you **merge** that PR.
+
+## Proposed Changes
+
+### Configuration
+#### [DELETE] [.releaserc.json](file:///home/thales/projects/task-runner/.releaserc.json)
+- Remove Semantic Release configuration.
+
+#### [NEW] [release-please-config.json](file:///home/thales/projects/task-runner/release-please-config.json)
+- Configuration for Release Please (monorepo-friendly structure, standard conventional commits).
+
+#### [NEW] [.release-please-manifest.json](file:///home/thales/projects/task-runner/.release-please-manifest.json)
+- Tracks versions (required for Release Please).
+
+### Infra / CI
+#### [DELETE] [.github/workflows/release.yml](file:///home/thales/projects/task-runner/.github/workflows/release.yml)
+- Remove successful `semantic-release` workflow.
+
+#### [NEW] [.github/workflows/release-please.yml](file:///home/thales/projects/task-runner/.github/workflows/release-please.yml)
+- New GitHub Action workflow that:
+    1. Runs `release-please` to update the PR.
+    2. If a release is created (PR merged), runs build/publish steps.
+
+## Verification Plan
+
+### Automated Tests
+- **Dry Run**: We cannot easily "test" the GitHub Action without merging, but we can verify the configuration files are valid JSON.
+- **Lint**: Ensure new workflow file syntax is valid (tools like `action-validator` if available, otherwise manual review).
+
+### Manual Verification
+- **Post-Merge**:
+    1. Push a `fix: test` commit to `main`.
+    2. Verify `release-please` bot creates a PR "chore: release 1.0.1".
+    3. Push another `feat: cool` commit.
+    4. Verify PR updates to includes the feature.
+    5. Merge the PR.
+    6. Verify GitHub Release created and NPM publish (if configured).

package/openspec/changes/adopt-release-pr/specs/release-pr/spec.md

@@ -0,0 +1,34 @@
+# Spec: Release PR Pattern
+
+## ADDED Requirements
+
+### Requirement: Release PR Generation
+The system MUST automatically maintain a "Release PR" that targets the `main` branch. This PR must accumulate all conventional changes since the last release, calculating the next semantic version and generating a corresponding changelog entry.
+
+#### Scenario: Feature commit triggers PR update
+Given the latest release is `v1.0.0`
+And a developer merges a commit with message `feat: add awesome feature` to `main`
+Then the system should create or update the Release PR
+And the PR title should be `chore: release 1.1.0`
+And the PR body should contain the changelog entry for "add awesome feature"
+And the `package.json` version in the PR should be `1.1.0`
+
+#### Scenario: Fix commit triggers patch update
+Given the latest release is `v1.0.0`
+And a developer merges a commit `fix: urgent bug` to `main`
+Then the Release PR should be updated to target version `1.0.1`
+
+### Requirement: Release Publication
+The system MUST execute the release process (git tag, GitHub Release, npm publish) ONLY when the Release PR is merged into `main`.
+
+#### Scenario: Merge triggers publish
+Given the Release PR for `v1.1.0` exists
+When a maintainer merges the PR into `main`
+Then the system should create a GitHub Release `v1.1.0`
+And the system should publish the package to the configured registry (NPM)
+And the system should NOT publish any other commits merged to `main` until the next Release PR merge
+
+## REMOVED Requirements
+
+### Requirement: Immediate Release
+The system MUST NOT trigger a release or publish artifacts on every commit to `main`, unless that commit is the merge of a Release PR.

package/openspec/changes/adopt-release-pr/tasks.md

@@ -0,0 +1,14 @@
+- [x] Remove Semantic Release configuration <!-- id: 0 -->
+    - Delete `.releaserc.json`
+    - Remove `release.yml`
+    - Uninstall `semantic-release` and its plugins
+- [x] Initialize Release Please configuration <!-- id: 1 -->
+    - Create `release-please-config.json` (root package type: node)
+    - Create `.release-please-manifest.json` (synced with current package.json version)
+- [x] Create Release Workflow <!-- id: 2 -->
+    - Create `.github/workflows/release-please.yml`
+    - Step 1: `googleapis/release-please-action`
+    - Step 2: `pnpm publish` (conditional on release creation)
+- [x] Verification <!-- id: 3 -->
+    - Validate CI YAML syntax
+    - Verify JSON config validity

package/openspec/changes/archive/2026-01-18-add-concurrency-control/specs/task-runner/spec.md

@@ -0,0 +1,26 @@
+## ADDED Requirements
+
+### Requirement: Concurrency Limit
+
+The `WorkflowExecutor` SHALL limit the number of concurrently executing tasks if a `concurrency` limit is provided.
+
+#### Scenario: Concurrency limit applied
+
+- **GIVEN** a `WorkflowExecutor` configured with `concurrency: N`
+- **WHEN** multiple independent tasks become ready
+- **THEN** no more than N tasks SHALL be in the 'running' state simultaneously.
+
+#### Scenario: Queueing ready tasks
+
+- **WHEN** the number of running tasks equals the `concurrency` limit
+- **THEN** any additional tasks that become ready SHALL remain in the 'ready' state until a slot becomes available.
+
+#### Scenario: Slot release
+
+- **WHEN** a running task completes or fails
+- **THEN** the loop SHALL immediately check for ready tasks and start them up to the limit.
+
+#### Scenario: Default unlimited concurrency
+
+- **WHEN** `WorkflowExecutor` is initialized without a `concurrency` option (or 0/undefined)
+- **THEN** it SHALL execute all ready tasks immediately (unlimited concurrency).

package/openspec/changes/archive/2026-01-18-add-external-task-cancellation/specs/task-runner/spec.md

@@ -0,0 +1,63 @@
+## ADDED Requirements
+
+### Requirement: TaskRunner Execution
+
+The `TaskRunner` SHALL execute a sequence of `TaskStep`s based on their dependencies, processing inputs and producing outputs.
+
+#### Scenario: Successful execution
+
+- **WHEN** all `TaskStep`s complete successfully
+- **THEN** the `TaskRunner` returns a successful workflow result.
+
+#### Scenario: Execution with AbortSignal
+
+- **WHEN** `TaskRunner.execute` is called with an `AbortSignal`
+- **THEN** the `TaskRunner` monitors the `AbortSignal` for cancellation requests.
+
+#### Scenario: Execution with Global Timeout
+
+- **WHEN** `TaskRunner.execute` is called with a `timeout` option
+- **THEN** the `TaskRunner` monitors the elapsed time for the workflow.
+
+### Requirement: External Workflow Cancellation
+
+The `TaskRunner` SHALL allow external cancellation of an ongoing workflow.
+
+#### Scenario: Workflow cancelled by AbortSignal
+
+- **WHEN** an `AbortSignal` provided to `TaskRunner.execute` is triggered
+- **THEN** the `TaskRunner` immediately attempts to stop execution of current and pending tasks.
+
+#### Scenario: Workflow cancelled by Global Timeout
+
+- **WHEN** the specified global `timeout` for `TaskRunner.execute` is reached
+- **THEN** the `TaskRunner` immediately attempts to stop execution of current and pending tasks.
+
+#### Scenario: Tasks marked as cancelled
+
+- **WHEN** a workflow is cancelled (by `AbortSignal` or `timeout`)
+- **THEN** all unexecuted `TaskStep`s SHALL be marked with a 'cancelled' status in the final result.
+
+#### Scenario: Pre-aborted workflow
+
+- **WHEN** `TaskRunner.execute` is called with an `AbortSignal` that is already aborted
+- **THEN** the `TaskRunner` SHALL return immediately with all tasks marked as cancelled, without executing any steps.
+
+#### Scenario: Graceful interruption of current task
+
+- **WHEN** a workflow is cancelled and a `TaskStep` is currently executing
+- **THEN** the `TaskStep` SHALL receive the cancellation signal (e.g., via `AbortSignal` context) to allow for graceful interruption.
+
+### Requirement: Cancellation Conflict Resolution
+
+The `TaskRunner` SHALL handle scenarios where both `AbortSignal` and global `timeout` are provided.
+
+#### Scenario: AbortSignal precedes Timeout
+
+- **WHEN** both `AbortSignal` and `timeout` are provided, and `AbortSignal` is triggered first
+- **THEN** the `TaskRunner` SHALL cancel the workflow based on the `AbortSignal`, ignoring the `timeout`.
+
+#### Scenario: Timeout precedes AbortSignal
+
+- **WHEN** both `AbortSignal` and `timeout` are provided, and `timeout` is reached first
+- **THEN** the `TaskRunner` SHALL cancel the workflow based on the `timeout`, ignoring the `AbortSignal`.

package/openspec/changes/archive/2026-01-18-add-integration-tests/specs/task-runner/spec.md

@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: Integration Verification
+
+The system's integrity SHALL be verified through comprehensive integration scenarios executed against the real runtime environment without mocks.
+
+#### Scenario: Complex Graph Execution
+
+- **WHEN** a complex task graph (diamonds, sequences, parallel branches) is executed
+- **THEN** the system SHALL respect all dependency constraints and execution orders.
+- **AND** the final state MUST reflect the cumulative side effects of all successful tasks.
+
+#### Scenario: Failure Propagation
+
+- **WHEN** a task fails in a complex graph
+- **THEN** ONLY dependent tasks SHALL be skipped
+- **AND** independent branches SHALL continue to execute to completion.
+
+#### Scenario: Context Integrity
+
+- **WHEN** multiple tasks mutate the shared context
+- **THEN** state changes MUST be propagated correctly to downstream tasks.

package/openspec/changes/archive/2026-01-18-add-task-retry-policy/specs/task-runner/spec.md

@@ -0,0 +1,40 @@
+## ADDED Requirements
+
+### Requirement: Task Retry Configuration
+
+The `TaskStep` interface SHALL support an optional `retry` property of type `TaskRetryConfig`.
+
+#### Scenario: Retry Config Structure
+
+- **GIVEN** a `TaskRetryConfig` object
+- **THEN** it SHALL support:
+  - `attempts`: Number of retry attempts (default: 0).
+  - `delay`: Base delay in milliseconds (default: 0).
+  - `backoff`: Backoff strategy ('fixed' | 'exponential') (default: 'fixed').
+
+### Requirement: Retrying Execution Strategy
+
+The system SHALL provide a `RetryingExecutionStrategy` that implements `IExecutionStrategy` and wraps another `IExecutionStrategy`.
+
+#### Scenario: Successful execution
+
+- **WHEN** the inner strategy returns a successful `TaskResult`
+- **THEN** `RetryingExecutionStrategy` SHALL return that result immediately.
+
+#### Scenario: Retry on failure
+
+- **WHEN** the inner strategy throws or returns a failed `TaskResult`
+- **AND** the task has `retry.attempts > 0`
+- **THEN** it SHALL wait for the configured `delay`.
+- **AND** it SHALL re-execute the task using the inner strategy.
+- **AND** it SHALL decrement the remaining attempts.
+
+#### Scenario: Max attempts reached
+
+- **WHEN** the task fails and no attempts remain
+- **THEN** it SHALL return the failed result (or throw).
+
+#### Scenario: Exponential Backoff
+
+- **WHEN** `retry.backoff` is 'exponential'
+- **THEN** the delay SHALL increase for each attempt (e.g., `delay * 2^attempt`).