@usine/config 0.0.1 → 0.2.0

package/dist/instance/instance.js

@@ -0,0 +1,21 @@
+import { Option, Schema } from "effect";
+import { UsineConfig } from "../factory.js";
+import { LoopFile, QuarantinedLoop, loopPath } from "../loop.js";
+import { AgentFile, InvalidAgent } from "../agent.js";
+import { ConfigWarning } from "./diagnostics.js";
+import { referenceIndex, loopReferenceFailure } from "./references.js";
+/** One consistent snapshot of an instance folder. Construction fails if a loop references a name the instance does not have. */
+export class LoadedInstance extends Schema.Class("@usine/config/LoadedInstance")(Schema.Struct({
+    config: UsineConfig,
+    agents: Schema.Array(AgentFile),
+    invalidAgents: Schema.Array(InvalidAgent),
+    loops: Schema.Array(LoopFile),
+    quarantinedLoops: Schema.Array(QuarantinedLoop),
+    warnings: Schema.Array(ConfigWarning),
+}).check(Schema.makeFilter(({ agents, config, loops }) => {
+    const references = referenceIndex(config, agents);
+    return loops.every((loop) => Option.isNone(loopReferenceFailure(loopPath(loop.name), loop, references)));
+}, { message: "Expected every loop to reference the loaded roster and registry" }))) {
+}
+export { UndeclaredLaneLabelWarning, UndeclaredTriggerLabelWarning, ConfigWarning, } from "./diagnostics.js";
+//# sourceMappingURL=instance.js.map

package/dist/instance/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../src/instance/instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,gIAAgI;AAChI,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,KAAK,CAAiB,8BAA8B,CAAC,CAC9F,MAAM,CAAC,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;CACtC,CAAC,CAAC,KAAK,CACN,MAAM,CAAC,UAAU,CACf,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IAC5B,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1B,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC,EACD,EAAE,OAAO,EAAE,iEAAiE,EAAE,CAC/E,CACF,CACF;CAAG;AAEJ,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/instance/references.d.ts

@@ -0,0 +1,21 @@
+import { AgentName } from "@usine/core/agent";
+import { RepositoryName } from "@usine/core/repository";
+import { Option } from "effect";
+import { InstancePath, ConfigFileError } from "../file.ts";
+import { RegistryTag, UsineConfig } from "../factory.ts";
+import { LoopFile } from "../loop.ts";
+import type { AgentFile } from "../agent.ts";
+/** The agent and selector names a loop may reference in one loaded instance. */
+export interface ReferenceIndex {
+    readonly agentNames: ReadonlySet<AgentName>;
+    readonly registryTags: ReadonlySet<RegistryTag>;
+    readonly repoNames: ReadonlySet<RepositoryName>;
+}
+export declare const referenceIndex: (config: UsineConfig, agents: ReadonlyArray<AgentFile>) => ReferenceIndex;
+/**
+ * Returns the reference error that quarantines this loop, if it names an agent
+ * or selector entry the instance does not have. The folder loader reports it
+ * per file and LoadedInstance refuses to construct with it.
+ */
+export declare const loopReferenceFailure: (file: InstancePath, loop: LoopFile, references: ReferenceIndex) => Option.Option<ConfigFileError>;
+//# sourceMappingURL=references.d.ts.map

package/dist/instance/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/instance/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;CACjD;AAED,eAAO,MAAM,cAAc,WACjB,WAAW,UACX,aAAa,CAAC,SAAS,CAAC,KAC/B,cAID,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SACzB,YAAY,QACZ,QAAQ,cACF,cAAc,KACzB,MAAM,CAAC,MAAM,CAAC,eAAe,CA4B/B,CAAC"}

package/dist/instance/references.js

@@ -0,0 +1,38 @@
+import { AgentName } from "@usine/core/agent";
+import { RepositoryName } from "@usine/core/repository";
+import { Option } from "effect";
+import { InstancePath, ConfigFileError } from "../file.js";
+import { RegistryTag, UsineConfig } from "../factory.js";
+import { LoopFile } from "../loop.js";
+export const referenceIndex = (config, agents) => ({
+    agentNames: new Set(agents.map(({ name }) => name)),
+    registryTags: new Set(config.repos.flatMap(({ tags }) => tags)),
+    repoNames: new Set(config.repos.map(({ name }) => name)),
+});
+/**
+ * Returns the reference error that quarantines this loop, if it names an agent
+ * or selector entry the instance does not have. The folder loader reports it
+ * per file and LoadedInstance refuses to construct with it.
+ */
+export const loopReferenceFailure = (file, loop, references) => {
+    const referenceError = (message) => Option.some(new ConfigFileError({ file, stage: "reference", expression: Option.none(), message }));
+    if (!references.agentNames.has(loop.agent)) {
+        return referenceError(`Unknown agent: ${loop.agent}`);
+    }
+    if (Option.isNone(loop.selector))
+        return Option.none();
+    if (Option.isSome(loop.selector.value.repos)) {
+        const missing = loop.selector.value.repos.value.filter((name) => !references.repoNames.has(name));
+        if (missing.length > 0) {
+            return referenceError(`Unknown selector repos: ${missing.join(", ")}`);
+        }
+    }
+    if (Option.isSome(loop.selector.value.tags)) {
+        const missing = loop.selector.value.tags.value.filter((tag) => !references.registryTags.has(tag));
+        if (missing.length > 0) {
+            return referenceError(`Unknown selector tags: ${missing.join(", ")}`);
+        }
+    }
+    return Option.none();
+};
+//# sourceMappingURL=references.js.map

package/dist/instance/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/instance/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAUtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAmB,EACnB,MAAgC,EAChB,EAAE,CAAC,CAAC;IACpB,UAAU,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACnD,YAAY,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAS,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAkB,EAClB,IAAc,EACd,UAA0B,EACM,EAAE;IAClC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAkC,EAAE,CACzE,MAAM,CAAC,IAAI,CACT,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CACtF,CAAC;IACJ,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,cAAc,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CACpD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAC1C,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,cAAc,CAAC,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CACnD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAC3C,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,cAAc,CAAC,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC"}

package/dist/instance-folder.d.ts

@@ -0,0 +1,14 @@
+import { InstanceDirectory } from "@usine/core/instance";
+import { Context, Effect, FileSystem, Layer, Path } from "effect";
+import { FactoryConfigError } from "./file.ts";
+import { LoadedInstance } from "./instance/instance.ts";
+import { ConfigParser } from "./parser.ts";
+declare const InstanceFolder_base: Context.ServiceClass<InstanceFolder, "@usine/config/InstanceFolder", {
+    readonly load: (root: InstanceDirectory) => Effect.Effect<LoadedInstance, FactoryConfigError>;
+}>;
+/** Loads an instance folder; an invalid `usine.yaml` fails the load, an invalid loop is quarantined and its siblings still load. */
+export declare class InstanceFolder extends InstanceFolder_base {
+    static readonly layer: Layer.Layer<InstanceFolder, never, ConfigParser | FileSystem.FileSystem | Path.Path>;
+}
+export {};
+//# sourceMappingURL=instance-folder.d.ts.map

package/dist/instance-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-folder.d.ts","sourceRoot":"","sources":["../src/instance-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAU,IAAI,EAAU,MAAM,QAAQ,CAAC;AAElF,OAAO,EAAmB,kBAAkB,EAAgB,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;;mBAoBxB,CAAC,IAAI,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC;;AAJjG,oIAAoI;AACpI,qBAAa,cAAe,SAAQ,mBAKD;IACjC,MAAM,CAAC,QAAQ,CAAC,KAAK,uFA0JnB;CACH"}

package/dist/instance-folder.js

@@ -0,0 +1,101 @@
+import { InstanceDirectory } from "@usine/core/instance";
+import { Context, Effect, FileSystem, Layer, Option, Path, Result } from "effect";
+import { InvalidAgent } from "./agent.js";
+import { ConfigFileError, FactoryConfigError, InstancePath } from "./file.js";
+import { LoadedInstance } from "./instance/instance.js";
+import { QuarantinedLoop } from "./loop.js";
+import { loopReferenceFailure, referenceIndex } from "./instance/references.js";
+import { ConfigParser } from "./parser.js";
+const FILE_CONCURRENCY = 16;
+const factoryError = (error) => new FactoryConfigError({
+    file: error.file,
+    stage: error.stage,
+    message: error.message,
+});
+/** Loads an instance folder; an invalid `usine.yaml` fails the load, an invalid loop is quarantined and its siblings still load. */
+export class InstanceFolder extends Context.Service()("@usine/config/InstanceFolder") {
+    static layer = Layer.effect(InstanceFolder, Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const path = yield* Path.Path;
+        const parser = yield* ConfigParser;
+        const readFile = Effect.fn("InstanceFolder.readFile")((absolutePath, file) => fileSystem.readFileString(absolutePath).pipe(Effect.mapError((error) => new ConfigFileError({
+            file,
+            stage: "read",
+            expression: Option.none(),
+            message: error.message,
+        }))));
+        const markdownFiles = Effect.fn("InstanceFolder.markdownFiles")((root, directory) => fileSystem.readDirectory(path.join(root, directory)).pipe(Effect.map((files) => files.filter((file) => file.endsWith(".md")).sort()), Effect.mapError((error) => new FactoryConfigError({
+            file: InstancePath.make(directory),
+            stage: "read",
+            message: error.message,
+        }))));
+        const loadMarkdownFiles = (root, directory, parseFile) => Effect.gen(function* () {
+            const files = yield* markdownFiles(root, directory);
+            return yield* Effect.forEach(files, (name) => {
+                const file = InstancePath.make(`${directory}/${name}`);
+                return readFile(path.join(root, file), file).pipe(Effect.flatMap((source) => parseFile(file, source)), Effect.result, Effect.map((result) => ({ file, result })));
+            }, { concurrency: FILE_CONCURRENCY });
+        });
+        return {
+            load: Effect.fn("InstanceFolder.load")((root) => Effect.gen(function* () {
+                const configFile = InstancePath.make("usine.yaml");
+                const configSource = yield* readFile(path.join(root, configFile), configFile).pipe(Effect.mapError(factoryError));
+                const config = yield* parser
+                    .parseUsineYaml(configFile, configSource)
+                    .pipe(Effect.mapError(factoryError));
+                const parsed = yield* Effect.all({
+                    agents: loadMarkdownFiles(root, "agents", parser.parseAgentFile),
+                    loops: loadMarkdownFiles(root, "loops", parser.parseLoopFile),
+                }, { concurrency: 2 });
+                const agents = [];
+                const invalidAgents = [];
+                for (const entry of parsed.agents) {
+                    if (Result.isSuccess(entry.result))
+                        agents.push(entry.result.success);
+                    else {
+                        invalidAgents.push(new InvalidAgent({ file: entry.file, error: entry.result.failure }));
+                    }
+                }
+                const references = referenceIndex(config, agents);
+                const loops = [];
+                const quarantinedLoops = [];
+                for (const entry of parsed.loops) {
+                    if (Result.isFailure(entry.result)) {
+                        quarantinedLoops.push(new QuarantinedLoop({ file: entry.file, error: entry.result.failure }));
+                        continue;
+                    }
+                    const referenceFailure = loopReferenceFailure(entry.file, entry.result.success, references);
+                    if (Option.isSome(referenceFailure)) {
+                        quarantinedLoops.push(new QuarantinedLoop({ file: entry.file, error: referenceFailure.value }));
+                    }
+                    else
+                        loops.push(entry.result.success);
+                }
+                const warnings = yield* parser.configWarnings(config, loops).pipe(Effect.catch((error) => Effect.logError("Config warning analysis failed; loaded the valid instance without warnings", {
+                    errorTag: error._tag,
+                    expression: error.source,
+                    message: error.message,
+                }).pipe(Effect.as([]))));
+                yield* Effect.forEach(warnings, (warning) => warning._tag === "UndeclaredLaneLabelWarning"
+                    ? Effect.logWarning("Board Lane references an undeclared GitHub label", {
+                        repository: warning.repository,
+                        lane: warning.lane,
+                        label: warning.label,
+                    })
+                    : Effect.logWarning("Loop trigger references an undeclared GitHub label", {
+                        loop: warning.loop,
+                        label: warning.label,
+                    }), { discard: true });
+                return new LoadedInstance({
+                    config,
+                    agents,
+                    invalidAgents,
+                    loops,
+                    quarantinedLoops,
+                    warnings,
+                });
+            })),
+        };
+    }));
+}
+//# sourceMappingURL=instance-folder.js.map

package/dist/instance-folder.js.map

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

package/dist/label.d.ts

@@ -0,0 +1,22 @@
+import { Schema } from "effect";
+/**
+ * GitHub trims label names and caps them at 50 characters. A name outside that
+ * contract never matches the catalog and would be re-created every cycle.
+ */
+export declare const GitHubLabelName: Schema.brand<Schema.String, "GitHubLabelName">;
+export type GitHubLabelName = typeof GitHubLabelName.Type;
+/** Compare label names on this key: GitHub matches them case-insensitively. */
+export declare const canonicalLabelName: (name: string) => string;
+/** Six hex digits without a leading hash, as GitHub stores label colors. */
+export declare const GitHubLabelColor: Schema.brand<Schema.String, "GitHubLabelColor">;
+export type GitHubLabelColor = typeof GitHubLabelColor.Type;
+declare const DeclaredLabel_base: Schema.Class<DeclaredLabel, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "GitHubLabelName">;
+    readonly color: Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "GitHubLabelColor">>;
+    readonly description: Schema.OptionFromOptionalKey<Schema.String>;
+}>, {}>;
+/** A label the factory creates in every managed repository. */
+export declare class DeclaredLabel extends DeclaredLabel_base {
+}
+export {};
+//# sourceMappingURL=label.d.ts.map

package/dist/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../src/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,eAAe,gDAKW,CAAC;AAExC,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAE1D,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAA4B,CAAC;AAE/E,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,iDAIW,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;;AAQ5D,+DAA+D;AAC/D,qBAAa,aAAc,SAAQ,kBAIjC;CAAG"}

package/dist/label.js

@@ -0,0 +1,25 @@
+import { Schema } from "effect";
+/**
+ * GitHub trims label names and caps them at 50 characters. A name outside that
+ * contract never matches the catalog and would be re-created every cycle.
+ */
+export const GitHubLabelName = Schema.String.check(Schema.isPattern(/^\S(?:.*\S)?$/u, {
+    message: "Expected a GitHub label name without surrounding whitespace",
+}), Schema.isMaxLength(50, { message: "Expected a GitHub label name of at most 50 characters" })).pipe(Schema.brand("GitHubLabelName"));
+/** Compare label names on this key: GitHub matches them case-insensitively. */
+export const canonicalLabelName = (name) => name.toLowerCase();
+/** Six hex digits without a leading hash, as GitHub stores label colors. */
+export const GitHubLabelColor = Schema.String.check(Schema.isPattern(/^[0-9a-fA-F]{6}$/u, {
+    message: "Expected a six-digit hex GitHub label color without #",
+})).pipe(Schema.brand("GitHubLabelColor"));
+const GitHubLabelDescription = Schema.String.check(Schema.isMaxLength(100, {
+    message: "Expected a GitHub label description of at most 100 characters",
+}));
+/** A label the factory creates in every managed repository. */
+export class DeclaredLabel extends Schema.Class("@usine/config/DeclaredLabel")({
+    name: GitHubLabelName,
+    color: Schema.OptionFromOptionalKey(GitHubLabelColor),
+    description: Schema.OptionFromOptionalKey(GitHubLabelDescription),
+}) {
+}
+//# sourceMappingURL=label.js.map

package/dist/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../src/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAChD,MAAM,CAAC,SAAS,CAAC,gBAAgB,EAAE;IACjC,OAAO,EAAE,6DAA6D;CACvE,CAAC,EACF,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAC7F,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAIxC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AAE/E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CACjD,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE;IACpC,OAAO,EAAE,uDAAuD;CACjE,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAIzC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAChD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE;IACtB,OAAO,EAAE,+DAA+D;CACzE,CAAC,CACH,CAAC;AAEF,+DAA+D;AAC/D,MAAM,OAAO,aAAc,SAAQ,MAAM,CAAC,KAAK,CAAgB,6BAA6B,CAAC,CAAC;IAC5F,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,MAAM,CAAC,qBAAqB,CAAC,gBAAgB,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC,qBAAqB,CAAC,sBAAsB,CAAC;CAClE,CAAC;CAAG"}

package/dist/loop.d.ts

@@ -0,0 +1,42 @@
+import { LoopName } from "@usine/core/loop";
+import { Schema } from "effect";
+import { InstancePath, ConfigFileError } from "./file.ts";
+/** The Loop's Markdown task template, with CEL expressions inside `{{ ... }}`. */
+export declare const PromptTemplate: Schema.brand<Schema.String, "PromptTemplate">;
+export type PromptTemplate = typeof PromptTemplate.Type;
+declare const LoopFile_base: Schema.Class<LoopFile, Schema.Struct<{
+    readonly name: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly trigger: Schema.Union<readonly [typeof import("./trigger.ts").IssueTrigger, typeof import("./trigger.ts").PullRequestTrigger, typeof import("./trigger.ts").ScheduleTrigger]>;
+    readonly selector: Schema.Option<Schema.decodeTo<Schema.declareConstructor<import("./selector.ts").Selector, {
+        readonly repos?: readonly string[];
+        readonly tags?: readonly string[];
+    }, readonly [Schema.Struct<{
+        readonly repos: Schema.OptionFromOptionalKey<Schema.$Array<Schema.brand<Schema.String, "RepositoryName">>>;
+        readonly tags: Schema.OptionFromOptionalKey<Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>>;
+    }>], {
+        readonly repos: Schema.OptionIso<Schema.toType<Schema.$Array<Schema.brand<Schema.String, "RepositoryName">>>>;
+        readonly tags: Schema.OptionIso<Schema.toType<Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>>>;
+    }>, Schema.Struct<{
+        readonly repos: Schema.OptionFromOptionalKey<Schema.$Array<Schema.brand<Schema.String, "RepositoryName">>>;
+        readonly tags: Schema.OptionFromOptionalKey<Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>>;
+    }>, never, never>>;
+    readonly approval: Schema.Literals<readonly ["none", "required"]>;
+    readonly maxCycles: Schema.withConstructorDefault<Schema.withDecodingDefaultKey<Schema.brand<Schema.Int, "CycleLimit">, never>>;
+    readonly step: Schema.brand<Schema.NonEmptyString, "StepName">;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+    readonly body: Schema.brand<Schema.String, "PromptTemplate">;
+}>, {}>;
+/** A Loop parsed from `loops/<name>.md`; the filename defines its identity. */
+export declare class LoopFile extends LoopFile_base {
+}
+declare const QuarantinedLoop_base: Schema.Class<QuarantinedLoop, Schema.Struct<{
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly error: typeof ConfigFileError;
+}>, {}>;
+/** A Loop excluded from execution because its file could not be loaded or its references resolved. */
+export declare class QuarantinedLoop extends QuarantinedLoop_base {
+}
+/** The file a loop name refers to. */
+export declare const loopPath: (name: LoopName) => InstancePath;
+export {};
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAuB,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAW1D,kFAAkF;AAClF,eAAO,MAAM,cAAc,+CAE1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAExD,+EAA+E;AAC/E,qBAAa,QAAS,SAAQ,aAY5B;CAAG;;;;;AAEL,sGAAsG;AACtG,qBAAa,eAAgB,SAAQ,oBAKpC;CAAG;AAEJ,sCAAsC;AACtC,eAAO,MAAM,QAAQ,SAAU,QAAQ,KAAG,YAAqD,CAAC"}

package/dist/loop.js

@@ -0,0 +1,36 @@
+import { AgentName } from "@usine/core/agent";
+import { CycleLimit, DEFAULT_CYCLE_LIMIT } from "@usine/core/cycle-budget";
+import { LoopName, ApprovalRequirement } from "@usine/core/loop";
+import { StepName } from "@usine/core/step";
+import { Effect, Schema } from "effect";
+import { InstancePath, ConfigFileError } from "./file.js";
+import { nonBlankString } from "./checks.js";
+import { ValidSelector } from "./selector.js";
+import { Trigger } from "./trigger.js";
+const KebabCase = Schema.isPattern(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u, {
+    message: "Expected a kebab-case filename identity",
+});
+const LoopFileName = LoopName.check(KebabCase);
+/** The Loop's Markdown task template, with CEL expressions inside `{{ ... }}`. */
+export const PromptTemplate = nonBlankString("Expected a non-blank Markdown prompt").pipe(Schema.brand("PromptTemplate"));
+/** A Loop parsed from `loops/<name>.md`; the filename defines its identity. */
+export class LoopFile extends Schema.Class("@usine/config/LoopFile")({
+    name: LoopFileName,
+    trigger: Trigger,
+    selector: Schema.Option(ValidSelector),
+    approval: ApprovalRequirement,
+    maxCycles: CycleLimit.pipe(Schema.withDecodingDefaultKey(Effect.succeed(DEFAULT_CYCLE_LIMIT)), Schema.withConstructorDefault(Effect.succeed(DEFAULT_CYCLE_LIMIT))),
+    step: StepName,
+    agent: AgentName,
+    body: PromptTemplate,
+}) {
+}
+/** A Loop excluded from execution because its file could not be loaded or its references resolved. */
+export class QuarantinedLoop extends Schema.Class("@usine/config/QuarantinedLoop")({
+    file: InstancePath,
+    error: ConfigFileError,
+}) {
+}
+/** The file a loop name refers to. */
+export const loopPath = (name) => InstancePath.make(`loops/${name}.md`);
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,6BAA6B,EAAE;IAChE,OAAO,EAAE,yCAAyC;CACnD,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAE/C,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC,sCAAsC,CAAC,CAAC,IAAI,CACvF,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAC/B,CAAC;AAIF,+EAA+E;AAC/E,MAAM,OAAO,QAAS,SAAQ,MAAM,CAAC,KAAK,CAAW,wBAAwB,CAAC,CAAC;IAC7E,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;IACtC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,UAAU,CAAC,IAAI,CACxB,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAClE,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CACnE;IACD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,cAAc;CACrB,CAAC;CAAG;AAEL,sGAAsG;AACtG,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,KAAK,CAAkB,+BAA+B,CAAC,CACjG;IACE,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,eAAe;CACvB,CACF;CAAG;AAEJ,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAgB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,25 @@
+import { ExpressionEngine, type ExpressionCheckError } from "@usine/expression/expression-engine";
+import { Context, Effect, Layer, Schema } from "effect";
+import { AgentFile } from "./agent.ts";
+import { ConfigFileError, InstancePath } from "./file.ts";
+import { type ConfigWarning } from "./instance/diagnostics.ts";
+import { LoopFile } from "./loop.ts";
+import { UsineConfig } from "./factory.ts";
+declare const ConfigParser_base: Context.ServiceClass<ConfigParser, "@usine/config/ConfigParser", {
+    /** Reads registry and factory settings from `source`; `file` identifies the source in diagnostics. */
+    readonly parseUsineYaml: (file: InstancePath, source: string) => Effect.Effect<UsineConfig, ConfigFileError>;
+    /** Reads an Agent's brain and standing instructions; `file` supplies its filename-derived identity. */
+    readonly parseAgentFile: (file: InstancePath, source: string) => Effect.Effect<AgentFile, ConfigFileError>;
+    /** Reads a Loop and checks its selection and prompt expressions; `file` supplies its identity. */
+    readonly parseLoopFile: (file: InstancePath, source: string) => Effect.Effect<LoopFile, ConfigFileError>;
+    /** Reports undeclared labels used by Board lanes or Loop conditions without rejecting otherwise valid configuration. */
+    readonly configWarnings: (config: UsineConfig, loops: ReadonlyArray<LoopFile>) => Effect.Effect<ReadonlyArray<ConfigWarning>, ExpressionCheckError>;
+    /** Renders the Loop's `{{ ... }}` expressions using `context.item` for the trigger payload and `context.repo` for the repository. */
+    readonly renderPrompt: (loop: LoopFile, context: Schema.JsonObject) => Effect.Effect<string, ConfigFileError>;
+}>;
+/** Parses supplied instance-file contents and checks the expressions that select Items and render task prompts. */
+export declare class ConfigParser extends ConfigParser_base {
+    static readonly layer: Layer.Layer<ConfigParser, never, ExpressionEngine>;
+}
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAEhB,KAAK,oBAAoB,EAG1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,EAAe,MAAM,QAAQ,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAA4B,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;;IA+QvC,sGAAsG;6BAC7E,CACvB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC;IAChD,uGAAuG;6BAC9E,CACvB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC;IAC9C,kGAAkG;4BAC1E,CACtB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;IAC7C,wHAAwH;6BAC/F,CACvB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACtE,qIAAqI;2BAC9G,CACrB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,CAAC,UAAU,KACvB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;;AA5B/C,mHAAmH;AACnH,qBAAa,YAAa,SAAQ,iBA6BD;IAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,qDAcnB;CACH"}

package/dist/parser.js

@@ -0,0 +1,204 @@
+import { StepName } from "@usine/core/step";
+import { ApprovalRequirement, LoopName } from "@usine/core/loop";
+import { ExpressionEngine, Source, } from "@usine/expression/expression-engine";
+import { Context, Effect, Layer, Option, Schema, SchemaIssue } from "effect";
+import { splitMarkdown } from "./frontmatter.js";
+import { AgentFile } from "./agent.js";
+import { canonicalLabelName, GitHubLabelName } from "./label.js";
+import { ConfigFileError, InstancePath } from "./file.js";
+import { UndeclaredLaneLabelWarning, UndeclaredTriggerLabelWarning, } from "./instance/diagnostics.js";
+import { LoopFile, loopPath, PromptTemplate } from "./loop.js";
+import { AgentPersona, AgentName } from "@usine/core/agent";
+import { Trigger } from "./trigger.js";
+import { UsineConfig } from "./factory.js";
+import { ValidSelector } from "./selector.js";
+import { Effort, Harness, ModelId } from "@usine/core/agent/brain";
+import { environmentFor } from "./payload-slices.js";
+import { parseYamlDocument } from "./yaml/document.js";
+const formatIssue = SchemaIssue.makeFormatterDefault();
+class LoopFrontmatter extends Schema.Class("@usine/config/LoopFrontmatter")({
+    trigger: Trigger,
+    selector: Schema.OptionFromOptionalKey(ValidSelector),
+    approval: ApprovalRequirement.pipe(Schema.withDecodingDefaultKey(Effect.succeed("none"))),
+    step: StepName.pipe(Schema.withDecodingDefaultKey(Effect.succeed("run"))),
+    agent: AgentName,
+    maxCycles: LoopFile.fields.maxCycles,
+}) {
+}
+const AuthoredLoopFrontmatter = LoopFrontmatter.pipe(Schema.encodeKeys({ maxCycles: "max_cycles" }));
+class AgentFrontmatter extends Schema.Class("@usine/config/AgentFrontmatter")({
+    harness: Harness,
+    model: ModelId,
+    effort: Effort,
+    parent_model: Schema.OptionFromOptionalKey(ModelId),
+    parent_effort: Schema.OptionFromOptionalKey(Effort),
+}) {
+}
+const schemaError = (file, error) => new ConfigFileError({
+    file,
+    stage: "schema",
+    expression: Option.none(),
+    message: formatIssue(error.issue),
+});
+const decodeJson = Schema.decodeUnknownEffect(Schema.Json);
+const parseYaml = (file, source) => Effect.gen(function* () {
+    const document = yield* parseYamlDocument(file, source);
+    return yield* decodeJson(document.toJS()).pipe(Effect.mapError((error) => new ConfigFileError({
+        file,
+        stage: "yaml",
+        expression: Option.none(),
+        message: formatIssue(error.issue),
+    })));
+});
+const expressionError = (file, error) => new ConfigFileError({
+    file,
+    stage: "expression",
+    expression: Option.some(error.source),
+    message: error.message,
+});
+const markdownName = (file) => {
+    const basename = file.slice(file.lastIndexOf("/") + 1);
+    if (!basename.endsWith(".md")) {
+        return new ConfigFileError({
+            file,
+            stage: "schema",
+            expression: Option.none(),
+            message: "Expected a .md filename",
+        });
+    }
+    return Effect.succeed(basename.slice(0, -3));
+};
+const loopName = (file) => markdownName(file).pipe(Effect.flatMap((name) => Schema.decodeUnknownEffect(LoopFile.fields.name)(name).pipe(Effect.mapError((error) => schemaError(file, error)))));
+const agentName = (file) => markdownName(file).pipe(Effect.flatMap((name) => Schema.decodeUnknownEffect(AgentName)(name).pipe(Effect.mapError((error) => schemaError(file, error)))));
+const interpolations = (file, body) => Effect.gen(function* () {
+    const found = [];
+    let cursor = 0;
+    while (cursor < body.length) {
+        const start = body.indexOf("{{", cursor);
+        if (start < 0)
+            break;
+        const end = body.indexOf("}}", start + 2);
+        if (end < 0) {
+            return yield* new ConfigFileError({
+                file,
+                stage: "expression",
+                expression: Option.none(),
+                message: `Unclosed prompt interpolation at character ${start}`,
+            });
+        }
+        const expression = body.slice(start + 2, end).trim();
+        const parsed = yield* Schema.decodeUnknownEffect(Source)(expression).pipe(Effect.mapError((error) => schemaError(file, error)));
+        found.push({ source: parsed, start, end: end + 2 });
+        cursor = end + 2;
+    }
+    return found;
+});
+const render = (engine, loop, context) => {
+    const file = loopPath(loop.name);
+    const environment = environmentFor(loop.trigger.on);
+    return Effect.gen(function* () {
+        const expressions = yield* interpolations(file, loop.body);
+        const rendered = yield* Effect.forEach(expressions, (expression) => engine.evaluateScalar(expression.source, environment, context).pipe(Effect.mapError((error) => expressionError(file, error)), Effect.map((value) => ({ expression, value }))));
+        let output = "";
+        let cursor = 0;
+        for (const { expression, value } of rendered) {
+            output += loop.body.slice(cursor, expression.start);
+            output += String(value);
+            cursor = expression.end;
+        }
+        return output + loop.body.slice(cursor);
+    });
+};
+const parseUsineYaml = Effect.fn("ConfigParser.parseUsineYaml")((file, source) => Effect.gen(function* () {
+    const yaml = yield* parseYaml(file, source);
+    return yield* Schema.decodeUnknownEffect(UsineConfig)(yaml, {
+        onExcessProperty: "error",
+    }).pipe(Effect.mapError((error) => schemaError(file, error)));
+}));
+const parseAgentFile = Effect.fn("ConfigParser.parseAgentFile")((file, source) => Effect.gen(function* () {
+    const name = yield* agentName(file);
+    const markdown = yield* splitMarkdown(file, source);
+    const yaml = yield* parseYaml(file, markdown.yaml);
+    const frontmatter = yield* Schema.decodeUnknownEffect(AgentFrontmatter)(yaml, {
+        onExcessProperty: "error",
+    }).pipe(Effect.mapError((error) => schemaError(file, error)));
+    const persona = yield* Schema.decodeUnknownEffect(AgentPersona)(markdown.body).pipe(Effect.mapError((error) => schemaError(file, error)));
+    return new AgentFile({
+        name,
+        harness: frontmatter.harness,
+        model: frontmatter.model,
+        effort: frontmatter.effort,
+        parentModel: frontmatter.parent_model,
+        parentEffort: frontmatter.parent_effort,
+        persona,
+    });
+}));
+const makeParseLoopFile = (engine) => Effect.fn("ConfigParser.parseLoopFile")((file, source) => Effect.gen(function* () {
+    const name = yield* loopName(file);
+    const markdown = yield* splitMarkdown(file, source);
+    const yaml = yield* parseYaml(file, markdown.yaml);
+    const frontmatter = yield* Schema.decodeUnknownEffect(AuthoredLoopFrontmatter)(yaml, {
+        onExcessProperty: "error",
+    }).pipe(Effect.mapError((error) => schemaError(file, error)));
+    const body = yield* Schema.decodeUnknownEffect(PromptTemplate)(markdown.body).pipe(Effect.mapError((error) => schemaError(file, error)));
+    const environment = environmentFor(frontmatter.trigger.on);
+    yield* engine
+        .checkBoolean(frontmatter.trigger.if, environment)
+        .pipe(Effect.mapError((error) => expressionError(file, error)));
+    const promptExpressions = yield* interpolations(file, body);
+    yield* Effect.forEach(promptExpressions, ({ source: expression }) => engine
+        .checkScalar(expression, environment)
+        .pipe(Effect.mapError((error) => expressionError(file, error))), { discard: true });
+    return new LoopFile({
+        name,
+        trigger: frontmatter.trigger,
+        selector: frontmatter.selector,
+        approval: frontmatter.approval,
+        maxCycles: frontmatter.maxCycles,
+        step: frontmatter.step,
+        agent: frontmatter.agent,
+        body,
+    });
+}));
+const decodeLabelName = Schema.decodeUnknownOption(GitHubLabelName);
+const makeConfigWarnings = (engine) => Effect.fn("ConfigParser.configWarnings")(function* (config, loops) {
+    const declared = new Set(config.labels.map(({ name }) => canonicalLabelName(name)));
+    const warnings = [];
+    for (const repository of config.repos) {
+        for (const lane of repository.lanes) {
+            for (const source of lane.sources) {
+                if ("label" in source && !declared.has(canonicalLabelName(source.label))) {
+                    warnings.push(new UndeclaredLaneLabelWarning({
+                        repository: repository.name,
+                        lane: lane.name,
+                        label: source.label,
+                    }));
+                }
+            }
+        }
+    }
+    for (const loop of loops) {
+        const literals = yield* engine.relatedStringLiterals(loop.trigger.if, ["item", "labels"]);
+        for (const literal of literals) {
+            const label = decodeLabelName(literal);
+            if (Option.isSome(label) && !declared.has(canonicalLabelName(label.value))) {
+                warnings.push(new UndeclaredTriggerLabelWarning({ loop: loop.name, label: label.value }));
+            }
+        }
+    }
+    return warnings;
+});
+/** Parses supplied instance-file contents and checks the expressions that select Items and render task prompts. */
+export class ConfigParser extends Context.Service()("@usine/config/ConfigParser") {
+    static layer = Layer.effect(ConfigParser, Effect.gen(function* () {
+        const engine = yield* ExpressionEngine;
+        return {
+            configWarnings: makeConfigWarnings(engine),
+            parseUsineYaml,
+            parseAgentFile,
+            parseLoopFile: makeParseLoopFile(engine),
+            renderPrompt: Effect.fn("ConfigParser.renderPrompt")((loop, context) => render(engine, loop, context)),
+        };
+    }));
+}
+//# sourceMappingURL=parser.js.map