raptor-aios 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to this project will be documented in this file.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.6.1] - 2026-06-05
+
+### Changed
+
+- Package `author` set to **Lucas Pedro <lucaspedrolbg@gmail.com> (https://github.com/lucaspedronet)** on the publishable package and the workspace `package.json` files (previously the bare npm handle). Metadata-only; no code changes.
+
+## [0.6.0] - 2026-06-05
+
+### Added
+
+- **Figma design gate — the design enriches `spec → plan → tasks` and is enforced.** A Figma link in `raptor new --desc` (or in a seeded Jira ticket) is now detected, normalized (`node-id` → canonical `1:23`) and recorded as a first-class artifact. `raptor new` scaffolds a traceable `design/` layer (`tokens.json`, `screens/`, `assets-manifest.json`, `README.md`) plus the standardized `assets/{images,icons,fonts}/` directories, and seeds a `## Design Reference` section into the spec. The agent "sees" the design through **its own Figma MCP tools** (`get_design_context`, `get_variable_defs`, `get_screenshot`, `get_metadata`, `get_libraries`, `search_design_system`) — RAPTOR holds no Figma credentials; it owns detection, scaffolding, the canonical prompts, and the gate.
+- **`gate.design.ready`** (required, article M3) — readiness-conditional like `gate.spec.ready`: it passes when no design is attached or while the spec is a draft, and blocks `raptor verify` once the spec is **approved** unless `design/tokens.json` is non-empty, every `[screen: X]` has a matching `design/screens/*.md`, the assets manifest is valid, every catalogued asset exists on disk, every referenced asset/screen is catalogued, and the plan declares its libraries/design-system. A catalogued-but-unused asset is a warning, not a failure.
+- **Design instructions in the canonical prompts** (`/raptor-specify`, `/raptor-plan`, `/raptor-tasks`) telling the agent which Figma MCP tools to use per phase — see the screens, extract the tokens, declare the libraries, download and catalogue the assets to `assets/*`, and reference them by `[screen: X]` / `[asset: X]` tags and concrete paths.
+- **`design.imported` audit event** (provider, ref count, file keys), plus `design_enriched` / `design_refs` / `design_scaffolded` on `feature.created`.
+- **[docs/design-gate.md](docs/design-gate.md)** — full pt-BR guide (flows, tables, schemas, examples) and an index entry.
+
+### Changed
+
+- Reference matching in the design gate is **tolerant**: screen/asset names compare by slug (`Order Details` ≡ `order-details`), asset paths by normalized POSIX path (`./assets/…` ≡ `assets/…`), and asset-path detection is scoped to the standardized `assets/{images,icons,fonts}` directories — avoiding false orphan/missing failures on incidental prose. The plan library check accepts any plausible heading (Tech Stack, Packages, Dependencies, UI Kit, …), not a single wording.
+
+### Reliability
+
+- The design scaffold in `raptor new` is **best-effort**: a filesystem failure (read-only `assets/`, a file where a dir is expected, ENOSPC) degrades gracefully (warns, records `design_scaffolded: false`) and never breaks feature creation — the same invariant the Jira seeding upholds. Asset-name matching no longer builds a `RegExp` from author-controlled data, so a name with regex metacharacters can never crash `verify`.
+
+> The design gate **complements** the existing readiness/coverage gates: coverage proves nothing is missing, readiness proves what's there is well-formed — now extended to screens, tokens and assets. It is enforced at `raptor verify` and stays silent while the spec is a draft or no design is attached.
+
 ## [0.5.0] - 2026-06-04
 
 ### Added

package/dist/_core/dist/agents/adapters/antigravity.js

@@ -1,9 +1,3 @@
-/**
- * Antigravity adapter.
- *
- * Generates `.antigravity/playbooks/<command>.md` with playbook header.
- * Blueprint ref: 17.5.3.
- */
 export const antigravityAdapter = {
     id: "antigravity",
     displayName: "Antigravity",
@@ -69,4 +63,3 @@ function buildAntigravityBody(canonical) {
     }
     return sections.join("\n");
 }
-//# sourceMappingURL=antigravity.js.map

package/dist/_core/dist/agents/adapters/claude-code.js

@@ -1,9 +1,3 @@
-/**
- * Claude Code adapter.
- *
- * Generates `.claude/commands/<command>.md` with YAML frontmatter.
- * Blueprint ref: 17.5.1.
- */
 export const claudeCodeAdapter = {
     id: "claude-code",
     displayName: "Claude Code",
@@ -30,7 +24,6 @@ export const claudeCodeAdapter = {
     commandFileName(command) {
         return `raptor-${command}.md`;
     },
-    // Claude Code discovers skills under `.claude/skills/<name>/SKILL.md`.
     skillDir: ".claude/skills",
     skillFileName(skillId) {
         return `raptor-${skillId}/SKILL.md`;
@@ -68,4 +61,3 @@ function buildContractSection(canonical) {
     sections.push("\n## Forma de assinatura\n", "Ao finalizar, grave o arquivo diretamente. O Raptor detectará via hash.", "NÃO adicione comentários como `// gerado por Claude`.");
     return sections.join("\n");
 }
-//# sourceMappingURL=claude-code.js.map

package/dist/_core/dist/agents/adapters/codex.js

@@ -1,12 +1,3 @@
-/**
- * OpenAI Codex CLI adapter.
- *
- * Materializes Raptor commands into `.codex/commands/<command>.md`
- * and uses `AGENTS.md` as the agent-neutral context file (the convention
- * adopted by the Codex CLI and other AGENTS.md-aware tools).
- *
- * Spec Kit ref: E11 — "Adaptador Codex".
- */
 export const codexAdapter = {
     id: "codex",
     displayName: "OpenAI Codex",
@@ -66,4 +57,3 @@ function buildContractSection(canonical) {
     sections.push("\n## Forma de assinatura\n", "Ao finalizar, grave o arquivo diretamente. O Raptor detectará via hash.", "NÃO adicione comentários como `// gerado por Codex`.");
     return sections.join("\n");
 }
-//# sourceMappingURL=codex.js.map

package/dist/_core/dist/agents/adapters/copilot.js

@@ -1,12 +1,3 @@
-/**
- * GitHub Copilot adapter.
- *
- * Materializes Raptor commands into `.github/prompts/<command>.prompt.md`
- * (the GitHub Copilot prompt-library convention) and uses
- * `.github/copilot-instructions.md` as the persistent context file.
- *
- * Spec Kit ref: E11 — "Adaptador Copilot".
- */
 export const copilotAdapter = {
     id: "copilot",
     displayName: "GitHub Copilot",
@@ -68,4 +59,3 @@ function buildContractSection(canonical) {
     sections.push("\n## Forma de assinatura\n", "Ao finalizar, grave o arquivo diretamente. O Raptor detectará via hash.", "NÃO adicione comentários como `// gerado por Copilot`.");
     return sections.join("\n");
 }
-//# sourceMappingURL=copilot.js.map

package/dist/_core/dist/agents/adapters/cursor.js

@@ -1,9 +1,3 @@
-/**
- * Cursor adapter.
- *
- * Generates `.cursor/rules/raptor-<command>.mdc` with Cursor MDC format.
- * Blueprint ref: 17.5.2.
- */
 export const cursorAdapter = {
     id: "cursor",
     displayName: "Cursor",
@@ -59,4 +53,3 @@ function buildCursorBody(canonical) {
     }
     return sections.join("\n");
 }
-//# sourceMappingURL=cursor.js.map

package/dist/_core/dist/agents/adapters/gemini.js

@@ -1,11 +1,3 @@
-/**
- * Gemini adapter.
- *
- * Generates `.gemini/commands/<command>.md` with YAML frontmatter.
- * Gemini uses GEMINI.md as its context file.
- *
- * Spec Kit ref: E11 — "Adaptador Gemini"
- */
 export const geminiAdapter = {
     id: "gemini",
     displayName: "Gemini (Antigravity)",
@@ -65,4 +57,3 @@ function buildContractSection(canonical) {
     sections.push("\n## Forma de assinatura\n", "Ao finalizar, grave o arquivo diretamente. O Raptor detectará via hash.", "NÃO adicione comentários como `// gerado por Gemini`.");
     return sections.join("\n");
 }
-//# sourceMappingURL=gemini.js.map

package/dist/_core/dist/agents/adapters/human.js

@@ -1,10 +1,3 @@
-/**
- * Human fallback adapter.
- *
- * Renders the canonical prompt to stdout for manual copy-paste.
- * Always available — used when no AI agent is installed.
- * Blueprint ref: 17.2 (Humano — fallback).
- */
 export const humanAdapter = {
     id: "human",
     displayName: "Human (manual)",
@@ -45,4 +38,3 @@ export const humanAdapter = {
         return `raptor-${command}.md`;
     },
 };
-//# sourceMappingURL=human.js.map

package/dist/_core/dist/agents/artifact-watcher.js

@@ -1,27 +1,3 @@
-/**
- * Artifact Watcher — polling-based file detection.
- *
- * Watches an expected artifact path (e.g. `specs/<feature>/plan.md`) and
- * resolves when the agent has produced/updated the file. Used by the
- * `--wait-artifact` flag in phase commands to allow the CLI to block
- * until an external agent (Claude Code, Cursor, Antigravity) finishes
- * producing the canonical output.
- *
- * Design choices:
- * - Polls with `fs.stat` at a configurable interval (default 500ms).
- * - Watches for either (a) new file creation after the baseline snapshot,
- *   or (b) mtime change on an existing file.
- * - Supports glob patterns (`specs/<f>/code/**`) via minimal base-dir
- *   directory scan — for our use case we only need to detect "something
- *   new appeared under this directory".
- * - Returns { path, hash, detectedAt } mirroring `ArtifactDetection`.
- *
- * Not goals:
- * - Recursive/native fs watching (avoided for cross-platform determinism).
- * - Debouncing writes larger than one tick (caller reads stable mtime).
- *
- * Blueprint ref: 17.7 — "Captura de artefatos".
- */
 import { readdirSync, statSync, existsSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { hashFile } from "../audit/hash.js";
@@ -43,10 +19,6 @@ export class ArtifactWaitAbortedError extends Error {
         this.name = "ArtifactWaitAbortedError";
     }
 }
-/**
- * Snapshot of a single path's mtime — `null` when the file does not exist.
- * The caller compares against a later snapshot to detect change.
- */
 export function snapshotMtime(path) {
     try {
         return statSync(path).mtimeMs;
@@ -55,10 +27,6 @@ export function snapshotMtime(path) {
         return null;
     }
 }
-/**
- * Snapshot a directory (non-recursive): returns a map of filename → mtime.
- * Used to detect when a new file appears under a directory (e.g. `code/**`).
- */
 export function snapshotDir(dir) {
     const out = new Map();
     if (!existsSync(dir))
@@ -79,16 +47,10 @@ export function snapshotDir(dir) {
             }
         }
         catch {
-            // ignore
         }
     }
     return out;
 }
-/**
- * Parse an expected path: either a concrete file (`specs/x/plan.md`) or a
- * glob-dir pattern ending in `/**` (`specs/x/code/**`). Returns the mode
- * and the effective directory/file path.
- */
 function parseExpected(expectedPath) {
     if (!isAbsolute(expectedPath)) {
         throw new Error(`Artifact path must be absolute: "${expectedPath}"`);
@@ -98,17 +60,6 @@ function parseExpected(expectedPath) {
     }
     return { mode: "file", watchTarget: expectedPath };
 }
-/**
- * Wait for an artifact to appear or change (by mtime) at `expectedPath`.
- *
- * - File mode: resolves when `expectedPath` exists AND (a) didn't exist
- *   at the baseline OR (b) its mtime differs from the baseline.
- * - Dir mode (trailing `/**`): resolves when any new file appears in the
- *   target directory OR an existing file's mtime changes.
- *
- * Returns the detected file path (in dir mode, the first changed/new file
- * encountered) along with its SHA-256 hash and detection timestamp.
- */
 export async function waitForArtifact(opts) {
     const pollIntervalMs = opts.pollIntervalMs ?? 500;
     const timeoutMs = opts.timeoutMs ?? 300_000;
@@ -185,30 +136,15 @@ export async function waitForArtifact(opts) {
         timer = setTimeout(poll, pollIntervalMs);
     });
 }
-/**
- * Resolve an artifact path relative to a project root.
- *
- * Exported as a helper for CLI commands that know the feature slug and
- * the expected output pattern from `CanonicalPrompt.expectedOutput`.
- */
 export function resolveArtifactPath(projectRoot, expectedOutput) {
     return isAbsolute(expectedOutput)
         ? expectedOutput
         : join(projectRoot, expectedOutput);
 }
-/**
- * Determine the "watch target directory" for a given expected path.
- * Useful for callers that want to show the user what they are waiting on.
- */
 export function watchTargetOf(expectedPath) {
     const { mode, watchTarget } = parseExpected(expectedPath);
     return mode === "dir" ? watchTarget : dirname(watchTarget);
 }
-/**
- * Returns the relative path of `absolute` from `root`, using forward slashes
- * so messages look uniform across platforms.
- */
 export function relPath(root, absolute) {
     return relative(root, absolute).replace(/\\/g, "/");
 }
-//# sourceMappingURL=artifact-watcher.js.map

package/dist/_core/dist/agents/backup.js

@@ -1,32 +1,6 @@
-/**
- * Artifact Backup — preserve previous versions before overwriting.
- *
- * Before a phase command (re-)generates a slash-command prompt file or
- * writes a new canonical artifact, we copy the previous file (if any)
- * into `.raptor/backup/<ISO>/<relative-path>`. This gives the user a
- * cheap "undo" and lets audit trails reference the pre-state.
- *
- * Design notes:
- * - Backups are timestamped per call — multiple files backed up in the
- *   same instant share a directory (we expose `createBackupSession` for
- *   that), otherwise each call gets its own unique directory.
- * - We intentionally do NOT rotate/prune; cleanup is the user's call.
- * - Missing source files are a no-op (returns `null`) — not an error,
- *   because "first write" is the common case.
- *
- * Blueprint ref: 17.4 — "Idempotência e versionamento de prompts".
- */
 import { existsSync, mkdirSync, copyFileSync, rmSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
-/**
- * Default relative location inside a project root where backups live.
- * Exported so callers can construct informational messages.
- */
 export const DEFAULT_BACKUP_SUBDIR = ".raptor/backup";
-/**
- * Build an ISO timestamp safe for a directory name (colons replaced).
- * Example: `2026-04-23T18-42-13-021Z`.
- */
 export function backupTimestamp(date = new Date()) {
     return date.toISOString().replace(/:/g, "-").replace(/\./g, "-");
 }
@@ -36,13 +10,6 @@ function resolveBackupRoot(projectRoot) {
     }
     return join(projectRoot, DEFAULT_BACKUP_SUBDIR);
 }
-/**
- * Back up a single file into a freshly-created session directory.
- *
- * If the source file does not exist, this is a no-op and returns `null`.
- * Otherwise the file is copied under `<root>/.raptor/backup/<ts>/<rel>`
- * where `<rel>` is the source path relative to `projectRoot`.
- */
 export function backupIfExists(projectRoot, absoluteSource) {
     if (!existsSync(absoluteSource))
         return null;
@@ -51,11 +18,6 @@ export function backupIfExists(projectRoot, absoluteSource) {
     session.discardIfEmpty();
     return result;
 }
-/**
- * Start a backup session. Useful when a command is about to overwrite
- * several files (e.g. one prompt per adapter) and we want them grouped
- * under a single timestamp directory.
- */
 export function createBackupSession(projectRoot, timestamp = backupTimestamp()) {
     const backupRoot = resolveBackupRoot(projectRoot);
     const dir = join(backupRoot, timestamp);
@@ -99,9 +61,7 @@ export function createBackupSession(projectRoot, timestamp = backupTimestamp())
                 rmSync(dir, { recursive: true, force: true });
             }
             catch {
-                // ignore — best effort cleanup
             }
         },
     };
 }
-//# sourceMappingURL=backup.js.map

package/dist/_core/dist/agents/config.js

@@ -1,21 +1,6 @@
-/**
- * Agent Configuration — agents.yml parser and validator.
- *
- * Parses, validates, and serializes the `.raptor/agents.yml` configuration.
- * Schema: raptor.agents/v1.
- *
- * Blueprint ref: 17.3 — "Manifesto de orquestração".
- */
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { getAgentByKind } from "./registry.js";
-// ---------------------------------------------------------------------------
-// YAML-like parser (minimal, no external dep)
-// ---------------------------------------------------------------------------
-/**
- * Parse agents.yml from a project root.
- * Returns null if the file doesn't exist.
- */
 export function loadAgentsConfig(projectRoot) {
     const configPath = join(projectRoot, ".raptor", "agents.yml");
     if (!existsSync(configPath))
@@ -23,13 +8,7 @@ export function loadAgentsConfig(projectRoot) {
     const raw = readFileSync(configPath, "utf8");
     return parseAgentsYaml(raw);
 }
-/**
- * Parse an agents.yml content string into an AgentsConfig.
- * Uses a simplified YAML parser since agents.yml has a predictable schema.
- */
 export function parseAgentsYaml(raw) {
-    // We use JSON as the canonical internal format. The YAML is parsed line-by-line
-    // into a structured object. This avoids a dependency on a full YAML parser.
     const config = {
         schema: "raptor.agents/v1",
         agents: [],
@@ -47,7 +26,6 @@ export function parseAgentsYaml(raw) {
         const trimmed = line.trim();
         if (trimmed === "" || trimmed.startsWith("#"))
             continue;
-        // Schema
         if (trimmed.startsWith("schema:")) {
             config.schema = trimmed
                 .split(":")
@@ -57,7 +35,6 @@ export function parseAgentsYaml(raw) {
                 .replace(/['"]/g, "");
             continue;
         }
-        // Section detection
         if (trimmed === "agents:") {
             currentSection = "agents";
             continue;
@@ -66,7 +43,6 @@ export function parseAgentsYaml(raw) {
             currentSection = "policy";
             continue;
         }
-        // Agent entries
         if (currentSection === "agents" || currentSection === "agent") {
             if (trimmed.startsWith("- id:")) {
                 if (currentAgent?.id) {
@@ -103,7 +79,6 @@ export function parseAgentsYaml(raw) {
                 }
             }
         }
-        // Policy section
         if (currentSection === "policy" ||
             currentSection === "byCommand" ||
             currentSection === "fallback") {
@@ -120,7 +95,7 @@ export function parseAgentsYaml(raw) {
             else if (trimmed === "fallback_chain:" ||
                 trimmed === "fallbackChain:") {
                 currentSection = "fallback";
-                config.policy.fallbackChain = []; // Reset default before parsing
+                config.policy.fallbackChain = [];
             }
             else if (currentSection === "byCommand" && trimmed.match(/^\w+:/)) {
                 const [key, ...rest] = trimmed.split(":");
@@ -139,7 +114,6 @@ export function parseAgentsYaml(raw) {
             }
         }
     }
-    // Flush last agent
     if (currentAgent?.id) {
         config.agents.push(finalizeAgent(currentAgent));
     }
@@ -163,27 +137,21 @@ function finalizeAgent(partial) {
         capabilities: partial.capabilities ?? [],
     };
 }
-/**
- * Validate an AgentsConfig for semantic correctness.
- */
 export function validateAgentsConfig(config) {
     const errors = [];
     const agentIds = new Set(config.agents.map((a) => a.id));
-    // Schema version
     if (config.schema !== "raptor.agents/v1") {
         errors.push({
             field: "schema",
             message: `Unknown schema "${config.schema}", expected "raptor.agents/v1".`,
         });
     }
-    // At least one agent
     if (config.agents.length === 0) {
         errors.push({
             field: "agents",
             message: "At least one agent must be configured.",
         });
     }
-    // Unique IDs
     const seen = new Set();
     for (const agent of config.agents) {
         if (seen.has(agent.id)) {
@@ -193,7 +161,6 @@ export function validateAgentsConfig(config) {
             });
         }
         seen.add(agent.id);
-        // Kind maps to a known adapter
         if (!getAgentByKind(agent.kind)) {
             errors.push({
                 field: `agents.${agent.id}.kind`,
@@ -201,14 +168,12 @@ export function validateAgentsConfig(config) {
             });
         }
     }
-    // Policy default references a valid agent
     if (!agentIds.has(config.policy.default)) {
         errors.push({
             field: "policy.default",
             message: `Default agent "${config.policy.default}" is not in agents[].`,
         });
     }
-    // by_command values reference valid agents
     for (const [cmd, agentId] of Object.entries(config.policy.byCommand)) {
         if (!agentIds.has(agentId)) {
             errors.push({
@@ -217,7 +182,6 @@ export function validateAgentsConfig(config) {
             });
         }
     }
-    // fallback_chain values reference valid agents
     for (const agentId of config.policy.fallbackChain) {
         if (!agentIds.has(agentId)) {
             errors.push({
@@ -228,12 +192,6 @@ export function validateAgentsConfig(config) {
     }
     return errors;
 }
-// ---------------------------------------------------------------------------
-// Generator — produce agents.yml from detected agents
-// ---------------------------------------------------------------------------
-/**
- * Generate default agents.yml content for detected agents.
- */
 export function generateAgentsYaml(agents) {
     const lines = [];
     lines.push("# Raptor — Agent Configuration");
@@ -260,11 +218,9 @@ export function generateAgentsYaml(agents) {
     for (const agent of agents) {
         lines.push(`    - ${agent.id}`);
     }
-    // Always ensure human is the ultimate fallback
     if (!agents.some((a) => a.id === "human")) {
         lines.push("    - human");
     }
     lines.push("");
     return lines.join("\n");
 }
-//# sourceMappingURL=config.js.map

package/dist/_core/dist/agents/context-file.js

@@ -1,20 +1,8 @@
-/**
- * Context File Manager.
- *
- * Manages delimited blocks in agent context files (CLAUDE.md, AGENTS.md, etc.).
- * Uses idempotent upsert with RAPTOR START/END markers to coexist safely
- * with user-authored content.
- *
- * Blueprint ref: 03§6 — "upsert idempotente delimitado por marcadores".
- */
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { mkdirSync } from "node:fs";
 const MARKER_START = "<!-- RAPTOR START -->";
 const MARKER_END = "<!-- RAPTOR END -->";
-/**
- * Generate the standard Raptor context block content.
- */
 export function buildContextBlock(opts) {
     const lines = [];
     lines.push("# Raptor — Spec-Driven Development Context\n");
@@ -48,13 +36,6 @@ export function buildContextBlock(opts) {
     lines.push('- **USE** `[NEEDS CLARIFICATION]` markers when information is missing.');
     return lines.join("\n");
 }
-/**
- * Insert or update the Raptor block in an agent context file.
- *
- * - If file doesn't exist: create with block only.
- * - If file exists without block: append block at end.
- * - If file exists with block: replace block content, preserve everything else.
- */
 export function upsertContextFile(filePath, content) {
     const block = `${MARKER_START}\n${content}\n${MARKER_END}`;
     if (!existsSync(filePath)) {
@@ -66,20 +47,14 @@ export function upsertContextFile(filePath, content) {
     const startIdx = existing.indexOf(MARKER_START);
     const endIdx = existing.indexOf(MARKER_END);
     if (startIdx === -1 || endIdx === -1) {
-        // Block doesn't exist — append
         const sep = existing.endsWith("\n") ? "\n" : "\n\n";
         writeFileSync(filePath, existing + sep + block + "\n");
         return;
     }
-    // Block exists — replace
     const before = existing.slice(0, startIdx);
     const after = existing.slice(endIdx + MARKER_END.length);
     writeFileSync(filePath, before + block + after);
 }
-/**
- * Remove the Raptor block from a context file.
- * Preserves all content outside the markers.
- */
 export function removeContextBlock(filePath) {
     if (!existsSync(filePath))
         return false;
@@ -94,13 +69,9 @@ export function removeContextBlock(filePath) {
     writeFileSync(filePath, cleaned ? cleaned + "\n" : "");
     return true;
 }
-/**
- * Check if a context file contains the Raptor block.
- */
 export function hasContextBlock(filePath) {
     if (!existsSync(filePath))
         return false;
     const content = readFileSync(filePath, "utf8");
     return content.includes(MARKER_START) && content.includes(MARKER_END);
 }
-//# sourceMappingURL=context-file.js.map

package/dist/_core/dist/agents/handoff.js

@@ -1,26 +1,4 @@
-/**
- * Agent Handoff Manager.
- *
- * Manages cross-agent transitions between SDD phases.
- * Enforces HD-1: previous phase must be "approved" before handoff.
- *
- * Blueprint ref: 17.8 — "Handoff cross-agent".
- */
-// ---------------------------------------------------------------------------
-// Phase ordering
-// ---------------------------------------------------------------------------
 const PHASE_ORDER = ["new", "plan", "tasks", "implement"];
-// ---------------------------------------------------------------------------
-// Validation
-// ---------------------------------------------------------------------------
-/**
- * Validate that a handoff is semantically correct.
- *
- * Rules enforced:
- * - HD-1: Phase ordering must be respected (new → plan → tasks → implement).
- * - HD-2: Cannot hand off to the same phase (no self-loop).
- * - HD-3: Source and target can be the same agent (same-agent phase transition).
- */
 export function validateHandoff(request) {
     const summary = {
         feature: request.feature,
@@ -29,7 +7,6 @@ export function validateHandoff(request) {
         phaseFrom: request.phaseFrom,
         phaseTo: request.phaseTo,
     };
-    // HD-2: No self-loop
     if (request.phaseFrom === request.phaseTo) {
         return {
             allowed: false,
@@ -37,11 +14,9 @@ export function validateHandoff(request) {
             summary,
         };
     }
-    // HD-1: Phase ordering
     const fromIdx = PHASE_ORDER.indexOf(request.phaseFrom);
     const toIdx = PHASE_ORDER.indexOf(request.phaseTo);
     if (fromIdx === -1 || toIdx === -1) {
-        // Unknown phase — allow (could be custom workflow step)
         return { allowed: true, summary };
     }
     if (toIdx <= fromIdx) {
@@ -53,19 +28,12 @@ export function validateHandoff(request) {
     }
     return { allowed: true, summary };
 }
-/**
- * Get the next phase in the canonical SDD cycle.
- */
 export function nextPhase(current) {
     const idx = PHASE_ORDER.indexOf(current);
     if (idx === -1 || idx >= PHASE_ORDER.length - 1)
         return null;
     return PHASE_ORDER[idx + 1];
 }
-/**
- * Check if a phase is the terminal phase (implement).
- */
 export function isTerminalPhase(phase) {
     return phase === PHASE_ORDER[PHASE_ORDER.length - 1];
 }
-//# sourceMappingURL=handoff.js.map