raptor-aios 0.1.0

package/dist/_core/dist/extensions/manifest.js

@@ -0,0 +1,176 @@
+/**
+ * Extension Manifest — parser and validator for `extension.yml`.
+ *
+ * A manifest describes what the extension provides. We parse it, validate
+ * the schema discriminator, normalize optional fields, and verify that
+ * every declared file actually exists on disk (otherwise the resolver
+ * would fail later with confusing errors).
+ *
+ * Blueprint ref: 03 §4 — "extension.yml".
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { hashFile } from "../audit/hash.js";
+import { EXTENSION_SCHEMA_V1, ExtensionManifestError, } from "./types.js";
+const PROVIDES_KEYS = [
+    "gates",
+    "templates",
+    "hooks",
+    "workflows",
+    "presets",
+];
+const ID_RE = /^[a-z][a-z0-9._-]{1,63}$/;
+const VERSION_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+/**
+ * Parse raw YAML text into a validated ExtensionManifest. Does NOT
+ * touch the filesystem beyond what the caller passes as source text.
+ */
+export function parseManifest(raw, manifestPath) {
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new ExtensionManifestError(`failed to parse extension.yml${manifestPath ? ` at ${manifestPath}` : ""}: ${err.message}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ExtensionManifestError(`extension.yml${manifestPath ? ` at ${manifestPath}` : ""} must be a YAML mapping`);
+    }
+    const obj = parsed;
+    if (obj.schema !== EXTENSION_SCHEMA_V1) {
+        throw new ExtensionManifestError(`unsupported schema "${String(obj.schema)}" — expected "${EXTENSION_SCHEMA_V1}"`);
+    }
+    const id = requireString(obj, "id");
+    if (!ID_RE.test(id)) {
+        throw new ExtensionManifestError(`invalid extension id "${id}" — must match ${ID_RE}`);
+    }
+    const name = requireString(obj, "name");
+    const version = requireString(obj, "version");
+    if (!VERSION_RE.test(version)) {
+        throw new ExtensionManifestError(`invalid version "${version}" — must be semver`);
+    }
+    const description = optionalString(obj, "description");
+    const author = optionalString(obj, "author");
+    const requires = parseRequires(obj.requires);
+    const provides = parseProvides(obj.provides);
+    const manifest = {
+        schema: EXTENSION_SCHEMA_V1,
+        id,
+        name,
+        version,
+    };
+    if (description !== undefined)
+        manifest.description = description;
+    if (author !== undefined)
+        manifest.author = author;
+    if (requires)
+        manifest.requires = requires;
+    if (provides)
+        manifest.provides = provides;
+    return manifest;
+}
+/**
+ * Load an `extension.yml` from disk, validate, and compute file hashes
+ * for every file declared under `provides.*`. Returns a LoadedExtension
+ * ready to be registered.
+ */
+export function loadManifestFromDir(rootDir) {
+    const abs = isAbsolute(rootDir) ? rootDir : resolve(rootDir);
+    const manifestPath = join(abs, "extension.yml");
+    if (!existsSync(manifestPath)) {
+        throw new ExtensionManifestError(`extension.yml not found in ${abs}`);
+    }
+    const raw = readFileSync(manifestPath, "utf8");
+    const manifest = parseManifest(raw, manifestPath);
+    const fileHashes = {};
+    const provides = manifest.provides;
+    if (provides) {
+        for (const kind of PROVIDES_KEYS) {
+            const list = provides[kind];
+            if (!list)
+                continue;
+            for (const relPath of list) {
+                const full = join(abs, relPath);
+                if (!existsSync(full) || !statSync(full).isFile()) {
+                    throw new ExtensionManifestError(`extension "${manifest.id}" declares ${kind}/${relPath} but file does not exist at ${full}`);
+                }
+                fileHashes[relPath] = hashFile(full);
+            }
+        }
+    }
+    return {
+        manifest,
+        rootDir: abs,
+        manifestPath,
+        fileHashes,
+    };
+}
+// ---------------------------------------------------------------------------
+// internals
+// ---------------------------------------------------------------------------
+function requireString(obj, key) {
+    const v = obj[key];
+    if (typeof v !== "string" || v.trim().length === 0) {
+        throw new ExtensionManifestError(`missing or invalid "${key}" — must be a non-empty string`);
+    }
+    return v;
+}
+function optionalString(obj, key) {
+    const v = obj[key];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== "string") {
+        throw new ExtensionManifestError(`"${key}" must be a string if present`);
+    }
+    return v;
+}
+function parseRequires(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw new ExtensionManifestError(`"requires" must be a mapping`);
+    }
+    const r = value;
+    const out = {};
+    if (r.raptor_version !== undefined) {
+        if (typeof r.raptor_version !== "string") {
+            throw new ExtensionManifestError(`"requires.raptor_version" must be a string`);
+        }
+        out.raptor_version = r.raptor_version;
+    }
+    return out;
+}
+function parseProvides(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw new ExtensionManifestError(`"provides" must be a mapping`);
+    }
+    const p = value;
+    const out = {};
+    for (const kind of PROVIDES_KEYS) {
+        const v = p[kind];
+        if (v === undefined || v === null)
+            continue;
+        if (!Array.isArray(v)) {
+            throw new ExtensionManifestError(`"provides.${kind}" must be a list of file paths`);
+        }
+        const arr = [];
+        for (const entry of v) {
+            if (typeof entry !== "string" || entry.trim().length === 0) {
+                throw new ExtensionManifestError(`"provides.${kind}" contains non-string or empty entry`);
+            }
+            if (entry.includes("..") || isAbsolute(entry)) {
+                throw new ExtensionManifestError(`"provides.${kind}" entry "${entry}" must be a relative path without ".." segments`);
+            }
+            arr.push(entry);
+        }
+        out[kind] = arr;
+    }
+    return out;
+}
+// dirname is imported for potential future use in relative-path math; keep
+// the reference to avoid tree-shake oddities with bundled tests.
+void dirname;
+//# sourceMappingURL=manifest.js.map

package/dist/_core/dist/extensions/manifest.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Extension Registry — in-memory store of loaded extensions for the
+ * duration of a single CLI or workflow run. Process-local by design:
+ * spawning a new Raptor invocation re-loads from disk so we never
+ * operate on stale state.
+ *
+ * Blueprint ref: 03 §5.
+ */
+import type { LoadedExtension, ProvidedKind } from "./types.js";
+export interface ExtensionRegistrySnapshot {
+    extensions: LoadedExtension[];
+}
+export declare class ExtensionRegistry {
+    private readonly byId;
+    private order;
+    register(ext: LoadedExtension): void;
+    has(id: string): boolean;
+    get(id: string): LoadedExtension | undefined;
+    list(): LoadedExtension[];
+    /** Enumerate all extensions that provide a given kind, in registration order. */
+    listByKind(kind: ProvidedKind): LoadedExtension[];
+    clear(): void;
+    snapshot(): ExtensionRegistrySnapshot;
+}
+/**
+ * Return the process-wide singleton registry, lazily instantiated.
+ * Tests that need isolation should prefer `new ExtensionRegistry()`
+ * directly instead of touching the singleton.
+ */
+export declare function getExtensionRegistry(): ExtensionRegistry;
+export declare function resetExtensionRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,KAAK,CAAgB;IAE7B,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAUpC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,IAAI,IAAI,eAAe,EAAE;IAIzB,iFAAiF;IACjF,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,EAAE;IAOjD,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,yBAAyB;CAGtC;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAGxD;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/_core/dist/extensions/registry.js

@@ -0,0 +1,57 @@
+/**
+ * Extension Registry — in-memory store of loaded extensions for the
+ * duration of a single CLI or workflow run. Process-local by design:
+ * spawning a new Raptor invocation re-loads from disk so we never
+ * operate on stale state.
+ *
+ * Blueprint ref: 03 §5.
+ */
+export class ExtensionRegistry {
+    byId = new Map();
+    order = [];
+    register(ext) {
+        if (this.byId.has(ext.manifest.id)) {
+            throw new Error(`extension "${ext.manifest.id}" is already registered (from ${this.byId.get(ext.manifest.id).rootDir})`);
+        }
+        this.byId.set(ext.manifest.id, ext);
+        this.order.push(ext.manifest.id);
+    }
+    has(id) {
+        return this.byId.has(id);
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return this.order.map((id) => this.byId.get(id)).filter(Boolean);
+    }
+    /** Enumerate all extensions that provide a given kind, in registration order. */
+    listByKind(kind) {
+        return this.list().filter((e) => {
+            const provided = e.manifest.provides?.[kind];
+            return Array.isArray(provided) && provided.length > 0;
+        });
+    }
+    clear() {
+        this.byId.clear();
+        this.order = [];
+    }
+    snapshot() {
+        return { extensions: this.list() };
+    }
+}
+let globalRegistry = null;
+/**
+ * Return the process-wide singleton registry, lazily instantiated.
+ * Tests that need isolation should prefer `new ExtensionRegistry()`
+ * directly instead of touching the singleton.
+ */
+export function getExtensionRegistry() {
+    if (!globalRegistry)
+        globalRegistry = new ExtensionRegistry();
+    return globalRegistry;
+}
+export function resetExtensionRegistry() {
+    globalRegistry = null;
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,OAAO,iBAAiB;IACX,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,GAAa,EAAE,CAAC;IAE7B,QAAQ,CAAC,GAAoB;QAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,cAAc,GAAG,CAAC,QAAQ,CAAC,EAAE,iCAAiC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAE,CAAC,OAAO,GAAG,CACzG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,iFAAiF;IACjF,UAAU,CAAC,IAAkB;QAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IACrC,CAAC;CACF;AAED,IAAI,cAAc,GAA6B,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,cAAc;QAAE,cAAc,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC9D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/_core/dist/extensions/resolver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Extension Resolver — answers "where does this template/gate/hook live?"
+ * by walking a layered set of sources.
+ *
+ * Resolution order (first hit wins):
+ *   1. `.raptor/overrides/<kind>/<name>`      (project-local overrides)
+ *   2. `.raptor/presets/<preset-id>/<kind>/<name>`
+ *   3. `<ext-root>/<relative-from-manifest>`  (extensions via registry)
+ *   4. bundled defaults (provided by caller)
+ *
+ * The resolver does NOT read file contents. It only returns the first
+ * matching absolute path so each subsystem can decide how to consume it
+ * (read raw, compile template, import JS, …).
+ *
+ * Blueprint ref: 03 §5, 04 §6.
+ */
+import type { ExtensionRegistry } from "./registry.js";
+import type { ProvidedKind, ResolveHit, ResolveRequest } from "./types.js";
+export interface ResolverOptions {
+    projectRoot: string;
+    registry: ExtensionRegistry;
+    /**
+     * Optional map of bundled defaults per kind. Key is the resource name
+     * (e.g. "plan.md.hbs"), value is an absolute path. When present this
+     * is the lowest-priority layer.
+     */
+    bundled?: Partial<Record<ProvidedKind, Record<string, string>>>;
+    /** Subdirs (mostly for tests). */
+    overridesSubdir?: string;
+    presetsSubdir?: string;
+    /**
+     * Ordered list of active preset ids. Presets earlier in the list win
+     * over later ones (matches F4 stacking semantics).
+     */
+    activePresets?: string[];
+}
+export declare const DEFAULT_OVERRIDES_SUBDIR = ".raptor/overrides";
+export declare const DEFAULT_PRESETS_SUBDIR = ".raptor/presets";
+export declare class Resolver {
+    private readonly opts;
+    constructor(opts: ResolverOptions);
+    resolve(req: ResolveRequest): ResolveHit | null;
+    /**
+     * Return every source that matches a request, ordered by priority.
+     * Useful for diagnostics / `raptor doctor --sources`.
+     */
+    resolveAll(req: ResolveRequest): ResolveHit[];
+    private checkOverrides;
+    private checkPresets;
+    private checkAllPresets;
+    private checkExtensions;
+    private checkAllExtensions;
+    private checkBundled;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/_core/dist/extensions/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/extensions/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAChE,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAC5D,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,eAAe;IAMlD,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI;IAa/C;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,EAAE;IAW7C,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,YAAY;CAQrB"}

package/dist/_core/dist/extensions/resolver.js

@@ -0,0 +1,143 @@
+/**
+ * Extension Resolver — answers "where does this template/gate/hook live?"
+ * by walking a layered set of sources.
+ *
+ * Resolution order (first hit wins):
+ *   1. `.raptor/overrides/<kind>/<name>`      (project-local overrides)
+ *   2. `.raptor/presets/<preset-id>/<kind>/<name>`
+ *   3. `<ext-root>/<relative-from-manifest>`  (extensions via registry)
+ *   4. bundled defaults (provided by caller)
+ *
+ * The resolver does NOT read file contents. It only returns the first
+ * matching absolute path so each subsystem can decide how to consume it
+ * (read raw, compile template, import JS, …).
+ *
+ * Blueprint ref: 03 §5, 04 §6.
+ */
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+export const DEFAULT_OVERRIDES_SUBDIR = ".raptor/overrides";
+export const DEFAULT_PRESETS_SUBDIR = ".raptor/presets";
+export class Resolver {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+        if (!isAbsolute(opts.projectRoot)) {
+            throw new Error(`projectRoot must be absolute, got "${opts.projectRoot}"`);
+        }
+    }
+    resolve(req) {
+        const overridesHit = this.checkOverrides(req);
+        if (overridesHit)
+            return overridesHit;
+        const presetHit = this.checkPresets(req);
+        if (presetHit)
+            return presetHit;
+        const extensionHit = this.checkExtensions(req);
+        if (extensionHit)
+            return extensionHit;
+        return this.checkBundled(req);
+    }
+    /**
+     * Return every source that matches a request, ordered by priority.
+     * Useful for diagnostics / `raptor doctor --sources`.
+     */
+    resolveAll(req) {
+        const hits = [];
+        const overridesHit = this.checkOverrides(req);
+        if (overridesHit)
+            hits.push(overridesHit);
+        hits.push(...this.checkAllPresets(req));
+        hits.push(...this.checkAllExtensions(req));
+        const bundledHit = this.checkBundled(req);
+        if (bundledHit)
+            hits.push(bundledHit);
+        return hits;
+    }
+    checkOverrides(req) {
+        const subdir = this.opts.overridesSubdir ?? DEFAULT_OVERRIDES_SUBDIR;
+        const candidate = join(this.opts.projectRoot, subdir, req.kind, req.name);
+        if (fileExists(candidate)) {
+            return { path: candidate, layer: "overrides" };
+        }
+        return null;
+    }
+    checkPresets(req) {
+        const subdir = this.opts.presetsSubdir ?? DEFAULT_PRESETS_SUBDIR;
+        for (const presetId of this.opts.activePresets ?? []) {
+            const candidate = join(this.opts.projectRoot, subdir, presetId, req.kind, req.name);
+            if (fileExists(candidate)) {
+                return { path: candidate, layer: "preset" };
+            }
+        }
+        return null;
+    }
+    checkAllPresets(req) {
+        const subdir = this.opts.presetsSubdir ?? DEFAULT_PRESETS_SUBDIR;
+        const hits = [];
+        for (const presetId of this.opts.activePresets ?? []) {
+            const candidate = join(this.opts.projectRoot, subdir, presetId, req.kind, req.name);
+            if (fileExists(candidate)) {
+                hits.push({ path: candidate, layer: "preset" });
+            }
+        }
+        return hits;
+    }
+    checkExtensions(req) {
+        for (const ext of this.opts.registry.list()) {
+            const list = ext.manifest.provides?.[req.kind];
+            if (!list)
+                continue;
+            if (!list.includes(req.name))
+                continue;
+            const candidate = join(ext.rootDir, req.name);
+            if (fileExists(candidate)) {
+                return {
+                    path: candidate,
+                    layer: "extension",
+                    extensionId: ext.manifest.id,
+                };
+            }
+        }
+        return null;
+    }
+    checkAllExtensions(req) {
+        const hits = [];
+        for (const ext of this.opts.registry.list()) {
+            const list = ext.manifest.provides?.[req.kind];
+            if (!list)
+                continue;
+            if (!list.includes(req.name))
+                continue;
+            const candidate = join(ext.rootDir, req.name);
+            if (fileExists(candidate)) {
+                hits.push({
+                    path: candidate,
+                    layer: "extension",
+                    extensionId: ext.manifest.id,
+                });
+            }
+        }
+        return hits;
+    }
+    checkBundled(req) {
+        const byName = this.opts.bundled?.[req.kind];
+        if (!byName)
+            return null;
+        const absolute = byName[req.name];
+        if (!absolute)
+            return null;
+        if (!fileExists(absolute))
+            return null;
+        return { path: absolute, layer: "bundled" };
+    }
+}
+function fileExists(p) {
+    try {
+        return existsSync(p) && statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/_core/dist/extensions/resolver.js.map

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

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

@@ -0,0 +1,173 @@
+/**
+ * Extension System — core types.
+ *
+ * Extensions are self-contained bundles that register new templates,
+ * gates, hooks, and workflows into a Raptor project. They live under
+ * `.raptor/extensions/<id>/` and declare their contents via an
+ * `extension.yml` manifest.
+ *
+ * Resolution order (highest → lowest priority):
+ *   1. `.raptor/overrides/`         (user project overrides)
+ *   2. `.raptor/presets/`           (stacked presets, see F4)
+ *   3. `.raptor/extensions/<id>/`   (this system)
+ *   4. bundled / core defaults
+ *
+ * Blueprint ref: 03 (integrations), 17 (multi-agent orchestration).
+ */
+export declare const EXTENSION_SCHEMA_V1: "raptor.extension/v1";
+export type ExtensionSchema = typeof EXTENSION_SCHEMA_V1;
+/**
+ * Formal JSON Schema (Draft-07) for `extension.yml` payloads. The runtime
+ * parser in `manifest.ts` is hand-rolled (because YAML can contain
+ * structures Ajv won't enforce cleanly), but this constant is the
+ * authoritative spec for the file format and is suitable for IDE schema
+ * validation, documentation, and contract tests.
+ *
+ * Spec Kit ref: E08 — "extension.yml com schema versionado e validador".
+ */
+export declare const EXTENSION_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "raptor.extension/v1";
+    readonly title: "Raptor Extension Manifest";
+    readonly description: "Self-contained bundle of templates/gates/hooks/workflows/presets.";
+    readonly type: "object";
+    readonly required: readonly ["schema", "id", "name", "version"];
+    readonly properties: {
+        readonly schema: {
+            readonly type: "string";
+            readonly const: "raptor.extension/v1";
+        };
+        readonly id: {
+            readonly type: "string";
+            readonly pattern: "^[a-z][a-z0-9._-]{1,63}$";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly pattern: "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$";
+        };
+        readonly description: {
+            readonly type: "string";
+        };
+        readonly author: {
+            readonly type: "string";
+        };
+        readonly requires: {
+            readonly type: "object";
+            readonly properties: {
+                readonly raptor_version: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly provides: {
+            readonly type: "object";
+            readonly properties: {
+                readonly gates: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly templates: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly hooks: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly workflows: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly presets: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly additionalProperties: true;
+};
+/**
+ * Declared artifacts an extension provides. Paths are relative to the
+ * extension root directory. All arrays are optional; an extension may
+ * provide a subset.
+ */
+export interface ExtensionProvides {
+    gates?: string[];
+    templates?: string[];
+    hooks?: string[];
+    workflows?: string[];
+    presets?: string[];
+}
+export interface ExtensionRequires {
+    /** Semver range the host Raptor must satisfy (e.g. ">=0.1.0"). */
+    raptor_version?: string;
+}
+export interface ExtensionManifest {
+    schema: ExtensionSchema;
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    requires?: ExtensionRequires;
+    provides?: ExtensionProvides;
+}
+/**
+ * A loaded extension: the manifest plus enough on-disk metadata for
+ * the resolver to find individual files.
+ */
+export interface LoadedExtension {
+    manifest: ExtensionManifest;
+    /** Absolute path of the extension root directory. */
+    rootDir: string;
+    /** Absolute path of the manifest file (`extension.yml`). */
+    manifestPath: string;
+    /**
+     * Map of relative file → SHA-256 hash. Computed at load time so
+     * corrupted or tampered files can be detected (future feature).
+     */
+    fileHashes: Record<string, string>;
+}
+export type ProvidedKind = keyof ExtensionProvides;
+/**
+ * A resolution request from a subsystem (e.g. template loader, gate
+ * runner). The resolver walks the layered sources and returns the
+ * first absolute file path that matches.
+ */
+export interface ResolveRequest {
+    kind: ProvidedKind;
+    /** Relative file name as declared by the caller. For templates this is e.g. `plan.md.hbs`. */
+    name: string;
+}
+export interface ResolveHit {
+    /** Absolute path of the resolved file. */
+    path: string;
+    /** Which layer answered. */
+    layer: "overrides" | "preset" | "extension" | "bundled";
+    /** Extension id when `layer === "extension"`, otherwise undefined. */
+    extensionId?: string;
+}
+export declare class ExtensionManifestError extends Error {
+    constructor(message: string);
+}
+export declare class ExtensionLoadError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map