raptor-aios 0.1.0

package/dist/_core/dist/presets/mobile-opinionated.js

@@ -0,0 +1,78 @@
+import { MOBILE_GATES } from "./gates.js";
+const articles = [
+    {
+        id: "M1",
+        title: "App Store & Play Store Compliance",
+        statement: "Every feature that touches restricted OS APIs (camera, microphone, contacts, location, photos, notifications, biometrics, health, HomeKit, etc.) MUST declare the exact store-level permission strings and the corresponding `NSxxxUsageDescription` / Android manifest permission in its `spec.md` frontmatter under `stores:`.",
+        rationale: "App Store and Play Store rejections are the single largest source of mobile release delays and often surface only during submission review — after the code has been merged and the release train is in motion. Declaring permissions at spec time forces the conversation before engineering cost is sunk.",
+        enforcement: "`gate.mobile.stores` (level `required`) validates that `spec.stores.ios_permissions` and `spec.stores.android_permissions` are declared and non-empty whenever a feature targets mobile.",
+        violation: {
+            level: "required",
+            description: "Spec cannot be approved until the `stores:` frontmatter is populated. An ADR in `memory/decisions.md` MAY override with explicit justification (e.g., pure business logic with no platform API).",
+        },
+    },
+    {
+        id: "M2",
+        title: "Privacy & Data Residency (LGPD/GDPR)",
+        statement: "Every feature that collects, processes, stores, or transmits personal data MUST declare in `plan.md` frontmatter: (a) the lawful basis (LGPD Art. 7 / GDPR Art. 6), (b) the data residency region, and (c) the retention period — before any code is generated.",
+        rationale: "Privacy regulations impose fines that dwarf individual release budgets and require demonstrable prior analysis, not post-hoc justification. Encoding lawful basis and residency at plan time creates a defensible audit trail and forces engineering to talk to legal before implementation starts.",
+        enforcement: "`gate.mobile.privacy` (level `required`) reads `plan.privacy.{lawful_basis, residency, retention}` and fails the plan gate if any are missing.",
+        violation: {
+            level: "required",
+            description: "Plan cannot reach `status: approved` without all three fields. Override requires DPO (Data Protection Officer) sign-off recorded as an ADR.",
+        },
+    },
+    {
+        id: "M3",
+        title: "Accessibility Parity (WCAG AA)",
+        statement: "Every user-facing feature MUST declare accessibility acceptance criteria equivalent to WCAG 2.1 level AA — screen reader labels, contrast ratios, touch target minimums, dynamic type support, focus order. A11y criteria are first-class ACs, not a post-release backlog.",
+        rationale: "Retrofitting accessibility is 5–10× more expensive than building it in, and legal exposure is rising (ADA lawsuits, EN 301 549 in the EU). Treating a11y as part of AC rather than 'polish' eliminates the most common source of post-release a11y debt.",
+        enforcement: '`gate.mobile.a11y` (level `required`) validates `spec.a11y.wcag_level == "AA"` and that `spec.a11y.criteria` is non-empty. Features with no UI MAY declare `a11y.wcag_level: n/a` with a justification.',
+        violation: {
+            level: "required",
+            description: "Spec cannot reach `status: approved` without a11y criteria. Background-only features may opt out via `a11y.wcag_level: n/a` plus `a11y.justification`.",
+        },
+    },
+    {
+        id: "M4",
+        title: "OS Support Matrix",
+        statement: "Every feature MUST declare in `plan.md` the minimum iOS and Android versions it supports, and code generation MUST respect the project-wide `os_matrix` baseline declared in `raptor.yml`. Raising the floor is a governed act requiring a constitutional amendment.",
+        rationale: "OS fragmentation silently breaks users who run older versions, and ad-hoc per-feature decisions lead to inconsistent release behavior. A project-wide declared floor ensures every team decision about APIs and libraries is made against the same target surface.",
+        enforcement: "`gate.mobile.os_matrix` (level `required`) validates that `plan.os_matrix.{ios_min, android_min}` are set and are not lower than the values declared in `raptor.yml`.",
+        violation: {
+            level: "required",
+            description: "Plan cannot reach `status: approved` without these fields. Baseline changes require an entry in `amendments.log` with a `core_version` bump or a project-level extension amendment.",
+        },
+    },
+    {
+        id: "M5",
+        title: "Performance Budget",
+        statement: "Every feature that affects startup, navigation, or memory MUST declare a performance budget in its plan: TTFI (time to first interaction), key interaction latency, and memory ceiling. Performance regressions measured against these budgets block the feature's merge.",
+        rationale: "Mobile performance degrades by a thousand cuts. Without an explicit budget, each feature feels locally acceptable while the app as a whole becomes unusable. Declaring budgets per feature ensures the conversation happens at spec time, not in a war room.",
+        enforcement: "`gate.mobile.perf_budget` (level `required`) validates `plan.perf_budget.{ttfi_ms, interactions_ms}` are declared. Features with zero perf impact may set `perf_budget.scope: none`. Future: integration with automated perf tests via `raptor verify perf`.",
+        violation: {
+            level: "required",
+            description: "Plan cannot reach `status: approved` without these fields or a `scope: none` declaration with justification.",
+        },
+    },
+    {
+        id: "M6",
+        title: "Crash-Free SLO & Observability",
+        statement: "Every release phase MUST meet a crash-free-session SLO ≥ 99.5% measured over a 7-day rolling window, and every feature's plan MUST declare which observability signals (logs, traces, custom events) it emits and where they can be inspected.",
+        rationale: "Crash-free rate is the single number most correlated with retention on mobile, and observability is what turns a crash report into a fix. Tying SLO and observability together at the constitutional level makes 'ship it, we'll see' impossible as a default.",
+        enforcement: "`gate.mobile.crash_free` (level `advisory`) validates `plan.crash_free_slo ≥ 99.5` and that `plan.observability.provider` is declared. Release-time enforcement happens via the release gates (future: `gate.release.crash_free_window`).",
+        violation: {
+            level: "advisory",
+            description: "Warnings at plan time; no merge block. Release gates (post-implementation) enforce the SLO hard.",
+        },
+    },
+];
+export const mobileOpinionated = {
+    id: "mobile-opinionated",
+    name: "Mobile Opinionated",
+    version: "1.0.0-draft.1",
+    description: "M1–M6: stores compliance, privacy/LGPD, accessibility AA, OS matrix, performance budget, crash-free SLO",
+    articles,
+    gates: MOBILE_GATES,
+};
+//# sourceMappingURL=mobile-opinionated.js.map

package/dist/_core/dist/presets/mobile-opinionated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-opinionated.js","sourceRoot":"","sources":["../../src/presets/mobile-opinionated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,QAAQ,GAAoB;IAChC;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,mCAAmC;QAC1C,SAAS,EACP,kUAAkU;QACpU,SAAS,EACP,6SAA6S;QAC/S,WAAW,EACT,0LAA0L;QAC5L,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,kMAAkM;SACrM;KACF;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,sCAAsC;QAC7C,SAAS,EACP,iQAAiQ;QACnQ,SAAS,EACP,qSAAqS;QACvS,WAAW,EACT,gJAAgJ;QAClJ,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,6IAA6I;SAChJ;KACF;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,gCAAgC;QACvC,SAAS,EACP,4QAA4Q;QAC9Q,SAAS,EACP,0PAA0P;QAC5P,WAAW,EACT,yMAAyM;QAC3M,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,wJAAwJ;SAC3J;KACF;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,mBAAmB;QAC1B,SAAS,EACP,sQAAsQ;QACxQ,SAAS,EACP,oQAAoQ;QACtQ,WAAW,EACT,uKAAuK;QACzK,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,qLAAqL;SACxL;KACF;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EACP,2QAA2Q;QAC7Q,SAAS,EACP,8PAA8P;QAChQ,WAAW,EACT,8PAA8P;QAChQ,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,8GAA8G;SACjH;KACF;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,gCAAgC;QACvC,SAAS,EACP,gPAAgP;QAClP,SAAS,EACP,gQAAgQ;QAClQ,WAAW,EACT,2OAA2O;QAC7O,SAAS,EAAE;YACT,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,kGAAkG;SACrG;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAW;IACvC,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,eAAe;IACxB,WAAW,EACT,yGAAyG;IAC3G,QAAQ;IACR,KAAK,EAAE,YAAY;CACpB,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { Preset } from "./types.js";
+export declare function getPreset(id: string): Preset | undefined;
+export declare function listPresets(): Preset[];
+export declare function knownPresetIds(): string[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC"}

package/dist/_core/dist/presets/registry.js

@@ -0,0 +1,14 @@
+import { mobileOpinionated } from "./mobile-opinionated.js";
+const REGISTRY = {
+    [mobileOpinionated.id]: mobileOpinionated,
+};
+export function getPreset(id) {
+    return REGISTRY[id];
+}
+export function listPresets() {
+    return Object.values(REGISTRY);
+}
+export function knownPresetIds() {
+    return Object.keys(REGISTRY);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,QAAQ,GAA2B;IACvC,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,iBAAiB;CAC1C,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/_core/dist/presets/renderer.d.ts

@@ -0,0 +1,5 @@
+import type { Preset, PresetArticle } from "./types.js";
+export declare function renderPresetArticle(a: PresetArticle, presetId: string): string;
+export declare function renderPresetArticles(preset: Preset): string;
+export declare function renderPresetGatesForPlan(preset: Preset): string;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/_core/dist/presets/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/presets/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAYR;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/D"}

package/dist/_core/dist/presets/renderer.js

@@ -0,0 +1,37 @@
+export function renderPresetArticle(a, presetId) {
+    return `### ${a.id} — ${a.title}
+
+**Statement.** ${a.statement}
+
+**Rationale.** ${a.rationale}
+
+**Enforcement.** ${a.enforcement}
+
+**Violation Consequence.** \`${a.violation.level}\` — ${a.violation.description}
+
+*Source: preset \`${presetId}\`.*`;
+}
+export function renderPresetArticles(preset) {
+    return preset.articles
+        .map((a) => renderPresetArticle(a, preset.id))
+        .join("\n\n");
+}
+export function renderPresetGatesForPlan(preset) {
+    if (preset.gates.length === 0)
+        return "*(none)*";
+    const byArticle = new Map();
+    for (const a of preset.articles)
+        byArticle.set(a.id, a.title);
+    const blocks = preset.gates.map((g) => {
+        const art = g.article ?? "—";
+        const title = (g.article && byArticle.get(g.article)) ?? g.title;
+        return `#### Gate ${art} — ${title}
+
+- [ ] ${g.title}
+- Gate id: \`${g.id}\`
+- Level: \`${g.level}\`
+- Status: \`pending\` <!-- change to \`pass\` | \`violated\` -->`;
+    });
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=renderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/presets/renderer.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,CAAgB,EAChB,QAAgB;IAEhB,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK;;iBAEhB,CAAC,CAAC,SAAS;;iBAEX,CAAC,CAAC,SAAS;;mBAET,CAAC,CAAC,WAAW;;+BAED,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,SAAS,CAAC,WAAW;;oBAE3D,QAAQ,MAAM,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,CAAC,QAAQ;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7C,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;QAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;QAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;QACjE,OAAO,aAAa,GAAG,MAAM,KAAK;;QAE9B,CAAC,CAAC,KAAK;eACA,CAAC,CAAC,EAAE;aACN,CAAC,CAAC,KAAK;iEAC6C,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/_core/dist/presets/stacking.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Preset stacking — merges multiple `Preset`s into a single effective
+ * preset so projects can layer (e.g.) `mobile-opinionated` +
+ * `security-hardening` + `company-baseline`.
+ *
+ * Semantics:
+ * - Articles merge by id. Earlier presets win; later presets only
+ *   contribute ids that were not already present.
+ * - Gates merge by id using the same first-wins rule.
+ * - The resulting Preset carries a synthetic id/name composed from the
+ *   inputs so audit records can trace which presets were active.
+ *
+ * Blueprint ref: 04 §4.
+ */
+import type { Preset } from "./types.js";
+export interface StackResult {
+    /** Materialized effective preset (for rendering and gate execution). */
+    preset: Preset;
+    /** Ordered list of ids that actually contributed content. */
+    order: string[];
+    /** Diagnostics: ids from later presets that were shadowed. */
+    shadowed: Array<{
+        from: string;
+        kind: "article" | "gate";
+        id: string;
+    }>;
+}
+export declare function stackPresets(presets: Preset[]): StackResult;
+//# sourceMappingURL=stacking.d.ts.map

package/dist/_core/dist/presets/stacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacking.d.ts","sourceRoot":"","sources":["../../src/presets/stacking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CA2D3D"}

package/dist/_core/dist/presets/stacking.js

@@ -0,0 +1,91 @@
+/**
+ * Preset stacking — merges multiple `Preset`s into a single effective
+ * preset so projects can layer (e.g.) `mobile-opinionated` +
+ * `security-hardening` + `company-baseline`.
+ *
+ * Semantics:
+ * - Articles merge by id. Earlier presets win; later presets only
+ *   contribute ids that were not already present.
+ * - Gates merge by id using the same first-wins rule.
+ * - The resulting Preset carries a synthetic id/name composed from the
+ *   inputs so audit records can trace which presets were active.
+ *
+ * Blueprint ref: 04 §4.
+ */
+export function stackPresets(presets) {
+    if (presets.length === 0) {
+        return {
+            preset: emptyPreset(),
+            order: [],
+            shadowed: [],
+        };
+    }
+    if (presets.length === 1) {
+        const p = presets[0];
+        return {
+            preset: clonePreset(p),
+            order: [p.id],
+            shadowed: [],
+        };
+    }
+    const articles = new Map();
+    const gates = new Map();
+    const shadowed = [];
+    const order = [];
+    for (const p of presets) {
+        order.push(p.id);
+        for (const a of p.articles) {
+            if (articles.has(a.id)) {
+                shadowed.push({ from: p.id, kind: "article", id: a.id });
+                continue;
+            }
+            articles.set(a.id, { ...a });
+        }
+        for (const g of p.gates) {
+            if (gates.has(g.id)) {
+                shadowed.push({ from: p.id, kind: "gate", id: g.id });
+                continue;
+            }
+            gates.set(g.id, g);
+        }
+    }
+    const composedId = presets.map((p) => p.id).join("+");
+    const composedName = `Stacked: ${presets.map((p) => p.name).join(" + ")}`;
+    const composedVersion = presets.map((p) => p.version).join("/");
+    const description = presets
+        .map((p) => (p.description ? `- ${p.id}: ${p.description}` : `- ${p.id}`))
+        .join("\n");
+    return {
+        preset: {
+            id: composedId,
+            name: composedName,
+            version: composedVersion,
+            description,
+            articles: Array.from(articles.values()),
+            gates: Array.from(gates.values()),
+        },
+        order,
+        shadowed,
+    };
+}
+function emptyPreset() {
+    return {
+        id: "empty",
+        name: "Empty",
+        version: "0.0.0",
+        description: "",
+        articles: [],
+        gates: [],
+    };
+}
+function clonePreset(p) {
+    return {
+        id: p.id,
+        name: p.name,
+        version: p.version,
+        description: p.description,
+        articles: p.articles.map((a) => ({ ...a })),
+        gates: [...p.gates],
+    };
+}
+//# sourceMappingURL=stacking.js.map

package/dist/_core/dist/presets/stacking.js.map

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

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

@@ -0,0 +1,22 @@
+import type { Gate } from "../gates/types.js";
+export interface PresetArticleViolation {
+    level: "required" | "advisory";
+    description: string;
+}
+export interface PresetArticle {
+    id: string;
+    title: string;
+    statement: string;
+    rationale: string;
+    enforcement: string;
+    violation: PresetArticleViolation;
+}
+export interface Preset {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    articles: PresetArticle[];
+    gates: Gate[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/presets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,sBAAsB,CAAC;CACnC;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}

package/dist/_core/dist/presets/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/presets/types.ts"],"names":[],"mappings":""}

package/dist/_core/dist/prompts/audit-log.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Structured JSONL Logger — Optional audit logging in JSONL format.
+ *
+ * Each log entry is a single-line JSON object appended to `.raptor/audit.jsonl`.
+ * Used for traceability, debugging, and compliance.
+ *
+ * Spec Kit ref: E07 — "Logs estruturados JSONL opcionais"
+ */
+export interface AuditLogEntry {
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Event type (e.g., "phase.transition", "artifact.created", "gate.passed"). */
+    event: string;
+    /** SDD phase (specify, plan, tasks, implement). */
+    phase?: string;
+    /** Feature directory. */
+    feature?: string;
+    /** Agent that performed the action. */
+    agent?: string;
+    /** Human actor identifier. */
+    actor?: string;
+    /** Affected file path. */
+    artifact?: string;
+    /** SHA-256 hash of the artifact content. */
+    hash?: string;
+    /** Additional metadata. */
+    meta?: Record<string, unknown>;
+    /** Duration in milliseconds (for timed operations). */
+    duration_ms?: number;
+    /** Whether the operation succeeded. */
+    success?: boolean;
+    /** Error message if operation failed. */
+    error?: string;
+}
+/**
+ * Append a structured log entry to the JSONL audit log.
+ *
+ * Idempotent: calling with the same entry appends a new line.
+ * Thread-safe via atomic append.
+ */
+export declare function auditLog(projectRoot: string, entry: Omit<AuditLogEntry, "timestamp">): void;
+/**
+ * Log a phase transition event.
+ */
+export declare function logPhaseTransition(projectRoot: string, opts: {
+    from?: string;
+    to: string;
+    feature: string;
+    agent?: string;
+    actor?: string;
+}): void;
+/**
+ * Log an artifact creation/update event.
+ */
+export declare function logArtifactEvent(projectRoot: string, opts: {
+    event: "artifact.created" | "artifact.updated" | "artifact.deleted";
+    artifact: string;
+    hash?: string;
+    feature: string;
+    phase: string;
+    agent?: string;
+}): void;
+/**
+ * Log a gate evaluation event.
+ */
+export declare function logGateEvent(projectRoot: string, opts: {
+    gateId: string;
+    passed: boolean;
+    feature: string;
+    phase: string;
+    error?: string;
+}): void;
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/_core/dist/prompts/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/prompts/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GACtC,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,IAAI,CASN"}

package/dist/_core/dist/prompts/audit-log.js

@@ -0,0 +1,73 @@
+/**
+ * Structured JSONL Logger — Optional audit logging in JSONL format.
+ *
+ * Each log entry is a single-line JSON object appended to `.raptor/audit.jsonl`.
+ * Used for traceability, debugging, and compliance.
+ *
+ * Spec Kit ref: E07 — "Logs estruturados JSONL opcionais"
+ */
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+// ---------------------------------------------------------------------------
+// Logger
+// ---------------------------------------------------------------------------
+/**
+ * Append a structured log entry to the JSONL audit log.
+ *
+ * Idempotent: calling with the same entry appends a new line.
+ * Thread-safe via atomic append.
+ */
+export function auditLog(projectRoot, entry) {
+    const logPath = join(projectRoot, ".raptor", "audit.jsonl");
+    // Ensure directory exists
+    const dir = dirname(logPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const fullEntry = {
+        timestamp: new Date().toISOString(),
+        ...entry,
+    };
+    // Single-line JSON + newline (JSONL format)
+    appendFileSync(logPath, JSON.stringify(fullEntry) + "\n");
+}
+/**
+ * Log a phase transition event.
+ */
+export function logPhaseTransition(projectRoot, opts) {
+    auditLog(projectRoot, {
+        event: "phase.transition",
+        phase: opts.to,
+        feature: opts.feature,
+        agent: opts.agent,
+        actor: opts.actor,
+        meta: { from_phase: opts.from },
+    });
+}
+/**
+ * Log an artifact creation/update event.
+ */
+export function logArtifactEvent(projectRoot, opts) {
+    auditLog(projectRoot, {
+        event: opts.event,
+        artifact: opts.artifact,
+        hash: opts.hash,
+        feature: opts.feature,
+        phase: opts.phase,
+        agent: opts.agent,
+    });
+}
+/**
+ * Log a gate evaluation event.
+ */
+export function logGateEvent(projectRoot, opts) {
+    auditLog(projectRoot, {
+        event: opts.passed ? "gate.passed" : "gate.failed",
+        phase: opts.phase,
+        feature: opts.feature,
+        success: opts.passed,
+        error: opts.error,
+        meta: { gate_id: opts.gateId },
+    });
+}
+//# sourceMappingURL=audit-log.js.map

package/dist/_core/dist/prompts/audit-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../src/prompts/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiC1C,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,WAAmB,EACnB,KAAuC;IAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAE5D,0BAA0B;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,SAAS,GAAkB;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,KAAK;KACT,CAAC;IAEF,4CAA4C;IAC5C,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,IAMC;IAED,QAAQ,CAAC,WAAW,EAAE;QACpB,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,IAAI,CAAC,EAAE;QACd,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,IAOC;IAED,QAAQ,CAAC,WAAW,EAAE;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,IAMC;IAED,QAAQ,CAAC,WAAW,EAAE;QACpB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa;QAClD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @raptor/core prompts module — Renderer, resumption, and audit logging.
+ */
+export { renderPrompt, autoResolveContext, parseFrontmatter, extractScriptPath, } from "./renderer.js";
+export type { RenderContext } from "./renderer.js";
+export { isValidTransition, nextPhase, readFeatureState, writeFeatureState, checkArtifactPresence, determineResumablePhase, } from "./resumption.js";
+export { auditLog, logPhaseTransition, logArtifactEvent, logGateEvent, } from "./audit-log.js";
+export type { AuditLogEntry } from "./audit-log.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/_core/dist/prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * @raptor/core prompts module — Renderer, resumption, and audit logging.
+ */
+export { renderPrompt, autoResolveContext, parseFrontmatter, extractScriptPath, } from "./renderer.js";
+export { isValidTransition, nextPhase, readFeatureState, writeFeatureState, checkArtifactPresence, determineResumablePhase, } from "./resumption.js";
+export { auditLog, logPhaseTransition, logArtifactEvent, logGateEvent, } from "./audit-log.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * 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"
+ */
+export interface RenderContext {
+    /** User arguments (verbatim from slash command invocation). */
+    arguments?: string;
+    /** Resolved script path (from frontmatter `scripts.sh`). */
+    scriptPath?: string;
+    /** Agent context file path (e.g., "CLAUDE.md"). */
+    contextFile?: string;
+    /** Active feature directory (e.g., "specs/003-user-auth"). */
+    featureDirectory?: string;
+    /** Feature name (e.g., "003-user-auth"). */
+    featureName?: string;
+    /** Project name from manifest. */
+    projectName?: string;
+    /** Project root (for resolving .raptor/ paths). */
+    projectRoot?: string;
+    /** Extra custom placeholders (key → value). */
+    custom?: Record<string, string>;
+}
+/**
+ * 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 declare function renderPrompt(template: string, ctx: RenderContext): string;
+/**
+ * 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 declare function autoResolveContext(projectRoot: string, overrides?: Partial<RenderContext>): RenderContext;
+/**
+ * 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 declare function parseFrontmatter(template: string): {
+    frontmatter: Record<string, string>;
+    body: string;
+};
+/**
+ * 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 declare function extractScriptPath(template: string): string | undefined;
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/prompts/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA0CD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAUzE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAgDf;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,CAqCA;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtE"}