@jterrats/open-orchestra 1.0.7 → 1.0.9

package/AGENTS.md

@@ -156,13 +156,13 @@
 - Mark breaking changes with `!` and a `BREAKING CHANGE:` footer.
 - Keep PRs <400 lines. Review your own diff before requesting review.
 
-<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="codex" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="1699a3b284078cede5d7c960ee773e8a758eb28fc4c3a668400890cb7b1a27db" updated-at="2026-05-17T20:32:42.512Z" -->
+<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="codex" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="7a5f273757296b408cc7681f35f89457055336b539c5e7b5bfbeb07ca3aa352e" updated-at="2026-05-20T15:28:50.449Z" -->
 # Open Orchestra Runtime Bootstrap
 
 Runtime target: Codex. Reference Open Orchestra from AGENTS.md so local CLI work follows workflow gates.
 
 Use Open Orchestra as the local control plane when `.agent-workflow/` exists.
-The active LLM runtime is the parent agent. Do not assume automatic real subagent spawning or real provider execution.
+The active LLM runtime is the parent agent. Orchestra renders spawn requests and records lifecycle; it does not call provider APIs directly.
 
 ## Orchestra Workflow — Required for All Work
 
@@ -222,6 +222,16 @@ orchestra benchmark --task <ID>
 - Run `orchestra validate --pre-run --task <ID> --json` before implementation; resolve missing estimate, workflow run, evidence, or review checks.
 - If a user accepts a smaller/advisory path, record it with `orchestra validate --pre-run --task <ID> --bypass --bypass-rationale "..."`.
 
+## Runtime-Native Background Spawn
+- When a workflow phase returns `completionMode=detached`, keep the parent conversation available and do not block on the child unless the user explicitly asks to wait.
+- After `orchestra workflow run` reports a pending parent runtime action, immediately inspect `orchestra runtime parent-actions --task <ID> --json` and consume safe actions supported by the active runtime.
+- Codex parent runtimes should call `spawn_agent` for `codex-spawn-agent` actions using the `promptArtifact`, then record `spawned` with the returned agent id.
+- Do not auto-consume actions when the user explicitly asked to pause, when the action is queued, or when the runtime/tool is unavailable or unsafe.
+- Use `orchestra runtime spawn-request --task <ID> --role <role> --phase <phase> --run-id <run-id>` to render the assignment packet.
+- Record child state with `orchestra runtime spawn-lifecycle --session <session-id> --status <spawned|active|completed|failed> --agent-id <id>`.
+- Resume the workflow after the child completes with `orchestra workflow run --task <ID> --resume <run-id>`.
+- Codex parent runtimes should use `spawn_agent` for the rendered packet and avoid waiting by default.
+
 ## Task Loop
 - `orchestra health` - Check local tools and workflow readiness.
 - `orchestra task list` - List local workflow tasks. Workflow phase subtasks are hidden by default.

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 ## Unreleased
 
+## 1.0.8 - 2026-05-19
+
+### Added
+
+- Added a release-blocking runtime manual queue E2E:
+  `npm run test:e2e:runtime` now creates a temporary workspace, initializes
+  Open Orchestra, starts two manual runtime sessions, and verifies a third
+  manual `spawn-request` materializes as `queued` with lifecycle commands and
+  session visibility.
+- Added an E2E test battery catalog documenting P0, P1, and P2 validation
+  surfaces for source quality, installed CLI, temporary workspaces, browser
+  console, public site, runtime delegation, recovery, security, provider, Sonar,
+  and package release dry-run coverage.
+
+### Changed
+
+- Runtime-native spawn requests are fully asynchronous by default: parent
+  runtimes receive session ids, prompt artifacts, expected result artifacts,
+  lifecycle commands, and quality warnings without waiting on child completion.
+- Release matrix now includes `runtime-manual-queue-e2e` so queued runtime
+  delegation behavior is part of the documented release validation surface.
+- CLI routing and refresh helpers were split into smaller modules while keeping
+  public command behavior stable.
+
+### Fixed
+
+- Manual `runtime spawn-request` now follows queue guardrails consistently:
+  `limitAction=queue` returns a queued artifact/session instead of failing,
+  while `limitAction=reject` still fails before creating a delegation artifact.
+
+### Validation
+
+- `npm run test:e2e:runtime` passed.
+- `npm run test:e2e` passed.
+- `ORCHESTRA_NODE_SCRIPT=/Users/polux/dev/open-orchestra/bin/orchestra.js npm run test:e2e:init`
+  passed.
+- `npm run precommit` passed.
+- `npm pack --dry-run --json` produced `jterrats-open-orchestra-1.0.8.tgz`.
+- `orchestra release check --json` passed and reported package version `1.0.8`
+  ahead of latest tag `v1.0.7`, ready for CI-owned tag creation.
+
 ## 0.5.1 - 2026-05-11
 
 ### Changed

package/CLAUDE.md

@@ -169,13 +169,13 @@ Do NOT start implementation without a registered task and workflow run. Use `orc
 - Correct mistakes directly without apologizing.
 - **No Ninja Edits.** Summarize proposed changes and get agreement before modifying files.
 
-<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="claude" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="24829d53d8697ae7e56c17f5d853452570c456ee948738a9f5174788f7d99f0d" updated-at="2026-05-17T20:32:42.510Z" -->
+<!-- open-orchestra:start block-id="runtime-bootstrap" generator="open-orchestra runtime bootstrap" version="1" target="claude" source-manifest="open-orchestra command-manifest,runtime-bootstrap" content-sha256="a6b4a8288f93b5aa641780b68a503274d48f53363b3142a24158da1722d0cb42" updated-at="2026-05-20T15:29:05.492Z" -->
 # Open Orchestra Runtime Bootstrap
 
 Runtime target: Claude. Reference compact Open Orchestra blocks from CLAUDE.md and load task skills on demand.
 
 Use Open Orchestra as the local control plane when `.agent-workflow/` exists.
-The active LLM runtime is the parent agent. Do not assume automatic real subagent spawning or real provider execution.
+The active LLM runtime is the parent agent. Orchestra renders spawn requests and records lifecycle; it does not call provider APIs directly.
 
 ## Orchestra Workflow — Required for All Work
 
@@ -235,6 +235,17 @@ orchestra benchmark --task <ID>
 - Run `orchestra validate --pre-run --task <ID> --json` before implementation; resolve missing estimate, workflow run, evidence, or review checks.
 - If a user accepts a smaller/advisory path, record it with `orchestra validate --pre-run --task <ID> --bypass --bypass-rationale "..."`.
 
+## Runtime-Native Background Spawn
+- When a workflow phase returns `completionMode=detached`, keep the parent conversation available and do not block on the child unless the user explicitly asks to wait.
+- After `orchestra workflow run` reports a pending parent runtime action, immediately inspect `orchestra runtime parent-actions --task <ID> --json` and consume safe actions supported by the active runtime.
+- Codex parent runtimes should call `spawn_agent` for `codex-spawn-agent` actions using the `promptArtifact`, then record `spawned` with the returned agent id.
+- Do not auto-consume actions when the user explicitly asked to pause, when the action is queued, or when the runtime/tool is unavailable or unsafe.
+- Use `orchestra runtime spawn-request --task <ID> --role <role> --phase <phase> --run-id <run-id>` to render the assignment packet.
+- Record child state with `orchestra runtime spawn-lifecycle --session <session-id> --status <spawned|active|completed|failed> --agent-id <id>`.
+- Resume the workflow after the child completes with `orchestra workflow run --task <ID> --resume <run-id>`.
+- Claude Code parent runtimes should launch the rendered packet with the native Agent/Subagent tool; use Task only when that is the exposed legacy alias.
+- Prefer a role-named Claude subagent and record the resulting id or label in spawn lifecycle.
+
 ## Task Loop
 - `orchestra health` - Check local tools and workflow readiness.
 - `orchestra task list` - List local workflow tasks. Workflow phase subtasks are hidden by default.

package/dist/acceptance-criteria-quality.d.ts

@@ -0,0 +1,12 @@
+import type { Task } from "./types.js";
+export interface AcceptanceCriteriaQualityIssue {
+    criterion: string;
+    index: number;
+    reason: string;
+}
+export interface AcceptanceCriteriaQualityReport {
+    valid: string[];
+    issues: AcceptanceCriteriaQualityIssue[];
+}
+export declare function assessAcceptanceCriteriaQuality(task: Pick<Task, "acceptanceCriteria"> | undefined): AcceptanceCriteriaQualityReport;
+export declare function hasAcceptanceCriteriaQualityIssues(task: Pick<Task, "acceptanceCriteria"> | undefined): boolean;

package/dist/acceptance-criteria-quality.js

@@ -0,0 +1,137 @@
+const MIN_ACTIONABLE_WORDS = 4;
+const ROLE_OR_PHASE_FRAGMENTS = new Set([
+    "architect",
+    "developer",
+    "development",
+    "qa",
+    "release",
+    "release manager",
+    "po",
+    "pm",
+    "ba",
+    "product owner",
+    "business analyst",
+    "qa planning",
+    "qa execution",
+]);
+const VERIFIABLE_SIGNALS = new Set([
+    "allow",
+    "allowed",
+    "allows",
+    "are",
+    "block",
+    "blocks",
+    "can",
+    "compare",
+    "compares",
+    "cover",
+    "covered",
+    "covers",
+    "create",
+    "creates",
+    "detect",
+    "detects",
+    "display",
+    "displays",
+    "exclude",
+    "excluded",
+    "excludes",
+    "expose",
+    "exposes",
+    "fail",
+    "fails",
+    "generate",
+    "generates",
+    "include",
+    "included",
+    "includes",
+    "is",
+    "list",
+    "lists",
+    "load",
+    "loads",
+    "map",
+    "maps",
+    "must",
+    "pass",
+    "passes",
+    "persist",
+    "persists",
+    "prevent",
+    "prevents",
+    "produce",
+    "produces",
+    "record",
+    "records",
+    "reject",
+    "rejected",
+    "rejects",
+    "render",
+    "renders",
+    "report",
+    "reports",
+    "require",
+    "required",
+    "requires",
+    "resume",
+    "resumes",
+    "return",
+    "returns",
+    "route",
+    "routes",
+    "save",
+    "saves",
+    "should",
+    "show",
+    "shows",
+    "update",
+    "updates",
+    "validate",
+    "validates",
+]);
+export function assessAcceptanceCriteriaQuality(task) {
+    const criteria = task?.acceptanceCriteria ?? [];
+    const issues = [];
+    const valid = [];
+    criteria.forEach((criterion, index) => {
+        const reason = acceptanceCriterionIssue(criterion);
+        if (reason) {
+            issues.push({ criterion, index, reason });
+        }
+        else {
+            valid.push(criterion);
+        }
+    });
+    return { valid, issues };
+}
+export function hasAcceptanceCriteriaQualityIssues(task) {
+    return assessAcceptanceCriteriaQuality(task).issues.length > 0;
+}
+function acceptanceCriterionIssue(criterion) {
+    const normalized = criterion.trim();
+    if (!normalized)
+        return "empty acceptance criterion";
+    if (isRoleOrPhaseFragment(normalized)) {
+        return "fragment looks like a role or phase name, not a verifiable outcome";
+    }
+    if (wordCount(normalized) < MIN_ACTIONABLE_WORDS) {
+        return "criterion is too short to be independently verifiable";
+    }
+    if (!hasVerifiableSignal(normalized)) {
+        return "criterion lacks an observable verification verb";
+    }
+    return undefined;
+}
+function isRoleOrPhaseFragment(value) {
+    return ROLE_OR_PHASE_FRAGMENTS.has(value.toLowerCase());
+}
+function hasVerifiableSignal(value) {
+    return words(value).some((word) => VERIFIABLE_SIGNALS.has(word));
+}
+function wordCount(value) {
+    return value.split(/\s+/).filter(Boolean).length;
+}
+function words(value) {
+    return value.toLowerCase().match(/[a-z]+/g) ?? [];
+}
+//# sourceMappingURL=acceptance-criteria-quality.js.map

package/dist/acceptance-criteria-quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-criteria-quality.js","sourceRoot":"","sources":["../src/acceptance-criteria-quality.ts"],"names":[],"mappings":"AAaA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,WAAW;IACX,WAAW;IACX,aAAa;IACb,IAAI;IACJ,SAAS;IACT,iBAAiB;IACjB,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,eAAe;IACf,kBAAkB;IAClB,aAAa;IACb,cAAc;CACf,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,OAAO;IACP,SAAS;IACT,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,KAAK;IACL,SAAS;IACT,UAAU;IACV,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;IACV,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;IACV,IAAI;IACJ,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,UAAU;IACV,SAAS;IACT,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,UAAU,+BAA+B,CAC7C,IAAkD;IAElD,MAAM,QAAQ,GAAG,IAAI,EAAE,kBAAkB,IAAI,EAAE,CAAC;IAChD,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAAkD;IAElD,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,wBAAwB,CAAC,SAAiB;IACjD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU;QAAE,OAAO,4BAA4B,CAAC;IACrD,IAAI,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,oEAAoE,CAAC;IAC9E,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,oBAAoB,EAAE,CAAC;QACjD,OAAO,uDAAuD,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACnD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AACpD,CAAC"}

package/dist/architecture-debt-inventory.d.ts

@@ -0,0 +1,31 @@
+export { renderArchitectureDebtInventory } from "./architecture-debt-report.js";
+export type ArchitectureDebtFindingKind = "large-file" | "long-function" | "command-module-logic" | "module-boundary";
+export interface ArchitectureDebtThresholds {
+    largeFileLines: number;
+    longFunctionLines: number;
+    commandModuleLines: number;
+}
+export interface ArchitectureDebtFinding {
+    kind: ArchitectureDebtFindingKind;
+    file: string;
+    line?: number;
+    name?: string;
+    metric: number;
+    threshold: number;
+    status: "warn";
+    message: string;
+}
+export interface ArchitectureDebtInventoryOptions {
+    root: string;
+    roots?: string[];
+    thresholds?: Partial<ArchitectureDebtThresholds>;
+}
+export interface ArchitectureDebtInventoryReport {
+    root: string;
+    mode: "report-only";
+    thresholds: ArchitectureDebtThresholds;
+    scannedFiles: number;
+    findings: ArchitectureDebtFinding[];
+    summary: Record<ArchitectureDebtFindingKind, number>;
+}
+export declare function buildArchitectureDebtInventory(options: ArchitectureDebtInventoryOptions): Promise<ArchitectureDebtInventoryReport>;

package/dist/architecture-debt-inventory.js

@@ -0,0 +1,200 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+export { renderArchitectureDebtInventory } from "./architecture-debt-report.js";
+const DEFAULT_ROOTS = ["bin", "scripts", "src"];
+const SOURCE_EXTENSIONS = new Set([".js", ".mjs", ".cjs", ".ts"]);
+const DEFAULT_THRESHOLDS = {
+    largeFileLines: 300,
+    longFunctionLines: 30,
+    commandModuleLines: 220,
+};
+const EXCLUDED_DIRECTORIES = new Set([
+    ".git",
+    ".agent-workflow",
+    "coverage",
+    "dist",
+    "node_modules",
+]);
+const COMMAND_LOGIC_TOKENS = [
+    "addTask(",
+    "appendEvent(",
+    "completeWithProviderFallback(",
+    "createHandoff(",
+    "createValidatedPhaseHandoff(",
+    "readEvents(",
+    "updateTask(",
+    "writeArtifact(",
+];
+export async function buildArchitectureDebtInventory(options) {
+    const thresholds = { ...DEFAULT_THRESHOLDS, ...options.thresholds };
+    const files = await discoverSourceFiles(options.root, options.roots);
+    const findings = (await Promise.all(files.map(async (file) => inspectSourceFile(options.root, file, thresholds))))
+        .flat()
+        .sort(compareFindings);
+    return {
+        root: options.root,
+        mode: "report-only",
+        thresholds,
+        scannedFiles: files.length,
+        findings,
+        summary: summarizeFindings(findings),
+    };
+}
+async function discoverSourceFiles(root, roots = DEFAULT_ROOTS) {
+    const files = [];
+    for (const scanRoot of roots) {
+        await walk(path.join(root, scanRoot), root, files);
+    }
+    return files.sort();
+}
+async function walk(directory, root, files) {
+    const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (EXCLUDED_DIRECTORIES.has(entry.name))
+            continue;
+        const absolute = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            await walk(absolute, root, files);
+            continue;
+        }
+        if (SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+            files.push(path.relative(root, absolute));
+        }
+    }
+}
+async function inspectSourceFile(root, file, thresholds) {
+    const content = await readFile(path.join(root, file), "utf8");
+    const lines = content.split(/\r?\n/);
+    return [
+        ...largeFileFinding(file, lines, thresholds),
+        ...longFunctionFindings(file, lines, thresholds),
+        ...commandModuleFindings(file, content, lines, thresholds),
+        ...moduleBoundaryFindings(file, content),
+    ];
+}
+function largeFileFinding(file, lines, thresholds) {
+    if (lines.length <= thresholds.largeFileLines)
+        return [];
+    return [
+        {
+            kind: "large-file",
+            file,
+            metric: lines.length,
+            threshold: thresholds.largeFileLines,
+            status: "warn",
+            message: "File exceeds the preferred module size.",
+        },
+    ];
+}
+function longFunctionFindings(file, lines, thresholds) {
+    const findings = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const name = functionName(lines[index] ?? "");
+        if (!name)
+            continue;
+        const length = functionLength(lines, index);
+        if (length > thresholds.longFunctionLines) {
+            findings.push({
+                kind: "long-function",
+                file,
+                line: index + 1,
+                name,
+                metric: length,
+                threshold: thresholds.longFunctionLines,
+                status: "warn",
+                message: "Function exceeds the preferred size.",
+            });
+        }
+    }
+    return findings;
+}
+function commandModuleFindings(file, content, lines, thresholds) {
+    if (!isCommandModule(file))
+        return [];
+    const hasLogicToken = COMMAND_LOGIC_TOKENS.some((token) => content.includes(token));
+    if (lines.length <= thresholds.commandModuleLines && !hasLogicToken) {
+        return [];
+    }
+    return [
+        {
+            kind: "command-module-logic",
+            file,
+            metric: lines.length,
+            threshold: thresholds.commandModuleLines,
+            status: "warn",
+            message: "Command-facing module may contain orchestration logic that belongs in domain or service helpers.",
+        },
+    ];
+}
+function moduleBoundaryFindings(file, content) {
+    const concerns = new Set();
+    if (/^(bin|scripts)\//.test(file) ||
+        /\b(process\.argv|runCli)\b/.test(content)) {
+        concerns.add("cli");
+    }
+    if (/node:fs|node:path|readFile|writeFile/.test(content)) {
+        concerns.add("filesystem");
+    }
+    if (/workflow|handoff|phase|task/i.test(file + content)) {
+        concerns.add("workflow");
+    }
+    if (/validate|assess|policy|contract|criteria/i.test(file + content)) {
+        concerns.add("domain");
+    }
+    if (concerns.size < 3)
+        return [];
+    return [
+        {
+            kind: "module-boundary",
+            file,
+            metric: concerns.size,
+            threshold: 3,
+            status: "warn",
+            message: `Module mixes concerns: ${[...concerns].sort().join(", ")}.`,
+        },
+    ];
+}
+function functionName(line) {
+    return (line.match(/^\s*(?:export\s+)?(?:async\s+)?function\s+([A-Za-z0-9_$]+)/)?.[1] ??
+        line.match(/^\s*(?:const|let|var)\s+([A-Za-z0-9_$]+)\s*=\s*(?:async\s*)?\([^)]*\)\s*=>\s*\{/)?.[1]);
+}
+function functionLength(lines, startIndex) {
+    let depth = 0;
+    let opened = false;
+    for (let index = startIndex; index < lines.length; index += 1) {
+        for (const char of lines[index] ?? "") {
+            if (char === "{") {
+                opened = true;
+                depth += 1;
+            }
+            else if (char === "}") {
+                depth -= 1;
+            }
+        }
+        if (opened && depth <= 0)
+            return index - startIndex + 1;
+    }
+    return 1;
+}
+function isCommandModule(file) {
+    return /^(bin|scripts)\//.test(file) || /commands?\.ts$/.test(file);
+}
+function summarizeFindings(findings) {
+    const summary = Object.fromEntries([
+        "large-file",
+        "long-function",
+        "command-module-logic",
+        "module-boundary",
+    ].map((kind) => [
+        kind,
+        findings.filter((item) => item.kind === kind).length,
+    ]));
+    return summary;
+}
+function compareFindings(left, right) {
+    return (left.kind.localeCompare(right.kind) ||
+        left.file.localeCompare(right.file) ||
+        (left.line ?? 0) - (right.line ?? 0) ||
+        (left.name ?? "").localeCompare(right.name ?? ""));
+}
+//# sourceMappingURL=architecture-debt-inventory.js.map

package/dist/architecture-debt-inventory.js.map

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

package/dist/architecture-debt-report.d.ts

@@ -0,0 +1,2 @@
+import type { ArchitectureDebtInventoryReport } from "./architecture-debt-inventory.js";
+export declare function renderArchitectureDebtInventory(report: ArchitectureDebtInventoryReport): string;

package/dist/architecture-debt-report.js

@@ -0,0 +1,28 @@
+export function renderArchitectureDebtInventory(report) {
+    const lines = [
+        "# Architecture Debt Inventory",
+        "",
+        `Mode: ${report.mode}`,
+        `Scanned files: ${report.scannedFiles}`,
+        "",
+        "## Summary",
+        ...Object.entries(report.summary).map(([kind, count]) => `- ${kind}: ${count}`),
+        "",
+        "## Findings",
+    ];
+    if (report.findings.length === 0) {
+        lines.push("- No findings.");
+    }
+    else {
+        for (const finding of report.findings) {
+            const location = finding.line
+                ? `${finding.file}:${finding.line}`
+                : finding.file;
+            const name = finding.name ? ` ${finding.name}` : "";
+            lines.push(`- [${finding.status}] ${finding.kind}: ${location}${name} (${finding.metric}/${finding.threshold}) - ${finding.message}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=architecture-debt-report.js.map

package/dist/architecture-debt-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-debt-report.js","sourceRoot":"","sources":["../src/architecture-debt-report.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,+BAA+B,CAC7C,MAAuC;IAEvC,MAAM,KAAK,GAAG;QACZ,+BAA+B;QAC/B,EAAE;QACF,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,kBAAkB,MAAM,CAAC,YAAY,EAAE;QACvC,EAAE;QACF,YAAY;QACZ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CACnC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CACzC;QACD,EAAE;QACF,aAAa;KACd,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;gBAC3B,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;gBACnC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CACR,MAAM,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,KAAK,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,OAAO,OAAO,CAAC,OAAO,EAAE,CAC1H,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/autonomous-phase-lifecycle.d.ts

@@ -1,5 +1,5 @@
 import type { AutonomousPhaseDefinition } from "./autonomous-workflow-constants.js";
-import type { AutonomousPhase, AutonomousRun, SizingLabel } from "./types.js";
+import type { AutonomousPhase, AutonomousRun, PhaseStructuredOutput, SizingLabel } from "./types.js";
 export type SizingCheckResult = {
     found: true;
     sizing: SizingLabel;
@@ -11,12 +11,16 @@ export declare function checkArchitectSizing(root: string, taskId: string): Prom
 export type PhaseOutcome = {
     kind: "done";
     notes: string;
+    output?: PhaseStructuredOutput;
 } | {
     kind: "gate_pause";
     reviewArtifact: string;
 } | {
     kind: "qa_fail";
     notes: string;
+} | {
+    kind: "blocked";
+    notes: string;
 };
 export declare function initPhase(root: string, run: AutonomousRun, phaseIndex: number, retryContext?: string, sequence?: AutonomousPhaseDefinition[]): Promise<AutonomousPhase>;
 export declare function closePhase(root: string, run: AutonomousRun, phaseIndex: number, outcome: PhaseOutcome, sequence?: AutonomousPhaseDefinition[]): Promise<{