@owlmeans/viable-common 0.0.43 → 0.0.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/viable-common",
-  "version": "0.0.43",
+  "version": "0.0.44",
   "license": "MIT",
   "description": "Runtime-free contracts of the OwlMeans Viable platform — the analysis, design and metadata shapes of a generated project, its target-shape manifest, the slot command vocabulary, the connector protocol and the conversion vocabulary, and the intent-first hand-off from the public site to the platform.",
   "type": "module",
@@ -58,24 +58,24 @@
     }
   },
   "devDependencies": {
-    "@langchain/core": "^1.2.9",
+    "@langchain/core": "^1.2.14",
     "@owlmeans/dep-config": "workspace:*",
-    "ajv": "^8.17.1",
+    "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/agent-common": "^0.1.18-rc.45",
-    "@owlmeans/auth": "^0.1.18-rc.38",
-    "@owlmeans/context": "^0.1.18-rc.32",
-    "@owlmeans/entrypoint": "^0.1.18-rc.39",
-    "@owlmeans/error": "^0.1.18-rc.36",
-    "@owlmeans/flow": "^0.1.18-rc.42",
-    "@owlmeans/llm-common": "^0.1.18-rc.37",
-    "@owlmeans/planning": "^0.1.18-rc.17",
-    "@owlmeans/resource": "^0.1.18-rc.37",
-    "@owlmeans/route": "^0.1.18-rc.33"
+    "@owlmeans/agent-common": "^0.1.18-rc.47",
+    "@owlmeans/auth": "^0.1.18-rc.39",
+    "@owlmeans/context": "^0.1.18-rc.33",
+    "@owlmeans/entrypoint": "^0.1.18-rc.40",
+    "@owlmeans/error": "^0.1.18-rc.37",
+    "@owlmeans/flow": "^0.1.18-rc.44",
+    "@owlmeans/llm-common": "^0.1.18-rc.38",
+    "@owlmeans/planning": "^0.1.18-rc.18",
+    "@owlmeans/resource": "^0.1.18-rc.39",
+    "@owlmeans/route": "^0.1.18-rc.34"
   },
   "publishConfig": {
     "access": "public"

package/src/agent/consts.local.ts

@@ -0,0 +1,47 @@
+import { AgentMarkdownKind, AgentStructuredKind } from './consts.js'
+
+export const documentActions: Record<string, AgentMarkdownKind> = {
+  'write-specification': AgentMarkdownKind.Specification,
+  'summarize-specification': AgentMarkdownKind.Specification,
+  'write-design-concept': AgentMarkdownKind.DesignDocument,
+  'describe-ui-component': AgentMarkdownKind.DesignDocument,
+  'describe-ui-screen': AgentMarkdownKind.DesignDocument,
+  'describe-ui-layout': AgentMarkdownKind.DesignDocument,
+}
+
+export const codeActions = new Set(['code', 'update-code', 'update-code-full'])
+
+/**
+ * The model's schema makes the final output self-describing; while it streams, the helper action
+ * gives the client the same semantic cue before a complete JSON value exists.
+ */
+export const structuredActions: Record<string, AgentStructuredKind> = {
+  'choose-files-for-fix': AgentStructuredKind.ArtifactSelection,
+  'list-files-to-fix': AgentStructuredKind.ArtifactSelection,
+  'extract-user-stories-from-spec': AgentStructuredKind.StoryPlan,
+  'derive-connecting-stories': AgentStructuredKind.StoryPlan,
+  'derive-area-scaffold-stories': AgentStructuredKind.StoryPlan,
+  'describe-ux-story-transitions': AgentStructuredKind.TransitionPlan,
+  'find-entrypoint-for-screen': AgentStructuredKind.EntrypointSelection,
+  'describe-api-access': AgentStructuredKind.AccessPolicy,
+  'describe-screen-access': AgentStructuredKind.AccessPolicy,
+  'plan-scaffold': AgentStructuredKind.ScaffoldPlan,
+  'runtime-gate': AgentStructuredKind.RuntimeDecision,
+  'detect-story-with-home-screen': AgentStructuredKind.CandidateRanking,
+}
+
+/**
+ * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
+ * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
+ */
+/**
+ * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
+ * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
+ * are file/shell operations, not model-schema output, so they always render as ToolCalls even
+ * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
+ * exactly like an ArtifactSelection.
+ */
+export const agentLoopActions = new Set([
+  'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
+  'source-extract',
+])

package/src/agent/consts.ts

@@ -0,0 +1,61 @@
+/**
+ * A compact, runtime-free description of how an agent message should be presented.
+ *
+ * The server emits this with thinking events and the browser refines it as streaming output
+ * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
+ * their own guesses about the same model response.
+ */
+export enum AgentMessageCategory {
+  Code = 'code',
+  Diff = 'diff',
+  Structured = 'structured',
+  Markdown = 'markdown',
+  Plain = 'plain',
+}
+
+export enum AgentCodeLanguage {
+  ReactTsx = 'react-tsx',
+  Css = 'css',
+  TypeScript = 'typescript',
+  Json = 'json',
+  Other = 'other',
+}
+
+/** A semantic shape that the manager can render as a purpose-built card. */
+export enum AgentStructuredKind {
+  ToolCalls = 'tool-calls',
+  ArtifactSelection = 'artifact-selection',
+  EntitySelection = 'entity-selection',
+  StoryPlan = 'story-plan',
+  ScreenPlan = 'screen-plan',
+  ComponentPlan = 'component-plan',
+  TransitionPlan = 'transition-plan',
+  EntrypointSelection = 'entrypoint-selection',
+  AccessPolicy = 'access-policy',
+  ScaffoldPlan = 'scaffold-plan',
+  RuntimeDecision = 'runtime-decision',
+  CandidateRanking = 'candidate-ranking',
+  Decision = 'decision',
+  GenericRecord = 'generic-record',
+  GenericList = 'generic-list',
+  GenericValue = 'generic-value',
+}
+
+export enum AgentMarkdownKind {
+  Specification = 'specification',
+  DesignDocument = 'design-document',
+  Documentation = 'documentation',
+}
+
+/** The family of specialist that produced an output, not an authorization role. */
+export enum AgentMessageRole {
+  Technical = 'technical',
+  Analytical = 'analytical',
+  Product = 'product',
+  Ux = 'ux',
+  VisualDesign = 'visual-design',
+  Architect = 'architect',
+  Developer = 'developer',
+  Repair = 'repair',
+  Orchestrator = 'orchestrator',
+}

package/src/agent/index.ts

@@ -3,3 +3,4 @@ export type * from './types.js'
 export * from './spectator/index.js'
 export * from './memory.js'
 export * from './presentation.js'
+export * from './consts.js'

package/src/agent/presentation.ts

@@ -1,135 +1,8 @@
-/**
- * A compact, runtime-free description of how an agent message should be presented.
- *
- * The server emits this with thinking events and the browser refines it as streaming output
- * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
- * their own guesses about the same model response.
- */
-export enum AgentMessageCategory {
-  Code = 'code',
-  Diff = 'diff',
-  Structured = 'structured',
-  Markdown = 'markdown',
-  Plain = 'plain',
-}
-
-export enum AgentCodeLanguage {
-  ReactTsx = 'react-tsx',
-  Css = 'css',
-  TypeScript = 'typescript',
-  Json = 'json',
-  Other = 'other',
-}
-
-/** A semantic shape that the manager can render as a purpose-built card. */
-export enum AgentStructuredKind {
-  ToolCalls = 'tool-calls',
-  ArtifactSelection = 'artifact-selection',
-  EntitySelection = 'entity-selection',
-  StoryPlan = 'story-plan',
-  ScreenPlan = 'screen-plan',
-  ComponentPlan = 'component-plan',
-  TransitionPlan = 'transition-plan',
-  EntrypointSelection = 'entrypoint-selection',
-  AccessPolicy = 'access-policy',
-  ScaffoldPlan = 'scaffold-plan',
-  RuntimeDecision = 'runtime-decision',
-  CandidateRanking = 'candidate-ranking',
-  Decision = 'decision',
-  GenericRecord = 'generic-record',
-  GenericList = 'generic-list',
-  GenericValue = 'generic-value',
-}
-
-export enum AgentMarkdownKind {
-  Specification = 'specification',
-  DesignDocument = 'design-document',
-  Documentation = 'documentation',
-}
-
-/** The family of specialist that produced an output, not an authorization role. */
-export enum AgentMessageRole {
-  Technical = 'technical',
-  Analytical = 'analytical',
-  Product = 'product',
-  Ux = 'ux',
-  VisualDesign = 'visual-design',
-  Architect = 'architect',
-  Developer = 'developer',
-  Repair = 'repair',
-  Orchestrator = 'orchestrator',
-}
-
-export interface AgentCodePresentation {
-  category: AgentMessageCategory.Code | AgentMessageCategory.Diff
-  language: AgentCodeLanguage
-  role: AgentMessageRole
-}
-
-export interface AgentStructuredPresentation {
-  category: AgentMessageCategory.Structured
-  structure: AgentStructuredKind
-  role: AgentMessageRole
-}
-
-export interface AgentMarkdownPresentation {
-  category: AgentMessageCategory.Markdown
-  document: AgentMarkdownKind
-  role: AgentMessageRole
-}
 
-export interface AgentPlainPresentation {
-  category: AgentMessageCategory.Plain
-  role: AgentMessageRole
-}
-
-export type AgentMessagePresentation =
-  | AgentCodePresentation
-  | AgentStructuredPresentation
-  | AgentMarkdownPresentation
-  | AgentPlainPresentation
-
-/** The attribution and content available to either side of a thinking event. */
-export interface AgentMessageClassificationInput {
-  agent?: string
-  helper?: string
-  action?: string
-  outputType?: string
-  text?: string
-  value?: unknown
-}
-
-type RecordValue = Record<string, unknown>
-
-const documentActions: Record<string, AgentMarkdownKind> = {
-  'write-specification': AgentMarkdownKind.Specification,
-  'summarize-specification': AgentMarkdownKind.Specification,
-  'write-design-concept': AgentMarkdownKind.DesignDocument,
-  'describe-ui-component': AgentMarkdownKind.DesignDocument,
-  'describe-ui-screen': AgentMarkdownKind.DesignDocument,
-  'describe-ui-layout': AgentMarkdownKind.DesignDocument,
-}
-
-const codeActions = new Set(['code', 'update-code', 'update-code-full'])
-
-/**
- * The model's schema makes the final output self-describing; while it streams, the helper action
- * gives the client the same semantic cue before a complete JSON value exists.
- */
-const structuredActions: Record<string, AgentStructuredKind> = {
-  'choose-files-for-fix': AgentStructuredKind.ArtifactSelection,
-  'list-files-to-fix': AgentStructuredKind.ArtifactSelection,
-  'extract-user-stories-from-spec': AgentStructuredKind.StoryPlan,
-  'derive-connecting-stories': AgentStructuredKind.StoryPlan,
-  'derive-area-scaffold-stories': AgentStructuredKind.StoryPlan,
-  'describe-ux-story-transitions': AgentStructuredKind.TransitionPlan,
-  'find-entrypoint-for-screen': AgentStructuredKind.EntrypointSelection,
-  'describe-api-access': AgentStructuredKind.AccessPolicy,
-  'describe-screen-access': AgentStructuredKind.AccessPolicy,
-  'plan-scaffold': AgentStructuredKind.ScaffoldPlan,
-  'runtime-gate': AgentStructuredKind.RuntimeDecision,
-  'detect-story-with-home-screen': AgentStructuredKind.CandidateRanking,
-}
+import { agentLoopActions, codeActions, documentActions, structuredActions } from './consts.local.js'
+import { AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole, AgentStructuredKind } from './consts.js'
+import type { RecordValue } from './types.local.js'
+import type { AgentMessageClassificationInput, AgentMessagePresentation } from './types.js'
 
 const asRecord = (value: unknown): RecordValue | undefined =>
   value != null && typeof value === 'object' && !Array.isArray(value)
@@ -274,22 +147,6 @@ const markdownKindOf = (text: string): AgentMarkdownKind | undefined => {
   return listItems >= 2 ? AgentMarkdownKind.Documentation : undefined
 }
 
-/**
- * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
- * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
- */
-/**
- * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
- * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
- * are file/shell operations, not model-schema output, so they always render as ToolCalls even
- * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
- * exactly like an ArtifactSelection.
- */
-const agentLoopActions = new Set([
-  'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
-  'source-extract',
-])
-
 const isGenericStructure = (kind: AgentStructuredKind | undefined): boolean =>
   kind == null || kind === AgentStructuredKind.GenericRecord || kind === AgentStructuredKind.GenericList ||
   kind === AgentStructuredKind.GenericValue

package/src/agent/types.local.ts

@@ -0,0 +1 @@
+export type RecordValue = Record<string, unknown>

package/src/agent/types.ts

@@ -1,4 +1,5 @@
 import type { LlmPurpose } from '@owlmeans/llm-common'
+import { AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole, AgentStructuredKind } from './consts.js'
 
 /**
  * Observability metadata attached to every model call. Extends the generic
@@ -8,3 +9,42 @@ export interface PurposeMetadata extends LlmPurpose {
   viableAgent?: string
   viableHelper?: string
 }
+
+export interface AgentCodePresentation {
+  category: AgentMessageCategory.Code | AgentMessageCategory.Diff
+  language: AgentCodeLanguage
+  role: AgentMessageRole
+}
+
+export interface AgentStructuredPresentation {
+  category: AgentMessageCategory.Structured
+  structure: AgentStructuredKind
+  role: AgentMessageRole
+}
+
+export interface AgentMarkdownPresentation {
+  category: AgentMessageCategory.Markdown
+  document: AgentMarkdownKind
+  role: AgentMessageRole
+}
+
+export interface AgentPlainPresentation {
+  category: AgentMessageCategory.Plain
+  role: AgentMessageRole
+}
+
+export type AgentMessagePresentation =
+  | AgentCodePresentation
+  | AgentStructuredPresentation
+  | AgentMarkdownPresentation
+  | AgentPlainPresentation
+
+/** The attribution and content available to either side of a thinking event. */
+export interface AgentMessageClassificationInput {
+  agent?: string
+  helper?: string
+  action?: string
+  outputType?: string
+  text?: string
+  value?: unknown
+}

package/src/areas/consts.ts

@@ -1,4 +1,5 @@
 import { AccessLevel } from '../dev/consts.js'
+import type { ProjectTenancy } from './types.js'
 
 /**
  * The audiences a generated application serves.
@@ -110,3 +111,9 @@ export const AREA_TIER: Record<ProjectArea, string | null> = {
   [ProjectArea.Admin]: null,
   [ProjectArea.Operator]: ProjectArea.Operator,
 }
+
+/** The longest requester sentence a tenancy decision quotes — a card refuses a longer one. */
+export const TENANCY_QUOTE_MAX = 1024
+
+/** A single-organization application — what every project is until a decision says otherwise. */
+export const NO_TENANCY: ProjectTenancy = Object.freeze({ operators: false, users: false })

package/src/areas/tenancy.ts

@@ -1,42 +1,6 @@
 import type { Blueprint } from '../blueprint/types.js'
-import { ProjectArea } from './consts.js'
-
-/**
- * Whether a generated application splits its audiences into tenant ORGANIZATIONS.
- *
- * Two flags rather than one, because the two audiences split independently: one back office can
- * serve end users who each belong to their own company (`users` only), every reseller can run its
- * own staff over one shared public (`operators` only), and a B2B tool usually does both. An
- * organization is an IAM-managed tenant — never a table the target keeps for itself.
- *
- * Both false is today's application: one organization, the project owner's, that every person acts in.
- */
-export interface ProjectTenancy {
-  /** The staff of the back office are split into tenant organizations. */
-  operators: boolean
-  /** The end users of the front office are distributed across tenant organizations. */
-  users: boolean
-}
-
-/**
- * A tenancy decision as the project card records it (`fields.tenancy`).
- *
- * The flags plus where they came from. `quotes` are the requester's OWN sentences, verbatim — the
- * evidence a later reader (a person reviewing the board, a run asked to reconsider) checks the
- * decision against, which a paraphrase would quietly replace with the model's reading of it.
- * `by` says whether a model inferred it or the owner set it; `at` is when, an ISO timestamp.
- */
-export interface ViableTenancyDecision extends ProjectTenancy {
-  quotes?: { operators?: string; users?: string }
-  by: 'model' | 'owner'
-  at: string
-}
-
-/** The longest requester sentence a tenancy decision quotes — a card refuses a longer one. */
-export const TENANCY_QUOTE_MAX = 1024
-
-/** A single-organization application — what every project is until a decision says otherwise. */
-export const NO_TENANCY: ProjectTenancy = Object.freeze({ operators: false, users: false })
+import { ProjectArea, NO_TENANCY } from './consts.js'
+import type { ProjectTenancy } from './types.js'
 
 /**
  * The tenancy of a resolved blueprint.

package/src/areas/types.ts

@@ -27,3 +27,34 @@ export interface NavEntry {
   alias: string
   label: string
 }
+
+/**
+ * Whether a generated application splits its audiences into tenant ORGANIZATIONS.
+ *
+ * Two flags rather than one, because the two audiences split independently: one back office can
+ * serve end users who each belong to their own company (`users` only), every reseller can run its
+ * own staff over one shared public (`operators` only), and a B2B tool usually does both. An
+ * organization is an IAM-managed tenant — never a table the target keeps for itself.
+ *
+ * Both false is today's application: one organization, the project owner's, that every person acts in.
+ */
+export interface ProjectTenancy {
+  /** The staff of the back office are split into tenant organizations. */
+  operators: boolean
+  /** The end users of the front office are distributed across tenant organizations. */
+  users: boolean
+}
+
+/**
+ * A tenancy decision as the project card records it (`fields.tenancy`).
+ *
+ * The flags plus where they came from. `quotes` are the requester's OWN sentences, verbatim — the
+ * evidence a later reader (a person reviewing the board, a run asked to reconsider) checks the
+ * decision against, which a paraphrase would quietly replace with the model's reading of it.
+ * `by` says whether a model inferred it or the owner set it; `at` is when, an ISO timestamp.
+ */
+export interface ViableTenancyDecision extends ProjectTenancy {
+  quotes?: { operators?: string; users?: string }
+  by: 'model' | 'owner'
+  at: string
+}

package/src/ba/types.ts

@@ -2,7 +2,7 @@ import { SpecCategory } from "./consts"
 import type { ConnectingStoryKind, StoryKind } from "./consts.js"
 import type { ProjectArea } from "../areas/consts.js"
 import type { StoryDraft } from "../areas/types.js"
-import type { StoryActor } from "../design/runtime.js"
+import type { StoryActor } from "../design/consts.js"
 
 export interface EntityList {
   entities: string[]

package/src/blueprint/consts.local.ts

@@ -0,0 +1,3 @@
+import { LandingGatePreference } from './consts.js'
+
+export const LANDING_GATE_PREFERENCES = new Set<string>(Object.values(LandingGatePreference))

package/src/blueprint/consts.ts

@@ -85,3 +85,55 @@ export enum WorkKind {
 
 /** The longest case quote a project card keeps (`fields.caseQuote`) — one sentence, generously. */
 export const CASE_QUOTE_MAX = 1024
+
+/**
+ * The layers, lowest first. A higher layer's value replaces the same key from a lower one.
+ *
+ * The ordering is the point: `technology` overrides everything, because a change of language
+ * invalidates every template, prompt and package below it. Nothing today has more than one
+ * technology — the ladder exists so that adding one is a data change. `experience` is last and
+ * optional: it shares no key with the five build layers, so its place decides nothing today.
+ */
+export enum BlueprintLayer {
+  Technology = 'technology',
+  Stack = 'stack',
+  Template = 'template',
+  CreateApp = 'create-app',
+  Packages = 'packages',
+  Experience = 'experience',
+}
+
+export const BLUEPRINT_LAYER_ORDER: BlueprintLayer[] = [
+  BlueprintLayer.Technology,
+  BlueprintLayer.Stack,
+  BlueprintLayer.Template,
+  BlueprintLayer.CreateApp,
+  BlueprintLayer.Packages,
+  BlueprintLayer.Experience,
+]
+
+/**
+ * How strongly a product of this kind wants a LANDING GATE — the working entry into the key
+ * end-user workflow drawn on the guest home, where a guest starts before signing in.
+ *
+ * A PRIOR handed to the model that decides, never the decision itself: `Encourage` still lets it
+ * answer "no gate" for a product with no end-user step a guest could begin, and `Discourage` still
+ * lets it choose one when the specification plainly describes such a step.
+ */
+export enum LandingGatePreference {
+  /** Most products of this kind have a first-value step a guest can begin — look for it. */
+  Encourage = 'encourage',
+  /** Neutral: decide from the specification alone. */
+  Allow = 'allow',
+  /** Products of this kind rarely have one — choose a gate only when the specification asks. */
+  Discourage = 'discourage',
+}
+
+export enum BlueprintPatchKind {
+  /** Deep-merge a JSON document — the manifests, the tsconfigs. */
+  JsonMerge = 'json-merge',
+  /** Rewrite the `<head>` of an HTML document from the project's identity. */
+  HtmlHead = 'html-head',
+  /** Write a document composed from the project's identity. */
+  Compose = 'compose',
+}

package/src/blueprint/index.ts

@@ -1,3 +1,4 @@
 export * from './types.js'
+export * from './utils.js'
 
 export * from './consts.js'

package/src/blueprint/types.ts

@@ -1,8 +1,9 @@
-import type { ProjectTenancy } from '../areas/tenancy.js'
+import type { ProjectTenancy } from '../areas/types.js'
 import type { SubProject } from '../slot/consts.js'
 import type { ViableSkill } from '../skills/consts.js'
 import type { ViablePersona } from '../skills/roles.js'
 import type { TopologyDescriptor } from '../topology/types.js'
+import { BlueprintPatchKind, LandingGatePreference } from './consts.js'
 
 /**
  * A BLUEPRINT is everything that decides what kind of project the pipeline is building — the
@@ -35,49 +36,6 @@ export interface Blueprint {
   experience?: ExperienceLayer
 }
 
-/**
- * The layers, lowest first. A higher layer's value replaces the same key from a lower one.
- *
- * The ordering is the point: `technology` overrides everything, because a change of language
- * invalidates every template, prompt and package below it. Nothing today has more than one
- * technology — the ladder exists so that adding one is a data change. `experience` is last and
- * optional: it shares no key with the five build layers, so its place decides nothing today.
- */
-export enum BlueprintLayer {
-  Technology = 'technology',
-  Stack = 'stack',
-  Template = 'template',
-  CreateApp = 'create-app',
-  Packages = 'packages',
-  Experience = 'experience',
-}
-
-export const BLUEPRINT_LAYER_ORDER: BlueprintLayer[] = [
-  BlueprintLayer.Technology,
-  BlueprintLayer.Stack,
-  BlueprintLayer.Template,
-  BlueprintLayer.CreateApp,
-  BlueprintLayer.Packages,
-  BlueprintLayer.Experience,
-]
-
-/**
- * How strongly a product of this kind wants a LANDING GATE — the working entry into the key
- * end-user workflow drawn on the guest home, where a guest starts before signing in.
- *
- * A PRIOR handed to the model that decides, never the decision itself: `Encourage` still lets it
- * answer "no gate" for a product with no end-user step a guest could begin, and `Discourage` still
- * lets it choose one when the specification plainly describes such a step.
- */
-export enum LandingGatePreference {
-  /** Most products of this kind have a first-value step a guest can begin — look for it. */
-  Encourage = 'encourage',
-  /** Neutral: decide from the specification alone. */
-  Allow = 'allow',
-  /** Products of this kind rarely have one — choose a gate only when the specification asks. */
-  Discourage = 'discourage',
-}
-
 /**
  * What the product should do for the people using it, independent of the stack it is built on.
  *
@@ -96,25 +54,6 @@ export interface ExperienceLayer {
   tenancy?: ProjectTenancy
 }
 
-const LANDING_GATE_PREFERENCES = new Set<string>(Object.values(LandingGatePreference))
-
-/**
- * The landing-gate preference of a resolved blueprint.
- *
- * Total: an absent layer, an absent key and a value this deploy does not know (a patch serialized
- * by a newer one) all answer `Allow` — the neutral prior, which leaves the decision to the
- * specification rather than tilting it either way on a value nobody set.
- */
-export const landingGatePreferenceOf = (
-  blueprint?: Pick<Blueprint, 'experience'> | null
-): LandingGatePreference => {
-  const value = blueprint?.experience?.landingGate
-
-  return value != null && LANDING_GATE_PREFERENCES.has(value)
-    ? value
-    : LandingGatePreference.Allow
-}
-
 /** Language and toolchain. Overrides everything below it. */
 export interface TechnologyLayer {
   id: string
@@ -181,15 +120,6 @@ export interface BlueprintPatchSpec {
   kind: BlueprintPatchKind
 }
 
-export enum BlueprintPatchKind {
-  /** Deep-merge a JSON document — the manifests, the tsconfigs. */
-  JsonMerge = 'json-merge',
-  /** Rewrite the `<head>` of an HTML document from the project's identity. */
-  HtmlHead = 'html-head',
-  /** Write a document composed from the project's identity. */
-  Compose = 'compose',
-}
-
 /** Which scaffolder runs first, and how. */
 export interface CreateAppLayer {
   id: string

package/src/blueprint/utils.ts

@@ -0,0 +1,20 @@
+import { LANDING_GATE_PREFERENCES } from './consts.local.js'
+import { LandingGatePreference } from './consts.js'
+import type { Blueprint } from './types.js'
+
+/**
+ * The landing-gate preference of a resolved blueprint.
+ *
+ * Total: an absent layer, an absent key and a value this deploy does not know (a patch serialized
+ * by a newer one) all answer `Allow` — the neutral prior, which leaves the decision to the
+ * specification rather than tilting it either way on a value nobody set.
+ */
+export const landingGatePreferenceOf = (
+  blueprint?: Pick<Blueprint, 'experience'> | null
+): LandingGatePreference => {
+  const value = blueprint?.experience?.landingGate
+
+  return value != null && LANDING_GATE_PREFERENCES.has(value)
+    ? value
+    : LandingGatePreference.Allow
+}