@cleocode/core 2026.9.20 → 2026.9.22

package/dist/store/schema/cleo-global/nexus.d.ts

@@ -417,6 +417,9 @@ export declare const nexusProjectIdAliases: import("drizzle-orm/sqlite-core").SQ
  * seen on this device, keyed by path (T12354). The registry row holds one path
  * per `project_id`; this table lets two checkouts of one project coexist.
  *
+ * @deprecated Superseded by {@link nexusProjectLocations} (T12469). Kept so
+ *   older binaries that share this global store keep working; current code
+ *   neither reads nor writes it.
  * @task T12354
  */
 export declare const nexusProjectPaths: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
@@ -506,6 +509,653 @@ export declare const nexusProjectPaths: import("drizzle-orm/sqlite-core").SQLite
     };
     dialect: "sqlite";
 }>;
+/** Lifecycle states of one project location (T12469). */
+export declare const PROJECT_LOCATION_STATES: readonly ["live", "missing", "superseded", "candidate"];
+/**
+ * `nexus_project_locations` — every place a project has been seen, on every
+ * device (ADR-094 · T12469). One row per `(project_id, device_id, path)`; rows
+ * are never deleted when a directory vanishes — they move to `missing`, and a
+ * path now claimed by another project moves to `superseded`, so location
+ * history survives for consumers such as legacy credential derivation.
+ *
+ * @task T12469
+ */
+export declare const nexusProjectLocations: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "nexus_project_locations";
+    schema: undefined;
+    columns: {
+        projectId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        deviceId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        path: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        firstSeen: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        lastSeen: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        state: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string enum";
+            data: "candidate" | "live" | "missing" | "superseded";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["live", "missing", "superseded", "candidate"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        checkoutNonce: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        gitRootCommit: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        gitRemote: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_locations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * `nexus_devices` — one row per machine that runs CLEO against this global
+ * store (T12510). `device_id` is the persisted `<cleoHome>/device-id` UUID
+ * (T9321), the same id {@link nexusProjectLocations} rows carry, so a location
+ * resolves to a hostname / OS / arch / CLEO version and a last heartbeat. The
+ * CLI upserts this device's row at most once per minute.
+ *
+ * @task T12510
+ */
+export declare const nexusDevices: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "nexus_devices";
+    schema: undefined;
+    columns: {
+        deviceId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        hostname: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        os: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        arch: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        cleoVersion: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        firstSeen: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        lastHeartbeatAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_devices";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Probe error codes a `nexus_project_git_state` row may carry (T12511). */
+export declare const GIT_PROBE_ERROR_CODES: readonly ["E_PATH_MISSING", "E_PATH_ACCESS", "E_NOT_GIT_REPO", "E_GIT_TIMEOUT", "E_GIT_FAILED", "E_FETCH_FAILED"];
+/**
+ * `nexus_project_git_state` — the last git state probe of one project location
+ * (T12511). Keyed exactly like {@link nexusProjectLocations}: `(project_id, device_id,
+ * path)`, one row per checkout per device, so another device reading this
+ * store sees where each project lives and what state it was last seen in.
+ *
+ * Remote columns describe the remote as of `remote_fetched_at` (FETCH_HEAD's
+ * mtime), never "now": the probe does not fetch unless asked. A failed probe
+ * still writes its row, with `probe_error_code` set — errors are never dropped.
+ *
+ * @task T12511
+ */
+export declare const nexusProjectGitState: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "nexus_project_git_state";
+    schema: undefined;
+    columns: {
+        projectId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        deviceId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        path: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        gitRoot: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        branch: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        headSha: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        detached: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        shallow: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        dirtyCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        untrackedCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        upstream: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        ahead: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        behind: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        remoteName: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        remoteUrl: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        remoteHeadSha: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        remoteFetchedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        probedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        durationMs: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        probeErrorCode: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string enum";
+            data: "E_PATH_MISSING" | "E_PATH_ACCESS" | "E_NOT_GIT_REPO" | "E_GIT_TIMEOUT" | "E_GIT_FAILED" | "E_FETCH_FAILED";
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["E_PATH_MISSING", "E_PATH_ACCESS", "E_NOT_GIT_REPO", "E_GIT_TIMEOUT", "E_GIT_FAILED", "E_FETCH_FAILED"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        probeError: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_project_git_state";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
 /**
  * `nexus_audit_log` — append-only audit log for all Nexus operations across
  * projects. Already domain-prefixed; the idempotent prefixer is a no-op.
@@ -962,6 +1612,38 @@ export declare const nexusUserProfile: import("drizzle-orm/sqlite-core").SQLiteT
             identity: undefined;
             generated: undefined;
         }, {}>;
+        projectId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_user_profile";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        scope: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_user_profile";
+            dataType: "string enum";
+            data: "project" | "user";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["project", "user"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -1122,6 +1804,10 @@ export type NewNexusProjectIdAliasRow = typeof nexusProjectIdAliases.$inferInser
 export type NexusProjectPathRow = typeof nexusProjectPaths.$inferSelect;
 /** Row type for `nexus_project_paths` INSERT (T12354). */
 export type NewNexusProjectPathRow = typeof nexusProjectPaths.$inferInsert;
+/** Row type for `nexus_project_locations` SELECT (T12469). */
+export type NexusProjectLocationRow = typeof nexusProjectLocations.$inferSelect;
+/** Row type for `nexus_project_locations` INSERT (T12469). */
+export type NewNexusProjectLocationRow = typeof nexusProjectLocations.$inferInsert;
 /** Row type for `nexus_audit_log` SELECT (target shape). */
 export type NexusAuditLogRow = typeof nexusAuditLog.$inferSelect;
 /** Row type for `nexus_audit_log` INSERT (target shape). */