@davidorex/pi-workflows 0.14.6 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,204 @@
 # Changelog
 
+All notable changes to `@davidorex/pi-workflows` are recorded here. Format follows [Keep a Changelog](https://keepachangelog.com/); entries are grounded in commits touching the published surface (`src/`, `schemas/`, `skills/`, `agents/`, `workflows/`). Versions are per-published-npm-release; the last published version is `0.26.0`. Tagged-but-unpublished work (`0.27.0` and later) lives under `[Unreleased]`.
+
+## [Unreleased]
+
+## [0.28.0] - 2026-06-03
+
+### Added
+- Read tools route through the shared `serializeForRead` helper
+
+### Changed
+- Agent-template tree relocated out of `packages/pi-workflows/templates/` into `@davidorex/pi-jit-agents`; the five pi-workflows consumer call-sites resolve templates via the new `bundledTemplateDir()` export, and the `templates/` entry left pi-workflows' `files[]`
+- Auth gating folded into per-package registry-derived gated-sets (`auth-required` surface)
+- Per-item Nunjucks macro readers consume the `array_key`-aware canonical-macro-name registry via the `.macro_name` property
+- Regenerated `SKILL.md` to reflect template relocation, new delegators, and registry changes
+
+### Fixed
+- Converge `/context init` onto a substrate-dir argument and correct the workflow-sdk scaffold-schemas claim in agent-facing source
+- Neutralize `.project/` references in agent-reachable code strings and agent-facing guidance across block-api / lens / roadmap / context / compile / workflow-sdk / template-validation / monitors / index
+
+### Removed
+- Scrubbed substrate-identity citations from the bundled agent, template, and render-by-id tool description string
+
+## [0.26.0] - 2026-05-25
+
+### Added
+- Block-api surface symmetry: three new block-api primitives, three new `BlockSpec` variants, five new registered tools, and a `readBlockDir` extraction
+- `appendToNestedArray` block-api primitive plus the workflow `nestedAppend` `BlockSpec`
+- Composition-primitive surface symmetry: three composition tools, a Nunjucks global, macro wiring, and annotation backfill
+- Per-item Nunjucks macros for spec-reviews, features, framework-gaps, layer-plans, and research blocks; `render_decision` and `render_conventions` macros for the legacy block library
+- `workflow-resume` tool alongside the renamed execute tool
+
+### Changed
+- **BREAKING**: workflow tool renamed `workflow` → `workflow-execute`
+- Migrated `/project` command/skill surface to `/context`, including the generated skill content
+- Migrated pi-mono peer-deps from `@mariozechner/*` to `@earendil-works/*` at `^0.74.0`
+- Retired per-item-macro duplication via shared helpers and a canonical-name registry map; retired seven residual debt items in one coordinated cross-package patch
+
+### Fixed
+- Empty-prefix guard, cross-block status-vocabulary check, and name-based error catches
+- Module hygiene: `fileURLToPath` idiom and name-based error catches
+- Completion atomic gates: test rewrites, `compileAgentSpec` BNF catch, loop/resume fixture cascade
+- Canonicalize `tmpDir` via `fs.realpathSync` in the `step-shared` `resolveSchemaPath` `process.cwd`-fallback test
+
+## [0.14.6] - 2026-04-28
+
+### Changed
+- Bumped pi-mono `0.63.1` → `0.70.2`; migrated TypeBox `v0.34` → `v1.x` via a hybrid import strategy
+
+## [0.14.4] - 2026-04-07
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.14.2.
+
+## [0.14.2] - 2026-04-06
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.14.1.
+
+## [0.14.1] - 2026-04-06
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.13.0.
+
+## [0.13.0] - 2026-04-06
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.12.0.
+
+## [0.12.0] - 2026-04-06
+
+### Added
+- Validation vocabulary surfaced in the skill generator (validator check registry); agent vocabulary extraction added to the skill generator
+- `agentContracts()` and `validationChecks()` SDK functions; `/workflow status` enhanced with agent contracts and a validation-check count
+- `contextBlocks` agent field plus shared block-rendering macros; static `inputSchema` required-key checking, `StepType` metadata validation, `contextBlocks` existence validation, and block-read schema tracing in the workflow validator
+- Integration tests for `inputSchema` rejection and end-to-end workflow execution
+
+### Changed
+- Three-state validation status (clean / warnings / invalid) replaces the binary `valid` flag; the `valid` boolean removed in favor of the `status` field as sole signal
+- Template validation is `contextBlocks`-aware, eliminating false positives; guarded-undefined template variables escalated from warning to error; null-schema warnings carry actionable suggestions
+
+## [0.11.3] - 2026-04-04
+
+### Fixed
+- Guard completion on workflow success, enforce JSON output validation, and correct agent prompt instructions
+
+## [0.11.0] - 2026-04-04
+
+### Added
+- `execute-task` workflow closing the task → verify → persist loop
+- `task-worker` and `task-verifier` agent specs with templates and a verification schema
+- `inputSchema` validation for agent steps, closing cross-block validation gaps
+
+## [0.10.5] - 2026-04-02
+
+### Fixed
+- Added a `shell` expression filter to prevent single-quote injection in command steps
+
+## [0.10.3] - 2026-04-02
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.10.2.
+
+## [0.10.2] - 2026-04-02
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.10.1.
+
+## [0.10.1] - 2026-04-02
+
+### Changed
+- Removed redundant `syncSkillsToUser` skill seeding to eliminate pi skill collisions
+
+## [0.10.0] - 2026-04-02
+
+### Added
+- Completed five remaining issues: tool_call blocking, explicit template syntax, workflow YAML alignment
+- Workflow-validation enhancements: textOutput type detection, array type checking, error accumulation
+
+### Changed
+- **BREAKING**: renamed the `gaps` block to `issues` with a new schema carrying `title`/`body`/`location`/`package` fields
+
+### Fixed
+- Resolved 17 issues across batches 1A/2A/3B/4A (template alignment, monitor safety, executor guards, test coverage) and 7 catalogued gaps across pi-project and pi-workflows
+- Addressed three create-phase workflow gaps: template null guards, null traversal, spec freezing
+
+## [0.9.2] - 2026-03-31
+
+Lockstep release; no `@davidorex/pi-workflows` published-surface changes since 0.9.1.
+
+## [0.9.1] - 2026-03-31
+
+### Fixed
+- DAG: surface invalid step references instead of silently dropping them; restrict bare `steps.` expression fallback to bare-expression contexts
+- State: warn when `buildResult` uses output from a non-last step
+- Workflow-spec: reject nested loop and parallel steps inside loop sub-steps; extracted `parseOutputSpec` helper
+- step-monitor: extract token usage from `complete()` response; log error when `promptTemplate` render fails
+- TUI: dispose previous widget pulse interval before creating a replacement
+- workflow-discovery: log error on directory-scan failure instead of returning silently empty
+- index: signal auto-resume via a `resumed` field in the workflow tool result
+- types: `@deprecated` JSDoc on `StepSpec.workflow`
+
+## [0.9.0] - 2026-03-29
+
+### Added
+- `block` step type: types, executor, dispatch, and expression filters; block-write schema detection in `validateWorkflow`; template-input alignment validation
+- Migrated six workflow command steps to the block step type
+
+### Changed
+- Executed Plan 3 judgment-step restructuring across six workflows; aligned dependencies to the pi-mono pattern
+
+### Fixed
+- Reverted relaxed analysis output schemas (the relaxation was rolled back)
+
+## [0.6.1] - 2026-03-28
+
+### Added
+- Support for array label fields in the workflow source picker for composite display
+
+### Fixed
+- Auto-parse JSON output into `result.output` when an agent/step declares `json` format
+- Migrated parallel-analysis to typed output refs; parse string items in `append-block-item`
+
+## [0.5.0] - 2026-03-28
+
+### Changed
+- Redesigned the workflow TUI with per-step colored bars and live metrics (plus conformance fixes)
+
+## [0.4.1] - 2026-03-27
+
+### Changed
+- Applied biome v2.4.9 auto-fixes; added the CI workflow and husky pre-commit, upgrading biome to v2.4.9
+
+## [0.4.0] - 2026-03-27
+
+### Added
+- Sync extension skills to `~/.pi/agent/skills/` on activation
+
+### Fixed
+- Migrated `getApiKey(model)` to `getApiKeyAndHeaders(model)` for pi 0.63.1
+
+## [0.3.4] - 2026-03-27
+
+### Fixed
+- Addressed five conformance audit findings across the extension packages
+- Replaced package-specifier imports with Node builtins in workflow command steps
+- Regenerated `SKILL.md` after conformance fixes
+
+## [0.3.2] - 2026-03-26
+
+### Fixed
+- Replaced relative source imports with package specifiers in workflow command steps
+
+## [0.3.1] - 2026-03-25
+
+### Added
+- `block:` schema-resolution prefix; `context` field on agent steps for narrative-flow injection
+- Missing artifacts sections to four planning workflows
+
+### Changed
+- Refactored command registration to dispatch tables with dynamic completions and help
+- Rewrote the skill generator for pi-compliant `SKILL.md` output (YAML frontmatter + XML tags)
+
+### Fixed
+- Made block artifact writes fatal
+
 ## [0.3.0] - 2026-03-18
 
 ## [0.2.0] - 2026-03-17

package/README.md

@@ -9,7 +9,7 @@ The schemas in `schemas/` (investigation-findings, decomposition-specs, executio
 ## Install
 
 ```bash
-pi install npm:@davidorex/pi-project    # dependency
+pi install npm:@davidorex/pi-context    # dependency
 pi install npm:@davidorex/pi-workflows
 ```
 
@@ -27,10 +27,13 @@ Creates `.workflows/` for run state. Workflow YAML specs are discovered automati
 
 pi-workflows replaces ad-hoc agent chaining with composable, typed workflow orchestration. Workflows are YAML specs. Steps run as subprocesses (`pi --mode json`) with their own context windows. The main conversation is the control plane; workflows are subordinate.
 
-Workflows consume project blocks as typed input via `readBlock()` — structured data, not raw files. When workflow agents write back to project blocks, pi-project's schema validation enforces the shape at write time. The two extensions form a typed loop: project state → workflow input → agent output → validated project state.
+Workflows consume project blocks as typed input via `readBlock()` — structured data, not raw files. When workflow agents write back to project blocks, pi-context's schema validation enforces the shape at write time. The two extensions form a typed loop: project state → workflow input → agent output → validated project state.
 
-**Tool registered:**
-- `workflow` — run a named workflow with typed input
+**Tools registered:**
+- `workflow-execute` — execute a named workflow with typed input (auto-resumes compatible incomplete runs unless `fresh: "true"`)
+- `workflow-resume` — explicitly resume an incomplete workflow run by name + runId; rejects on no-match or runId mismatch
+- `workflow-list`, `workflow-agents`, `workflow-validate`, `workflow-status`, `workflow-init` — discovery / inspection / scaffolding surfaces
+- `render-item-by-id`, `enforce-budget` — per-item rendering + budget enforcement helpers
 
 **Commands registered:**
 - `/workflow init` — scaffold `.workflows/` directory for run state
@@ -129,9 +132,9 @@ Available filters: `length`, `keys`, `filter`, `json`, `upper`, `lower`, `trim`,
 
 | Directory | Contents |
 |-----------|----------|
-| `agents/` | 13 agent specs (`.agent.yaml`): investigator, decomposer, verifier, synthesizer, etc. |
-| `schemas/` | 11 output schemas (`.schema.json`): investigation-findings, execution-results, etc. |
-| `workflows/` | 10 workflow specs (`.workflow.yaml`): do-gap, create-phase, parallel-analysis, etc. |
+| `agents/` | agent specs (`.agent.yaml`): investigator, decomposer, verifier, synthesizer, … — `ls agents/` or `availableAgents(cwd)` for the current set |
+| `schemas/` | output schemas (`.schema.json`): investigation-findings, execution-results, … — `ls schemas/` for the current set |
+| `workflows/` | workflow specs (`.workflow.yaml`): do-gap, create-phase, parallel-analysis, … — `ls workflows/` or `availableWorkflows(cwd)` for the current set |
 | `templates/` | Nunjucks prompt templates organized by agent role |
 
 ## SDK (`src/workflow-sdk.ts`)
@@ -177,7 +180,7 @@ When working with this extension:
 - **Read `src/dag.ts`** to understand how execution order is inferred from expressions
 - **Read agent `.agent.yaml` files** in `agents/` to understand available agent capabilities
 - **Read workflow `.workflow.yaml` files** in `workflows/` for examples of workflow structure
-- Use the `workflow` tool to execute workflows — it handles discovery, input validation, checkpoint detection, and result formatting
+- Use the `workflow-execute` tool to execute workflows — it handles discovery, input validation, checkpoint detection (auto-resume), and result formatting. Use `workflow-resume` for explicit-only resume by runId (rejects on no-match).
 - The `/workflow list` command provides an interactive picker; `/workflow run <name>` runs directly
 
 ## Tests
@@ -190,6 +193,6 @@ Runs `tsx --test src/*.test.ts`. 500+ tests covering step types, expressions, DA
 
 ## Development
 
-Part of the [`pi-project-workflows`](../../README.md) monorepo. All three packages (pi-project, pi-workflows, pi-behavior-monitors) are versioned in lockstep at 0.9.1.
+Part of the [`pi-project-workflows`](../../README.md) monorepo. All four packages (pi-context, pi-jit-agents, pi-workflows, pi-behavior-monitors) are versioned in lockstep (current version in each `package.json`).
 
 `npm run build` compiles TypeScript to `dist/` via `tsc`. The package ships `dist/`, not `src/` — the `pi.extensions` entry point is `./dist/index.js`.

package/agents/handoff-writer.agent.yaml

@@ -8,7 +8,7 @@ input:
   required: [project_state, path]
   properties:
     project_state:
-      description: Current project state (from projectState() or /project status — includes phases, blocks, gaps, decisions, recent commits)
+      description: Current project state (from contextState() or /context status — includes phases, blocks, gaps, decisions, recent commits)
     path:
       type: string
       description: Root path of the project

package/agents/requirements-gatherer.agent.yaml

@@ -31,7 +31,7 @@ prompt:
     - Output MUST be valid JSON conforming to the requirements.schema.json shape
     - The top-level object has a single "requirements" array
     - Every requirement has: id, description, type, status, priority (all required)
-    - IDs must be unique, formatted as REQ-001, REQ-002, etc.
+    - IDs must be unique, formatted as REQ-NNN (zero-padded three-digit suffix)
     - acceptance_criteria should be specific enough to verify without ambiguity
     - Do NOT produce architecture decisions, module designs, or code
     - "wont" priority requirements are valuable — they document conscious exclusions from the vision's scope_boundaries.out

package/dist/agent-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-spec.d.ts","sourceRoot":"","sources":["../src/agent-spec.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CAOpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACzC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,KAAK,CAAC;gBAEjB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAO7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CA2C1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAgB/F"}
+{"version":3,"file":"agent-spec.d.ts","sourceRoot":"","sources":["../src/agent-spec.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiC5C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CAOpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACzC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,KAAK,CAAC;gBAEjB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAO7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CA2C1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAgB/F"}

package/dist/agent-spec.js

@@ -12,7 +12,10 @@
  *   3. <package>/agents/<name>.agent.yaml (builtin)
  */
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { bundledDir } from "./bundled-dirs.js";
 /**
  * Check if a prompt.system value looks like a template file path vs inline text.
  * Heuristic: treats strings ending in .md as template paths. A literal prompt
@@ -43,8 +46,6 @@ function resolvePromptField(value) {
     }
     return {};
 }
-import os from "node:os";
-import { parse as parseYaml } from "yaml";
 /**
  * Thrown when an agent spec file is not found in any search path.
  */
@@ -122,7 +123,7 @@ export function parseAgentYaml(filePath) {
  * Create an agent loader that finds .agent.yaml specs.
  */
 export function createAgentLoader(cwd, builtinDir) {
-    const defaultBuiltinDir = builtinDir ?? path.resolve(import.meta.dirname, "..", "agents");
+    const defaultBuiltinDir = builtinDir ?? bundledDir("agents");
     return (name) => {
         const searchPaths = [
             path.join(cwd, ".pi", "agents", `${name}.agent.yaml`),

package/dist/agent-spec.js.map

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

package/dist/auth-required.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The pi-workflows-owned set of tool names that require human-authorization at
+ * the pi-agent-dispatch tool_call gate. Co-located with the package whose tools
+ * it gates so membership changes travel with the surface they describe; the
+ * pi-agent-dispatch gate imports this via the `./auth-required` subpath and
+ * folds it into the aggregated AUTH_REQUIRED_TOOLS. The gate remains the
+ * enforcement point — this is the source of pi-workflows' contribution to it.
+ */
+export declare const gatedTools: readonly ["workflow-execute", "workflow-resume", "workflow-init"];
+//# sourceMappingURL=auth-required.d.ts.map

package/dist/auth-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-required.d.ts","sourceRoot":"","sources":["../src/auth-required.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,mEAAoE,CAAC"}

package/dist/auth-required.js

@@ -0,0 +1,10 @@
+/**
+ * The pi-workflows-owned set of tool names that require human-authorization at
+ * the pi-agent-dispatch tool_call gate. Co-located with the package whose tools
+ * it gates so membership changes travel with the surface they describe; the
+ * pi-agent-dispatch gate imports this via the `./auth-required` subpath and
+ * folds it into the aggregated AUTH_REQUIRED_TOOLS. The gate remains the
+ * enforcement point — this is the source of pi-workflows' contribution to it.
+ */
+export const gatedTools = ["workflow-execute", "workflow-resume", "workflow-init"];
+//# sourceMappingURL=auth-required.js.map

package/dist/auth-required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-required.js","sourceRoot":"","sources":["../src/auth-required.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,CAAU,CAAC"}

package/dist/bundled-dirs.d.ts

@@ -0,0 +1,2 @@
+export declare function bundledDir(subdir: "agents" | "workflows" | "schemas"): string;
+//# sourceMappingURL=bundled-dirs.d.ts.map

package/dist/bundled-dirs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-dirs.d.ts","sourceRoot":"","sources":["../src/bundled-dirs.ts"],"names":[],"mappings":"AAwBA,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAE7E"}

package/dist/bundled-dirs.js

@@ -0,0 +1,26 @@
+/**
+ * Resolved paths into this package's bundled defaults directories.
+ *
+ * Pi loads pi-workflows from `dist/`; the bundled `agents/`, `workflows/`, and
+ * `schemas/` directories sit one level above the runtime JS (i.e. at the
+ * package root). Every consumer that previously hand-built
+ * `path.resolve(import.meta.dirname, "..", "<subdir>")` now routes through
+ * `bundledDir(name)` so the relative-path arithmetic exists once. Module-scoped
+ * — never re-export from the package barrel, since the value is meaningful
+ * only when computed against this file's own location.
+ *
+ * The "templates" branch was retired per DEC-0049 uniform-agent axiom: the
+ * agent-prompt template tree relocated to pi-jit-agents. Consumers needing
+ * the bundled template root import `bundledTemplateDir` from
+ * `@davidorex/pi-jit-agents/template` instead of asking this helper.
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+// fileURLToPath idiom (FGAP-088): this is EAGER (module top-level), so an
+// undefined import.meta.dirname under tsx's CJS-interop dist-load would throw at
+// import time; import.meta.url is defined in both load paths.
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+export function bundledDir(subdir) {
+    return path.join(PACKAGE_ROOT, subdir);
+}
+//# sourceMappingURL=bundled-dirs.js.map

package/dist/bundled-dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-dirs.js","sourceRoot":"","sources":["../src/bundled-dirs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,0EAA0E;AAC1E,iFAAiF;AACjF,8DAA8D;AAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAEtF,MAAM,UAAU,UAAU,CAAC,MAA0C;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Extension entry point — registers workflow tools and the `/workflow` command
  * for discovering, executing, and managing multi-step workflow runs.
  */
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 declare const extension: (pi: ExtensionAPI) => void;
 export default extension;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAGX,YAAY,EAGZ,MAAM,+BAA+B,CAAC;AAydvC,QAAA,MAAM,SAAS,GAAI,IAAI,YAAY,SAsalC,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAGX,YAAY,EAGZ,MAAM,iCAAiC,CAAC;AAydzC,QAAA,MAAM,SAAS,GAAI,IAAI,YAAY,SAilBlC,CAAC;AAEF,eAAe,SAAS,CAAC"}