raptor-aios 0.1.0

package/dist/_core/dist/agents/backup.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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".
+ */
+export interface BackupResult {
+    /** Absolute path of the source file we backed up. */
+    source: string;
+    /** Absolute path where the backup was written. */
+    destination: string;
+    /** Directory path (absolute) of the backup session. */
+    sessionDir: string;
+    /** ISO timestamp used to name the session directory. */
+    timestamp: string;
+}
+export interface BackupSession {
+    /** Absolute session directory (e.g. `<root>/.raptor/backup/2026-04-23T...`). */
+    dir: string;
+    /** ISO timestamp used in the dir name (reused for logging). */
+    timestamp: string;
+    /**
+     * Back up one file into this session dir. Returns `null` if the source
+     * file does not exist.
+     */
+    backup(absoluteSource: string): BackupResult | null;
+    /**
+     * Remove the session directory if no files were backed up to it.
+     * Used by callers that want to avoid leaving empty dirs.
+     */
+    discardIfEmpty(): void;
+}
+/**
+ * Default relative location inside a project root where backups live.
+ * Exported so callers can construct informational messages.
+ */
+export declare 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 declare function backupTimestamp(date?: Date): string;
+/**
+ * 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 declare function backupIfExists(projectRoot: string, absoluteSource: string): BackupResult | null;
+/**
+ * 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 declare function createBackupSession(projectRoot: string, timestamp?: string): BackupSession;
+//# sourceMappingURL=backup.d.ts.map

package/dist/_core/dist/agents/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/agents/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACpD;;;OAGG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE/D;AAWD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,YAAY,GAAG,IAAI,CAMrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAA0B,GACpC,aAAa,CAqDf"}

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

@@ -0,0 +1,107 @@
+/**
+ * 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, "-");
+}
+function resolveBackupRoot(projectRoot) {
+    if (!isAbsolute(projectRoot)) {
+        throw new Error(`projectRoot must be absolute for backup operations: "${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;
+    const session = createBackupSession(projectRoot);
+    const result = session.backup(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);
+    let materialized = false;
+    let count = 0;
+    const ensureDir = () => {
+        if (!materialized) {
+            mkdirSync(dir, { recursive: true });
+            materialized = true;
+        }
+    };
+    return {
+        dir,
+        timestamp,
+        backup(absoluteSource) {
+            if (!isAbsolute(absoluteSource)) {
+                throw new Error(`Backup source must be absolute: "${absoluteSource}"`);
+            }
+            if (!existsSync(absoluteSource))
+                return null;
+            const rel = relative(projectRoot, absoluteSource);
+            if (rel.startsWith("..") || isAbsolute(rel)) {
+                throw new Error(`Backup source must live under projectRoot. source="${absoluteSource}" root="${projectRoot}"`);
+            }
+            const destination = join(dir, rel);
+            ensureDir();
+            mkdirSync(dirname(destination), { recursive: true });
+            copyFileSync(absoluteSource, destination);
+            count += 1;
+            return {
+                source: absoluteSource,
+                destination,
+                sessionDir: dir,
+                timestamp,
+            };
+        },
+        discardIfEmpty() {
+            if (!materialized || count > 0)
+                return;
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                // ignore — best effort cleanup
+            }
+        },
+    };
+}
+//# sourceMappingURL=backup.js.map

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

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

package/dist/_core/dist/agents/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 type { AgentsConfig } from "./types.js";
+/**
+ * Parse agents.yml from a project root.
+ * Returns null if the file doesn't exist.
+ */
+export declare function loadAgentsConfig(projectRoot: string): AgentsConfig | null;
+/**
+ * Parse an agents.yml content string into an AgentsConfig.
+ * Uses a simplified YAML parser since agents.yml has a predictable schema.
+ */
+export declare function parseAgentsYaml(raw: string): AgentsConfig;
+export interface AgentConfigError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate an AgentsConfig for semantic correctness.
+ */
+export declare function validateAgentsConfig(config: AgentsConfig): AgentConfigError[];
+/**
+ * Generate default agents.yml content for detected agents.
+ */
+export declare function generateAgentsYaml(agents: Array<{
+    id: string;
+    kind: string;
+    capabilities: string[];
+}>): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/_core/dist/agents/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agents/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAkIzD;AAyBD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE,CAqE7E;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAClE,MAAM,CAsCR"}

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

@@ -0,0 +1,270 @@
+/**
+ * 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))
+        return null;
+    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: [],
+        policy: {
+            default: "human",
+            byCommand: {},
+            fallbackChain: ["human"],
+        },
+    };
+    const lines = raw.split("\n");
+    let currentSection = "root";
+    let currentAgent = null;
+    for (const rawLine of lines) {
+        const line = rawLine.trimEnd();
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        // Schema
+        if (trimmed.startsWith("schema:")) {
+            config.schema = trimmed
+                .split(":")
+                .slice(1)
+                .join(":")
+                .trim()
+                .replace(/['"]/g, "");
+            continue;
+        }
+        // Section detection
+        if (trimmed === "agents:") {
+            currentSection = "agents";
+            continue;
+        }
+        if (trimmed === "policy:") {
+            currentSection = "policy";
+            continue;
+        }
+        // Agent entries
+        if (currentSection === "agents" || currentSection === "agent") {
+            if (trimmed.startsWith("- id:")) {
+                if (currentAgent?.id) {
+                    config.agents.push(finalizeAgent(currentAgent));
+                }
+                currentAgent = {
+                    id: trimmed.replace("- id:", "").trim().replace(/['"]/g, ""),
+                };
+                currentSection = "agent";
+                continue;
+            }
+            if (currentSection === "agent" && currentAgent) {
+                if (trimmed.startsWith("kind:")) {
+                    currentAgent.kind = trimmed
+                        .replace("kind:", "")
+                        .trim()
+                        .replace(/['"]/g, "");
+                }
+                else if (trimmed.startsWith("version:")) {
+                    currentAgent.version = trimmed
+                        .replace("version:", "")
+                        .trim()
+                        .replace(/['"]/g, "");
+                }
+                else if (trimmed.startsWith("installCheck:")) {
+                    currentAgent.installCheck = trimmed
+                        .replace("installCheck:", "")
+                        .trim()
+                        .replace(/['"]/g, "");
+                }
+                else if (trimmed.startsWith("capabilities:")) {
+                    const caps = trimmed.replace("capabilities:", "").trim();
+                    currentAgent.capabilities = parseInlineArray(caps);
+                }
+            }
+        }
+        // Policy section
+        if (currentSection === "policy" ||
+            currentSection === "byCommand" ||
+            currentSection === "fallback") {
+            if (trimmed.startsWith("default:")) {
+                config.policy.default = trimmed
+                    .replace("default:", "")
+                    .trim()
+                    .replace(/['"]/g, "");
+                currentSection = "policy";
+            }
+            else if (trimmed === "by_command:" || trimmed === "byCommand:") {
+                currentSection = "byCommand";
+            }
+            else if (trimmed === "fallback_chain:" ||
+                trimmed === "fallbackChain:") {
+                currentSection = "fallback";
+                config.policy.fallbackChain = []; // Reset default before parsing
+            }
+            else if (currentSection === "byCommand" && trimmed.match(/^\w+:/)) {
+                const [key, ...rest] = trimmed.split(":");
+                config.policy.byCommand[key.trim()] = rest
+                    .join(":")
+                    .trim()
+                    .replace(/['"]/g, "");
+            }
+            else if (currentSection === "fallback") {
+                if (trimmed.startsWith("[")) {
+                    config.policy.fallbackChain = parseInlineArray(trimmed);
+                }
+                else if (trimmed.startsWith("-")) {
+                    config.policy.fallbackChain.push(trimmed.replace(/^-\s*/, "").replace(/['"]/g, ""));
+                }
+            }
+        }
+    }
+    // Flush last agent
+    if (currentAgent?.id) {
+        config.agents.push(finalizeAgent(currentAgent));
+    }
+    return config;
+}
+function parseInlineArray(s) {
+    const cleaned = s.replace(/[\[\]]/g, "").trim();
+    if (!cleaned)
+        return [];
+    return cleaned
+        .split(",")
+        .map((x) => x.trim().replace(/['"]/g, ""))
+        .filter(Boolean);
+}
+function finalizeAgent(partial) {
+    return {
+        id: partial.id ?? "unknown",
+        kind: partial.kind ?? partial.id ?? "unknown",
+        version: partial.version,
+        installCheck: partial.installCheck,
+        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)) {
+            errors.push({
+                field: `agents.${agent.id}`,
+                message: `Duplicate agent id "${agent.id}".`,
+            });
+        }
+        seen.add(agent.id);
+        // Kind maps to a known adapter
+        if (!getAgentByKind(agent.kind)) {
+            errors.push({
+                field: `agents.${agent.id}.kind`,
+                message: `Unknown agent kind "${agent.kind}".`,
+            });
+        }
+    }
+    // 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({
+                field: `policy.by_command.${cmd}`,
+                message: `Agent "${agentId}" is not in agents[].`,
+            });
+        }
+    }
+    // fallback_chain values reference valid agents
+    for (const agentId of config.policy.fallbackChain) {
+        if (!agentIds.has(agentId)) {
+            errors.push({
+                field: "policy.fallback_chain",
+                message: `Agent "${agentId}" in fallback_chain is not in agents[].`,
+            });
+        }
+    }
+    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");
+    lines.push("# Gerado automaticamente pelo 'raptor init'. Edite conforme necessário.");
+    lines.push("");
+    lines.push("schema: raptor.agents/v1");
+    lines.push("");
+    lines.push("agents:");
+    for (const agent of agents) {
+        lines.push(`  - id: ${agent.id}`);
+        lines.push(`    kind: ${agent.kind}`);
+        lines.push(`    capabilities: [${agent.capabilities.join(", ")}]`);
+    }
+    const defaultAgent = agents[0]?.id ?? "human";
+    lines.push("");
+    lines.push("policy:");
+    lines.push(`  default: ${defaultAgent}`);
+    lines.push("  by_command:");
+    lines.push(`    new: ${defaultAgent}`);
+    lines.push(`    plan: ${defaultAgent}`);
+    lines.push(`    tasks: ${defaultAgent}`);
+    lines.push(`    implement: ${defaultAgent}`);
+    lines.push("  fallback_chain:");
+    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/config.js.map

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

package/dist/_core/dist/agents/context-file.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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".
+ */
+/**
+ * Generate the standard Raptor context block content.
+ */
+export declare function buildContextBlock(opts: {
+    projectName: string;
+    preset?: string;
+    constitutionArticles?: string[];
+}): string;
+/**
+ * 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 declare function upsertContextFile(filePath: string, content: string): void;
+/**
+ * Remove the Raptor block from a context file.
+ * Preserves all content outside the markers.
+ */
+export declare function removeContextBlock(filePath: string): boolean;
+/**
+ * Check if a context file contains the Raptor block.
+ */
+export declare function hasContextBlock(filePath: string): boolean;
+//# sourceMappingURL=context-file.d.ts.map

package/dist/_core/dist/agents/context-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-file.d.ts","sourceRoot":"","sources":["../../src/agents/context-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,GAAG,MAAM,CAsCT;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAwBzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzD"}

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

@@ -0,0 +1,106 @@
+/**
+ * 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");
+    lines.push(`This project (**${opts.projectName}**) is governed by the Raptor (SDD) framework.`);
+    lines.push("");
+    lines.push("## Core Principles\n");
+    lines.push("1. **Specification is the source of truth** — no code without an approved spec (C1).");
+    lines.push("2. **Forensic traceability** — every transformation is audited with SHA-256 hashes (C2).");
+    lines.push("3. **Justified decisions** — every technical decision cites a constitutional article (C3).");
+    lines.push("4. **Constitutional integrity** — CORE block is immutable with verified hash (C4).");
+    lines.push("5. **Human in the loop** — critical gates require human approval (C5).");
+    if (opts.preset) {
+        lines.push(`\n## Active preset: ${opts.preset}\n`);
+    }
+    if (opts.constitutionArticles && opts.constitutionArticles.length > 0) {
+        lines.push(`\n## Applicable articles\n`);
+        lines.push(`- ${opts.constitutionArticles.join(", ")}`);
+    }
+    lines.push("\n## Raptor Commands (slash commands)\n");
+    lines.push("- `/raptor-new` — create a new feature spec");
+    lines.push("- `/raptor-clarify` — detect and resolve [NEEDS CLARIFICATION] in spec");
+    lines.push("- `/raptor-plan` — generate plan.md from an approved spec");
+    lines.push("- `/raptor-checklist` — generate or validate thematic checklists (security, a11y, etc.)");
+    lines.push("- `/raptor-tasks` — decompose plan into executable tasks");
+    lines.push("- `/raptor-analyze` — cross-artifact analysis spec↔plan↔tasks (drift, coverage, M7)");
+    lines.push("- `/raptor-implement` — implement tasks with audit trail");
+    lines.push("\n## Rules for the agent\n");
+    lines.push("- **DO NOT** edit `.raptor/audit.jsonl` — it is append-only managed by Raptor.");
+    lines.push("- **DO NOT** edit `.raptor/constitution.md` in the RAPTOR-CORE block.");
+    lines.push("- **DO NOT** skip phases — each phase has gates that must be satisfied.");
+    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)) {
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, block + "\n");
+        return;
+    }
+    const existing = readFileSync(filePath, "utf8");
+    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;
+    const existing = readFileSync(filePath, "utf8");
+    const startIdx = existing.indexOf(MARKER_START);
+    const endIdx = existing.indexOf(MARKER_END);
+    if (startIdx === -1 || endIdx === -1)
+        return false;
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + MARKER_END.length);
+    const cleaned = (before + after).replace(/\n{3,}/g, "\n\n").trim();
+    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