@treeseed/sdk 0.12.60 → 0.12.61

package/dist/guarantees/index.js

@@ -19,6 +19,9 @@ function diagnostic(severity, code, message, path, sourcePath) {
 function isRecord(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
+function arrayOrEmpty(value) {
+  return value ?? [];
+}
 function stringValue(value) {
   return typeof value === "string" ? value.trim() : "";
 }
@@ -332,10 +335,10 @@ function validateTreeseedGuarantee(input) {
 }
 function allVerifierRefs(manifest) {
   return [
-    ...manifest.api?.verifierRefs ?? [],
-    ...manifest.content?.verifierRefs ?? [],
-    ...manifest.audit?.verifierRefs ?? [],
-    ...(manifest.negativeCases ?? []).flatMap((entry) => entry.verifierRefs ?? [])
+    ...arrayOrEmpty(manifest.api?.verifierRefs),
+    ...arrayOrEmpty(manifest.content?.verifierRefs),
+    ...arrayOrEmpty(manifest.audit?.verifierRefs),
+    ...arrayOrEmpty(manifest.negativeCases).flatMap((entry) => arrayOrEmpty(entry.verifierRefs))
   ];
 }
 function selectedByFilter(manifest, filter = {}) {
@@ -403,9 +406,9 @@ function dependencyIdsForGuarantee(input) {
     reasons.add(reason);
     deps.set(id, reasons);
   };
-  for (const id of input.entry.manifest.dependencies.guarantees ?? []) add(id, "explicit-guarantee");
-  for (const journeyIndex of input.entry.manifest.dependencies.journeys ?? []) add(input.byJourneyIndex.get(journeyIndex)?.manifest.id, "journey-index");
-  for (const dep of input.entry.manifest.dependsOnGuarantees ?? []) {
+  for (const id of arrayOrEmpty(input.entry.manifest.dependencies.guarantees)) add(id, "explicit-guarantee");
+  for (const journeyIndex of arrayOrEmpty(input.entry.manifest.dependencies.journeys)) add(input.byJourneyIndex.get(journeyIndex)?.manifest.id, "journey-index");
+  for (const dep of arrayOrEmpty(input.entry.manifest.dependsOnGuarantees)) {
     const [ownerPackage, ref] = dep.includes(":") ? dep.split(/:(.+)/u).filter(Boolean) : ["", dep];
     const match = input.valid.find((candidate) => (!ownerPackage || candidate.manifest.ownerPackage === ownerPackage) && candidate.manifest.status === "active" && (candidate.manifest.id === ref || allVerifierRefs(candidate.manifest).includes(ref)));
     add(match?.manifest.id, "depends-on-verifier");
@@ -455,14 +458,14 @@ function buildTreeseedGuaranteeDependencyGraph(input) {
     const filtered = [...deps.keys()].filter((id) => includedIds.has(id)).sort((a, b) => sortGuaranteeEntries(byId.get(a), byId.get(b)));
     depMap.set(entry.manifest.id, filtered);
     const reasons = /* @__PURE__ */ new Set();
-    for (const depId of filtered) for (const reason of deps.get(depId) ?? []) reasons.add(reason);
-    for (const reason of reasonById.get(entry.manifest.id) ?? []) reasons.add(reason);
+    for (const depId of filtered) for (const reason of arrayOrEmpty(deps.get(depId))) reasons.add(reason);
+    for (const reason of arrayOrEmpty(reasonById.get(entry.manifest.id))) reasons.add(reason);
     reasonMap.set(entry.manifest.id, reasons);
   }
   const producersByStateKey = /* @__PURE__ */ new Map();
   for (const [id, keys] of stateProduces) {
     for (const key of keys) {
-      producersByStateKey.set(key, [...producersByStateKey.get(key) ?? [], id]);
+      producersByStateKey.set(key, [...arrayOrEmpty(producersByStateKey.get(key)), id]);
     }
   }
   for (const [key, producers] of producersByStateKey) {
@@ -480,10 +483,10 @@ function buildTreeseedGuaranteeDependencyGraph(input) {
   }
   for (const [id, keys] of stateConsumes) {
     for (const key of keys) {
-      const producers = producersByStateKey.get(key) ?? [];
+      const producers = arrayOrEmpty(producersByStateKey.get(key));
       const producer = producers.length === 1 ? producers[0] : void 0;
       if (producer && producer !== id && includedIds.has(producer)) {
-        const deps = depMap.get(id) ?? [];
+        const deps = arrayOrEmpty(depMap.get(id));
         if (!deps.includes(producer)) deps.push(producer);
         depMap.set(id, deps.sort((a, b) => sortGuaranteeEntries(byId.get(a), byId.get(b))));
         const reasons = reasonMap.get(id) ?? /* @__PURE__ */ new Set();
@@ -502,14 +505,14 @@ function buildTreeseedGuaranteeDependencyGraph(input) {
       return;
     }
     visiting.add(id);
-    for (const dep of depMap.get(id) ?? []) visitOrder(dep, [...chain, id]);
+    for (const dep of arrayOrEmpty(depMap.get(id))) visitOrder(dep, [...chain, id]);
     visiting.delete(id);
     visited.add(id);
     ordered.push(id);
   };
   for (const entry of included) visitOrder(entry.manifest.id, []);
   const inverse = /* @__PURE__ */ new Map();
-  for (const [id, deps] of depMap) for (const dep of deps) inverse.set(dep, [...inverse.get(dep) ?? [], id]);
+  for (const [id, deps] of depMap) for (const dep of deps) inverse.set(dep, [...arrayOrEmpty(inverse.get(dep)), id]);
   const depthCache = /* @__PURE__ */ new Map();
   const depth = (id, chain = []) => {
     if (depthCache.has(id)) return depthCache.get(id);
@@ -517,20 +520,20 @@ function buildTreeseedGuaranteeDependencyGraph(input) {
       diagnostics.push(diagnostic("error", "guarantee.dependency_cycle", `Guarantee dependency cycle: ${[...chain, id].join(" -> ")}.`, "dependencies", byId.get(id)?.sourcePath));
       return 0;
     }
-    const value = Math.max(0, ...(depMap.get(id) ?? []).map((dep) => depth(dep, [...chain, id]) + 1));
+    const value = Math.max(0, ...arrayOrEmpty(depMap.get(id)).map((dep) => depth(dep, [...chain, id]) + 1));
     depthCache.set(id, value);
     return value;
   };
   const meta = /* @__PURE__ */ new Map();
   for (const [index, id] of ordered.entries()) {
     meta.set(id, {
-      dependsOn: depMap.get(id) ?? [],
-      dependencyOf: (inverse.get(id) ?? []).sort((a, b) => sortGuaranteeEntries(byId.get(a), byId.get(b))),
+      dependsOn: arrayOrEmpty(depMap.get(id)),
+      dependencyOf: arrayOrEmpty(inverse.get(id)).sort((a, b) => sortGuaranteeEntries(byId.get(a), byId.get(b))),
       dependencyReason: [...reasonMap.get(id) ?? /* @__PURE__ */ new Set()],
       dependencyDepth: depth(id),
       executionOrder: index,
-      producesState: stateProduces.get(id) ?? [],
-      consumesState: stateConsumes.get(id) ?? []
+      producesState: arrayOrEmpty(stateProduces.get(id)),
+      consumesState: arrayOrEmpty(stateConsumes.get(id))
     });
   }
   return { entries: ordered.map((id) => byId.get(id)).filter(Boolean), selectedIds, meta, diagnostics };
@@ -541,7 +544,7 @@ function filterTreeseedGuarantees(input) {
 function validateTreeseedGuaranteeRegistry(input) {
   const diagnostics = [
     ...input.guarantees.flatMap((entry) => entry.diagnostics),
-    ...(input.verifierRegistries ?? []).flatMap((entry) => entry.diagnostics)
+    ...arrayOrEmpty(input.verifierRegistries).flatMap((entry) => entry.diagnostics)
   ];
   validateFilter(input.filter, diagnostics);
   const valid = input.guarantees.filter((entry) => Boolean(entry.manifest));
@@ -558,16 +561,16 @@ function validateTreeseedGuaranteeRegistry(input) {
     }
   }
   for (const entry of valid) {
-    for (const dep of entry.manifest.dependencies.guarantees ?? []) {
+    for (const dep of arrayOrEmpty(entry.manifest.dependencies.guarantees)) {
       if (!ids.has(dep)) diagnostics.push(diagnostic("error", "guarantee.missing_dependency", `Missing guarantee dependency "${dep}".`, "dependencies.guarantees", entry.sourcePath));
     }
-    for (const dep of entry.manifest.dependencies.journeys ?? []) {
+    for (const dep of arrayOrEmpty(entry.manifest.dependencies.journeys)) {
       if (!journeyIndexes.has(dep)) diagnostics.push(diagnostic("error", "guarantee.missing_journey_dependency", `Missing journey dependency "${dep}".`, "dependencies.journeys", entry.sourcePath));
       if (entry.manifest.journeyIndex && dep >= entry.manifest.journeyIndex) diagnostics.push(diagnostic("error", "guarantee.forward_journey_dependency", `Journey dependency ${dep} must be lower than ${entry.manifest.journeyIndex}.`, "dependencies.journeys", entry.sourcePath));
     }
   }
   for (const entry of valid) {
-    for (const dep of entry.manifest.dependsOnGuarantees ?? []) {
+    for (const dep of arrayOrEmpty(entry.manifest.dependsOnGuarantees)) {
       const [ownerPackage, ref] = dep.includes(":") ? dep.split(/:(.+)/u).filter(Boolean) : ["", dep];
       const match = valid.find((candidate) => (!ownerPackage || candidate.manifest.ownerPackage === ownerPackage) && candidate.manifest.status === "active" && (candidate.manifest.id === ref || allVerifierRefs(candidate.manifest).includes(ref)));
       if (!match) diagnostics.push(diagnostic("error", "guarantee.missing_depends_on_guarantee", `Missing active guarantee dependency "${dep}".`, "dependsOnGuarantees", entry.sourcePath));
@@ -582,13 +585,13 @@ function validateTreeseedGuaranteeRegistry(input) {
       return;
     }
     visiting.add(id);
-    for (const dep of ids.get(id)?.manifest.dependencies.guarantees ?? []) visit(dep, [...chain, id]);
+    for (const dep of arrayOrEmpty(ids.get(id)?.manifest.dependencies.guarantees)) visit(dep, [...chain, id]);
     visiting.delete(id);
     visited.add(id);
   };
   for (const id of ids.keys()) visit(id, []);
-  const verifierIds = new Set((input.verifierRegistries ?? []).flatMap((entry) => Object.keys(entry.registry?.verifiers ?? {})));
-  const verifierKinds = new Map((input.verifierRegistries ?? []).flatMap(
+  const verifierIds = new Set(arrayOrEmpty(input.verifierRegistries).flatMap((entry) => Object.keys(entry.registry?.verifiers ?? {})));
+  const verifierKinds = new Map(arrayOrEmpty(input.verifierRegistries).flatMap(
     (registry) => Object.entries(registry.registry?.verifiers ?? {}).map(([id, definition]) => [id, definition.kind])
   ));
   for (const entry of valid) {
@@ -613,7 +616,7 @@ function validateTreeseedGuaranteeRegistry(input) {
     ok: errors === 0,
     workspaceRoot: resolve(input.workspaceRoot),
     guarantees: input.guarantees,
-    verifierRegistries: input.verifierRegistries ?? [],
+    verifierRegistries: arrayOrEmpty(input.verifierRegistries),
     diagnostics,
     counts: {
       total: input.guarantees.length,
@@ -625,7 +628,7 @@ function validateTreeseedGuaranteeRegistry(input) {
   };
 }
 function refs(contract) {
-  return contract?.verifierRefs ?? [];
+  return arrayOrEmpty(contract?.verifierRefs);
 }
 function planTreeseedGuarantees(input) {
   const registry = discoverTreeseedGuarantees({ workspaceRoot: input.workspaceRoot, filter: input.filter });
@@ -653,9 +656,9 @@ function planTreeseedGuarantees(input) {
       auditVerifierRefs: refs(entry.manifest.audit),
       evidenceRequired: entry.manifest.evidence.required,
       dependencyDepth: meta?.dependencyDepth ?? 0,
-      dependencyOf: meta?.dependencyOf ?? [],
-      dependsOn: meta?.dependsOn ?? [],
-      dependencyReason: meta?.dependencyReason ?? [],
+      dependencyOf: arrayOrEmpty(meta?.dependencyOf),
+      dependsOn: arrayOrEmpty(meta?.dependsOn),
+      dependencyReason: arrayOrEmpty(meta?.dependencyReason),
       executionOrder: meta?.executionOrder ?? 0,
       ...meta?.producesState.length ? { producesState: meta.producesState } : {},
       ...meta?.consumesState.length ? { consumesState: meta.consumesState } : {}
@@ -894,19 +897,19 @@ function exportTreeseedGuaranteesCsv(input) {
     entry.manifest.ownerPackage,
     entry.manifest.surface ?? "",
     entry.manifest.status,
-    [...entry.manifest.dependencies.guarantees ?? [], ...(entry.manifest.dependencies.journeys ?? []).map((id) => `journey:${id}`)],
+    [...arrayOrEmpty(entry.manifest.dependencies.guarantees), ...arrayOrEmpty(entry.manifest.dependencies.journeys).map((id) => `journey:${id}`)],
     entry.manifest.actors.allowed,
     entry.manifest.actors.forbidden,
-    [...entry.manifest.devices.required, ...entry.manifest.devices.optional ?? []],
-    [...entry.manifest.preconditions.fixtures ?? [], ...entry.manifest.preconditions.notes ?? []],
+    [...entry.manifest.devices.required, ...arrayOrEmpty(entry.manifest.devices.optional)],
+    [...arrayOrEmpty(entry.manifest.preconditions.fixtures), ...arrayOrEmpty(entry.manifest.preconditions.notes)],
     entry.manifest.scene?.manifest ?? "",
-    entry.manifest.api?.verifierRefs ?? [],
-    entry.manifest.content?.verifierRefs ?? [],
-    entry.manifest.audit?.verifierRefs ?? [],
-    (entry.manifest.negativeCases ?? []).map((negativeCase) => negativeCase.id),
+    arrayOrEmpty(entry.manifest.api?.verifierRefs),
+    arrayOrEmpty(entry.manifest.content?.verifierRefs),
+    arrayOrEmpty(entry.manifest.audit?.verifierRefs),
+    arrayOrEmpty(entry.manifest.negativeCases).map((negativeCase) => negativeCase.id),
     entry.manifest.gates,
     entry.manifest.evidence.required,
-    entry.manifest.notes ?? [],
+    arrayOrEmpty(entry.manifest.notes),
     entry.relativePath
   ]);
   return [header, ...body].map((row) => row.map(csvEscape).join(",")).join("\n") + "\n";
@@ -1217,10 +1220,10 @@ async function defaultTreeseedGuaranteeVerifierExecutor(input) {
     };
   }
   if (definition.kind === "manualEvidence") {
-    return { status: "skipped", summary: `${input.ref} requires manual evidence.`, evidence: definition.evidence ?? [] };
+    return { status: "skipped", summary: `${input.ref} requires manual evidence.`, evidence: arrayOrEmpty(definition.evidence) };
   }
   if (definition.kind === "scene") {
-    return { status: "passed", summary: `${input.ref} is covered by the guarantee scene step.`, evidence: definition.evidence ?? [] };
+    return { status: "passed", summary: `${input.ref} is covered by the guarantee scene step.`, evidence: arrayOrEmpty(definition.evidence) };
   }
   if (definition.kind === "apiAcceptanceCase") {
     if (!definition.caseId) {
@@ -1261,7 +1264,7 @@ async function defaultTreeseedGuaranteeVerifierExecutor(input) {
       outputRoot: input.outputRoot,
       ref: input.ref,
       command: "npm",
-      args: ["-w", workspace, "run", definition.command, "--", ...definition.args ?? []],
+      args: ["-w", workspace, "run", definition.command, "--", ...arrayOrEmpty(definition.args)],
       timeoutSeconds: definition.timeoutSeconds,
       onProgress: input.onProgress
     });
@@ -1275,7 +1278,7 @@ async function defaultTreeseedGuaranteeVerifierExecutor(input) {
       outputRoot: input.outputRoot,
       ref: input.ref,
       command: "node",
-      args: ["--import", "tsx", definition.command, ...definition.args ?? []],
+      args: ["--import", "tsx", definition.command, ...arrayOrEmpty(definition.args)],
       cwd: definition.cwd,
       timeoutSeconds: definition.timeoutSeconds,
       onProgress: input.onProgress
@@ -1310,8 +1313,8 @@ function sceneDeviceRunsForGuarantee(devices) {
 }
 function sceneReportEvidencePaths(workspaceRoot, report) {
   const primaryScreenshots = [
-    ...(report.steps ?? []).map((step) => step.screenshotPath).filter(Boolean),
-    ...report.artifacts?.screenshotPaths ?? []
+    ...arrayOrEmpty(report.steps).map((step) => step.screenshotPath).filter(Boolean),
+    ...arrayOrEmpty(report.artifacts?.screenshotPaths)
   ].filter((path) => Boolean(path && !path.includes("/screenshots/viewport/")));
   return sortedUnique([
     ...primaryScreenshots,
@@ -1347,7 +1350,7 @@ async function defaultTreeseedGuaranteeSceneExecutor(input) {
         status: ok2 ? "passed" : "failed",
         summary: ok2 ? "Scene device matrix passed." : contractDiagnostics.length > 0 ? "Scene is not a complete service journey." : "Scene device matrix failed.",
         evidence: runReports.flatMap((entry) => sceneReportEvidencePaths(input.workspaceRoot, entry)),
-        diagnostics: [...contractDiagnostics, ...runReports.flatMap((entry) => entry.diagnostics ?? [])]
+        diagnostics: [...contractDiagnostics, ...runReports.flatMap((entry) => arrayOrEmpty(entry.diagnostics))]
       };
     }
     const run = runs[0];
@@ -1368,7 +1371,7 @@ async function defaultTreeseedGuaranteeSceneExecutor(input) {
       status: ok ? "passed" : "failed",
       summary: ok ? "Scene passed." : contractDiagnostics.length > 0 ? "Scene is not a complete service journey." : "Scene failed.",
       evidence: sceneReportEvidencePaths(input.workspaceRoot, report),
-      diagnostics: [...contractDiagnostics, ...report.diagnostics ?? []]
+      diagnostics: [...contractDiagnostics, ...arrayOrEmpty(report.diagnostics)]
     };
   } catch (error) {
     return {
@@ -1449,14 +1452,14 @@ async function runGuaranteeSteps(input) {
       ...step,
       status: result.status,
       summary: result.summary ?? step.summary,
-      evidence: result.evidence ?? step.evidence ?? [],
-      diagnostics: result.diagnostics ?? step.diagnostics ?? [],
+      evidence: result.evidence ?? arrayOrEmpty(step.evidence),
+      diagnostics: result.diagnostics ?? arrayOrEmpty(step.diagnostics),
       startedAt: stepStartedAt,
       completedAt
     };
     steps.push(nextStep);
-    evidence.push(...nextStep.evidence ?? []);
-    diagnostics.push(...nextStep.diagnostics ?? []);
+    evidence.push(...arrayOrEmpty(nextStep.evidence));
+    diagnostics.push(...arrayOrEmpty(nextStep.diagnostics));
     input.onProgress?.(`[guarantees][step] ${input.guarantee.manifest.id}: ${nextStep.status} ${step.kind}${step.ref ? ` ${step.ref}` : ""}`);
   };
   const scene = input.guarantee.manifest.scene;
@@ -1475,10 +1478,10 @@ async function runGuaranteeSteps(input) {
     }));
   }
   const verifierGroups = [
-    { kind: "api", refs: input.guarantee.manifest.api?.verifierRefs ?? [] },
-    { kind: "content", refs: input.guarantee.manifest.content?.verifierRefs ?? [] },
-    { kind: "audit", refs: input.guarantee.manifest.audit?.verifierRefs ?? [] },
-    { kind: "negative-case", refs: (input.guarantee.manifest.negativeCases ?? []).flatMap((entry) => entry.verifierRefs ?? []) }
+    { kind: "api", refs: arrayOrEmpty(input.guarantee.manifest.api?.verifierRefs) },
+    { kind: "content", refs: arrayOrEmpty(input.guarantee.manifest.content?.verifierRefs) },
+    { kind: "audit", refs: arrayOrEmpty(input.guarantee.manifest.audit?.verifierRefs) },
+    { kind: "negative-case", refs: arrayOrEmpty(input.guarantee.manifest.negativeCases).flatMap((entry) => arrayOrEmpty(entry.verifierRefs)) }
   ];
   for (const group of verifierGroups) {
     for (const ref of group.refs) {
@@ -1553,7 +1556,7 @@ async function runTreeseedGuarantees(input) {
     for (const [index, entry] of runEntries.entries()) {
       input.onProgress?.(`[guarantees][run] ${index + 1}/${runEntries.length} ${entry.manifest.id} (${entry.manifest.ownerPackage}) ${entry.manifest.journey}`);
       const planEntry = planEntryById.get(entry.manifest.id);
-      const blockingDependencies = (planEntry?.dependsOn ?? []).map((id) => resultById.get(id)).filter((result2) => Boolean(result2 && result2.status !== "passed"));
+      const blockingDependencies = arrayOrEmpty(planEntry?.dependsOn).map((id) => resultById.get(id)).filter((result2) => Boolean(result2 && result2.status !== "passed"));
       if (blockingDependencies.length > 0) {
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const blockedBy = blockingDependencies.map((result2) => result2.id);

package/dist/hosting/contracts.d.ts

@@ -171,25 +171,6 @@ export interface TreeseedHostingPlan {
     placements: TreeseedHostingPlacementSummary[];
     warnings: string[];
 }
-export interface TreeseedHostingApplyResult {
-    environment: TreeseedHostingEnvironment;
-    planOnly: boolean;
-    selectedApps?: string[];
-    selectedSystems?: string[];
-    skippedSystems?: Array<{
-        system: string;
-        reason: string;
-    }>;
-    transport?: Record<string, Record<string, string>>;
-    results: Array<{
-        unit: TreeseedHostingUnit;
-        plan: TreeseedHostingUnitPlan;
-        result: TreeseedHostAdapterOperationResult;
-        verification: TreeseedHostingVerification;
-    }>;
-    placements: TreeseedHostingPlacementSummary[];
-    warnings: string[];
-}
 export interface TreeseedHostingPlacementSummary {
     placement: TreeseedServicePlacement;
     label: string;

package/dist/hosting/graph.d.ts

@@ -1,16 +1,10 @@
 import { type TreeseedCanonicalAction, type TreeseedCanonicalDrift, type TreeseedCanonicalGraphNode, type TreeseedCanonicalPostcondition } from '../reconcile/index.js';
 import type { TreeseedRunnableBootstrapSystem } from '../reconcile/bootstrap-systems.js';
-import type { TreeseedHostingApplyResult, TreeseedHostingEnvironment, TreeseedHostingGraph, TreeseedHostingGraphInput, TreeseedHostingPlan, TreeseedHostingPlacementSummary, TreeseedHostingUnit, TreeseedServicePlacement } from './contracts.js';
+import type { TreeseedHostingEnvironment, TreeseedHostingGraph, TreeseedHostingGraphInput, TreeseedHostingPlan, TreeseedHostingPlacementSummary, TreeseedHostingUnit, TreeseedServicePlacement } from './contracts.js';
 export declare function compileTreeseedHostingGraph(input: TreeseedHostingGraphInput): TreeseedHostingGraph;
 export declare function planTreeseedHostingGraph(input: TreeseedHostingGraphInput & {
     planOnly?: boolean;
 }): Promise<TreeseedHostingPlan>;
-/**
- * @deprecated Use reconcileTreeseedTarget with hosting selectors instead.
- */
-export declare function applyTreeseedHostingGraph(input: TreeseedHostingGraphInput & {
-    planOnly?: boolean;
-}): Promise<TreeseedHostingApplyResult>;
 export declare function serializeHostingUnit(unit: TreeseedHostingUnit): {
     id: string;
     label: string;
@@ -113,83 +107,4 @@ export declare function serializeHostingPlan(plan: TreeseedHostingPlan): {
     environment: TreeseedHostingEnvironment;
     planOnly: boolean;
 };
-export declare function serializeHostingApplyResult(result: TreeseedHostingApplyResult): {
-    selectedApps: string[];
-    selectedSystems: string[];
-    skippedSystems: {
-        system: string;
-        reason: string;
-    }[];
-    transport: Record<string, Record<string, string>> | undefined;
-    placements: TreeseedHostingPlacementSummary[];
-    results: {
-        unit: {
-            id: string;
-            label: string;
-            serviceType: string;
-            placement: TreeseedServicePlacement;
-            hostId: string;
-            environment: TreeseedHostingEnvironment;
-            projectGroupId: string | null;
-            requiredCapabilities: import("./contracts.js").TreeseedHostCapability[];
-            secretRefs: string[];
-            variableRefs: string[];
-            application: {
-                id: string;
-                relativeRoot: string;
-                roles: string[];
-            } | null;
-            config: unknown;
-            metadata: unknown;
-        };
-        desired: {
-            id: string;
-            label: string;
-            serviceType: string;
-            placement: TreeseedServicePlacement;
-            hostId: string;
-            environment: TreeseedHostingEnvironment;
-            projectGroupId: string | null;
-            requiredCapabilities: import("./contracts.js").TreeseedHostCapability[];
-            secretRefs: string[];
-            variableRefs: string[];
-            application: {
-                id: string;
-                relativeRoot: string;
-                roles: string[];
-            } | null;
-            config: unknown;
-            metadata: unknown;
-        };
-        observed: import("./contracts.js").TreeseedHostAdapterOperationResult;
-        diff: import("./contracts.js").TreeseedHostingUnitPlan;
-        actions: import("./contracts.js").TreeseedHostingAction[];
-        retainedResources: unknown[];
-        blockedDrift: unknown[];
-        providerLimitations: unknown[];
-        plan: import("./contracts.js").TreeseedHostingUnitPlan;
-        result: import("./contracts.js").TreeseedHostAdapterOperationResult;
-        verification: import("./contracts.js").TreeseedHostingVerification;
-    }[];
-    warnings: string[];
-    desiredGraph: TreeseedCanonicalGraphNode[];
-    observedGraph: TreeseedCanonicalGraphNode[];
-    stateGraph: TreeseedCanonicalGraphNode[];
-    diff: TreeseedCanonicalDrift[];
-    actions: TreeseedCanonicalAction[];
-    postconditions: TreeseedCanonicalPostcondition[];
-    selectedResources: string[];
-    skippedResources: Array<{
-        id: string;
-        reason: string;
-    }>;
-    blockedDrift: TreeseedCanonicalDrift[];
-    providerLimitations: TreeseedCanonicalDrift[];
-    retainedResources: TreeseedCanonicalGraphNode[];
-    destroyedResources: TreeseedCanonicalGraphNode[];
-    liveVerification: import("../reconcile/platform.js").TreeseedCanonicalLiveVerification;
-    ok: boolean;
-    environment: TreeseedHostingEnvironment;
-    planOnly: boolean;
-};
 export declare function hostingEnvironmentLabel(environment: TreeseedHostingEnvironment): string;