@treeseed/sdk 0.4.13 → 0.5.1

package/dist/operations/services/knowledge-coop-packaging.d.ts

@@ -0,0 +1,59 @@
+export interface KnowledgeCoopPackageManifest {
+    schemaVersion: 1;
+    kind: 'template' | 'knowledge_pack';
+    id: string;
+    title: string;
+    summary: string | null;
+    version: string;
+    generatedAt: string;
+    projectSlug: string;
+    sourceProjectRoot: string;
+    payloadRoot: string;
+    files: string[];
+    compatibility: {
+        minCliVersion: string;
+        minCoreVersion: string;
+        minSdkVersion: string;
+    };
+    sourceSelection: {
+        includedPaths: string[];
+    };
+    market: {
+        publisherId: string | null;
+        publisherName: string | null;
+        publishMetadata: Record<string, unknown>;
+    };
+}
+export interface KnowledgeCoopPackageBuildResult {
+    outputRoot: string;
+    payloadRoot: string;
+    manifestPath: string;
+    files: string[];
+    manifest: KnowledgeCoopPackageManifest;
+}
+export interface KnowledgeCoopKnowledgePackImportResult {
+    manifest: KnowledgeCoopPackageManifest;
+    manifestPath: string;
+    payloadRoot: string;
+    importedPaths: string[];
+}
+export declare function resolveKnowledgeCoopPackageOutputRoot(projectRoot: string, kind: 'template' | 'knowledge_pack', slug: string): string;
+export declare function buildKnowledgeCoopTemplatePackage(projectRoot: string, input?: {
+    id?: string;
+    title?: string;
+    summary?: string | null;
+    outputRoot?: string | null;
+    projectSlug?: string | null;
+    market?: KnowledgeCoopPackageManifest['market'];
+}): KnowledgeCoopPackageBuildResult;
+export declare function buildKnowledgeCoopKnowledgePackPackage(projectRoot: string, input?: {
+    id?: string;
+    title?: string;
+    summary?: string | null;
+    outputRoot?: string | null;
+    projectSlug?: string | null;
+    includePaths?: string[];
+    market?: KnowledgeCoopPackageManifest['market'];
+}): KnowledgeCoopPackageBuildResult;
+export declare function importKnowledgeCoopKnowledgePack(targetRoot: string, sourcePath: string): KnowledgeCoopKnowledgePackImportResult;
+export declare function relativePackageFiles(outputRoot: string): string[];

package/dist/operations/services/knowledge-coop-packaging.js

@@ -0,0 +1,234 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, resolve, relative } from "node:path";
+import { cliPackageVersion, corePackageVersion, sdkPackageVersion } from "./runtime-paths.js";
+const TEMPLATE_IGNORES = [
+  ".git",
+  ".github",
+  ".astro",
+  ".wrangler",
+  "node_modules",
+  "dist",
+  ".treeseed/state",
+  ".treeseed/generated"
+];
+const KNOWLEDGE_PACK_DEFAULT_PATHS = [
+  "src/content/objectives",
+  "src/content/questions",
+  "src/content/notes",
+  "src/content/proposals",
+  "src/content/decisions",
+  "src/content/knowledge",
+  "src/content/pages"
+];
+function nowStamp(date = /* @__PURE__ */ new Date()) {
+  const year = date.getUTCFullYear();
+  const month = `${date.getUTCMonth() + 1}`.padStart(2, "0");
+  const day = `${date.getUTCDate()}`.padStart(2, "0");
+  const hour = `${date.getUTCHours()}`.padStart(2, "0");
+  const minute = `${date.getUTCMinutes()}`.padStart(2, "0");
+  const second = `${date.getUTCSeconds()}`.padStart(2, "0");
+  return `${year}${month}${day}${hour}${minute}${second}`;
+}
+function slugify(value, fallback = "package") {
+  return String(value ?? "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || fallback;
+}
+function ensureDir(path) {
+  mkdirSync(path, { recursive: true });
+}
+function shouldIgnore(relativePath, ignorePatterns) {
+  return ignorePatterns.some((pattern) => relativePath === pattern || relativePath.startsWith(`${pattern}/`));
+}
+function listFiles(root, relativeRoot = "", ignorePatterns = []) {
+  if (!existsSync(root)) {
+    return [];
+  }
+  const entries = readdirSync(root, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const nextRelative = relativeRoot ? `${relativeRoot}/${entry.name}` : entry.name;
+    if (shouldIgnore(nextRelative, ignorePatterns)) {
+      continue;
+    }
+    const nextAbsolute = resolve(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFiles(nextAbsolute, nextRelative, ignorePatterns));
+      continue;
+    }
+    files.push(nextRelative);
+  }
+  return files.sort((left, right) => left.localeCompare(right));
+}
+function writeManifest(outputRoot, manifest) {
+  const manifestPath = resolve(outputRoot, "manifest.json");
+  writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`, "utf8");
+  return manifestPath;
+}
+function normalizeVersion(value, fallback = "0.1.0") {
+  return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function loadProjectPackageVersion(projectRoot) {
+  try {
+    const packageJson = JSON.parse(readFileSync(resolve(projectRoot, "package.json"), "utf8"));
+    return normalizeVersion(packageJson.version, "0.1.0");
+  } catch {
+    return "0.1.0";
+  }
+}
+function copySelectedPaths(projectRoot, payloadRoot, relativePaths, ignorePatterns = []) {
+  const copied = [];
+  for (const relativePath of relativePaths) {
+    const sourcePath = resolve(projectRoot, relativePath);
+    if (!existsSync(sourcePath)) {
+      continue;
+    }
+    const targetPath = resolve(payloadRoot, relativePath);
+    const stats = statSync(sourcePath);
+    if (stats.isDirectory()) {
+      for (const file of listFiles(sourcePath, relativePath, ignorePatterns)) {
+        const absoluteSource = resolve(projectRoot, file);
+        const absoluteTarget = resolve(payloadRoot, file);
+        ensureDir(dirname(absoluteTarget));
+        cpSync(absoluteSource, absoluteTarget, { force: true });
+        copied.push(file);
+      }
+      continue;
+    }
+    ensureDir(dirname(targetPath));
+    cpSync(sourcePath, targetPath, { force: true });
+    copied.push(relativePath);
+  }
+  return copied.sort((left, right) => left.localeCompare(right));
+}
+function defaultTemplatePaths(projectRoot) {
+  const preferred = [
+    "package.json",
+    "astro.config.ts",
+    "tsconfig.json",
+    "treeseed.site.yaml",
+    "src",
+    "public"
+  ];
+  return preferred.filter((relativePath) => existsSync(resolve(projectRoot, relativePath)));
+}
+function buildManifest(projectRoot, input) {
+  return {
+    schemaVersion: 1,
+    kind: input.kind,
+    id: input.id,
+    title: input.title,
+    summary: input.summary ?? null,
+    version: loadProjectPackageVersion(projectRoot),
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    projectSlug: input.projectSlug,
+    sourceProjectRoot: projectRoot,
+    payloadRoot: "payload",
+    files: [...input.files],
+    compatibility: {
+      minCliVersion: normalizeVersion(cliPackageVersion),
+      minCoreVersion: normalizeVersion(corePackageVersion),
+      minSdkVersion: normalizeVersion(sdkPackageVersion)
+    },
+    sourceSelection: {
+      includedPaths: [...input.sourceSelection]
+    },
+    market: input.market ?? {
+      publisherId: null,
+      publisherName: null,
+      publishMetadata: {}
+    }
+  };
+}
+function resolveKnowledgeCoopPackageOutputRoot(projectRoot, kind, slug) {
+  return resolve(projectRoot, ".treeseed", "packages", kind, `${slug}-${nowStamp()}`);
+}
+function buildKnowledgeCoopTemplatePackage(projectRoot, input = {}) {
+  const projectSlug = slugify(input.projectSlug ?? basename(projectRoot), "project");
+  const packageId = slugify(input.id ?? `${projectSlug}-template`, "template");
+  const outputRoot = resolve(input.outputRoot ?? resolveKnowledgeCoopPackageOutputRoot(projectRoot, "template", packageId));
+  const payloadRoot = resolve(outputRoot, "payload");
+  ensureDir(payloadRoot);
+  const files = copySelectedPaths(projectRoot, payloadRoot, defaultTemplatePaths(projectRoot), TEMPLATE_IGNORES);
+  const manifest = buildManifest(projectRoot, {
+    kind: "template",
+    id: packageId,
+    title: input.title ?? `${projectSlug} template`,
+    summary: input.summary ?? null,
+    projectSlug,
+    files,
+    sourceSelection: defaultTemplatePaths(projectRoot),
+    market: input.market
+  });
+  const manifestPath = writeManifest(outputRoot, manifest);
+  return {
+    outputRoot,
+    payloadRoot,
+    manifestPath,
+    files,
+    manifest
+  };
+}
+function buildKnowledgeCoopKnowledgePackPackage(projectRoot, input = {}) {
+  const projectSlug = slugify(input.projectSlug ?? basename(projectRoot), "project");
+  const packageId = slugify(input.id ?? `${projectSlug}-knowledge-pack`, "knowledge-pack");
+  const outputRoot = resolve(input.outputRoot ?? resolveKnowledgeCoopPackageOutputRoot(projectRoot, "knowledge_pack", packageId));
+  const payloadRoot = resolve(outputRoot, "payload");
+  ensureDir(payloadRoot);
+  const includePaths = (input.includePaths ?? KNOWLEDGE_PACK_DEFAULT_PATHS).filter((relativePath) => existsSync(resolve(projectRoot, relativePath)));
+  const files = copySelectedPaths(projectRoot, payloadRoot, includePaths);
+  const manifest = buildManifest(projectRoot, {
+    kind: "knowledge_pack",
+    id: packageId,
+    title: input.title ?? `${projectSlug} knowledge pack`,
+    summary: input.summary ?? null,
+    projectSlug,
+    files,
+    sourceSelection: includePaths,
+    market: input.market
+  });
+  const manifestPath = writeManifest(outputRoot, manifest);
+  return {
+    outputRoot,
+    payloadRoot,
+    manifestPath,
+    files,
+    manifest
+  };
+}
+function importKnowledgeCoopKnowledgePack(targetRoot, sourcePath) {
+  const resolvedSource = resolve(sourcePath);
+  const manifestPath = statSync(resolvedSource).isDirectory() ? resolve(resolvedSource, "manifest.json") : resolvedSource;
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  const sourceRoot = dirname(manifestPath);
+  const payloadRoot = resolve(sourceRoot, manifest.payloadRoot || "payload");
+  if (!existsSync(payloadRoot)) {
+    throw new Error(`Knowledge pack payload directory is missing: ${payloadRoot}`);
+  }
+  const importedPaths = [];
+  for (const file of manifest.files) {
+    const sourceFile = resolve(payloadRoot, file);
+    if (!existsSync(sourceFile)) {
+      continue;
+    }
+    const targetFile = resolve(targetRoot, file);
+    ensureDir(dirname(targetFile));
+    cpSync(sourceFile, targetFile, { recursive: true, force: true });
+    importedPaths.push(file);
+  }
+  return {
+    manifest,
+    manifestPath,
+    payloadRoot,
+    importedPaths: importedPaths.sort((left, right) => left.localeCompare(right))
+  };
+}
+function relativePackageFiles(outputRoot) {
+  return listFiles(outputRoot).map((entry) => relative(outputRoot, resolve(outputRoot, entry)) || basename(entry));
+}
+export {
+  buildKnowledgeCoopKnowledgePackPackage,
+  buildKnowledgeCoopTemplatePackage,
+  importKnowledgeCoopKnowledgePack,
+  relativePackageFiles,
+  resolveKnowledgeCoopPackageOutputRoot
+};

package/dist/operations/services/local-dev.d.ts

@@ -1,7 +1,6 @@
 export declare function runStep(command: any, args: any, options?: {}): void;
 export declare function runNodeScript(scriptRelativePath: any, args?: never[], options?: {}): void;
 export declare function spawnProcess(command: any, args: any, options?: {}): import("child_process").ChildProcessWithoutNullStreams;
-export declare function syncDevVars(overrides?: {}): void;
 export declare function runLocalD1Migration(persistTo: any): void;
 export declare function prepareCloudflareLocalRuntime({ envOverrides, persistTo, outDir }?: {
     envOverrides?: {} | undefined;

package/dist/operations/services/local-dev.js

@@ -36,14 +36,6 @@ function spawnProcess(command, args, options = {}) {
     detached: options.detached ?? false
   });
 }
-function syncDevVars(overrides = {}) {
-  const overrideEntries = Object.entries(overrides);
-  runNodeScript(
-    "./scripts/sync-dev-vars.js",
-    overrideEntries.map(([key, value]) => `${key}=${value}`),
-    { cwd: fixtureRoot }
-  );
-}
 function runLocalD1Migration(persistTo) {
   applyLocalD1Migrations({
     cwd: fixtureRoot,
@@ -61,10 +53,6 @@ function prepareCloudflareLocalRuntime({ envOverrides = {}, persistTo, outDir }
   runNodeScript("./scripts/patch-starlight-content-path.js");
   runNodeScript("./scripts/aggregate-book.js");
   runNodeScript("./scripts/ensure-mailpit.js");
-  syncDevVars({
-    TREESEED_LOCAL_DEV_MODE: "cloudflare",
-    ...mergedEnvOverrides
-  });
   runLocalD1Migration(persistTo);
   const astroArgs = ["astro", "build", "--root", fixtureRoot];
   if (outDir) {
@@ -101,6 +89,5 @@ export {
   runNodeScript,
   runStep,
   spawnProcess,
-  startWranglerDev,
-  syncDevVars
+  startWranglerDev
 };

package/dist/operations/services/project-platform.d.ts

@@ -26,6 +26,26 @@ export declare function provisionProjectPlatform(options: ProjectPlatformActionO
         siteDataDb: any;
         queue: any;
         content: any;
+        webCache: {
+            webHost: any;
+            contentHost: any;
+            rulesManaged: boolean;
+            lastSyncedAt: any;
+            lastError: any;
+            policy: {
+                sourcePages: {
+                    paths: string[];
+                    browserTtlSeconds: number;
+                    edgeTtlSeconds: number;
+                    staleWhileRevalidateSeconds: number;
+                    staleIfErrorSeconds: number;
+                };
+                contentPages: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+                r2PublishedObjects: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+            };
+            deployPurge: any;
+            contentPurge: any;
+        };
     };
     verification: {
         ok: boolean;
@@ -38,6 +58,7 @@ export declare function provisionProjectPlatform(options: ProjectPlatformActionO
             queue: boolean;
             dlq: boolean;
             r2: boolean;
+            webCache: boolean;
         };
         state: any;
     };
@@ -59,23 +80,6 @@ export declare function provisionProjectPlatform(options: ProjectPlatformActionO
             logicalName: string;
         }[];
         verification: {
-            ok: boolean;
-            checks: {
-                id: any;
-                ok: boolean;
-                service: string;
-                projectId: string | null;
-                projectName: string | null;
-                serviceId: string | null;
-                serviceName: string | null;
-                environment: string;
-                environmentId: string | null;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-            }[];
-        } | {
             ok: boolean;
             checks: {
                 id: any;
@@ -136,43 +140,6 @@ export declare function deployProjectPlatform(options: ProjectPlatformActionOpti
                 skipped: boolean;
                 reason: string;
             };
-            runner: {
-                ok: boolean;
-                skipped: boolean;
-                reason: string;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-                error?: undefined;
-            } | {
-                ok: any;
-                status: number;
-                payload: any;
-                heartbeatPresent: any;
-                attempt: number;
-                skipped?: undefined;
-                reason?: undefined;
-                error?: undefined;
-            } | {
-                ok: boolean;
-                reason: string;
-                skipped?: undefined;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-                error?: undefined;
-            } | {
-                ok: boolean;
-                error: string;
-                skipped?: undefined;
-                reason?: undefined;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-            };
             pages: {
                 ok: boolean;
                 status: number;
@@ -307,43 +274,6 @@ export declare function monitorProjectPlatform(options: ProjectPlatformActionOpt
             skipped: boolean;
             reason: string;
         };
-        runner: {
-            ok: boolean;
-            skipped: boolean;
-            reason: string;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-            error?: undefined;
-        } | {
-            ok: any;
-            status: number;
-            payload: any;
-            heartbeatPresent: any;
-            attempt: number;
-            skipped?: undefined;
-            reason?: undefined;
-            error?: undefined;
-        } | {
-            ok: boolean;
-            reason: string;
-            skipped?: undefined;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-            error?: undefined;
-        } | {
-            ok: boolean;
-            error: string;
-            skipped?: undefined;
-            reason?: undefined;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-        };
         pages: {
             ok: boolean;
             status: number;
@@ -447,6 +377,26 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
         siteDataDb: any;
         queue: any;
         content: any;
+        webCache: {
+            webHost: any;
+            contentHost: any;
+            rulesManaged: boolean;
+            lastSyncedAt: any;
+            lastError: any;
+            policy: {
+                sourcePages: {
+                    paths: string[];
+                    browserTtlSeconds: number;
+                    edgeTtlSeconds: number;
+                    staleWhileRevalidateSeconds: number;
+                    staleIfErrorSeconds: number;
+                };
+                contentPages: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+                r2PublishedObjects: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+            };
+            deployPurge: any;
+            contentPurge: any;
+        };
     };
     verification: {
         ok: boolean;
@@ -459,6 +409,7 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
             queue: boolean;
             dlq: boolean;
             r2: boolean;
+            webCache: boolean;
         };
         state: any;
     };
@@ -480,23 +431,6 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
             logicalName: string;
         }[];
         verification: {
-            ok: boolean;
-            checks: {
-                id: any;
-                ok: boolean;
-                service: string;
-                projectId: string | null;
-                projectName: string | null;
-                serviceId: string | null;
-                serviceName: string | null;
-                environment: string;
-                environmentId: string | null;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-            }[];
-        } | {
             ok: boolean;
             checks: {
                 id: any;
@@ -553,43 +487,6 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
             skipped: boolean;
             reason: string;
         };
-        runner: {
-            ok: boolean;
-            skipped: boolean;
-            reason: string;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-            error?: undefined;
-        } | {
-            ok: any;
-            status: number;
-            payload: any;
-            heartbeatPresent: any;
-            attempt: number;
-            skipped?: undefined;
-            reason?: undefined;
-            error?: undefined;
-        } | {
-            ok: boolean;
-            reason: string;
-            skipped?: undefined;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-            error?: undefined;
-        } | {
-            ok: boolean;
-            error: string;
-            skipped?: undefined;
-            reason?: undefined;
-            status?: undefined;
-            payload?: undefined;
-            heartbeatPresent?: undefined;
-            attempt?: undefined;
-        };
         pages: {
             ok: boolean;
             status: number;
@@ -709,43 +606,6 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
                 skipped: boolean;
                 reason: string;
             };
-            runner: {
-                ok: boolean;
-                skipped: boolean;
-                reason: string;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-                error?: undefined;
-            } | {
-                ok: any;
-                status: number;
-                payload: any;
-                heartbeatPresent: any;
-                attempt: number;
-                skipped?: undefined;
-                reason?: undefined;
-                error?: undefined;
-            } | {
-                ok: boolean;
-                reason: string;
-                skipped?: undefined;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-                error?: undefined;
-            } | {
-                ok: boolean;
-                error: string;
-                skipped?: undefined;
-                reason?: undefined;
-                status?: undefined;
-                payload?: undefined;
-                heartbeatPresent?: undefined;
-                attempt?: undefined;
-            };
             pages: {
                 ok: boolean;
                 status: number;