@treeseed/sdk 0.6.16 → 0.6.17

package/dist/operations/services/commit-message-provider.js

@@ -1,5 +1,7 @@
 const DEFAULT_COMMIT_AI_MODEL = "@cf/google/gemma-4-26b-a4b-it";
 const allowedTypes = /* @__PURE__ */ new Set(["feat", "fix", "refactor", "test", "docs", "build", "ci", "chore"]);
+const allowedSectionHeadings = /* @__PURE__ */ new Set(["Intent", "Changes", "Integrated package changes", "Dependency and pointer updates"]);
+const forbiddenSectionHeadings = /* @__PURE__ */ new Set(["Why", "Validation"]);
 const danglingSubjectEndings = /* @__PURE__ */ new Set([
   "a",
   "an",
@@ -29,6 +31,7 @@ const danglingSubjectEndings = /* @__PURE__ */ new Set([
 ]);
 const defaultTimeoutMs = 3e4;
 const defaultMaxDiffChars = 12e3;
+const subjectMaxLength = 72;
 function envValue(env, key) {
   const value = env[key];
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
@@ -44,9 +47,31 @@ function stripControlCharacters(value) {
 function normalizeWhitespace(value) {
   return stripControlCharacters(value).replace(/\s+/gu, " ").trim();
 }
+function compactValue(value, maxLength = 120) {
+  const normalized = normalizeWhitespace(String(value ?? ""));
+  if (normalized.length <= maxLength) return normalized;
+  return `${normalized.slice(0, maxLength - 1).trim()}...`;
+}
+function shortSha(value) {
+  const normalized = String(value ?? "").trim();
+  return normalized ? normalized.slice(0, 12) : "unknown";
+}
 function changedPaths(changedFiles) {
   return changedFiles.split(/\r?\n/u).map((line) => line.trim()).filter(Boolean).map((line) => line.replace(/^([MADRCU?!]{1,2})\s+/u, "").trim()).filter(Boolean);
 }
+function changedFileGroups(paths) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const path of paths) {
+    const group = path.startsWith(".github/") || path.includes("/workflows/") ? "ci" : /(^|\/)(test|tests|__tests__)\/|\.test\.|\.spec\./u.test(path) ? "tests" : path.startsWith("docs/") || /\.(md|mdx|txt)$/u.test(path) ? "docs" : path.includes("workflow") || path.includes("repository-save-orchestrator") ? "workflow" : path.includes("package-reference") || path.includes("release") || path.includes("publish") ? "release" : /(^|\/)(package|package-lock)\.json$/u.test(path) || path.includes("build") || path.includes("scripts/") ? "build" : path.includes("config") || path.endsWith(".yaml") || path.endsWith(".yml") ? "config" : path.startsWith("migrations/") || path.includes("/db/") ? "database" : path.startsWith("src/pages/") || path.startsWith("src/layouts/") || path.includes("/ui/") ? "ui" : path.startsWith("src/api/") || path.includes("/api/") ? "api" : "source";
+    counts.set(group, (counts.get(group) ?? 0) + 1);
+  }
+  return [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));
+}
+function formatGroups(paths) {
+  const groups = changedFileGroups(paths);
+  if (groups.length === 0) return "none";
+  return groups.map(([group, count]) => `${group}: ${count}`).join(", ");
+}
 function conventionalParts(message) {
   const value = String(message ?? "").trim();
   const match = value.match(/^([a-z]+)(?:\(([a-z0-9-]+)\))?:\s*(.+)$/iu);
@@ -73,12 +98,9 @@ function inferType(context) {
 function inferScope(context) {
   const conventional = conventionalParts(context.userMessage);
   if (conventional?.scope) return conventional.scope;
-  const counts = /* @__PURE__ */ new Map();
-  for (const path of changedPaths(context.changedFiles)) {
-    const scope = path.startsWith(".github/") ? "ci" : path.includes("workflow") || path.includes("repository-save-orchestrator") ? "workflow" : path.includes("package-reference") || path.includes("publish") || path.includes("release") ? "release" : path.includes("save") ? "save" : path.includes("cli/") || path.startsWith("src/cli") || path.includes("operations-registry") ? "cli" : path.includes("config") || path.endsWith(".yaml") || path.endsWith(".yml") ? "config" : path.includes("test") || path.includes("__tests__") ? "tests" : path.endsWith(".md") || path.endsWith(".mdx") ? "docs" : path.includes("package.json") || path.includes("package-lock.json") || path.includes("build") ? "build" : context.branchMode === "package-dev-save" ? "save" : "workflow";
-    counts.set(scope, (counts.get(scope) ?? 0) + 1);
-  }
-  return [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))[0]?.[0] ?? (context.branchMode === "package-release-main" ? "release" : "save");
+  if ((context.packageChanges?.length ?? 0) > 0 || (context.submodulePointers?.length ?? 0) > 0) return "deps";
+  const groups = changedFileGroups(changedPaths(context.changedFiles));
+  return groups[0]?.[0] ?? (context.branchMode === "package-release-main" ? "release" : "save");
 }
 function summaryFromHint(message) {
   const conventional = conventionalParts(message);
@@ -103,19 +125,19 @@ function repairSummaryEnding(summary, fallback = "record changes") {
 function fallbackSummary(context, type, scope) {
   const hint = summaryFromHint(context.userMessage);
   if (hint) return repairSummaryEnding(hint);
+  if ((context.packageChanges?.length ?? 0) > 0 || (context.submodulePointers?.length ?? 0) > 0) return "sync integrated package updates";
+  if ((context.dependencyUpdates?.length ?? 0) > 0) return "sync package dependency references";
   if (context.branchMode === "package-release-main") return "prepare stable release";
-  if (scope === "cli") return "allow save without message";
-  if (scope === "release" || scope === "ci") return "guard dev tags from publish";
-  if (scope === "workflow" || scope === "save") return "generate save commit messages";
-  if (type === "test") return "cover save workflow behavior";
-  if (type === "docs") return "update workflow guidance";
-  if (type === "build") return "update package build metadata";
-  return "record workflow changes";
+  if (scope === "workflow" || scope === "save") return "update save workflow behavior";
+  if (type === "test") return "cover workflow behavior";
+  if (type === "docs") return "update workflow documentation";
+  if (type === "build") return "update package metadata";
+  return "record repository changes";
 }
 function truncateSubject(type, scope, summary) {
   const prefix = `${type}(${scope}): `;
   const cleanSummary = repairSummaryEnding(summary);
-  const maxSummaryLength = Math.max(10, 50 - prefix.length);
+  const maxSummaryLength = Math.max(10, subjectMaxLength - prefix.length);
   if (cleanSummary.length <= maxSummaryLength) return `${prefix}${cleanSummary}`;
   const sliced = cleanSummary.slice(0, maxSummaryLength).replace(/\s+\S*$/u, "").trim();
   const repaired = repairSummaryEnding(sliced || cleanSummary.slice(0, maxSummaryLength).trim());
@@ -142,46 +164,163 @@ function formatBullet(text) {
   const lines = wrapText(text, 70);
   return lines.map((line, index) => `${index === 0 ? "-" : " "} ${line}`).join("\n");
 }
-function formatCommitMessage(type, scope, summary, bullets) {
+function normalizeSectionBullets(values) {
+  return (values ?? []).map((value) => normalizeWhitespace(value)).filter(Boolean);
+}
+function normalizeSections(sections) {
+  if (Array.isArray(sections)) {
+    return { changes: normalizeSectionBullets(sections) };
+  }
+  return {
+    intent: normalizeSectionBullets(sections.intent),
+    changes: normalizeSectionBullets(sections.changes),
+    packageChanges: normalizeSectionBullets(sections.packageChanges),
+    dependencyUpdates: normalizeSectionBullets(sections.dependencyUpdates)
+  };
+}
+function formatSection(heading, bullets) {
+  if (bullets.length === 0) return null;
+  return [heading, ...bullets.map(formatBullet)].join("\n");
+}
+function formatCommitMessage(type, scope, summary, sections) {
   const normalizedType = allowedTypes.has(type) ? type : "chore";
   const normalizedScope = scope.toLowerCase().replace(/[^a-z0-9-]+/gu, "-").replace(/^-+|-+$/gu, "") || "workflow";
   const subject = truncateSubject(normalizedType, normalizedScope, summary);
-  const body = bullets.map((bullet) => normalizeWhitespace(bullet)).filter(Boolean).slice(0, 3).map(formatBullet).join("\n");
+  const normalizedSections = normalizeSections(sections);
+  const changes = normalizedSections.changes.length > 0 ? normalizedSections.changes : ["Records the staged repository changes supplied to the save workflow."];
+  const body = [
+    formatSection("Intent:", normalizedSections.intent ?? []),
+    formatSection("Changes:", changes),
+    formatSection("Integrated package changes:", normalizedSections.packageChanges ?? []),
+    formatSection("Dependency and pointer updates:", normalizedSections.dependencyUpdates ?? [])
+  ].filter((section) => Boolean(section)).join("\n\n");
   return `${subject}
 
 ${body}`;
 }
+function packageChangeBullet(change) {
+  const details = [
+    `${change.name} ${change.path}: ${shortSha(change.oldSha)} -> ${shortSha(change.newSha)}`,
+    change.tagName || change.version ? `tag ${change.tagName ?? change.version}` : null,
+    change.dependencySpec ? `dependency ${compactValue(change.dependencySpec, 96)}` : null,
+    change.commitSubject ? `child: ${compactValue(change.commitSubject, 96)}` : null
+  ].filter(Boolean);
+  return details.join(", ");
+}
+function dependencyUpdateBullet(update) {
+  const field = update.field ? `${update.field}.` : "";
+  const tag = update.tagName ? `, previous tag ${update.tagName}` : "";
+  return `${field}${update.packageName}: ${compactValue(update.from, 90)} -> ${compactValue(update.to, 90)}${tag}`;
+}
+function pointerUpdateBullet(pointer) {
+  const label = pointer.packageName ? `${pointer.packageName} ${pointer.path}` : pointer.path;
+  return `${label}: ${shortSha(pointer.oldSha)} -> ${shortSha(pointer.newSha)}`;
+}
+function fallbackChanges(context) {
+  const paths = changedPaths(context.changedFiles);
+  const bullets = [];
+  if (paths.length > 0) {
+    bullets.push(`Updates ${paths.length} file${paths.length === 1 ? "" : "s"} across ${formatGroups(paths)}.`);
+    bullets.push(`Touches ${paths.slice(0, 6).join(", ")}${paths.length > 6 ? ", ..." : ""}.`);
+  } else {
+    bullets.push("Records the staged repository changes supplied to the save workflow.");
+  }
+  if (context.plannedTag || context.plannedVersion) {
+    bullets.push(`Plans package version/tag ${context.plannedTag ?? context.plannedVersion} for ${context.repoName}.`);
+  }
+  return bullets;
+}
 function generateFallbackCommitMessage(context) {
   const type = inferType(context);
   const scope = inferScope(context);
   const summary = fallbackSummary(context, type, scope);
-  const bullets = [
-    context.userMessage?.trim() ? `Uses the provided save hint to describe why the ${scope} checkpoint is necessary.` : `Records the current ${scope} changes in the standard save workflow.`,
-    context.branchMode === "package-dev-save" ? "Keeps development package state on Git tags without publishing stable NPM releases." : context.branchMode === "package-release-main" ? "Prepares stable package metadata for the main branch release path." : "Preserves the project branch state for the parent workflow.",
-    "Keeps the message deterministic when AI generation is unavailable."
+  const intent = context.userMessage?.trim() ? [`Save hint: ${summaryFromHint(context.userMessage) ?? normalizeWhitespace(context.userMessage)}`] : [];
+  const dependencyUpdates = [
+    ...(context.dependencyUpdates ?? []).map(dependencyUpdateBullet),
+    ...(context.submodulePointers ?? []).map(pointerUpdateBullet)
   ];
-  return formatCommitMessage(type, scope, summary, bullets);
+  return formatCommitMessage(type, scope, summary, {
+    intent,
+    changes: fallbackChanges(context),
+    packageChanges: (context.packageChanges ?? []).map(packageChangeBullet),
+    dependencyUpdates
+  });
+}
+function sectionKey(heading) {
+  if (heading === "Intent") return "intent";
+  if (heading === "Changes") return "changes";
+  if (heading === "Integrated package changes") return "packageChanges";
+  if (heading === "Dependency and pointer updates") return "dependencyUpdates";
+  return null;
+}
+function parseCommitSections(lines) {
+  const sections = {
+    intent: [],
+    changes: [],
+    packageChanges: [],
+    dependencyUpdates: []
+  };
+  let current = null;
+  let lastBullet = null;
+  for (const rawLine of lines) {
+    const line = rawLine.trimEnd();
+    if (!line.trim()) continue;
+    const headingMatch = line.trim().match(/^([^:]+):$/u);
+    if (headingMatch) {
+      const heading = headingMatch[1].trim();
+      if (forbiddenSectionHeadings.has(heading)) {
+        throw new Error(`AI commit message included forbidden ${heading} section.`);
+      }
+      if (!allowedSectionHeadings.has(heading)) {
+        throw new Error(`AI commit message included unsupported ${heading} section.`);
+      }
+      current = sectionKey(heading);
+      lastBullet = null;
+      continue;
+    }
+    if (!current) {
+      throw new Error("AI commit message included body text before a supported section.");
+    }
+    if (line.trim().startsWith("- ")) {
+      lastBullet = line.trim().replace(/^-\s*/u, "");
+      sections[current].push(lastBullet);
+      continue;
+    }
+    if (/^\s+/u.test(line) && lastBullet != null) {
+      sections[current][sections[current].length - 1] = `${sections[current][sections[current].length - 1]} ${line.trim()}`;
+      continue;
+    }
+    throw new Error("AI commit message section content must use bullets.");
+  }
+  return sections;
 }
-function assertCommitTemplate(message) {
+function assertCommitTemplate(message, context) {
   const normalized = stripControlCharacters(message).replace(/^```(?:text)?\s*/iu, "").replace(/```\s*$/u, "").trim();
   const [subject = "", ...rest] = normalized.split(/\r?\n/u);
-  if (!/^(feat|fix|refactor|test|docs|build|ci|chore)\([a-z0-9-]+\): .+/u.test(subject.trim())) {
+  const subjectMatch = subject.trim().match(/^(feat|fix|refactor|test|docs|build|ci|chore)\(([a-z0-9-]+)\):\s*(.+)$/u);
+  if (!subjectMatch) {
     throw new Error("AI commit message did not use the required subject template.");
   }
-  const summary = subject.replace(/^[a-z]+\([^)]+\):\s*/u, "").trim();
+  const [, type, scope, summary] = subjectMatch;
   if (danglingSubjectEndings.has(lastSummaryWord(summary))) {
     throw new Error("AI commit message subject appears truncated.");
   }
-  const bullets = rest.map((line) => line.trim()).filter((line) => line.startsWith("- "));
-  if (bullets.length === 0) {
-    throw new Error("AI commit message did not include body bullets.");
+  const sections = parseCommitSections(rest);
+  if (sections.changes.length === 0) {
+    throw new Error("AI commit message did not include a Changes section.");
   }
-  return formatCommitMessage(
-    subject.split("(")[0],
-    subject.match(/\(([^)]+)\)/u)?.[1] ?? "workflow",
-    subject.replace(/^[a-z]+\([^)]+\):\s*/u, ""),
-    bullets.map((line) => line.replace(/^-\s*/u, ""))
-  );
+  if (sections.intent.length > 0 && !context.userMessage?.trim()) {
+    throw new Error("AI commit message included Intent without a save hint.");
+  }
+  if (context.userMessage?.trim() && sections.intent.length === 0) {
+    throw new Error("AI commit message omitted Intent for the provided save hint.");
+  }
+  return formatCommitMessage(type, scope, summary, {
+    intent: sections.intent,
+    changes: sections.changes,
+    packageChanges: sections.packageChanges,
+    dependencyUpdates: sections.dependencyUpdates
+  });
 }
 function cloudflareEndpoint(accountId, model, gatewayId) {
   const normalizedModel = model.replace(/^\/+/u, "");
@@ -190,33 +329,71 @@ function cloudflareEndpoint(accountId, model, gatewayId) {
   }
   return `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(accountId)}/ai/run/${normalizedModel}`;
 }
+function contextLines(context) {
+  const paths = changedPaths(context.changedFiles);
+  const dependencyUpdates = [
+    ...(context.dependencyUpdates ?? []).map(dependencyUpdateBullet),
+    ...(context.submodulePointers ?? []).map(pointerUpdateBullet)
+  ];
+  return [
+    "Repository context:",
+    `Repo: ${context.repoName}`,
+    `Path: ${context.repoPath}`,
+    `Branch: ${context.branch}`,
+    `Mode: ${context.branchMode}`,
+    `Kind: ${context.kind}`,
+    context.userMessage ? `User hint: ${context.userMessage}` : "User hint: none",
+    context.plannedVersion ? `Planned version: ${context.plannedVersion}` : null,
+    context.plannedTag ? `Planned tag: ${context.plannedTag}` : null,
+    "",
+    "Changed file groups:",
+    formatGroups(paths),
+    "",
+    "Changed files:",
+    paths.length > 0 ? paths.join("\n") : "(none)",
+    "",
+    "Integrated package changes:",
+    (context.packageChanges ?? []).length > 0 ? (context.packageChanges ?? []).map(packageChangeBullet).join("\n") : "(none)",
+    "",
+    "Dependency and pointer updates:",
+    dependencyUpdates.length > 0 ? dependencyUpdates.join("\n") : "(none)"
+  ].filter((line) => line !== null);
+}
 function cloudflarePrompt(context, maxDiffChars) {
   return {
     system: [
-      "Generate exactly one Git commit message.",
-      "Use this template:",
-      "type(scope): short imperative summary",
+      "You are an accurate repository historian generating one Git commit message.",
+      "You have no tool access. You cannot inspect files, history, tests, or prompts.",
+      "Use only the repository facts supplied in the user message.",
+      "Do not infer motivation, goals, test results, or validation results.",
+      "Do not include a Why section or a Validation section.",
       "",
-      "- Explain why this change is necessary.",
-      "- Mention any side effects or constraints.",
-      "- Use 72 character wrap.",
+      "Required output shape:",
+      "type(scope): imperative summary",
+      "",
+      "Intent:",
+      '- Include this section only when User hint is not "none". Summarize the hint without inventing motivation.',
+      "",
+      "Changes:",
+      "- Describe concrete code, schema, config, docs, and test changes from the supplied facts.",
+      "",
+      "Integrated package changes:",
+      "- Include this section only when package changes are supplied.",
+      "",
+      "Dependency and pointer updates:",
+      "- Include this section only when dependency or submodule pointer updates are supplied.",
       "",
       "Use only these types: feat, fix, refactor, test, docs, build, ci, chore.",
       "Infer scope from the changed area, not from the repository name.",
-      "Do not include repository name or package version in save messages.",
+      "Keep the subject concise; body lines should wrap at 72 characters.",
       "Return only the commit message."
     ].join("\n"),
     user: [
-      `Branch: ${context.branch}`,
-      `Mode: ${context.branchMode}`,
-      `Kind: ${context.kind}`,
-      context.userMessage ? `User hint: ${context.userMessage}` : "User hint: none",
-      context.plannedTag ? `Planned tag: ${context.plannedTag}` : null,
-      "Changed files:",
-      context.changedFiles || "(none)",
-      "Diff:",
+      ...contextLines(context),
+      "",
+      "Diff (truncated; structured context above is complete):",
       context.diff.slice(0, maxDiffChars) || "(none)"
-    ].filter((line) => line !== null).join("\n")
+    ].join("\n")
   };
 }
 function extractCloudflareText(payload) {
@@ -268,7 +445,7 @@ async function generateCloudflareCommitMessage(context, env, fetchImpl) {
     if (!text) {
       throw new Error("Cloudflare commit AI returned an empty response.");
     }
-    return assertCommitTemplate(text);
+    return assertCommitTemplate(text, context);
   } finally {
     clearTimeout(timeout);
   }
@@ -283,7 +460,7 @@ async function generateRepositoryCommitMessage(context, options = {}) {
   if (mode === "generated" && options.provider) {
     try {
       return {
-        message: assertCommitTemplate(await Promise.resolve(options.provider.generate(context))),
+        message: assertCommitTemplate(await Promise.resolve(options.provider.generate(context)), context),
         provider: "cloudflare-workers-ai",
         fallbackUsed: false,
         error: null

package/dist/operations/services/config-runtime.js

@@ -191,7 +191,6 @@ function writeDeploySummary(write, summary) {
   write(`  Account ID: ${summary.accountId}`);
   write(`  D1: ${summary.siteDataDb.databaseName} (${summary.siteDataDb.databaseId})`);
   write(`  KV FORM_GUARD_KV: ${summary.formGuardKv.id}`);
-  write(`  KV SESSION: ${summary.sessionKv.id}`);
 }
 function syncManagedServiceSettingsFromDeployConfig(tenantRoot) {
   const config = loadTreeseedMachineConfig(tenantRoot);

package/dist/operations/services/deploy.d.ts

@@ -165,6 +165,9 @@ export declare function ensureGeneratedWranglerConfig(tenantRoot: any, options?:
                 rootDir: string | undefined;
                 publicBaseUrl: string | undefined;
                 localBaseUrl: string | undefined;
+                local: {
+                    runtime: string | undefined;
+                } | undefined;
                 environments: {
                     local: {
                         baseUrl: string | undefined;
@@ -216,6 +219,9 @@ export declare function ensureGeneratedWranglerConfig(tenantRoot: any, options?:
                 provider: string | undefined;
                 rootDir: string | undefined;
                 publicBaseUrl: string | undefined;
+                local: {
+                    runtime: string | undefined;
+                } | undefined;
                 cloudflare: {
                     workerName: string | undefined;
                 };
@@ -296,7 +302,6 @@ export declare function buildProvisioningSummary(deployConfig: any, state: any,
         dlq: any;
         database: any;
         formGuardKv: any;
-        sessionKv: any;
         railwayProject: any;
         webDomain: any;
         apiDomain: any;
@@ -526,6 +531,9 @@ export declare function validateDeployPrerequisites(tenantRoot: any, { requireRe
             rootDir: string | undefined;
             publicBaseUrl: string | undefined;
             localBaseUrl: string | undefined;
+            local: {
+                runtime: string | undefined;
+            } | undefined;
             environments: {
                 local: {
                     baseUrl: string | undefined;
@@ -577,6 +585,9 @@ export declare function validateDeployPrerequisites(tenantRoot: any, { requireRe
             provider: string | undefined;
             rootDir: string | undefined;
             publicBaseUrl: string | undefined;
+            local: {
+                runtime: string | undefined;
+            } | undefined;
             cloudflare: {
                 workerName: string | undefined;
             };
@@ -699,6 +710,9 @@ export declare function validateDestroyPrerequisites(tenantRoot: any, { requireR
             rootDir: string | undefined;
             publicBaseUrl: string | undefined;
             localBaseUrl: string | undefined;
+            local: {
+                runtime: string | undefined;
+            } | undefined;
             environments: {
                 local: {
                     baseUrl: string | undefined;
@@ -750,6 +764,9 @@ export declare function validateDestroyPrerequisites(tenantRoot: any, { requireR
             provider: string | undefined;
             rootDir: string | undefined;
             publicBaseUrl: string | undefined;
+            local: {
+                runtime: string | undefined;
+            } | undefined;
             cloudflare: {
                 workerName: string | undefined;
             };
@@ -816,7 +833,6 @@ export declare function destroyCloudflareResources(tenantRoot: any, options?: {}
             dlq: any;
             database: any;
             formGuardKv: any;
-            sessionKv: any;
             railwayProject: any;
             webDomain: any;
             apiDomain: any;
@@ -876,7 +892,7 @@ export declare function destroyCloudflareResources(tenantRoot: any, options?: {}
             status: string;
             id: any;
             preview: boolean;
-        };
+        } | null;
         sessionPreview: {
             status: string;
             id: any;
@@ -912,7 +928,6 @@ export declare function provisionCloudflareResources(tenantRoot: any, options?:
         dlq: any;
         database: any;
         formGuardKv: any;
-        sessionKv: any;
         railwayProject: any;
         webDomain: any;
         apiDomain: any;
@@ -948,7 +963,6 @@ export declare function verifyProvisionedCloudflareResources(tenantRoot: any, op
     checks: {
         pages: boolean;
         formGuardKv: boolean;
-        sessionKv: boolean;
         d1: boolean;
         queue: boolean;
         dlq: boolean;