@aid-framework/generator-sdk 0.0.0 → 0.1.39

package/dist/plan.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The two-phase generator contract (§8.1): `plan` is a pure function of the IR, and
+ * `emit` turns a plan into committed bytes.
+ *
+ * The split is what makes the safety properties checkable before anything touches
+ * disk. A plan is data — a set of repo-relative paths with owners — so ownership,
+ * path escapes, and duplicates are all decided by `validatePlan` with no filesystem
+ * involved. Drift detection then only has to answer one question per file: does the
+ * content on disk still match the hash recorded from the last generation?
+ */
+import type { IR } from '@aid-framework/ir';
+import { type GeneratorDiagnostic } from './diagnostics.js';
+import { type FileOwner } from './ownership.js';
+export interface GeneratedFile {
+    /** Repo-relative POSIX path. */
+    path: string;
+    content: string;
+    owner: FileOwner;
+    /** Replaced with `content`; absent means create-only-if-missing. */
+    previousHash?: string;
+}
+export interface Plan {
+    files: readonly GeneratedFile[];
+}
+export interface GeneratorContext {
+    /** Version of the generator producing the output, recorded per file in the manifest. */
+    generatorVersion: string;
+    /** Repository root the plan's paths are relative to. */
+    root: string;
+}
+export interface Generator {
+    readonly name: string;
+    readonly target: string;
+    readonly version: string;
+    readonly irRange: string;
+    plan(ir: IR, context: GeneratorContext): Plan;
+    emit(plan: Plan, context: GeneratorContext): readonly GeneratedFile[];
+}
+export interface PlanValidationOptions {
+    generatedDir?: string;
+    businessDir?: string;
+    /** The manifest is generator bookkeeping, never a planned artifact. */
+    manifestFilename?: string;
+}
+/**
+ * Checks a plan before any of it is written. Every failure is reported at once —
+ * a generator author fixing one path at a time per run is how drift bugs survive.
+ */
+export declare function validatePlan(plan: unknown, options?: PlanValidationOptions): GeneratorDiagnostic[];
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,SAAS,EAKf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,aAAa,EAAE,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,qBAA0B,GAClC,mBAAmB,EAAE,CAkJvB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/plan.js

@@ -0,0 +1,132 @@
+/**
+ * The two-phase generator contract (§8.1): `plan` is a pure function of the IR, and
+ * `emit` turns a plan into committed bytes.
+ *
+ * The split is what makes the safety properties checkable before anything touches
+ * disk. A plan is data — a set of repo-relative paths with owners — so ownership,
+ * path escapes, and duplicates are all decided by `validatePlan` with no filesystem
+ * involved. Drift detection then only has to answer one question per file: does the
+ * content on disk still match the hash recorded from the last generation?
+ */
+import { sortDiagnostics } from '@aid-framework/spec';
+import { GENERATOR_DIAGNOSTIC_CODES, generatorError, } from './diagnostics.js';
+import { DEFAULT_MANIFEST_FILENAME, escapesRoot, isAbsolutePath, isReservedPath, normalizeRelativePath, ownerForPath, } from './ownership.js';
+/**
+ * Checks a plan before any of it is written. Every failure is reported at once —
+ * a generator author fixing one path at a time per run is how drift bugs survive.
+ */
+export function validatePlan(plan, options = {}) {
+    const manifestFilename = options.manifestFilename ?? DEFAULT_MANIFEST_FILENAME;
+    const diagnostics = [];
+    if (!isRecord(plan) || !Array.isArray(plan.files)) {
+        return [
+            generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planNotAMapping,
+                message: 'A plan must be an object with a `files` array.',
+                path: 'plan.files',
+            }),
+        ];
+    }
+    if (plan.files.length === 0) {
+        diagnostics.push(generatorError({
+            code: GENERATOR_DIAGNOSTIC_CODES.planEmpty,
+            message: 'A plan must contain at least one file; an empty plan hides a broken generator.',
+            path: 'plan.files',
+        }));
+    }
+    const seen = new Map();
+    for (const [index, entry] of plan.files.entries()) {
+        const at = `plan.files[${index}]`;
+        if (!isRecord(entry)) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at} must be an object with \`path\`, \`content\`, and \`owner\`.`,
+                path: at,
+            }));
+            continue;
+        }
+        if (typeof entry.path !== 'string') {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.path must be a string.`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        const raw = entry.path;
+        if (isAbsolutePath(raw)) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.path "${raw}" is absolute; plan paths are repo-relative.`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        if (escapesRoot(raw)) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.path "${raw}" escapes the repository root.`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        const normalized = normalizeRelativePath(raw);
+        if (normalized === undefined) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.path "${raw}" is not a usable relative path.`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        if (isReservedPath(normalized, manifestFilename)) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.path "${normalized}" is reserved by the generator; it is never planned.`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        const expectedOwner = ownerForPath(normalized, options);
+        if (expectedOwner === undefined) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planOwnerMismatch,
+                message: `${at}.path "${normalized}" is outside the managed roots, so it has no owner.`,
+                path: `${at}.path`,
+                hint: 'Generated files belong under the generated root and business files under the business root.',
+            }));
+            continue;
+        }
+        if (entry.owner !== expectedOwner) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planOwnerMismatch,
+                message: `${at}.owner is "${String(entry.owner)}" but "${normalized}" is a ${expectedOwner} path.`,
+                path: `${at}.owner`,
+            }));
+            continue;
+        }
+        if (typeof entry.content !== 'string') {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planInvalidPath,
+                message: `${at}.content must be a string.`,
+                path: `${at}.content`,
+            }));
+            continue;
+        }
+        const first = seen.get(normalized);
+        if (first !== undefined) {
+            diagnostics.push(generatorError({
+                code: GENERATOR_DIAGNOSTIC_CODES.planDuplicatePath,
+                message: `"${normalized}" is planned twice (at plan.files[${first}]).`,
+                path: `${at}.path`,
+            }));
+            continue;
+        }
+        seen.set(normalized, index);
+    }
+    return sortDiagnostics(diagnostics);
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

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

package/dist/semver.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The minimal semver surface a generator manifest needs: parse a version, parse a
+ * range, and decide whether a version satisfies a range.
+ *
+ * This exists because `Generator.irRange` (§8.1) and `AidManifest.generatorVersion`
+ * (§10) are both version contracts, and "does this generator support the IR it was
+ * handed" must be answered before codegen, not discovered at runtime. It is
+ * deliberately not a full semver library: no build metadata in comparisons, and
+ * prereleases follow the npm rule that a prerelease only matches a comparator whose
+ * bound version carries a prerelease at the same `major.minor.patch`. That rule is
+ * what stops `1.2.3-rc.1` silently satisfying `^1.2.3`.
+ */
+export interface Version {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: readonly (string | number)[];
+}
+export declare function parseVersion(text: string): Version | undefined;
+export declare function formatVersion(version: Version): string;
+export declare function isValidVersion(text: string): boolean;
+/** Semver precedence. Build metadata is not part of precedence and is not parsed. */
+export declare function compareVersions(left: Version, right: Version): -1 | 0 | 1;
+interface Bound {
+    operator: '>' | '>=' | '<' | '<=' | '=';
+    version: Version;
+}
+/** One whitespace-separated conjunct, already expanded into `>`, `>=`, `<`, `<=`, `=` bounds. */
+type Conjunct = Bound[];
+interface Range {
+    /** One entry per `||` alternative; a version satisfies the range if any satisfies. */
+    alternatives: Conjunct[];
+    /** True when the range is a bare wildcard, which no version can fail. */
+    any: boolean;
+}
+export declare function isValidRange(text: string): boolean;
+/**
+ * Parses the range grammar the repo's manifests use: `||` alternatives, and each
+ * alternative a whitespace-separated list of comparators. A comparator is an
+ * operator plus a version that may be partial or wildcarded (`1.2.x`, `1`, `*`).
+ * Anything outside the grammar is `undefined`, never a permissive default.
+ */
+export declare function parseRange(text: string): Range | undefined;
+export declare function satisfies(versionText: string, rangeText: string): boolean;
+export {};
+//# sourceMappingURL=semver.d.ts.map

package/dist/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../src/semver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC1C;AAOD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAa9D;AAOD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAKzE;AAkCD,UAAU,KAAK;IACb,QAAQ,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iGAAiG;AACjG,KAAK,QAAQ,GAAG,KAAK,EAAE,CAAC;AAExB,UAAU,KAAK;IACb,sFAAsF;IACtF,YAAY,EAAE,QAAQ,EAAE,CAAC;IACzB,yEAAyE;IACzE,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAoB1D;AAqID,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOzE"}

package/dist/semver.js

@@ -0,0 +1,264 @@
+/**
+ * The minimal semver surface a generator manifest needs: parse a version, parse a
+ * range, and decide whether a version satisfies a range.
+ *
+ * This exists because `Generator.irRange` (§8.1) and `AidManifest.generatorVersion`
+ * (§10) are both version contracts, and "does this generator support the IR it was
+ * handed" must be answered before codegen, not discovered at runtime. It is
+ * deliberately not a full semver library: no build metadata in comparisons, and
+ * prereleases follow the npm rule that a prerelease only matches a comparator whose
+ * bound version carries a prerelease at the same `major.minor.patch`. That rule is
+ * what stops `1.2.3-rc.1` silently satisfying `^1.2.3`.
+ */
+const VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)?$/;
+const IDENTIFIER_PATTERN = /^\d+$/;
+export function parseVersion(text) {
+    const match = VERSION_PATTERN.exec(text.trim());
+    if (match === null)
+        return undefined;
+    const [, major, minor, patch, prerelease] = match;
+    if (major === undefined || minor === undefined || patch === undefined)
+        return undefined;
+    return {
+        major: Number(major),
+        minor: Number(minor),
+        patch: Number(patch),
+        prerelease: parsePrerelease(prerelease),
+    };
+}
+function parsePrerelease(text) {
+    if (text === undefined || text === '')
+        return [];
+    return text.split('.').map((part) => (IDENTIFIER_PATTERN.test(part) ? Number(part) : part));
+}
+export function formatVersion(version) {
+    const base = `${version.major}.${version.minor}.${version.patch}`;
+    if (version.prerelease.length === 0)
+        return base;
+    return `${base}-${version.prerelease.join('.')}`;
+}
+export function isValidVersion(text) {
+    return parseVersion(text) !== undefined;
+}
+/** Semver precedence. Build metadata is not part of precedence and is not parsed. */
+export function compareVersions(left, right) {
+    for (const key of ['major', 'minor', 'patch']) {
+        if (left[key] !== right[key])
+            return left[key] < right[key] ? -1 : 1;
+    }
+    return comparePrerelease(left.prerelease, right.prerelease);
+}
+function comparePrerelease(left, right) {
+    // An empty prerelease outranks any prerelease: 1.0.0 > 1.0.0-rc.1.
+    if (left.length === 0 && right.length === 0)
+        return 0;
+    if (left.length === 0)
+        return 1;
+    if (right.length === 0)
+        return -1;
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const a = left[index];
+        const b = right[index];
+        // A shorter prerelease is lower when its identifiers are exhausted.
+        if (a === undefined)
+            return -1;
+        if (b === undefined)
+            return 1;
+        if (a === b)
+            continue;
+        const aNumeric = typeof a === 'number';
+        const bNumeric = typeof b === 'number';
+        if (aNumeric && bNumeric)
+            return a < b ? -1 : 1;
+        // Numeric identifiers always rank below alphanumeric ones.
+        if (aNumeric !== bNumeric)
+            return aNumeric ? -1 : 1;
+        return a < b ? -1 : 1;
+    }
+    return 0;
+}
+const OPERATORS = ['>=', '<=', '^', '~', '>', '<', '='];
+export function isValidRange(text) {
+    return parseRange(text) !== undefined;
+}
+/**
+ * Parses the range grammar the repo's manifests use: `||` alternatives, and each
+ * alternative a whitespace-separated list of comparators. A comparator is an
+ * operator plus a version that may be partial or wildcarded (`1.2.x`, `1`, `*`).
+ * Anything outside the grammar is `undefined`, never a permissive default.
+ */
+export function parseRange(text) {
+    const source = text.trim();
+    if (source === '')
+        return undefined;
+    const alternatives = [];
+    for (const alternative of source.split('||')) {
+        const trimmed = alternative.trim();
+        if (trimmed === '')
+            return undefined;
+        // `-` ranges are deliberately unsupported: a range we cannot expand exactly
+        // must fail validation rather than match approximately.
+        if (/\s-\s/.test(trimmed))
+            return undefined;
+        const conjunct = expandConjunct(trimmed);
+        if (conjunct === undefined)
+            return undefined;
+        alternatives.push(conjunct);
+    }
+    if (alternatives.length === 0)
+        return undefined;
+    return { alternatives, any: alternatives.some((conjunct) => conjunct.length === 0) };
+}
+function expandConjunct(text) {
+    if (text === '*' || text === 'x' || text === 'X')
+        return [];
+    const bounds = [];
+    for (const token of text.split(/\s+/)) {
+        if (token === '')
+            continue;
+        const expanded = expandComparator(token);
+        if (expanded === undefined)
+            return undefined;
+        bounds.push(...expanded);
+    }
+    return bounds.length === 0 ? [] : bounds;
+}
+function splitOperator(token) {
+    for (const operator of OPERATORS) {
+        if (token.startsWith(operator))
+            return { operator, rest: token.slice(operator.length) };
+    }
+    return { operator: '=', rest: token };
+}
+function parsePartial(text) {
+    const [core, ...rest] = text.split('-');
+    if (core === undefined)
+        return undefined;
+    const prerelease = rest.length === 0 ? [] : parsePrerelease(rest.join('-'));
+    const parts = core.split('.');
+    const numbers = [];
+    let wildcards = 0;
+    for (const part of parts) {
+        if (/(?:x|X|\*)/.test(part)) {
+            wildcards += 1;
+            continue;
+        }
+        if (!/^\d+$/.test(part))
+            return undefined;
+        numbers.push(Number(part));
+    }
+    if (parts.length > 3)
+        return undefined;
+    if (wildcards > 0 && numbers.length + wildcards !== parts.length)
+        return undefined;
+    const [major = 0, minor = 0, patch = 0] = numbers;
+    return {
+        major,
+        minor,
+        patch,
+        prerelease,
+        specified: Math.min(numbers.length, 3),
+    };
+}
+function makeVersion(major, minor, patch, prerelease = []) {
+    return { major, minor, patch, prerelease };
+}
+function expandComparator(token) {
+    const { operator, rest } = splitOperator(token);
+    // A bare operator (`>=`) names nothing and is a typo; an operator in front of a
+    // wildcard (`^x`) names no version at all, so it constrains nothing.
+    if (rest === '')
+        return undefined;
+    if (rest === '*' || rest === 'x' || rest === 'X')
+        return [];
+    const partial = parsePartial(rest);
+    if (partial === undefined)
+        return undefined;
+    const { major, minor, patch, prerelease, specified } = partial;
+    if (specified === 3) {
+        const exact = makeVersion(major, minor, patch, prerelease);
+        switch (operator) {
+            case '=':
+            case '>':
+            case '>=':
+            case '<':
+            case '<=':
+                return [{ operator, version: exact }];
+            case '~':
+                return [
+                    { operator: '>=', version: exact },
+                    { operator: '<', version: makeVersion(major, minor + 1, 0) },
+                ];
+            case '^': {
+                const upper = major > 0
+                    ? makeVersion(major + 1, 0, 0)
+                    : minor > 0
+                        ? makeVersion(0, minor + 1, 0)
+                        : makeVersion(0, 0, patch + 1);
+                return [
+                    { operator: '>=', version: exact },
+                    { operator: '<', version: upper },
+                ];
+            }
+            default:
+                return undefined;
+        }
+    }
+    if (operator === '>' || operator === '<' || operator === '>=' || operator === '<=') {
+        return [{ operator, version: makeVersion(major, minor, patch, prerelease) }];
+    }
+    // `^`/`~`/`=` with a partial version: partial versions lower-bound at zero and
+    // upper-bound at the last position that was actually written.
+    return partialBounds(major, minor, patch, specified);
+}
+/** A partial version (`1`, `1.2`, `1.2.x`) has a zero lower bound and a bumped upper bound. */
+function partialBounds(major, minor, patch, specified) {
+    // `^x.y` names no version at all, so it constrains nothing rather than guessing.
+    if (specified === 0)
+        return [];
+    const lower = { operator: '>=', version: makeVersion(major, minor, patch) };
+    const upper = specified === 1
+        ? { operator: '<', version: makeVersion(major + 1, 0, 0) }
+        : { operator: '<', version: makeVersion(major, minor + 1, 0) };
+    return [lower, upper];
+}
+export function satisfies(versionText, rangeText) {
+    const parsedVersion = parseVersion(versionText);
+    const range = parseRange(rangeText);
+    if (parsedVersion === undefined || range === undefined)
+        return false;
+    if (range.any)
+        return true;
+    return range.alternatives.some((conjunct) => satisfiesConjunct(parsedVersion, conjunct));
+}
+function satisfiesConjunct(candidate, conjunct) {
+    if (conjunct.length === 0)
+        return true;
+    if (candidate.prerelease.length > 0) {
+        const anchored = conjunct.some((bound) => bound.version.prerelease.length > 0 &&
+            bound.version.major === candidate.major &&
+            bound.version.minor === candidate.minor &&
+            bound.version.patch === candidate.patch);
+        if (!anchored)
+            return false;
+    }
+    return conjunct.every((bound) => satisfiesBound(candidate, bound));
+}
+/** No `default`: a new operator must be handled here, not silently pass. */
+function satisfiesBound(candidate, bound) {
+    const order = compareVersions(candidate, bound.version);
+    switch (bound.operator) {
+        case '>':
+            return order > 0;
+        case '>=':
+            return order >= 0;
+        case '<':
+            return order < 0;
+        case '<=':
+            return order <= 0;
+        case '=':
+            return order === 0;
+    }
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

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

package/dist/targets.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The Phase 0 target declarations, in the shape `@aid-framework/ir`'s capability gate consumes.
+ *
+ * `@aid-framework/ir` ships a placeholder (`PHASE_0_TARGET_CAPABILITIES`) precisely so the gate
+ * can exist before a real generator does; this module is the replacement. It matters
+ * that these are *declarations*, not aspirations: a target that claims `streaming`
+ * makes every spec requiring streaming pass the capability gate, so the list is the
+ * honest answer to "what does the code this generator emits actually do".
+ *
+ * Two facts are recorded here rather than hidden in prose:
+ *
+ * - `streaming` is declared since layer P7a. It was absent while both gateways raised
+ *   `FeatureDeferredError`; the Python runtime now streams and the generator emits a
+ *   route that negotiates `Accept: text/event-stream`, so the declaration is backed by
+ *   an emitter, a runtime and a committed example. The TypeScript runtime still defers
+ *   streaming (ratified to L6), which is why `@aid-framework/ir`'s derivation and this list are
+ *   kept separate concerns.
+ * - `agents` and `cursor-memory` are declared since layer P7b, and they are two
+ *   declarations rather than one because the IR derives two: `agents` from an `agents`
+ *   collection, `cursor-memory` from a `memory` collection (there is no `memory`
+ *   capability to declare). Both are backed by emitted code -- `generated/agents.py`
+ *   builds the runtime over this app's own gateway and tools and serves the routes --
+ *   and by the example's `tests/test_agents.py`, which pauses a run and resumes it. The
+ *   TypeScript target declares neither, so `@aid-framework/ir` will route a spec that needs them
+ *   to the Python target or refuse it.
+ * - the absence of `emitsAgainst.orchestration` — Phase 0 control flow is plain async,
+ *   and orchestration frameworks are deferred to Phase 2. An agent loop is not an
+ *   orchestration framework: the emitted `build_runtime` calls `AgentRuntime.from_ir`
+ *   from the repo's own runtime and depends on nothing outside it.
+ */
+import { type TargetCapabilityDeclarations } from '@aid-framework/ir';
+import { type GeneratorManifest, type GeneratorManifestInput } from './manifest.js';
+export declare const PY_FASTAPI_TARGET = "py-fastapi";
+/**
+ * The FastAPI + Pydantic target. `emitsAgainst` says the emitted code binds to
+ * Pydantic for structured output and OpenTelemetry GenAI for tracing, and to no
+ * orchestration framework at all.
+ */
+export declare const PY_FASTAPI_MANIFEST_INPUT: GeneratorManifestInput;
+export declare const PY_FASTAPI_MANIFEST: GeneratorManifest;
+export declare function phase0Generators(): GeneratorManifest[];
+/** Drop-in replacement for `@aid-framework/ir`'s `phase0TargetCapabilities()`. */
+export declare function phase0TargetCapabilities(): TargetCapabilityDeclarations;
+//# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAc,KAAK,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAGlF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAG5B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBA2BvC,CAAC;AAiBF,eAAO,MAAM,mBAAmB,EAAE,iBAGjC,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAEtD;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,IAAI,4BAA4B,CAEvE"}