@loxtep/sdk 0.8.0 → 0.9.0

package/dist/client/project-workspace-status-types.d.ts

@@ -0,0 +1,644 @@
+/**
+ * Three-layer project / workspace status payload.
+ *
+ * Stable snake_case contract for:
+ * - CLI: `loxtep status`, enriched `loxtep projects list|get`
+ * - MCP: `get_project_workspace_status` (planned)
+ *
+ * Layers:
+ * - **local** — CWD / known-locals + `.loxtep/project.json`
+ * - **cloud** — org project + Studio/S3 workspace
+ * - **deployed** — instance bindings after `deploy`
+ *
+ * Unpublished = deltas Local→Cloud and Cloud→Deployed (not a vague draft flag).
+ *
+ * Cost guidance: see {@link PROJECT_WORKSPACE_STATUS_FIELD_COST} and
+ * `docs/project-workspace-status.md`. Prefer `population_depth: "summary"` when
+ * enriching list rows so list stays snappy.
+ */
+import { z } from 'zod';
+/** How deeply the producer filled the payload. */
+export declare const StatusPopulationDepthSchema: z.ZodEnum<{
+    status: "status";
+    summary: "summary";
+    unpublished: "unpublished";
+}>;
+export type StatusPopulationDepth = z.infer<typeof StatusPopulationDepthSchema>;
+/** Relative cost to populate a field or nested group. */
+export declare const PopulationCostSchema: z.ZodEnum<{
+    cheap: "cheap";
+    moderate: "moderate";
+    expensive: "expensive";
+}>;
+export type PopulationCost = z.infer<typeof PopulationCostSchema>;
+/** GitHub Project_Repository binding for status surfaces. */
+export declare const GithubLinkStateSchema: z.ZodEnum<{
+    linked: "linked";
+    unbound: "unbound";
+}>;
+export type GithubLinkState = z.infer<typeof GithubLinkStateSchema>;
+/** Whether `.loxtep/project.json` has instance_id + api_url (loxtep attach). */
+export declare const AttachStateSchema: z.ZodEnum<{
+    unattached: "unattached";
+    attached: "attached";
+}>;
+export type AttachState = z.infer<typeof AttachStateSchema>;
+/**
+ * Deployed-layer badge.
+ * - `never_deployed` — no successful deployment known
+ * - `deployed` — cloud revision matches (or considered current) deployed runtime
+ * - `stale` — cloud ahead of deployed (Cloud→Deployed dirty)
+ * - `unknown` — not computed / API unavailable (do not invent success)
+ */
+export declare const DeployedLayerStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    deployed: "deployed";
+    never_deployed: "never_deployed";
+    stale: "stale";
+}>;
+export type DeployedLayerState = z.infer<typeof DeployedLayerStateSchema>;
+/**
+ * Suggested next CLI/MCP action for humans and agents.
+ * Distinct from runtime `observe status`.
+ */
+export declare const NextActionHintSchema: z.ZodEnum<{
+    push: "push";
+    link: "link";
+    none: "none";
+    init: "init";
+    attach: "attach";
+    clone: "clone";
+    deploy: "deploy";
+}>;
+export type NextActionHint = z.infer<typeof NextActionHintSchema>;
+/** Presence of a layer when the producer probed it. */
+export declare const LayerPresenceSchema: z.ZodEnum<{
+    unknown: "unknown";
+    present: "present";
+    absent: "absent";
+}>;
+export type LayerPresence = z.infer<typeof LayerPresenceSchema>;
+export declare const LocalWorkspaceLayerSchema: z.ZodObject<{
+    presence: z.ZodEnum<{
+        unknown: "unknown";
+        present: "present";
+        absent: "absent";
+    }>;
+    path: z.ZodNullable<z.ZodString>;
+    project_file: z.ZodNullable<z.ZodString>;
+    known_local: z.ZodBoolean;
+    attach_state: z.ZodEnum<{
+        unattached: "unattached";
+        attached: "attached";
+    }>;
+    instance_id: z.ZodNullable<z.ZodString>;
+    api_url: z.ZodNullable<z.ZodString>;
+    project_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type LocalWorkspaceLayer = z.infer<typeof LocalWorkspaceLayerSchema>;
+export declare const GithubStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        linked: "linked";
+        unbound: "unbound";
+    }>;
+    url: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    branch: z.ZodNullable<z.ZodString>;
+    last_sync_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type GithubStatus = z.infer<typeof GithubStatusSchema>;
+export declare const CloudProjectLayerSchema: z.ZodObject<{
+    presence: z.ZodEnum<{
+        unknown: "unknown";
+        present: "present";
+        absent: "absent";
+    }>;
+    project_id: z.ZodNullable<z.ZodString>;
+    organization_id: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    github: z.ZodObject<{
+        state: z.ZodEnum<{
+            linked: "linked";
+            unbound: "unbound";
+        }>;
+        url: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        last_sync_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    workspace_revision: z.ZodNullable<z.ZodString>;
+    workspace_updated_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CloudProjectLayer = z.infer<typeof CloudProjectLayerSchema>;
+export declare const DeployedRuntimeLayerSchema: z.ZodObject<{
+    presence: z.ZodEnum<{
+        unknown: "unknown";
+        present: "present";
+        absent: "absent";
+    }>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        deployed: "deployed";
+        never_deployed: "never_deployed";
+        stale: "stale";
+    }>;
+    instance_id: z.ZodNullable<z.ZodString>;
+    deployment_id: z.ZodNullable<z.ZodString>;
+    deployment_status: z.ZodNullable<z.ZodString>;
+    last_deployed_at: z.ZodNullable<z.ZodString>;
+    age_seconds: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeployedRuntimeLayer = z.infer<typeof DeployedRuntimeLayerSchema>;
+/** Entity kinds in the push/deploy package inventory. */
+export declare const UnpublishedEntityKindSchema: z.ZodEnum<{
+    connection: "connection";
+    schema: "schema";
+    data_product: "data_product";
+    transformation: "transformation";
+    workflow: "workflow";
+    validation: "validation";
+    module: "module";
+}>;
+export type UnpublishedEntityKind = z.infer<typeof UnpublishedEntityKindSchema>;
+/** How a package path differs across a layer boundary. */
+export declare const UnpublishedChangeKindSchema: z.ZodEnum<{
+    added: "added";
+    modified: "modified";
+    removed: "removed";
+    pending_push: "pending_push";
+    pending_deploy: "pending_deploy";
+    cloud_only: "cloud_only";
+}>;
+export type UnpublishedChangeKind = z.infer<typeof UnpublishedChangeKindSchema>;
+/** One actionable file/entity in an unpublished inventory. */
+export declare const UnpublishedChangeItemSchema: z.ZodObject<{
+    path: z.ZodString;
+    entity_kind: z.ZodEnum<{
+        connection: "connection";
+        schema: "schema";
+        data_product: "data_product";
+        transformation: "transformation";
+        workflow: "workflow";
+        validation: "validation";
+        module: "module";
+    }>;
+    change: z.ZodEnum<{
+        added: "added";
+        modified: "modified";
+        removed: "removed";
+        pending_push: "pending_push";
+        pending_deploy: "pending_deploy";
+        cloud_only: "cloud_only";
+    }>;
+    workflow_id: z.ZodNullable<z.ZodString>;
+    content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type UnpublishedChangeItem = z.infer<typeof UnpublishedChangeItemSchema>;
+/**
+ * One unpublished delta axis.
+ * `dirty: null` means "not computed at this population_depth" — not "clean".
+ */
+export declare const UnpublishedDeltaSchema: z.ZodObject<{
+    dirty: z.ZodNullable<z.ZodBoolean>;
+    summary: z.ZodNullable<z.ZodString>;
+    changed_count: z.ZodNullable<z.ZodNumber>;
+    changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        entity_kind: z.ZodEnum<{
+            connection: "connection";
+            schema: "schema";
+            data_product: "data_product";
+            transformation: "transformation";
+            workflow: "workflow";
+            validation: "validation";
+            module: "module";
+        }>;
+        change: z.ZodEnum<{
+            added: "added";
+            modified: "modified";
+            removed: "removed";
+            pending_push: "pending_push";
+            pending_deploy: "pending_deploy";
+            cloud_only: "cloud_only";
+        }>;
+        workflow_id: z.ZodNullable<z.ZodString>;
+        content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type UnpublishedDelta = z.infer<typeof UnpublishedDeltaSchema>;
+export declare const UnpublishedStatusSchema: z.ZodObject<{
+    local_to_cloud: z.ZodObject<{
+        dirty: z.ZodNullable<z.ZodBoolean>;
+        summary: z.ZodNullable<z.ZodString>;
+        changed_count: z.ZodNullable<z.ZodNumber>;
+        changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            entity_kind: z.ZodEnum<{
+                connection: "connection";
+                schema: "schema";
+                data_product: "data_product";
+                transformation: "transformation";
+                workflow: "workflow";
+                validation: "validation";
+                module: "module";
+            }>;
+            change: z.ZodEnum<{
+                added: "added";
+                modified: "modified";
+                removed: "removed";
+                pending_push: "pending_push";
+                pending_deploy: "pending_deploy";
+                cloud_only: "cloud_only";
+            }>;
+            workflow_id: z.ZodNullable<z.ZodString>;
+            content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    cloud_to_deployed: z.ZodObject<{
+        dirty: z.ZodNullable<z.ZodBoolean>;
+        summary: z.ZodNullable<z.ZodString>;
+        changed_count: z.ZodNullable<z.ZodNumber>;
+        changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            entity_kind: z.ZodEnum<{
+                connection: "connection";
+                schema: "schema";
+                data_product: "data_product";
+                transformation: "transformation";
+                workflow: "workflow";
+                validation: "validation";
+                module: "module";
+            }>;
+            change: z.ZodEnum<{
+                added: "added";
+                modified: "modified";
+                removed: "removed";
+                pending_push: "pending_push";
+                pending_deploy: "pending_deploy";
+                cloud_only: "cloud_only";
+            }>;
+            workflow_id: z.ZodNullable<z.ZodString>;
+            content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UnpublishedStatus = z.infer<typeof UnpublishedStatusSchema>;
+/**
+ * Full three-layer status. MCP `get_project_workspace_status` and CLI `status`
+ * should return this shape (optionally wrapped in `{ success, data }`).
+ */
+export declare const ProjectWorkspaceStatusSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    population_depth: z.ZodEnum<{
+        status: "status";
+        summary: "summary";
+        unpublished: "unpublished";
+    }>;
+    project_id: z.ZodNullable<z.ZodString>;
+    display_name: z.ZodNullable<z.ZodString>;
+    local: z.ZodObject<{
+        presence: z.ZodEnum<{
+            unknown: "unknown";
+            present: "present";
+            absent: "absent";
+        }>;
+        path: z.ZodNullable<z.ZodString>;
+        project_file: z.ZodNullable<z.ZodString>;
+        known_local: z.ZodBoolean;
+        attach_state: z.ZodEnum<{
+            unattached: "unattached";
+            attached: "attached";
+        }>;
+        instance_id: z.ZodNullable<z.ZodString>;
+        api_url: z.ZodNullable<z.ZodString>;
+        project_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    cloud: z.ZodObject<{
+        presence: z.ZodEnum<{
+            unknown: "unknown";
+            present: "present";
+            absent: "absent";
+        }>;
+        project_id: z.ZodNullable<z.ZodString>;
+        organization_id: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+        github: z.ZodObject<{
+            state: z.ZodEnum<{
+                linked: "linked";
+                unbound: "unbound";
+            }>;
+            url: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            last_sync_at: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        workspace_revision: z.ZodNullable<z.ZodString>;
+        workspace_updated_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    deployed: z.ZodObject<{
+        presence: z.ZodEnum<{
+            unknown: "unknown";
+            present: "present";
+            absent: "absent";
+        }>;
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            deployed: "deployed";
+            never_deployed: "never_deployed";
+            stale: "stale";
+        }>;
+        instance_id: z.ZodNullable<z.ZodString>;
+        deployment_id: z.ZodNullable<z.ZodString>;
+        deployment_status: z.ZodNullable<z.ZodString>;
+        last_deployed_at: z.ZodNullable<z.ZodString>;
+        age_seconds: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    unpublished: z.ZodObject<{
+        local_to_cloud: z.ZodObject<{
+            dirty: z.ZodNullable<z.ZodBoolean>;
+            summary: z.ZodNullable<z.ZodString>;
+            changed_count: z.ZodNullable<z.ZodNumber>;
+            changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                entity_kind: z.ZodEnum<{
+                    connection: "connection";
+                    schema: "schema";
+                    data_product: "data_product";
+                    transformation: "transformation";
+                    workflow: "workflow";
+                    validation: "validation";
+                    module: "module";
+                }>;
+                change: z.ZodEnum<{
+                    added: "added";
+                    modified: "modified";
+                    removed: "removed";
+                    pending_push: "pending_push";
+                    pending_deploy: "pending_deploy";
+                    cloud_only: "cloud_only";
+                }>;
+                workflow_id: z.ZodNullable<z.ZodString>;
+                content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        cloud_to_deployed: z.ZodObject<{
+            dirty: z.ZodNullable<z.ZodBoolean>;
+            summary: z.ZodNullable<z.ZodString>;
+            changed_count: z.ZodNullable<z.ZodNumber>;
+            changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                entity_kind: z.ZodEnum<{
+                    connection: "connection";
+                    schema: "schema";
+                    data_product: "data_product";
+                    transformation: "transformation";
+                    workflow: "workflow";
+                    validation: "validation";
+                    module: "module";
+                }>;
+                change: z.ZodEnum<{
+                    added: "added";
+                    modified: "modified";
+                    removed: "removed";
+                    pending_push: "pending_push";
+                    pending_deploy: "pending_deploy";
+                    cloud_only: "cloud_only";
+                }>;
+                workflow_id: z.ZodNullable<z.ZodString>;
+                content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    next_action: z.ZodEnum<{
+        push: "push";
+        link: "link";
+        none: "none";
+        init: "init";
+        attach: "attach";
+        clone: "clone";
+        deploy: "deploy";
+    }>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ProjectWorkspaceStatus = z.infer<typeof ProjectWorkspaceStatusSchema>;
+/**
+ * Lean enrichment for `projects list` / MCP `list_projects` rows.
+ * All fields beyond identity are optional so producers can omit expensive ones.
+ */
+export declare const ProjectListStatusEnrichmentSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    local_present: z.ZodOptional<z.ZodBoolean>;
+    local_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attach_state: z.ZodOptional<z.ZodEnum<{
+        unattached: "unattached";
+        attached: "attached";
+    }>>;
+    github_state: z.ZodOptional<z.ZodEnum<{
+        linked: "linked";
+        unbound: "unbound";
+    }>>;
+    deployed_state: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        deployed: "deployed";
+        never_deployed: "never_deployed";
+        stale: "stale";
+    }>>;
+    local_to_cloud_dirty: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    cloud_to_deployed_dirty: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ProjectListStatusEnrichment = z.infer<typeof ProjectListStatusEnrichmentSchema>;
+/** MCP / REST envelope helpers (match SDK successResponse patterns). */
+export declare const ProjectWorkspaceStatusResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        population_depth: z.ZodEnum<{
+            status: "status";
+            summary: "summary";
+            unpublished: "unpublished";
+        }>;
+        project_id: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        local: z.ZodObject<{
+            presence: z.ZodEnum<{
+                unknown: "unknown";
+                present: "present";
+                absent: "absent";
+            }>;
+            path: z.ZodNullable<z.ZodString>;
+            project_file: z.ZodNullable<z.ZodString>;
+            known_local: z.ZodBoolean;
+            attach_state: z.ZodEnum<{
+                unattached: "unattached";
+                attached: "attached";
+            }>;
+            instance_id: z.ZodNullable<z.ZodString>;
+            api_url: z.ZodNullable<z.ZodString>;
+            project_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        cloud: z.ZodObject<{
+            presence: z.ZodEnum<{
+                unknown: "unknown";
+                present: "present";
+                absent: "absent";
+            }>;
+            project_id: z.ZodNullable<z.ZodString>;
+            organization_id: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+            github: z.ZodObject<{
+                state: z.ZodEnum<{
+                    linked: "linked";
+                    unbound: "unbound";
+                }>;
+                url: z.ZodNullable<z.ZodString>;
+                name: z.ZodNullable<z.ZodString>;
+                branch: z.ZodNullable<z.ZodString>;
+                last_sync_at: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            workspace_revision: z.ZodNullable<z.ZodString>;
+            workspace_updated_at: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        deployed: z.ZodObject<{
+            presence: z.ZodEnum<{
+                unknown: "unknown";
+                present: "present";
+                absent: "absent";
+            }>;
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                deployed: "deployed";
+                never_deployed: "never_deployed";
+                stale: "stale";
+            }>;
+            instance_id: z.ZodNullable<z.ZodString>;
+            deployment_id: z.ZodNullable<z.ZodString>;
+            deployment_status: z.ZodNullable<z.ZodString>;
+            last_deployed_at: z.ZodNullable<z.ZodString>;
+            age_seconds: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        unpublished: z.ZodObject<{
+            local_to_cloud: z.ZodObject<{
+                dirty: z.ZodNullable<z.ZodBoolean>;
+                summary: z.ZodNullable<z.ZodString>;
+                changed_count: z.ZodNullable<z.ZodNumber>;
+                changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    entity_kind: z.ZodEnum<{
+                        connection: "connection";
+                        schema: "schema";
+                        data_product: "data_product";
+                        transformation: "transformation";
+                        workflow: "workflow";
+                        validation: "validation";
+                        module: "module";
+                    }>;
+                    change: z.ZodEnum<{
+                        added: "added";
+                        modified: "modified";
+                        removed: "removed";
+                        pending_push: "pending_push";
+                        pending_deploy: "pending_deploy";
+                        cloud_only: "cloud_only";
+                    }>;
+                    workflow_id: z.ZodNullable<z.ZodString>;
+                    content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+            cloud_to_deployed: z.ZodObject<{
+                dirty: z.ZodNullable<z.ZodBoolean>;
+                summary: z.ZodNullable<z.ZodString>;
+                changed_count: z.ZodNullable<z.ZodNumber>;
+                changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    entity_kind: z.ZodEnum<{
+                        connection: "connection";
+                        schema: "schema";
+                        data_product: "data_product";
+                        transformation: "transformation";
+                        workflow: "workflow";
+                        validation: "validation";
+                        module: "module";
+                    }>;
+                    change: z.ZodEnum<{
+                        added: "added";
+                        modified: "modified";
+                        removed: "removed";
+                        pending_push: "pending_push";
+                        pending_deploy: "pending_deploy";
+                        cloud_only: "cloud_only";
+                    }>;
+                    workflow_id: z.ZodNullable<z.ZodString>;
+                    content_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        next_action: z.ZodEnum<{
+            push: "push";
+            link: "link";
+            none: "none";
+            init: "init";
+            attach: "attach";
+            clone: "clone";
+            deploy: "deploy";
+        }>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ProjectWorkspaceStatusResponse = z.infer<typeof ProjectWorkspaceStatusResponseSchema>;
+/**
+ * Cost of filling fields so list enrichment can stay snappy.
+ *
+ * - **cheap** — OK per list row (disk + columns already on project list row)
+ * - **moderate** — OK for status/get (one extra call or small join)
+ * - **expensive** — only for `--unpublished` / depth `unpublished`
+ */
+export declare const PROJECT_WORKSPACE_STATUS_FIELD_COST: {
+    readonly 'local.presence': "cheap";
+    readonly 'local.path': "cheap";
+    readonly 'local.project_file': "cheap";
+    readonly 'local.known_local': "cheap";
+    readonly 'local.attach_state': "cheap";
+    readonly 'local.instance_id': "cheap";
+    readonly 'local.api_url': "cheap";
+    readonly 'local.project_id': "cheap";
+    readonly 'cloud.presence': "cheap";
+    readonly 'cloud.project_id': "cheap";
+    readonly 'cloud.organization_id': "cheap";
+    readonly 'cloud.name': "cheap";
+    readonly 'cloud.status': "cheap";
+    readonly 'cloud.github': "cheap";
+    readonly 'cloud.workspace_revision': "moderate";
+    readonly 'cloud.workspace_updated_at': "moderate";
+    readonly 'deployed.presence': "moderate";
+    readonly 'deployed.state': "moderate";
+    readonly 'deployed.instance_id': "moderate";
+    readonly 'deployed.deployment_id': "moderate";
+    readonly 'deployed.deployment_status': "moderate";
+    readonly 'deployed.last_deployed_at': "moderate";
+    readonly 'deployed.age_seconds': "cheap";
+    readonly 'unpublished.local_to_cloud.dirty': "moderate";
+    readonly 'unpublished.local_to_cloud.summary': "moderate";
+    readonly 'unpublished.local_to_cloud.changed_count': "expensive";
+    readonly 'unpublished.local_to_cloud.changes': "expensive";
+    readonly 'unpublished.cloud_to_deployed.dirty': "moderate";
+    readonly 'unpublished.cloud_to_deployed.summary': "moderate";
+    readonly 'unpublished.cloud_to_deployed.changed_count': "expensive";
+    readonly 'unpublished.cloud_to_deployed.changes': "expensive";
+    readonly next_action: "cheap";
+    readonly notes: "cheap";
+};
+export type ProjectWorkspaceStatusFieldPath = keyof typeof PROJECT_WORKSPACE_STATUS_FIELD_COST;
+/**
+ * Depth → allowed cost ceiling. Producers SHOULD omit or set null for fields
+ * above the ceiling rather than blocking on expensive work.
+ */
+export declare const STATUS_POPULATION_DEPTH_COST_CEILING: {
+    readonly summary: "cheap";
+    readonly status: "moderate";
+    readonly unpublished: "expensive";
+};
+//# sourceMappingURL=project-workspace-status-types.d.ts.map

package/dist/client/project-workspace-status-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-workspace-status-types.d.ts","sourceRoot":"","sources":["../../src/client/project-workspace-status-types.ts"],"names":[],"mappings":"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"}