@cat-factory/contracts 0.281.0 → 0.283.0

package/dist/pipeline-environment-lifecycle.js

@@ -0,0 +1,142 @@
+import { TESTER_AGENT_KIND } from './run-evidence.js';
+import { UI_TESTER_AGENT_KIND } from './visual-pipeline.js';
+// ---------------------------------------------------------------------------
+// The ENVIRONMENT LIFECYCLE a pipeline's steps have to spell out: provision (`deployer`) →
+// consume (a tester / acceptance / human-test step) → reclaim (`disposer`).
+//
+// Stated once here, in the package both the backend and the SPA compile against, because three
+// surfaces have to agree about it and each of them answers a different half of the same question:
+//
+//  - the pipeline BUILDER, which warns while a draft is being composed;
+//  - the SAVE boundary, which refuses a draft that would run into one of these dead ends;
+//  - the palette, which has to offer the Deployer and the Disposer wherever a tester is offered.
+//
+// The rule is deliberately structural: it reads the step list and nothing else. Whether a given
+// SERVICE actually needs an environment is workspace state a pipeline cannot see (a pipeline is a
+// workspace-level template applied to any block), and the answer the platform settled on is that
+// the Deployer is present unconditionally and NO-OPS on a service that stands nothing up
+// (`infraless` / `docker-compose` with no handler). One pipeline covers every provision type;
+// there is no pipeline-per-infra-type fan-out, and that is what makes a purely structural rule
+// the right one to enforce.
+//
+// RECLAIM IS THE DEFAULT, NOT THE ONLY LEGAL END. An environment that deliberately outlives its
+// run is a real shape (a preview a reviewer pokes at after the PR is open), so the reclaim leg is
+// satisfied EITHER by a `disposer` or by the deployer step DECLARING the retention
+// (`StepOptions.retainEnvironment`). What the rule refuses is the third case, silence: a chain
+// that neither reclaims nor says it means not to, which is indistinguishable from an author who
+// forgot. The declaration is not a validation bypass — it is the fact the PR verification report
+// needs to render the teardown leg as `retained` rather than as a `pending` reclaim that is never
+// coming (`prReport.environments.ts`).
+// ---------------------------------------------------------------------------
+/**
+ * The agent kind that PROVISIONS a run's ephemeral environments, the sole provisioner, which
+ * is why every consumer below is stated relative to it. The canonical slug also backs
+ * integrations' `DEPLOYER_AGENT_KIND` (re-exported there).
+ */
+export const DEPLOYER_AGENT_KIND = 'deployer';
+/**
+ * The agent kind that RECLAIMS them again, the deployer's counterpart at the other end of the
+ * lifecycle. It tears down by the environment ids the deployer RECORDED on its own step, so it
+ * has nothing whatsoever to do without one earlier in the chain.
+ */
+export const DISPOSER_AGENT_KIND = 'disposer';
+/**
+ * The agent kind of the human-testing gate: it parks for a person to validate the change in the
+ * live URL, so it reads the environment rather than standing one up. The canonical slug also
+ * backs orchestration's `HUMAN_TEST_AGENT_KIND` (re-exported there).
+ */
+export const HUMAN_TEST_AGENT_KIND = 'human-test';
+/**
+ * The agent kind of the acceptance-test author. The canonical slug also backs agents'
+ * `ACCEPTANCE_AGENT_KINDS` (which is built from it).
+ */
+export const ACCEPTANCE_AGENT_KIND = 'playwright';
+/**
+ * The steps that CONSUME a provisioned environment to run against: the API/UI testers, the
+ * acceptance runner, and the human-test gate. Each reads the environment's coordinates and none
+ * of them provisions, so a chain reaching one with no `deployer` in front of it dead-ends inside
+ * the consumer on any service that stands an environment up.
+ */
+export const ENV_CONSUMER_AGENT_KINDS = [
+    TESTER_AGENT_KIND,
+    UI_TESTER_AGENT_KIND,
+    ACCEPTANCE_AGENT_KIND,
+    HUMAN_TEST_AGENT_KIND,
+];
+/**
+ * Every environment-lifecycle fault in a step list, in step order.
+ *
+ * Walked as a STATE MACHINE over the enabled steps rather than as a set of presence checks,
+ * because every one of these faults is about ORDER and half of them are invisible to a scan that
+ * only asks whether a kind appears somewhere. The state is whether an environment is standing at
+ * this point in the chain: a `deployer` raises it, a `disposer` drops it, and a consumer is
+ * judged against what is standing WHEN IT RUNS. That is what separates a consumer with nothing
+ * yet provisioned from one whose environment has already been reclaimed, and it is what lets a
+ * chain that provisions twice (`deployer → tester → disposer → deployer → tester → disposer`)
+ * read as two clean lifecycles instead of a pile of contradictions.
+ *
+ * Evaluated over the ENABLED subset, like every other structural pipeline rule: a run is built
+ * from the enabled steps alone, so a disabled `deployer` provisions nothing and a disabled
+ * consumer needs nothing. That also means "disable the Deployer but leave the Tester on" is
+ * caught, which is the shape a half-edited draft most often reaches.
+ *
+ * Returns every fault rather than the first, so the builder can show a draft's whole remaining
+ * work at once instead of one refusal per save.
+ */
+export function pipelineEnvironmentProblems(agentKinds, enabled, stepOptions) {
+    const isEnabled = (i) => enabled?.[i] !== false;
+    const problems = [];
+    // Whether an environment is standing at this point in the chain. `reclaimed` is deliberately
+    // distinct from `none`: both mean a consumer here has nothing to run against, and they need
+    // opposite fixes.
+    let environment = 'none';
+    for (let i = 0; i < agentKinds.length; i++) {
+        const agentKind = agentKinds[i];
+        if (agentKind === undefined || !isEnabled(i))
+            continue;
+        if (agentKind === DEPLOYER_AGENT_KIND) {
+            environment = 'live';
+            // The disposer reclaims by the ids the deployer recorded, so ANY enabled disposer after
+            // this one takes this environment down: that is both what satisfies the reclaim
+            // requirement and what contradicts a retain declaration.
+            const reclaimed = agentKinds.some((kind, j) => j > i && kind === DISPOSER_AGENT_KIND && isEnabled(j));
+            if (stepOptions?.[i]?.retainEnvironment === true) {
+                if (reclaimed) {
+                    problems.push({ reason: 'retained_deployer_reclaimed', index: i, agentKind });
+                }
+            }
+            else if (!reclaimed) {
+                problems.push({ reason: 'deployer_without_disposer', index: i, agentKind });
+            }
+        }
+        else if (agentKind === DISPOSER_AGENT_KIND) {
+            if (environment !== 'live') {
+                problems.push({ reason: 'disposer_without_deployer', index: i, agentKind });
+            }
+            environment = 'reclaimed';
+        }
+        else if (environment !== 'live' && ENV_CONSUMER_AGENT_KINDS.includes(agentKind)) {
+            problems.push({
+                reason: environment === 'reclaimed' ? 'consumer_after_disposer' : 'consumer_without_deployer',
+                index: i,
+                agentKind,
+            });
+        }
+    }
+    return problems;
+}
+/**
+ * The subset of {@link PipelineEnvironmentProblemReason} that names a step which would DEAD-END
+ * for want of a live environment, as opposed to one that leaves the lifecycle untidy.
+ *
+ * Exported because the two halves are enforced at different doors and only these cross both: the
+ * save boundary refuses the whole set on what is being AUTHORED, while the run door refuses a
+ * STORED chain (see `RunAdmission`) and may only refuse what would genuinely fail on the service
+ * the run was started against. A pipeline stored before this rule existed still runs; one whose
+ * tester has no environment to read does not.
+ */
+export const ENV_CONSUMER_STARVATION_REASONS = [
+    'consumer_without_deployer',
+    'consumer_after_disposer',
+];
+//# sourceMappingURL=pipeline-environment-lifecycle.js.map

package/dist/pipeline-environment-lifecycle.js.map

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

package/dist/pipeline-purpose-vocabulary.d.ts

@@ -0,0 +1,32 @@
+import * as v from 'valibot';
+/**
+ * The USE-CASE of a pipeline: what kind of work it exists to do. Chosen in the pipeline
+ * builder and stamped on every built-in preset, it is the classifier the SPA filters on:
+ *
+ *   - `build`      produces or changes application code (the default for engineering
+ *                  pipelines: full builds, bug fixes, refactors, dependency updates, …).
+ *   - `document`   authors or updates documentation (a PRD/RFC/runbook, business rules, …);
+ *                  a `document` task offers ONLY these.
+ *   - `review`     reviews existing code / a pull request and reports findings; writes no code.
+ *   - `research`   timeboxed investigation / analysis that delivers findings (a spike, an
+ *                  environment analysis).
+ *   - `planning`   decomposes and plans an initiative (no code, no repo write of its own).
+ *
+ * The gating predicates that read it live in `pipeline-purpose.ts`, which re-exports this
+ * module. The vocabulary sits apart from them because `agent-presentation.ts` has to name a
+ * purpose too (`AgentPresentation.purposes`) and the predicates have to name an
+ * `AgentCategory`: keeping the two halves in one file makes those a cycle, and a cycle whose
+ * modules both build a `Set` at evaluation time resolves to an empty one on whichever side
+ * loses the race.
+ */
+export declare const PIPELINE_PURPOSES: readonly ['build', 'document', 'review', 'research', 'planning'];
+export declare const pipelinePurposeSchema: v.PicklistSchema<readonly ["build", "document", "review", "research", "planning"], undefined>;
+export type PipelinePurpose = v.InferOutput<typeof pipelinePurposeSchema>;
+/**
+ * Whether a value is a purpose THIS BUILD knows, DERIVED from the picklist for the same reason
+ * `isAgentCategory` is: the vocabulary is closed but PERSISTED, on `Pipeline.purpose`, so a
+ * member retired from the union goes on living in stored rows and in the SPA bundle a browser
+ * cached before a new member shipped. Narrow with this before indexing anything by a purpose.
+ */
+export declare function isPipelinePurpose(value: string): value is PipelinePurpose;
+//# sourceMappingURL=pipeline-purpose-vocabulary.d.ts.map

package/dist/pipeline-purpose-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-purpose-vocabulary.d.ts","sourceRoot":"","sources":["../src/pipeline-purpose-vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,YAAI,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAU,CAAA;AACjG,eAAO,MAAM,qBAAqB,+FAAgC,CAAA;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAIzE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}

package/dist/pipeline-purpose-vocabulary.js

@@ -0,0 +1,34 @@
+import * as v from 'valibot';
+/**
+ * The USE-CASE of a pipeline: what kind of work it exists to do. Chosen in the pipeline
+ * builder and stamped on every built-in preset, it is the classifier the SPA filters on:
+ *
+ *   - `build`      produces or changes application code (the default for engineering
+ *                  pipelines: full builds, bug fixes, refactors, dependency updates, …).
+ *   - `document`   authors or updates documentation (a PRD/RFC/runbook, business rules, …);
+ *                  a `document` task offers ONLY these.
+ *   - `review`     reviews existing code / a pull request and reports findings; writes no code.
+ *   - `research`   timeboxed investigation / analysis that delivers findings (a spike, an
+ *                  environment analysis).
+ *   - `planning`   decomposes and plans an initiative (no code, no repo write of its own).
+ *
+ * The gating predicates that read it live in `pipeline-purpose.ts`, which re-exports this
+ * module. The vocabulary sits apart from them because `agent-presentation.ts` has to name a
+ * purpose too (`AgentPresentation.purposes`) and the predicates have to name an
+ * `AgentCategory`: keeping the two halves in one file makes those a cycle, and a cycle whose
+ * modules both build a `Set` at evaluation time resolves to an empty one on whichever side
+ * loses the race.
+ */
+export const PIPELINE_PURPOSES = ['build', 'document', 'review', 'research', 'planning'];
+export const pipelinePurposeSchema = v.picklist(PIPELINE_PURPOSES);
+const PIPELINE_PURPOSE_SET = new Set(pipelinePurposeSchema.options);
+/**
+ * Whether a value is a purpose THIS BUILD knows, DERIVED from the picklist for the same reason
+ * `isAgentCategory` is: the vocabulary is closed but PERSISTED, on `Pipeline.purpose`, so a
+ * member retired from the union goes on living in stored rows and in the SPA bundle a browser
+ * cached before a new member shipped. Narrow with this before indexing anything by a purpose.
+ */
+export function isPipelinePurpose(value) {
+    return PIPELINE_PURPOSE_SET.has(value);
+}
+//# sourceMappingURL=pipeline-purpose-vocabulary.js.map

package/dist/pipeline-purpose-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-purpose-vocabulary.js","sourceRoot":"","sources":["../src/pipeline-purpose-vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAU,CAAA;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA;AAGlE,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAExF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC"}

package/dist/pipeline-purpose.d.ts

@@ -1,36 +1,19 @@
-import * as v from 'valibot';
 import { type AgentCategory } from './agent-presentation.js';
 import type { Pipeline } from './entities.js';
+import { type PipelinePurpose } from './pipeline-purpose-vocabulary.js';
 import type { BlockLevel, TaskType } from './primitives.js';
 /**
- * The USE-CASE of a pipeline — what kind of work it exists to do. Chosen in the pipeline
- * builder and stamped on every built-in preset, it is the classifier the SPA filters on:
- *
- *   - `build`      — produces or changes application code (the default for engineering
- *                    pipelines: full builds, bug fixes, refactors, dependency updates, …).
- *   - `document`   — authors or updates documentation (a PRD/RFC/runbook, business rules, …);
- *                    a `document` task offers ONLY these.
- *   - `review`     — reviews existing code / a pull request and reports findings; writes no code.
- *   - `research`   — timeboxed investigation / analysis that delivers findings (a spike, an
- *                    environment analysis).
- *   - `planning`   — decomposes and plans an initiative (no code, no repo write of its own).
+ * The pipeline-purpose vocabulary itself ({@link PipelinePurpose} and what each member means)
+ * lives in `pipeline-purpose-vocabulary.ts` and is re-exported here, so every consumer keeps
+ * importing the classifier and the predicates that read it from one place.
  *
  * A non-`build` purpose hides the Implementation/Testing agent kinds in the builder
  * ({@link purposeAllowsAgentCategory}), narrows what its palette offers
- * ({@link purposeSuggestsAgentCategory}) and its saved-pipeline library lists
+ * ({@link purposeSuggestsAgentKind}) and its saved-pipeline library lists
  * ({@link pipelineMatchesPurpose}), and scopes the pipeline in the task pickers
  * ({@link pipelineAllowedForTaskType}). The `Pipeline.purpose` field references this schema.
  */
-export declare const PIPELINE_PURPOSES: readonly ['build', 'document', 'review', 'research', 'planning'];
-export declare const pipelinePurposeSchema: v.PicklistSchema<readonly ["build", "document", "review", "research", "planning"], undefined>;
-export type PipelinePurpose = v.InferOutput<typeof pipelinePurposeSchema>;
-/**
- * Whether a value is a purpose THIS BUILD knows, DERIVED from the picklist for the same reason
- * {@link isAgentCategory} is: the vocabulary is closed but PERSISTED, on `Pipeline.purpose`, so a
- * member retired from the union goes on living in stored rows and in the SPA bundle a browser
- * cached before a new member shipped. Narrow with this before indexing anything by a purpose.
- */
-export declare function isPipelinePurpose(value: string): value is PipelinePurpose;
+export * from './pipeline-purpose-vocabulary.js';
 /**
  * Whether a pipeline of `purpose` may use an agent kind in `category`: the builder's SAVE
  * gate. A `build` pipeline may use anything; every other purpose refuses the Implementation
@@ -60,6 +43,43 @@ export declare function purposeAllowsAgentCategory(purpose: Pipeline['purpose'],
  * and the runtime one exists only for the values it structurally cannot have.
  */
 export declare function purposeSuggestsAgentCategory(purpose: Pipeline['purpose'], category: AgentCategory): boolean;
+/**
+ * What a palette entry declares for the purpose dial to judge it by: the section it groups under
+ * and, when it knows better than its section does, the purposes it is worth offering to.
+ */
+export interface AgentPurposeRelevance {
+    /** The palette section, i.e. what {@link purposeSuggestsAgentCategory} reads. */
+    category?: AgentCategory;
+    /** The kind's OWN answer, from `AgentPresentation.purposes`. */
+    purposes?: readonly PipelinePurpose[];
+}
+/**
+ * Whether an agent KIND is worth OFFERING to a pipeline of `purpose`: what the builder palette
+ * actually filters on.
+ *
+ * A category is a SHELF LABEL, not a statement of what a kind does, so
+ * {@link purposeSuggestsAgentCategory} can only ever remove whole sections: keeping `docs` for a
+ * `review` pipeline so the Domain Rules Reviewer survives also offered it the two agents that
+ * WRITE documentation into the repo, and `document` and `research` had identical rows, so moving
+ * the dial between them narrowed nothing at all. A kind that knows it belongs to one use-case says
+ * so itself, and the section keeps deciding for every kind that does not.
+ *
+ * The two narrowings INTERSECT: a declaration may only ever hide MORE than the section already
+ * does, never buy a kind back into a purpose its section is not offered to. That is not a
+ * convenience, it is what keeps relevance a SUBSET of compatibility
+ * ({@link purposeAllowsAgentCategory}) no matter what a deployment declares: a kind offered
+ * outside its category's row would be a palette entry whose step then blocks the save, the one
+ * dead end this pair of tables exists to prevent.
+ *
+ * Declaring nothing is the normal case and stays exactly as permissive as before. A declared list
+ * naming only purposes this build cannot NAME is read as declaring nothing rather than as
+ * excluding everything, the same default-open reading its siblings give an unrecognised value: a
+ * kind whose entire list was retired would otherwise vanish from every palette in the build that
+ * has to fix it. An AUTHORED empty list never reaches here at all: `agentPresentationSchema`
+ * refuses one at registration, so this reading cannot double as a way of saying "offer me
+ * nowhere", which is what someone typing `purposes: []` means and the opposite of what it does.
+ */
+export declare function purposeSuggestsAgentKind(purpose: Pipeline['purpose'], kind: AgentPurposeRelevance): boolean;
 /**
  * Whether `pipeline` belongs in a library being browsed AT `purpose`: the builder's saved-pipeline
  * list, the third surface the purpose dial narrows (the palette's catalog and the save gate being

package/dist/pipeline-purpose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-purpose.d.ts","sourceRoot":"","sources":["../src/pipeline-purpose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,yBAAyB,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,YAAI,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAU,CAAA;AACjG,eAAO,MAAM,qBAAqB,+FAAgC,CAAA;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAIzE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AA2DD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAIT;AA8BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAIT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,OAAO,CAMT;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,OAAO,CAQT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,OAAO,CAIT"}
+{"version":3,"file":"pipeline-purpose.d.ts","sourceRoot":"","sources":["../src/pipeline-purpose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,yBAAyB,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAC1F,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE3D;;;;;;;;;;GAUG;AACH,cAAc,kCAAkC,CAAA;AA2DhD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAIT;AA8BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAIT;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAMT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,OAAO,CAMT;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,OAAO,CAQT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EACnC,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,OAAO,CAIT"}

package/dist/pipeline-purpose.js

@@ -1,36 +1,17 @@
-import * as v from 'valibot';
 import { isAgentCategory } from './agent-presentation.js';
+import { isPipelinePurpose } from './pipeline-purpose-vocabulary.js';
 /**
- * The USE-CASE of a pipeline — what kind of work it exists to do. Chosen in the pipeline
- * builder and stamped on every built-in preset, it is the classifier the SPA filters on:
- *
- *   - `build`      — produces or changes application code (the default for engineering
- *                    pipelines: full builds, bug fixes, refactors, dependency updates, …).
- *   - `document`   — authors or updates documentation (a PRD/RFC/runbook, business rules, …);
- *                    a `document` task offers ONLY these.
- *   - `review`     — reviews existing code / a pull request and reports findings; writes no code.
- *   - `research`   — timeboxed investigation / analysis that delivers findings (a spike, an
- *                    environment analysis).
- *   - `planning`   — decomposes and plans an initiative (no code, no repo write of its own).
+ * The pipeline-purpose vocabulary itself ({@link PipelinePurpose} and what each member means)
+ * lives in `pipeline-purpose-vocabulary.ts` and is re-exported here, so every consumer keeps
+ * importing the classifier and the predicates that read it from one place.
  *
  * A non-`build` purpose hides the Implementation/Testing agent kinds in the builder
  * ({@link purposeAllowsAgentCategory}), narrows what its palette offers
- * ({@link purposeSuggestsAgentCategory}) and its saved-pipeline library lists
+ * ({@link purposeSuggestsAgentKind}) and its saved-pipeline library lists
  * ({@link pipelineMatchesPurpose}), and scopes the pipeline in the task pickers
  * ({@link pipelineAllowedForTaskType}). The `Pipeline.purpose` field references this schema.
  */
-export const PIPELINE_PURPOSES = ['build', 'document', 'review', 'research', 'planning'];
-export const pipelinePurposeSchema = v.picklist(PIPELINE_PURPOSES);
-const PIPELINE_PURPOSE_SET = new Set(pipelinePurposeSchema.options);
-/**
- * Whether a value is a purpose THIS BUILD knows, DERIVED from the picklist for the same reason
- * {@link isAgentCategory} is: the vocabulary is closed but PERSISTED, on `Pipeline.purpose`, so a
- * member retired from the union goes on living in stored rows and in the SPA bundle a browser
- * cached before a new member shipped. Narrow with this before indexing anything by a purpose.
- */
-export function isPipelinePurpose(value) {
-    return PIPELINE_PURPOSE_SET.has(value);
-}
+export * from './pipeline-purpose-vocabulary.js';
 // ---------------------------------------------------------------------------
 // Pipeline-purpose gating (shared by the SPA pickers + the builder palette).
 //
@@ -148,6 +129,41 @@ export function purposeSuggestsAgentCategory(purpose, category) {
         return true;
     return PURPOSE_SUGGESTED_CATEGORIES[classifier][category];
 }
+/**
+ * Whether an agent KIND is worth OFFERING to a pipeline of `purpose`: what the builder palette
+ * actually filters on.
+ *
+ * A category is a SHELF LABEL, not a statement of what a kind does, so
+ * {@link purposeSuggestsAgentCategory} can only ever remove whole sections: keeping `docs` for a
+ * `review` pipeline so the Domain Rules Reviewer survives also offered it the two agents that
+ * WRITE documentation into the repo, and `document` and `research` had identical rows, so moving
+ * the dial between them narrowed nothing at all. A kind that knows it belongs to one use-case says
+ * so itself, and the section keeps deciding for every kind that does not.
+ *
+ * The two narrowings INTERSECT: a declaration may only ever hide MORE than the section already
+ * does, never buy a kind back into a purpose its section is not offered to. That is not a
+ * convenience, it is what keeps relevance a SUBSET of compatibility
+ * ({@link purposeAllowsAgentCategory}) no matter what a deployment declares: a kind offered
+ * outside its category's row would be a palette entry whose step then blocks the save, the one
+ * dead end this pair of tables exists to prevent.
+ *
+ * Declaring nothing is the normal case and stays exactly as permissive as before. A declared list
+ * naming only purposes this build cannot NAME is read as declaring nothing rather than as
+ * excluding everything, the same default-open reading its siblings give an unrecognised value: a
+ * kind whose entire list was retired would otherwise vanish from every palette in the build that
+ * has to fix it. An AUTHORED empty list never reaches here at all: `agentPresentationSchema`
+ * refuses one at registration, so this reading cannot double as a way of saying "offer me
+ * nowhere", which is what someone typing `purposes: []` means and the opposite of what it does.
+ */
+export function purposeSuggestsAgentKind(purpose, kind) {
+    const classifier = classifierFor(purpose);
+    if (classifier === null)
+        return true;
+    if (kind.category && !purposeSuggestsAgentCategory(purpose, kind.category))
+        return false;
+    const declared = kind.purposes?.filter((p) => isPipelinePurpose(p)) ?? [];
+    return declared.length === 0 || declared.includes(classifier);
+}
 /**
  * Whether `pipeline` belongs in a library being browsed AT `purpose`: the builder's saved-pipeline
  * list, the third surface the purpose dial narrows (the palette's catalog and the save gate being

package/dist/pipeline-purpose.js.map

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

package/dist/pr-report.d.ts

@@ -554,6 +554,13 @@ export type PrReportEnvironmentEvidence = v.InferOutput<typeof prReportEnvironme
  *                       and distinct from `pending` because the platform did do its part; see
  *                       {@link teardownConfirmationSchema} for which of the causes applies.
  *  - `pending`        — at least one is still standing (the run may still be using it).
+ *  - `retained`       — at least one is still standing AND the pipeline's deployer step DECLARED
+ *                       that its environments outlive the run
+ *                       ({@link StepOptions.retainEnvironment}), so no reclaim is coming from this
+ *                       run and the TTL sweep or an operator owns it from here. Distinct from
+ *                       `pending`, which says a teardown is still expected: a reviewer reading
+ *                       `pending` on a preview environment waits for something that never happens,
+ *                       and an operator reading it goes looking for the failure that isn't there.
  *  - `failed`         — an environment's latest teardown attempt FAILED, so it is still standing
  *                       for a reason someone has to act on.
  *  - `not_applicable` — nothing was ever provisioned.
@@ -569,7 +576,7 @@ export declare const prReportEnvironmentsSchema: v.ObjectSchema<{
         readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly error: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     }, undefined>, undefined>;
-    readonly teardown: v.PicklistSchema<["confirmed", "unconfirmed", "pending", "failed", "not_applicable"], undefined>;
+    readonly teardown: v.PicklistSchema<["confirmed", "unconfirmed", "pending", "retained", "failed", "not_applicable"], undefined>;
     readonly timeline: v.ObjectSchema<{
         /**
          * Why this timeline is empty, or `null` when the log was read whole and the dates below are
@@ -657,7 +664,10 @@ export declare const prReportEnvironmentsSchema: v.ObjectSchema<{
     }, undefined>;
     /**
      * The composed verdict over the three legs:
-     *  - `complete`:       up, observed, and reclaimed.
+     *  - `complete`:       up, observed, and reclaimed — or, where the deployer declared the
+     *                        environment outlives the run, up, observed and deliberately kept. It
+     *                        means the run did everything it undertook to do, NOT that nothing is
+     *                        left standing; {@link teardown} is where that is stated.
      *  - `incomplete`:     at least one leg is missing; {@link gaps} names which.
      *  - `not_applicable`: no environment was ever meant to stand up (no deployer step, or every
      *                       frame is infraless), so there is nothing to prove.
@@ -1431,7 +1441,7 @@ export declare const prVerificationReportSchema: v.ObjectSchema<{
             readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly error: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
-        readonly teardown: v.PicklistSchema<["confirmed", "unconfirmed", "pending", "failed", "not_applicable"], undefined>;
+        readonly teardown: v.PicklistSchema<["confirmed", "unconfirmed", "pending", "retained", "failed", "not_applicable"], undefined>;
         readonly timeline: v.ObjectSchema<{
             /**
              * Why this timeline is empty, or `null` when the log was read whole and the dates below are
@@ -1519,7 +1529,10 @@ export declare const prVerificationReportSchema: v.ObjectSchema<{
         }, undefined>;
         /**
          * The composed verdict over the three legs:
-         *  - `complete`:       up, observed, and reclaimed.
+         *  - `complete`:       up, observed, and reclaimed — or, where the deployer declared the
+         *                        environment outlives the run, up, observed and deliberately kept. It
+         *                        means the run did everything it undertook to do, NOT that nothing is
+         *                        left standing; {@link teardown} is where that is stated.
          *  - `incomplete`:     at least one leg is missing; {@link gaps} names which.
          *  - `not_applicable`: no environment was ever meant to stand up (no deployer step, or every
          *                       frame is infraless), so there is nothing to prove.

package/dist/pr-report.d.ts.map

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

package/dist/pr-report.js

@@ -477,6 +477,13 @@ export const prReportEnvironmentEvidenceSchema = v.object({
  *                       and distinct from `pending` because the platform did do its part; see
  *                       {@link teardownConfirmationSchema} for which of the causes applies.
  *  - `pending`        — at least one is still standing (the run may still be using it).
+ *  - `retained`       — at least one is still standing AND the pipeline's deployer step DECLARED
+ *                       that its environments outlive the run
+ *                       ({@link StepOptions.retainEnvironment}), so no reclaim is coming from this
+ *                       run and the TTL sweep or an operator owns it from here. Distinct from
+ *                       `pending`, which says a teardown is still expected: a reviewer reading
+ *                       `pending` on a preview environment waits for something that never happens,
+ *                       and an operator reading it goes looking for the failure that isn't there.
  *  - `failed`         — an environment's latest teardown attempt FAILED, so it is still standing
  *                       for a reason someone has to act on.
  *  - `not_applicable` — nothing was ever provisioned.
@@ -485,12 +492,22 @@ export const prReportEnvironmentsSchema = v.object({
     status: prReportSectionStatusSchema,
     note: v.optional(v.nullable(v.string())),
     entries: v.array(prReportEnvironmentSchema),
-    teardown: v.picklist(['confirmed', 'unconfirmed', 'pending', 'failed', 'not_applicable']),
+    teardown: v.picklist([
+        'confirmed',
+        'unconfirmed',
+        'pending',
+        'retained',
+        'failed',
+        'not_applicable',
+    ]),
     timeline: prReportEnvironmentTimelineSchema,
     evidence: prReportEnvironmentEvidenceSchema,
     /**
      * The composed verdict over the three legs:
-     *  - `complete`:       up, observed, and reclaimed.
+     *  - `complete`:       up, observed, and reclaimed — or, where the deployer declared the
+     *                        environment outlives the run, up, observed and deliberately kept. It
+     *                        means the run did everything it undertook to do, NOT that nothing is
+     *                        left standing; {@link teardown} is where that is stated.
      *  - `incomplete`:     at least one leg is missing; {@link gaps} names which.
      *  - `not_applicable`: no environment was ever meant to stand up (no deployer step, or every
      *                       frame is infraless), so there is nothing to prove.