fix: align schemas with issue spec — rename TenantUsage fields, make tenantRegion optional, add seedData

- A1: Make tenantRegion optional per issue spec
- A2: Rename objectCount→currentObjectCount, totalRecords→currentRecordCount, storageBytes→currentStorageBytes
- C2: Add seedData[] to DeployBundleSchema
- C3: Add seedData[] to AppManifestSchema
- Update all related tests

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/spec/src/contracts/deploy-pipeline-service.test.ts

@@ -17,6 +17,7 @@ describe('Deploy Pipeline Service Contract', () => {
     views: [],
     flows: [],
     permissions: [],
+    seedData: [],
   };
 
   const samplePlan: MigrationPlan = {

packages/spec/src/kernel/context.test.ts

@@ -217,7 +217,6 @@ describe('TenantRuntimeContextSchema', () => {
     expect(() => TenantRuntimeContextSchema.parse({
       ...baseContext,
       tenantPlan: 'free',
-      tenantRegion: 'us-east',
       tenantDbUrl: 'libsql://test.turso.io',
     })).toThrow();
   });
@@ -227,7 +226,6 @@ describe('TenantRuntimeContextSchema', () => {
       ...baseContext,
       tenantId: '',
       tenantPlan: 'free',
-      tenantRegion: 'us-east',
       tenantDbUrl: 'libsql://test.turso.io',
     })).toThrow();
   });
@@ -237,7 +235,6 @@ describe('TenantRuntimeContextSchema', () => {
       ...baseContext,
       tenantId: 'tenant_test',
       tenantPlan: 'basic',
-      tenantRegion: 'us-east',
       tenantDbUrl: 'libsql://test.turso.io',
     })).toThrow();
   });
@@ -268,9 +265,9 @@ describe('TenantRuntimeContextSchema', () => {
       ...baseContext,
       tenantId: 'tenant_noquota',
       tenantPlan: 'free',
-      tenantRegion: 'us-east',
       tenantDbUrl: 'libsql://noquota.turso.io',
     });
     expect(parsed.tenantQuotas).toBeUndefined();
+    expect(parsed.tenantRegion).toBeUndefined();
   });
 });

packages/spec/src/kernel/context.zod.ts

@@ -153,7 +153,7 @@ export const TenantRuntimeContextSchema = KernelContextSchema.extend({
   tenantPlan: z.enum(['free', 'pro', 'enterprise']).describe('Tenant subscription plan'),
 
   /** Tenant deployment region */
-  tenantRegion: z.string().min(1).describe('Tenant deployment region'),
+  tenantRegion: z.string().optional().describe('Tenant deployment region'),
 
   /** Tenant database connection URL */
   tenantDbUrl: z.string().min(1).describe('Tenant database connection URL'),

packages/spec/src/system/app-install.test.ts

@@ -41,6 +41,7 @@ describe('AppManifestSchema', () => {
     expect(parsed.views).toEqual([]);
     expect(parsed.flows).toEqual([]);
     expect(parsed.hasSeedData).toBe(false);
+    expect(parsed.seedData).toEqual([]);
     expect(parsed.dependencies).toEqual([]);
   });
 

packages/spec/src/system/app-install.zod.ts

@@ -52,6 +52,9 @@ export const AppManifestSchema = z.object({
   /** Whether seed data is included */
   hasSeedData: z.boolean().default(false).describe('Whether app includes seed data'),
 
+  /** Seed data records to populate on install */
+  seedData: z.array(z.record(z.string(), z.unknown())).default([]).describe('Seed data records'),
+
   /** App dependencies (other apps that must be installed first) */
   dependencies: z.array(z.string()).default([]).describe('Required app dependencies'),
 }).describe('App manifest for marketplace installation');

packages/spec/src/system/deploy-bundle.test.ts

@@ -178,10 +178,12 @@ describe('DeployBundleSchema', () => {
       views: [{ name: 'task_list', type: 'grid' }],
       flows: [],
       permissions: [],
+      seedData: [{ object: 'task', records: [{ name: 'Sample Task' }] }],
     };
     const parsed = DeployBundleSchema.parse(bundle);
     expect(parsed.manifest.version).toBe('1.0.0');
     expect(parsed.objects).toHaveLength(1);
+    expect(parsed.seedData).toHaveLength(1);
   });
 
   it('should accept minimal bundle', () => {
@@ -193,6 +195,7 @@ describe('DeployBundleSchema', () => {
     expect(parsed.views).toEqual([]);
     expect(parsed.flows).toEqual([]);
     expect(parsed.permissions).toEqual([]);
+    expect(parsed.seedData).toEqual([]);
   });
 
   it('should reject missing manifest', () => {

packages/spec/src/system/deploy-bundle.zod.ts

@@ -219,6 +219,9 @@ export const DeployBundleSchema = z.object({
 
   /** Permission definitions */
   permissions: z.array(z.record(z.string(), z.unknown())).default([]).describe('Permission definitions'),
+
+  /** Seed data records to populate after schema migration */
+  seedData: z.array(z.record(z.string(), z.unknown())).default([]).describe('Seed data records'),
 }).describe('Deploy bundle containing all metadata for deployment');
 
 export type DeployBundle = z.infer<typeof DeployBundleSchema>;

packages/spec/src/system/tenant.test.ts

@@ -648,34 +648,34 @@ describe('TenantQuotaSchema (extended fields)', () => {
 describe('TenantUsageSchema', () => {
   it('should accept full usage tracking', () => {
     const usage: TenantUsage = {
-      objectCount: 15,
-      totalRecords: 50000,
-      storageBytes: 1073741824,
+      currentObjectCount: 15,
+      currentRecordCount: 50000,
+      currentStorageBytes: 1073741824,
       deploymentsToday: 3,
       currentUsers: 42,
       apiRequestsThisMinute: 120,
       lastUpdatedAt: '2026-01-15T10:30:00Z',
     };
     const parsed = TenantUsageSchema.parse(usage);
-    expect(parsed.objectCount).toBe(15);
-    expect(parsed.totalRecords).toBe(50000);
+    expect(parsed.currentObjectCount).toBe(15);
+    expect(parsed.currentRecordCount).toBe(50000);
     expect(parsed.deploymentsToday).toBe(3);
     expect(parsed.currentUsers).toBe(42);
     expect(parsed.apiRequestsThisMinute).toBe(120);
   });
 
   it('should apply zero defaults', () => {
     const parsed = TenantUsageSchema.parse({});
-    expect(parsed.objectCount).toBe(0);
-    expect(parsed.totalRecords).toBe(0);
-    expect(parsed.storageBytes).toBe(0);
+    expect(parsed.currentObjectCount).toBe(0);
+    expect(parsed.currentRecordCount).toBe(0);
+    expect(parsed.currentStorageBytes).toBe(0);
     expect(parsed.deploymentsToday).toBe(0);
     expect(parsed.currentUsers).toBe(0);
     expect(parsed.apiRequestsThisMinute).toBe(0);
   });
 
   it('should reject negative values', () => {
-    expect(() => TenantUsageSchema.parse({ objectCount: -1 })).toThrow();
+    expect(() => TenantUsageSchema.parse({ currentObjectCount: -1 })).toThrow();
     expect(() => TenantUsageSchema.parse({ currentUsers: -1 })).toThrow();
     expect(() => TenantUsageSchema.parse({ apiRequestsThisMinute: -1 })).toThrow();
   });

packages/spec/src/system/tenant.zod.ts

@@ -103,11 +103,11 @@ export type TenantQuota = z.infer<typeof TenantQuotaSchema>;
  */
 export const TenantUsageSchema = z.object({
   /** Current number of custom objects */
-  objectCount: z.number().int().min(0).default(0).describe('Current number of custom objects'),
+  currentObjectCount: z.number().int().min(0).default(0).describe('Current number of custom objects'),
   /** Current total record count across all objects */
-  totalRecords: z.number().int().min(0).default(0).describe('Total records across all objects'),
+  currentRecordCount: z.number().int().min(0).default(0).describe('Total records across all objects'),
   /** Current storage usage in bytes */
-  storageBytes: z.number().int().min(0).default(0).describe('Current storage usage in bytes'),
+  currentStorageBytes: z.number().int().min(0).default(0).describe('Current storage usage in bytes'),
   /** Deployments executed today */
   deploymentsToday: z.number().int().min(0).default(0).describe('Deployments executed today'),
   /** Current number of active users */