@treeseed/sdk 0.8.12 → 0.8.14

package/dist/seeds/types.d.ts

@@ -0,0 +1,220 @@
+export declare const SEED_ENVIRONMENTS: readonly ["local", "staging", "prod"];
+export type SeedEnvironment = typeof SEED_ENVIRONMENTS[number];
+export type SeedDiagnosticSeverity = 'error' | 'warning';
+export type SeedPlanActionType = 'create' | 'update' | 'unchanged' | 'skip' | 'delete' | 'error';
+export type SeedResourceKind = 'team' | 'repositoryHost' | 'project' | 'hubRepository' | 'capacityProvider' | 'capacityLane' | 'capacityGrant' | 'workPolicy' | 'product' | 'catalogArtifact';
+export type SeedDiagnostic = {
+    severity: SeedDiagnosticSeverity;
+    code: string;
+    message: string;
+    path?: string;
+};
+export type SeedResourceBase = {
+    key: string;
+    environments?: SeedEnvironment[];
+};
+export type SeedManifest = {
+    name: string;
+    version: 1;
+    description?: string;
+    defaultEnvironments?: SeedEnvironment[];
+    environments: SeedEnvironment[];
+    resources: SeedManifestResources;
+};
+export type SeedManifestResources = {
+    teams: SeedTeamResource[];
+    repositoryHosts: SeedRepositoryHostResource[];
+    projects: SeedProjectResource[];
+    hubRepositories: SeedHubRepositoryResource[];
+    products: SeedProductResource[];
+    catalogArtifacts: SeedCatalogArtifactResource[];
+    capacityProviders: SeedCapacityProviderResource[];
+    capacityGrants: SeedCapacityGrantResource[];
+    workPolicies: SeedWorkPolicyResource[];
+    agentPools: Record<string, unknown>[];
+};
+export type SeedTeamResource = SeedResourceBase & {
+    slug: string;
+    name?: string;
+    displayName?: string;
+    logoUrl?: string;
+    profileSummary?: string;
+    metadata?: Record<string, unknown>;
+};
+export type SeedProjectRepository = {
+    role: string;
+    provider: string;
+    owner: string;
+    name: string;
+    gitUrl: string;
+    defaultBranch?: string;
+    checkoutPath?: string;
+    submodulePath?: string;
+    webUrl?: string;
+};
+export type SeedProjectResource = SeedResourceBase & {
+    team: string;
+    slug: string;
+    name: string;
+    description?: string;
+    kind?: string;
+    repository: SeedProjectRepository;
+    metadata?: Record<string, unknown>;
+};
+export type SeedRepositoryHostResource = SeedResourceBase & {
+    team: string;
+    provider: string;
+    name: string;
+    ownership?: string;
+    accountLabel?: string;
+    organizationOrOwner: string;
+    defaultVisibility?: string;
+    softwareRepositoryNameTemplate?: string;
+    contentRepositoryNameTemplate?: string;
+    branchPolicy?: Record<string, unknown>;
+    workflowPolicy?: Record<string, unknown>;
+    allowedProjectKinds?: string[];
+    status?: string;
+    credentialRef?: string;
+    metadata?: Record<string, unknown>;
+};
+export type SeedHubRepositoryResource = SeedResourceBase & {
+    project: string;
+    role: string;
+    repositoryHost?: string;
+    provider: string;
+    owner: string;
+    name: string;
+    gitUrl: string;
+    defaultBranch?: string;
+    currentBranch?: string;
+    submodulePath?: string;
+    status?: string;
+    accessPolicy?: Record<string, unknown>;
+    releasePolicy?: Record<string, unknown>;
+    publishPolicy?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+export type SeedProductResource = SeedResourceBase & {
+    team: string;
+    kind: string;
+    slug: string;
+    title: string;
+    summary?: string;
+    visibility?: string;
+    listingEnabled?: boolean;
+    offerMode?: string;
+    manifestKey?: string;
+    artifactKey?: string;
+    searchText?: string;
+    metadata?: Record<string, unknown>;
+};
+export type SeedCatalogArtifactResource = SeedResourceBase & {
+    product: string;
+    version: string;
+    kind: string;
+    contentKey: string;
+    manifestKey?: string;
+    publishedAt?: string;
+    metadata?: Record<string, unknown>;
+};
+export type SeedCapacityLaneResource = SeedResourceBase & {
+    name: string;
+    businessModel?: string;
+    modelFamily?: string;
+    modelClass?: string;
+    regionPolicy?: string;
+    unit?: string;
+    scarcityLevel?: string;
+    hardLimits?: Record<string, unknown>;
+    routingPolicy?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+export type SeedCapacityProviderRegistrationApiKey = {
+    createIfMissing?: boolean;
+    name?: string;
+    scopes?: string[];
+    expiresAt?: string;
+};
+export type SeedCapacityProviderRegistration = {
+    apiKey?: SeedCapacityProviderRegistrationApiKey;
+};
+export type SeedCapacityProviderResource = SeedResourceBase & {
+    team: string;
+    name: string;
+    kind?: string;
+    provider: string;
+    billingScope?: string;
+    monthlyCreditBudget?: number;
+    dailyCreditBudget?: number;
+    maxConcurrentWorkdays?: number;
+    maxConcurrentWorkers?: number;
+    capacityModel?: Record<string, unknown>;
+    registration?: SeedCapacityProviderRegistration;
+    metadata?: Record<string, unknown>;
+    lanes?: SeedCapacityLaneResource[];
+};
+export type SeedCapacityGrantResource = SeedResourceBase & {
+    provider: string;
+    lane?: string;
+    team: string;
+    project?: string;
+    environment?: SeedEnvironment;
+    grantScope?: string;
+    dailyCreditLimit?: number;
+    weeklyCreditLimit?: number;
+    monthlyCreditLimit?: number;
+    dailyUsdLimit?: number;
+    weeklyQuotaMinutes?: number;
+    monthlyProviderUnits?: number;
+    priorityWeight?: number;
+    overflowPolicy?: string;
+    state?: string;
+    metadata?: Record<string, unknown>;
+};
+export type SeedWorkPolicyResource = SeedResourceBase & {
+    project: string;
+    environment: SeedEnvironment;
+    enabled?: boolean;
+    startCron?: string;
+    durationMinutes?: number;
+    maxRunners?: number;
+    maxWorkersPerRunner?: number;
+    dailyCreditBudget?: number;
+    maxQueuedTasks?: number;
+    maxQueuedCredits?: number;
+    autoscale?: Record<string, unknown>;
+    creditWeights?: unknown[];
+    metadata?: Record<string, unknown>;
+};
+export type NormalizedSeedResource = {
+    kind: SeedResourceKind;
+    key: string;
+    label: string;
+    environments: SeedEnvironment[];
+    payload: Record<string, unknown>;
+    parentKey?: string;
+};
+export type SeedPlanAction = NormalizedSeedResource & {
+    action: SeedPlanActionType;
+    reason?: string;
+    existing?: Record<string, unknown> | null;
+};
+export type SeedPlanSummary = Record<SeedPlanActionType, number>;
+export type SeedCurrentResource = {
+    key: string;
+    kind: SeedResourceKind;
+    payload: Record<string, unknown>;
+    existing?: Record<string, unknown> | null;
+};
+export type SeedPlan = {
+    ok: boolean;
+    seed: string;
+    version: 1;
+    mode: 'plan' | 'validate' | 'apply';
+    environments: SeedEnvironment[];
+    summary: SeedPlanSummary;
+    actions: SeedPlanAction[];
+    diagnostics: SeedDiagnostic[];
+    manifestPath: string;
+};

package/dist/seeds/types.js

@@ -0,0 +1,4 @@
+const SEED_ENVIRONMENTS = ["local", "staging", "prod"];
+export {
+  SEED_ENVIRONMENTS
+};

package/dist/stores/operational-store.d.ts

@@ -1,6 +1,11 @@
-import type { PrioritySnapshot, SdkCreatePrioritySnapshotRequest, SdkAppendTaskEventRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateTaskRequest, SdkFailTaskRequest, SdkGraphRunEntity, SdkClaimWorkdayManagerLeaseRequest, SdkCreateWorkdayRequest, SdkPriorityOverrideRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkReportEntity, SdkRecordScaleDecisionRequest, SdkRecordWorkerRunnerRequest, SdkRecordTaskCreditsRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkStartWorkDayRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateWorkDayGraphRequest, SdkWorkDayEntity, RepositoryClaim, RunnerScaleDecision, ScaleDecision, TaskCreditLedgerEntry, WorkdayPolicy, WorkdayManagerLease, WorkdayRequest, WorkerRunner } from '../sdk-types.ts';
+import type { ApprovalRequest, CreateApprovalRequestRequest, DecideApprovalRequestRequest, PrioritySnapshot, ListApprovalRequestsRequest, SdkCreatePrioritySnapshotRequest, SdkAppendTaskEventRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateTaskRequest, SdkFailTaskRequest, SdkGraphRunEntity, SdkClaimWorkdayManagerLeaseRequest, SdkCreateWorkdayRequest, SdkPriorityOverrideRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkReportEntity, SdkRecordScaleDecisionRequest, SdkRecordWorkerRunnerRequest, SdkRecordTaskCreditsRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkStartWorkDayRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateWorkDayGraphRequest, SdkWorkDayEntity, RepositoryClaim, RunnerScaleDecision, ScaleDecision, TaskCreditLedgerEntry, UpsertTeamInboxItemRequest, WorkdayPolicy, WorkdayManagerLease, WorkdayRequest, WorkerRunner } from '../sdk-types.ts';
+import type { InboxItem } from '../project-workflow.ts';
 import { SqliteStoreBase, type DatabaseRow } from './helpers.ts';
 export declare class OperationalStore extends SqliteStoreBase {
+    private governanceInitialized;
+    private runnerInitialized;
+    private ensureGovernanceSchema;
+    private ensureRunnerSchema;
     getWorkDay(id: string): Promise<SdkWorkDayEntity | null>;
     searchWorkDays(limit?: number): Promise<SdkWorkDayEntity[]>;
     startWorkDay(request: SdkStartWorkDayRequest): Promise<SdkWorkDayEntity | null>;
@@ -27,6 +32,7 @@ export declare class OperationalStore extends SqliteStoreBase {
     listWorkdayRequests(projectId: string, environment: string, state?: string | null): Promise<WorkdayRequest[]>;
     claimWorkdayManagerLease(request: SdkClaimWorkdayManagerLeaseRequest): Promise<WorkdayManagerLease | null>;
     releaseWorkdayManagerLease(request: SdkReleaseWorkdayManagerLeaseRequest): Promise<WorkdayManagerLease | null>;
+    listWorkdayManagerLeases(projectId: string, environment: string): Promise<WorkdayManagerLease[]>;
     recordWorkerRunner(request: SdkRecordWorkerRunnerRequest): Promise<WorkerRunner | null>;
     listWorkerRunners(projectId: string, environment: string): Promise<WorkerRunner[]>;
     recordRepositoryClaim(request: SdkRecordRepositoryClaimRequest): Promise<RepositoryClaim | null>;
@@ -52,4 +58,8 @@ export declare class OperationalStore extends SqliteStoreBase {
     listTaskCredits(workDayId: string): Promise<TaskCreditLedgerEntry[]>;
     recordScaleDecision(request: SdkRecordScaleDecisionRequest): Promise<ScaleDecision | null>;
     getLatestScaleDecision(projectId: string, environment: string, poolName: string): Promise<ScaleDecision | null>;
+    createApprovalRequest(request: CreateApprovalRequestRequest): Promise<ApprovalRequest | null>;
+    listApprovalRequests(request?: ListApprovalRequestsRequest): Promise<ApprovalRequest[]>;
+    decideApprovalRequest(id: string, request: DecideApprovalRequestRequest): Promise<ApprovalRequest | null>;
+    upsertTeamInboxItem(request: UpsertTeamInboxItemRequest): Promise<InboxItem | null>;
 }

package/dist/stores/operational-store.js

@@ -250,7 +250,135 @@ function scaleDecisionFromRow(row) {
     createdAt: String(row.created_at ?? nowIso())
   };
 }
+function approvalRequestFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    teamId: String(row.team_id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    workDayId: row.work_day_id === void 0 || row.work_day_id === null ? null : String(row.work_day_id),
+    taskId: row.task_id === void 0 || row.task_id === null ? null : String(row.task_id),
+    kind: String(row.kind ?? ""),
+    state: String(row.state ?? "pending"),
+    severity: String(row.severity ?? "medium"),
+    requestedByType: String(row.requested_by_type ?? "worker"),
+    requestedById: row.requested_by_id === void 0 || row.requested_by_id === null ? null : String(row.requested_by_id),
+    title: String(row.title ?? ""),
+    summary: String(row.summary ?? ""),
+    options: parseJsonValue(row.options_json, []),
+    recommendation: parseJsonValue(row.recommendation_json, {}),
+    policySnapshot: parseJsonValue(row.policy_snapshot_json, {}),
+    expiresAt: row.expires_at === void 0 || row.expires_at === null ? null : String(row.expires_at),
+    decidedByType: row.decided_by_type === void 0 || row.decided_by_type === null ? null : String(row.decided_by_type),
+    decidedById: row.decided_by_id === void 0 || row.decided_by_id === null ? null : String(row.decided_by_id),
+    decidedAt: row.decided_at === void 0 || row.decided_at === null ? null : String(row.decided_at),
+    decision: row.decision_json === void 0 || row.decision_json === null ? null : parseJsonValue(row.decision_json, null),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso()),
+    updatedAt: String(row.updated_at ?? nowIso())
+  };
+}
+function teamInboxItemFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    teamId: String(row.team_id ?? ""),
+    projectId: row.project_id === void 0 || row.project_id === null ? null : String(row.project_id),
+    kind: String(row.kind ?? ""),
+    state: String(row.state ?? "informational"),
+    title: String(row.title ?? ""),
+    summary: row.summary === void 0 || row.summary === null ? null : String(row.summary),
+    href: row.href === void 0 || row.href === null ? null : String(row.href),
+    itemKey: row.item_key === void 0 || row.item_key === null ? null : String(row.item_key),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso()),
+    updatedAt: String(row.updated_at ?? nowIso())
+  };
+}
 class OperationalStore extends SqliteStoreBase {
+  governanceInitialized = false;
+  runnerInitialized = false;
+  async ensureGovernanceSchema() {
+    if (this.governanceInitialized) return;
+    await this.execute(`CREATE TABLE IF NOT EXISTS approval_requests (
+			id TEXT PRIMARY KEY,
+			team_id TEXT NOT NULL,
+			project_id TEXT NOT NULL,
+			work_day_id TEXT,
+			task_id TEXT,
+			kind TEXT NOT NULL,
+			state TEXT NOT NULL DEFAULT 'pending',
+			severity TEXT NOT NULL DEFAULT 'medium',
+			requested_by_type TEXT NOT NULL DEFAULT 'worker',
+			requested_by_id TEXT,
+			title TEXT NOT NULL,
+			summary TEXT NOT NULL,
+			options_json TEXT NOT NULL DEFAULT '[]',
+			recommendation_json TEXT NOT NULL DEFAULT '{}',
+			policy_snapshot_json TEXT NOT NULL DEFAULT '{}',
+			expires_at TEXT,
+			decided_by_type TEXT,
+			decided_by_id TEXT,
+			decided_at TEXT,
+			decision_json TEXT,
+			metadata_json TEXT NOT NULL DEFAULT '{}',
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		)`);
+    await this.execute("CREATE INDEX IF NOT EXISTS idx_approval_requests_team_state ON approval_requests(team_id, state, created_at DESC)");
+    await this.execute("CREATE INDEX IF NOT EXISTS idx_approval_requests_project_workday ON approval_requests(project_id, work_day_id, state, created_at DESC)");
+    await this.execute(`CREATE TABLE IF NOT EXISTS team_inbox_items (
+			id TEXT PRIMARY KEY,
+			team_id TEXT NOT NULL,
+			project_id TEXT,
+			kind TEXT NOT NULL,
+			state TEXT NOT NULL,
+			title TEXT NOT NULL,
+			summary TEXT,
+			href TEXT,
+			item_key TEXT,
+			metadata_json TEXT NOT NULL DEFAULT '{}',
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		)`);
+    await this.execute("CREATE INDEX IF NOT EXISTS idx_team_inbox_items_team_created ON team_inbox_items(team_id, created_at DESC)");
+    this.governanceInitialized = true;
+  }
+  async ensureRunnerSchema() {
+    if (this.runnerInitialized) return;
+    await this.execute(`CREATE TABLE IF NOT EXISTS workday_manager_leases (
+			id TEXT PRIMARY KEY,
+			project_id TEXT NOT NULL,
+			environment TEXT NOT NULL,
+			work_day_id TEXT,
+			manager_id TEXT NOT NULL,
+			state TEXT NOT NULL DEFAULT 'active',
+			heartbeat_at TEXT NOT NULL,
+			expires_at TEXT NOT NULL,
+			metadata_json TEXT NOT NULL DEFAULT '{}',
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		)`);
+    await this.execute("CREATE INDEX IF NOT EXISTS idx_workday_manager_leases_active ON workday_manager_leases(project_id, environment, state, heartbeat_at DESC)");
+    await this.execute(`CREATE TABLE IF NOT EXISTS worker_runners (
+			id TEXT PRIMARY KEY,
+			project_id TEXT NOT NULL,
+			environment TEXT NOT NULL,
+			runner_id TEXT NOT NULL,
+			runner_service_name TEXT NOT NULL,
+			volume_identity TEXT NOT NULL,
+			state TEXT NOT NULL,
+			max_local_workers INTEGER NOT NULL DEFAULT 4,
+			active_local_workers INTEGER NOT NULL DEFAULT 0,
+			available_capacity INTEGER NOT NULL DEFAULT 0,
+			last_heartbeat_at TEXT NOT NULL,
+			claimed_repository_ids_json TEXT NOT NULL DEFAULT '[]',
+			metadata_json TEXT NOT NULL DEFAULT '{}',
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		)`);
+    await this.execute("CREATE UNIQUE INDEX IF NOT EXISTS idx_worker_runners_identity ON worker_runners(project_id, environment, runner_id)");
+    await this.execute("CREATE INDEX IF NOT EXISTS idx_worker_runners_state_capacity ON worker_runners(project_id, environment, state, available_capacity DESC)");
+    this.runnerInitialized = true;
+  }
   async getWorkDay(id) {
     const row = await this.selectFirst(`SELECT * FROM work_days WHERE id = ${toSqlValue(id)} LIMIT 1`);
     return row ? workDayFromRow(row) : null;
@@ -505,6 +633,7 @@ class OperationalStore extends SqliteStoreBase {
     return rows.map(workdayRequestFromRow);
   }
   async claimWorkdayManagerLease(request) {
+    await this.ensureRunnerSchema();
     const timestamp = request.now ?? nowIso();
     const active = await this.selectFirst(
       `SELECT * FROM workday_manager_leases WHERE project_id = ${toSqlValue(request.projectId)} AND environment = ${toSqlValue(request.environment)} AND state = 'active' ORDER BY updated_at DESC LIMIT 1`
@@ -540,6 +669,7 @@ class OperationalStore extends SqliteStoreBase {
     return row ? workdayManagerLeaseFromRow(row) : null;
   }
   async releaseWorkdayManagerLease(request) {
+    await this.ensureRunnerSchema();
     const timestamp = nowIso();
     await this.execute(
       `UPDATE workday_manager_leases SET state = 'released', updated_at = ${toSqlValue(timestamp)} WHERE id = ${toSqlValue(request.id)} AND manager_id = ${toSqlValue(request.managerId)}`
@@ -547,7 +677,16 @@ class OperationalStore extends SqliteStoreBase {
     const row = await this.selectFirst(`SELECT * FROM workday_manager_leases WHERE id = ${toSqlValue(request.id)} LIMIT 1`);
     return row ? workdayManagerLeaseFromRow(row) : null;
   }
+  async listWorkdayManagerLeases(projectId, environment) {
+    await this.ensureRunnerSchema();
+    if (!await this.tableExists("workday_manager_leases")) return [];
+    const rows = await this.selectAll(
+      `SELECT * FROM workday_manager_leases WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} ORDER BY heartbeat_at DESC, updated_at DESC LIMIT 10`
+    );
+    return rows.map(workdayManagerLeaseFromRow);
+  }
   async recordWorkerRunner(request) {
+    await this.ensureRunnerSchema();
     const timestamp = nowIso();
     const id = request.id ?? `${request.projectId}:${request.environment}:${request.runnerId}`;
     const maxLocalWorkers = Number(request.maxLocalWorkers ?? 4);
@@ -577,6 +716,7 @@ class OperationalStore extends SqliteStoreBase {
     return row ? workerRunnerFromRow(row) : null;
   }
   async listWorkerRunners(projectId, environment) {
+    await this.ensureRunnerSchema();
     if (!await this.tableExists("worker_runners")) return [];
     const rows = await this.selectAll(
       `SELECT * FROM worker_runners WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} ORDER BY runner_id ASC`
@@ -786,6 +926,110 @@ class OperationalStore extends SqliteStoreBase {
     );
     return row ? scaleDecisionFromRow(row) : null;
   }
+  async createApprovalRequest(request) {
+    await this.ensureGovernanceSchema();
+    const id = request.id ?? crypto.randomUUID();
+    const existing = await this.selectFirst(`SELECT * FROM approval_requests WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    if (existing && String(existing.state ?? "pending") !== "pending") {
+      return approvalRequestFromRow(existing);
+    }
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO approval_requests (
+				id, team_id, project_id, work_day_id, task_id, kind, state, severity, requested_by_type,
+				requested_by_id, title, summary, options_json, recommendation_json, policy_snapshot_json,
+				expires_at, decided_by_type, decided_by_id, decided_at, decision_json, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.teamId)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.workDayId ?? null)},
+				${toSqlValue(request.taskId ?? null)},
+				${toSqlValue(request.kind)},
+				${toSqlValue(existing?.state ?? "pending")},
+				${toSqlValue(request.severity ?? existing?.severity ?? "medium")},
+				${toSqlValue(request.requestedByType ?? existing?.requested_by_type ?? "worker")},
+				${toSqlValue(request.requestedById ?? existing?.requested_by_id ?? null)},
+				${toSqlValue(request.title)},
+				${toSqlValue(request.summary)},
+				${toSqlValue(json(request.options ?? parseJsonValue(existing?.options_json, [])))},
+				${toSqlValue(json(request.recommendation ?? parseJsonValue(existing?.recommendation_json, {})))},
+				${toSqlValue(json(request.policySnapshot ?? parseJsonValue(existing?.policy_snapshot_json, {})))},
+				${toSqlValue(request.expiresAt ?? existing?.expires_at ?? null)},
+				${toSqlValue(existing?.decided_by_type ?? null)},
+				${toSqlValue(existing?.decided_by_id ?? null)},
+				${toSqlValue(existing?.decided_at ?? null)},
+				${toSqlValue(existing?.decision_json ?? null)},
+				${toSqlValue(json(request.metadata ?? parseJsonValue(existing?.metadata_json, {})))},
+				COALESCE((SELECT created_at FROM approval_requests WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM approval_requests WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? approvalRequestFromRow(row) : null;
+  }
+  async listApprovalRequests(request = {}) {
+    await this.ensureGovernanceSchema();
+    const clauses = [];
+    if (request.projectId) clauses.push(`project_id = ${toSqlValue(request.projectId)}`);
+    if (request.teamId) clauses.push(`team_id = ${toSqlValue(request.teamId)}`);
+    if (request.state) {
+      const states = Array.isArray(request.state) ? request.state : [request.state];
+      clauses.push(`state IN (${states.map((entry) => toSqlValue(String(entry))).join(", ")})`);
+    }
+    const rows = await this.selectAll(
+      `SELECT * FROM approval_requests ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""} ORDER BY created_at DESC LIMIT ${Math.max(1, Math.min(500, Number(request.limit ?? 100)))}`
+    );
+    return rows.map(approvalRequestFromRow);
+  }
+  async decideApprovalRequest(id, request) {
+    await this.ensureGovernanceSchema();
+    const existing = await this.selectFirst(`SELECT * FROM approval_requests WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    if (!existing) return null;
+    const timestamp = nowIso();
+    const decision = {
+      ...request.decision ?? {},
+      ...request.optionId ? { optionId: request.optionId } : {},
+      ...request.note ? { note: request.note } : {}
+    };
+    await this.execute(
+      `UPDATE approval_requests
+			 SET state = ${toSqlValue(String(request.state || "pending"))},
+			 decided_by_type = ${toSqlValue(request.decidedByType ?? "user")},
+			 decided_by_id = ${toSqlValue(request.decidedById ?? null)},
+			 decided_at = ${toSqlValue(timestamp)},
+			 decision_json = ${toSqlValue(json(decision))},
+			 updated_at = ${toSqlValue(timestamp)}
+			 WHERE id = ${toSqlValue(id)}`
+    );
+    const row = await this.selectFirst(`SELECT * FROM approval_requests WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? approvalRequestFromRow(row) : null;
+  }
+  async upsertTeamInboxItem(request) {
+    await this.ensureGovernanceSchema();
+    const id = request.id ?? request.itemKey ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO team_inbox_items (
+				id, team_id, project_id, kind, state, title, summary, href, item_key, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.teamId)},
+				${toSqlValue(request.projectId ?? null)},
+				${toSqlValue(request.kind)},
+				${toSqlValue(request.state)},
+				${toSqlValue(request.title)},
+				${toSqlValue(request.summary ?? null)},
+				${toSqlValue(request.href ?? null)},
+				${toSqlValue(request.itemKey ?? null)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM team_inbox_items WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM team_inbox_items WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? teamInboxItemFromRow(row) : null;
+  }
 }
 export {
   OperationalStore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.8.12",
+  "version": "0.8.14",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -112,6 +112,10 @@
       "types": "./dist/fixture-support.d.ts",
       "default": "./dist/fixture-support.js"
     },
+    "./seeds": {
+      "types": "./dist/seeds/index.d.ts",
+      "default": "./dist/seeds/index.js"
+    },
     "./scripts/verify-driver": "./scripts/verify-driver.mjs",
     "./workflow-support": {
       "types": "./dist/workflow-support.d.ts",