raptor-aios 0.1.0

package/dist/_core/dist/skills/materializer.js

@@ -0,0 +1,97 @@
+/**
+ * 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 { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { hashString } from "../audit/hash.js";
+import { resolveSkillPrompt } from "./registry.js";
+/**
+ * Resolve the path where `skillId` should be written for a given adapter.
+ * Native skill dir when available, otherwise a degraded command file.
+ */
+export function skillTargetPath(projectRoot, adapter, skillId) {
+    if (adapter.skillDir && adapter.skillFileName) {
+        return join(projectRoot, adapter.skillDir, adapter.skillFileName(skillId));
+    }
+    // Fallback: a prefixed command file so it never collides with SDD commands.
+    return join(projectRoot, adapter.commandDir, `raptor-skill-${skillId}${adapter.commandExt}`);
+}
+/** Build the on-disk content for a skill (frontmatter + prompt body). */
+export function buildSkillContent(skill, prompt) {
+    const fm = [
+        "---",
+        `name: ${skill.id}`,
+        `description: ${JSON.stringify(skill.description)}`,
+        "---",
+        "",
+    ].join("\n");
+    return `${fm}# ${skill.name}\n\n${prompt.trim()}\n`;
+}
+/**
+ * Which adapters a skill targets: its `agents` list (filtered to the supplied
+ * adapters) or all supplied adapters when `agents` is omitted/empty.
+ */
+function targetsFor(skill, adapters) {
+    if (skill.agents && skill.agents.length > 0) {
+        return adapters.filter((a) => skill.agents.includes(a.id));
+    }
+    return adapters;
+}
+/**
+ * Materialize a single skill into every target adapter. The `human` adapter
+ * (no command dir) is skipped.
+ */
+export function materializeSkill(opts) {
+    const { projectRoot, skill, adapters } = opts;
+    const prompt = resolveSkillPrompt(skill, projectRoot);
+    const content = buildSkillContent(skill, prompt);
+    const out = [];
+    for (const adapter of targetsFor(skill, adapters)) {
+        if (adapter.id === "human")
+            continue;
+        const path = skillTargetPath(projectRoot, adapter, skill.id);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+        out.push({
+            skillId: skill.id,
+            agentId: adapter.id,
+            path,
+            hash: hashString(content),
+        });
+    }
+    return out;
+}
+/** Materialize every skill into every target adapter. */
+export function materializeSkills(opts) {
+    return opts.skills.flatMap((skill) => materializeSkill({
+        projectRoot: opts.projectRoot,
+        skill,
+        adapters: opts.adapters,
+    }));
+}
+/** Remove a skill's materialized files from every target adapter. */
+export function removeMaterializedSkill(opts) {
+    const { projectRoot, skill, adapters } = opts;
+    const removed = [];
+    for (const adapter of targetsFor(skill, adapters)) {
+        if (adapter.id === "human")
+            continue;
+        const path = skillTargetPath(projectRoot, adapter, skill.id);
+        // For native skill dirs the SKILL.md lives in its own folder — remove that.
+        const target = adapter.skillDir && adapter.skillFileName ? dirname(path) : path;
+        try {
+            rmSync(target, { recursive: true, force: true });
+            removed.push(target);
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=materializer.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Skills registry — discovery and prompt resolution.
+ */
+import type { Skill } from "./types.js";
+/** Directory holding skill prompt files referenced by `promptFile`. */
+export declare function skillsDir(projectRoot: string): string;
+/**
+ * Discover all skills declared in `.raptor/skills.yml`.
+ * Returns an empty array when no config exists.
+ */
+export declare function discoverSkills(projectRoot: string): Skill[];
+/**
+ * Resolve a skill's prompt body — inline `prompt` or the contents of
+ * `promptFile` (relative to `.raptor/skills/`). Throws if `promptFile`
+ * is declared but missing.
+ */
+export declare function resolveSkillPrompt(skill: Skill, projectRoot: string): string;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAc5E"}

package/dist/_core/dist/skills/registry.js

@@ -0,0 +1,36 @@
+/**
+ * Skills registry — discovery and prompt resolution.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadSkillsConfig } from "./config.js";
+/** Directory holding skill prompt files referenced by `promptFile`. */
+export function skillsDir(projectRoot) {
+    return join(projectRoot, ".raptor", "skills");
+}
+/**
+ * Discover all skills declared in `.raptor/skills.yml`.
+ * Returns an empty array when no config exists.
+ */
+export function discoverSkills(projectRoot) {
+    return loadSkillsConfig(projectRoot)?.skills ?? [];
+}
+/**
+ * Resolve a skill's prompt body — inline `prompt` or the contents of
+ * `promptFile` (relative to `.raptor/skills/`). Throws if `promptFile`
+ * is declared but missing.
+ */
+export function resolveSkillPrompt(skill, projectRoot) {
+    if (typeof skill.prompt === "string" && skill.prompt.length > 0) {
+        return skill.prompt;
+    }
+    if (skill.promptFile) {
+        const path = join(skillsDir(projectRoot), skill.promptFile);
+        if (!existsSync(path)) {
+            throw new Error(`skill "${skill.id}": promptFile not found at ${path}`);
+        }
+        return readFileSync(path, "utf8");
+    }
+    throw new Error(`skill "${skill.id}": neither prompt nor promptFile is set`);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,WAAmB;IAClE,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,CAAC,EAAE,8BAA8B,IAAI,EAAE,CACvD,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,yCAAyC,CAAC,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Skills — first-class, reusable agent capabilities materialized into each
+ * agent's native skill/command format.
+ *
+ * A Skill is a named, described prompt fragment that Raptor can install into
+ * one or more agents (e.g. Claude Code's `.claude/skills/<id>/SKILL.md`). It
+ * complements the SDD slash commands: those drive the lifecycle, skills add
+ * project-specific reusable capabilities.
+ *
+ * Schema: raptor.skills/v1.
+ */
+export declare const SKILLS_SCHEMA_V1: "raptor.skills/v1";
+export interface Skill {
+    /** Unique kebab-case identifier (e.g. "review-pr"). */
+    id: string;
+    /** Human-friendly name. */
+    name: string;
+    /** One-line description — used by agents to decide relevance. */
+    description: string;
+    /** Inline prompt body. Mutually exclusive with `promptFile`. */
+    prompt?: string;
+    /**
+     * Path to a markdown file holding the prompt body, relative to
+     * `.raptor/skills/`. Mutually exclusive with `prompt`.
+     */
+    promptFile?: string;
+    /**
+     * Agent keys this skill targets. Omit/empty = all configured agents.
+     * Each entry must be a known agent key.
+     */
+    agents?: string[];
+    /** Free-form tags for organization. */
+    tags?: string[];
+}
+export interface SkillsConfig {
+    schema: typeof SKILLS_SCHEMA_V1;
+    skills: Skill[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,MAAM,WAAW,KAAK;IACpB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,gBAAgB,CAAC;IAChC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}

package/dist/_core/dist/skills/types.js

@@ -0,0 +1,13 @@
+/**
+ * Skills — first-class, reusable agent capabilities materialized into each
+ * agent's native skill/command format.
+ *
+ * A Skill is a named, described prompt fragment that Raptor can install into
+ * one or more agents (e.g. Claude Code's `.claude/skills/<id>/SKILL.md`). It
+ * complements the SDD slash commands: those drive the lifecycle, skills add
+ * project-specific reusable capabilities.
+ *
+ * Schema: raptor.skills/v1.
+ */
+export const SKILLS_SCHEMA_V1 = "raptor.skills/v1";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAA2B,CAAC"}

package/dist/_core/dist/state/feature.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Feature State — Schema and validation for `.raptor/feature.json`.
+ *
+ * Tracks the currently active feature in a project. This file is written
+ * by scripts (create-new-feature.sh) and read by prompts (check-prerequisites.sh).
+ *
+ * Spec Kit ref: E06 — ".raptor/feature.json com schema e validador"
+ */
+export declare const FEATURE_PHASES: readonly ["specify", "clarify", "plan", "tasks", "implement", "done"];
+export declare const FEATURE_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "raptor.feature/v1";
+    readonly title: "Raptor Feature State";
+    readonly description: "Tracks the currently active feature in a Raptor project.";
+    readonly type: "object";
+    readonly required: readonly ["feature_directory"];
+    readonly properties: {
+        readonly feature_directory: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Relative path to the active feature directory (e.g. 'specs/003-user-auth').";
+        };
+        readonly feature_name: {
+            readonly type: "string";
+            readonly description: "Feature display name (extracted from directory).";
+        };
+        readonly current_phase: {
+            readonly type: "string";
+            readonly enum: readonly ["specify", "clarify", "plan", "tasks", "implement", "done"];
+            readonly description: "Current SDD phase.";
+        };
+        readonly started_at: {
+            readonly type: "string";
+            readonly description: "ISO 8601 timestamp of when the feature was started.";
+        };
+        readonly updated_at: {
+            readonly type: "string";
+            readonly description: "ISO 8601 timestamp of last state update.";
+        };
+    };
+    readonly additionalProperties: false;
+};
+export interface FeatureState {
+    feature_directory: string;
+    feature_name?: string;
+    current_phase?: (typeof FEATURE_PHASES)[number];
+    started_at?: string;
+    updated_at?: string;
+}
+export declare function validateFeatureState(data: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Create a new feature state.
+ */
+export declare function createFeatureState(featureDirectory: string, phase?: FeatureState["current_phase"]): FeatureState;
+//# sourceMappingURL=feature.d.ts.map

package/dist/_core/dist/state/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/state/feature.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,eAAO,MAAM,cAAc,uEAOjB,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCtB,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CASA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,GACpC,YAAY,CAQd"}

package/dist/_core/dist/state/feature.js

@@ -0,0 +1,81 @@
+/**
+ * Feature State — Schema and validation for `.raptor/feature.json`.
+ *
+ * Tracks the currently active feature in a project. This file is written
+ * by scripts (create-new-feature.sh) and read by prompts (check-prerequisites.sh).
+ *
+ * Spec Kit ref: E06 — ".raptor/feature.json com schema e validador"
+ */
+import Ajv from "ajv";
+// ---------------------------------------------------------------------------
+// JSON Schema (Draft-07)
+// ---------------------------------------------------------------------------
+export const FEATURE_PHASES = [
+    "specify",
+    "clarify",
+    "plan",
+    "tasks",
+    "implement",
+    "done",
+];
+export const FEATURE_JSON_SCHEMA = {
+    $schema: "http://json-schema.org/draft-07/schema#",
+    $id: "raptor.feature/v1",
+    title: "Raptor Feature State",
+    description: "Tracks the currently active feature in a Raptor project.",
+    type: "object",
+    required: ["feature_directory"],
+    properties: {
+        feature_directory: {
+            type: "string",
+            minLength: 1,
+            description: "Relative path to the active feature directory (e.g. 'specs/003-user-auth').",
+        },
+        feature_name: {
+            type: "string",
+            description: "Feature display name (extracted from directory).",
+        },
+        current_phase: {
+            type: "string",
+            enum: FEATURE_PHASES,
+            description: "Current SDD phase.",
+        },
+        started_at: {
+            type: "string",
+            description: "ISO 8601 timestamp of when the feature was started.",
+        },
+        updated_at: {
+            type: "string",
+            description: "ISO 8601 timestamp of last state update.",
+        },
+    },
+    additionalProperties: false,
+};
+// ---------------------------------------------------------------------------
+// Validator
+// ---------------------------------------------------------------------------
+const ajv = new Ajv.default({ allErrors: true });
+const validateFn = ajv.compile(FEATURE_JSON_SCHEMA);
+export function validateFeatureState(data) {
+    const valid = validateFn(data);
+    if (valid)
+        return { valid: true, errors: [] };
+    const errors = (validateFn.errors ?? []).map((e) => {
+        const path = e.instancePath || "(root)";
+        return `${path}: ${e.message ?? "unknown error"}`;
+    });
+    return { valid: false, errors };
+}
+/**
+ * Create a new feature state.
+ */
+export function createFeatureState(featureDirectory, phase) {
+    return {
+        feature_directory: featureDirectory,
+        feature_name: featureDirectory.split("/").pop() ?? featureDirectory,
+        current_phase: phase ?? "specify",
+        started_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=feature.js.map

package/dist/_core/dist/state/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../src/state/feature.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAyB,MAAM,KAAK,CAAC;AAE5C,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;IACP,WAAW;IACX,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,yCAAyC;IAClD,GAAG,EAAE,mBAAmB;IACxB,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,0DAA0D;IACvE,IAAI,EAAE,QAAiB;IACvB,QAAQ,EAAE,CAAC,mBAAmB,CAAC;IAC/B,UAAU,EAAE;QACV,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAiB;YACvB,SAAS,EAAE,CAAC;YACZ,WAAW,EACT,6EAA6E;SAChF;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,kDAAkD;SAChE;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,oBAAoB;SAClC;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,qDAAqD;SACnE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,0CAA0C;SACxD;KACF;IACD,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAcX,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAIhD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAY,CAAC;IAC1C,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC;QACxC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,gBAAwB,EACxB,KAAqC;IAErC,OAAO;QACL,iBAAiB,EAAE,gBAAgB;QACnC,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,gBAAgB;QACnE,aAAa,EAAE,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * @raptor/core state module — Feature state and init options schemas.
+ */
+export { createFeatureState, validateFeatureState, FEATURE_JSON_SCHEMA, FEATURE_PHASES, } from "./feature.js";
+export type { FeatureState } from "./feature.js";
+export { validateInitOptions, INIT_OPTIONS_JSON_SCHEMA, } from "./init-options.js";
+export type { InitOptions } from "./init-options.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/state/index.js

@@ -0,0 +1,6 @@
+/**
+ * @raptor/core state module — Feature state and init options schemas.
+ */
+export { createFeatureState, validateFeatureState, FEATURE_JSON_SCHEMA, FEATURE_PHASES, } from "./feature.js";
+export { validateInitOptions, INIT_OPTIONS_JSON_SCHEMA, } from "./init-options.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/state/init-options.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Init Options — Schema and validation for `.raptor/init-options.json`.
+ *
+ * Persists the choices made during `raptor init` so scripts and prompts
+ * can resolve project-wide settings without re-reading flags.
+ *
+ * Spec Kit ref: E06 — ".raptor/init-options.json com schema e validador"
+ */
+export declare const INIT_OPTIONS_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "raptor.init-options/v1";
+    readonly title: "Raptor Init Options";
+    readonly description: "Choices made during `raptor init`, persisted for downstream scripts.";
+    readonly type: "object";
+    readonly required: readonly ["ai", "script_type", "branch_numbering", "preset", "no_git", "created_at"];
+    readonly properties: {
+        readonly ai: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Primary AI agent integration key.";
+        };
+        readonly script_type: {
+            readonly type: "string";
+            readonly enum: readonly ["sh"];
+            readonly description: "Shell script type used. V1 supports 'sh' only.";
+        };
+        readonly branch_numbering: {
+            readonly type: "string";
+            readonly enum: readonly ["sequential", "timestamp"];
+            readonly description: "Branch numbering strategy.";
+        };
+        readonly preset: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Active preset ID.";
+        };
+        readonly no_git: {
+            readonly type: "boolean";
+            readonly description: "Whether git operations are disabled.";
+        };
+        readonly created_at: {
+            readonly type: "string";
+            readonly description: "ISO 8601 timestamp of init.";
+        };
+    };
+    readonly additionalProperties: false;
+};
+export interface InitOptions {
+    ai: string;
+    script_type: "sh";
+    branch_numbering: "sequential" | "timestamp";
+    preset: string;
+    no_git: boolean;
+    created_at: string;
+}
+export declare function validateInitOptions(data: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=init-options.d.ts.map

package/dist/_core/dist/state/init-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-options.d.ts","sourceRoot":"","sources":["../../src/state/init-options.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C3B,CAAC;AAMX,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,IAAI,CAAC;IAClB,gBAAgB,EAAE,YAAY,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CASA"}

package/dist/_core/dist/state/init-options.js

@@ -0,0 +1,74 @@
+/**
+ * Init Options — Schema and validation for `.raptor/init-options.json`.
+ *
+ * Persists the choices made during `raptor init` so scripts and prompts
+ * can resolve project-wide settings without re-reading flags.
+ *
+ * Spec Kit ref: E06 — ".raptor/init-options.json com schema e validador"
+ */
+import Ajv from "ajv";
+// ---------------------------------------------------------------------------
+// JSON Schema (Draft-07)
+// ---------------------------------------------------------------------------
+export const INIT_OPTIONS_JSON_SCHEMA = {
+    $schema: "http://json-schema.org/draft-07/schema#",
+    $id: "raptor.init-options/v1",
+    title: "Raptor Init Options",
+    description: "Choices made during `raptor init`, persisted for downstream scripts.",
+    type: "object",
+    required: [
+        "ai",
+        "script_type",
+        "branch_numbering",
+        "preset",
+        "no_git",
+        "created_at",
+    ],
+    properties: {
+        ai: {
+            type: "string",
+            minLength: 1,
+            description: "Primary AI agent integration key.",
+        },
+        script_type: {
+            type: "string",
+            enum: ["sh"],
+            description: "Shell script type used. V1 supports 'sh' only.",
+        },
+        branch_numbering: {
+            type: "string",
+            enum: ["sequential", "timestamp"],
+            description: "Branch numbering strategy.",
+        },
+        preset: {
+            type: "string",
+            minLength: 1,
+            description: "Active preset ID.",
+        },
+        no_git: {
+            type: "boolean",
+            description: "Whether git operations are disabled.",
+        },
+        created_at: {
+            type: "string",
+            description: "ISO 8601 timestamp of init.",
+        },
+    },
+    additionalProperties: false,
+};
+// ---------------------------------------------------------------------------
+// Validator
+// ---------------------------------------------------------------------------
+const ajv = new Ajv.default({ allErrors: true });
+const validateFn = ajv.compile(INIT_OPTIONS_JSON_SCHEMA);
+export function validateInitOptions(data) {
+    const valid = validateFn(data);
+    if (valid)
+        return { valid: true, errors: [] };
+    const errors = (validateFn.errors ?? []).map((e) => {
+        const path = e.instancePath || "(root)";
+        return `${path}: ${e.message ?? "unknown error"}`;
+    });
+    return { valid: false, errors };
+}
+//# sourceMappingURL=init-options.js.map

package/dist/_core/dist/state/init-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-options.js","sourceRoot":"","sources":["../../src/state/init-options.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAyB,MAAM,KAAK,CAAC;AAE5C,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,yCAAyC;IAClD,GAAG,EAAE,wBAAwB;IAC7B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,sEAAsE;IACnF,IAAI,EAAE,QAAiB;IACvB,QAAQ,EAAE;QACR,IAAI;QACJ,aAAa;QACb,kBAAkB;QAClB,QAAQ;QACR,QAAQ;QACR,YAAY;KACb;IACD,UAAU,EAAE;QACV,EAAE,EAAE;YACF,IAAI,EAAE,QAAiB;YACvB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,mCAAmC;SACjD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,CAAC,IAAI,CAAC;YACZ,WAAW,EAAE,gDAAgD;SAC9D;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;YACjC,WAAW,EAAE,4BAA4B;SAC1C;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAiB;YACvB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,mBAAmB;SACjC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAkB;YACxB,WAAW,EAAE,sCAAsC;SACpD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,6BAA6B;SAC3C;KACF;IACD,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAeX,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAI/C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAY,CAAC;IAC1C,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC;QACxC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/_core/dist/template/engine.d.ts

@@ -0,0 +1,7 @@
+import { Context, Helper } from "./types.js";
+export interface RenderOptions {
+    helpers?: Record<string, Helper>;
+}
+export declare function render(source: string, ctx: Context, opts?: RenderOptions): string;
+export declare function compile(source: string): (ctx: Context, opts?: RenderOptions) => string;
+//# sourceMappingURL=engine.d.ts.map

package/dist/_core/dist/template/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/template/engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAO,OAAO,EAAQ,MAAM,EAAuB,MAAM,YAAY,CAAC;AAuE7E,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,MAAM,CACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,aAAkB,GACvB,MAAM,CAIR;AAED,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,GACb,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,MAAM,CAMhD"}

package/dist/_core/dist/template/engine.js

@@ -0,0 +1,86 @@
+import { parse } from "./parser.js";
+import { defaultHelpers, truthy } from "./helpers.js";
+import { TemplateError } from "./types.js";
+function resolvePath(ctx, path) {
+    if (path.length === 1) {
+        if (path[0] === "this")
+            return ctx["__this__"] ?? ctx;
+        if (path[0] === "@index")
+            return ctx["__index__"];
+        if (path[0] === "@first")
+            return ctx["__first__"];
+        if (path[0] === "@last")
+            return ctx["__last__"];
+    }
+    let cur = ctx;
+    for (const key of path) {
+        if (cur === null || cur === undefined)
+            return undefined;
+        if (typeof cur !== "object")
+            return undefined;
+        cur = cur[key];
+    }
+    return cur;
+}
+function evalArg(arg, ctx) {
+    if (arg.kind === "literal")
+        return arg.value;
+    return resolvePath(ctx, arg.path);
+}
+function evalExpr(expr, ctx, helpers) {
+    if (expr.kind === "var")
+        return resolvePath(ctx, expr.path);
+    const fn = helpers[expr.name];
+    if (!fn)
+        throw new TemplateError(`unknown helper: ${expr.name}`);
+    return fn(...expr.args.map((a) => evalArg(a, ctx)));
+}
+function renderNodes(nodes, ctx, helpers) {
+    let out = "";
+    for (const n of nodes) {
+        if (n.kind === "text") {
+            out += n.text;
+        }
+        else if (n.kind === "expr") {
+            const v = evalExpr(n.expr, ctx, helpers);
+            out += v === undefined || v === null ? "" : String(v);
+        }
+        else if (n.kind === "if") {
+            const v = evalExpr(n.cond, ctx, helpers);
+            out += renderNodes(truthy(v) ? n.then : n.else, ctx, helpers);
+        }
+        else if (n.kind === "each") {
+            const v = evalExpr(n.list, ctx, helpers);
+            if (!Array.isArray(v))
+                continue;
+            for (let i = 0; i < v.length; i++) {
+                const item = v[i];
+                const childCtx = {
+                    ...ctx,
+                    __this__: item,
+                    __index__: i,
+                    __first__: i === 0,
+                    __last__: i === v.length - 1,
+                    ...(typeof item === "object" && item !== null
+                        ? item
+                        : {}),
+                };
+                out += renderNodes(n.body, childCtx, helpers);
+            }
+        }
+    }
+    return out;
+}
+export function render(source, ctx, opts = {}) {
+    const ast = parse(source);
+    const helpers = { ...defaultHelpers, ...(opts.helpers ?? {}) };
+    return renderNodes(ast, ctx, helpers);
+}
+export function compile(source) {
+    const ast = parse(source);
+    return (ctx, opts = {}) => {
+        const helpers = { ...defaultHelpers, ...(opts.helpers ?? {}) };
+        return renderNodes(ast, ctx, helpers);
+    };
+}
+//# sourceMappingURL=engine.js.map