@planu/cli 4.13.0 → 5.0.0

package/dist/config/release-policy.json

@@ -0,0 +1,108 @@
+{
+  "schemaVersion": 1,
+  "supportedNativeTargets": 8,
+  "gitIdentity": { "name": "planudev", "email": "hello@planu.dev" },
+  "quality": { "branchCoverageMinimum": 88.1, "mutationScoreMinimum": 80 },
+  "native": {
+    "blockingCommands": [
+      "cargo fmt --manifest-path rust/planu-core/Cargo.toml --all -- --check",
+      "cargo clippy --manifest-path rust/planu-core/Cargo.toml --all-targets --all-features -- -D warnings",
+      "cargo test --manifest-path rust/planu-core/Cargo.toml --all-features",
+      "cargo test --manifest-path rust/planu-core/Cargo.toml --test property_invariants",
+      "cargo audit --file rust/planu-core/Cargo.lock",
+      "cargo deny check --config deny.toml"
+    ],
+    "performance": { "samples": 30, "warmups": 5, "p95RatioMaximum": 1.1, "rssP95RatioMaximum": 1.15 }
+  },
+  "releaseOptimization": {
+    "rustNightlyToolchain": "nightly-2026-04-14",
+    "releaseSloSeconds": { "warm": 1500, "cold": 2100, "recovery": 180 },
+    "sourceReceiptInputPatterns": [
+      "(^|/)package\\.json$",
+      "(^|/)(pnpm-lock\\.yaml|Cargo\\.toml|Cargo\\.lock|rust-toolchain(?:\\.toml)?)$",
+      "^scripts/",
+      "^src/config/release-policy\\.json$"
+    ],
+    "sourceQualityPlan": [
+      { "id": "validate", "executable": "pnpm", "args": ["validate"], "timeoutSeconds": 1800 },
+      { "id": "strict", "executable": "pnpm", "args": ["check:strict"], "timeoutSeconds": 1800 },
+      { "id": "reliability", "executable": "pnpm", "args": ["check:reliability"], "timeoutSeconds": 1800 },
+      { "id": "dependency-freshness", "executable": "pnpm", "args": ["check:deps:fresh"], "timeoutSeconds": 1800 },
+      { "id": "coverage", "executable": "pnpm", "args": ["test:coverage"], "timeoutSeconds": 1800 },
+      { "id": "mutation", "executable": "pnpm", "args": ["audit:mutation"], "timeoutSeconds": 1800 },
+      {
+        "id": "rust-format",
+        "executable": "cargo",
+        "args": ["fmt", "--manifest-path", "rust/planu-core/Cargo.toml", "--all", "--", "--check"],
+        "timeoutSeconds": 1800
+      },
+      {
+        "id": "rust-clippy",
+        "executable": "cargo",
+        "args": [
+          "clippy",
+          "--manifest-path",
+          "rust/planu-core/Cargo.toml",
+          "--all-targets",
+          "--all-features",
+          "--",
+          "-D",
+          "warnings"
+        ],
+        "timeoutSeconds": 1800
+      },
+      {
+        "id": "rust-test",
+        "executable": "cargo",
+        "args": ["test", "--manifest-path", "rust/planu-core/Cargo.toml", "--all-features"],
+        "timeoutSeconds": 1800
+      },
+      {
+        "id": "rust-audit",
+        "executable": "cargo",
+        "args": ["audit", "--file", "rust/planu-core/Cargo.lock"],
+        "timeoutSeconds": 1800
+      },
+      {
+        "id": "rust-policy",
+        "executable": "cargo",
+        "args": [
+          "deny",
+          "--manifest-path",
+          "rust/planu-core/Cargo.toml",
+          "check",
+          "--config",
+          "rust/planu-core/deny.toml"
+        ],
+        "timeoutSeconds": 1800
+      },
+      {
+        "id": "rust-fuzz",
+        "executable": "cargo",
+        "args": [
+          "+nightly-2026-04-14",
+          "fuzz",
+          "run",
+          "public-inputs",
+          "--fuzz-dir",
+          "rust/planu-core/fuzz",
+          "--",
+          "-max_total_time=60"
+        ],
+        "timeoutSeconds": 1800
+      }
+    ],
+    "effectiveLinkers": [
+      { "id": "CC", "command": "clang" },
+      { "id": "CXX", "command": "clang++" }
+    ]
+  },
+  "workflowActions": {
+    "actions/checkout": "d23441a48e516b6c34aea4fa41551a30e30af803",
+    "actions/setup-node": "249970729cb0ef3589644e2896645e5dc5ba9c38",
+    "actions/upload-artifact": "b7c566a772e6b6bfb58ed0dc250532a479d7789f",
+    "pnpm/action-setup": "fc06bc1257f339d1d5d8b3a19a8cae5388b55320",
+    "dtolnay/rust-toolchain": "2c7215f132e9ebf062739d9130488b56d53c060c",
+    "Swatinem/rust-cache": "e18b497796c12c097a38f9edb9d0641fb99eee32"
+  }
+}

package/dist/config/runtime-policy.json

@@ -0,0 +1,55 @@
+{
+  "acknowledgementBudgetMs": 200,
+  "toolExecution": {
+    "defaultTimeoutMs": 55000,
+    "minimumTimeoutMs": 1,
+    "maximumTimeoutMs": 600000,
+    "safetyMarginRatio": 0.05,
+    "safetyMarginMaximumMs": 500
+  },
+  "qualityAssurance": {
+    "defaultTimeoutMs": 300000,
+    "minimumTimeoutMs": 1000,
+    "maximumTimeoutMs": 900000,
+    "maximumOutputBufferBytes": 67108864
+  },
+  "lintValidation": {
+    "defaultTimeoutMs": 90000,
+    "minimumTimeoutMs": 1000,
+    "maximumTimeoutMs": 1800000
+  },
+  "createSpec": {
+    "criticalTimeoutMs": 25000,
+    "inlineAnalysisBudgetMs": 40,
+    "idempotencyClaimStaleMs": 60000,
+    "idempotencyClaimWaitMs": 25000,
+    "idempotencyClaimPollMs": 20,
+    "idempotencyMatchWindowMs": 600000
+  },
+  "validation": {
+    "defaultDeadlineMs": 1800000,
+    "durableLintTimeoutMs": 150000,
+    "complianceCommandTimeoutMs": 900000,
+    "noProgressTimeoutMs": 960000,
+    "submissionLockWaitMs": 180,
+    "submissionLockPollMs": 5,
+    "workerLeaseMs": 30000,
+    "workerHeartbeatMs": 1000,
+    "workerConcurrency": 2,
+    "heartbeatStartupTimeoutMs": 5000,
+    "heartbeatShutdownTimeoutMs": 5000,
+    "heartbeatDatabaseBusyTimeoutMs": 250,
+    "freshnessLeaseTtlMs": 2100000,
+    "freshnessInvalidationCoalesceMs": 25,
+    "receiptPublicationDeadlineMs": 20000,
+    "receiptCheckpointLogMaxBytes": 1048576,
+    "receiptCheckpointResultMaxBytes": 4194304
+  },
+  "postCommit": {
+    "defaultTaskTimeoutMs": 10000,
+    "minimumLeaseMs": 30000,
+    "leaseMultiplier": 3,
+    "maximumRememberedTransitions": 1000,
+    "minimumHeartbeatMs": 1000
+  }
+}

package/dist/config/skill-templates/planu-resume-work.md

@@ -26,7 +26,7 @@ Use this skill at the start of a session, or when returning to a project after a
 1. **Check status** — calls `planu_status` to see all active specs
 2. **Find in-progress** — identifies specs with status `implementing` or `review`
 3. **Load context** — reads the spec's `spec.md` and any inline `## Technical`, `## Files`, and `## Progress` sections
-4. **Restore session** — calls `restore_session` or `session_checkpoint` to recover the previous session state
+4. **Read checkpoint** — reads `planu/session-context.md` to recover the saved session context
 5. **Report** — summarizes exactly where to resume: which files were being modified, which criteria are still open
 
 ## What you get
@@ -48,4 +48,4 @@ User: "resume work" (or start a new session)
 
 - Run this skill at the start of every session when you have in-progress specs
 - If multiple specs are in-progress, the skill picks the most recently modified one
-- Use `session_checkpoint` at the end of each session to make resumption smoother
+- Use `session_checkpoint` at the end of each session to save bounded context for the next one

package/dist/config/skill-templates/planu-validate.md

@@ -24,10 +24,12 @@ Use this skill after implementation is complete, before marking a spec as done,
 ## How it works
 
 1. **Find active spec** — calls `planu_status` to identify the current `implementing` spec
-2. **Run validation** — calls `validate({ specId })` which checks each acceptance criterion
-3. **Health check** — calls `spec_health_check({ specId })` for structural quality
-4. **Auto-fix** — calls `auto_fix_validation` for automatically fixable issues
-5. **Report** — presents a structured pass/fail report with next steps for each failure
+2. **Submit validation** — call `validate({ specId })` and capture its durable acknowledgement: `operationId`, `projectId`, `workspaceId`, and `cursor`
+3. **Wait for completion** — call `watch_job` with those identifiers and the latest cursor; repeat while state is non-terminal
+4. **Inspect the result** — require state `completed`, then read `job.result.structuredContent`; stop and report `failed`, `dead-letter`, or `cancelled` jobs
+5. **Health check** — call `spec_health_check({ specId })` for structural quality
+6. **Auto-fix** — call `auto_fix_validation` for automatically fixable issues, then submit and await a new validation job
+7. **Report** — present a structured pass/fail report from the completed job result
 
 ## Output format
 
@@ -53,4 +55,5 @@ Failures:
 
 - Run this skill before every commit on an implementing spec
 - If validation fails, fix the gaps and re-run — don't proceed to `done` with failures
+- Never interpret the initial `validate` acknowledgement as a pass; only `job.result.structuredContent` from a `completed` job is authoritative
 - Use the Planu Validator agent for a deeper analysis with fix suggestions

package/dist/config/subagent-templates/planu-spec-implementer.md

@@ -11,6 +11,8 @@ tools:
   - mcp__planu__list_specs
   - mcp__planu__update_status
   - mcp__planu__validate
+  - mcp__planu__get_job
+  - mcp__planu__watch_job
   - mcp__planu__check_readiness
   - mcp__planu__tdd_scaffold
 ---
@@ -33,9 +35,10 @@ You are an autonomous implementation agent for Spec Driven Development. Your job
 5. **Scaffold TDD tests** — call `tdd_scaffold` to generate test stubs from acceptance criteria.
 6. **Implement** — write all source files in dependency order: types → engine → storage → tools/resources. Follow Clean Architecture (types layer imports nothing; tools import engine+storage+types).
 7. **Run tests** — `pnpm typecheck && pnpm lint && pnpm test:coverage`. Fix all failures.
-8. **Validate** — call `validate({ specId })`. Fix any failing criteria.
-9. **Commit** — `git add <files> && git commit -m "feat(SPEC-NNN): <title>"`.
-10. **Update status to `done`** — call `update_status({ specId, status: "done" })`.
+8. **Submit validation** — call `validate({ specId })` and capture `operationId`, `projectId`, `workspaceId`, and `cursor` from the durable acknowledgement.
+9. **Await and inspect** — call `watch_job` with those identifiers and the latest cursor until terminal. Require `completed`, then inspect `job.result.structuredContent`. Stop on `failed`, `dead-letter`, or `cancelled`; fix failures and submit a new validation job.
+10. **Commit** — only after the completed validation result reports `ready: true`, `status: "passing"`, and passing quality gates, run `git add <files> && git commit -m "feat(SPEC-NNN): <title>"`.
+11. **Update status to `done`** — call `update_status({ specId, status: "done" })` only after that completed passing result.
 
 ## Rules
 
@@ -46,3 +49,4 @@ You are an autonomous implementation agent for Spec Driven Development. Your job
 - All Zod schemas must have `.describe()` on every field
 - Error messages must be actionable: "What failed + Why + What to do next"
 - Coverage must be ≥95% on new files before marking done
+- NEVER treat the initial `validate` acknowledgement as validation success

package/dist/config/subagent-templates/planu-validator.md

@@ -7,6 +7,8 @@ tools:
   - Glob
   - Grep
   - mcp__planu__validate
+  - mcp__planu__get_job
+  - mcp__planu__watch_job
   - mcp__planu__list_specs
   - mcp__planu__spec_health_check
   - mcp__planu__check_readiness
@@ -26,14 +28,16 @@ You are a validation specialist. Your job is to verify that implemented code sat
 ## Workflow
 
 1. **Load spec** — call `list_specs` and read `spec.md` for all acceptance criteria.
-2. **Run validation** — call `validate({ specId })`. Read the full output.
-3. **Run health check** — call `spec_health_check({ specId })` for structural issues.
-4. **Assess gaps** — for each failing criterion:
+2. **Submit validation** — call `validate({ specId })` and capture `operationId`, `projectId`, `workspaceId`, and `cursor` from the durable acknowledgement.
+3. **Wait for the terminal result** — call `watch_job` with those identifiers and the latest cursor. Repeat while state is `accepted`, `running`, or `checkpointed`. Require `completed`; stop and report `failed`, `dead-letter`, or `cancelled`.
+4. **Read the validation result** — inspect `job.result.structuredContent`. The acknowledgement is not a pass/fail result.
+5. **Run health check** — call `spec_health_check({ specId })` for structural issues.
+6. **Assess gaps** — for each failing criterion:
    - Identify which source files are responsible
    - Diagnose the root cause (missing logic, wrong condition, untested branch)
    - Propose a minimal fix
-5. **Auto-fix when safe** — call `auto_fix_validation` for fixable issues.
-6. **Report** — provide a summary with: passing count, failing count, and concrete next steps for each failure.
+7. **Auto-fix when safe** — call `auto_fix_validation` for fixable issues, then submit and await a new validation job.
+8. **Report** — provide a summary with: passing count, failing count, and concrete next steps for each failure.
 
 ## Output format
 
@@ -50,5 +54,6 @@ You are a validation specialist. Your job is to verify that implemented code sat
 ## Rules
 
 - Never mark a spec as done unless ALL criteria pass validation
+- Never mark a spec as done from a validate acknowledgement; require a `completed` job and inspect `job.result.structuredContent`
 - Never accept "mostly works" — every criterion is a contract
 - Flag ambiguous criteria as "needs clarification" rather than inventing semantics

package/dist/config/technology-registry.json

@@ -0,0 +1,120 @@
+{
+  "schemaVersion": 1,
+  "frameworkCatalog": "framework-registry/index.json",
+  "detectionCatalog": "detection-signals.json",
+  "symbols": {
+    "technology-activerecord-97a448": "activerecord",
+    "technology-actix-d99b7a": "actix",
+    "technology-actix-web-ab3e35": "actix-web",
+    "technology-alembic-8249d2": "alembic",
+    "technology-angular-a39f89": "angular",
+    "technology-angular-e79052": "Angular",
+    "technology-aspnet-cc66fa": "aspnet",
+    "technology-astro-23661e": "astro",
+    "technology-astro-c490cc": "Astro",
+    "technology-aws-cdk-0145c3": "aws-cdk",
+    "technology-axum-af7119": "axum",
+    "technology-celery-ddc517": "celery",
+    "technology-celery-17d78b": "Celery",
+    "technology-chrome-9390ef": "chrome",
+    "technology-cloudflare-738e22": "cloudflare",
+    "technology-datadog-4d8bd9": "datadog",
+    "technology-diesel-f83cff": "diesel",
+    "technology-django-7d8a08": "django",
+    "technology-django-4445d9": "Django",
+    "technology-docker-d548c5": "docker",
+    "technology-docker-e6169e": "Docker",
+    "technology-docker-compose-b0a828": "docker-compose",
+    "technology-drizzle-424f22": "drizzle",
+    "technology-echo-092c79": "echo",
+    "technology-electron-88b1de": "electron",
+    "technology-electron-61a62a": "Electron",
+    "technology-eloquent-b89f45": "eloquent",
+    "technology-express-008231": "express",
+    "technology-express-572a14": "Express",
+    "technology-fastapi-6aee0e": "fastapi",
+    "technology-fastapi-2dd9eb": "FastAPI",
+    "technology-fastify-cbe57e": "fastify",
+    "technology-fastify-ed8050": "Fastify",
+    "technology-fiber-77c3e6": "fiber",
+    "technology-figma-5b79d0": "figma",
+    "technology-flask-b87aa5": "flask",
+    "technology-flask-c08622": "Flask",
+    "technology-flutter-be1396": "flutter",
+    "technology-fly-f4debd": "fly",
+    "technology-gin-985adc": "gin",
+    "technology-gorm-7f6614": "gorm",
+    "technology-gorm-9c68e4": "GORM",
+    "technology-graphql-aed31c": "graphql",
+    "technology-jest-35e99f": "jest",
+    "technology-jest-1f30f0": "Jest",
+    "technology-kubernetes-94abcb": "kubernetes",
+    "technology-kubernetes-a37d07": "Kubernetes",
+    "technology-laravel-c34cfa": "laravel",
+    "technology-laravel-ab5d68": "Laravel",
+    "technology-mongoose-4e1812": "mongoose",
+    "technology-nestjs-2d0087": "nestjs",
+    "technology-nestjs-58b822": "NestJS",
+    "technology-netlify-58465a": "netlify",
+    "technology-netlify-55c13c": "Netlify",
+    "technology-next-js-0d857f": "next.js",
+    "technology-next-js-30b7f8": "Next.js",
+    "technology-nextjs-c93379": "nextjs",
+    "technology-nuxt-22c407": "nuxt",
+    "technology-nuxt-e88c87": "Nuxt",
+    "technology-opentelemetry-15646c": "opentelemetry",
+    "technology-playwright-7827e8": "playwright",
+    "technology-playwright-9b7555": "Playwright",
+    "technology-prisma-99497c": "prisma",
+    "technology-prisma-e4b88d": "Prisma",
+    "technology-puppeteer-c83c91": "puppeteer",
+    "technology-pydantic-636623": "pydantic",
+    "technology-pytest-2b0121": "pytest",
+    "technology-rails-2e1d59": "rails",
+    "technology-railway-e34d1c": "railway",
+    "technology-railway-3e12c4": "Railway",
+    "technology-react-275976": "react",
+    "technology-redis-34fb46": "redis",
+    "technology-redis-a7f641": "Redis",
+    "technology-redis-1fa82e": "REDIS",
+    "technology-remix-0c5d96": "remix",
+    "technology-remix-f84ed4": "Remix",
+    "technology-sentry-0cf685": "sentry",
+    "technology-sentry-0acb12": "SENTRY",
+    "technology-sequelize-d18291": "sequelize",
+    "technology-serde-8b917c": "serde",
+    "technology-shadcn-d27663": "shadcn",
+    "technology-shadcn-ui-542509": "shadcn/ui",
+    "technology-spring-boot-9c3c05": "spring boot",
+    "technology-spring-boot-8d9a80": "Spring Boot",
+    "technology-springboot-7e901d": "springboot",
+    "technology-sqlalchemy-37f268": "sqlalchemy",
+    "technology-sqlx-28225b": "sqlx",
+    "technology-stripe-2bed20": "stripe",
+    "technology-stripe-961a60": "Stripe",
+    "technology-stripe-59c349": "STRIPE",
+    "technology-supabase-4d7594": "supabase",
+    "technology-supabase-fe7ceb": "Supabase",
+    "technology-supabase-1dedb8": "SUPABASE",
+    "technology-svelte-c190ac": "svelte",
+    "technology-sveltekit-eefb03": "sveltekit",
+    "technology-sveltekit-b62200": "SvelteKit",
+    "technology-swiftui-b63400": "swiftui",
+    "technology-swiftui-2d05f5": "SwiftUI",
+    "technology-tailwind-44c8cf": "tailwind",
+    "technology-terraform-94dc3e": "terraform",
+    "technology-terraform-05b073": "Terraform",
+    "technology-tokio-434de5": "tokio",
+    "technology-trpc-7a75ed": "trpc",
+    "technology-turbopack-1a3487": "turbopack",
+    "technology-typeorm-527d4d": "typeorm",
+    "technology-typescript-969545": "typescript",
+    "technology-typescript-ed0504": "TypeScript",
+    "technology-vercel-9d3508": "vercel",
+    "technology-vercel-68edc7": "Vercel",
+    "technology-vitest-a9127f": "vitest",
+    "technology-vitest-7fc39e": "Vitest",
+    "technology-vue-564382": "vue",
+    "technology-zod-4f63cf": "zod"
+  }
+}

package/dist/config/version.js

@@ -3,15 +3,14 @@ import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '../../package.json');
-let version = '0.0.0';
-try {
+function loadVersion() {
     const raw = JSON.parse(readFileSync(pkgPath, 'utf8'));
-    if (typeof raw === 'object' && raw !== null && 'version' in raw) {
-        version = String(raw.version);
+    const version = typeof raw === 'object' && raw !== null && 'version' in raw ? raw.version : undefined;
+    if (typeof version !== 'string' ||
+        !/^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/u.test(version)) {
+        throw new Error('[Planu] package.json contains an invalid release version');
     }
+    return version;
 }
-catch {
-    // Fallback to unknown version on parse error
-}
-export const PLANU_VERSION = version;
+export const PLANU_VERSION = loadVersion();
 //# sourceMappingURL=version.js.map

package/dist/core/index.d.ts

@@ -14,7 +14,7 @@ export { generateLeanTechnicalContent } from '../engine/spec-format/lean-technic
 export { checkSpecReadiness } from '../engine/readiness-checker.js';
 export { scoreSpecQuality } from '../engine/spec-quality-scorer.js';
 export { validateSpecFormat } from './spec-validator.js';
-export type { ValidationResult, ValidationError, ValidationWarning, ValidateSpecFormatOptions, ValidationSource, } from '../types/validation.js';
+export type { SpecValidationResult as ValidationResult, ValidationError, ValidationWarning, ValidateSpecFormatOptions, ValidationSource, } from '../types/validation.js';
 export { estimateSpec, inferDifficulty, calculateAccuracy } from '../engine/estimator.js';
 export { calculateEstimation } from '../engine/estimator.js';
 export { analyzeProject, quickAnalyze } from '../engine/analyzer.js';

package/dist/core/spec-validator.d.ts

@@ -1,12 +1,12 @@
 import type { Spec } from '../types/spec/core.js';
-import type { ValidationResult, ValidateSpecFormatOptions } from '../types/validation.js';
-export type { ValidationResult, ValidationError, ValidationWarning, ValidateSpecFormatOptions, ValidationSource, } from '../types/validation.js';
+import type { SpecValidationResult, ValidateSpecFormatOptions } from '../types/validation.js';
+export type { SpecValidationResult as ValidationResult, ValidationError, ValidationWarning, ValidateSpecFormatOptions, ValidationSource, } from '../types/validation.js';
 /**
  * Validate a spec's format against the unified spec.md schema (SPEC-630).
  * Reads spec.specPath from disk, runs structural + semantic checks, returns
- * a single ValidationResult.
+ * a single SpecValidationResult.
  *
  * Pure function: no global side effects, no MCP SDK dependency, no telemetry.
  */
-export declare function validateSpecFormat(spec: Pick<Spec, 'id' | 'specPath' | 'difficulty' | 'tags' | 'dependencies' | 'scope' | 'target' | 'type' | 'title'>, opts?: ValidateSpecFormatOptions): Promise<ValidationResult>;
+export declare function validateSpecFormat(spec: Pick<Spec, 'id' | 'specPath' | 'difficulty' | 'tags' | 'dependencies' | 'scope' | 'target' | 'type' | 'title'>, opts?: ValidateSpecFormatOptions): Promise<SpecValidationResult>;
 //# sourceMappingURL=spec-validator.d.ts.map

package/dist/core/spec-validator.js

@@ -137,7 +137,7 @@ function mapQualityToValidation(dimensions) {
 /**
  * Validate a spec's format against the unified spec.md schema (SPEC-630).
  * Reads spec.specPath from disk, runs structural + semantic checks, returns
- * a single ValidationResult.
+ * a single SpecValidationResult.
  *
  * Pure function: no global side effects, no MCP SDK dependency, no telemetry.
  */

package/dist/engine/abortable-process-runner.d.ts

@@ -1,8 +1,26 @@
+import { spawn } from 'node:child_process';
 import type { AbortableProcessOptions, AbortableProcessResult } from '../types/abortable-process.js';
+export declare const PROCESS_TERMINATION_GRACE_MS = 75;
+export declare const PROCESS_TREE_EXTINCTION_TIMEOUT_MS = 1000;
+export declare const PROCESS_CHILD_CLOSE_TIMEOUT_MS = 1000;
+/** Isolates platform-specific process supervision in unit tests without changing host state. */
+export declare function configureAbortableProcessRunnerForTests(options?: {
+    platform?: NodeJS.Platform;
+    spawnProcess?: typeof spawn;
+    isProcessGroupAlive?: (pid: number) => boolean;
+}): void;
+export declare class ProcessTreeTerminationError extends Error {
+    readonly code = "PROCESS_TREE_TERMINATION_UNVERIFIED";
+    constructor();
+}
+export declare class ChildProcessCloseTimeoutError extends Error {
+    readonly code = "PROCESS_CLOSE_UNOBSERVED";
+    constructor();
+}
 /**
  * Runs a validation command in its own process group. Cancellation and timeouts
- * terminate the complete group and settle only after the child has closed, so a
- * cancelled gate cannot keep writing output or publish late evidence.
+ * terminate the complete group and settle only after child closure or a bounded,
+ * typed close-observation failure, so a cancelled gate cannot publish late evidence.
  */
 export declare function runAbortableProcess(command: string, args: string[], options: AbortableProcessOptions): Promise<AbortableProcessResult>;
 //# sourceMappingURL=abortable-process-runner.d.ts.map