raptor-aios 0.1.0

package/dist/_core/dist/prompts/renderer.js

@@ -0,0 +1,179 @@
+/**
+ * Prompt Renderer — Resolves placeholders in Raptor prompt templates.
+ *
+ * Handles the canonical placeholder vocabulary:
+ *   - `$ARGUMENTS`       → User-supplied arguments
+ *   - `{SCRIPT}`         → Resolved script path from frontmatter
+ *   - `{ARGS}`           → User arguments (alias for $ARGUMENTS in script context)
+ *   - `__CONTEXT_FILE__`  → Path to the agent's context file (e.g., CLAUDE.md)
+ *   - `<FEATURE_DIR>`    → Active feature directory from feature.json
+ *   - `<FEATURE_NAME>`   → Feature name extracted from directory
+ *   - `<PROJECT_NAME>`   → Project name from manifest
+ *
+ * Spec Kit ref: E07 — "Renderer de placeholders"
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Placeholder resolution
+// ---------------------------------------------------------------------------
+/**
+ * Built-in placeholder map derived from a RenderContext.
+ */
+function buildPlaceholderMap(ctx) {
+    const map = new Map();
+    if (ctx.arguments !== undefined) {
+        map.set("$ARGUMENTS", ctx.arguments);
+        map.set("{ARGS}", ctx.arguments);
+    }
+    if (ctx.scriptPath !== undefined) {
+        map.set("{SCRIPT}", ctx.scriptPath);
+    }
+    if (ctx.contextFile !== undefined) {
+        map.set("__CONTEXT_FILE__", ctx.contextFile);
+    }
+    if (ctx.featureDirectory !== undefined) {
+        map.set("<FEATURE_DIR>", ctx.featureDirectory);
+    }
+    if (ctx.featureName !== undefined) {
+        map.set("<FEATURE_NAME>", ctx.featureName);
+    }
+    if (ctx.projectName !== undefined) {
+        map.set("<PROJECT_NAME>", ctx.projectName);
+    }
+    // Merge custom placeholders
+    if (ctx.custom) {
+        for (const [key, value] of Object.entries(ctx.custom)) {
+            map.set(key, value);
+        }
+    }
+    return map;
+}
+/**
+ * Render a prompt template by replacing all known placeholders.
+ *
+ * @param template - Raw prompt markdown content.
+ * @param ctx      - Rendering context with values for each placeholder.
+ * @returns        - Rendered prompt with placeholders replaced.
+ */
+export function renderPrompt(template, ctx) {
+    const map = buildPlaceholderMap(ctx);
+    let result = template;
+    for (const [placeholder, value] of map) {
+        // Use split+join for global replacement (no regex needed)
+        result = result.split(placeholder).join(value);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Auto-resolution from project state
+// ---------------------------------------------------------------------------
+/**
+ * Auto-resolve a RenderContext by reading project state files.
+ *
+ * Reads:
+ *   - `.raptor/feature.json`    → featureDirectory, featureName
+ *   - `.raptor/raptor.manifest.json` → projectName
+ *   - Frontmatter `scripts.sh`  → scriptPath
+ *
+ * @param projectRoot - Absolute path to the project root.
+ * @param overrides   - Explicit values that override auto-detected ones.
+ */
+export function autoResolveContext(projectRoot, overrides) {
+    const ctx = {
+        projectRoot,
+        ...overrides,
+    };
+    const raptorDir = join(projectRoot, ".raptor");
+    // Feature state
+    if (!ctx.featureDirectory) {
+        // 1. Check env var
+        const envFeature = process.env.RAPTOR_FEATURE_DIRECTORY;
+        if (envFeature) {
+            ctx.featureDirectory = envFeature;
+            ctx.featureName = envFeature.split("/").pop() ?? envFeature;
+        }
+        else {
+            // 2. Check feature.json
+            const featureJsonPath = join(raptorDir, "feature.json");
+            if (existsSync(featureJsonPath)) {
+                try {
+                    const featureState = JSON.parse(readFileSync(featureJsonPath, "utf-8"));
+                    ctx.featureDirectory = featureState.feature_directory;
+                    ctx.featureName =
+                        featureState.feature_name ??
+                            featureState.feature_directory?.split("/").pop();
+                }
+                catch {
+                    // ignore parse errors
+                }
+            }
+        }
+    }
+    // Project name from manifest
+    if (!ctx.projectName) {
+        const manifestPath = join(raptorDir, "raptor.manifest.json");
+        if (existsSync(manifestPath)) {
+            try {
+                const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+                ctx.projectName = manifest.project_name;
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    return ctx;
+}
+// ---------------------------------------------------------------------------
+// Frontmatter parser (lightweight)
+// ---------------------------------------------------------------------------
+/**
+ * Extract frontmatter and body from a prompt template.
+ *
+ * Returns the frontmatter as a raw key-value map and the body content.
+ * This is intentionally lightweight — does NOT depend on a YAML parser.
+ */
+export function parseFrontmatter(template) {
+    if (!template.startsWith("---\n") && !template.startsWith("---\r\n")) {
+        return { frontmatter: {}, body: template };
+    }
+    const endIdx = template.indexOf("\n---", 4);
+    if (endIdx === -1) {
+        return { frontmatter: {}, body: template };
+    }
+    const fmBlock = template.slice(4, endIdx);
+    const body = template.slice(endIdx + 4).trimStart();
+    const frontmatter = {};
+    for (const line of fmBlock.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const colonIdx = trimmed.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        let value = trimmed.slice(colonIdx + 1).trim();
+        // Remove surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        frontmatter[key] = value;
+    }
+    return { frontmatter, body };
+}
+/**
+ * Extract the script path from a prompt template's frontmatter.
+ *
+ * Handles nested YAML like:
+ * ```yaml
+ * scripts:
+ *   sh: scripts/bash/create-new-feature.sh --json
+ * ```
+ */
+export function extractScriptPath(template) {
+    const match = template.match(/scripts:\s*\n\s+sh:\s*(.+)/);
+    return match?.[1]?.trim();
+}
+//# sourceMappingURL=renderer.js.map

package/dist/_core/dist/prompts/renderer.js.map

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

package/dist/_core/dist/prompts/resumption.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Resumption Policy — Idempotent state transitions for Raptor SDD lifecycle.
+ *
+ * Ensures that re-running a command in the same phase produces the same result.
+ * Handles interrupted workflows by detecting partial state and resuming.
+ *
+ * Spec Kit ref: E07 — "Política de retomada/idempotência"
+ */
+import type { FeatureState } from "../state/feature.js";
+declare const PHASE_ORDER: readonly ["specify", "clarify", "plan", "tasks", "implement", "done"];
+type Phase = (typeof PHASE_ORDER)[number];
+/**
+ * Check if a phase transition is valid (forward-only).
+ */
+export declare function isValidTransition(current: Phase | undefined, target: Phase): boolean;
+/**
+ * Get the next expected phase in the SDD lifecycle.
+ */
+export declare function nextPhase(current: Phase): Phase | undefined;
+/**
+ * Read the current feature state from `.raptor/feature.json`.
+ */
+export declare function readFeatureState(projectRoot: string): FeatureState | undefined;
+/**
+ * Write the feature state atomically.
+ *
+ * Idempotent: writing the same state twice produces the same file.
+ * Validates phase transition before writing.
+ */
+export declare function writeFeatureState(projectRoot: string, update: Partial<FeatureState> & {
+    feature_directory: string;
+}, options?: {
+    force?: boolean;
+}): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Check which SDD artifacts exist for a feature.
+ *
+ * Used by `/rpt.implement` to determine where to resume.
+ */
+export declare function checkArtifactPresence(projectRoot: string, featureDirectory: string): {
+    hasSpec: boolean;
+    hasPlan: boolean;
+    hasTasks: boolean;
+    hasResearch: boolean;
+    hasDataModel: boolean;
+    hasChecklists: boolean;
+    missingForPhase: Record<Phase, string[]>;
+};
+/**
+ * Determine the resumable phase for a feature.
+ *
+ * Looks at which artifacts exist and returns the latest completed phase.
+ */
+export declare function determineResumablePhase(projectRoot: string, featureDirectory: string): Phase;
+export {};
+//# sourceMappingURL=resumption.d.ts.map

package/dist/_core/dist/prompts/resumption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumption.d.ts","sourceRoot":"","sources":["../../src/prompts/resumption.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,QAAA,MAAM,WAAW,uEAOP,CAAC;AAEX,KAAK,KAAK,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,GAAG,SAAS,EAC1B,MAAM,EAAE,KAAK,GACZ,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAI3D;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAClB,YAAY,GAAG,SAAS,CAQ1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAC7D,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCtC;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C,CAqCA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,KAAK,CAOP"}

package/dist/_core/dist/prompts/resumption.js

@@ -0,0 +1,149 @@
+/**
+ * Resumption Policy — Idempotent state transitions for Raptor SDD lifecycle.
+ *
+ * Ensures that re-running a command in the same phase produces the same result.
+ * Handles interrupted workflows by detecting partial state and resuming.
+ *
+ * Spec Kit ref: E07 — "Política de retomada/idempotência"
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Phase ordering
+// ---------------------------------------------------------------------------
+const PHASE_ORDER = [
+    "specify",
+    "clarify",
+    "plan",
+    "tasks",
+    "implement",
+    "done",
+];
+/**
+ * Check if a phase transition is valid (forward-only).
+ */
+export function isValidTransition(current, target) {
+    if (current === undefined)
+        return true; // first phase
+    const currentIdx = PHASE_ORDER.indexOf(current);
+    const targetIdx = PHASE_ORDER.indexOf(target);
+    if (currentIdx === -1 || targetIdx === -1)
+        return false;
+    // Allow same phase (idempotent) and forward transitions
+    return targetIdx >= currentIdx;
+}
+/**
+ * Get the next expected phase in the SDD lifecycle.
+ */
+export function nextPhase(current) {
+    const idx = PHASE_ORDER.indexOf(current);
+    if (idx === -1 || idx >= PHASE_ORDER.length - 1)
+        return undefined;
+    return PHASE_ORDER[idx + 1];
+}
+// ---------------------------------------------------------------------------
+// Feature state persistence
+// ---------------------------------------------------------------------------
+/**
+ * Read the current feature state from `.raptor/feature.json`.
+ */
+export function readFeatureState(projectRoot) {
+    const path = join(projectRoot, ".raptor", "feature.json");
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write the feature state atomically.
+ *
+ * Idempotent: writing the same state twice produces the same file.
+ * Validates phase transition before writing.
+ */
+export function writeFeatureState(projectRoot, update, options) {
+    const path = join(projectRoot, ".raptor", "feature.json");
+    const current = readFeatureState(projectRoot);
+    // Validate phase transition
+    if (update.current_phase &&
+        current?.current_phase &&
+        !options?.force) {
+        if (!isValidTransition(current.current_phase, update.current_phase)) {
+            return {
+                success: false,
+                error: `Invalid phase transition: ${current.current_phase} → ${update.current_phase}. Use --force to override.`,
+            };
+        }
+    }
+    const state = {
+        ...current,
+        ...update,
+        updated_at: new Date().toISOString(),
+    };
+    if (!state.started_at) {
+        state.started_at = state.updated_at;
+    }
+    writeFileSync(path, JSON.stringify(state, null, 2) + "\n");
+    return { success: true };
+}
+// ---------------------------------------------------------------------------
+// Artifact presence checks (for resumption)
+// ---------------------------------------------------------------------------
+/**
+ * Check which SDD artifacts exist for a feature.
+ *
+ * Used by `/rpt.implement` to determine where to resume.
+ */
+export function checkArtifactPresence(projectRoot, featureDirectory) {
+    const dir = join(projectRoot, featureDirectory);
+    const hasSpec = existsSync(join(dir, "spec.md"));
+    const hasPlan = existsSync(join(dir, "plan.md"));
+    const hasTasks = existsSync(join(dir, "tasks.md"));
+    const hasResearch = existsSync(join(dir, "research.md"));
+    const hasDataModel = existsSync(join(dir, "data-model.md"));
+    const hasChecklists = existsSync(join(dir, "checklists")) &&
+        existsSync(join(dir, "checklists", "requirements.md"));
+    const missingForPhase = {
+        specify: [],
+        clarify: hasSpec ? [] : ["spec.md"],
+        plan: hasSpec ? [] : ["spec.md"],
+        tasks: [
+            ...(hasSpec ? [] : ["spec.md"]),
+            ...(hasPlan ? [] : ["plan.md"]),
+        ],
+        implement: [
+            ...(hasSpec ? [] : ["spec.md"]),
+            ...(hasPlan ? [] : ["plan.md"]),
+            ...(hasTasks ? [] : ["tasks.md"]),
+        ],
+        done: [],
+    };
+    return {
+        hasSpec,
+        hasPlan,
+        hasTasks,
+        hasResearch,
+        hasDataModel,
+        hasChecklists,
+        missingForPhase,
+    };
+}
+/**
+ * Determine the resumable phase for a feature.
+ *
+ * Looks at which artifacts exist and returns the latest completed phase.
+ */
+export function determineResumablePhase(projectRoot, featureDirectory) {
+    const presence = checkArtifactPresence(projectRoot, featureDirectory);
+    if (presence.hasTasks)
+        return "tasks";
+    if (presence.hasPlan)
+        return "plan";
+    if (presence.hasSpec)
+        return "specify";
+    return "specify";
+}
+//# sourceMappingURL=resumption.js.map

package/dist/_core/dist/prompts/resumption.js.map

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

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

@@ -0,0 +1,27 @@
+/**
+ * Skills configuration — `.raptor/skills.yml` parser, validator, serializer.
+ *
+ * Mirrors the shape of `agents/config.ts` but uses the `yaml` dependency
+ * directly because skill prompts are frequently multi-line.
+ */
+import { type SkillsConfig } from "./types.js";
+export interface SkillConfigError {
+    skillId?: string;
+    field: string;
+    message: string;
+}
+/** Path to `.raptor/skills.yml` under a project root. */
+export declare function skillsConfigPath(projectRoot: string): string;
+/** Load and parse `.raptor/skills.yml`, or null if it doesn't exist. */
+export declare function loadSkillsConfig(projectRoot: string): SkillsConfig | null;
+/** Parse a skills.yml string into a SkillsConfig (always returns a config). */
+export declare function parseSkillsYaml(raw: string): SkillsConfig;
+/** Serialize a SkillsConfig to YAML for writing to disk. */
+export declare function generateSkillsYaml(config: SkillsConfig): string;
+/**
+ * Validate a SkillsConfig. Returns an array of errors (empty = valid).
+ * Checks: unique kebab-case ids, non-empty name/description, exactly one of
+ * prompt|promptFile, and agents ⊆ known agent keys.
+ */
+export declare function validateSkillsConfig(config: SkillsConfig): SkillConfigError[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/skills/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIzE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAOzD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE,CA4D7E"}

package/dist/_core/dist/skills/config.js

@@ -0,0 +1,102 @@
+/**
+ * Skills configuration — `.raptor/skills.yml` parser, validator, serializer.
+ *
+ * Mirrors the shape of `agents/config.ts` but uses the `yaml` dependency
+ * directly because skill prompts are frequently multi-line.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { ALL_AGENT_KEYS } from "../agents/keys.js";
+import { SKILLS_SCHEMA_V1 } from "./types.js";
+const KEBAB_RE = /^[a-z][a-z0-9-]*$/;
+/** Path to `.raptor/skills.yml` under a project root. */
+export function skillsConfigPath(projectRoot) {
+    return join(projectRoot, ".raptor", "skills.yml");
+}
+/** Load and parse `.raptor/skills.yml`, or null if it doesn't exist. */
+export function loadSkillsConfig(projectRoot) {
+    const path = skillsConfigPath(projectRoot);
+    if (!existsSync(path))
+        return null;
+    return parseSkillsYaml(readFileSync(path, "utf8"));
+}
+/** Parse a skills.yml string into a SkillsConfig (always returns a config). */
+export function parseSkillsYaml(raw) {
+    const doc = (parseYaml(raw) ?? {});
+    const skills = Array.isArray(doc.skills) ? doc.skills : [];
+    return {
+        schema: SKILLS_SCHEMA_V1,
+        skills,
+    };
+}
+/** Serialize a SkillsConfig to YAML for writing to disk. */
+export function generateSkillsYaml(config) {
+    const header = "# Raptor — Skills\n" +
+        "# Reusable agent capabilities materialized into each agent's native\n" +
+        "# skill/command format. Managed by 'raptor skill add|remove|sync'.\n\n";
+    return header + stringifyYaml({ schema: SKILLS_SCHEMA_V1, skills: config.skills });
+}
+/**
+ * Validate a SkillsConfig. Returns an array of errors (empty = valid).
+ * Checks: unique kebab-case ids, non-empty name/description, exactly one of
+ * prompt|promptFile, and agents ⊆ known agent keys.
+ */
+export function validateSkillsConfig(config) {
+    const errors = [];
+    if (config.schema !== SKILLS_SCHEMA_V1) {
+        errors.push({
+            field: "schema",
+            message: `expected "${SKILLS_SCHEMA_V1}", got "${config.schema}"`,
+        });
+    }
+    const seen = new Set();
+    for (const skill of config.skills) {
+        const id = skill.id ?? "(missing)";
+        if (!skill.id || !KEBAB_RE.test(skill.id)) {
+            errors.push({
+                skillId: id,
+                field: "id",
+                message: "must be kebab-case (lowercase letters, digits, hyphens)",
+            });
+        }
+        if (skill.id) {
+            if (seen.has(skill.id)) {
+                errors.push({ skillId: id, field: "id", message: "duplicate id" });
+            }
+            seen.add(skill.id);
+        }
+        if (!skill.name || !skill.name.trim()) {
+            errors.push({ skillId: id, field: "name", message: "name is required" });
+        }
+        if (!skill.description || !skill.description.trim()) {
+            errors.push({
+                skillId: id,
+                field: "description",
+                message: "description is required (agents use it to decide relevance)",
+            });
+        }
+        const hasInline = typeof skill.prompt === "string" && skill.prompt.length > 0;
+        const hasFile = typeof skill.promptFile === "string" && skill.promptFile.length > 0;
+        if (hasInline === hasFile) {
+            errors.push({
+                skillId: id,
+                field: "prompt",
+                message: "exactly one of `prompt` or `promptFile` must be set",
+            });
+        }
+        if (skill.agents) {
+            for (const a of skill.agents) {
+                if (!ALL_AGENT_KEYS.includes(a)) {
+                    errors.push({
+                        skillId: id,
+                        field: "agents",
+                        message: `unknown agent key "${a}"`,
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=config.js.map

package/dist/_core/dist/skills/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/skills/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAiC,MAAM,YAAY,CAAC;AAE7E,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAQrC,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;IAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,MAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO;QACL,MAAM,EAAE,gBAAgB;QACxB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,MAAM,GACV,qBAAqB;QACrB,uEAAuE;QACvE,wEAAwE,CAAC;IAC3E,OAAO,MAAM,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,aAAa,gBAAgB,WAAW,MAAM,CAAC,MAAM,GAAG;SAClE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,yDAAyD;aACnE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,6DAA6D;aACvE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9E,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtE,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,qDAAqD;aAC/D,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,KAAK,EAAE,QAAQ;wBACf,OAAO,EAAE,sBAAsB,CAAC,GAAG;qBACpC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/_core/dist/skills/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Skills subsystem — public surface.
+ */
+export { SKILLS_SCHEMA_V1 } from "./types.js";
+export type { Skill, SkillsConfig } from "./types.js";
+export { skillsConfigPath, loadSkillsConfig, parseSkillsYaml, generateSkillsYaml, validateSkillsConfig, type SkillConfigError, } from "./config.js";
+export { skillsDir, discoverSkills, resolveSkillPrompt } from "./registry.js";
+export { type MaterializedSkill, skillTargetPath, buildSkillContent, materializeSkill, materializeSkills, removeMaterializedSkill, } from "./materializer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/_core/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EACL,KAAK,iBAAiB,EACtB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/skills/index.js

@@ -0,0 +1,8 @@
+/**
+ * Skills subsystem — public surface.
+ */
+export { SKILLS_SCHEMA_V1 } from "./types.js";
+export { skillsConfigPath, loadSkillsConfig, parseSkillsYaml, generateSkillsYaml, validateSkillsConfig, } from "./config.js";
+export { skillsDir, discoverSkills, resolveSkillPrompt } from "./registry.js";
+export { skillTargetPath, buildSkillContent, materializeSkill, materializeSkills, removeMaterializedSkill, } from "./materializer.js";
+//# sourceMappingURL=index.js.map

package/dist/_core/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAEL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/skills/materializer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Skills materializer — writes each skill into each target agent's native
+ * skill/command location.
+ *
+ * Agents that expose a native skill directory (`adapter.skillDir`, e.g. Claude
+ * Code's `.claude/skills`) get a `SKILL.md`; agents without one degrade
+ * gracefully to a `raptor-skill-<id>` command file in their command dir.
+ */
+import type { AgentAdapter } from "../agents/types.js";
+import type { Skill } from "./types.js";
+export interface MaterializedSkill {
+    skillId: string;
+    agentId: string;
+    path: string;
+    hash: string;
+}
+/**
+ * Resolve the path where `skillId` should be written for a given adapter.
+ * Native skill dir when available, otherwise a degraded command file.
+ */
+export declare function skillTargetPath(projectRoot: string, adapter: AgentAdapter, skillId: string): string;
+/** Build the on-disk content for a skill (frontmatter + prompt body). */
+export declare function buildSkillContent(skill: Skill, prompt: string): string;
+/**
+ * Materialize a single skill into every target adapter. The `human` adapter
+ * (no command dir) is skipped.
+ */
+export declare function materializeSkill(opts: {
+    projectRoot: string;
+    skill: Skill;
+    adapters: AgentAdapter[];
+}): MaterializedSkill[];
+/** Materialize every skill into every target adapter. */
+export declare function materializeSkills(opts: {
+    projectRoot: string;
+    skills: Skill[];
+    adapters: AgentAdapter[];
+}): MaterializedSkill[];
+/** Remove a skill's materialized files from every target adapter. */
+export declare function removeMaterializedSkill(opts: {
+    projectRoot: string;
+    skill: Skill;
+    adapters: AgentAdapter[];
+}): string[];
+//# sourceMappingURL=materializer.d.ts.map

package/dist/_core/dist/skills/materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.d.ts","sourceRoot":"","sources":["../../src/skills/materializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GACd,MAAM,CAUR;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAStE;AAaD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,GAAG,iBAAiB,EAAE,CAoBtB;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,GAAG,iBAAiB,EAAE,CAQtB;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,GAAG,MAAM,EAAE,CAiBX"}