clivly 0.9.2 → 0.9.3

package/README.md

@@ -60,7 +60,7 @@ database tables and does not modify your ORM schema.
 | [`clivly login`](#clivly-login) | Pair this machine and write credentials to your env file |
 | [`clivly status`](#clivly-status) | Check your setup, step by step. Read-only |
 | [`clivly add widget`](#clivly-add-widget) | Scaffold the chat-session route |
-| [`clivly push-schema`](#clivly-push-schema) | Report your schema to Clivly without deploying |
+| [`clivly push-schema`](#clivly-push-schema) | Push your schema, custom objects and mappings to Clivly without deploying |
 | [`clivly dev`](#clivly-dev) | Tunnel localhost so remote sync can reach you |
 | `clivly --version` | Print the installed `clivly` version |
 | [`clivly ping` / `connect` / `doctor`](#deprecated-aliases) | Deprecated aliases running parts of `status` |
@@ -257,8 +257,36 @@ Walks your setup one step at a time and stops at the first thing that isn't
 ready, telling you what to do about it. **This is the command to reach for when
 something isn't working.** It is read-only and writes nothing.
 
-The ladder: credential → Clivly reachable → `clivly.config` loads →
-`clivly.config` is edge-safe → setup checks → sync trigger URL.
+It answers two questions under two headings:
+
+- **Workspace** — how far setup has got *on Clivly's side*. The server computes
+  this ladder and the CLI prints its verdict, so the terminal and the dashboard
+  can never disagree about where you are. Shown whenever reachability is in
+  scope; `clivly doctor` is local by definition and omits it.
+- **This project** — the local ladder, run here on your machine: credential →
+  Clivly reachable → `clivly.config` loads → `clivly.config` is edge-safe →
+  setup checks → sync trigger URL.
+
+```text
+Clivly status
+
+Workspace
+  ✅ Create a credential
+  ✅ Install Clivly in your app        heartbeat 2m ago
+  ✅ Check what the SDK reported        found 12 tables
+  ⏳ Choose the table holding your people
+  🔒 Let Clivly start a sync
+
+This project
+  ✅ Step 1 of 6 · API key present
+  ✅ Step 2 of 6 · Clivly reachable — Acme
+  ...
+```
+
+If the Workspace section reads
+`⚠️ This Clivly server does not report setup progress`, or names a rejected key
+or an unreachable host, that means the question could not be asked — not that
+your workspace is empty.
 
 | Flag | Effect |
 | --- | --- |
@@ -303,9 +331,35 @@ for the full flow.
 npx clivly push-schema [--config <path>]
 ```
 
-Sends your discovered tables and columns to Clivly so the dashboard can offer
-them for mapping — without deploying your app. Reads your config; writes nothing
-locally. **Table and column names only; never row data.**
+Pushes everything your config declares to Clivly, without deploying your app:
+
+1. **Discovery** — your tables and columns, so the dashboard can offer them for
+   mapping. **Names only; never row data.**
+2. **Custom object types** — anything you declared with `objectType`, so you
+   never create one in the dashboard and paste its id back into config.
+3. **Mappings** — the rows that make those objects actually receive data. Until
+   a mapping exists, a sync is accepted and stores nothing.
+
+Reads your config; writes nothing locally. Safe to re-run — it reports what it
+created, updated, or left alone.
+
+```text
+Clivly push-schema
+  ✅ Schema reported to Clivly.
+  ✅ Created 1 custom object: client_accounts.
+  ✅ Mapped 2 entities: clients, advisors.
+     Open Integrations → Mapping to review them.
+```
+
+**Exits `1` if Clivly refuses your config** — most often because an entity would
+overwrite a mapping someone edited in the dashboard. Config owns the mappings it
+declares; a dashboard-edited mapping is never silently overwritten. That makes
+this command safe to run in CI as a schema gate.
+
+> Two older-version paths, both non-fatal. If the **SDK in your app** predates
+> this feature, only steps 1 and 2 run. If **Clivly** does not have the route
+> yet, the command warns that it could not declare them and still exits `0` —
+> your schema did land, so re-running once Clivly is upgraded finishes the job.
 
 ---
 

package/core.d.cts

@@ -6,5 +6,6 @@ import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-RQLGx8ub.cjs";
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-CmEdAMwj.cjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-BG2O1an2.cjs";
+import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.cjs";
 import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-Da_dlcQ_.cjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/core.d.mts

@@ -6,5 +6,6 @@ import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-D9dsonoi.mjs";
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-Bo7pqXW3.mjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-DgQbrJON.mjs";
+import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.mjs";
 import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-CDY8g9Ic.mjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/drizzle.d.cts

@@ -1,5 +1,5 @@
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-DEtRrqtc.cjs";
-import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-C6aHjedO.cjs";
+import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-EYyxWZnf.cjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle.d.ts
 interface DrizzleDb {

package/drizzle.d.mts

@@ -1,5 +1,5 @@
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-CiK8MMEZ.mjs";
-import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-Dj-0Q3Hb.mjs";
+import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-BmdGnYMn.mjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle.d.ts
 interface DrizzleDb {

package/index.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-const require_sdk = require("./sdk-D4Wp_uxb.cjs");
+const require_sdk = require("./sdk-COLUHhJq.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -1002,7 +1002,7 @@ Usage:
   clivly init [options]           Scaffold Clivly (config, routes, env file) for your app
   clivly add widget [options]     Scaffold the chat-session route
   clivly status [options]         Check your setup, step by step
-  clivly push-schema [options]    Report your schema to Clivly without deploying
+  clivly push-schema [options]    Push schema, custom objects and mappings to Clivly
   clivly dev [options]            Tunnel localhost so remote sync can reach you
   clivly login [options]          Pair this machine and write credentials to your env file
   clivly --version                Print the installed clivly version
@@ -1058,7 +1058,9 @@ Options:
 Usage:
   clivly status [--verbose] [--config <path>] [--env-file <path>]
 
-Runs the setup ladder: credential, reachability, config load, edge-safety,
+Prints two sections. "Workspace" is how far setup has got on Clivly's side,
+computed by the server so the terminal and the dashboard agree. "This project"
+runs the local ladder: credential, reachability, config load, edge-safety,
 setup checks, sync trigger. Read-only — writes nothing.
 
 Options:
@@ -1066,13 +1068,23 @@ Options:
   --config <path>   Path to clivly.config.ts
   --env-file <path> Extra env file to load
 `,
-	"push-schema": `clivly push-schema — report your schema without deploying
+	"push-schema": `clivly push-schema — push everything your config declares
 
 Usage:
   clivly push-schema [--config <path>]
 
-Sends your discovered tables to Clivly so the dashboard can offer them for
-mapping. Reads your config; writes nothing locally.
+Pushes three things to Clivly, without deploying your app:
+  1. Your table and column NAMES, so the dashboard can offer them for mapping.
+     Never row data — discovery is names only.
+  2. The custom object types you declared with \`objectType\`.
+  3. The mappings that make those objects actually receive rows.
+
+Reads your config; writes nothing locally. Safe to re-run — it reports what it
+created, updated, or left alone.
+
+Exits 1 if Clivly refuses your config, most often because an entity would
+overwrite a mapping edited in the dashboard. That makes it usable in CI as a
+schema gate.
 `,
 	dev: `clivly dev — tunnel localhost so remote sync can reach you
 
@@ -2861,6 +2873,17 @@ function defaultReadConfigSource(path) {
 		return null;
 	}
 }
+/**
+* Ping Clivly at most once per command, memoised on the context.
+*
+* `clivly status` asks two questions of one response — "did this call reach
+* Clivly" and "how far has this workspace got" — and they must come from the
+* same answer, not two calls that could disagree.
+*/
+function pingOnce(ctx) {
+	ctx.pingResult ??= ctx.connect(ctx.apiKey, ctx.apiUrl);
+	return ctx.pingResult;
+}
 const REASON_HINT = {
 	ok: "",
 	invalid_api_key: "The key was rejected (401). Check CLIVLY_SECRET_KEY (or legacy CLIVLY_API_KEY).",
@@ -2872,7 +2895,7 @@ const REASON_HINT = {
 	network_error: "Could not reach Clivly. Check your network or --api-url."
 };
 const apiKeyStage = {
-	id: "credential",
+	id: "api-key",
 	label: "API key present",
 	run(ctx) {
 		if (ctx.apiKey) return Promise.resolve({
@@ -2887,11 +2910,11 @@ const apiKeyStage = {
 	}
 };
 const reachabilityStage = {
-	id: "application",
+	id: "reachable",
 	label: "Clivly reachable",
 	needs: [apiKeyStage.id],
 	async run(ctx) {
-		const result = await ctx.connect(ctx.apiKey, ctx.apiUrl);
+		const result = await pingOnce(ctx);
 		if (result.ok) {
 			const name = result.org?.name ?? "(unnamed org)";
 			const id = result.org?.id ? ` (${result.org.id})` : "";
@@ -3025,19 +3048,57 @@ function defaultLoadSdk(path) {
 	return loadConfigSdk(path, "doctor");
 }
 //#endregion
+//#region src/workspace-section.ts
+const MARK$1 = {
+	active: "⏳",
+	blocked: "🔒",
+	done: "✅",
+	failed: "❌",
+	skipped: "⏭️ "
+};
+/**
+* The workspace half of `clivly status`, rendered from what the server sent.
+*
+* This module decides nothing about a stage's state — it prints the verdict the
+* server computed. A CLI that computed its own would be a second ladder, which
+* is the drift this whole change removes.
+*
+* "Unavailable" and "nothing is set up" are deliberately different outcomes. An
+* old server, a rejected key and a dead network all mean we could not ask; none
+* of them means the workspace is empty.
+*/
+function workspaceSection(result) {
+	if (!result) return {
+		kind: "unavailable",
+		reason: "Could not reach Clivly."
+	};
+	if (!result.ok) return {
+		kind: "unavailable",
+		reason: result.status === null ? "Could not reach Clivly (no response)." : `Clivly rejected the request — ${result.reason} (HTTP ${result.status}).`
+	};
+	if (!result.workspace) return {
+		kind: "unavailable",
+		reason: "This Clivly server does not report setup progress. Upgrade the server to see it here."
+	};
+	return {
+		kind: "ladder",
+		lines: result.workspace.steps.map((step) => `  ${MARK$1[step.state]} ${step.label}${step.evidence ? `        ${step.evidence}` : ""}`)
+	};
+}
+//#endregion
 //#region src/status.ts
 /** Stage ids each legacy command maps onto. */
 const ALIAS_STAGE_IDS = {
 	status: STATUS_STAGES.map((stage) => stage.id),
-	ping: ["credential", "application"],
+	ping: ["api-key", "reachable"],
 	doctor: [
 		"config",
 		"runtime",
 		"setup-checks"
 	],
 	connect: [
-		"credential",
-		"application",
+		"api-key",
+		"reachable",
 		"config",
 		"trigger-url"
 	]
@@ -3093,6 +3154,13 @@ async function runStatus(options) {
 	};
 	out("\nClivly status\n");
 	const results = await runLadder(stages, ctx);
+	if (selected.has("reachable")) {
+		const section = workspaceSection(ctx.pingResult ? await ctx.pingResult : null);
+		out("\nWorkspace\n");
+		if (section.kind === "ladder") for (const line of section.lines) out(`${line}\n`);
+		else out(`  ⚠️  ${section.reason}\n`);
+	}
+	out("\nThis project\n");
 	for (const result of results) renderStage(result, options.verbose ?? false, out);
 	const code = ladderExitCode(results);
 	if (code !== 0 && results.some((result) => result.state === "pending")) out("\nSetup is incomplete — finish the steps above and re-run.\n");
@@ -3122,6 +3190,7 @@ const KNOWN_COMMANDS = [
 	"init",
 	"status",
 	"push-schema",
+	"add",
 	"dev",
 	"login",
 	"help",
@@ -3889,6 +3958,7 @@ if (isEntrypoint(process.argv[1], require("url").pathToFileURL(__filename).href)
 	process.exitCode = code;
 });
 //#endregion
+exports.KNOWN_COMMANDS = KNOWN_COMMANDS;
 exports.credentialsMissing = credentialsMissing;
 exports.main = main;
 exports.nearestCommand = nearestCommand;

package/index.d.cts

@@ -58,6 +58,7 @@ interface ProbeHit {
 }
 //#endregion
 //#region src/index.d.ts
+declare const KNOWN_COMMANDS: readonly ["init", "status", "push-schema", "add", "dev", "login", "help", "ping", "doctor", "connect"];
 declare function nearestCommand(input: string): string | undefined;
 interface AddDeps {
   fileExists: (path: string) => boolean;
@@ -117,4 +118,4 @@ declare function runInit(options: RunInitOptions): Promise<number>;
 declare function runInitFromArgv(argv: string[], cwd: string): Promise<number>;
 declare function main(argv: string[]): Promise<number>;
 //#endregion
-export { AddDeps, RunInitOptions, credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };
+export { AddDeps, KNOWN_COMMANDS, RunInitOptions, credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };

package/index.d.mts

@@ -58,6 +58,7 @@ interface ProbeHit {
 }
 //#endregion
 //#region src/index.d.ts
+declare const KNOWN_COMMANDS: readonly ["init", "status", "push-schema", "add", "dev", "login", "help", "ping", "doctor", "connect"];
 declare function nearestCommand(input: string): string | undefined;
 interface AddDeps {
   fileExists: (path: string) => boolean;
@@ -117,4 +118,4 @@ declare function runInit(options: RunInitOptions): Promise<number>;
 declare function runInitFromArgv(argv: string[], cwd: string): Promise<number>;
 declare function main(argv: string[]): Promise<number>;
 //#endregion
-export { AddDeps, RunInitOptions, credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };
+export { AddDeps, KNOWN_COMMANDS, RunInitOptions, credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };

package/index.mjs

@@ -2,7 +2,7 @@
 import { t as CANONICAL_FIELDS } from "./entity-config-kUHri9yA.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import { t as createClivlySDK } from "./sdk-DXV8M_Io.mjs";
+import { t as createClivlySDK } from "./sdk-CZNXBsgA.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch, writeFileSync } from "node:fs";
@@ -1001,7 +1001,7 @@ Usage:
   clivly init [options]           Scaffold Clivly (config, routes, env file) for your app
   clivly add widget [options]     Scaffold the chat-session route
   clivly status [options]         Check your setup, step by step
-  clivly push-schema [options]    Report your schema to Clivly without deploying
+  clivly push-schema [options]    Push schema, custom objects and mappings to Clivly
   clivly dev [options]            Tunnel localhost so remote sync can reach you
   clivly login [options]          Pair this machine and write credentials to your env file
   clivly --version                Print the installed clivly version
@@ -1057,7 +1057,9 @@ Options:
 Usage:
   clivly status [--verbose] [--config <path>] [--env-file <path>]
 
-Runs the setup ladder: credential, reachability, config load, edge-safety,
+Prints two sections. "Workspace" is how far setup has got on Clivly's side,
+computed by the server so the terminal and the dashboard agree. "This project"
+runs the local ladder: credential, reachability, config load, edge-safety,
 setup checks, sync trigger. Read-only — writes nothing.
 
 Options:
@@ -1065,13 +1067,23 @@ Options:
   --config <path>   Path to clivly.config.ts
   --env-file <path> Extra env file to load
 `,
-	"push-schema": `clivly push-schema — report your schema without deploying
+	"push-schema": `clivly push-schema — push everything your config declares
 
 Usage:
   clivly push-schema [--config <path>]
 
-Sends your discovered tables to Clivly so the dashboard can offer them for
-mapping. Reads your config; writes nothing locally.
+Pushes three things to Clivly, without deploying your app:
+  1. Your table and column NAMES, so the dashboard can offer them for mapping.
+     Never row data — discovery is names only.
+  2. The custom object types you declared with \`objectType\`.
+  3. The mappings that make those objects actually receive rows.
+
+Reads your config; writes nothing locally. Safe to re-run — it reports what it
+created, updated, or left alone.
+
+Exits 1 if Clivly refuses your config, most often because an entity would
+overwrite a mapping edited in the dashboard. That makes it usable in CI as a
+schema gate.
 `,
 	dev: `clivly dev — tunnel localhost so remote sync can reach you
 
@@ -2860,6 +2872,17 @@ function defaultReadConfigSource(path) {
 		return null;
 	}
 }
+/**
+* Ping Clivly at most once per command, memoised on the context.
+*
+* `clivly status` asks two questions of one response — "did this call reach
+* Clivly" and "how far has this workspace got" — and they must come from the
+* same answer, not two calls that could disagree.
+*/
+function pingOnce(ctx) {
+	ctx.pingResult ??= ctx.connect(ctx.apiKey, ctx.apiUrl);
+	return ctx.pingResult;
+}
 const REASON_HINT = {
 	ok: "",
 	invalid_api_key: "The key was rejected (401). Check CLIVLY_SECRET_KEY (or legacy CLIVLY_API_KEY).",
@@ -2871,7 +2894,7 @@ const REASON_HINT = {
 	network_error: "Could not reach Clivly. Check your network or --api-url."
 };
 const apiKeyStage = {
-	id: "credential",
+	id: "api-key",
 	label: "API key present",
 	run(ctx) {
 		if (ctx.apiKey) return Promise.resolve({
@@ -2886,11 +2909,11 @@ const apiKeyStage = {
 	}
 };
 const reachabilityStage = {
-	id: "application",
+	id: "reachable",
 	label: "Clivly reachable",
 	needs: [apiKeyStage.id],
 	async run(ctx) {
-		const result = await ctx.connect(ctx.apiKey, ctx.apiUrl);
+		const result = await pingOnce(ctx);
 		if (result.ok) {
 			const name = result.org?.name ?? "(unnamed org)";
 			const id = result.org?.id ? ` (${result.org.id})` : "";
@@ -3024,19 +3047,57 @@ function defaultLoadSdk(path) {
 	return loadConfigSdk(path, "doctor");
 }
 //#endregion
+//#region src/workspace-section.ts
+const MARK$1 = {
+	active: "⏳",
+	blocked: "🔒",
+	done: "✅",
+	failed: "❌",
+	skipped: "⏭️ "
+};
+/**
+* The workspace half of `clivly status`, rendered from what the server sent.
+*
+* This module decides nothing about a stage's state — it prints the verdict the
+* server computed. A CLI that computed its own would be a second ladder, which
+* is the drift this whole change removes.
+*
+* "Unavailable" and "nothing is set up" are deliberately different outcomes. An
+* old server, a rejected key and a dead network all mean we could not ask; none
+* of them means the workspace is empty.
+*/
+function workspaceSection(result) {
+	if (!result) return {
+		kind: "unavailable",
+		reason: "Could not reach Clivly."
+	};
+	if (!result.ok) return {
+		kind: "unavailable",
+		reason: result.status === null ? "Could not reach Clivly (no response)." : `Clivly rejected the request — ${result.reason} (HTTP ${result.status}).`
+	};
+	if (!result.workspace) return {
+		kind: "unavailable",
+		reason: "This Clivly server does not report setup progress. Upgrade the server to see it here."
+	};
+	return {
+		kind: "ladder",
+		lines: result.workspace.steps.map((step) => `  ${MARK$1[step.state]} ${step.label}${step.evidence ? `        ${step.evidence}` : ""}`)
+	};
+}
+//#endregion
 //#region src/status.ts
 /** Stage ids each legacy command maps onto. */
 const ALIAS_STAGE_IDS = {
 	status: STATUS_STAGES.map((stage) => stage.id),
-	ping: ["credential", "application"],
+	ping: ["api-key", "reachable"],
 	doctor: [
 		"config",
 		"runtime",
 		"setup-checks"
 	],
 	connect: [
-		"credential",
-		"application",
+		"api-key",
+		"reachable",
 		"config",
 		"trigger-url"
 	]
@@ -3092,6 +3153,13 @@ async function runStatus(options) {
 	};
 	out("\nClivly status\n");
 	const results = await runLadder(stages, ctx);
+	if (selected.has("reachable")) {
+		const section = workspaceSection(ctx.pingResult ? await ctx.pingResult : null);
+		out("\nWorkspace\n");
+		if (section.kind === "ladder") for (const line of section.lines) out(`${line}\n`);
+		else out(`  ⚠️  ${section.reason}\n`);
+	}
+	out("\nThis project\n");
 	for (const result of results) renderStage(result, options.verbose ?? false, out);
 	const code = ladderExitCode(results);
 	if (code !== 0 && results.some((result) => result.state === "pending")) out("\nSetup is incomplete — finish the steps above and re-run.\n");
@@ -3121,6 +3189,7 @@ const KNOWN_COMMANDS = [
 	"init",
 	"status",
 	"push-schema",
+	"add",
 	"dev",
 	"login",
 	"help",
@@ -3888,4 +3957,4 @@ if (isEntrypoint(process.argv[1], import.meta.url)) main(process.argv.slice(2)).
 	process.exitCode = code;
 });
 //#endregion
-export { credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };
+export { KNOWN_COMMANDS, credentialsMissing, main, nearestCommand, runAdd, runInit, runInitFromArgv };

package/integration-state-BK-riZnm.d.cts

@@ -0,0 +1,130 @@
+//#region ../core/src/integration-state.d.ts
+declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
+type StepId = (typeof INTEGRATION_STEPS)[number];
+/** `blocked` means "prerequisite unmet", never "broken" — see C-19. */
+type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
+type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
+/**
+ * @deprecated No longer derived. Liveness is its own dimension — read
+ * `ConnectionHealth` from `deriveLiveness`. Setup progress does not move
+ * backwards just because an app stopped running.
+ */
+"disconnected";
+interface RunFact {
+  at: number;
+  message?: string;
+  ok: boolean;
+}
+/**
+ * Where the reporting app is running, as the app itself understands it.
+ *
+ * `unknown` is a real value, not an absence: `detectHostEnvironment` refuses to
+ * guess when nothing places the app, and a bare `node server.js` with no
+ * NODE_ENV must still be able to connect and be shown as itself. Defaulting
+ * such a host to `local_dev` would file a production box's faults under local
+ * development, where nobody would look for them.
+ */
+type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
+interface IntegrationFacts {
+  discoveredTableCount: number;
+  /** The environment the app reported on its last heartbeat. */
+  environment?: HostEnvironment | null;
+  /**
+   * Has this app ever checked in? Distinguishes "never installed" from "was
+   * working, now silent" — the same absent heartbeat means different things,
+   * and only one of them is diagnosed rather than set up.
+   */
+  everConnected: boolean;
+  hasCredential: boolean;
+  /**
+   * The cadence the app said it heartbeats at. Liveness windows are multiples
+   * of this rather than a fixed constant, so an app that deliberately reports
+   * slowly is not called dead for obeying its own configuration.
+   */
+  heartbeatIntervalMs?: number | null;
+  lastHeartbeatAt: number | null;
+  lastRun: RunFact | null;
+  mappedEntityCount: number;
+  now: number;
+  /**
+   * Deployment presence, when this deployment has one. Absent or `http`
+   * transport keeps the cadence-derived behaviour every SDK in the field uses.
+   */
+  presence?: DeploymentPresence | null;
+  /**
+   * Faults the running app diagnosed about itself on its last heartbeat — an
+   * unreadable database, a secret missing from the process environment. These
+   * are what make a reachable app `live_with_issues`; unfinished setup is not.
+   */
+  reportedIssues?: StepProblem[];
+  syncInFlight: boolean;
+  /** A trigger URL and secret both exist, so Clivly can ask the app to sync. */
+  triggerConfigured: boolean;
+  warnings: string[];
+  widgetInstalled: boolean;
+}
+interface StepProblem {
+  code: string;
+  fix: string;
+  message: string;
+}
+interface IntegrationStep {
+  blockedBy: StepId | null;
+  evidence: string | null;
+  id: StepId;
+  label: string;
+  problem: StepProblem | null;
+  state: StepState;
+}
+type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
+/** Which algorithm decides whether this deployment is up. */
+type PresenceTransport = "websocket" | "http";
+type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
+/**
+ * A deployment's connection state as its `PresenceRoom` last persisted it.
+ *
+ * This exists because a socket has an explicit state and a timestamp does not.
+ * Deriving WebSocket liveness from heartbeat age would leave a disconnected app
+ * shown as live for 150 seconds and offline only after ten minutes, which is
+ * the whole reason this transport exists.
+ */
+interface DeploymentPresence {
+  /** Sockets currently accepted in the room. */
+  activeInstanceCount: number;
+  connectionState: PresenceConnectionState;
+  transport: PresenceTransport;
+}
+interface ConnectionLiveness {
+  /** `"8s ago"`, or `"No heartbeat yet"` when the app has never reported. */
+  ageLabel: string;
+  ageMs: number | null;
+  environment: HostEnvironment | null;
+  health: ConnectionHealth;
+  /**
+   * Faults on a reachable app. Empty unless `health` is `live_with_issues`.
+   */
+  issues: StepProblem[];
+  /** Present when a deployment-presence record supplied this liveness result. */
+  presence?: Pick<DeploymentPresence, "connectionState" | "transport">;
+  /** Is a heartbeat recent enough to speak for the app as it is right now? */
+  reachable: boolean;
+}
+interface NextAction {
+  command: string | null;
+  envFile: string | null;
+  label: string;
+}
+interface IntegrationState {
+  /**
+   * Is the app running right now. Deliberately alongside `status` rather than
+   * folded into it: a surface must be able to say "setup reached mapping" and
+   * "the app is offline" in the same breath without either overwriting the
+   * other.
+   */
+  liveness: ConnectionLiveness;
+  next: NextAction | null;
+  status: IntegrationStatus;
+  steps: IntegrationStep[];
+}
+//#endregion
+export { IntegrationStep as a, StepProblem as c, IntegrationStatus as i, StepState as l, IntegrationFacts as n, NextAction as o, IntegrationState as r, StepId as s, ConnectionLiveness as t };

package/integration-state-BK-riZnm.d.mts

@@ -0,0 +1,130 @@
+//#region ../core/src/integration-state.d.ts
+declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
+type StepId = (typeof INTEGRATION_STEPS)[number];
+/** `blocked` means "prerequisite unmet", never "broken" — see C-19. */
+type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
+type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
+/**
+ * @deprecated No longer derived. Liveness is its own dimension — read
+ * `ConnectionHealth` from `deriveLiveness`. Setup progress does not move
+ * backwards just because an app stopped running.
+ */
+"disconnected";
+interface RunFact {
+  at: number;
+  message?: string;
+  ok: boolean;
+}
+/**
+ * Where the reporting app is running, as the app itself understands it.
+ *
+ * `unknown` is a real value, not an absence: `detectHostEnvironment` refuses to
+ * guess when nothing places the app, and a bare `node server.js` with no
+ * NODE_ENV must still be able to connect and be shown as itself. Defaulting
+ * such a host to `local_dev` would file a production box's faults under local
+ * development, where nobody would look for them.
+ */
+type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
+interface IntegrationFacts {
+  discoveredTableCount: number;
+  /** The environment the app reported on its last heartbeat. */
+  environment?: HostEnvironment | null;
+  /**
+   * Has this app ever checked in? Distinguishes "never installed" from "was
+   * working, now silent" — the same absent heartbeat means different things,
+   * and only one of them is diagnosed rather than set up.
+   */
+  everConnected: boolean;
+  hasCredential: boolean;
+  /**
+   * The cadence the app said it heartbeats at. Liveness windows are multiples
+   * of this rather than a fixed constant, so an app that deliberately reports
+   * slowly is not called dead for obeying its own configuration.
+   */
+  heartbeatIntervalMs?: number | null;
+  lastHeartbeatAt: number | null;
+  lastRun: RunFact | null;
+  mappedEntityCount: number;
+  now: number;
+  /**
+   * Deployment presence, when this deployment has one. Absent or `http`
+   * transport keeps the cadence-derived behaviour every SDK in the field uses.
+   */
+  presence?: DeploymentPresence | null;
+  /**
+   * Faults the running app diagnosed about itself on its last heartbeat — an
+   * unreadable database, a secret missing from the process environment. These
+   * are what make a reachable app `live_with_issues`; unfinished setup is not.
+   */
+  reportedIssues?: StepProblem[];
+  syncInFlight: boolean;
+  /** A trigger URL and secret both exist, so Clivly can ask the app to sync. */
+  triggerConfigured: boolean;
+  warnings: string[];
+  widgetInstalled: boolean;
+}
+interface StepProblem {
+  code: string;
+  fix: string;
+  message: string;
+}
+interface IntegrationStep {
+  blockedBy: StepId | null;
+  evidence: string | null;
+  id: StepId;
+  label: string;
+  problem: StepProblem | null;
+  state: StepState;
+}
+type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
+/** Which algorithm decides whether this deployment is up. */
+type PresenceTransport = "websocket" | "http";
+type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
+/**
+ * A deployment's connection state as its `PresenceRoom` last persisted it.
+ *
+ * This exists because a socket has an explicit state and a timestamp does not.
+ * Deriving WebSocket liveness from heartbeat age would leave a disconnected app
+ * shown as live for 150 seconds and offline only after ten minutes, which is
+ * the whole reason this transport exists.
+ */
+interface DeploymentPresence {
+  /** Sockets currently accepted in the room. */
+  activeInstanceCount: number;
+  connectionState: PresenceConnectionState;
+  transport: PresenceTransport;
+}
+interface ConnectionLiveness {
+  /** `"8s ago"`, or `"No heartbeat yet"` when the app has never reported. */
+  ageLabel: string;
+  ageMs: number | null;
+  environment: HostEnvironment | null;
+  health: ConnectionHealth;
+  /**
+   * Faults on a reachable app. Empty unless `health` is `live_with_issues`.
+   */
+  issues: StepProblem[];
+  /** Present when a deployment-presence record supplied this liveness result. */
+  presence?: Pick<DeploymentPresence, "connectionState" | "transport">;
+  /** Is a heartbeat recent enough to speak for the app as it is right now? */
+  reachable: boolean;
+}
+interface NextAction {
+  command: string | null;
+  envFile: string | null;
+  label: string;
+}
+interface IntegrationState {
+  /**
+   * Is the app running right now. Deliberately alongside `status` rather than
+   * folded into it: a surface must be able to say "setup reached mapping" and
+   * "the app is offline" in the same breath without either overwriting the
+   * other.
+   */
+  liveness: ConnectionLiveness;
+  next: NextAction | null;
+  status: IntegrationStatus;
+  steps: IntegrationStep[];
+}
+//#endregion
+export { IntegrationStep as a, StepProblem as c, IntegrationStatus as i, StepState as l, IntegrationFacts as n, NextAction as o, IntegrationState as r, StepId as s, ConnectionLiveness as t };

package/internal.d.cts

@@ -6,5 +6,6 @@ import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-RQLGx8ub.cjs";
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-CmEdAMwj.cjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-BG2O1an2.cjs";
+import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.cjs";
 import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-Da_dlcQ_.cjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/internal.d.mts

@@ -6,5 +6,6 @@ import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-D9dsonoi.mjs";
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-Bo7pqXW3.mjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-DgQbrJON.mjs";
+import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.mjs";
 import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-CDY8g9Ic.mjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/{namespace-probe-Dj-0Q3Hb.d.mts → namespace-probe-BmdGnYMn.d.mts}

@@ -1,4 +1,5 @@
 import { a as ClivlyEntitiesConfig } from "./entity-config-B2RA53nw.mjs";
+import { r as IntegrationState } from "./integration-state-BK-riZnm.mjs";
 //#region ../sdk/src/drizzle-meta.d.ts
 declare const DRIZZLE_META: "__clivly_drizzle_source_meta__";
 interface DrizzleSourceMeta {
@@ -301,6 +302,12 @@ interface ClivlyConnectResult {
   retryable: boolean;
   /** HTTP status, or null when the request never completed (network error). */
   status: number | null;
+  /**
+   * The workspace's setup ladder, computed by the server. Present only on
+   * `ping()`, and null when the server is older than this field or could not
+   * read it — which the CLI renders as "unavailable", never as "not set up".
+   */
+  workspace?: IntegrationState | null;
 }
 interface SyncCursor {
   /** The row's id, breaking ties when timestamps collide. */

package/{namespace-probe-C6aHjedO.d.cts → namespace-probe-EYyxWZnf.d.cts}

@@ -1,4 +1,5 @@
 import { a as ClivlyEntitiesConfig } from "./entity-config-B2RA53nw.cjs";
+import { r as IntegrationState } from "./integration-state-BK-riZnm.cjs";
 //#region ../sdk/src/drizzle-meta.d.ts
 declare const DRIZZLE_META: "__clivly_drizzle_source_meta__";
 interface DrizzleSourceMeta {
@@ -301,6 +302,12 @@ interface ClivlyConnectResult {
   retryable: boolean;
   /** HTTP status, or null when the request never completed (network error). */
   status: number | null;
+  /**
+   * The workspace's setup ladder, computed by the server. Present only on
+   * `ping()`, and null when the server is older than this field or could not
+   * read it — which the CLI renders as "unavailable", never as "not set up".
+   */
+  workspace?: IntegrationState | null;
 }
 interface SyncCursor {
   /** The row's id, breaking ties when timestamps collide. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",

package/{sdk-D4Wp_uxb.cjs → sdk-COLUHhJq.cjs}

@@ -1789,6 +1789,7 @@ function createClivlySDK(config) {
 				reason: "ok",
 				retryable: false,
 				org: body?.org,
+				workspace: body?.workspace ?? null,
 				..."appLastSeenAt" in body ? { appLastSeenAt: body.appLastSeenAt ?? null } : {}
 			};
 		}

package/{sdk-DXV8M_Io.mjs → sdk-CZNXBsgA.mjs}

@@ -1789,6 +1789,7 @@ function createClivlySDK(config) {
 				reason: "ok",
 				retryable: false,
 				org: body?.org,
+				workspace: body?.workspace ?? null,
 				..."appLastSeenAt" in body ? { appLastSeenAt: body.appLastSeenAt ?? null } : {}
 			};
 		}

package/sdk.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
-const require_sdk = require("./sdk-D4Wp_uxb.cjs");
+const require_sdk = require("./sdk-COLUHhJq.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;
 exports.ClivlyNetworkError = require_sdk.ClivlyNetworkError;

package/sdk.d.cts

@@ -1,5 +1,5 @@
 import { C as defineClivlyConfig, S as customObjectDeclarations, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult } from "./entity-config-B2RA53nw.cjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-C6aHjedO.cjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-EYyxWZnf.cjs";
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/sdk.d.mts

@@ -1,5 +1,5 @@
 import { C as defineClivlyConfig, S as customObjectDeclarations, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult } from "./entity-config-B2RA53nw.mjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-Dj-0Q3Hb.mjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-BmdGnYMn.mjs";
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/sdk.mjs

@@ -1,3 +1,3 @@
 import { o as customObjectDeclarations, p as validateEntitiesConfig, s as defineClivlyConfig } from "./entity-config-kUHri9yA.mjs";
-import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, t as createClivlySDK } from "./sdk-DXV8M_Io.mjs";
+import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, t as createClivlySDK } from "./sdk-CZNXBsgA.mjs";
 export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, validateEntitiesConfig };

package/vite.d.cts

@@ -1,4 +1,4 @@
-import { o as ClivlySDK } from "./namespace-probe-C6aHjedO.cjs";
+import { o as ClivlySDK } from "./namespace-probe-EYyxWZnf.cjs";
 import { Plugin } from "vite";
 //#region ../sdk/src/vite.d.ts
 interface ClivlyViteOptions {

package/vite.d.mts

@@ -1,4 +1,4 @@
-import { o as ClivlySDK } from "./namespace-probe-Dj-0Q3Hb.mjs";
+import { o as ClivlySDK } from "./namespace-probe-BmdGnYMn.mjs";
 import { Plugin } from "vite";
 //#region ../sdk/src/vite.d.ts
 interface ClivlyViteOptions {