@treeseed/sdk 0.10.24 → 0.10.25

package/dist/template-launch-ui.d.ts

@@ -0,0 +1,85 @@
+import type { ProjectEnvironmentName, TemplateLaunchRequirements, TemplateSecretTarget } from './sdk-types.ts';
+import type { ProjectLaunchHostInventoryRecord } from './template-launch-requirements.ts';
+export interface ProjectLaunchRequirementHostChoice {
+    value: string;
+    label: string;
+    mode: 'none' | 'team_owned' | 'treeseed_managed' | 'new';
+    hostId?: string | null;
+    managedHostKey?: string | null;
+    provider: string;
+    type: string;
+    selected: boolean;
+    readiness: 'ready' | 'configuration_required' | 'inactive' | 'new' | 'none';
+    rootDomain?: string | null;
+}
+export interface ProjectLaunchHostRequirementViewModel {
+    kind: 'host';
+    key: string;
+    type: string;
+    displayName: string;
+    purpose: string;
+    required: boolean;
+    compatibleProviders: string[];
+    defaultSelection?: 'team-default' | 'managed' | 'none';
+    environmentScopes: ProjectEnvironmentName[];
+    configWritePreviews: Array<{
+        target: string;
+        path: string;
+        valueFrom: string;
+        writeWhen?: string;
+    }>;
+    environmentWritePreviews: Array<{
+        env: string;
+        targets: string[];
+        scopes: ProjectEnvironmentName[];
+        sensitivity: string;
+    }>;
+    choices: ProjectLaunchRequirementHostChoice[];
+}
+export interface ProjectLaunchResourceRequirementViewModel {
+    kind: 'resource';
+    key: string;
+    type: string;
+    displayName: string;
+    purpose: string;
+    required: boolean;
+    compatibleProviders: string[];
+    configWritePreviews: Array<{
+        target: string;
+        path: string;
+        valueFrom: string;
+        writeWhen?: string;
+    }>;
+    environmentWritePreviews: Array<{
+        env: string;
+        targets: string[];
+        scopes: ProjectEnvironmentName[];
+        sensitivity: string;
+    }>;
+    status: 'unsupported_in_standard_launch';
+}
+export interface ProjectLaunchSecretRequirementViewModel {
+    kind: 'secret';
+    key: string;
+    env: string;
+    required: boolean;
+    sensitivity: string;
+    source: string;
+    targets: TemplateSecretTarget[];
+    status: 'planned';
+}
+export interface ProjectLaunchRequirementsViewModel {
+    version?: number;
+    hosts: ProjectLaunchHostRequirementViewModel[];
+    resources: ProjectLaunchResourceRequirementViewModel[];
+    secrets: ProjectLaunchSecretRequirementViewModel[];
+}
+export interface DeriveProjectLaunchRequirementsViewModelOptions {
+    launchRequirements?: TemplateLaunchRequirements | null;
+    repositoryHosts?: ProjectLaunchHostInventoryRecord[];
+    teamHosts?: ProjectLaunchHostInventoryRecord[];
+    managedHosts?: ProjectLaunchHostInventoryRecord[];
+    defaultHosts?: Record<string, unknown> | null;
+    environmentScopes?: ProjectEnvironmentName[];
+}
+export declare function deriveProjectLaunchRequirementsViewModel(options: DeriveProjectLaunchRequirementsViewModelOptions): ProjectLaunchRequirementsViewModel;

package/dist/template-launch-ui.js

@@ -0,0 +1,189 @@
+function hostType(host) {
+  const metadataType = typeof host.metadata?.hostType === "string" ? host.metadata.hostType : host.type;
+  if (metadataType === "repository_host" || metadataType === "repository") return "repository";
+  if (metadataType === "web_host" || metadataType === "cloudflare" || metadataType === "web") return "web";
+  if (metadataType === "email_host" || metadataType === "smtp" || metadataType === "email") return "email";
+  if (metadataType === "ai_host" || metadataType === "ai") return "ai";
+  if (host.provider === "github") return "repository";
+  if (host.provider === "cloudflare") return "web";
+  if (host.provider === "smtp") return "email";
+  return metadataType ?? "";
+}
+function rootDomain(host) {
+  const metadata = host.metadata ?? {};
+  const dns = metadata.dns && typeof metadata.dns === "object" ? metadata.dns : {};
+  const value = dns.zoneName ?? dns.rootDomain ?? metadata.rootDomain ?? metadata.webRootDomain ?? metadata.cloudflareZoneName;
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function hostLabel(host, fallback) {
+  const ownership = host.ownership === "treeseed_managed" ? "managed" : host.accountLabel ?? host.organizationOrOwner ?? host.provider ?? "team-owned";
+  return `${host.name || fallback} (${ownership})`;
+}
+function compatibleHosts(requirement, options) {
+  const source = requirement.type === "repository" ? options.repositoryHosts ?? [] : [...options.teamHosts ?? [], ...options.managedHosts ?? []];
+  return source.filter((host) => {
+    if (hostType(host) !== requirement.type) return false;
+    return !requirement.compatibleProviders?.length || requirement.compatibleProviders.includes(host.provider);
+  });
+}
+function defaultHostId(requirement, defaultHosts) {
+  for (const key of [requirement.key, requirement.type, requirement.key === "sourceRepository" ? "repository" : null, requirement.key === "publicWeb" ? "web" : null, requirement.key === "transactionalEmail" ? "email" : null]) {
+    if (!key) continue;
+    const value = defaultHosts?.[key];
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return null;
+}
+function selectedChoiceIndex(choices, requirement, defaultHosts) {
+  const configuredDefault = defaultHostId(requirement, defaultHosts);
+  if (configuredDefault) {
+    const index = choices.findIndex((choice) => choice.hostId === configuredDefault || choice.managedHostKey === configuredDefault);
+    if (index >= 0) return index;
+  }
+  if (requirement.defaultSelection === "team-default") {
+    const teamIndex = choices.findIndex((choice) => choice.mode === "team_owned");
+    if (teamIndex >= 0) return teamIndex;
+  }
+  if (requirement.defaultSelection === "managed" || requirement.defaultSelection === "team-default") {
+    const managedIndex = choices.findIndex((choice) => choice.mode === "treeseed_managed");
+    if (managedIndex >= 0) return managedIndex;
+  }
+  if (!requirement.required) {
+    const noneIndex = choices.findIndex((choice) => choice.mode === "none");
+    if (noneIndex >= 0) return noneIndex;
+  }
+  return choices.length > 0 ? 0 : -1;
+}
+function deriveHostRequirement(requirement, options) {
+  const scopes = options.environmentScopes ?? ["staging", "prod"];
+  const choices = compatibleHosts(requirement, options).map((host) => {
+    const managed = host.ownership === "treeseed_managed";
+    const status = typeof host.status === "string" && host.status ? host.status : "active";
+    return {
+      value: `${managed ? "treeseed_managed" : "team_owned"}:${host.id}`,
+      label: hostLabel(host, requirement.displayName),
+      mode: managed ? "treeseed_managed" : "team_owned",
+      hostId: managed && requirement.type !== "repository" ? null : host.id,
+      managedHostKey: managed ? host.id : null,
+      provider: host.provider,
+      type: requirement.type,
+      selected: false,
+      readiness: status === "active" || status === "ready" ? "ready" : status === "configuration_required" ? "configuration_required" : "inactive",
+      rootDomain: rootDomain(host)
+    };
+  });
+  if (requirement.type === "repository" && !choices.some((choice) => choice.value === "treeseed_managed:platform:github:hosted-hubs" || choice.value === "team_owned:platform:github:hosted-hubs")) {
+    choices.unshift({
+      value: "treeseed_managed:platform:github:hosted-hubs",
+      label: "TreeSeed hosted repositories (managed)",
+      mode: "treeseed_managed",
+      hostId: "platform:github:hosted-hubs",
+      managedHostKey: "platform:github:hosted-hubs",
+      provider: "github",
+      type: "repository",
+      selected: false,
+      readiness: "ready",
+      rootDomain: null
+    });
+  }
+  if (!requirement.required) {
+    choices.push({
+      value: `none:${requirement.key}`,
+      label: `No ${requirement.displayName.toLowerCase()}`,
+      mode: "none",
+      hostId: null,
+      managedHostKey: null,
+      provider: requirement.compatibleProviders?.[0] ?? "",
+      type: requirement.type,
+      selected: false,
+      readiness: "none",
+      rootDomain: null
+    });
+  }
+  choices.push({
+    value: `new:${requirement.type}`,
+    label: `Create new ${requirement.type} host...`,
+    mode: "new",
+    hostId: null,
+    managedHostKey: null,
+    provider: requirement.compatibleProviders?.[0] ?? "",
+    type: requirement.type,
+    selected: false,
+    readiness: "new",
+    rootDomain: null
+  });
+  const selectedIndex = selectedChoiceIndex(choices, requirement, options.defaultHosts);
+  if (selectedIndex >= 0) choices[selectedIndex] = { ...choices[selectedIndex], selected: true };
+  return {
+    kind: "host",
+    key: requirement.key,
+    type: requirement.type,
+    displayName: requirement.displayName,
+    purpose: requirement.purpose,
+    required: requirement.required,
+    compatibleProviders: requirement.compatibleProviders ?? [],
+    defaultSelection: requirement.defaultSelection,
+    environmentScopes: scopes,
+    configWritePreviews: (requirement.configWrites ?? []).map((write) => ({
+      target: write.target,
+      path: write.path,
+      valueFrom: write.valueFrom,
+      writeWhen: write.writeWhen
+    })),
+    environmentWritePreviews: (requirement.environmentWrites ?? []).map((write) => ({
+      env: write.env,
+      targets: write.targets ?? [],
+      scopes: write.scopes ?? scopes,
+      sensitivity: write.sensitivity ?? "plain"
+    })),
+    choices
+  };
+}
+function deriveResourceRequirement(requirement) {
+  return {
+    kind: "resource",
+    key: requirement.key,
+    type: requirement.type,
+    displayName: requirement.displayName,
+    purpose: requirement.purpose,
+    required: requirement.required,
+    compatibleProviders: requirement.compatibleProviders ?? [],
+    configWritePreviews: (requirement.configWrites ?? []).map((write) => ({
+      target: write.target,
+      path: write.path,
+      valueFrom: write.valueFrom,
+      writeWhen: write.writeWhen
+    })),
+    environmentWritePreviews: (requirement.environmentWrites ?? []).map((write) => ({
+      env: write.env,
+      targets: write.targets ?? [],
+      scopes: write.scopes ?? ["staging", "prod"],
+      sensitivity: write.sensitivity ?? "plain"
+    })),
+    status: "unsupported_in_standard_launch"
+  };
+}
+function deriveSecretRequirement(requirement) {
+  return {
+    kind: "secret",
+    key: requirement.key,
+    env: requirement.env,
+    required: requirement.required,
+    sensitivity: requirement.sensitivity,
+    source: requirement.source,
+    targets: requirement.targets,
+    status: "planned"
+  };
+}
+function deriveProjectLaunchRequirementsViewModel(options) {
+  const launchRequirements = options.launchRequirements ?? {};
+  return {
+    version: launchRequirements.version,
+    hosts: (launchRequirements.hosts ?? []).map((requirement) => deriveHostRequirement(requirement, options)),
+    resources: (launchRequirements.resources ?? []).map(deriveResourceRequirement),
+    secrets: (launchRequirements.secrets ?? []).map(deriveSecretRequirement)
+  };
+}
+export {
+  deriveProjectLaunchRequirementsViewModel
+};

package/dist/treeseed/template-catalog/catalog.fixture.json

@@ -83,7 +83,7 @@
           "kind": "git",
           "repoUrl": "https://github.com/treeseed-ai/starter-research.git",
           "directory": ".",
-          "ref": "main",
+          "ref": "staging",
           "integrity": "pending-external-repo"
         },
         "hooksPolicy": "builtin_only",
@@ -94,6 +94,64 @@
         "license": "AGPL-3.0-only",
         "support": "community"
       },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated research project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the research site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and research project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
       "relatedBooks": [],
       "relatedKnowledge": [],
       "relatedObjectives": []
@@ -133,7 +191,7 @@
           "kind": "git",
           "repoUrl": "https://github.com/treeseed-ai/starter-engineering.git",
           "directory": ".",
-          "ref": "main",
+          "ref": "staging",
           "integrity": "pending-external-repo"
         },
         "hooksPolicy": "builtin_only",
@@ -144,6 +202,64 @@
         "license": "AGPL-3.0-only",
         "support": "community"
       },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated engineering project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the engineering site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and engineering project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
       "relatedBooks": [],
       "relatedKnowledge": [],
       "relatedObjectives": []
@@ -183,7 +299,7 @@
           "kind": "git",
           "repoUrl": "https://github.com/treeseed-ai/starter-information-hub.git",
           "directory": ".",
-          "ref": "main",
+          "ref": "staging",
           "integrity": "pending-external-repo"
         },
         "hooksPolicy": "builtin_only",
@@ -194,6 +310,217 @@
         "license": "AGPL-3.0-only",
         "support": "community"
       },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the generated information hub project repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the information hub site, previews, content storage, and web runtime resources.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "transactionalEmail",
+            "type": "email",
+            "required": false,
+            "compatibleProviders": ["smtp"],
+            "displayName": "Transactional email",
+            "purpose": "Send form, account, and information hub project notification email.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.transactionalEmail.provider", "valueFrom": "selectedHost.provider", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "SMTP_HOST", "valueFrom": "selectedHost.smtpHost", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          }
+        ]
+      },
+      "relatedBooks": [],
+      "relatedKnowledge": [],
+      "relatedObjectives": []
+    },
+    {
+      "id": "market-control-plane",
+      "displayName": "TreeSeed Market Control Plane",
+      "description": "Draft first-party template requirements for deploying the TreeSeed Market control plane with dynamic host and Railway resource selection.",
+      "summary": "A draft control-plane template that models the Market web/API, operations runner, and PostgreSQL resource roles without hardcoded provider accounts.",
+      "status": "draft",
+      "featured": false,
+      "category": "reference-app",
+      "audience": [
+        "operators",
+        "platform-teams"
+      ],
+      "tags": [
+        "market",
+        "control-plane",
+        "railway",
+        "postgres",
+        "operations-runner"
+      ],
+      "publisher": {
+        "id": "treeseed",
+        "name": "TreeSeed",
+        "url": "https://treeseed.ai"
+      },
+      "publisherVerified": true,
+      "templateVersion": "0.1.0",
+      "templateApiVersion": 1,
+      "minCliVersion": "0.1.1",
+      "minCoreVersion": "0.1.2",
+      "fulfillment": {
+        "mode": "git",
+        "source": {
+          "kind": "git",
+          "repoUrl": "https://github.com/treeseed-ai/market.git",
+          "directory": ".",
+          "ref": "main",
+          "integrity": "draft-requirements-only"
+        },
+        "hooksPolicy": "builtin_only",
+        "supportsReconcile": true
+      },
+      "offer": {
+        "priceModel": "free",
+        "license": "AGPL-3.0-only",
+        "support": "community"
+      },
+      "launchRequirements": {
+        "version": 1,
+        "hosts": [
+          {
+            "kind": "host",
+            "key": "sourceRepository",
+            "type": "repository",
+            "required": true,
+            "compatibleProviders": ["github"],
+            "displayName": "Source repository",
+            "purpose": "Create and push the Market control-plane repository.",
+            "defaultSelection": "team-default",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.owner", "valueFrom": "selectedHost.github.owner" },
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.sourceRepository.repository", "valueFrom": "derived.repositoryName" }
+            ],
+            "environmentWrites": [
+              { "env": "GITHUB_TOKEN", "valueFrom": "selectedHost.token", "targets": ["github-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "host",
+            "key": "publicWeb",
+            "type": "web",
+            "required": true,
+            "compatibleProviders": ["cloudflare"],
+            "displayName": "Public web host",
+            "purpose": "Deploy the Market web surface and public control-plane routes.",
+            "defaultSelection": "managed",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "hosting.hostBindings.publicWeb.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "hosting.kind", "valueFrom": "literal.market_control_plane" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.provider", "valueFrom": "selectedHost.provider" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.prod.domain", "valueFrom": "launchInput.domains.productionDomain", "writeWhen": "host-selected" },
+              { "target": "treeseed.site.yaml", "path": "surfaces.web.environments.staging.domain", "valueFrom": "launchInput.domains.stagingDomain", "writeWhen": "host-selected" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_PUBLIC_WEB_PROVIDER", "valueFrom": "selectedHost.provider", "targets": ["github-variable", "cloudflare-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          }
+        ],
+        "resources": [
+          {
+            "kind": "resource",
+            "key": "marketDatabase",
+            "type": "database",
+            "required": true,
+            "compatibleProviders": ["railway-postgres"],
+            "displayName": "Market database",
+            "purpose": "Provide the PostgreSQL database used by the Market API control plane.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.resourceType", "valueFrom": "literal.postgres" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.marketDatabase.railway.environmentVariable", "valueFrom": "literal.TREESEED_MARKET_DATABASE_URL" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["github-secret", "railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "resource",
+            "key": "api",
+            "type": "service",
+            "required": true,
+            "compatibleProviders": ["railway"],
+            "displayName": "Market API service",
+            "purpose": "Run the Market API service that serves the control-plane routes.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.api.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.api.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.rootDirectory", "valueFrom": "literal." },
+              { "target": "treeseed.site.yaml", "path": "services.api.railway.startCommand", "valueFrom": "literal.node dist/api/server.js" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" }
+            ]
+          },
+          {
+            "kind": "resource",
+            "key": "marketOperationsRunner",
+            "type": "service",
+            "required": true,
+            "compatibleProviders": ["railway"],
+            "displayName": "Market operations runner",
+            "purpose": "Run the governed Market operations runner for queued control-plane operations.",
+            "configWrites": [
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.enabled", "valueFrom": "literal.true" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.provider", "valueFrom": "literal.railway" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.railway.serviceName", "valueFrom": "selectedResource.configValues.serviceName" },
+              { "target": "treeseed.site.yaml", "path": "services.marketOperationsRunner.railway.startCommand", "valueFrom": "literal.node dist/market-operations-runner/runner.js" }
+            ],
+            "environmentWrites": [
+              { "env": "TREESEED_MARKET_DATABASE_URL", "valueFrom": "selectedResource.secretRefs.databaseUrl", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" },
+              { "env": "TREESEED_PLATFORM_RUNNER_TOKEN", "valueFrom": "selectedResource.secretRefs.runnerToken", "targets": ["railway-secret"], "scopes": ["staging", "prod"], "sensitivity": "secret" },
+              { "env": "TREESEED_PLATFORM_RUNNER_ID", "valueFrom": "selectedResource.environmentValues.runnerId", "targets": ["railway-var"], "scopes": ["staging", "prod"], "sensitivity": "plain" }
+            ]
+          }
+        ]
+      },
       "relatedBooks": [],
       "relatedKnowledge": [],
       "relatedObjectives": []