@treeseed/sdk 0.4.9 → 0.4.10

package/dist/stores/operational-store.js

@@ -88,6 +88,78 @@ function reportFromRow(row) {
     createdAt: String(row.created_at ?? row.createdAt ?? nowIso())
   };
 }
+function parseJsonValue(value, fallback) {
+  if (typeof value !== "string" || !value.trim()) {
+    return fallback;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function normalizeAutoscale(value, fallback) {
+  return {
+    minWorkers: Number(value?.minWorkers ?? fallback?.minWorkers ?? 0),
+    maxWorkers: Number(value?.maxWorkers ?? fallback?.maxWorkers ?? 1),
+    targetQueueDepth: Number(value?.targetQueueDepth ?? fallback?.targetQueueDepth ?? 1),
+    cooldownSeconds: Number(value?.cooldownSeconds ?? fallback?.cooldownSeconds ?? 60)
+  };
+}
+function workPolicyFromRow(row) {
+  return {
+    projectId: String(row.project_id ?? ""),
+    environment: String(row.environment ?? "local"),
+    schedule: parseJsonValue(row.schedule_json, {
+      timezone: "UTC",
+      windows: []
+    }),
+    dailyTaskCreditBudget: Number(row.daily_task_credit_budget ?? 0),
+    maxQueuedTasks: Number(row.max_queued_tasks ?? 0),
+    maxQueuedCredits: Number(row.max_queued_credits ?? 0),
+    autoscale: normalizeAutoscale(parseJsonValue(row.autoscale_json, {})),
+    creditWeights: parseJsonValue(row.credit_weights_json, []),
+    metadata: parseJsonValue(row.metadata_json, {})
+  };
+}
+function prioritySnapshotFromRow(row) {
+  const payload = parseJsonValue(row.snapshot_json, {});
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    workDayId: row.work_day_id !== void 0 && row.work_day_id !== null ? String(row.work_day_id) : null,
+    generatedAt: String(row.generated_at ?? row.created_at ?? nowIso()),
+    items: Array.isArray(payload.items) ? payload.items : [],
+    metadata: parseJsonValue(row.metadata_json, {})
+  };
+}
+function taskCreditLedgerEntryFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    workDayId: String(row.work_day_id ?? ""),
+    taskId: row.task_id !== void 0 && row.task_id !== null ? String(row.task_id) : null,
+    phase: String(row.phase ?? "seed"),
+    credits: Number(row.credits ?? 0),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso())
+  };
+}
+function scaleDecisionFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    environment: String(row.environment ?? "local"),
+    poolName: String(row.pool_name ?? ""),
+    workDayId: row.work_day_id !== void 0 && row.work_day_id !== null ? String(row.work_day_id) : null,
+    desiredWorkers: Number(row.desired_workers ?? 0),
+    observedQueueDepth: Number(row.observed_queue_depth ?? 0),
+    observedActiveLeases: Number(row.observed_active_leases ?? 0),
+    reason: String(row.reason ?? "reconcile"),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso())
+  };
+}
 class OperationalStore extends SqliteStoreBase {
   async getWorkDay(id) {
     const row = await this.selectFirst(`SELECT * FROM work_days WHERE id = ${toSqlValue(id)} LIMIT 1`);
@@ -273,6 +345,169 @@ class OperationalStore extends SqliteStoreBase {
     const row = await this.selectFirst(`SELECT * FROM reports WHERE id = ${toSqlValue(id)} LIMIT 1`);
     return row ? reportFromRow(row) : null;
   }
+  async getWorkPolicy(projectId, environment = "local") {
+    if (!await this.tableExists("work_policies")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM work_policies WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} LIMIT 1`
+    );
+    return row ? workPolicyFromRow(row) : null;
+  }
+  async upsertWorkPolicy(request) {
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO work_policies (
+				project_id, environment, schedule_json, daily_task_credit_budget, max_queued_tasks, max_queued_credits, autoscale_json, credit_weights_json, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.environment)},
+				${toSqlValue(json(request.schedule))},
+				${Number(request.dailyTaskCreditBudget ?? 0)},
+				${Number(request.maxQueuedTasks ?? 0)},
+				${Number(request.maxQueuedCredits ?? 0)},
+				${toSqlValue(json(request.autoscale))},
+				${toSqlValue(json(request.creditWeights ?? []))},
+				${toSqlValue(json(request.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM work_policies WHERE project_id = ${toSqlValue(request.projectId)} AND environment = ${toSqlValue(request.environment)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    return this.getWorkPolicy(request.projectId, request.environment);
+  }
+  async listPriorityOverrides(projectId) {
+    if (!await this.tableExists("priority_overrides")) {
+      return [];
+    }
+    return this.selectAll(
+      `SELECT * FROM priority_overrides WHERE project_id = ${toSqlValue(projectId)} ORDER BY priority DESC, updated_at DESC`
+    );
+  }
+  async upsertPriorityOverride(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO priority_overrides (
+				id, project_id, model, subject_id, priority, estimated_credits, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.model)},
+				${toSqlValue(request.subjectId)},
+				${Number(request.priority ?? 0)},
+				${toSqlValue(request.estimatedCredits ?? null)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM priority_overrides WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM priority_overrides WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? {
+      id: String(row.id ?? ""),
+      projectId: String(row.project_id ?? ""),
+      model: String(row.model ?? ""),
+      subjectId: String(row.subject_id ?? ""),
+      priority: Number(row.priority ?? 0),
+      estimatedCredits: row.estimated_credits === null || row.estimated_credits === void 0 ? null : Number(row.estimated_credits),
+      metadata: parseJsonValue(row.metadata_json, {}),
+      createdAt: String(row.created_at ?? timestamp),
+      updatedAt: String(row.updated_at ?? timestamp)
+    } : null;
+  }
+  async createPrioritySnapshot(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO priority_snapshots (
+				id, project_id, work_day_id, snapshot_json, metadata_json, generated_at, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.workDayId ?? null)},
+				${toSqlValue(json({ items: request.items }))},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)},
+				COALESCE((SELECT created_at FROM priority_snapshots WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM priority_snapshots WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? prioritySnapshotFromRow(row) : null;
+  }
+  async getLatestPrioritySnapshot(projectId, workDayId) {
+    if (!await this.tableExists("priority_snapshots")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM priority_snapshots WHERE project_id = ${toSqlValue(projectId)}${workDayId ? ` AND work_day_id = ${toSqlValue(workDayId)}` : ""} ORDER BY generated_at DESC LIMIT 1`
+    );
+    return row ? prioritySnapshotFromRow(row) : null;
+  }
+  async recordTaskCredits(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT INTO task_credit_ledger (
+				id, project_id, work_day_id, task_id, phase, credits, metadata_json, created_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.workDayId)},
+				${toSqlValue(request.taskId ?? null)},
+				${toSqlValue(request.phase)},
+				${Number(request.credits ?? 0)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const delta = request.phase === "refund" ? -Math.abs(Number(request.credits ?? 0)) : Math.abs(Number(request.credits ?? 0));
+    await this.execute(
+      `UPDATE work_days SET capacity_used = MAX(0, capacity_used + ${delta}), updated_at = ${toSqlValue(timestamp)} WHERE id = ${toSqlValue(request.workDayId)}`
+    );
+    const row = await this.selectFirst(`SELECT * FROM task_credit_ledger WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? taskCreditLedgerEntryFromRow(row) : null;
+  }
+  async listTaskCredits(workDayId) {
+    if (!await this.tableExists("task_credit_ledger")) {
+      return [];
+    }
+    const rows = await this.selectAll(
+      `SELECT * FROM task_credit_ledger WHERE work_day_id = ${toSqlValue(workDayId)} ORDER BY created_at ASC`
+    );
+    return rows.map(taskCreditLedgerEntryFromRow);
+  }
+  async recordScaleDecision(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT INTO scale_decisions (
+				id, project_id, environment, pool_name, work_day_id, desired_workers, observed_queue_depth, observed_active_leases, reason, metadata_json, created_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.environment)},
+				${toSqlValue(request.poolName)},
+				${toSqlValue(request.workDayId ?? null)},
+				${Number(request.desiredWorkers ?? 0)},
+				${Number(request.observedQueueDepth ?? 0)},
+				${Number(request.observedActiveLeases ?? 0)},
+				${toSqlValue(request.reason)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM scale_decisions WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? scaleDecisionFromRow(row) : null;
+  }
+  async getLatestScaleDecision(projectId, environment, poolName) {
+    if (!await this.tableExists("scale_decisions")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM scale_decisions WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} AND pool_name = ${toSqlValue(poolName)} ORDER BY created_at DESC LIMIT 1`
+    );
+    return row ? scaleDecisionFromRow(row) : null;
+  }
 }
 export {
   OperationalStore

package/dist/template-catalog.js

@@ -67,7 +67,14 @@ function normalizeTemplateCatalogEntry(value) {
     minCoreVersion: optionalString(record.minCoreVersion),
     fulfillment: {
       mode: optionalString(fulfillment.mode),
-      source: {
+      source: optionalString(source.kind) === "r2" ? {
+        kind: "r2",
+        bucket: optionalString(source.bucket),
+        objectKey: expectString(source.objectKey, "fulfillment.source.objectKey"),
+        version: expectString(source.version, "fulfillment.source.version"),
+        publicUrl: optionalString(source.publicUrl),
+        integrity: optionalString(source.integrity)
+      } : {
         kind: "git",
         repoUrl: expectString(source.repoUrl, "fulfillment.source.repoUrl"),
         directory: expectString(source.directory, "fulfillment.source.directory"),

package/dist/treeseed/template-catalog/templates/starter-basic/template/treeseed.site.yaml

@@ -2,9 +2,27 @@ name: __SITE_NAME__
 slug: __SITE_SLUG__
 siteUrl: __SITE_URL__
 contactEmail: __CONTACT_EMAIL__
+hosting:
+  kind: hosted_project
+  registration: optional
+  marketBaseUrl: https://api.treeseed.ai
+  teamId: __SITE_SLUG__
+  projectId: __SITE_SLUG__
 cloudflare:
   accountId: replace-with-cloudflare-account-id
   workerName: __SITE_SLUG__
+  pages:
+    projectName: __SITE_SLUG__
+    previewProjectName: __SITE_SLUG__-staging
+    productionBranch: main
+    stagingBranch: staging
+    buildOutputDir: dist
+  r2:
+    binding: TREESEED_CONTENT_BUCKET
+    bucketName: __SITE_SLUG__-content
+    manifestKeyTemplate: teams/{teamId}/published/common.json
+    previewRootTemplate: teams/{teamId}/previews
+    previewTtlHours: 168
 plugins:
   - package: '@treeseed/sdk/plugin-default'
 providers:
@@ -18,6 +36,8 @@ providers:
     research: stub
   deploy: cloudflare
   content:
+    runtime: team_scoped_r2_overlay
+    publish: team_scoped_r2_overlay
     docs: default
   site: default
 smtp:

package/dist/types/cloudflare.d.ts

@@ -22,11 +22,34 @@ export interface D1DatabaseLike {
 export interface CloudflareRuntimeAssets {
     fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
 }
+export interface R2ObjectBodyLike {
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    json<T = unknown>(): Promise<T>;
+}
+export interface R2ObjectLike extends R2ObjectBodyLike {
+    httpEtag?: string;
+    etag?: string;
+    size?: number;
+    uploaded?: Date;
+    writeHttpMetadata?(headers: Headers): void;
+}
+export interface R2PutOptionsLike {
+    httpMetadata?: Record<string, unknown>;
+    customMetadata?: Record<string, string>;
+}
+export interface R2BucketLike {
+    get(key: string): Promise<R2ObjectLike | null>;
+    head?(key: string): Promise<R2ObjectLike | null>;
+    put(key: string, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: R2PutOptionsLike): Promise<unknown>;
+    delete?(key: string | string[]): Promise<void>;
+}
 export interface CloudflareRuntime {
     env: {
         FORM_GUARD_KV: KvNamespaceLike;
         SITE_DATA_DB: D1DatabaseLike;
         SESSION: KvNamespaceLike;
         ASSETS?: CloudflareRuntimeAssets;
+        [key: string]: unknown;
     };
 }

package/dist/workflow/operations.d.ts

@@ -30,7 +30,7 @@ export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promis
 export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<TreeseedWorkflowResult<{
     mode: string;
     scopes: ("local" | "staging" | "prod")[];
-    sync: "all" | "cloudflare" | "railway" | "none" | "github";
+    sync: "none" | "cloudflare" | "railway" | "github" | "all";
     configPath: string;
     keyPath: string;
     repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
@@ -79,6 +79,12 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
         }>;
         connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
         validationByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, ReturnType<typeof import("../platform/environment.ts").validateTreeseedEnvironmentValues>>;
+        readinessByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, {
+            configured: boolean;
+            provisioned: boolean;
+            deployable: boolean;
+            checks: Record<string, unknown>;
+        }>;
         updated: {
             scope: import("../operations/services/config-runtime.ts").TreeseedConfigScope | "shared";
             id: string;
@@ -133,7 +139,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
     payload: {
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
+        sync: "none" | "cloudflare" | "railway" | "github" | "all";
         secretsRevealed: boolean;
         reports: {
             scope: "local" | "staging" | "prod";
@@ -196,7 +202,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
     payload: {
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
+        sync: "none" | "cloudflare" | "railway" | "github" | "all";
         keyPath: string;
         repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
         preflight: {
@@ -455,9 +461,12 @@ export declare function workflowDestroy(helpers: WorkflowOperationHelpers, input
                 workerName: any;
                 siteUrl: any;
                 accountId: any;
+                pages: any;
                 formGuardKv: any;
                 sessionKv: any;
                 siteDataDb: any;
+                queue: any;
+                content: any;
             };
             operations: {
                 worker: {

package/dist/workflow/policy.d.ts

@@ -9,4 +9,4 @@ export type TreeseedResolvedWorkflowPaths = {
 };
 export declare function classifyTreeseedBranchRole(branchName: string | null, repoDir: string | null): TreeseedWorkflowBranchRole;
 export declare function resolveTreeseedWorkflowPaths(startCwd: string): TreeseedResolvedWorkflowPaths;
-export declare function workflowEnvironmentForBranchRole(branchRole: TreeseedWorkflowBranchRole): "local" | "staging" | "prod" | "none";
+export declare function workflowEnvironmentForBranchRole(branchRole: TreeseedWorkflowBranchRole): "local" | "none" | "staging" | "prod";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -20,7 +20,8 @@
   "files": [
     "README.md",
     "dist",
-    "scripts/verify-driver.mjs"
+    "scripts/verify-driver.mjs",
+    "templates"
   ],
   "publishConfig": {
     "access": "public"
@@ -133,6 +134,10 @@
       "types": "./dist/platform/books-data.d.ts",
       "default": "./dist/platform/books-data.js"
     },
+    "./platform/published-content": {
+      "types": "./dist/platform/published-content.d.ts",
+      "default": "./dist/platform/published-content.js"
+    },
     "./platform/book-export": {
       "types": "./dist/platform/book-export.d.ts",
       "default": "./dist/platform/book-export.js"