@treeseed/sdk 0.10.27 → 0.10.28

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AgentSdk, ScopedAgentSdk } from './sdk.ts';
 export { ContentGraphRuntime } from './graph.ts';
-export { TREESEED_DEFAULT_STARTER_TEMPLATE_ID, projectConnectionModeFromHosting } from './sdk-types.ts';
+export { TREESEED_DEFAULT_STARTER_TEMPLATE_ID, TREESEED_TEMPLATE_ID_ALIASES, normalizeTreeseedTemplateId, projectConnectionModeFromHosting, } from './sdk-types.ts';
 export { createControlPlaneReporter } from './control-plane.ts';
 export { ControlPlaneClient } from './control-plane-client.ts';
 export * from './seeds/index.ts';

package/dist/index.js

@@ -1,6 +1,11 @@
 import { AgentSdk, ScopedAgentSdk } from "./sdk.js";
 import { ContentGraphRuntime } from "./graph.js";
-import { TREESEED_DEFAULT_STARTER_TEMPLATE_ID, projectConnectionModeFromHosting } from "./sdk-types.js";
+import {
+  TREESEED_DEFAULT_STARTER_TEMPLATE_ID,
+  TREESEED_TEMPLATE_ID_ALIASES,
+  normalizeTreeseedTemplateId,
+  projectConnectionModeFromHosting
+} from "./sdk-types.js";
 import { createControlPlaneReporter } from "./control-plane.js";
 import { ControlPlaneClient } from "./control-plane-client.js";
 export * from "./seeds/index.js";
@@ -395,6 +400,7 @@ export {
   TREESEED_MARKET_API_BASE_URL_ENV,
   TREESEED_REMOTE_CONTRACT_HEADER,
   TREESEED_REMOTE_CONTRACT_VERSION,
+  TREESEED_TEMPLATE_ID_ALIASES,
   TRESEED_OPERATION_SPECS,
   TeamScopedR2OverlayContentPublishProvider,
   TeamScopedR2OverlayContentRuntimeProvider,
@@ -528,6 +534,7 @@ export {
   normalizeTaskAdmissionPolicy,
   normalizeTaskPlanProposal,
   normalizeTemplateLaunchRequirements,
+  normalizeTreeseedTemplateId,
   normalizeUtilityPolicy,
   observeTreeseedUnits,
   parseGraphDsl,

package/dist/operations/services/template-registry.js

@@ -1,6 +1,9 @@
 import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { basename, dirname, relative, resolve } from "node:path";
+import {
+  normalizeTreeseedTemplateId
+} from "../../sdk-types.js";
 import { RemoteTemplateCatalogClient } from "../../template-catalog.js";
 import {
   normalizeTemplateLaunchRequirements
@@ -47,15 +50,15 @@ function listTemplateArtifactIds() {
   return [.../* @__PURE__ */ new Set([...packagedIds, ...localStarterIds])].sort((left, right) => left.localeCompare(right, void 0, { sensitivity: "base" }));
 }
 const LOCAL_STARTER_ID_TO_DIRECTORY = {
-  "starter-research": "research",
-  "starter-engineering": "engineering",
-  "starter-information-hub": "information-hub"
+  "research": "research",
+  "engineering": "engineering",
+  "information-hub": "information-hub"
 };
 function localStartersRoot() {
   return resolve(cliPackageRoot, "..", "..", "starters");
 }
 function resolveLocalStarterArtifactRoot(id) {
-  const directory = LOCAL_STARTER_ID_TO_DIRECTORY[id];
+  const directory = LOCAL_STARTER_ID_TO_DIRECTORY[normalizeTreeseedTemplateId(id)];
   if (!directory) {
     return null;
   }
@@ -124,11 +127,13 @@ function validateTemplatePlaceholders(definition) {
   }
 }
 function normalizeTemplateProduct(remoteProduct) {
-  const artifactRoot = resolve(localTemplateArtifactsRoot, remoteProduct.id);
+  const id = normalizeTreeseedTemplateId(remoteProduct.id);
+  const artifactRoot = resolve(localTemplateArtifactsRoot, id);
   const source = remoteProduct.fulfillment.source;
   return {
     ...remoteProduct,
-    contentPath: source.kind === "git" ? `${source.repoUrl}#${remoteProduct.id}` : `r2://${source.bucket ?? "bucket"}/${source.objectKey}#${remoteProduct.id}`,
+    id,
+    contentPath: source.kind === "git" ? `${source.repoUrl}#${id}` : `r2://${source.bucket ?? "bucket"}/${source.objectKey}#${id}`,
     artifactRoot,
     artifactManifestPath: resolve(artifactRoot, "template.config.json"),
     templateRoot: resolve(artifactRoot, "template"),
@@ -364,7 +369,8 @@ async function listTemplateProducts(options = {}) {
   });
 }
 async function resolveTemplateProduct(id, options = {}) {
-  const product = (await listTemplateProducts(options)).find((entry) => entry.id === id);
+  const normalizedId = normalizeTreeseedTemplateId(id);
+  const product = (await listTemplateProducts(options)).find((entry) => entry.id === normalizedId);
   if (!product) {
     throw new Error(`Unable to resolve remote template product "${id}".`);
   }
@@ -524,6 +530,7 @@ async function syncTemplateProject(siteRoot, options = {}) {
   if (!check) {
     writeTemplateState(siteRoot, {
       ...state,
+      templateId: definition.product.id,
       templateVersion: definition.product.templateVersion,
       sourceRef: definition.product.fulfillment.source.ref,
       lastSyncedAt: (/* @__PURE__ */ new Date()).toISOString()

package/dist/scripts/template-catalog.test.js

@@ -36,8 +36,8 @@ function writeCatalogCache(root, endpoint, items) {
 }
 
 const starterTemplate = {
-	id: 'starter-basic',
-	displayName: 'TreeSeed Basic',
+	id: 'fixture-template',
+	displayName: 'Fixture Template',
 	description: 'Starter',
 	summary: 'Starter summary',
 	status: 'live',
@@ -53,7 +53,7 @@ const starterTemplate = {
 	fulfillment: {
 		source: {
 			repoUrl: 'https://example.com/repo.git',
-			directory: 'templates/starter-basic',
+			directory: 'templates/fixture-template',
 			ref: 'main',
 		},
 		hooksPolicy: 'builtin_only',
@@ -69,7 +69,7 @@ test('template registry reads the remote catalog from a configured file endpoint
 
 	const remoteProducts = await listTemplateProducts({ cwd, env: {} });
 	assert.equal(remoteProducts.length, 1);
-	assert.equal(remoteProducts[0]?.id, 'starter-basic');
+	assert.equal(remoteProducts[0]?.id, 'fixture-template');
 
 	writeCatalogCache(cwd, fallbackEndpoint, [starterTemplate]);
 
@@ -83,7 +83,7 @@ test('template registry reads the remote catalog from a configured file endpoint
 	});
 
 	assert.equal(cachedProducts.length, 1);
-	assert.equal(cachedProducts[0]?.id, 'starter-basic');
+	assert.equal(cachedProducts[0]?.id, 'fixture-template');
 	assert.equal(warnings.length, 1);
 	assert.match(warnings[0], /Using cached template catalog/);
 });
@@ -94,7 +94,7 @@ test('template definition resolution rejects templates missing from the remote c
 	const cwd = makeMachineConfigRoot(`file:${fixturePath}`);
 
 	await assert.rejects(
-		() => resolveTemplateDefinition('starter-basic', { cwd, env: {} }),
-		/Unable to resolve remote template product "starter-basic"\./,
+		() => resolveTemplateDefinition('fixture-template', { cwd, env: {} }),
+		/Unable to resolve remote template product "fixture-template"\./,
 	);
 });

package/dist/sdk-types.d.ts

@@ -21,7 +21,9 @@ export declare const PROJECT_DEPLOYMENT_STATUSES: readonly ["pending", "queued",
 export declare const PROJECT_INFRA_RESOURCE_PROVIDERS: readonly ["cloudflare", "railway", "github", "market"];
 export declare const PROJECT_INFRA_RESOURCE_KINDS: readonly ["pages", "worker", "kv", "turnstile-widget", "r2", "d1", "queue", "dlq", "railway_project", "railway_service", "railway_schedule"];
 export declare const AGENT_POOL_STATUSES: readonly ["pending", "active", "degraded", "offline"];
-export declare const TREESEED_DEFAULT_STARTER_TEMPLATE_ID: "starter-research";
+export declare const TREESEED_DEFAULT_STARTER_TEMPLATE_ID: "research";
+export declare const TREESEED_TEMPLATE_ID_ALIASES: {};
+export declare function normalizeTreeseedTemplateId(templateId: string | null | undefined): string;
 export declare const TEMPLATE_HOST_REQUIREMENT_TYPES: readonly ["repository", "web", "email", "ai"];
 export declare const TEMPLATE_RESOURCE_REQUIREMENT_TYPES: readonly ["service", "database", "object-storage", "queue", "dns-zone"];
 export declare const TEMPLATE_SECRET_SENSITIVITIES: readonly ["secret", "plain", "derived"];

package/dist/sdk-types.js

@@ -59,7 +59,12 @@ const PROJECT_INFRA_RESOURCE_KINDS = [
   "railway_schedule"
 ];
 const AGENT_POOL_STATUSES = ["pending", "active", "degraded", "offline"];
-const TREESEED_DEFAULT_STARTER_TEMPLATE_ID = "starter-research";
+const TREESEED_DEFAULT_STARTER_TEMPLATE_ID = "research";
+const TREESEED_TEMPLATE_ID_ALIASES = {};
+function normalizeTreeseedTemplateId(templateId) {
+  const trimmed = String(templateId ?? "").trim();
+  return TREESEED_TEMPLATE_ID_ALIASES[trimmed] ?? trimmed;
+}
 const TEMPLATE_HOST_REQUIREMENT_TYPES = ["repository", "web", "email", "ai"];
 const TEMPLATE_RESOURCE_REQUIREMENT_TYPES = ["service", "database", "object-storage", "queue", "dns-zone"];
 const TEMPLATE_SECRET_SENSITIVITIES = ["secret", "plain", "derived"];
@@ -120,5 +125,7 @@ export {
   TREESEED_DEFAULT_STARTER_TEMPLATE_ID,
   TREESEED_HOSTING_KINDS,
   TREESEED_HOSTING_REGISTRATIONS,
+  TREESEED_TEMPLATE_ID_ALIASES,
+  normalizeTreeseedTemplateId,
   projectConnectionModeFromHosting
 };