@agent-relay/factory 0.1.49 → 0.1.51

package/dist/environments/verification-stack-descriptor.d.ts.map

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

package/dist/environments/verification-stack-descriptor.js

@@ -0,0 +1,275 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { ProcessCommandRunner } from './kubernetes-command.js';
+export const DEFAULT_VERIFICATION_STACK_PATH = '.factory/verification-stack.yaml';
+export const VERIFICATION_STACK_API_VERSION = 'factory.agentworkforce.dev/v1alpha1';
+export const VERIFICATION_STACK_KIND = 'VerificationStack';
+export const DEFAULT_VERIFICATION_E2E_IMAGE = 'node:22.17.0-alpine3.22@sha256:fc3e945f920b7e3000cd1af86c4ae406ec70c72f328b667baf0f3a8910d69eed';
+/** File URL that works from both the source checkout and the published dist. */
+export const VERIFICATION_STACK_JSON_SCHEMA_URL = new URL('../../schemas/verification-stack.schema.json', import.meta.url);
+const dnsNameSchema = z.string().trim().min(1).max(63).regex(/^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?$/u, 'must be a lowercase DNS label (letters, numbers, and hyphens)');
+const relativePathSchema = z.string().trim().min(1).refine((value) => !isAbsolute(value) && !value.split(/[\\/]/u).includes('..'), 'must be a path inside the repository');
+const durationFields = {
+    timeoutSeconds: z.number().int().min(1).max(3_600).default(120),
+    intervalSeconds: z.number().min(0.1).max(60).default(2),
+};
+const pinnedImageSchema = z.string().trim().regex(/@sha256:[a-f0-9]{64}$/u, 'must pin an OCI image by sha256 digest');
+const httpProbeSchema = z.object({
+    type: z.literal('http'),
+    service: dnsNameSchema.optional(),
+    port: z.number().int().min(1).max(65_535),
+    path: z.string().startsWith('/').default('/'),
+    scheme: z.enum(['http', 'https']).default('http'),
+    expectedStatuses: z.array(z.number().int().min(100).max(599)).min(1).default([200]),
+    ...durationFields,
+}).strict();
+const tcpProbeSchema = z.object({
+    type: z.literal('tcp'),
+    service: dnsNameSchema.optional(),
+    port: z.number().int().min(1).max(65_535),
+    ...durationFields,
+}).strict();
+const execProbeSchema = z.object({
+    type: z.literal('exec'),
+    target: z.string().trim().min(1).optional(),
+    container: dnsNameSchema.optional(),
+    command: z.array(z.string().min(1)).min(1),
+    ...durationFields,
+}).strict();
+export const VerificationProbeSchema = z.discriminatedUnion('type', [
+    httpProbeSchema,
+    tcpProbeSchema,
+    execProbeSchema,
+]);
+const helmSourceSchema = z.object({
+    type: z.literal('helm'),
+    chart: z.string().trim().min(1),
+    release: dnsNameSchema.optional(),
+    valuesFiles: z.array(relativePathSchema).default([]),
+}).strict();
+const kustomizeSourceSchema = z.object({
+    type: z.literal('kustomize'),
+    path: relativePathSchema,
+}).strict();
+const manifestsSourceSchema = z.object({
+    type: z.literal('manifests'),
+    paths: z.array(relativePathSchema).min(1),
+}).strict();
+const composeSourceSchema = z.object({
+    type: z.literal('docker-compose'),
+    path: relativePathSchema,
+}).strict();
+export const VerificationStackSourceSchema = z.discriminatedUnion('type', [
+    helmSourceSchema,
+    kustomizeSourceSchema,
+    manifestsSourceSchema,
+    composeSourceSchema,
+]);
+const referenceSchema = z.object({
+    ref: z.string().trim().min(1),
+    optional: z.boolean().default(false),
+}).strict();
+const referenceDataKeySchema = z.string().min(1).max(253).regex(/^[A-Za-z0-9._-]+$/u, 'must contain only letters, numbers, dots, underscores, and hyphens');
+const materializedReferenceSchema = z.object({
+    name: dnsNameSchema,
+    data: z.record(referenceDataKeySchema, referenceSchema).refine((data) => Object.keys(data).length > 0, 'must declare at least one referenced key'),
+}).strict();
+const serviceSchema = z.object({
+    name: dnsNameSchema,
+    workload: z.object({
+        kind: z.enum(['deployment', 'statefulset', 'daemonset']),
+        name: dnsNameSchema.optional(),
+    }).strict(),
+    readiness: VerificationProbeSchema,
+    health: VerificationProbeSchema.optional(),
+}).strict();
+const execSeedSchema = z.object({
+    type: z.literal('exec'),
+    name: dnsNameSchema,
+    service: dnsNameSchema,
+    container: dnsNameSchema.optional(),
+    command: z.array(z.string().min(1)).min(1),
+    timeoutSeconds: z.number().int().min(1).max(3_600).default(120),
+}).strict();
+const jobSeedSchema = z.object({
+    type: z.literal('job'),
+    name: dnsNameSchema,
+    manifest: relativePathSchema,
+    job: dnsNameSchema,
+    timeoutSeconds: z.number().int().min(1).max(3_600).default(120),
+}).strict();
+const seedSchema = z.discriminatedUnion('type', [execSeedSchema, jobSeedSchema]);
+const endpointSchema = z.object({
+    name: dnsNameSchema,
+    service: dnsNameSchema,
+    port: z.number().int().min(1).max(65_535),
+    protocol: z.enum(['http', 'https']).default('http'),
+    path: z.string().startsWith('/').default('/'),
+}).strict();
+const verificationGateSchema = z.object({
+    environmentTtlSeconds: z.number().int().min(1).max(24 * 60 * 60).default(15 * 60),
+    e2e: z.object({
+        image: pinnedImageSchema.default(DEFAULT_VERIFICATION_E2E_IMAGE),
+        command: z.string().trim().min(1),
+        args: z.array(z.string()).default([]),
+        env: z.record(z.string()).default({}),
+        timeoutSeconds: z.number().int().min(1).max(60 * 60).default(5 * 60),
+    }).strict(),
+    load: z.object({
+        profile: relativePathSchema,
+        timeoutSeconds: z.number().int().min(1).max(60 * 60).default(5 * 60),
+        k6Image: pinnedImageSchema.optional(),
+    }).strict(),
+    overallTimeoutSeconds: z.number().int().min(1).max(2 * 60 * 60).default(15 * 60),
+    teardownTimeoutSeconds: z.number().int().min(1).max(30 * 60).default(2 * 60),
+}).strict();
+export const VerificationStackDescriptorSchema = z.object({
+    apiVersion: z.literal(VERIFICATION_STACK_API_VERSION),
+    kind: z.literal(VERIFICATION_STACK_KIND),
+    name: dnsNameSchema,
+    source: VerificationStackSourceSchema,
+    secrets: z.array(materializedReferenceSchema).default([]),
+    config: z.array(materializedReferenceSchema).default([]),
+    services: z.array(serviceSchema).min(1),
+    seeds: z.array(seedSchema).default([]),
+    endpoints: z.array(endpointSchema).default([]),
+    /** Required when this descriptor participates in Factory's live merge gate. */
+    verification: verificationGateSchema.optional(),
+}).strict().superRefine((descriptor, context) => {
+    uniqueNames(descriptor.services, 'services', context);
+    uniqueNames(descriptor.secrets, 'secrets', context);
+    uniqueNames(descriptor.config, 'config', context);
+    uniqueNames(descriptor.seeds, 'seeds', context);
+    uniqueNames(descriptor.endpoints, 'endpoints', context);
+    const services = new Set(descriptor.services.map((service) => service.name));
+    descriptor.seeds.forEach((seed, index) => {
+        if (seed.type === 'exec' && !services.has(seed.service)) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['seeds', index, 'service'],
+                message: `references undeclared service ${JSON.stringify(seed.service)}`,
+            });
+        }
+    });
+    descriptor.endpoints.forEach((endpoint, index) => {
+        if (!services.has(endpoint.service)) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['endpoints', index, 'service'],
+                message: `references undeclared service ${JSON.stringify(endpoint.service)}`,
+            });
+        }
+    });
+});
+export class VerificationStackDescriptorError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'VerificationStackDescriptorError';
+    }
+}
+export function loadVerificationStack(input, source = '<input>') {
+    const parsed = VerificationStackDescriptorSchema.safeParse(input);
+    if (parsed.success)
+        return parsed.data;
+    const details = parsed.error.issues.map((issue) => {
+        const path = issue.path.length ? issue.path.join('.') : '<root>';
+        return `- ${path}: ${issue.message}`;
+    }).join('\n');
+    throw new VerificationStackDescriptorError(`Invalid verification-stack descriptor ${source}:\n${details}`, { cause: parsed.error });
+}
+export function parseVerificationStack(text, source = '<input>') {
+    let input;
+    try {
+        input = parseYaml(text);
+    }
+    catch (cause) {
+        throw new VerificationStackDescriptorError(`Could not parse verification-stack descriptor ${source}: ${errorMessage(cause)}`, { cause });
+    }
+    return loadVerificationStack(input, source);
+}
+export async function loadVerificationStackFile(filePath) {
+    const absolutePath = resolve(filePath);
+    let text;
+    try {
+        text = await readFile(absolutePath, 'utf8');
+    }
+    catch (cause) {
+        throw new VerificationStackDescriptorError(`Could not read verification-stack descriptor ${absolutePath}: ${errorMessage(cause)}`, { cause });
+    }
+    return {
+        descriptor: parseVerificationStack(text, absolutePath),
+        descriptorPath: absolutePath,
+        rootDir: dirname(absolutePath),
+    };
+}
+/** Resolve the default or overridden descriptor from a checkout or an arbitrary Git ref. */
+export async function resolveVerificationStackDescriptor(options) {
+    const repoPath = resolve(options.repoPath);
+    const descriptorPath = validateDescriptorPath(options.descriptorPath ?? DEFAULT_VERIFICATION_STACK_PATH);
+    if (!options.ref) {
+        const absolutePath = resolveInside(repoPath, descriptorPath);
+        const loaded = await loadVerificationStackFile(absolutePath);
+        return { ...loaded, rootDir: repoPath, descriptorPath };
+    }
+    const runner = options.commandRunner ?? new ProcessCommandRunner();
+    let commit;
+    try {
+        const result = await runner.run('git', [
+            '-C', repoPath, 'rev-parse', '--verify', `${options.ref}^{commit}`,
+        ]);
+        commit = result.stdout.trim();
+    }
+    catch (cause) {
+        throw new VerificationStackDescriptorError(`Could not resolve verification-stack Git ref ${JSON.stringify(options.ref)} in ${repoPath}: ${errorMessage(cause)}`, { cause });
+    }
+    try {
+        const result = await runner.run('git', ['-C', repoPath, 'show', `${commit}:${descriptorPath}`]);
+        return {
+            descriptor: parseVerificationStack(result.stdout, `${options.ref}:${descriptorPath}`),
+            descriptorPath,
+            rootDir: repoPath,
+            ref: commit,
+        };
+    }
+    catch (cause) {
+        if (cause instanceof VerificationStackDescriptorError)
+            throw cause;
+        throw new VerificationStackDescriptorError(`Could not read verification-stack descriptor ${descriptorPath} at ${JSON.stringify(options.ref)}: ${errorMessage(cause)}`, { cause });
+    }
+}
+function uniqueNames(values, field, context) {
+    const seen = new Set();
+    values.forEach((value, index) => {
+        if (seen.has(value.name)) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [field, index, 'name'],
+                message: `duplicate name ${JSON.stringify(value.name)}`,
+            });
+        }
+        seen.add(value.name);
+    });
+}
+function validateDescriptorPath(value) {
+    if (!value || isAbsolute(value) || value.split(/[\\/]/u).includes('..')) {
+        throw new VerificationStackDescriptorError(`verification-stack descriptor path must stay inside the repository: ${JSON.stringify(value)}`);
+    }
+    return value.replaceAll('\\', '/');
+}
+export function resolveVerificationStackAsset(rootDir, assetPath) {
+    return resolveInside(rootDir, assetPath);
+}
+function resolveInside(root, child) {
+    const absolute = resolve(root, child);
+    const fromRoot = relative(root, absolute);
+    if (fromRoot === '..' || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
+        throw new VerificationStackDescriptorError(`verification-stack asset path escapes the repository: ${JSON.stringify(child)}`);
+    }
+    return absolute;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=verification-stack-descriptor.js.map

package/dist/environments/verification-stack-descriptor.js.map

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

package/dist/environments/verification-stack.d.ts

@@ -0,0 +1,29 @@
+import { type LoadedVerificationStack } from './verification-stack-descriptor.js';
+export interface ResolvedVerificationStack {
+    descriptorPath: string;
+    repositoryPath: string;
+    loaded: LoadedVerificationStack;
+    environmentTtlMs: number;
+    e2e: {
+        image: string;
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+        timeoutMs: number;
+    };
+    load: {
+        profilePath: string;
+        timeoutMs: number;
+        k6Image?: string;
+    };
+    timeouts: {
+        overallMs: number;
+        teardownMs: number;
+    };
+}
+/**
+ * Resolve the repository-owned deployment descriptor and require the live-gate
+ * section used by the provision → deploy → E2E → load pipeline.
+ */
+export declare function loadVerificationGateStack(repositoryPath: string, descriptorPath?: string): Promise<ResolvedVerificationStack>;
+//# sourceMappingURL=verification-stack.d.ts.map

package/dist/environments/verification-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-stack.d.ts","sourceRoot":"","sources":["../../src/environments/verification-stack.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,oCAAoC,CAAA;AAE3C,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,uBAAuB,CAAA;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,EAAE,CAAA;QACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC3B,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,cAAc,SAAqC,GAClD,OAAO,CAAC,yBAAyB,CAAC,CAwCpC"}

package/dist/environments/verification-stack.js

@@ -0,0 +1,43 @@
+import { resolve } from 'node:path';
+import { resolveVerificationStackAsset, resolveVerificationStackDescriptor, } from './verification-stack-descriptor.js';
+/**
+ * Resolve the repository-owned deployment descriptor and require the live-gate
+ * section used by the provision → deploy → E2E → load pipeline.
+ */
+export async function loadVerificationGateStack(repositoryPath, descriptorPath = '.factory/verification-stack.yaml') {
+    const root = resolve(repositoryPath);
+    const loaded = await resolveVerificationStackDescriptor({
+        repoPath: root,
+        descriptorPath,
+    });
+    const gate = loaded.descriptor.verification;
+    if (!gate) {
+        throw new Error(`Verification stack ${loaded.descriptorPath} does not declare the required verification section`);
+    }
+    if (loaded.descriptor.endpoints.length === 0) {
+        throw new Error(`Verification stack ${loaded.descriptorPath} must expose at least one endpoint for E2E and load stages`);
+    }
+    return {
+        descriptorPath: loaded.descriptorPath,
+        repositoryPath: root,
+        loaded,
+        environmentTtlMs: gate.environmentTtlSeconds * 1_000,
+        e2e: {
+            image: gate.e2e.image,
+            command: gate.e2e.command,
+            args: gate.e2e.args,
+            env: gate.e2e.env,
+            timeoutMs: gate.e2e.timeoutSeconds * 1_000,
+        },
+        load: {
+            profilePath: resolveVerificationStackAsset(loaded.rootDir, gate.load.profile),
+            timeoutMs: gate.load.timeoutSeconds * 1_000,
+            ...(gate.load.k6Image ? { k6Image: gate.load.k6Image } : {}),
+        },
+        timeouts: {
+            overallMs: gate.overallTimeoutSeconds * 1_000,
+            teardownMs: gate.teardownTimeoutSeconds * 1_000,
+        },
+    };
+}
+//# sourceMappingURL=verification-stack.js.map

package/dist/environments/verification-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-stack.js","sourceRoot":"","sources":["../../src/environments/verification-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GAEnC,MAAM,oCAAoC,CAAA;AAyB3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,cAAsB,EACtB,cAAc,GAAG,kCAAkC;IAEnD,MAAM,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,MAAM,kCAAkC,CAAC;QACtD,QAAQ,EAAE,IAAI;QACd,cAAc;KACf,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAA;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,CAAC,cAAc,qDAAqD,CACjG,CAAA;IACH,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,CAAC,cAAc,4DAA4D,CACxG,CAAA;IACH,CAAC;IAED,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,IAAI;QACpB,MAAM;QACN,gBAAgB,EAAE,IAAI,CAAC,qBAAqB,GAAG,KAAK;QACpD,GAAG,EAAE;YACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO;YACzB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK;SAC3C;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,6BAA6B,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7E,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,KAAK;YAC3C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D;QACD,QAAQ,EAAE;YACR,SAAS,EAAE,IAAI,CAAC,qBAAqB,GAAG,KAAK;YAC7C,UAAU,EAAE,IAAI,CAAC,sBAAsB,GAAG,KAAK;SAChD;KACF,CAAA;AACH,CAAC"}

package/dist/featuremap/generate.d.ts

@@ -0,0 +1,72 @@
+import type { Logger } from '../ports/system.js';
+import { type FeatureCriticality } from './validate.js';
+export { FEATURE_MAP_MANIFEST_PATH } from './validate.js';
+export type FeatureMapCriticality = FeatureCriticality;
+export type FeatureMapVerifyTier = 1 | 2 | 3 | 4 | 5 | 6;
+export interface FeatureMapFeature {
+    id: string;
+    name: string;
+    cli?: string;
+    api?: string;
+    description: string;
+    location: string;
+    verifyTier: FeatureMapVerifyTier;
+    criticality: FeatureMapCriticality;
+}
+export interface ParsedFeatureMapManifest {
+    version: string;
+    categoryIds: string[];
+    categoryProcedures: Record<string, string>;
+    features: FeatureMapFeature[];
+}
+export interface StaleFeatureLocation {
+    featureId: string;
+    location: string;
+    reason: 'missing' | 'outside-repo';
+}
+export interface FeatureMapGenerationOptions {
+    /** Hard wall-clock budget for discovery, inference, validation, and persistence. */
+    timeoutMs?: number;
+    /** Per-dispatch growth cap. */
+    maxNewEntries?: number;
+    /** Total generated plus hand-authored feature cap. */
+    maxManifestFeatures?: number;
+    /** Maximum touched files considered after glob expansion. */
+    maxTouchedFiles?: number;
+    /** Maximum directory entries inspected while expanding globs. */
+    maxScannedPaths?: number;
+    /** Files larger than this receive a path-derived fallback entry without being read. */
+    maxSourceBytes?: number;
+    /** Existing manifests larger than this are not read or changed. */
+    maxManifestBytes?: number;
+    /** Existing locations checked for drift on one invocation. */
+    maxStaleChecks?: number;
+    logger?: Pick<Logger, 'warn'>;
+    now?: () => Date;
+}
+export interface FeatureMapGenerationInput extends FeatureMapGenerationOptions {
+    repoPath: string;
+    touchedFileGlobs: readonly string[];
+}
+export type FeatureMapGenerationStatus = 'created' | 'updated' | 'unchanged' | 'failed' | 'timed-out';
+export interface FeatureMapGenerationResult {
+    ok: boolean;
+    status: FeatureMapGenerationStatus;
+    manifestPath: string;
+    added: FeatureMapFeature[];
+    staleLocations: StaleFeatureLocation[];
+    touchedFiles: string[];
+    warnings: string[];
+    error?: string;
+}
+/**
+ * Lazily create or extend a repository's feature manifest from touched files.
+ *
+ * The function intentionally never rejects. Dispatch callers can record a
+ * failed/timed-out result and continue their primary work unchanged.
+ */
+export declare function generateFeatureMap(input: FeatureMapGenerationInput): Promise<FeatureMapGenerationResult>;
+export declare function generateFeatureMap(repoPath: string, touchedFileGlobs: readonly string[], options?: FeatureMapGenerationOptions): Promise<FeatureMapGenerationResult>;
+/** Parse through the shared validator consumed by the feature guardian and CI. */
+export declare function parseFeatureMapManifest(raw: string): ParsedFeatureMapManifest;
+//# sourceMappingURL=generate.d.ts.map

package/dist/featuremap/generate.d.ts.map

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