npm - heyspex - Versions diffs - 0.2.4 → 0.2.5 - Mend

heyspex 0.2.4 → 0.2.5

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 (5) hide show

package/dist/cli-templates/harness-commands/claude/hs-log.md CHANGED Viewed

@@ -20,7 +20,7 @@ Admin/dev-only — resolves paths via `dev-factory/watch-dev-log.mjs`, then watc
 2. **Watch it.** Start a background `tail -f` over the resolved path(s) and stream it:
    - Default: filtered to signal only — `grep -E --line-buffered -i "error|warn|exception|fatal|crash| 4[0-9][0-9] | 5[0-9][0-9] "` — so routine 200-OK request logs stay silent and only real problems surface.
    - `--raw` in `$ARGUMENTS`: skip the filter, stream everything (useful for a first look, like the very first time this was set up).
-   - Multiple paths (e.g. `companion`'s 4 files) can be tailed together: `tail -n 0 -f path1 path2 ...`.
+   - Multiple paths (e.g. `companion`'s 3 files) can be tailed together: `tail -n 0 -f path1 path2 ...`.
 3. **Report** the resolved path(s) and whether you're running filtered or raw, then stay quiet until something actually worth flagging comes through — don't narrate routine matched lines individually if they're clearly benign.

package/dist/cli-templates/harness-commands/claude/hs-review.md CHANGED Viewed

@@ -1,23 +1,23 @@
----
-description: Pull the next review-ready spec from the HeySpex review queue (review-focus.yaml → manifest traversal of `status: in_review` with HS-REV companion → folder scan).
-argument-hint: "[HS-XXXX-TASK | HS-XXXX-EPIC] [--ignore-focus]"
-allowed-tools: mcp__heyspex__heyspex_next_review
----
-Invoke the `mcp__heyspex__heyspex_next_review` MCP tool to fetch the next review-ready spec from the HeySpex vault, then paste the returned `prompt_markdown` verbatim so the user (reviewer) can walk acceptance against the parent spec + HS-REV companion.
-Argument parsing for `$ARGUMENTS` (all optional; if `$ARGUMENTS` is empty, call the tool with no parameters):
-- A bare token matching `HS-TASK-*` / `HS-EPIC-*` / `HS-*-*` → pass as `spec_id`.
-- A bare token matching `HS-ROADMAP-*` → pass as `roadmap_id`.
-- `--ignore-focus` → set `ignore_focus: true`.
-Resolution precedence (built into the tool, do not re-implement here): `args.spec_id` → `.heyspex/review-focus.yaml` pin → manifest traversal for `status: in_review` specs with an `HS-REV-<suffix>-*.md` companion → folder scan as fallback. Sorted by `updated:` ascending (oldest first).
-After the tool returns, output the `prompt_markdown` field as-is, then on a final line state the source: `_Source: {source_kind} · {spec_id} · phase {phase_id} · age {age_in_review_days}d_`. Do not summarize, paraphrase, or start executing the returned prompt.
-This skill does NOT claim the spec. Reviewing is a human-in-loop activity by design (CLAUDE.md §Session Completion); the reviewer walks the four sections of the HS-REV companion (`## Acceptance verification`, `## Reviewer notes`, `## Memory candidates`, `## Decision: close or reopen`) and decides pass/reopen. Memory candidates are scored against the four-axis rubric (non-derivability / reusability / surprise-cost / concreteness, 0–3 each, threshold ≥ 7/12) — the prompt body includes the rubric and the conflict-check instruction.
-If the tool errors with `NO_REVIEW_READY`, tell the user the review queue is empty (no specs at `status: in_review` with an HS-REV companion) and suggest checking `specs/reviews/` for stale companions or filing the missing review doc. If `SPEC_NOT_IN_REVIEW`, surface the spec's actual status so the user can pick the right `/hs-review HS-XXXX` target. If `NO_REVIEW_DOC`, the parent spec is `in_review` but has no `HS-REV-<suffix>-*.md` companion — point the user at CLAUDE.md §Session Completion §3 for the four-section template.
-Cross-reference: [[HS-XRO1-RVDC-TASK-heyspex-review-on-deck-mcp-and-hs-review]] (spec), [[HS-UKD6-CLR4-RES-close-out-review-screen-jtbd-architecture]] §J17 (downstream Review surface that will call this tool from the "Copy `/hs-review`" affordance).
+---
+description: 'Pull the next review-ready spec from the HeySpex review queue (review-focus.yaml → manifest traversal of `status: in_review` with HS-REV companion → folder scan).'
+argument-hint: "[HS-XXXX-TASK | HS-XXXX-EPIC] [--ignore-focus]"
+allowed-tools: mcp__heyspex__heyspex_next_review
+---
+Invoke the `mcp__heyspex__heyspex_next_review` MCP tool to fetch the next review-ready spec from the HeySpex vault, then paste the returned `prompt_markdown` verbatim so the user (reviewer) can walk acceptance against the parent spec + HS-REV companion.
+Argument parsing for `$ARGUMENTS` (all optional; if `$ARGUMENTS` is empty, call the tool with no parameters):
+- A bare token matching `HS-TASK-*` / `HS-EPIC-*` / `HS-*-*` → pass as `spec_id`.
+- A bare token matching `HS-ROADMAP-*` → pass as `roadmap_id`.
+- `--ignore-focus` → set `ignore_focus: true`.
+Resolution precedence (built into the tool, do not re-implement here): `args.spec_id` → `.heyspex/review-focus.yaml` pin → manifest traversal for `status: in_review` specs with an `HS-REV-<suffix>-*.md` companion → folder scan as fallback. Sorted by `updated:` ascending (oldest first).
+After the tool returns, output the `prompt_markdown` field as-is, then on a final line state the source: `_Source: {source_kind} · {spec_id} · phase {phase_id} · age {age_in_review_days}d_`. Do not summarize, paraphrase, or start executing the returned prompt.
+This skill does NOT claim the spec. Reviewing is a human-in-loop activity by design (CLAUDE.md §Session Completion); the reviewer walks the four sections of the HS-REV companion (`## Acceptance verification`, `## Reviewer notes`, `## Memory candidates`, `## Decision: close or reopen`) and decides pass/reopen. Memory candidates are scored against the four-axis rubric (non-derivability / reusability / surprise-cost / concreteness, 0–3 each, threshold ≥ 7/12) — the prompt body includes the rubric and the conflict-check instruction.
+If the tool errors with `NO_REVIEW_READY`, tell the user the review queue is empty (no specs at `status: in_review` with an HS-REV companion) and suggest checking `specs/reviews/` for stale companions or filing the missing review doc. If `SPEC_NOT_IN_REVIEW`, surface the spec's actual status so the user can pick the right `/hs-review HS-XXXX` target. If `NO_REVIEW_DOC`, the parent spec is `in_review` but has no `HS-REV-<suffix>-*.md` companion — point the user at CLAUDE.md §Session Completion §3 for the four-section template.
+Cross-reference: [[HS-XRO1-RVDC-TASK-heyspex-review-on-deck-mcp-and-hs-review]] (spec), [[HS-UKD6-CLR4-RES-close-out-review-screen-jtbd-architecture]] §J17 (downstream Review surface that will call this tool from the "Copy `/hs-review`" affordance).

package/dist/cli-templates/harness-commands/cursor/hs-log.md CHANGED Viewed

@@ -24,7 +24,7 @@ Admin/dev-only — resolves paths via `dev-factory/watch-dev-log.mjs`, then watc
 2. **Watch it.** Start a background `tail -f` over the resolved path(s) and stream it:
    - Default: filtered to signal only — `grep -E --line-buffered -i "error|warn|exception|fatal|crash| 4[0-9][0-9] | 5[0-9][0-9] "` — so routine 200-OK request logs stay silent and only real problems surface.
    - `--raw` in `$ARGUMENTS`: skip the filter, stream everything (useful for a first look, like the very first time this was set up).
-   - Multiple paths (e.g. `companion`'s 4 files) can be tailed together: `tail -n 0 -f path1 path2 ...`.
+   - Multiple paths (e.g. `companion`'s 3 files) can be tailed together: `tail -n 0 -f path1 path2 ...`.
 3. **Report** the resolved path(s) and whether you're running filtered or raw, then stay quiet until something actually worth flagging comes through — don't narrate routine matched lines individually if they're clearly benign.

package/dist/cli-templates/harness-commands/cursor/hs-review.md CHANGED Viewed

@@ -1,26 +1,26 @@
 ---
 name: hs-review
-description: Pull the next review-ready spec from the HeySpex review queue (review-focus.yaml → manifest traversal of `status: in_review` with HS-REV companion → folder scan).
+description: 'Pull the next review-ready spec from the HeySpex review queue (review-focus.yaml → manifest traversal of `status: in_review` with HS-REV companion → folder scan).'
 ---
 <!-- Generated by scripts/sync-skills.mjs from .claude/commands/hs-review.md — do not edit by hand. Run `npm run skills:sync`. -->
 **Usage:** `/hs-review [HS-XXXX-TASK | HS-XXXX-EPIC] [--ignore-focus]`
-Invoke the `heyspex_next_review` MCP tool to fetch the next review-ready spec from the HeySpex vault, then paste the returned `prompt_markdown` verbatim so the user (reviewer) can walk acceptance against the parent spec + HS-REV companion.
-Argument parsing for `$ARGUMENTS` (all optional; if `$ARGUMENTS` is empty, call the tool with no parameters):
-- A bare token matching `HS-TASK-*` / `HS-EPIC-*` / `HS-*-*` → pass as `spec_id`.
-- A bare token matching `HS-ROADMAP-*` → pass as `roadmap_id`.
-- `--ignore-focus` → set `ignore_focus: true`.
-Resolution precedence (built into the tool, do not re-implement here): `args.spec_id` → `.heyspex/review-focus.yaml` pin → manifest traversal for `status: in_review` specs with an `HS-REV-<suffix>-*.md` companion → folder scan as fallback. Sorted by `updated:` ascending (oldest first).
-After the tool returns, output the `prompt_markdown` field as-is, then on a final line state the source: `_Source: {source_kind} · {spec_id} · phase {phase_id} · age {age_in_review_days}d_`. Do not summarize, paraphrase, or start executing the returned prompt.
-This skill does NOT claim the spec. Reviewing is a human-in-loop activity by design (CLAUDE.md §Session Completion); the reviewer walks the four sections of the HS-REV companion (`## Acceptance verification`, `## Reviewer notes`, `## Memory candidates`, `## Decision: close or reopen`) and decides pass/reopen. Memory candidates are scored against the four-axis rubric (non-derivability / reusability / surprise-cost / concreteness, 0–3 each, threshold ≥ 7/12) — the prompt body includes the rubric and the conflict-check instruction.
-If the tool errors with `NO_REVIEW_READY`, tell the user the review queue is empty (no specs at `status: in_review` with an HS-REV companion) and suggest checking `specs/reviews/` for stale companions or filing the missing review doc. If `SPEC_NOT_IN_REVIEW`, surface the spec's actual status so the user can pick the right `/hs-review HS-XXXX` target. If `NO_REVIEW_DOC`, the parent spec is `in_review` but has no `HS-REV-<suffix>-*.md` companion — point the user at CLAUDE.md §Session Completion §3 for the four-section template.
-Cross-reference: [[HS-XRO1-RVDC-TASK-heyspex-review-on-deck-mcp-and-hs-review]] (spec), [[HS-UKD6-CLR4-RES-close-out-review-screen-jtbd-architecture]] §J17 (downstream Review surface that will call this tool from the "Copy `/hs-review`" affordance).
+Invoke the `heyspex_next_review` MCP tool to fetch the next review-ready spec from the HeySpex vault, then paste the returned `prompt_markdown` verbatim so the user (reviewer) can walk acceptance against the parent spec + HS-REV companion.
+Argument parsing for `$ARGUMENTS` (all optional; if `$ARGUMENTS` is empty, call the tool with no parameters):
+- A bare token matching `HS-TASK-*` / `HS-EPIC-*` / `HS-*-*` → pass as `spec_id`.
+- A bare token matching `HS-ROADMAP-*` → pass as `roadmap_id`.
+- `--ignore-focus` → set `ignore_focus: true`.
+Resolution precedence (built into the tool, do not re-implement here): `args.spec_id` → `.heyspex/review-focus.yaml` pin → manifest traversal for `status: in_review` specs with an `HS-REV-<suffix>-*.md` companion → folder scan as fallback. Sorted by `updated:` ascending (oldest first).
+After the tool returns, output the `prompt_markdown` field as-is, then on a final line state the source: `_Source: {source_kind} · {spec_id} · phase {phase_id} · age {age_in_review_days}d_`. Do not summarize, paraphrase, or start executing the returned prompt.
+This skill does NOT claim the spec. Reviewing is a human-in-loop activity by design (CLAUDE.md §Session Completion); the reviewer walks the four sections of the HS-REV companion (`## Acceptance verification`, `## Reviewer notes`, `## Memory candidates`, `## Decision: close or reopen`) and decides pass/reopen. Memory candidates are scored against the four-axis rubric (non-derivability / reusability / surprise-cost / concreteness, 0–3 each, threshold ≥ 7/12) — the prompt body includes the rubric and the conflict-check instruction.
+If the tool errors with `NO_REVIEW_READY`, tell the user the review queue is empty (no specs at `status: in_review` with an HS-REV companion) and suggest checking `specs/reviews/` for stale companions or filing the missing review doc. If `SPEC_NOT_IN_REVIEW`, surface the spec's actual status so the user can pick the right `/hs-review HS-XXXX` target. If `NO_REVIEW_DOC`, the parent spec is `in_review` but has no `HS-REV-<suffix>-*.md` companion — point the user at CLAUDE.md §Session Completion §3 for the four-section template.
+Cross-reference: [[HS-XRO1-RVDC-TASK-heyspex-review-on-deck-mcp-and-hs-review]] (spec), [[HS-UKD6-CLR4-RES-close-out-review-screen-jtbd-architecture]] §J17 (downstream Review surface that will call this tool from the "Copy `/hs-review`" affordance).

package/package.json CHANGED Viewed

@@ -1,257 +1,257 @@
-{
-  "name": "heyspex",
-  "version": "0.2.4",
-  "description": "HeySpex CLI + MCP server — connect Claude Code, Cursor, and any MCP client to your HeySpex spec vault",
-  "keywords": [
-    "heyspex",
-    "mcp",
-    "model-context-protocol",
-    "claude-code",
-    "cursor",
-    "spec-driven-development",
-    "agents"
-  ],
-  "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pwhermanson/workflow-protocol.git"
-  },
-  "engines": {
-    "node": ">=20.0.0 <25.0.0"
-  },
-  "workspaces": [
-    "spex-console",
-    "pm-control-center",
-    "companion/extension"
-  ],
-  "bin": {
-    "hs": "bin/hs.mjs",
-    "heyspex": "bin/hs.mjs",
-    "heyspex-mcp": "vendor/heyspex-mcp/cli.mjs",
-    "spexcode": "bin/spexcode.mjs"
-  },
-  "exports": {
-    "./package.json": "./package.json",
-    "./console-url-resolver": "./scripts/lib/console-url-resolver.mjs"
-  },
-  "files": [
-    "bin/hs.mjs",
-    "bin/postinstall.mjs",
-    "bin/hs-vault-binding.mjs",
-    "vendor/heyspex-mcp/**/*.mjs",
-    "!vendor/heyspex-mcp/**/*.test.mjs",
-    "vendor/heyspex-mcp/config-seed.yaml",
-    "scripts/check-mcp-freshness.mjs",
-    "scripts/gateway-skills-lib.mjs",
-    "scripts/vault-id-lib.mjs",
-    "scripts/lib/console-url-resolver.mjs",
-    "scripts/lib/window-placement.mjs",
-    "scripts/lib/hs-link.mjs",
-    "scripts/lib/hook-vault-header.mjs",
-    "scripts/lib/dev-mode.mjs",
-    "scripts/lib/directive-obligations.mjs",
-    "scripts/lib/hs-command.mjs",
-    "scripts/lib/shared-path-helpers.mjs",
-    "scripts/claude-statusline/statusline-command.mjs",
-    "scripts/claude-statusline/fonts/HeySpexIcons.ttf",
-    "scripts/dev-server-status.mjs",
-    "scripts/lib/hs-source-*.mjs",
-    "scripts/lib/agent-env-markers.mjs",
-    "!scripts/lib/hs-source-*.test.mjs",
-    "scripts/lib/standalone-doctor.mjs",
-    "dev-factory/lib/fleet-readiness.mjs",
-    "dev-factory/lib/fleet-state.mjs",
-    "dev-factory/lib/code-repo-root.mjs",
-    "dev-factory/lib/sufficiency-score.mjs",
-    "dev-factory/lib/model-catalog.mjs",
-    "dev-factory/model-catalog.json",
-    "docs/mcp-client-config.md",
-    "docs/copilot-plugin-install.md",
-    "docs/driving-heyspex-from-copilot.md",
-    "plugins/heyspex/README.md",
-    "dist/cli/*.mjs",
-    "dist/cli-templates/**",
-    "LICENSE",
-    "scripts/install-claude-code-hooks.mjs",
-    "scripts/install-cursor-hooks.mjs",
-    "scripts/install-copilot-hooks.mjs",
-    "scripts/copilot-statusline.mjs",
-    "scripts/lib/customer-kit.mjs",
-    "scripts/lib/copilot-cli.mjs",
-    "scripts/lib/hook-dispositions.mjs",
-    "scripts/lib/template-pin.mjs",
-    "scripts/cursor-hooks/manifest.mjs",
-    "scripts/dev-server-stop.mjs",
-    "scripts/wip-ledger-health.mjs",
-    "scripts/hs-worktree.mjs",
-    "scripts/lib/hs-worktree-args.mjs",
-    "dev-factory/lib/worktree-allocator.mjs",
-    "dev-factory/engine/worktree.mjs",
-    "scripts/hs-view.mjs",
-    "scripts/hs-capture-cli.mjs",
-    "scripts/lib/heyspex-home.mjs",
-    "scripts/hs-companion.mjs",
-    "scripts/lib/hs-companion-settings.mjs",
-    "scripts/hs-next.mjs",
-    "scripts/hs-mode.mjs",
-    "scripts/heyspex-mode.mjs",
-    "scripts/hs-gateway.mjs",
-    "scripts/hs-settings.mjs",
-    "scripts/hs-classifier.mjs",
-    "scripts/hs-auto.mjs",
-    "scripts/hs-auto-resolve.mjs",
-    "scripts/hs-auto-source.mjs",
-    "dev-factory/lib/spec-io.mjs",
-    "dev-factory/lib/epic-detect.mjs",
-    "plugins/heyspex/bin/launch-mcp.mjs",
-    "plugins/heyspex/bin/run-hook.mjs",
-    "plugins/heyspex/.claude-plugin/plugin.json",
-    ".claude-plugin/marketplace.json",
-    "plugins/heyspex/.mcp.json",
-    "plugins/heyspex/.cursor-plugin/plugin.json",
-    "plugins/heyspex/mcp.json",
-    "plugins/heyspex/assets/*",
-    "plugins/heyspex/hooks/*.json",
-    "scripts/claude-hooks/*.mjs",
-    "!scripts/claude-hooks/*.test.mjs",
-    "!scripts/claude-hooks/*.smoke.mjs",
-    "!scripts/claude-hooks/*.fixtures.mjs",
-    "!scripts/claude-hooks/*.measure.mjs",
-    "scripts/stamp-provenance-on-edit.mjs",
-    "scripts/provenance-lib.mjs",
-    "scripts/lib/subagent-git-lock.mjs",
-    "dev-factory/lib/seat-context.mjs",
-    "dev-factory/lib/context-budget.mjs",
-    "dev-factory/lib/fleet-queue.mjs",
-    "dev-factory/lib/fleet-queue-file.mjs",
-    "spexharness/src/adapters/*.mjs",
-    "spexharness/src/gates/capture-workflow-gate.mjs",
-    "spexharness/src/gates/claim-before-code-gate.decide.mjs",
-    "spexharness/src/gates/claim-before-code-gate.mjs",
-    "spexharness/src/gates/directive-obligation-gate.decide.mjs",
-    "spexharness/src/gates/directive-obligation-gate.mjs",
-    "spexharness/src/gates/deep-research-cost-gate.mjs",
-    "spexharness/src/gates/enforce-session-sequence.mjs",
-    "spexharness/src/gates/enforce-vault-naming.mjs",
-    "spexharness/src/gates/epic-milestone-phrasing-gate.mjs",
-    "spexharness/src/gates/diagnose-capture-reminder.mjs",
-    "spexharness/src/gates/git-identity-guard.decide.mjs",
-    "spexharness/src/gates/git-identity-guard.mjs",
-    "spexharness/src/gates/_shell-write-targets.mjs",
-    "spexharness/src/gates/vault-write-tier-guard.decide.mjs",
-    "spexharness/src/gates/vault-write-tier-guard.mjs",
-    "spexharness/src/gates/vault-mirror-catchup.mjs",
-    "spexharness/src/gates/vault-mirror-catchup.runner.mjs",
-    "spexharness/src/gates/git-reflog-audit.mjs",
-    "spexharness/src/gates/git-stash-gate.decide.mjs",
-    "spexharness/src/gates/git-stash-gate.mjs",
-    "spexharness/src/gates/id-display-format-gate.mjs",
-    "spexharness/src/gates/inject-doctrine-gate.mjs",
-    "spexharness/src/gates/inject-vault-context.mjs",
-    "spexharness/src/gates/naughty-list-gate.mjs",
-    "spexharness/src/gates/plan-review-gate.mjs",
-    "spexharness/src/gates/preflight-reminder-gate.mjs",
-    "spexharness/src/gates/research-protocol-gate.mjs",
-    "spexharness/src/gates/settings-write-gate.decide.mjs",
-    "spexharness/src/gates/settings-write-gate.mjs",
-    "spexharness/src/profile/*.mjs",
-    "spexharness/src/doctrine/*.mjs",
-    "spexharness/doctrine/baseline/SPEXCODE-DOCTRINE.baseline.json",
-    "spexharness/src/chat/tui/ansi.mjs",
-    "spexharness/src/chat/tui/palette.mjs",
-    "spexharness/src/chat/tui/select.mjs",
-    "spexharness/src/config-root.mjs",
-    "spexharness/src/context-budget.mjs",
-    "spexharness/src/dev-server-control.mjs",
-    "spexharness/src/events.mjs",
-    "spexharness/src/git-reflog-audit.mjs",
-    "spexharness/src/intent-classifier.mjs",
-    "spexharness/src/intent-directive.mjs",
-    "spexharness/src/redact.mjs",
-    "spexharness/src/rule-table.mjs",
-    "spexharness/src/seat-context.mjs",
-    "spexharness/src/session-bootstrap.mjs",
-    "spexharness/src/session-record.mjs",
-    "spexharness/src/token-inventory.mjs",
-    "!spexharness/**/*.test.mjs"
-  ],
-  "dependencies": {
-    "js-yaml": ">=3.13.0 <5.0.0"
-  },
-  "devDependencies": {
-    "esbuild": "^0.24.2"
-  },
-  "scripts": {
-    "prepack": "node scripts/build-cli-bundle.mjs && node scripts/prepack-closure-gate.mjs",
-    "build:cli": "node scripts/build-cli-bundle.mjs",
-    "postinstall": "node bin/postinstall.mjs",
-    "setup": "node scripts/heyspex-doctor.mjs --fix",
-    "doctor": "node scripts/heyspex-doctor.mjs",
-    "heyspex:on": "node scripts/hs-mode.mjs on",
-    "heyspex:off": "node scripts/hs-mode.mjs off",
-    "heyspex:status": "node scripts/hs-mode.mjs status",
-    "commandcode:install": "node scripts/install-commandcode.mjs",
-    "commandcode:check": "node scripts/install-commandcode.mjs --check",
-    "commandcode:uninstall": "node scripts/install-commandcode.mjs --uninstall",
-    "seats:sync": "node scripts/sync-seat-context.mjs",
-    "seats:check": "node scripts/sync-seat-context.mjs --check",
-    "skills:sync": "node scripts/sync-skills.mjs",
-    "skills:check": "node scripts/sync-skills.mjs --check",
-    "pm:dashboard": "node bin/cli.mjs dashboard",
-    "pm:control-center": "node bin/cli.mjs control-center",
-    "pm:parallel-check": "node bin/cli.mjs parallel-check",
-    "validate:vault-ids": "node scripts/validate-vault-ids.mjs --require-family",
-    "validate:vault-naming": "node scripts/validate-vault-naming.mjs",
-    "validate:vault-blockers": "node scripts/validate-vault-blockers.mjs",
-    "validate:vault-frontmatter": "node scripts/validate-vault-frontmatter.mjs",
-    "validate:vault-encoding": "node scripts/fix-mojibake.mjs --check",
-    "fix:vault-encoding": "node scripts/fix-mojibake.mjs --apply",
-    "validate:review-backlinks": "node scripts/validate-review-backlinks.mjs",
-    "build:procedure-catalog": "node scripts/build-procedure-catalog.mjs",
-    "validate:procedure-catalog": "node scripts/build-procedure-catalog.mjs --check",
-    "build:guardrails": "node scripts/build-guardrails.mjs",
-    "validate:guardrails": "node scripts/build-guardrails.mjs --check",
-    "compile:agents": "node scripts/compile-agents.mjs",
-    "validate:agents": "node scripts/compile-agents.mjs --check",
-    "build:vault-index": "node scripts/build-vault-index.mjs",
-    "validate:vault-index": "node scripts/build-vault-index.mjs --check",
-    "check:retired-names": "node scripts/check-retired-names.mjs",
-    "check:model-ids": "node scripts/check-model-ids.mjs",
-    "check:shared-helpers": "node scripts/check-shared-helpers.mjs",
-    "check:no-process-exit": "node scripts/check-no-process-exit.mjs",
-    "check:epic-milestone-phrasing": "node scripts/check-epic-milestone-phrasing.mjs",
-    "smoke:cli-help": "node scripts/smoke-cli-help.mjs",
-    "commit": "node scripts/human-commit.mjs",
-    "commit:owner": "node scripts/owner-commit.mjs",
-    "hooks:install": "node scripts/install-git-hooks.mjs",
-    "hooks:install-claude": "node scripts/install-claude-code-hooks.mjs",
-    "hooks:check-claude": "node scripts/install-claude-code-hooks.mjs --check",
-    "hooks:install-cursor": "node scripts/install-cursor-hooks.mjs",
-    "hooks:check-cursor": "node scripts/install-cursor-hooks.mjs --check",
-    "hooks:write-github": "node scripts/lib/customer-kit.mjs --write-github-hooks",
-    "hooks:check-github": "node scripts/lib/customer-kit.mjs --check-github-hooks",
-    "hooks:smoke-cursor": "node scripts/cursor-hooks/_run.smoke.mjs",
-    "companion": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action start",
-    "companion:stop": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action stop",
-    "companion:status": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action status",
-    "spexcompanion": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action start",
-    "spexcompanion:stop": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action stop",
-    "spexcompanion:status": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action status",
-    "console": "npm run dev -w spex-console",
-    "console:log": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/run-console-devlog.ps1",
-    "console:log:lan": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/run-console-devlog.ps1 -Lan",
-    "console:stop": "node scripts/dev-server-stop.mjs",
-    "console:status": "node scripts/dev-server-status.mjs",
-    "//test": "`npm test` is an ALIAS for `test:all` (scripts/run-all-tests.mjs) - the repo-health sweep over all four suites. It is deliberately NOT wired into CI or any git/Claude hook: .github/workflows/ci.yml runs `npm test --workspace spex-console`, which is a different script and is unaffected.",
-    "test": "npm run test:all",
-    "test:all": "node scripts/run-all-tests.mjs",
-    "test:mcp": "node --test vendor/heyspex-mcp/*.test.mjs scripts/lib/*.test.mjs dev-factory/lib/*.test.mjs dev-factory/watch-dev-log.test.mjs",
-    "test:harness": "node --test spexharness/**/*.test.mjs",
-    "verify:package": "node scripts/verify-mcp-package.mjs",
-    "smoke:packed-install": "node scripts/packed-install.smoke.mjs",
-    "verify:onboarding": "node scripts/verify-onboarding-scenario.mjs --fake",
-    "sweep": "node scripts/sweep.mjs"
-  },
-  "//files": "PUBLISHED SURFACE - every entry is verified by `node scripts/verify-mcp-package.mjs`. It must cover the STATIC import closure of vendor/heyspex-mcp/cli.mjs, plus (since [[HS-LGG2-WW9R-TASK-ship-the-hook-runtime-in-the-npm]]) the customer hook kit: scripts/claude-hooks/_run.mjs, every HOOK_SCOPES customer hook (scripts/lib/customer-kit.mjs) and their static closure under spexharness/src, dev-factory/lib and scripts/ - the hookTargets check names any file that falls out - plus the run-time data files in customer-kit.mjs CUSTOMER_HOOK_DATA (only the baseline edition of SpexCode Doctrine, never the learned spexharness/doctrine/SPEXCODE-DOCTRINE.json; [[HS-A2PO-WW9R-TASK-owner-ruling-does-inject-doctrine-ship]]) - and nothing else. SpexFleet internals (dev-factory/router.mjs, cloud-clients.mjs, cost-tracker.mjs, spexcrawl/) are deliberately absent - research-tools.mjs reaches them through the lazy dev-factory-bridge.mjs. Do not add a path here without re-running the verifier; npm publish is a one-way door ([[HS-ZJSP-0JNK-TASK-ship-the-heyspex-mcp-server-as-an]] / [[HS-8DET-0JNK-TASK-confirm-the-open-core-boundary-and]]). `dist/cli/*.mjs` + `dist/cli-templates/**` are a SEPARATE published surface (`hs-init`, `hs-install`, `hs-claim`, `hs-check`, `hs-env`, `hs-connect`, `hs-join`, `hs-vault`, `hs-workspace`, `hs-defer`, `hs-vault-pull`, `hs-vault-push`, `hs-dev`, `hs-index-rebuild`, `hs-index-reconcile` bundled by `scripts/build-cli-bundle.mjs`'s `ENTRIES` array, regenerated fresh every `prepack` - `dist/` itself stays git-ignored) - see that script's doc comment for the entry scope decision and [[HS-JOQX-0JNK-TASK-published-package-runs-hs-init-and-hs]]."
-}
+{
+  "name": "heyspex",
+  "version": "0.2.5",
+  "description": "HeySpex CLI + MCP server — connect Claude Code, Cursor, and any MCP client to your HeySpex spec vault",
+  "keywords": [
+    "heyspex",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "cursor",
+    "spec-driven-development",
+    "agents"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pwhermanson/workflow-protocol.git"
+  },
+  "engines": {
+    "node": ">=20.0.0 <25.0.0"
+  },
+  "workspaces": [
+    "spex-console",
+    "pm-control-center",
+    "companion/extension"
+  ],
+  "bin": {
+    "hs": "bin/hs.mjs",
+    "heyspex": "bin/hs.mjs",
+    "heyspex-mcp": "vendor/heyspex-mcp/cli.mjs",
+    "spexcode": "bin/spexcode.mjs"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./console-url-resolver": "./scripts/lib/console-url-resolver.mjs"
+  },
+  "files": [
+    "bin/hs.mjs",
+    "bin/postinstall.mjs",
+    "bin/hs-vault-binding.mjs",
+    "vendor/heyspex-mcp/**/*.mjs",
+    "!vendor/heyspex-mcp/**/*.test.mjs",
+    "vendor/heyspex-mcp/config-seed.yaml",
+    "scripts/check-mcp-freshness.mjs",
+    "scripts/gateway-skills-lib.mjs",
+    "scripts/vault-id-lib.mjs",
+    "scripts/lib/console-url-resolver.mjs",
+    "scripts/lib/window-placement.mjs",
+    "scripts/lib/hs-link.mjs",
+    "scripts/lib/hook-vault-header.mjs",
+    "scripts/lib/dev-mode.mjs",
+    "scripts/lib/directive-obligations.mjs",
+    "scripts/lib/hs-command.mjs",
+    "scripts/lib/shared-path-helpers.mjs",
+    "scripts/claude-statusline/statusline-command.mjs",
+    "scripts/claude-statusline/fonts/HeySpexIcons.ttf",
+    "scripts/dev-server-status.mjs",
+    "scripts/lib/hs-source-*.mjs",
+    "scripts/lib/agent-env-markers.mjs",
+    "!scripts/lib/hs-source-*.test.mjs",
+    "scripts/lib/standalone-doctor.mjs",
+    "dev-factory/lib/fleet-readiness.mjs",
+    "dev-factory/lib/fleet-state.mjs",
+    "dev-factory/lib/code-repo-root.mjs",
+    "dev-factory/lib/sufficiency-score.mjs",
+    "dev-factory/lib/model-catalog.mjs",
+    "dev-factory/model-catalog.json",
+    "docs/mcp-client-config.md",
+    "docs/copilot-plugin-install.md",
+    "docs/driving-heyspex-from-copilot.md",
+    "plugins/heyspex/README.md",
+    "dist/cli/*.mjs",
+    "dist/cli-templates/**",
+    "LICENSE",
+    "scripts/install-claude-code-hooks.mjs",
+    "scripts/install-cursor-hooks.mjs",
+    "scripts/install-copilot-hooks.mjs",
+    "scripts/copilot-statusline.mjs",
+    "scripts/lib/customer-kit.mjs",
+    "scripts/lib/copilot-cli.mjs",
+    "scripts/lib/hook-dispositions.mjs",
+    "scripts/lib/template-pin.mjs",
+    "scripts/cursor-hooks/manifest.mjs",
+    "scripts/dev-server-stop.mjs",
+    "scripts/wip-ledger-health.mjs",
+    "scripts/hs-worktree.mjs",
+    "scripts/lib/hs-worktree-args.mjs",
+    "dev-factory/lib/worktree-allocator.mjs",
+    "dev-factory/engine/worktree.mjs",
+    "scripts/hs-view.mjs",
+    "scripts/hs-capture-cli.mjs",
+    "scripts/lib/heyspex-home.mjs",
+    "scripts/hs-companion.mjs",
+    "scripts/lib/hs-companion-settings.mjs",
+    "scripts/hs-next.mjs",
+    "scripts/hs-mode.mjs",
+    "scripts/heyspex-mode.mjs",
+    "scripts/hs-gateway.mjs",
+    "scripts/hs-settings.mjs",
+    "scripts/hs-classifier.mjs",
+    "scripts/hs-auto.mjs",
+    "scripts/hs-auto-resolve.mjs",
+    "scripts/hs-auto-source.mjs",
+    "dev-factory/lib/spec-io.mjs",
+    "dev-factory/lib/epic-detect.mjs",
+    "plugins/heyspex/bin/launch-mcp.mjs",
+    "plugins/heyspex/bin/run-hook.mjs",
+    "plugins/heyspex/.claude-plugin/plugin.json",
+    ".claude-plugin/marketplace.json",
+    "plugins/heyspex/.mcp.json",
+    "plugins/heyspex/.cursor-plugin/plugin.json",
+    "plugins/heyspex/mcp.json",
+    "plugins/heyspex/assets/*",
+    "plugins/heyspex/hooks/*.json",
+    "scripts/claude-hooks/*.mjs",
+    "!scripts/claude-hooks/*.test.mjs",
+    "!scripts/claude-hooks/*.smoke.mjs",
+    "!scripts/claude-hooks/*.fixtures.mjs",
+    "!scripts/claude-hooks/*.measure.mjs",
+    "scripts/stamp-provenance-on-edit.mjs",
+    "scripts/provenance-lib.mjs",
+    "scripts/lib/subagent-git-lock.mjs",
+    "dev-factory/lib/seat-context.mjs",
+    "dev-factory/lib/context-budget.mjs",
+    "dev-factory/lib/fleet-queue.mjs",
+    "dev-factory/lib/fleet-queue-file.mjs",
+    "spexharness/src/adapters/*.mjs",
+    "spexharness/src/gates/capture-workflow-gate.mjs",
+    "spexharness/src/gates/claim-before-code-gate.decide.mjs",
+    "spexharness/src/gates/claim-before-code-gate.mjs",
+    "spexharness/src/gates/directive-obligation-gate.decide.mjs",
+    "spexharness/src/gates/directive-obligation-gate.mjs",
+    "spexharness/src/gates/deep-research-cost-gate.mjs",
+    "spexharness/src/gates/enforce-session-sequence.mjs",
+    "spexharness/src/gates/enforce-vault-naming.mjs",
+    "spexharness/src/gates/epic-milestone-phrasing-gate.mjs",
+    "spexharness/src/gates/diagnose-capture-reminder.mjs",
+    "spexharness/src/gates/git-identity-guard.decide.mjs",
+    "spexharness/src/gates/git-identity-guard.mjs",
+    "spexharness/src/gates/_shell-write-targets.mjs",
+    "spexharness/src/gates/vault-write-tier-guard.decide.mjs",
+    "spexharness/src/gates/vault-write-tier-guard.mjs",
+    "spexharness/src/gates/vault-mirror-catchup.mjs",
+    "spexharness/src/gates/vault-mirror-catchup.runner.mjs",
+    "spexharness/src/gates/git-reflog-audit.mjs",
+    "spexharness/src/gates/git-stash-gate.decide.mjs",
+    "spexharness/src/gates/git-stash-gate.mjs",
+    "spexharness/src/gates/id-display-format-gate.mjs",
+    "spexharness/src/gates/inject-doctrine-gate.mjs",
+    "spexharness/src/gates/inject-vault-context.mjs",
+    "spexharness/src/gates/naughty-list-gate.mjs",
+    "spexharness/src/gates/plan-review-gate.mjs",
+    "spexharness/src/gates/preflight-reminder-gate.mjs",
+    "spexharness/src/gates/research-protocol-gate.mjs",
+    "spexharness/src/gates/settings-write-gate.decide.mjs",
+    "spexharness/src/gates/settings-write-gate.mjs",
+    "spexharness/src/profile/*.mjs",
+    "spexharness/src/doctrine/*.mjs",
+    "spexharness/doctrine/baseline/SPEXCODE-DOCTRINE.baseline.json",
+    "spexharness/src/chat/tui/ansi.mjs",
+    "spexharness/src/chat/tui/palette.mjs",
+    "spexharness/src/chat/tui/select.mjs",
+    "spexharness/src/config-root.mjs",
+    "spexharness/src/context-budget.mjs",
+    "spexharness/src/dev-server-control.mjs",
+    "spexharness/src/events.mjs",
+    "spexharness/src/git-reflog-audit.mjs",
+    "spexharness/src/intent-classifier.mjs",
+    "spexharness/src/intent-directive.mjs",
+    "spexharness/src/redact.mjs",
+    "spexharness/src/rule-table.mjs",
+    "spexharness/src/seat-context.mjs",
+    "spexharness/src/session-bootstrap.mjs",
+    "spexharness/src/session-record.mjs",
+    "spexharness/src/token-inventory.mjs",
+    "!spexharness/**/*.test.mjs"
+  ],
+  "dependencies": {
+    "js-yaml": ">=3.13.0 <5.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.2"
+  },
+  "scripts": {
+    "prepack": "node scripts/sync-skills.mjs && node scripts/build-cli-bundle.mjs && node scripts/prepack-closure-gate.mjs",
+    "build:cli": "node scripts/build-cli-bundle.mjs",
+    "postinstall": "node bin/postinstall.mjs",
+    "setup": "node scripts/heyspex-doctor.mjs --fix",
+    "doctor": "node scripts/heyspex-doctor.mjs",
+    "heyspex:on": "node scripts/hs-mode.mjs on",
+    "heyspex:off": "node scripts/hs-mode.mjs off",
+    "heyspex:status": "node scripts/hs-mode.mjs status",
+    "commandcode:install": "node scripts/install-commandcode.mjs",
+    "commandcode:check": "node scripts/install-commandcode.mjs --check",
+    "commandcode:uninstall": "node scripts/install-commandcode.mjs --uninstall",
+    "seats:sync": "node scripts/sync-seat-context.mjs",
+    "seats:check": "node scripts/sync-seat-context.mjs --check",
+    "skills:sync": "node scripts/sync-skills.mjs",
+    "skills:check": "node scripts/sync-skills.mjs --check",
+    "pm:dashboard": "node bin/cli.mjs dashboard",
+    "pm:control-center": "node bin/cli.mjs control-center",
+    "pm:parallel-check": "node bin/cli.mjs parallel-check",
+    "validate:vault-ids": "node scripts/validate-vault-ids.mjs --require-family",
+    "validate:vault-naming": "node scripts/validate-vault-naming.mjs",
+    "validate:vault-blockers": "node scripts/validate-vault-blockers.mjs",
+    "validate:vault-frontmatter": "node scripts/validate-vault-frontmatter.mjs",
+    "validate:vault-encoding": "node scripts/fix-mojibake.mjs --check",
+    "fix:vault-encoding": "node scripts/fix-mojibake.mjs --apply",
+    "validate:review-backlinks": "node scripts/validate-review-backlinks.mjs",
+    "build:procedure-catalog": "node scripts/build-procedure-catalog.mjs",
+    "validate:procedure-catalog": "node scripts/build-procedure-catalog.mjs --check",
+    "build:guardrails": "node scripts/build-guardrails.mjs",
+    "validate:guardrails": "node scripts/build-guardrails.mjs --check",
+    "compile:agents": "node scripts/compile-agents.mjs",
+    "validate:agents": "node scripts/compile-agents.mjs --check",
+    "build:vault-index": "node scripts/build-vault-index.mjs",
+    "validate:vault-index": "node scripts/build-vault-index.mjs --check",
+    "check:retired-names": "node scripts/check-retired-names.mjs",
+    "check:model-ids": "node scripts/check-model-ids.mjs",
+    "check:shared-helpers": "node scripts/check-shared-helpers.mjs",
+    "check:no-process-exit": "node scripts/check-no-process-exit.mjs",
+    "check:epic-milestone-phrasing": "node scripts/check-epic-milestone-phrasing.mjs",
+    "smoke:cli-help": "node scripts/smoke-cli-help.mjs",
+    "commit": "node scripts/human-commit.mjs",
+    "commit:owner": "node scripts/owner-commit.mjs",
+    "hooks:install": "node scripts/install-git-hooks.mjs",
+    "hooks:install-claude": "node scripts/install-claude-code-hooks.mjs",
+    "hooks:check-claude": "node scripts/install-claude-code-hooks.mjs --check",
+    "hooks:install-cursor": "node scripts/install-cursor-hooks.mjs",
+    "hooks:check-cursor": "node scripts/install-cursor-hooks.mjs --check",
+    "hooks:write-github": "node scripts/lib/customer-kit.mjs --write-github-hooks",
+    "hooks:check-github": "node scripts/lib/customer-kit.mjs --check-github-hooks",
+    "hooks:smoke-cursor": "node scripts/cursor-hooks/_run.smoke.mjs",
+    "companion": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action start",
+    "companion:stop": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action stop",
+    "companion:status": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action status",
+    "spexcompanion": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action start",
+    "spexcompanion:stop": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action stop",
+    "spexcompanion:status": "pwsh -NoProfile -ExecutionPolicy Bypass -File companion/start.ps1 -Action status",
+    "console": "npm run dev -w spex-console",
+    "console:log": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/run-console-devlog.ps1",
+    "console:log:lan": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/run-console-devlog.ps1 -Lan",
+    "console:stop": "node scripts/dev-server-stop.mjs",
+    "console:status": "node scripts/dev-server-status.mjs",
+    "//test": "`npm test` is an ALIAS for `test:all` (scripts/run-all-tests.mjs) - the repo-health sweep over all four suites. It is deliberately NOT wired into CI or any git/Claude hook: .github/workflows/ci.yml runs `npm test --workspace spex-console`, which is a different script and is unaffected.",
+    "test": "npm run test:all",
+    "test:all": "node scripts/run-all-tests.mjs",
+    "test:mcp": "node --test vendor/heyspex-mcp/*.test.mjs scripts/lib/*.test.mjs dev-factory/lib/*.test.mjs dev-factory/watch-dev-log.test.mjs",
+    "test:harness": "node --test spexharness/**/*.test.mjs",
+    "verify:package": "node scripts/verify-mcp-package.mjs",
+    "smoke:packed-install": "node scripts/packed-install.smoke.mjs",
+    "verify:onboarding": "node scripts/verify-onboarding-scenario.mjs --fake",
+    "sweep": "node scripts/sweep.mjs"
+  },
+  "//files": "PUBLISHED SURFACE - every entry is verified by `node scripts/verify-mcp-package.mjs`. It must cover the STATIC import closure of vendor/heyspex-mcp/cli.mjs, plus (since [[HS-LGG2-WW9R-TASK-ship-the-hook-runtime-in-the-npm]]) the customer hook kit: scripts/claude-hooks/_run.mjs, every HOOK_SCOPES customer hook (scripts/lib/customer-kit.mjs) and their static closure under spexharness/src, dev-factory/lib and scripts/ - the hookTargets check names any file that falls out - plus the run-time data files in customer-kit.mjs CUSTOMER_HOOK_DATA (only the baseline edition of SpexCode Doctrine, never the learned spexharness/doctrine/SPEXCODE-DOCTRINE.json; [[HS-A2PO-WW9R-TASK-owner-ruling-does-inject-doctrine-ship]]) - and nothing else. SpexFleet internals (dev-factory/router.mjs, cloud-clients.mjs, cost-tracker.mjs, spexcrawl/) are deliberately absent - research-tools.mjs reaches them through the lazy dev-factory-bridge.mjs. Do not add a path here without re-running the verifier; npm publish is a one-way door ([[HS-ZJSP-0JNK-TASK-ship-the-heyspex-mcp-server-as-an]] / [[HS-8DET-0JNK-TASK-confirm-the-open-core-boundary-and]]). `dist/cli/*.mjs` + `dist/cli-templates/**` are a SEPARATE published surface (`hs-init`, `hs-install`, `hs-claim`, `hs-check`, `hs-env`, `hs-connect`, `hs-join`, `hs-vault`, `hs-workspace`, `hs-defer`, `hs-vault-pull`, `hs-vault-push`, `hs-dev`, `hs-index-rebuild`, `hs-index-reconcile` bundled by `scripts/build-cli-bundle.mjs`'s `ENTRIES` array, regenerated fresh every `prepack` - `dist/` itself stays git-ignored) - see that script's doc comment for the entry scope decision and [[HS-JOQX-0JNK-TASK-published-package-runs-hs-init-and-hs]]."
+}