@treeseed/sdk 0.10.26 → 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/mailpit-runtime.js

@@ -1,5 +1,4 @@
 import { spawnSync } from "node:child_process";
-const EXPECTED_PORTS = ["1025->1025/tcp", "8025->8025/tcp"];
 const KNOWN_MAILPIT_NAMES = ["treeseed_mailpit", "docs_mailpit"];
 function runDocker(args, options = {}) {
   return spawnSync("docker", args, {
@@ -14,9 +13,13 @@ function parseDockerPsOutput(stdout) {
   });
 }
 function isCompatibleMailpitContainer(container) {
-  const nameMatch = KNOWN_MAILPIT_NAMES.includes(container.name);
+  const expectedName = process.env.TREESEED_MAILPIT_CONTAINER_NAME?.trim();
+  const smtpPort = process.env.TREESEED_MAILPIT_SMTP_PORT?.trim() || "1025";
+  const uiPort = process.env.TREESEED_MAILPIT_UI_PORT?.trim() || "8025";
+  const expectedPorts = [`${smtpPort}->1025/tcp`, `${uiPort}->8025/tcp`];
+  const nameMatch = expectedName ? container.name === expectedName : KNOWN_MAILPIT_NAMES.includes(container.name);
   const imageMatch = container.image.includes("mailpit");
-  const portsMatch = EXPECTED_PORTS.every((port) => container.ports.includes(port));
+  const portsMatch = expectedPorts.every((port) => container.ports.includes(port));
   return (nameMatch || imageMatch) && portsMatch;
 }
 function dockerIsAvailable() {
@@ -50,7 +53,7 @@ function stopKnownMailpitContainers(options = {}) {
 function streamKnownMailpitLogs() {
   const container = findRunningMailpitContainer();
   if (!container) {
-    console.error("No running Mailpit container was found on ports 1025 and 8025.");
+    console.error("No running Mailpit container was found for the configured local ports.");
     process.exit(1);
   }
   const result = runDocker(["logs", "-f", container.name], { stdio: "inherit" });

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/ensure-mailpit.js

@@ -1,16 +1,35 @@
 import { spawnSync } from 'node:child_process';
 import { dockerIsAvailable, findRunningMailpitContainer } from '../operations/services/mailpit-runtime.js';
-import { mailpitComposeFile, packageRoot } from '../operations/services/runtime-paths.js';
+import { packageRoot } from '../operations/services/runtime-paths.js';
+function mailpitConfig() {
+    return {
+        containerName: process.env.TREESEED_MAILPIT_CONTAINER_NAME?.trim() || 'treeseed_mailpit',
+        smtpPort: process.env.TREESEED_MAILPIT_SMTP_PORT?.trim() || '1025',
+        uiPort: process.env.TREESEED_MAILPIT_UI_PORT?.trim() || '8025',
+    };
+}
 if (!dockerIsAvailable()) {
     console.error('Docker is required for Treeseed form email testing. Start Docker and rerun the Mailpit command.');
     process.exit(1);
 }
 const existingMailpit = findRunningMailpitContainer();
+const config = mailpitConfig();
 if (existingMailpit) {
-    console.log(`Reusing existing Mailpit container "${existingMailpit.name}" on ports 1025 and 8025.`);
+    console.log(`Reusing existing Mailpit container "${existingMailpit.name}" on ports ${config.smtpPort} and ${config.uiPort}.`);
     process.exit(0);
 }
-const result = spawnSync('docker', ['compose', '-f', mailpitComposeFile, 'up', '-d', 'mailpit'], {
+spawnSync('docker', ['rm', '-f', config.containerName], { encoding: 'utf8', cwd: packageRoot, env: { ...process.env } });
+const result = spawnSync('docker', [
+    'run',
+    '-d',
+    '--name',
+    config.containerName,
+    '-p',
+    `127.0.0.1:${config.smtpPort}:1025`,
+    '-p',
+    `127.0.0.1:${config.uiPort}:8025`,
+    'axllent/mailpit:latest',
+], {
     encoding: 'utf8',
     cwd: packageRoot,
     env: { ...process.env },
@@ -18,7 +37,7 @@ const result = spawnSync('docker', ['compose', '-f', mailpitComposeFile, 'up', '
 if (result.status !== 0) {
     const reusedMailpit = findRunningMailpitContainer();
     if (reusedMailpit) {
-        console.log(`Reusing existing Mailpit container "${reusedMailpit.name}" on ports 1025 and 8025.`);
+        console.log(`Reusing existing Mailpit container "${reusedMailpit.name}" on ports ${config.smtpPort} and ${config.uiPort}.`);
         process.exit(0);
     }
     if (result.stdout)

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
 };