@intentius/chant 0.7.0 → 0.8.0

package/dist/build.d.ts

@@ -0,0 +1,120 @@
+import type { Declarable } from "./declarable.js";
+import type { Serializer, SerializerResult } from "./serializer.js";
+import type { OwnershipMarker } from "./ownership.js";
+import type { DiscoveryError, BuildError } from "./errors.js";
+import { LexiconOutput } from "./lexicon-output.js";
+/**
+ * Build manifest describing cross-lexicon outputs and deployment order
+ */
+export interface BuildManifest {
+    lexicons: string[];
+    outputs: Record<string, {
+        source: string;
+        entity: string;
+        attribute: string;
+    }>;
+    deployOrder: string[];
+    /** Cross-stack apply-ordering graph (see {@link computeStackGraph}). */
+    stackGraph: StackGraph;
+}
+/**
+ * The cross-stack (cross-lexicon) apply-ordering graph chant already computes
+ * while resolving cross-lexicon references — surfaced as tool-agnostic data for
+ * an orchestrator to consume. chant exposes the order; it does not drive the
+ * apply.
+ */
+export interface StackGraph {
+    /** Stacks (lexicon partitions) in the build. */
+    nodes: string[];
+    /**
+     * Consumer→producer edges: `from` imports a value `to` exports, so `to` must
+     * apply before `from`. Inferred from cross-lexicon references.
+     */
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+    /** A flat applicable sequence — every producer before its consumers. */
+    order: string[];
+    /**
+     * Levels: stacks in the same wave have no inter-dependency and may apply
+     * concurrently. `order` flattened with parallelism made explicit.
+     */
+    waves: string[][];
+    /** Dependency cycles, if any (each a list of stacks). Normally empty. */
+    cycles: string[][];
+}
+/**
+ * Compute the cross-stack apply-ordering graph from resolved entities. Edges are
+ * inferred from cross-lexicon attribute references (a resource in lexicon A
+ * referencing an attribute of a resource in lexicon B ⇒ A depends on B). Returns
+ * the edge set plus a topological order, parallel-safe waves, and any cycles.
+ */
+export declare function computeStackGraph(entities: Map<string, Declarable>, lexiconNames: string[]): StackGraph;
+/**
+ * Result of the build process
+ */
+/**
+ * Optional inputs to the build pipeline.
+ */
+export interface BuildOptions {
+    /**
+     * When set, serializers stamp this ownership marker into each resource's
+     * native metadata channel. Resolved from project config by the caller.
+     */
+    ownership?: OwnershipMarker;
+    /**
+     * The resolved project configuration, passed through to each serializer's
+     * {@link SerializeContext} so a dialect can read its lexicon-scoped settings.
+     */
+    config?: Record<string, unknown>;
+}
+export interface BuildResult {
+    /** Map of lexicon name to serialized output (string or multi-file result) */
+    outputs: Map<string, string | SerializerResult>;
+    /** Map of entity name to Declarable entity */
+    entities: Map<string, Declarable>;
+    /** Resource-level dependency graph from discovery */
+    dependencies: Map<string, Set<string>>;
+    /** Array of warnings encountered during the build */
+    warnings: string[];
+    /** Array of errors encountered during discovery and build */
+    errors: Array<DiscoveryError | BuildError>;
+    /** Build manifest with cross-lexicon dependency info */
+    manifest: BuildManifest;
+    /** Number of source files processed */
+    sourceFileCount: number;
+}
+/**
+ * Partitions entities by their lexicon field.
+ * Property-kind Declarables are included in the same partition as their parent
+ * (they get inlined during serialization).
+ *
+ * @param entities - Map of entity name to Declarable
+ * @returns Map of lexicon name to Map of entity name to Declarable
+ */
+export declare function partitionByLexicon(entities: Map<string, Declarable>): Map<string, Map<string, Declarable>>;
+/**
+ * Collect LexiconOutput instances from all entity property trees.
+ * Walks entity properties recursively to find LexiconOutput values.
+ */
+export declare function collectLexiconOutputs(entities: Map<string, Declarable>): LexiconOutput[];
+/**
+ * Detect cross-lexicon AttrRefs by walking each entity's property tree.
+ * For each AttrRef whose parent entity belongs to a different lexicon than
+ * the consuming entity, auto-create a LexiconOutput.
+ *
+ * @param entities - Map of entity name to Declarable
+ * @returns Array of auto-detected LexiconOutput instances
+ */
+export declare function detectCrossLexiconRefs(entities: Map<string, Declarable>): LexiconOutput[];
+/**
+ * Builds a lexicon specification by discovering entities, sorting them
+ * topologically, and serializing them using the lexicon serializers.
+ *
+ * @param path - The directory path containing the specification files
+ * @param serializers - The serializers to use for serialization
+ * @returns BuildResult with outputs, entities, warnings, and errors
+ */
+export declare function build(path: string, serializers: Serializer[], parentBuildStack?: Set<string>, options?: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAmB,MAAM,kBAAkB,CAAC;AAOlE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CACtD,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,YAAY,EAAE,MAAM,EAAE,GACrB,UAAU,CAuEZ;AAED;;GAEG;AACH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;IAChD,8CAA8C;IAC9C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC,CAAC;IAC3C,wDAAwD;IACxD,QAAQ,EAAE,aAAa,CAAC;IACxB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CActC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,aAAa,EAAE,CA4DjB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAChC,aAAa,EAAE,CA8EjB;AA6ED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,UAAU,EAAE,EACzB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAkJtB"}

package/dist/builder.d.ts

@@ -0,0 +1,56 @@
+import type { Declarable } from "./declarable.js";
+/**
+ * Base class for builder pattern implementations
+ *
+ * Provides a fluent API for constructing Declarable entities.
+ * Subclasses should implement the build() method to return
+ * a fully constructed Declarable entity.
+ *
+ * @example
+ * ```ts
+ * class ResourceBuilder extends Builder<MyResource> {
+ *   private name?: string;
+ *   private type?: string;
+ *
+ *   withName(name: string): this {
+ *     this.name = name;
+ *     return this;
+ *   }
+ *
+ *   withType(type: string): this {
+ *     this.type = type;
+ *     return this;
+ *   }
+ *
+ *   build(): MyResource {
+ *     if (!this.name || !this.type) {
+ *       throw new Error("Name and type are required");
+ *     }
+ *     return {
+ *       entityType: "MyResource",
+ *       [DECLARABLE_MARKER]: true,
+ *       name: this.name,
+ *       type: this.type,
+ *     };
+ *   }
+ * }
+ *
+ * const resource = new ResourceBuilder()
+ *   .withName("myResource")
+ *   .withType("custom")
+ *   .build();
+ * ```
+ */
+export declare abstract class Builder<T extends Declarable> {
+    /**
+     * Builds and returns the final Declarable entity
+     *
+     * Subclasses must implement this method to construct
+     * and return the entity with all configured properties.
+     *
+     * @returns The constructed Declarable entity
+     * @throws Error if required properties are not set
+     */
+    abstract build(): T;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,8BAAsB,OAAO,CAAC,CAAC,SAAS,UAAU;IAChD;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,IAAI,CAAC;CACpB"}

package/dist/child-project.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Child Project — represents a nested project directory that gets built
+ * independently and referenced from a parent as a single deployment unit.
+ *
+ * Lexicons create ChildProjectInstance via their own factory (e.g. `nestedStack()`).
+ * The core build pipeline detects these and recursively builds children.
+ */
+import { DECLARABLE_MARKER, type Declarable } from "./declarable.js";
+import type { BuildResult } from "./build.js";
+/**
+ * Marker symbol for child project identification.
+ */
+export declare const CHILD_PROJECT_MARKER: unique symbol;
+/**
+ * A child project instance — a Declarable representing a separately-built
+ * project directory referenced from a parent.
+ */
+export interface ChildProjectInstance extends Declarable {
+    readonly [CHILD_PROJECT_MARKER]: true;
+    readonly [DECLARABLE_MARKER]: true;
+    readonly lexicon: string;
+    readonly entityType: string;
+    readonly kind: "resource";
+    readonly projectPath: string;
+    readonly logicalName: string;
+    readonly outputs: Record<string, unknown>;
+    readonly options: Record<string, unknown>;
+    buildResult?: BuildResult;
+}
+/**
+ * Type guard for ChildProjectInstance.
+ */
+export declare function isChildProject(value: unknown): value is ChildProjectInstance;
+//# sourceMappingURL=child-project.d.ts.map

package/dist/child-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-project.d.ts","sourceRoot":"","sources":["../src/child-project.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAmC,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAO5E"}

package/dist/cli/commands/audit.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `chant audit` — run chant's security, correctness, and best-practice checks against an existing repo's
+ * pipeline YAML and emit a tiered report. Does not require a chant project;
+ * it reads `.github/workflows`, `.gitlab-ci.yml`, and `.forgejo/workflows`
+ * directly and runs the real post-synth checks via the audit core.
+ */
+import { type AuditInput, type AuditFinding, type ChecksProvider } from "../../audit/core.js";
+import { type ReportTheme } from "../../audit/report-html.js";
+export type AuditFormat = "stylish" | "json" | "sarif" | "markdown" | "html";
+export type AuditTier = "merge-worthy" | "all";
+export type AuditFailOn = "merge-worthy" | "warning" | "none";
+export interface AuditCommandOptions {
+    /** Repo root/dir to scan, or an https:// repo URL to fetch and audit. */
+    path: string;
+    format?: AuditFormat;
+    /** Restrict findings to a tier (default "all"). */
+    tier?: AuditTier;
+    /** Exit-code policy (default "none" — read-only friendly). */
+    failOn?: AuditFailOn;
+    /** Server-side token for remote fetch (defaults to env). */
+    token?: string;
+    /** Injectable fetch for testing remote audits. */
+    fetchImpl?: typeof fetch;
+    /** Write the rendered report to this file instead of returning it for stdout. */
+    output?: string;
+    /** Injectable post-synth checks provider (testing). */
+    checksProvider?: ChecksProvider;
+    /** HTML report: theme knobs (title, logo, accent, footer). */
+    theme?: ReportTheme;
+    /** HTML report: full template override. */
+    template?: string;
+    /** Snapshot timestamp (ISO); defaults to now. Injectable for deterministic output. */
+    now?: string;
+    /** Tool version recorded in the HTML snapshot. */
+    toolVersion?: string;
+}
+export interface AuditCommandResult {
+    success: boolean;
+    /** Rendered report in the requested format. */
+    output: string;
+    findings: AuditFinding[];
+    /** Files that were scanned (relative to the root). */
+    scanned: string[];
+    exitCode: number;
+    error?: string;
+    /** Set when the report was written to a file (via `output`). */
+    wroteTo?: string;
+}
+/**
+ * Select the fetch token for a repo host. Tokens are host-specific — a GitHub
+ * PAT sent to GitLab/Codeberg is rejected (401) — so we never cross hosts.
+ */
+export declare function tokenForHost(url: string, env?: NodeJS.ProcessEnv): string | undefined;
+/** Coverage caveats about what the audit could and couldn't see. */
+export declare function coverageNotes(inputs: AuditInput[]): string[];
+/** Run the audit and produce a rendered result. */
+export declare function auditCommand(options: AuditCommandOptions): Promise<AuditCommandResult>;
+/** Print an audit result to stdout. */
+export declare function printAuditResult(result: AuditCommandResult): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/cli/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvG,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOvE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAC7E,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAiBlG;AAuBD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAS5D;AAmFD,mDAAmD;AACnD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkI5F;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAUjE"}

package/dist/cli/commands/build.d.ts

@@ -0,0 +1,70 @@
+import type { Serializer } from "../../serializer.js";
+import type { LexiconPlugin } from "../../lexicon.js";
+/**
+ * Build command options
+ */
+export interface BuildOptions {
+    /** Path to infrastructure directory */
+    path: string;
+    /** Output file path (undefined = stdout) */
+    output?: string;
+    /** Output format */
+    format: "json" | "yaml";
+    /** Serializers to use for serialization */
+    serializers: Serializer[];
+    /** Lexicon plugins (for post-synth checks) */
+    plugins?: LexiconPlugin[];
+    /** Print summary to stderr */
+    verbose?: boolean;
+    /**
+     * Environment/stack to evaluate policy against (`--env`). Falls back to the
+     * project's `ownership.env`. Passed into post-synth checks so organizational
+     * policy can branch on environment.
+     */
+    env?: string;
+}
+/**
+ * Resolve the output format for `chant build`.
+ *
+ * When `--format` is not given, infer it from the `-o` file extension
+ * (`.yaml`/`.yml` → yaml, `.json` → json); fall back to json when there is no
+ * extension to infer from. An explicit `--format` always wins, but a mismatch
+ * with the output extension is surfaced as a warning.
+ */
+export declare function resolveBuildFormat(explicit: string | undefined, output: string | undefined): {
+    format: "json" | "yaml";
+    warning?: string;
+};
+/**
+ * Build command result
+ */
+export interface BuildResult {
+    /** Whether the build succeeded */
+    success: boolean;
+    /** Number of resources built */
+    resourceCount: number;
+    /** Number of source files processed */
+    fileCount: number;
+    /** Error messages */
+    errors: string[];
+    /** Warning messages */
+    warnings: string[];
+}
+/**
+ * Execute the build command
+ */
+export declare function buildCommand(options: BuildOptions): Promise<BuildResult>;
+/**
+ * Print errors to stderr
+ */
+export declare function printErrors(errors: string[]): void;
+/**
+ * Print warnings to stderr
+ */
+export declare function printWarnings(warnings: string[]): void;
+/**
+ * Run build in watch mode. Runs an initial build, then watches for changes
+ * and triggers rebuilds. Returns a cleanup function.
+ */
+export declare function buildCommandWatch(options: BuildOptions, onRebuild?: (result: BuildResult) => void): () => void;
+//# sourceMappingURL=build.d.ts.map

package/dist/cli/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,2CAA2C;IAC3C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAoB/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsP9E;AAiDD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAIlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAItD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACxC,MAAM,IAAI,CAmCZ"}

package/dist/cli/commands/check-lexicon.d.ts

@@ -0,0 +1,19 @@
+export interface CheckItem {
+    name: string;
+    tier: 1 | 2 | 3;
+    pass: boolean;
+    detail?: string;
+}
+export interface CheckResult {
+    items: CheckItem[];
+    tier1Pass: boolean;
+}
+/**
+ * Run all completeness checks against a lexicon directory.
+ */
+export declare function checkLexicon(dir: string): CheckResult;
+/**
+ * Print the check result as a colored table or JSON.
+ */
+export declare function printCheckResult(result: CheckResult, json: boolean): void;
+//# sourceMappingURL=check-lexicon.d.ts.map

package/dist/cli/commands/check-lexicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-lexicon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check-lexicon.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAiDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAiSrD;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAmDzE"}

package/dist/cli/commands/describe.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `chant describe <component>` — project the effective, fully-resolved
+ * configuration for one named component, offline (source only; no live calls).
+ *
+ * `chant list` shows inventory and `chant graph` shows edges; neither shows the
+ * resolved property bag for a single thing. `describe` does: for a layered
+ * config (see the layered-config guide) it answers "what is the effective config
+ * for this component, after every spread/override?" without merging the layers
+ * by hand.
+ */
+export interface DescribeOptions {
+    /** The component to describe — a named export (declarable or composite instance). */
+    component: string;
+    /** Path to the infrastructure directory. */
+    path: string;
+    /** Output format. */
+    format: "text" | "json";
+}
+/** One resolved resource produced by the component. */
+export interface DescribedResource {
+    name: string;
+    lexicon: string;
+    entityType: string;
+    kind: string;
+    /** The resolved (post-merge, post-composite-expansion) property bag. */
+    props: unknown;
+}
+export interface DescribeResult {
+    success: boolean;
+    component: string;
+    /** True when the component is a composite instance (≥1 produced resource by prefix). */
+    composite: boolean;
+    resources: DescribedResource[];
+    output: string;
+}
+export declare function describeCommand(options: DescribeOptions): Promise<DescribeResult>;
+/** Print a describe result to the console. */
+export declare function printDescribeResult(result: DescribeResult): void;
+//# sourceMappingURL=describe.d.ts.map

package/dist/cli/commands/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/describe.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AA+BD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyCvF;AAqBD,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKhE"}

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,32 @@
+import type { Serializer } from "../../serializer.js";
+/**
+ * Diff command options
+ */
+export interface DiffOptions {
+    /** Path to infrastructure directory */
+    path: string;
+    /** Existing output file to diff against */
+    output?: string;
+    /** Serializers to use for serialization */
+    serializers: Serializer[];
+}
+/**
+ * Diff command result
+ */
+export interface DiffResult {
+    /** Whether the diff succeeded (no build errors) */
+    success: boolean;
+    /** Whether there are changes between current and previous */
+    hasChanges: boolean;
+    /** Unified diff output */
+    diff: string;
+}
+/**
+ * Execute the diff command
+ */
+export declare function diffCommand(options: DiffOptions): Promise<DiffResult>;
+/**
+ * Print diff result to console
+ */
+export declare function printDiffResult(result: DiffResult): void;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC3E;AA6ID;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAUxD"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+export interface DoctorCheck {
+    name: string;
+    status: "pass" | "fail" | "warn";
+    message?: string;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    success: boolean;
+}
+export declare function doctorCommand(path: string): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgNvE"}

package/dist/cli/commands/import.d.ts

@@ -0,0 +1,68 @@
+import type { LexiconPlugin, ResourceSelector } from "../../lexicon.js";
+/**
+ * Import command options
+ */
+export interface ImportOptions {
+    /** Path to template file */
+    templatePath: string;
+    /** Output directory (defaults to ./infra/) */
+    output?: string;
+    /** Force overwrite existing files */
+    force?: boolean;
+}
+/**
+ * Import command result
+ */
+export interface ImportResult {
+    /** Whether import succeeded */
+    success: boolean;
+    /** Generated files */
+    generatedFiles: string[];
+    /** Warning messages */
+    warnings: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Detected lexicon */
+    lexicon?: string;
+}
+/**
+ * Execute the import command
+ */
+export declare function importCommand(options: ImportOptions): Promise<ImportResult>;
+/**
+ * Live import options — read from a running cloud/cluster instead of a file.
+ */
+export interface LiveImportOptions {
+    /** Environment to resolve (passed to each lexicon's exportResources). */
+    environment: string;
+    /** Restrict to one lexicon by name (e.g. "aws", "k8s"). */
+    lexicon?: string;
+    /** Output directory (defaults to ./infra/). */
+    output?: string;
+    /** Force overwrite existing files. */
+    force?: boolean;
+    /** Selector forwarded to the lexicon. */
+    selector?: ResourceSelector;
+    /** Restrict to chant-owned resources (inert until ownership marking lands). */
+    owned?: boolean;
+    /** Keep server-defaulted fields instead of stripping to declared shape. */
+    verbatim?: boolean;
+}
+/**
+ * Import directly from a live environment: ask each lexicon's exportResources
+ * for full-fidelity IR, then generate chant TypeScript from it.
+ *
+ * Unlike file import, the live config may contain secrets — the caller prints a
+ * warning. Reuses the same by-category output organization as file import.
+ */
+export declare function importFromLive(options: LiveImportOptions): Promise<ImportResult>;
+/**
+ * Live-import core: given resolved plugins, export and generate. Split from
+ * plugin resolution so it can be tested with fake exporters (no cloud calls).
+ */
+export declare function liveImportFromPlugins(plugins: LexiconPlugin[], options: LiveImportOptions): Promise<ImportResult>;
+/**
+ * Print import result
+ */
+export declare function printImportResult(result: ImportResult): void;
+//# sourceMappingURL=import.d.ts.map

package/dist/cli/commands/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/import.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmID;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA8IjF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAatF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CAmFvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAsB5D"}

package/dist/cli/commands/init-lexicon/templates/codegen.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Codegen template generators for init-lexicon scaffold.
+ */
+export declare function generateCodegenGenerateTs(): string;
+export declare function generateCodegenGenerateCliTs(): string;
+export declare function generateCodegenNamingTs(): string;
+export declare function generateCodegenPackageTs(name: string): string;
+export declare function generateCodegenDocsTs(name: string): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/cli/commands/init-lexicon/templates/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/codegen.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,yBAAyB,IAAI,MAAM,CA4ElD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAUrD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAmChD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2B7D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2B1D"}

package/dist/cli/commands/init-lexicon/templates/docs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Docs site template generators for init-lexicon scaffold.
+ */
+export declare function generateDocsPackageJson(name: string): string;
+export declare function generateDocsTsConfig(): string;
+export declare function generateDocsAstroConfig(name: string): string;
+export declare function generateDocsContentConfig(): string;
+export declare function generateDocsIndexMdx(name: string): string;
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/commands/init-lexicon/templates/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB5D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CASlD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWzD"}

package/dist/cli/commands/init-lexicon/templates/examples.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Example template generators for init-lexicon scaffold.
+ */
+export declare function generateExamplePackageJson(name: string): string;
+export declare function generateExampleInfraTs(name: string, names: {
+    packageName: string;
+}): string;
+//# sourceMappingURL=examples.d.ts.map

package/dist/cli/commands/init-lexicon/templates/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/examples.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAc3F"}

package/dist/cli/commands/init-lexicon/templates/lint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lint template generators for init-lexicon scaffold.
+ */
+export declare function generateSampleRuleTs(names: {
+    rulePrefix: string;
+}): string;
+export declare function generateLintRulesIndexTs(): string;
+//# sourceMappingURL=lint.d.ts.map

package/dist/cli/commands/init-lexicon/templates/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoB1E;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD"}

package/dist/cli/commands/init-lexicon/templates/lsp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * LSP template generators for init-lexicon scaffold.
+ */
+export declare function generateLspCompletionsTs(name: string): string;
+export declare function generateLspHoverTs(name: string): string;
+//# sourceMappingURL=lsp.d.ts.map

package/dist/cli/commands/init-lexicon/templates/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/lsp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBvD"}

package/dist/cli/commands/init-lexicon/templates/plugin.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plugin and index template generators for init-lexicon scaffold.
+ */
+export declare function generatePluginTs(name: string, names: {
+    pluginVarName: string;
+    serializerVarName: string;
+}): string;
+export declare function generateIndexTs(names: {
+    pluginVarName: string;
+    serializerVarName: string;
+}): string;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/commands/init-lexicon/templates/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/init-lexicon/templates/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA4FlH;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAWnG"}