@usine/config 0.0.1 → 0.2.0

package/README.md

@@ -1,5 +1,53 @@
 # @usine/config
 
-Config file machinery for [usine](https://github.com/basaltbytes/usine), an agent-agnostic software factory: parse, validate, and surgically rewrite the instance repo's files — `usine.yaml` (version, registry, settings), loop files (`loops/*.md`), and agent files (`agents/*.md`). Markdown-with-frontmatter parsing, strict schema validation, and a comment-preserving YAML-AST writer so UI edits never clobber hand-authored formatting.
+Reads and edits the authored files in a [usine](https://github.com/basaltbytes/usine) instance folder:
 
-Part of usine. This block is not implemented yet — its 0.0.x releases reserve the seam while the engine grows. Everything here is 0.x: APIs change without notice.
+- `usine.yaml` defines the schema version, factory-wide GitHub labels, managed-repo registry, settings, workers, webhook mode, and operator login.
+- `loops/*.md` combines strict YAML frontmatter with a Markdown prompt. The parser type-checks the trigger and every `{{ CEL expression }}` against that trigger's payload.
+- `agents/*.md` records a named agent's harness, model, effort, optional parent model, optional parent effort, and persona.
+- `updateYaml` and `updateFrontmatter` change one path through the YAML document tree while retaining comments, key order, and the Markdown body.
+
+Authored keys are snake_case (`poll_interval`, `max_concurrent_attempts`); the decoded domain types expose camelCase fields (`pollInterval`, `maxConcurrentAttempts`). The rename is part of the schema, so edits encode back to the authored casing.
+
+Declare the GitHub labels used by Loops and Board lanes once. Usine provisions missing declarations in every managed repository; existing definitions are never edited or deleted. `color` is an optional six-digit hexadecimal value without `#`:
+
+```yaml
+labels:
+  - name: ready-for-agent
+    color: a2eeef
+    description: Ready for an agent to claim
+  - name: ready-for-review
+```
+
+Label names follow GitHub's contract: at most 50 characters, no surrounding whitespace, and unique without regard to case; descriptions are at most 100 characters. A lane source or trigger-expression string literal that refers to an undeclared label becomes a non-blocking entry in `LoadedInstance.warnings`; prose in prompt bodies is not inspected.
+
+Set `settings.max_children` to the number of child sessions one Attempt may spawn. The default is 4, and the count includes sequential and concurrent child sessions.
+
+Each managed repository can define an exclusive Board lane map. A lane accepts one or more GitHub label or Item-state sources:
+
+```yaml
+repos:
+  - name: acme/widget
+    lanes:
+      - name: Ready
+        sources:
+          - label: ready-for-agent
+      - name: In review
+        sources:
+          - label: ready-for-review
+          - state: pr-open
+```
+
+Valid state sources are `issue-open`, `issue-closed`, `pr-open`, `pr-closed`, and `pr-merged`. Lane names and sources must be unique within the repository. Repositories without an authored map receive proposed lanes from the labels observed during GitHub polling.
+
+`workers` must contain at least one uniquely named worker. If the key is absent, the parser supplies one local worker named `local` with a concurrency limit of one. Set `kind` to `local` or `exe.dev` to select its executor, and set `max_concurrent_attempts` to control how many Attempts it can run at once.
+
+`InstanceFolder.load` takes an `InstanceDirectory` (from `@usine/core/instance`) and returns one atomic `LoadedInstance` snapshot. An invalid `usine.yaml` fails the load with a `FactoryConfigError`; an invalid loop enters `quarantinedLoops` with a `ConfigFileError` naming the file and stage, without blocking valid siblings. Invalid agents appear in `invalidAgents`, and loops that name them are quarantined. A `LoadedInstance` always satisfies its own reference rule: every loaded loop names a rostered agent and registered selector entries, enforced at construction. Non-blocking authored-reference diagnostics appear in `warnings`. The `ConfigError` union covers both failure types.
+
+Import factory settings and registry types from `@usine/config/factory`, Board lanes from `@usine/config/board`, and label declarations from `@usine/config/label`. Authored loop, trigger, and agent schemas are available at `/loop`, `/trigger`, and `/agent`; `/selector` provides both the selector schema and matching operation. `/instance` provides `LoadedInstance` and its warnings, while `/file` provides file paths and typed loading failures. Shared identities and agent personas come from their owning `@usine/core` modules.
+
+The package exports Effect services and layers. Import `InstanceFolder` from `@usine/config/instance-folder` and `ConfigParser` from `@usine/config/parser`. Supply `FileSystem.FileSystem` and `Path.Path` implementations when composing `InstanceFolder.layer`; `ConfigParser.layer` requires `ExpressionEngine` from `@usine/expression/expression-engine`.
+
+All APIs remain 0.x and can change between minor releases.
+
+Issue and pull-request Loops accept `max_cycles`, a positive integer defaulting to three. Each Loop may open that many Runs on an Item between operator resets. The first excess admission blocks further Runs from every Loop on the Item. Schedule Loops are exempt. See the [review/fix guide](../../docs/guides/review-fix-loops.md) for authored examples.

package/dist/agent.d.ts

@@ -0,0 +1,23 @@
+import { Schema } from "effect";
+import { ConfigFileError } from "./file.ts";
+declare const AgentFile_base: Schema.Class<AgentFile, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "AgentName">;
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+    readonly parentModel: Schema.Option<Schema.brand<Schema.String, "ModelId">>;
+    readonly parentEffort: Schema.Option<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    readonly persona: Schema.brand<Schema.String, "AgentPersona">;
+}>, {}>;
+/** An Agent's authored brain, parent overrides, and standing instructions, named by its Markdown filename. */
+export declare class AgentFile extends AgentFile_base {
+}
+declare const InvalidAgent_base: Schema.Class<InvalidAgent, Schema.Struct<{
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly error: typeof ConfigFileError;
+}>, {}>;
+/** An Agent file excluded from the roster because it could not be loaded. */
+export declare class InvalidAgent extends InvalidAgent_base {
+}
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAgB,eAAe,EAAE,MAAM,WAAW,CAAC;;;;;;;;;;AAE1D,8GAA8G;AAC9G,qBAAa,SAAU,SAAQ,cAQ7B;CAAG;;;;;AAEL,6EAA6E;AAC7E,qBAAa,YAAa,SAAQ,iBAGhC;CAAG"}

package/dist/agent.js

@@ -0,0 +1,22 @@
+import { AgentPersona, AgentName } from "@usine/core/agent";
+import { Effort, Harness, ModelId } from "@usine/core/agent/brain";
+import { Schema } from "effect";
+import { InstancePath, ConfigFileError } from "./file.js";
+/** An Agent's authored brain, parent overrides, and standing instructions, named by its Markdown filename. */
+export class AgentFile extends Schema.Class("@usine/config/AgentFile")({
+    name: AgentName,
+    harness: Harness,
+    model: ModelId,
+    effort: Effort,
+    parentModel: Schema.Option(ModelId),
+    parentEffort: Schema.Option(Effort),
+    persona: AgentPersona,
+}) {
+}
+/** An Agent file excluded from the roster because it could not be loaded. */
+export class InvalidAgent extends Schema.Class("@usine/config/InvalidAgent")({
+    file: InstancePath,
+    error: ConfigFileError,
+}) {
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE1D,8GAA8G;AAC9G,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,KAAK,CAAY,yBAAyB,CAAC,CAAC;IAChF,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,YAAY;CACtB,CAAC;CAAG;AAEL,6EAA6E;AAC7E,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,KAAK,CAAe,4BAA4B,CAAC,CAAC;IACzF,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,eAAe;CACvB,CAAC;CAAG"}

package/dist/board.d.ts

@@ -0,0 +1,31 @@
+import { Schema } from "effect";
+/** The operator-visible name of one lane on a Project's Board. */
+export declare const LaneName: Schema.brand<Schema.String, "LaneName">;
+export type LaneName = typeof LaneName.Type;
+/** An issue or pull-request state that can place an Item in a Board lane. */
+export declare const LaneItemState: Schema.Literals<readonly ["issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged"]>;
+export type LaneItemState = typeof LaneItemState.Type;
+declare const LabelLaneSource_base: Schema.Class<LabelLaneSource, Schema.Struct<{
+    readonly label: Schema.brand<Schema.String, "GitHubLabelName">;
+}>, {}>;
+/** Places Items with this GitHub label in the lane; Board moves can write the label. */
+export declare class LabelLaneSource extends LabelLaneSource_base {
+}
+declare const StateLaneSource_base: Schema.Class<StateLaneSource, Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged"]>;
+}>, {}>;
+/** Places Items with this GitHub state in the lane; Board moves cannot change the state. */
+export declare class StateLaneSource extends StateLaneSource_base {
+}
+/** A GitHub label or Item state that routes matching Items to a Board lane. */
+export declare const LaneSource: Schema.Union<readonly [typeof LabelLaneSource, typeof StateLaneSource]>;
+export type LaneSource = typeof LaneSource.Type;
+declare const Lane_base: Schema.Class<Lane, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "LaneName">;
+    readonly sources: Schema.$Array<Schema.Union<readonly [typeof LabelLaneSource, typeof StateLaneSource]>>;
+}>, {}>;
+/** A named Board column containing Items that match any of its configured sources. */
+export declare class Lane extends Lane_base {
+}
+export {};
+//# sourceMappingURL=board.d.ts.map

package/dist/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../src/board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,kEAAkE;AAClE,eAAO,MAAM,QAAQ,yCAEpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;AAE5C,6EAA6E;AAC7E,eAAO,MAAM,aAAa,+FAMxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;;;;AAEtD,wFAAwF;AACxF,qBAAa,eAAgB,SAAQ,oBAIpC;CAAG;;;;AAEJ,4FAA4F;AAC5F,qBAAa,eAAgB,SAAQ,oBAIpC;CAAG;AAEJ,+EAA+E;AAC/E,eAAO,MAAM,UAAU,yEAAmD,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;;;;;AAEhD,sFAAsF;AACtF,qBAAa,IAAK,SAAQ,SAGxB;CAAG"}

package/dist/board.js

@@ -0,0 +1,32 @@
+import { Schema } from "effect";
+import { nonBlankString } from "./checks.js";
+import { GitHubLabelName } from "./label.js";
+/** The operator-visible name of one lane on a Project's Board. */
+export const LaneName = nonBlankString("Expected a non-blank lane name").pipe(Schema.brand("LaneName"));
+/** An issue or pull-request state that can place an Item in a Board lane. */
+export const LaneItemState = Schema.Literals([
+    "issue-open",
+    "issue-closed",
+    "pr-open",
+    "pr-closed",
+    "pr-merged",
+]);
+/** Places Items with this GitHub label in the lane; Board moves can write the label. */
+export class LabelLaneSource extends Schema.Class("@usine/config/LabelLaneSource")({
+    label: GitHubLabelName,
+}) {
+}
+/** Places Items with this GitHub state in the lane; Board moves cannot change the state. */
+export class StateLaneSource extends Schema.Class("@usine/config/StateLaneSource")({
+    state: LaneItemState,
+}) {
+}
+/** A GitHub label or Item state that routes matching Items to a Board lane. */
+export const LaneSource = Schema.Union([LabelLaneSource, StateLaneSource]);
+/** A named Board column containing Items that match any of its configured sources. */
+export class Lane extends Schema.Class("@usine/config/Lane")({
+    name: LaneName,
+    sources: Schema.Array(LaneSource).check(Schema.isNonEmpty()),
+}) {
+}
+//# sourceMappingURL=board.js.map

package/dist/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../src/board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,kEAAkE;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAC3E,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CACzB,CAAC;AAIF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3C,YAAY;IACZ,cAAc;IACd,SAAS;IACT,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAIH,wFAAwF;AACxF,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,KAAK,CAAkB,+BAA+B,CAAC,CACjG;IACE,KAAK,EAAE,eAAe;CACvB,CACF;CAAG;AAEJ,4FAA4F;AAC5F,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,KAAK,CAAkB,+BAA+B,CAAC,CACjG;IACE,KAAK,EAAE,aAAa;CACrB,CACF;CAAG;AAEJ,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;AAI3E,sFAAsF;AACtF,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,KAAK,CAAO,oBAAoB,CAAC,CAAC;IACjE,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;CAC7D,CAAC;CAAG"}

package/dist/checks.d.ts

@@ -0,0 +1,3 @@
+import { Schema } from "effect";
+export declare const nonBlankString: (message: string) => Schema.String;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,cAAc,YAAa,MAAM,kBACa,CAAC"}

package/dist/checks.js

@@ -0,0 +1,3 @@
+import { Schema } from "effect";
+export const nonBlankString = (message) => Schema.String.check(Schema.isPattern(/\S/u, { message }));
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE,CAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,86 @@
+import { Schema } from "effect";
+import { Lane } from "./board.ts";
+import { DeclaredLabel } from "./label.ts";
+/** A factory-defined repository grouping that Loops can select by tag. */
+export declare const RegistryTag: Schema.brand<Schema.String, "RegistryTag">;
+export type RegistryTag = typeof RegistryTag.Type;
+/** GitHub login identifying the human operator for this factory. */
+export declare const OperatorLogin: Schema.brand<Schema.String, "OperatorLogin">;
+export type OperatorLogin = typeof OperatorLogin.Type;
+declare const ManagedRepo_base: Schema.Class<ManagedRepo, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "RepositoryName">;
+    readonly tags: Schema.withDecodingDefaultKey<Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>, never>;
+    readonly lanes: Schema.withDecodingDefaultKey<Schema.$Array<typeof Lane>, never>;
+}>, {}>;
+/** A repository the factory manages, with its selector tags and configured Board lanes. */
+export declare class ManagedRepo extends ManagedRepo_base {
+}
+declare const Worker_base: Schema.Class<Worker, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "WorkerName">;
+    readonly kind: Schema.Literals<readonly ["local", "exe.dev"]>;
+    readonly maxConcurrentAttempts: Schema.withDecodingDefaultKey<Schema.Int, never>;
+}>, {}>;
+/** A named place to execute Attempts, with the number it may run at the same time. */
+export declare class Worker extends Worker_base {
+}
+declare const Settings_base: Schema.Class<Settings, Schema.Struct<{
+    /** Seconds between routine GitHub polling cycles; defaults to 60. */
+    readonly pollInterval: Schema.withDecodingDefaultKey<Schema.Int, never>;
+    /** Total child sessions allowed over one Attempt's lifetime, including sequential spawns; defaults to four. */
+    readonly maxChildren: Schema.withDecodingDefaultKey<Schema.brand<Schema.Int, "ChildSessionBudget">, never>;
+    /** Configured Attempt duration ceiling in minutes; defaults to 60. */
+    readonly maxAttemptMinutes: Schema.withDecodingDefaultKey<Schema.Int, never>;
+    /** Configured total-token ceiling per Attempt; defaults to 10,000,000. */
+    readonly maxAttemptTokens: Schema.withDecodingDefaultKey<Schema.Int, never>;
+    /** Parent model used when the Agent has no override; an absent default leaves selection to Pi. */
+    readonly parentModel: Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "ModelId">>;
+    /** Default parent reasoning effort; if neither Agent nor factory supplies one, the child's effort applies. */
+    readonly parentEffort: Schema.OptionFromOptionalKey<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+}>, {}>;
+/** Factory-wide polling, Attempt limits, and defaults for the coordinating parent. */
+export declare class Settings extends Settings_base {
+}
+/** How GitHub hints reach the factory to request earlier polling; routine polling remains the backstop. */
+export declare const Webhooks: Schema.Union<readonly [Schema.Struct<{
+    readonly mode: Schema.Literal<"off">;
+}>, Schema.Struct<{
+    readonly mode: Schema.Literal<"deliveries">;
+}>, Schema.encodeKeys<Schema.Struct<{
+    readonly mode: Schema.Literal<"endpoint">;
+    readonly publicUrl: Schema.URLFromString;
+}>, {
+    readonly publicUrl: "public_url";
+}>]>;
+export type Webhooks = typeof Webhooks.Type;
+declare const UsineConfig_base: Schema.Class<UsineConfig, Schema.Struct<{
+    readonly version: Schema.Literal<1>;
+    readonly labels: Schema.withDecodingDefaultKey<Schema.$Array<typeof DeclaredLabel>, never>;
+    readonly repos: Schema.$Array<typeof ManagedRepo>;
+    readonly settings: Schema.withDecodingDefaultKey<Schema.encodeKeys<typeof Settings, {
+        readonly pollInterval: "poll_interval";
+        readonly maxChildren: "max_children";
+        readonly maxAttemptMinutes: "max_attempt_minutes";
+        readonly maxAttemptTokens: "max_attempt_tokens";
+        readonly parentModel: "parent_model";
+        readonly parentEffort: "parent_effort";
+    }>, never>;
+    readonly workers: Schema.withDecodingDefaultKey<Schema.$Array<Schema.encodeKeys<typeof Worker, {
+        readonly maxConcurrentAttempts: "max_concurrent_attempts";
+    }>>, never>;
+    readonly webhooks: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Struct<{
+        readonly mode: Schema.Literal<"off">;
+    }>, Schema.Struct<{
+        readonly mode: Schema.Literal<"deliveries">;
+    }>, Schema.encodeKeys<Schema.Struct<{
+        readonly mode: Schema.Literal<"endpoint">;
+        readonly publicUrl: Schema.URLFromString;
+    }>, {
+        readonly publicUrl: "public_url";
+    }>]>, never>;
+    readonly operator: Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "OperatorLogin">>;
+}>, {}>;
+/** The factory's repository registry, Worker capacity, labels, and operating defaults from `usine.yaml`. */
+export declare class UsineConfig extends UsineConfig_base {
+}
+export {};
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAc,IAAI,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAsB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,0EAA0E;AAC1E,eAAO,MAAM,WAAW,4CAEvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;AAElD,oEAAoE;AACpE,eAAO,MAAM,aAAa,8CAIW,CAAC;AAEtC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;;;;;;AA6BtD,2FAA2F;AAC3F,qBAAa,WAAY,SAAQ,gBAM/B;CAAG;;;;;;AAEL,sFAAsF;AACtF,qBAAa,MAAO,SAAQ,WAI1B;CAAG;;IAIH,qEAAqE;;IAErE,+GAA+G;;IAE/G,sEAAsE;;IAEtE,0EAA0E;;IAE1E,kGAAkG;;IAElG,8GAA8G;;;AAZhH,sFAAsF;AACtF,qBAAa,QAAS,SAAQ,aAa5B;CAAG;AAEL,2GAA2G;AAC3G,eAAO,MAAM,QAAQ;;;;;;;;;IAMnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuB5C,4GAA4G;AAC5G,qBAAa,WAAY,SAAQ,gBAU/B;CAAG"}

package/dist/factory.js

@@ -0,0 +1,87 @@
+import { Effort, ModelId } from "@usine/core/agent/brain";
+import { ChildSessionBudget } from "@usine/core/agent/session";
+import { RepositoryName } from "@usine/core/repository";
+import { WorkerName, WorkerKind } from "@usine/core/worker";
+import { Effect, Schema } from "effect";
+import { nonBlankString } from "./checks.js";
+import { LaneSource, Lane } from "./board.js";
+import { canonicalLabelName, DeclaredLabel } from "./label.js";
+/** A factory-defined repository grouping that Loops can select by tag. */
+export const RegistryTag = nonBlankString("Expected a non-blank registry tag").pipe(Schema.brand("RegistryTag"));
+/** GitHub login identifying the human operator for this factory. */
+export const OperatorLogin = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/u, {
+    message: "Expected a GitHub login",
+})).pipe(Schema.brand("OperatorLogin"));
+const PositiveInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+const uniqueNames = Schema.makeFilter((values) => new Set(values.map(({ name }) => name)).size === values.length, { message: "Expected unique names" });
+const laneSourceKey = (source) => "label" in source ? `label:${source.label}` : `state:${source.state}`;
+const uniqueLaneSources = Schema.makeFilter((lanes) => {
+    const keys = lanes.flatMap(({ sources }) => sources.map(laneSourceKey));
+    return new Set(keys).size === keys.length;
+}, { message: "Expected every lane source to be mapped once" });
+const Lanes = Schema.Array(Lane).check(uniqueNames, uniqueLaneSources);
+const uniqueLabelNames = Schema.makeFilter((values) => new Set(values.map(({ name }) => canonicalLabelName(name))).size === values.length, { message: "Expected unique GitHub label names" });
+const DeclaredLabels = Schema.Array(DeclaredLabel).check(uniqueLabelNames);
+/** A repository the factory manages, with its selector tags and configured Board lanes. */
+export class ManagedRepo extends Schema.Class("@usine/config/ManagedRepo")({
+    name: RepositoryName,
+    tags: Schema.Array(RegistryTag)
+        .check(Schema.isUnique())
+        .pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
+    lanes: Lanes.pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
+}) {
+}
+/** A named place to execute Attempts, with the number it may run at the same time. */
+export class Worker extends Schema.Class("@usine/config/Worker")({
+    name: WorkerName,
+    kind: WorkerKind,
+    maxConcurrentAttempts: PositiveInt.pipe(Schema.withDecodingDefaultKey(Effect.succeed(1))),
+}) {
+}
+/** Factory-wide polling, Attempt limits, and defaults for the coordinating parent. */
+export class Settings extends Schema.Class("@usine/config/Settings")({
+    /** Seconds between routine GitHub polling cycles; defaults to 60. */
+    pollInterval: PositiveInt.pipe(Schema.withDecodingDefaultKey(Effect.succeed(60))),
+    /** Total child sessions allowed over one Attempt's lifetime, including sequential spawns; defaults to four. */
+    maxChildren: ChildSessionBudget.pipe(Schema.withDecodingDefaultKey(Effect.succeed(4))),
+    /** Configured Attempt duration ceiling in minutes; defaults to 60. */
+    maxAttemptMinutes: PositiveInt.pipe(Schema.withDecodingDefaultKey(Effect.succeed(60))),
+    /** Configured total-token ceiling per Attempt; defaults to 10,000,000. */
+    maxAttemptTokens: PositiveInt.pipe(Schema.withDecodingDefaultKey(Effect.succeed(10_000_000))),
+    /** Parent model used when the Agent has no override; an absent default leaves selection to Pi. */
+    parentModel: Schema.OptionFromOptionalKey(ModelId),
+    /** Default parent reasoning effort; if neither Agent nor factory supplies one, the child's effort applies. */
+    parentEffort: Schema.OptionFromOptionalKey(Effort),
+}) {
+}
+/** How GitHub hints reach the factory to request earlier polling; routine polling remains the backstop. */
+export const Webhooks = Schema.Union([
+    Schema.Struct({ mode: Schema.Literal("off") }),
+    Schema.Struct({ mode: Schema.Literal("deliveries") }),
+    Schema.Struct({ mode: Schema.Literal("endpoint"), publicUrl: Schema.URLFromString }).pipe(Schema.encodeKeys({ publicUrl: "public_url" })),
+]);
+// Authored YAML keys are snake_case and domain fields camelCase. The rename
+// happens once here and encodes back for edits.
+const SettingsFromYaml = Settings.pipe(Schema.encodeKeys({
+    pollInterval: "poll_interval",
+    maxChildren: "max_children",
+    maxAttemptMinutes: "max_attempt_minutes",
+    maxAttemptTokens: "max_attempt_tokens",
+    parentModel: "parent_model",
+    parentEffort: "parent_effort",
+}));
+const WorkerFromYaml = Worker.pipe(Schema.encodeKeys({ maxConcurrentAttempts: "max_concurrent_attempts" }));
+const ManagedRepos = Schema.Array(ManagedRepo).check(uniqueNames);
+const Workers = Schema.Array(WorkerFromYaml).check(Schema.isNonEmpty(), uniqueNames);
+/** The factory's repository registry, Worker capacity, labels, and operating defaults from `usine.yaml`. */
+export class UsineConfig extends Schema.Class("@usine/config/UsineConfig")({
+    version: Schema.Literal(1),
+    labels: DeclaredLabels.pipe(Schema.withDecodingDefaultKey(Effect.succeed([]))),
+    repos: ManagedRepos,
+    settings: SettingsFromYaml.pipe(Schema.withDecodingDefaultKey(Effect.succeed({}))),
+    workers: Workers.pipe(Schema.withDecodingDefaultKey(Effect.succeed([{ name: "local", kind: "local" }]))),
+    webhooks: Webhooks.pipe(Schema.withDecodingDefaultKey(Effect.succeed({ mode: "off" }))),
+    operator: Schema.OptionFromOptionalKey(OperatorLogin),
+}) {
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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

package/dist/file.d.ts

@@ -0,0 +1,27 @@
+import { Schema } from "effect";
+/** Path of one authored file, relative to the instance folder. */
+export declare const InstancePath: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+export type InstancePath = typeof InstancePath.Type;
+export declare const FileStage: Schema.Literals<readonly ["expression", "frontmatter", "read", "reference", "schema", "yaml"]>;
+export type FileStage = typeof FileStage.Type;
+declare const ConfigFileError_base: Schema.Class<ConfigFileError, Schema.TaggedStruct<"ConfigFileError", {
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly stage: Schema.Literals<readonly ["expression", "frontmatter", "read", "reference", "schema", "yaml"]>;
+    readonly expression: Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "ExpressionSource">>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** A failure pinned to one authored file and one parse stage, so the UI can quarantine that file alone. */
+export declare class ConfigFileError extends ConfigFileError_base {
+}
+declare const FactoryConfigError_base: Schema.Class<FactoryConfigError, Schema.TaggedStruct<"FactoryConfigError", {
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly stage: Schema.Literals<readonly ["expression", "frontmatter", "read", "reference", "schema", "yaml"]>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The registry or settings could not be loaded, which blocks the whole instance. */
+export declare class FactoryConfigError extends FactoryConfigError_base {
+}
+export declare const ConfigError: Schema.Union<readonly [typeof ConfigFileError, typeof FactoryConfigError]>;
+export type ConfigError = typeof ConfigError.Type;
+export {};
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,kEAAkE;AAClE,eAAO,MAAM,YAAY,qDAA2D,CAAC;AAErF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;AAEpD,eAAO,MAAM,SAAS,gGAOpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;;;;;;;AAE9C,2GAA2G;AAC3G,qBAAa,eAAgB,SAAQ,oBAOnC;CAAG;;;;;;AAEL,qFAAqF;AACrF,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;AAEL,eAAO,MAAM,WAAW,4EAAsD,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC"}

package/dist/file.js

@@ -0,0 +1,29 @@
+import { Source } from "@usine/expression/expression-engine";
+import { Schema } from "effect";
+/** Path of one authored file, relative to the instance folder. */
+export const InstancePath = Schema.NonEmptyString.pipe(Schema.brand("InstancePath"));
+export const FileStage = Schema.Literals([
+    "expression",
+    "frontmatter",
+    "read",
+    "reference",
+    "schema",
+    "yaml",
+]);
+/** A failure pinned to one authored file and one parse stage, so the UI can quarantine that file alone. */
+export class ConfigFileError extends Schema.TaggedError("@usine/config/ConfigFileError")("ConfigFileError", {
+    file: InstancePath,
+    stage: FileStage,
+    expression: Schema.OptionFromOptionalKey(Source),
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The registry or settings could not be loaded, which blocks the whole instance. */
+export class FactoryConfigError extends Schema.TaggedError("@usine/config/FactoryConfigError")("FactoryConfigError", {
+    file: InstancePath,
+    stage: FileStage,
+    message: Schema.NonEmptyString,
+}) {
+}
+export const ConfigError = Schema.Union([ConfigFileError, FactoryConfigError]);
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;AAIrF,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;IACvC,YAAY;IACZ,aAAa;IACb,MAAM;IACN,WAAW;IACX,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAIH,2GAA2G;AAC3G,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,WAAW,CACrD,+BAA+B,CAChC,CAAC,iBAAiB,EAAE;IACnB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,qFAAqF;AACrF,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,WAAW,CACxD,kCAAkC,CACnC,CAAC,oBAAoB,EAAE;IACtB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,10 @@
+import { Effect } from "effect";
+import { ConfigFileError, type InstancePath } from "./file.ts";
+export interface MarkdownParts {
+    readonly yaml: string;
+    readonly body: string;
+    readonly newline: "\n" | "\r\n";
+}
+/** Splits a Markdown file into its YAML half and its body without parsing either. */
+export declare const splitMarkdown: (file: InstancePath, source: string) => Effect.Effect<MarkdownParts, ConfigFileError>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC;CACjC;AAeD,qFAAqF;AACrF,eAAO,MAAM,aAAa,SAClB,YAAY,UACV,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAoC9C,CAAC"}

package/dist/frontmatter.js

@@ -0,0 +1,51 @@
+import { Effect, Option } from "effect";
+import { ConfigFileError } from "./file.js";
+const closingDelimiterAt = (source, newline, from) => {
+    const delimiter = `${newline}---`;
+    let candidate = source.indexOf(delimiter, from);
+    while (candidate >= 0) {
+        const afterDelimiter = candidate + delimiter.length;
+        if (afterDelimiter === source.length || source.startsWith(newline, afterDelimiter)) {
+            return candidate;
+        }
+        candidate = source.indexOf(delimiter, afterDelimiter);
+    }
+    return -1;
+};
+/** Splits a Markdown file into its YAML half and its body without parsing either. */
+export const splitMarkdown = (file, source) => {
+    const newline = source.startsWith("---\r\n")
+        ? "\r\n"
+        : source.startsWith("---\n")
+            ? "\n"
+            : undefined;
+    if (newline === undefined) {
+        return new ConfigFileError({
+            file,
+            stage: "frontmatter",
+            expression: Option.none(),
+            message: "Expected the file to start with a YAML frontmatter delimiter (---)",
+        });
+    }
+    const yamlStart = 3 + newline.length;
+    const closingDelimiter = `${newline}---`;
+    const yamlEnd = closingDelimiterAt(source, newline, yamlStart);
+    if (yamlEnd < 0) {
+        return new ConfigFileError({
+            file,
+            stage: "frontmatter",
+            expression: Option.none(),
+            message: "Expected a closing YAML frontmatter delimiter (---)",
+        });
+    }
+    const afterDelimiter = yamlEnd + closingDelimiter.length;
+    const bodyStart = source.startsWith(newline, afterDelimiter)
+        ? afterDelimiter + newline.length
+        : afterDelimiter;
+    return Effect.succeed({
+        yaml: source.slice(yamlStart, yamlEnd),
+        body: source.slice(bodyStart),
+        newline,
+    });
+};
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,eAAe,EAAqB,MAAM,WAAW,CAAC;AAQ/D,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,OAAsB,EAAE,IAAY,EAAU,EAAE;IAC1F,MAAM,SAAS,GAAG,GAAG,OAAO,KAAK,CAAC;IAClC,IAAI,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,SAAS,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;QACpD,IAAI,cAAc,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACnF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAkB,EAClB,MAAc,EACiC,EAAE;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAC1C,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;YAC1B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI;YACJ,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;YACzB,OAAO,EAAE,oEAAoE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACrC,MAAM,gBAAgB,GAAG,GAAG,OAAO,KAAK,CAAC;IACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI;YACJ,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;YACzB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC;QAC1D,CAAC,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM;QACjC,CAAC,CAAC,cAAc,CAAC;IACnB,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;QACtC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7B,OAAO;KACR,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/instance/diagnostics.d.ts

@@ -0,0 +1,19 @@
+import { Schema } from "effect";
+declare const UndeclaredLaneLabelWarning_base: Schema.Class<UndeclaredLaneLabelWarning, Schema.TaggedStruct<"UndeclaredLaneLabelWarning", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly lane: Schema.brand<Schema.String, "LaneName">;
+    readonly label: Schema.brand<Schema.String, "GitHubLabelName">;
+}>, {}>;
+export declare class UndeclaredLaneLabelWarning extends UndeclaredLaneLabelWarning_base {
+}
+declare const UndeclaredTriggerLabelWarning_base: Schema.Class<UndeclaredTriggerLabelWarning, Schema.TaggedStruct<"UndeclaredTriggerLabelWarning", {
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly label: Schema.brand<Schema.String, "GitHubLabelName">;
+}>, {}>;
+export declare class UndeclaredTriggerLabelWarning extends UndeclaredTriggerLabelWarning_base {
+}
+/** Diagnostics that do not block a load. */
+export declare const ConfigWarning: Schema.Union<readonly [typeof UndeclaredLaneLabelWarning, typeof UndeclaredTriggerLabelWarning]>;
+export type ConfigWarning = typeof ConfigWarning.Type;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/instance/diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAKhC,qBAAa,0BAA2B,SAAQ,+BAM9C;CAAG;;;;;AAEL,qBAAa,6BAA8B,SAAQ,kCAKjD;CAAG;AAEL,4CAA4C;AAC5C,eAAO,MAAM,aAAa,kGAGxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC"}

package/dist/instance/diagnostics.js

@@ -0,0 +1,22 @@
+import { RepositoryName } from "@usine/core/repository";
+import { Schema } from "effect";
+import { LaneName } from "../board.js";
+import { GitHubLabelName } from "../label.js";
+import { LoopFile } from "../loop.js";
+export class UndeclaredLaneLabelWarning extends Schema.TaggedClass("@usine/config/UndeclaredLaneLabelWarning")("UndeclaredLaneLabelWarning", {
+    repository: RepositoryName,
+    lane: LaneName,
+    label: GitHubLabelName,
+}) {
+}
+export class UndeclaredTriggerLabelWarning extends Schema.TaggedClass("@usine/config/UndeclaredTriggerLabelWarning")("UndeclaredTriggerLabelWarning", {
+    loop: LoopFile.fields.name,
+    label: GitHubLabelName,
+}) {
+}
+/** Diagnostics that do not block a load. */
+export const ConfigWarning = Schema.Union([
+    UndeclaredLaneLabelWarning,
+    UndeclaredTriggerLabelWarning,
+]);
+//# sourceMappingURL=diagnostics.js.map

package/dist/instance/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/instance/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,OAAO,0BAA2B,SAAQ,MAAM,CAAC,WAAW,CAChE,0CAA0C,CAC3C,CAAC,4BAA4B,EAAE;IAC9B,UAAU,EAAE,cAAc;IAC1B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,eAAe;CACvB,CAAC;CAAG;AAEL,MAAM,OAAO,6BAA8B,SAAQ,MAAM,CAAC,WAAW,CACnE,6CAA6C,CAC9C,CAAC,+BAA+B,EAAE;IACjC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI;IAC1B,KAAK,EAAE,eAAe;CACvB,CAAC;CAAG;AAEL,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;IACxC,0BAA0B;IAC1B,6BAA6B;CAC9B,CAAC,CAAC"}

package/dist/instance/instance.d.ts

@@ -0,0 +1,17 @@
+import { Schema } from "effect";
+import { UsineConfig } from "../factory.ts";
+import { LoopFile, QuarantinedLoop } from "../loop.ts";
+import { AgentFile, InvalidAgent } from "../agent.ts";
+declare const LoadedInstance_base: Schema.Class<LoadedInstance, Schema.Struct<{
+    readonly config: typeof UsineConfig;
+    readonly agents: Schema.$Array<typeof AgentFile>;
+    readonly invalidAgents: Schema.$Array<typeof InvalidAgent>;
+    readonly loops: Schema.$Array<typeof LoopFile>;
+    readonly quarantinedLoops: Schema.$Array<typeof QuarantinedLoop>;
+    readonly warnings: Schema.$Array<Schema.Union<readonly [typeof import("./diagnostics.ts").UndeclaredLaneLabelWarning, typeof import("./diagnostics.ts").UndeclaredTriggerLabelWarning]>>;
+}>, {}>;
+/** One consistent snapshot of an instance folder. Construction fails if a loop references a name the instance does not have. */
+export declare class LoadedInstance extends LoadedInstance_base {
+}
+export { UndeclaredLaneLabelWarning, UndeclaredTriggerLabelWarning, ConfigWarning, } from "./diagnostics.ts";
+//# sourceMappingURL=instance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/instance/instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAY,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;;;;;;;;;AAItD,gIAAgI;AAChI,qBAAa,cAAe,SAAQ,mBAmBnC;CAAG;AAEJ,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,aAAa,GACd,MAAM,kBAAkB,CAAC"}