@treeseed/sdk 0.8.12 → 0.8.14

package/dist/model-registry.js

@@ -421,6 +421,44 @@ function buildBuiltinModelRegistry(repoRoot) {
       sortableFields: ["sent_at", "created_at"],
       pickField: "created_at"
     },
+    approval_request: {
+      name: "approval_request",
+      aliases: ["approval_requests", "approvals"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        team_id: field("team_id", { aliases: ["teamId"], filterable: true, dbColumns: ["team_id"], writeDbColumn: "team_id" }),
+        project_id: field("project_id", { aliases: ["projectId"], filterable: true, dbColumns: ["project_id"], writeDbColumn: "project_id" }),
+        work_day_id: field("work_day_id", { aliases: ["workDayId"], filterable: true, dbColumns: ["work_day_id"], writeDbColumn: "work_day_id" }),
+        task_id: field("task_id", { aliases: ["taskId"], filterable: true, dbColumns: ["task_id"], writeDbColumn: "task_id" }),
+        kind: field("kind", { filterable: true, dbColumns: ["kind"], writeDbColumn: "kind" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        severity: field("severity", { filterable: true, dbColumns: ["severity"], writeDbColumn: "severity" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
+      filterableFields: ["team_id", "project_id", "work_day_id", "task_id", "kind", "state", "severity", "created_at", "updated_at"],
+      sortableFields: ["created_at", "updated_at"],
+      pickField: "created_at"
+    },
+    team_inbox_item: {
+      name: "team_inbox_item",
+      aliases: ["team_inbox_items", "inbox_item", "inbox_items"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        team_id: field("team_id", { aliases: ["teamId"], filterable: true, dbColumns: ["team_id"], writeDbColumn: "team_id" }),
+        project_id: field("project_id", { aliases: ["projectId"], filterable: true, dbColumns: ["project_id"], writeDbColumn: "project_id" }),
+        kind: field("kind", { filterable: true, dbColumns: ["kind"], writeDbColumn: "kind" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        item_key: field("item_key", { aliases: ["itemKey"], filterable: true, dbColumns: ["item_key"], writeDbColumn: "item_key" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
+      filterableFields: ["team_id", "project_id", "kind", "state", "item_key", "created_at", "updated_at"],
+      sortableFields: ["created_at", "updated_at"],
+      pickField: "created_at"
+    },
     agent: {
       name: "agent",
       aliases: ["agents"],
@@ -497,6 +535,42 @@ function buildBuiltinModelRegistry(repoRoot) {
       filterableFields: ["model", "item_key", "claimed_by", "lease_expires_at"],
       sortableFields: ["lease_expires_at", "claimed_at"],
       pickField: "lease_expires_at"
+    },
+    workday_manager_lease: {
+      name: "workday_manager_lease",
+      aliases: ["workday_manager_leases", "manager_lease", "manager_leases"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        project_id: field("project_id", { aliases: ["projectId"], filterable: true, dbColumns: ["project_id"], writeDbColumn: "project_id" }),
+        environment: field("environment", { filterable: true, dbColumns: ["environment"], writeDbColumn: "environment" }),
+        work_day_id: field("work_day_id", { aliases: ["workDayId"], filterable: true, dbColumns: ["work_day_id"], writeDbColumn: "work_day_id" }),
+        manager_id: field("manager_id", { aliases: ["managerId"], filterable: true, dbColumns: ["manager_id"], writeDbColumn: "manager_id" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        heartbeat_at: field("heartbeat_at", { aliases: ["heartbeatAt"], sortable: true, comparableAs: "date", dbColumns: ["heartbeat_at"], writeDbColumn: "heartbeat_at" }),
+        expires_at: field("expires_at", { aliases: ["expiresAt"], sortable: true, comparableAs: "date", dbColumns: ["expires_at"], writeDbColumn: "expires_at" })
+      },
+      filterableFields: ["project_id", "environment", "work_day_id", "manager_id", "state"],
+      sortableFields: ["heartbeat_at", "expires_at"],
+      pickField: "heartbeat_at"
+    },
+    worker_runner: {
+      name: "worker_runner",
+      aliases: ["worker_runners", "runner", "runners"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        project_id: field("project_id", { aliases: ["projectId"], filterable: true, dbColumns: ["project_id"], writeDbColumn: "project_id" }),
+        environment: field("environment", { filterable: true, dbColumns: ["environment"], writeDbColumn: "environment" }),
+        runner_id: field("runner_id", { aliases: ["runnerId"], filterable: true, sortable: true, dbColumns: ["runner_id"], writeDbColumn: "runner_id" }),
+        runner_service_name: field("runner_service_name", { aliases: ["runnerServiceName"], filterable: true, dbColumns: ["runner_service_name"], writeDbColumn: "runner_service_name" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        available_capacity: field("available_capacity", { aliases: ["availableCapacity"], sortable: true, comparableAs: "number", dbColumns: ["available_capacity"], writeDbColumn: "available_capacity" }),
+        last_heartbeat_at: field("last_heartbeat_at", { aliases: ["lastHeartbeatAt"], sortable: true, comparableAs: "date", dbColumns: ["last_heartbeat_at"], writeDbColumn: "last_heartbeat_at" })
+      },
+      filterableFields: ["project_id", "environment", "runner_id", "runner_service_name", "state"],
+      sortableFields: ["runner_id", "available_capacity", "last_heartbeat_at"],
+      pickField: "last_heartbeat_at"
     }
   };
 }

package/dist/operations/providers/default.js

@@ -184,6 +184,11 @@ function workflowInputForOperation(name, input) {
       return {};
     case "dev:watch":
       return { ...input, watch: true };
+    case "dev:manager":
+      return {
+        ...input,
+        surfaces: input.withWorker === true ? "manager,worker" : typeof input.surfaces === "string" ? input.surfaces : "manager"
+      };
     default:
       return input;
   }
@@ -1071,6 +1076,7 @@ class DefaultTreeseedOperationsProvider {
       new WorkflowOperation("release"),
       new WorkflowOperation("destroy"),
       new WorkflowOperation("dev"),
+      new WorkflowOperation("dev:manager", "dev"),
       new WorkflowOperation("dev:watch", "dev"),
       new InitOperation("init"),
       new HubPlanLaunchOperation("hub.plan_launch"),

package/dist/operations/services/deploy.js

@@ -340,14 +340,14 @@ const LOCAL_RUNTIME_AUTH_ENV_KEYS = [
   "TREESEED_API_DEVICE_ACCESS_TOKEN_TTL",
   "TREESEED_API_DEVICE_POLL_INTERVAL",
   "TREESEED_API_WEB_EXCHANGE_TTL",
-  "TREESEED_GITHUB_CLIENT_ID",
-  "TREESEED_GITHUB_CLIENT_SECRET",
-  "TREESEED_GOOGLE_CLIENT_ID",
-  "TREESEED_GOOGLE_CLIENT_SECRET",
-  "TREESEED_MICROSOFT_CLIENT_ID",
-  "TREESEED_MICROSOFT_CLIENT_SECRET",
-  "TREESEED_APPLE_CLIENT_ID",
-  "TREESEED_APPLE_CLIENT_SECRET"
+  "TREESEED_AUTH_GITHUB_CLIENT_ID",
+  "TREESEED_AUTH_GITHUB_CLIENT_SECRET",
+  "TREESEED_AUTH_GOOGLE_CLIENT_ID",
+  "TREESEED_AUTH_GOOGLE_CLIENT_SECRET",
+  "TREESEED_AUTH_MICROSOFT_CLIENT_ID",
+  "TREESEED_AUTH_MICROSOFT_CLIENT_SECRET",
+  "TREESEED_AUTH_APPLE_CLIENT_ID",
+  "TREESEED_AUTH_APPLE_CLIENT_SECRET"
 ];
 function localAuthRuntimeVars(env) {
   return Object.fromEntries(

package/dist/operations-registry.js

@@ -52,6 +52,7 @@ const TRESEED_OPERATION_SPECS = [
   operation({ id: "deploy.release", name: "release", aliases: [], group: "Workflow", summary: "Release changed packages and market from staging to production.", description: "Select changed packages plus dependents, validate publish workflows, release packages first, then promote market from staging to main with aligned package pointers.", provider: "default", related: ["stage", "status", "rollback"] }),
   operation({ id: "deploy.destroy", name: "destroy", aliases: [], group: "Workflow", summary: "Destroy a persistent environment and its local state.", description: "Delete the selected persistent environment resources and remove the local deploy state after confirmation.", provider: "default", related: ["config", "status"] }),
   operation({ id: "local.dev", name: "dev", aliases: [], group: "Local Development", summary: "Start the unified local Treeseed development environment.", description: "Start the unified local Treeseed development environment.", provider: "default" }),
+  operation({ id: "local.devManager", name: "dev:manager", aliases: [], group: "Local Development", summary: "Start the governed local workday manager.", description: "Start the governed local documentation automation manager through the integrated dev supervisor.", provider: "default", related: ["dev"] }),
   operation({ id: "local.devWatch", name: "dev:watch", aliases: [], group: "Local Development", summary: "Start local development with rebuild and watch mode.", description: "Start local development with rebuild and watch mode.", provider: "default" }),
   operation({ id: "local.build", name: "build", aliases: [], group: "Local Development", summary: "Build the tenant site and generated worker artifacts.", description: "Build the tenant site and generated worker artifacts.", provider: "default" }),
   operation({ id: "local.check", name: "check", aliases: [], group: "Local Development", summary: "Run the tenant check flow.", description: "Run the tenant check flow.", provider: "default" }),

package/dist/scripts/tenant-d1-migrate-local.js

@@ -11,5 +11,6 @@ runLocalD1Migrations({
     cwd: tenantRoot,
     wranglerConfig,
     migrationsRoot,
+    persistTo: process.env.TREESEED_API_D1_LOCAL_PERSIST_TO?.trim() || undefined,
 });
 process.exit(0);

package/dist/sdk-types.d.ts

@@ -1,5 +1,5 @@
 import type { TreeseedFieldAliasBinding } from './field-aliases.ts';
-export declare const SDK_MODEL_NAMES: readonly ["page", "note", "question", "proposal", "decision", "book", "knowledge", "objective", "person", "subscription", "message", "agent", "agent_run", "agent_cursor", "content_lease", "work_day", "task", "task_event", "task_output", "graph_run", "report"];
+export declare const SDK_MODEL_NAMES: readonly ["page", "note", "question", "proposal", "decision", "book", "knowledge", "objective", "person", "subscription", "message", "agent", "agent_run", "agent_cursor", "content_lease", "work_day", "task", "task_event", "task_output", "graph_run", "report", "approval_request", "team_inbox_item", "workday_manager_lease", "worker_runner"];
 export declare const SDK_OPERATIONS: readonly ["get", "read", "search", "follow", "pick", "create", "update"];
 export declare const SDK_STORAGE_BACKENDS: readonly ["content", "d1"];
 export declare const SDK_PICK_STRATEGIES: readonly ["latest", "highest_priority", "oldest"];
@@ -328,7 +328,7 @@ export interface WorkdayManagerLease {
     createdAt: string;
     updatedAt: string;
 }
-export type WorkerRunnerState = 'active' | 'sleeping' | 'waking' | 'draining' | 'failed';
+export type WorkerRunnerState = 'active' | 'idle' | 'offline' | 'sleeping' | 'waking' | 'draining' | 'failed';
 export interface WorkerRunner {
     id: string;
     projectId: string;
@@ -411,7 +411,7 @@ export type CapacityOverflowPolicy = 'deny' | 'hard_grant' | 'soft_grant' | 'wei
 export type CapacityReservationState = 'reserved' | 'consuming' | 'consumed' | 'released' | 'expired' | 'cancelled' | 'failed' | 'overran_pending_approval';
 export type CapacityEstimatePhase = 'intent' | 'discovery' | 'plan' | 'execution' | 'actual';
 export type CapacityEstimateConfidence = 'low' | 'medium' | 'high';
-export type CapacityApprovalState = 'pending' | 'approved' | 'rejected' | 'expired' | 'superseded';
+export type CapacityApprovalState = 'pending' | 'approved' | 'changes_requested' | 'deferred' | 'rejected' | 'expired' | 'superseded';
 export type TaskRiskClass = 'low' | 'medium' | 'high';
 export type TaskMutationScope = 'none' | 'repository_read' | 'repository_write' | 'production';
 export type TaskConcurrencyClass = 'read_only' | 'repository_claim' | 'exclusive_project' | 'human_attention';
@@ -840,9 +840,36 @@ export interface ApprovalRequest {
     decidedById: string | null;
     decidedAt: string | null;
     decision: Record<string, unknown> | null;
+    metadata: Record<string, unknown>;
     createdAt: string;
     updatedAt: string;
 }
+export interface ListApprovalRequestsRequest {
+    projectId?: string | null;
+    teamId?: string | null;
+    state?: CapacityApprovalState | string | Array<CapacityApprovalState | string> | null;
+    limit?: number;
+}
+export interface DecideApprovalRequestRequest {
+    state: CapacityApprovalState | string;
+    optionId?: string | null;
+    note?: string | null;
+    decision?: Record<string, unknown> | null;
+    decidedByType?: string | null;
+    decidedById?: string | null;
+}
+export interface UpsertTeamInboxItemRequest {
+    id?: string;
+    teamId: string;
+    projectId?: string | null;
+    kind: string;
+    state: string;
+    title: string;
+    summary?: string | null;
+    href?: string | null;
+    itemKey?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
 export interface CapacityTaskExecutionEnvelope {
     providerId?: string | null;
     laneId?: string | null;

package/dist/sdk-types.js

@@ -19,7 +19,11 @@ const SDK_MODEL_NAMES = [
   "task_event",
   "task_output",
   "graph_run",
-  "report"
+  "report",
+  "approval_request",
+  "team_inbox_item",
+  "workday_manager_lease",
+  "worker_runner"
 ];
 const SDK_OPERATIONS = ["get", "read", "search", "follow", "pick", "create", "update"];
 const SDK_STORAGE_BACKENDS = ["content", "d1"];

package/dist/sdk.d.ts

@@ -3,7 +3,7 @@ import { ContentStore } from './content-store.ts';
 import { type AgentDatabase } from './d1-store.ts';
 import { type LoadedTreeseedPluginEntry } from './platform/plugins.ts';
 import type { ReleaseDetail, ReleaseSummary, SharePackageStatus, WorkstreamDetail, WorkstreamEvent, WorkstreamSummary } from './project-workflow.ts';
-import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreatePrioritySnapshotRequest, SdkCreateTaskRequest, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkJsonEnvelope, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMutationRequest, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkContextPackRequest, SdkGraphDslParseResult, SdkPickRequest, SdkPriorityOverrideRequest, SdkClaimWorkdayManagerLeaseRequest, SdkCreateWorkdayRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkRecordWorkerRunnerRequest, SdkRecordRunRequest, SdkRecordScaleDecisionRequest, SdkRecordTaskCreditsRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkSearchRequest, SdkStartWorkDayRequest, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateWorkDayGraphRequest, SdkUpdateRequest, SdkModelDefinition, SdkModelRegistry, SdkGraphRankingProvider, SdkDispatchConfig, SdkDispatchRequest, SdkDispatchResult, PrioritySnapshot, RepositoryClaim, RunnerScaleDecision, ScaleDecision, TaskCreditLedgerEntry, WorkdayManagerLease, WorkdayPolicy, WorkdayRequest, WorkerRunner } from './sdk-types.ts';
+import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, CreateApprovalRequestRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreatePrioritySnapshotRequest, SdkCreateTaskRequest, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkJsonEnvelope, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMutationRequest, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkContextPackRequest, SdkGraphDslParseResult, SdkPickRequest, SdkPriorityOverrideRequest, SdkClaimWorkdayManagerLeaseRequest, SdkCreateWorkdayRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkRecordWorkerRunnerRequest, SdkRecordRunRequest, SdkRecordScaleDecisionRequest, SdkRecordTaskCreditsRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkSearchRequest, SdkStartWorkDayRequest, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateWorkDayGraphRequest, SdkUpdateRequest, SdkModelDefinition, SdkModelRegistry, SdkGraphRankingProvider, SdkDispatchConfig, SdkDispatchRequest, SdkDispatchResult, DecideApprovalRequestRequest, ListApprovalRequestsRequest, PrioritySnapshot, RepositoryClaim, RunnerScaleDecision, ScaleDecision, TaskCreditLedgerEntry, WorkdayManagerLease, WorkdayPolicy, WorkdayRequest, WorkerRunner, UpsertTeamInboxItemRequest } from './sdk-types.ts';
 export interface AgentSdkOptions {
     repoRoot?: string;
     database?: AgentDatabase;
@@ -92,6 +92,7 @@ export declare class AgentSdk {
     listWorkdayRequests(projectId: string, environment: string, state?: string | null): Promise<SdkJsonEnvelope<WorkdayRequest[]>>;
     claimWorkdayManagerLease(request: SdkClaimWorkdayManagerLeaseRequest): Promise<SdkJsonEnvelope<WorkdayManagerLease>>;
     releaseWorkdayManagerLease(request: SdkReleaseWorkdayManagerLeaseRequest): Promise<SdkJsonEnvelope<WorkdayManagerLease>>;
+    listWorkdayManagerLeases(projectId: string, environment: string): Promise<SdkJsonEnvelope<WorkdayManagerLease[]>>;
     recordWorkerRunner(request: SdkRecordWorkerRunnerRequest): Promise<SdkJsonEnvelope<WorkerRunner>>;
     listWorkerRunners(projectId: string, environment: string): Promise<SdkJsonEnvelope<WorkerRunner[]>>;
     recordRepositoryClaim(request: SdkRecordRepositoryClaimRequest): Promise<SdkJsonEnvelope<RepositoryClaim>>;
@@ -107,6 +108,10 @@ export declare class AgentSdk {
     listTaskCredits(workDayId: string): Promise<SdkJsonEnvelope<TaskCreditLedgerEntry[]>>;
     recordScaleDecision(request: SdkRecordScaleDecisionRequest): Promise<SdkJsonEnvelope<ScaleDecision>>;
     getLatestScaleDecision(projectId: string, environment: string, poolName: string): Promise<SdkJsonEnvelope<ScaleDecision>>;
+    createApprovalRequest(request: CreateApprovalRequestRequest): Promise<SdkJsonEnvelope<import("./sdk-types.ts").ApprovalRequest | null>>;
+    listApprovalRequests(request?: ListApprovalRequestsRequest): Promise<SdkJsonEnvelope<import("./sdk-types.ts").ApprovalRequest[]>>;
+    decideApprovalRequest(id: string, request: DecideApprovalRequestRequest): Promise<SdkJsonEnvelope<import("./sdk-types.ts").ApprovalRequest | null>>;
+    upsertTeamInboxItem(request: UpsertTeamInboxItemRequest): Promise<SdkJsonEnvelope<import("./project-workflow.ts").InboxItem | null>>;
     listWorkstreams(projectId: string): Promise<SdkJsonEnvelope<WorkstreamSummary[]>>;
     getWorkstream(workstreamId: string): Promise<SdkJsonEnvelope<WorkstreamDetail>>;
     upsertWorkstream(input: Partial<WorkstreamSummary> & Pick<WorkstreamSummary, 'projectId' | 'title'>): Promise<SdkJsonEnvelope<WorkstreamSummary>>;

package/dist/sdk.js

@@ -281,6 +281,10 @@ class AgentSdk {
     const payload = await this.database.releaseWorkdayManagerLease(request);
     return this.envelope("workday_manager_lease", "release", payload);
   }
+  async listWorkdayManagerLeases(projectId, environment) {
+    const payload = await this.database.listWorkdayManagerLeases(projectId, environment);
+    return this.envelope("workday_manager_lease", "search", payload, { count: payload.length });
+  }
   async recordWorkerRunner(request) {
     const payload = await this.database.recordWorkerRunner(request);
     return this.envelope("worker_runner", "update", payload);
@@ -341,6 +345,22 @@ class AgentSdk {
     const payload = await this.database.getLatestScaleDecision(projectId, environment, poolName);
     return this.envelope("report", "get", payload);
   }
+  async createApprovalRequest(request) {
+    const payload = await this.database.createApprovalRequest(request);
+    return this.envelope("approval_request", "create", payload);
+  }
+  async listApprovalRequests(request = {}) {
+    const payload = await this.database.listApprovalRequests(request);
+    return this.envelope("approval_request", "search", payload, { count: payload.length });
+  }
+  async decideApprovalRequest(id, request) {
+    const payload = await this.database.decideApprovalRequest(id, request);
+    return this.envelope("approval_request", "update", payload);
+  }
+  async upsertTeamInboxItem(request) {
+    const payload = await this.database.upsertTeamInboxItem(request);
+    return this.envelope("team_inbox_item", "update", payload);
+  }
   async listWorkstreams(projectId) {
     const payload = await this.database.listWorkstreams(projectId);
     return this.envelope("task", "search", payload, { count: payload.length });

package/dist/seeds/errors.d.ts

@@ -0,0 +1,5 @@
+import type { SeedDiagnostic } from './types.js';
+export declare function errorDiagnostic(code: string, message: string, path?: string): SeedDiagnostic;
+export declare function warningDiagnostic(code: string, message: string, path?: string): SeedDiagnostic;
+export declare function hasSeedErrors(diagnostics: SeedDiagnostic[]): boolean;
+export declare function formatSeedDiagnostics(diagnostics: SeedDiagnostic[]): string[];

package/dist/seeds/errors.js

@@ -0,0 +1,22 @@
+function errorDiagnostic(code, message, path) {
+  return { severity: "error", code, message, path };
+}
+function warningDiagnostic(code, message, path) {
+  return { severity: "warning", code, message, path };
+}
+function hasSeedErrors(diagnostics) {
+  return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+}
+function formatSeedDiagnostics(diagnostics) {
+  return diagnostics.map((diagnostic) => {
+    const prefix = diagnostic.severity === "error" ? "ERROR" : "WARN";
+    const location = diagnostic.path ? ` ${diagnostic.path}` : "";
+    return `${prefix} ${diagnostic.code}${location}: ${diagnostic.message}`;
+  });
+}
+export {
+  errorDiagnostic,
+  formatSeedDiagnostics,
+  hasSeedErrors,
+  warningDiagnostic
+};

package/dist/seeds/index.d.ts

@@ -0,0 +1,20 @@
+import type { SeedPlan } from './types.js';
+export { formatSeedDiagnostics, hasSeedErrors } from './errors.js';
+export { formatSeedPlan } from './planner.js';
+export type * from './types.js';
+export declare function loadAndPlanSeed(input: {
+    projectRoot: string;
+    seedName: string;
+    environments?: string;
+    mode: SeedPlan['mode'];
+}): {
+    ok: boolean;
+    plan: null;
+    diagnostics: import("./types.js").SeedDiagnostic[];
+    manifestPath: string;
+} | {
+    ok: boolean;
+    plan: SeedPlan;
+    diagnostics: import("./types.js").SeedDiagnostic[];
+    manifestPath: string;
+};

package/dist/seeds/index.js

@@ -0,0 +1,53 @@
+import { errorDiagnostic, hasSeedErrors } from "./errors.js";
+import { loadSeedManifest } from "./loader.js";
+import { resolveSelectedSeedEnvironments } from "./normalize.js";
+import { createSeedPlan } from "./planner.js";
+import { parseSeedManifest } from "./schema.js";
+import { formatSeedDiagnostics, hasSeedErrors as hasSeedErrors2 } from "./errors.js";
+import { formatSeedPlan } from "./planner.js";
+function loadAndPlanSeed(input) {
+  const loaded = loadSeedManifest(input.projectRoot, input.seedName);
+  const diagnostics = [...loaded.diagnostics];
+  const manifest = parseSeedManifest(loaded.value, diagnostics);
+  if (!manifest) {
+    return {
+      ok: false,
+      plan: null,
+      diagnostics,
+      manifestPath: loaded.path
+    };
+  }
+  if (manifest.name !== input.seedName) {
+    diagnostics.push(errorDiagnostic("seed.name_mismatch", `Manifest name ${manifest.name} does not match requested seed ${input.seedName}.`, "name"));
+  }
+  const selected = resolveSelectedSeedEnvironments(manifest, input.environments);
+  for (const message of selected.errors) {
+    diagnostics.push(errorDiagnostic("seed.environment_selection", message, "environments"));
+  }
+  if (hasSeedErrors(diagnostics)) {
+    return {
+      ok: false,
+      plan: null,
+      diagnostics,
+      manifestPath: loaded.path
+    };
+  }
+  return {
+    ok: true,
+    plan: createSeedPlan({
+      manifest,
+      manifestPath: loaded.path,
+      environments: selected.environments,
+      mode: input.mode,
+      diagnostics
+    }),
+    diagnostics,
+    manifestPath: loaded.path
+  };
+}
+export {
+  formatSeedDiagnostics,
+  formatSeedPlan,
+  hasSeedErrors2 as hasSeedErrors,
+  loadAndPlanSeed
+};

package/dist/seeds/loader.d.ts

@@ -0,0 +1,8 @@
+import type { SeedDiagnostic } from './types.js';
+export type LoadedSeedDocument = {
+    path: string;
+    value: unknown;
+    diagnostics: SeedDiagnostic[];
+};
+export declare function resolveSeedManifestPath(projectRoot: string, seedName: string): string;
+export declare function loadSeedManifest(projectRoot: string, seedName: string): LoadedSeedDocument;

package/dist/seeds/loader.js

@@ -0,0 +1,32 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parseDocument } from "yaml";
+import { errorDiagnostic } from "./errors.js";
+function resolveSeedManifestPath(projectRoot, seedName) {
+  return resolve(projectRoot, "seeds", `${seedName}.yaml`);
+}
+function loadSeedManifest(projectRoot, seedName) {
+  const path = resolveSeedManifestPath(projectRoot, seedName);
+  const diagnostics = [];
+  if (!/^[a-z0-9][a-z0-9._-]*$/u.test(seedName)) {
+    diagnostics.push(errorDiagnostic("seed.invalid_name", `Seed name must be a simple file-safe identifier: ${seedName}.`, "name"));
+    return { path, value: null, diagnostics };
+  }
+  if (!existsSync(path)) {
+    diagnostics.push(errorDiagnostic("seed.not_found", `Seed manifest not found at ${path}.`, "manifest"));
+    return { path, value: null, diagnostics };
+  }
+  const source = readFileSync(path, "utf8");
+  const document = parseDocument(source, { prettyErrors: false });
+  for (const parseError of document.errors) {
+    diagnostics.push(errorDiagnostic("seed.yaml_parse_error", parseError.message, "manifest"));
+  }
+  if (diagnostics.length > 0) {
+    return { path, value: null, diagnostics };
+  }
+  return { path, value: document.toJSON(), diagnostics };
+}
+export {
+  loadSeedManifest,
+  resolveSeedManifestPath
+};

package/dist/seeds/normalize.d.ts

@@ -0,0 +1,13 @@
+import type { NormalizedSeedResource, SeedEnvironment, SeedManifest } from './types.js';
+export declare function seedOwnershipMetadata(seed: SeedManifest, resourceKey: string): {
+    seed: {
+        name: string;
+        resourceKey: string;
+        version: 1;
+    };
+};
+export declare function normalizeSeedResources(manifest: SeedManifest, selected: SeedEnvironment[]): NormalizedSeedResource[];
+export declare function resolveSelectedSeedEnvironments(manifest: SeedManifest, requested: string | undefined): {
+    environments: SeedEnvironment[];
+    errors: string[];
+};