@loxtep/sdk 0.8.0 → 0.9.1

package/dist/client/project-workspace-status-types.js

@@ -0,0 +1,265 @@
+/**
+ * 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';
+// ---------------------------------------------------------------------------
+// Enums / scalar vocab (stable for CLI tables + MCP)
+// ---------------------------------------------------------------------------
+/** How deeply the producer filled the payload. */
+export const StatusPopulationDepthSchema = z.enum([
+    /** List-safe fields only (cheap disk + cheap cloud row columns). */
+    'summary',
+    /** Default for `loxtep status` / MCP get — layers + cheap/moderate deploys. */
+    'status',
+    /** Entity/file-level unpublished inventory (expensive). */
+    'unpublished',
+]);
+/** Relative cost to populate a field or nested group. */
+export const PopulationCostSchema = z.enum(['cheap', 'moderate', 'expensive']);
+/** GitHub Project_Repository binding for status surfaces. */
+export const GithubLinkStateSchema = z.enum(['linked', 'unbound']);
+/** Whether `.loxtep/project.json` has instance_id + api_url (loxtep attach). */
+export const AttachStateSchema = z.enum(['unattached', 'attached']);
+/**
+ * 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 const DeployedLayerStateSchema = z.enum([
+    'never_deployed',
+    'deployed',
+    'stale',
+    'unknown',
+]);
+/**
+ * Suggested next CLI/MCP action for humans and agents.
+ * Distinct from runtime `observe status`.
+ */
+export const NextActionHintSchema = z.enum([
+    'init',
+    'link',
+    'attach',
+    'clone',
+    'push',
+    'deploy',
+    'none',
+]);
+/** Presence of a layer when the producer probed it. */
+export const LayerPresenceSchema = z.enum(['present', 'absent', 'unknown']);
+// ---------------------------------------------------------------------------
+// Nested layer objects
+// ---------------------------------------------------------------------------
+export const LocalWorkspaceLayerSchema = z.object({
+    /** Whether a local workspace was resolved (cwd walk or known-locals). */
+    presence: LayerPresenceSchema,
+    /** Absolute path to the project root when known. */
+    path: z.string().nullable(),
+    /** Absolute path to `.loxtep/project.json` when known. */
+    project_file: z.string().nullable(),
+    /** True when path came from `~/.loxtep/workspaces.json`. */
+    known_local: z.boolean(),
+    /** attach state derived from local config (instance_id + api_url). */
+    attach_state: AttachStateSchema,
+    instance_id: z.string().nullable(),
+    api_url: z.string().nullable(),
+    /** Local project_id from `.loxtep/project.json` when present. */
+    project_id: z.string().nullable(),
+});
+export const GithubStatusSchema = z.object({
+    state: GithubLinkStateSchema,
+    url: z.string().nullable(),
+    name: z.string().nullable(),
+    branch: z.string().nullable(),
+    last_sync_at: z.string().nullable(),
+});
+export const CloudProjectLayerSchema = z.object({
+    presence: LayerPresenceSchema,
+    project_id: z.string().nullable(),
+    organization_id: z.string().nullable(),
+    name: z.string().nullable(),
+    /** Cloud project lifecycle status (`active` | `inactive` | `archived`). */
+    status: z.string().nullable(),
+    github: GithubStatusSchema,
+    /**
+     * Best-effort workspace / package revision marker when available
+     * (e.g. last push or S3 workspace etag/sha). Null when not populated.
+     */
+    workspace_revision: z.string().nullable(),
+    workspace_updated_at: z.string().nullable(),
+});
+export const DeployedRuntimeLayerSchema = z.object({
+    presence: LayerPresenceSchema,
+    state: DeployedLayerStateSchema,
+    instance_id: z.string().nullable(),
+    deployment_id: z.string().nullable(),
+    /** Platform deployment status string when known (pending, deployed, failed, …). */
+    deployment_status: z.string().nullable(),
+    /** ISO-8601 UTC of last relevant deploy event when known. */
+    last_deployed_at: z.string().nullable(),
+    /** Seconds since `last_deployed_at` when both clock and timestamp known. */
+    age_seconds: z.number().int().nonnegative().nullable(),
+});
+/** Entity kinds in the push/deploy package inventory. */
+export const UnpublishedEntityKindSchema = z.enum([
+    'workflow',
+    'connection',
+    'data_product',
+    'transformation',
+    'validation',
+    'schema',
+    'module',
+]);
+/** How a package path differs across a layer boundary. */
+export const UnpublishedChangeKindSchema = z.enum([
+    'added',
+    'modified',
+    'removed',
+    'pending_push',
+    'pending_deploy',
+    'cloud_only',
+]);
+/** One actionable file/entity in an unpublished inventory. */
+export const UnpublishedChangeItemSchema = z.object({
+    /** Repo-relative path (e.g. `workflows/wf_1/connections/src.json`). */
+    path: z.string(),
+    entity_kind: UnpublishedEntityKindSchema,
+    change: UnpublishedChangeKindSchema,
+    workflow_id: z.string().nullable(),
+    content_sha256: z.string().nullable().optional(),
+});
+/**
+ * One unpublished delta axis.
+ * `dirty: null` means "not computed at this population_depth" — not "clean".
+ */
+export const UnpublishedDeltaSchema = z.object({
+    dirty: z.boolean().nullable(),
+    /** Short human/agent summary suitable for CLI one-liners. */
+    summary: z.string().nullable(),
+    /** Count of changed entities/files when inventory was computed. */
+    changed_count: z.number().int().nonnegative().nullable(),
+    /**
+     * Entity/file inventory (population_depth `unpublished` only).
+     * Empty at summary/status depths.
+     */
+    changes: z.array(UnpublishedChangeItemSchema).default([]),
+});
+export const UnpublishedStatusSchema = z.object({
+    local_to_cloud: UnpublishedDeltaSchema,
+    cloud_to_deployed: UnpublishedDeltaSchema,
+});
+// ---------------------------------------------------------------------------
+// Full status payload + list enrichment
+// ---------------------------------------------------------------------------
+/**
+ * Full three-layer status. MCP `get_project_workspace_status` and CLI `status`
+ * should return this shape (optionally wrapped in `{ success, data }`).
+ */
+export const ProjectWorkspaceStatusSchema = z.object({
+    /** Schema version for forward-compatible clients. */
+    schema_version: z.literal(1),
+    population_depth: StatusPopulationDepthSchema,
+    /** Canonical project_id when any layer knows it. */
+    project_id: z.string().nullable(),
+    display_name: z.string().nullable(),
+    local: LocalWorkspaceLayerSchema,
+    cloud: CloudProjectLayerSchema,
+    deployed: DeployedRuntimeLayerSchema,
+    unpublished: UnpublishedStatusSchema,
+    next_action: NextActionHintSchema,
+    /** Optional free-form notes (warnings, "deploy API unavailable", etc.). */
+    notes: z.array(z.string()).default([]),
+});
+/**
+ * Lean enrichment for `projects list` / MCP `list_projects` rows.
+ * All fields beyond identity are optional so producers can omit expensive ones.
+ */
+export const ProjectListStatusEnrichmentSchema = z.object({
+    project_id: z.string(),
+    name: z.string().optional(),
+    local_present: z.boolean().optional(),
+    local_path: z.string().nullable().optional(),
+    attach_state: AttachStateSchema.optional(),
+    github_state: GithubLinkStateSchema.optional(),
+    deployed_state: DeployedLayerStateSchema.optional(),
+    /** Local→Cloud dirty; omit or null when not computed. */
+    local_to_cloud_dirty: z.boolean().nullable().optional(),
+    /** Cloud→Deployed dirty; omit or null when not computed. */
+    cloud_to_deployed_dirty: z.boolean().nullable().optional(),
+});
+/** MCP / REST envelope helpers (match SDK successResponse patterns). */
+export const ProjectWorkspaceStatusResponseSchema = z.object({
+    success: z.literal(true),
+    data: ProjectWorkspaceStatusSchema,
+});
+// ---------------------------------------------------------------------------
+// Population cost map (implementer guide; not emitted on the wire)
+// ---------------------------------------------------------------------------
+/**
+ * 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 const PROJECT_WORKSPACE_STATUS_FIELD_COST = {
+    'local.presence': 'cheap',
+    'local.path': 'cheap',
+    'local.project_file': 'cheap',
+    'local.known_local': 'cheap',
+    'local.attach_state': 'cheap',
+    'local.instance_id': 'cheap',
+    'local.api_url': 'cheap',
+    'local.project_id': 'cheap',
+    'cloud.presence': 'cheap',
+    'cloud.project_id': 'cheap',
+    'cloud.organization_id': 'cheap',
+    'cloud.name': 'cheap',
+    'cloud.status': 'cheap',
+    'cloud.github': 'cheap',
+    'cloud.workspace_revision': 'moderate',
+    'cloud.workspace_updated_at': 'moderate',
+    'deployed.presence': 'moderate',
+    'deployed.state': 'moderate',
+    'deployed.instance_id': 'moderate',
+    'deployed.deployment_id': 'moderate',
+    'deployed.deployment_status': 'moderate',
+    'deployed.last_deployed_at': 'moderate',
+    'deployed.age_seconds': 'cheap', // derived from last_deployed_at once known
+    'unpublished.local_to_cloud.dirty': 'moderate',
+    'unpublished.local_to_cloud.summary': 'moderate',
+    'unpublished.local_to_cloud.changed_count': 'expensive',
+    'unpublished.local_to_cloud.changes': 'expensive',
+    'unpublished.cloud_to_deployed.dirty': 'moderate',
+    'unpublished.cloud_to_deployed.summary': 'moderate',
+    'unpublished.cloud_to_deployed.changed_count': 'expensive',
+    'unpublished.cloud_to_deployed.changes': 'expensive',
+    next_action: 'cheap',
+    notes: 'cheap',
+};
+/**
+ * Depth → allowed cost ceiling. Producers SHOULD omit or set null for fields
+ * above the ceiling rather than blocking on expensive work.
+ */
+export const STATUS_POPULATION_DEPTH_COST_CEILING = {
+    summary: 'cheap',
+    status: 'moderate',
+    unpublished: 'expensive',
+};
+//# sourceMappingURL=project-workspace-status-types.js.map

package/dist/client/project-workspace-status-types.js.map

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

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

@@ -0,0 +1,76 @@
+/**
+ * Project workspace status producer + rendering.
+ *
+ * Builds {@link ProjectWorkspaceStatus} from cwd-local config, cloud project row,
+ * and optional deployments list. List enrichment stays at `summary` cost ceiling.
+ * Local→Cloud dirty prefers push-manifest compare (same discovery as `loxtep push`).
+ */
+import type { Project } from './projects-types.js';
+import type { Deployment } from './deployments-types.js';
+import type { AttachState, DeployedLayerState, GithubLinkState, NextActionHint, ProjectListStatusEnrichment, ProjectWorkspaceStatus, StatusPopulationDepth, UnpublishedDelta } from './project-workspace-status-types.js';
+export interface LocalProjectSnapshot {
+    project_id: string;
+    path: string;
+    project_file: string;
+    instance_id: string | null;
+    api_url: string | null;
+}
+export interface BuildProjectWorkspaceStatusInput {
+    population_depth?: StatusPopulationDepth;
+    /** Absolute or relative cwd used for local resolution. */
+    cwd?: string;
+    local?: LocalProjectSnapshot | null;
+    cloud?: Project | null;
+    /** When provided, used for deployed layer (status depth). Empty array = never deployed. */
+    deployments?: Deployment[] | null;
+    /** True when deployments probe failed (use unknown + note). */
+    deployments_unavailable?: boolean;
+    /** Override clock for age_seconds (tests). */
+    now_ms?: number;
+    /**
+     * Test override for Local→Cloud dirty.
+     * When unset, uses push-manifest inventory against `local.path`.
+     */
+    local_git_dirty?: boolean | null;
+    /** Precomputed Local→Cloud inventory (status --unpublished / projects changes). */
+    local_to_cloud_inventory?: UnpublishedDelta | null;
+    /** Cloud workflow ids for inventory escalate (optional). */
+    cloud_workflow_ids?: string[] | null;
+    cloud_list_unavailable?: boolean;
+    notes?: string[];
+    /** True when path came from `~/.loxtep/workspaces.json`. */
+    known_local?: boolean;
+}
+export declare function githubStateFromProject(project: Project | null | undefined): GithubLinkState;
+export declare function deriveNextAction(input: {
+    local_present: boolean;
+    attach_state: AttachState;
+    github_state: GithubLinkState;
+    deployed_state: DeployedLayerState;
+    local_to_cloud_dirty: boolean | null;
+    cloud_to_deployed_dirty: boolean | null;
+}): NextActionHint;
+/**
+ * Pure builder for {@link ProjectWorkspaceStatus}. Callers supply already-loaded
+ * local/cloud/deployments so this stays unit-testable without IO.
+ */
+export declare function buildProjectWorkspaceStatus(input: BuildProjectWorkspaceStatusInput): ProjectWorkspaceStatus;
+/** Lean list/get row enrichment from a full (or summary) status payload. */
+export declare function toProjectListStatusEnrichment(status: ProjectWorkspaceStatus): ProjectListStatusEnrichment;
+/**
+ * Cheap list-row enrichment without a per-project deploy call.
+ * Marks local when `cwd_project_id` matches or when present in known-locals;
+ * github from project columns. `deployed_state` only when provided in
+ * `deployed_by_project`.
+ */
+export declare function enrichProjectListSummary(project: Project, opts?: {
+    cwd_project_id?: string | null;
+    cwd_path?: string | null;
+    cwd_attach_state?: AttachState;
+    deployed_by_project?: Map<string, DeployedLayerState>;
+    /** project_id → absolute path from `~/.loxtep/workspaces.json`. */
+    known_local_paths?: Map<string, string>;
+}): ProjectListStatusEnrichment;
+/** One-screen human rendering for `loxtep status` (not observe status). */
+export declare function formatProjectWorkspaceStatusLines(status: ProjectWorkspaceStatus): string[];
+//# sourceMappingURL=project-workspace-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-workspace-status.d.ts","sourceRoot":"","sources":["../../src/client/project-workspace-status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMzD,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EAErB,gBAAgB,EACjB,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,+DAA+D;IAC/D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnD,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAOD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAG3F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,kBAAkB,CAAC;IACnC,oBAAoB,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,uBAAuB,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC,GAAG,cAAc,CAWjB;AAsJD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,sBAAsB,CAyIxB;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,2BAA2B,CAY7B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GACL,2BAA2B,CAiB7B;AAED,2EAA2E;AAC3E,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAsD1F"}