primitive-admin 1.2.0-alpha.1 → 1.2.0-alpha.11

package/dist/src/lib/generated-sdk-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-sdk-types.js","sourceRoot":"","sources":["../../../src/lib/generated-sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,s+qHAAs+qH,CAAC"}
+{"version":3,"file":"generated-sdk-types.js","sourceRoot":"","sources":["../../../src/lib/generated-sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,q0vLAAq0vL,CAAC"}

package/dist/src/lib/init-adopt.js

@@ -8,7 +8,7 @@
  * the committed default -> the sole environment) against an explicit root.
  */
 import { join } from "path";
-import { readLocalSelection, selectEnvironmentName } from "./env-resolver-core.js";
+import { isCommittedEnvironment, readLocalState, selectEnvironmentName, } from "./env-resolver-core.js";
 import { PROJECT_TREE_DIR, PROJECT_CONFIG_FILENAME, loadProjectConfigFromPath, } from "./project-config.js";
 /**
  * Resolves the environment `init` adopts from the project rooted at `root`.
@@ -18,15 +18,24 @@ import { PROJECT_TREE_DIR, PROJECT_CONFIG_FILENAME, loadProjectConfigFromPath, }
 export function resolveAdoptedEnvironment(root, options = {}) {
     const projectConfigPath = join(root, PROJECT_TREE_DIR, PROJECT_CONFIG_FILENAME);
     const projectConfig = loadProjectConfigFromPath(projectConfigPath);
+    const localState = readLocalState(projectConfigPath, projectConfig);
     const { name } = selectEnvironmentName(projectConfig, {
         explicitEnvName: options.explicitEnvName ?? null,
         envVarName: options.envVarName ?? null,
-        localSelection: readLocalSelection(projectConfigPath),
+        localSelection: localState.selectedEnvironment,
+        localEnvironments: localState.environments,
         configPath: projectConfigPath,
     });
+    // A machine-local environment (#4117) names its app and server in
+    // `.primitive/local.json`, not in the committed config.
+    const localEntry = isCommittedEnvironment(projectConfig, name)
+        ? undefined
+        : localState.environments[name];
     return {
         name,
-        config: projectConfig.environments[name],
+        config: localEntry
+            ? { apiUrl: localEntry.apiUrl, appId: localEntry.appId, appName: localEntry.appName }
+            : projectConfig.environments[name],
         projectConfig,
         projectConfigPath,
     };

package/dist/src/lib/init-adopt.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-adopt.js","sourceRoot":"","sources":["../../../src/lib/init-adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GAG1B,MAAM,qBAAqB,CAAC;AAS7B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,UAA2E,EAAE;IAE7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,aAAoB,EAAE;QAC3D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,cAAc,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;QACrD,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC;QACxC,aAAa;QACb,iBAAiB;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"init-adopt.js","sourceRoot":"","sources":["../../../src/lib/init-adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GAG1B,MAAM,qBAAqB,CAAC;AAS7B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,UAA2E,EAAE;IAE7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,cAAc,CAAC,iBAAiB,EAAE,aAAoB,CAAC,CAAC;IAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,aAAoB,EAAE;QAC3D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,cAAc,EAAE,UAAU,CAAC,mBAAmB;QAC9C,iBAAiB,EAAE,UAAU,CAAC,YAAY;QAC1C,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,kEAAkE;IAClE,wDAAwD;IACxD,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,EAAE,IAAI,CAAC;QAC5D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,UAAU;YAChB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE;YACrF,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC;QACpC,aAAa;QACb,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/src/lib/init-login-note.d.ts

@@ -0,0 +1,13 @@
+/**
+ * What `primitive init` says about the login it seeds into a new project
+ * (#4512). Init signs in before its app exists, so it cannot pin the login to
+ * the app; the note names the login that does.
+ */
+import type { Credentials } from "../types/index.js";
+/** The note for a seeded login that covers all of the admin's apps. */
+export declare const INIT_ALL_APPS_NOTE = "This login covers all of your apps. Run 'primitive login' inside the project to limit it to this app.";
+/**
+ * The note for `credentials` once seeded, or null: a pinned login says
+ * nothing, and a CI job's `PRIMITIVE_TOKEN` is never seeded.
+ */
+export declare function initLoginNote(credentials: Credentials): string | null;

package/dist/src/lib/init-login-note.js

@@ -0,0 +1,22 @@
+/** The note for a seeded login that covers all of the admin's apps. */
+export const INIT_ALL_APPS_NOTE = "This login covers all of your apps. Run 'primitive login' inside the project to limit it to this app.";
+/** The apps an access token is pinned to; none for an unpinned or unreadable one. */
+function pinsOf(accessToken) {
+    try {
+        const claims = JSON.parse(Buffer.from(accessToken.split(".")[1] ?? "", "base64url").toString("utf-8"));
+        return Array.isArray(claims?.apps) ? claims.apps : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The note for `credentials` once seeded, or null: a pinned login says
+ * nothing, and a CI job's `PRIMITIVE_TOKEN` is never seeded.
+ */
+export function initLoginNote(credentials) {
+    if (credentials.source === "env")
+        return null;
+    return pinsOf(credentials.accessToken).length === 0 ? INIT_ALL_APPS_NOTE : null;
+}
+//# sourceMappingURL=init-login-note.js.map

package/dist/src/lib/init-login-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-login-note.js","sourceRoot":"","sources":["../../../src/lib/init-login-note.ts"],"names":[],"mappings":"AAOA,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,uGAAuG,CAAC;AAE1G,qFAAqF;AACrF,SAAS,MAAM,CAAC,WAAmB;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACvG,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC"}

package/dist/src/lib/json-value.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse a JSON-or-table value a TOML file or an API response carries: a string
+ * is JSON text, anything else is already the value (TOML parsed it as a
+ * table). Absent stays absent.
+ */
+export declare function safeJsonParse(value: any): any;

package/dist/src/lib/json-value.js

@@ -0,0 +1,13 @@
+/**
+ * Parse a JSON-or-table value a TOML file or an API response carries: a string
+ * is JSON text, anything else is already the value (TOML parsed it as a
+ * table). Absent stays absent.
+ */
+export function safeJsonParse(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === "string")
+        return JSON.parse(value);
+    return value;
+}
+//# sourceMappingURL=json-value.js.map

package/dist/src/lib/json-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.js","sourceRoot":"","sources":["../../../src/lib/json-value.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAU;IACtC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/lib/load-routes.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The bulk-load and snapshot routes a data verb drives, by family (#4889):
+ * `documents/:id/*` for `primitive documents ingest|ingests|snapshots`, and
+ * `db3/:id/*` for their `primitive db3` twins. The verbs share one action
+ * body each (`../commands/documents.ts`) and differ only in these calls.
+ */
+import type { ApiClient } from "./api-client.js";
+/** One chunk of a bulk-load artifact, as the upload sends it. */
+export type LoadChunkUpload = Parameters<ApiClient["uploadDocumentIngestChunk"]>[3];
+/** A listing page's options. */
+export type LoadPageOptions = {
+    limit?: number;
+    cursor?: string;
+};
+/** The calls one family's bulk-load and snapshot verbs make. */
+export interface LoadRoutes {
+    /** What the verbs' prompts call the target: `document` or `db3`. */
+    noun: "document" | "db3";
+    schema(client: ApiClient, appId: string, id: string): Promise<any>;
+    listIngests(client: ApiClient, appId: string, id: string, options: LoadPageOptions): Promise<any>;
+    getIngest(client: ApiClient, appId: string, id: string, sessionId: string): Promise<any>;
+    createIngest(client: ApiClient, appId: string, id: string, body: Parameters<ApiClient["createDocumentIngest"]>[2]): Promise<any>;
+    uploadIngestChunk(client: ApiClient, appId: string, id: string, sessionId: string, chunk: LoadChunkUpload): Promise<any>;
+    commitIngest(client: ApiClient, appId: string, id: string, sessionId: string): Promise<any>;
+    abortIngest(client: ApiClient, appId: string, id: string, sessionId: string): Promise<any>;
+    listSnapshots(client: ApiClient, appId: string, id: string, options: LoadPageOptions): Promise<any>;
+    getSnapshot(client: ApiClient, appId: string, id: string, segmentId: string): Promise<any>;
+    requestSnapshot(client: ApiClient, appId: string, id: string): Promise<any>;
+}
+/** `documents/:id/*`. */
+export declare const DOCUMENT_LOAD_ROUTES: LoadRoutes;
+/** `db3/:id/*`: the same routes under a db3's own name. */
+export declare const DB3_LOAD_ROUTES: LoadRoutes;

package/dist/src/lib/load-routes.js

@@ -0,0 +1,35 @@
+/**
+ * The bulk-load and snapshot routes a data verb drives, by family (#4889):
+ * `documents/:id/*` for `primitive documents ingest|ingests|snapshots`, and
+ * `db3/:id/*` for their `primitive db3` twins. The verbs share one action
+ * body each (`../commands/documents.ts`) and differ only in these calls.
+ */
+/** `documents/:id/*`. */
+export const DOCUMENT_LOAD_ROUTES = {
+    noun: "document",
+    schema: (client, appId, id) => client.getDocumentSchema(appId, id),
+    listIngests: (client, appId, id, options) => client.listDocumentIngests(appId, id, options),
+    getIngest: (client, appId, id, sessionId) => client.getDocumentIngest(appId, id, sessionId),
+    createIngest: (client, appId, id, body) => client.createDocumentIngest(appId, id, body),
+    uploadIngestChunk: (client, appId, id, sessionId, chunk) => client.uploadDocumentIngestChunk(appId, id, sessionId, chunk),
+    commitIngest: (client, appId, id, sessionId) => client.commitDocumentIngest(appId, id, sessionId),
+    abortIngest: (client, appId, id, sessionId) => client.abortDocumentIngest(appId, id, sessionId),
+    listSnapshots: (client, appId, id, options) => client.listDocumentSnapshots(appId, id, options),
+    getSnapshot: (client, appId, id, segmentId) => client.getDocumentSnapshot(appId, id, segmentId),
+    requestSnapshot: (client, appId, id) => client.requestDocumentSnapshot(appId, id),
+};
+/** `db3/:id/*`: the same routes under a db3's own name. */
+export const DB3_LOAD_ROUTES = {
+    noun: "db3",
+    schema: (client, appId, id) => client.getDb3Schema(appId, id),
+    listIngests: (client, appId, id, options) => client.listDb3Ingests(appId, id, options),
+    getIngest: (client, appId, id, sessionId) => client.getDb3Ingest(appId, id, sessionId),
+    createIngest: (client, appId, id, body) => client.createDb3Ingest(appId, id, body),
+    uploadIngestChunk: (client, appId, id, sessionId, chunk) => client.uploadDb3IngestChunk(appId, id, sessionId, chunk),
+    commitIngest: (client, appId, id, sessionId) => client.commitDb3Ingest(appId, id, sessionId),
+    abortIngest: (client, appId, id, sessionId) => client.abortDb3Ingest(appId, id, sessionId),
+    listSnapshots: (client, appId, id, options) => client.listDb3Snapshots(appId, id, options),
+    getSnapshot: (client, appId, id, segmentId) => client.getDb3Snapshot(appId, id, segmentId),
+    requestSnapshot: (client, appId, id) => client.requestDb3Snapshot(appId, id),
+};
+//# sourceMappingURL=load-routes.js.map

package/dist/src/lib/load-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-routes.js","sourceRoot":"","sources":["../../../src/lib/load-routes.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/local-state.d.ts

@@ -11,13 +11,29 @@
  * CLI, Vite plugin, Swift script — agrees; this module owns the writes and the
  * ignore coverage that keeps the file out of `git status`.
  */
-import { localStatePathForConfigPath, readLocalSelection } from "./env-resolver-core.js";
+import { localStatePathForConfigPath, readLocalSelection, type CoreLocalEnvironmentEntry } from "./env-resolver-core.js";
 export { localStatePathForConfigPath, readLocalSelection };
 /**
  * Writes this machine's environment selection. Returns the path written so
  * callers can name it in their success message.
  */
 export declare function writeLocalSelection(configPath: string, name: string): string;
+/**
+ * Registers (or replaces) the machine-local environment `name` (#4117): a
+ * child app's entry, naming its own app and server and the committed
+ * environment whose tree it shares. Returns the path written.
+ *
+ * Refuses, writing nothing, a name a committed environment already has and
+ * any entry the resolver core would refuse to read — the file this writes is
+ * always one every reader accepts. The selection and unrelated keys are kept.
+ */
+export declare function writeLocalEnvironment(configPath: string, name: string, entry: CoreLocalEnvironmentEntry): string;
+/**
+ * Removes the machine-local environment `name` and clears a selection that
+ * names it, so no later command resolves an entry that is gone. Returns
+ * whether there was an entry to remove; anything else in the file is kept.
+ */
+export declare function removeLocalEnvironment(configPath: string, name: string): boolean;
 /**
  * Clears the selection if (and only if) it names `name`. Used by `env remove`
  * so removing the selected environment can't leave a dangling selection that
@@ -39,17 +55,32 @@ export interface IgnoreCoverageOutcome {
     /** Why, for `failed`. */
     detail?: string;
 }
+/**
+ * Makes sure the machine-local file at `path` is git-ignored before it is
+ * written, and confirms it.
+ *
+ * When the file is not already covered an anchored pattern is appended to the
+ * repository's exclude file, resolved via `git rev-parse --git-path
+ * info/exclude` so a linked worktree (where `.git` is a FILE) works, and
+ * anchored relative to `git rev-parse --show-toplevel` so a project root
+ * nested below the worktree root is not mis-rooted. `reason` names the command
+ * in the comment written beside the pattern.
+ *
+ * Coverage is confirmed, not assumed (#4485): a destination git already
+ * tracks is a failure, and so is one `git check-ignore` still reports as not
+ * ignored once the pattern is in place — a committed `.gitignore` negation
+ * outranks `info/exclude`. Git runs from the nearest existing directory above
+ * the destination, and no directory is created.
+ */
+export declare function ensureFileIgnored(path: string, options: {
+    reason: string;
+}): IgnoreCoverageOutcome;
 /**
  * Makes sure `.primitive/local.json` is ignored before it is written.
  *
  * Templates scaffolded from now on carry the entry in their `.gitignore`, but
  * projects created before this change do not — and `env use` writing an
  * untracked-but-committable file would be exactly the "switching backends
- * dirties the repo" problem this replaced. When the file is not already
- * covered we append an anchored pattern to the repository's exclude file,
- * resolved via `git rev-parse --git-path info/exclude` so a linked worktree
- * (where `.git` is a FILE) works, and anchored relative to
- * `git rev-parse --show-toplevel` so a project root nested below the worktree
- * root is not mis-rooted.
+ * dirties the repo" problem this replaced. See {@link ensureFileIgnored}.
  */
 export declare function ensureLocalStateIgnored(localStatePath: string): IgnoreCoverageOutcome;

package/dist/src/lib/local-state.js

@@ -14,8 +14,34 @@
 import { execFileSync } from "child_process";
 import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "fs";
 import { basename, dirname, join, relative, sep } from "path";
-import { PRIMITIVE_LOCAL_STATE_VERSION, localStatePathForConfigPath, readLocalSelection, } from "./env-resolver-core.js";
+import { PRIMITIVE_LOCAL_STATE_VERSION, PROJECT_CONFIG_DISPLAY_NAME, isCommittedEnvironment, localStatePathForConfigPath, parseLocalEnvironments, readCoreProjectConfig, readLocalSelection, } from "./env-resolver-core.js";
 export { localStatePathForConfigPath, readLocalSelection };
+/**
+ * The file's current keys, or an empty object for a missing or corrupt file.
+ * Unrelated keys a future version of the CLI may have written are preserved
+ * by every write.
+ */
+function readExistingLocalState(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // A corrupt file is replaced wholesale — that is exactly the remedy the
+        // corrupt-local-state error tells the user to reach for.
+    }
+    return {};
+}
+function writeLocalStateFile(path, body) {
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(body, null, 2) + "\n");
+}
 /**
  * Writes this machine's environment selection. Returns the path written so
  * callers can name it in their success message.
@@ -25,20 +51,7 @@ export function writeLocalSelection(configPath, name) {
     const dir = dirname(path);
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });
-    // Preserve any unrelated keys a future version of the CLI may have written.
-    let existing = {};
-    if (existsSync(path)) {
-        try {
-            const parsed = JSON.parse(readFileSync(path, "utf-8"));
-            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-                existing = parsed;
-            }
-        }
-        catch {
-            // A corrupt file is replaced wholesale — that is exactly the remedy the
-            // corrupt-local-state error tells the user to reach for.
-        }
-    }
+    const existing = readExistingLocalState(path);
     const body = {
         ...existing,
         version: PRIMITIVE_LOCAL_STATE_VERSION,
@@ -47,6 +60,72 @@ export function writeLocalSelection(configPath, name) {
     writeFileSync(path, JSON.stringify(body, null, 2) + "\n");
     return path;
 }
+/**
+ * Registers (or replaces) the machine-local environment `name` (#4117): a
+ * child app's entry, naming its own app and server and the committed
+ * environment whose tree it shares. Returns the path written.
+ *
+ * Refuses, writing nothing, a name a committed environment already has and
+ * any entry the resolver core would refuse to read — the file this writes is
+ * always one every reader accepts. The selection and unrelated keys are kept.
+ */
+export function writeLocalEnvironment(configPath, name, entry) {
+    const path = localStatePathForConfigPath(configPath);
+    const config = readCoreProjectConfig(configPath);
+    if (isCommittedEnvironment(config, name)) {
+        throw new Error(`"${name}" is a committed environment in ${PROJECT_CONFIG_DISPLAY_NAME}; a machine-local environment needs a name of its own.`);
+    }
+    const existing = readExistingLocalState(path);
+    const current = existing.environments &&
+        typeof existing.environments === "object" &&
+        !Array.isArray(existing.environments)
+        ? existing.environments
+        : {};
+    const environments = {
+        ...current,
+        [name]: {
+            apiUrl: entry.apiUrl,
+            appId: entry.appId,
+            ...(entry.appName !== undefined ? { appName: entry.appName } : {}),
+            tree: entry.tree,
+        },
+    };
+    // The same rules the read applies, so a refused entry never reaches disk.
+    parseLocalEnvironments(environments, path, config);
+    writeLocalStateFile(path, {
+        ...existing,
+        version: PRIMITIVE_LOCAL_STATE_VERSION,
+        environments,
+    });
+    return path;
+}
+/**
+ * Removes the machine-local environment `name` and clears a selection that
+ * names it, so no later command resolves an entry that is gone. Returns
+ * whether there was an entry to remove; anything else in the file is kept.
+ */
+export function removeLocalEnvironment(configPath, name) {
+    const path = localStatePathForConfigPath(configPath);
+    const existing = readExistingLocalState(path);
+    const environments = existing.environments;
+    if (!environments ||
+        typeof environments !== "object" ||
+        Array.isArray(environments) ||
+        !Object.prototype.hasOwnProperty.call(environments, name)) {
+        return false;
+    }
+    const remaining = { ...environments };
+    delete remaining[name];
+    const body = {
+        ...existing,
+        version: PRIMITIVE_LOCAL_STATE_VERSION,
+        environments: remaining,
+    };
+    if (body.selectedEnvironment === name)
+        delete body.selectedEnvironment;
+    writeLocalStateFile(path, body);
+    return true;
+}
 /**
  * Clears the selection if (and only if) it names `name`. Used by `env remove`
  * so removing the selected environment can't leave a dangling selection that
@@ -97,71 +176,115 @@ function git(cwd, args) {
 function escapeGitignorePattern(relPath) {
     return relPath.replace(/[\\*?[\]]/g, (c) => "\\" + c).replace(/^([#!])/, "\\$1");
 }
+/** The nearest directory at or above `path` that exists. */
+function nearestExistingDir(path) {
+    let dir = dirname(path);
+    while (!existsSync(dir)) {
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return dir;
+}
+/** Whether git reports `path` as ignored, run from `cwd`. */
+function isGitIgnored(cwd, path) {
+    try {
+        execFileSync("git", ["check-ignore", "-q", "--", path], { cwd, stdio: "ignore" });
+        return true;
+    }
+    catch {
+        // Exit 1 means "not ignored".
+        return false;
+    }
+}
+/** Whether git tracks `path`, run from `cwd`. */
+function isGitTracked(cwd, path) {
+    try {
+        execFileSync("git", ["ls-files", "--error-unmatch", "--", path], { cwd, stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
- * Makes sure `.primitive/local.json` is ignored before it is written.
+ * Makes sure the machine-local file at `path` is git-ignored before it is
+ * written, and confirms it.
  *
- * Templates scaffolded from now on carry the entry in their `.gitignore`, but
- * projects created before this change do not — and `env use` writing an
- * untracked-but-committable file would be exactly the "switching backends
- * dirties the repo" problem this replaced. When the file is not already
- * covered we append an anchored pattern to the repository's exclude file,
- * resolved via `git rev-parse --git-path info/exclude` so a linked worktree
- * (where `.git` is a FILE) works, and anchored relative to
- * `git rev-parse --show-toplevel` so a project root nested below the worktree
- * root is not mis-rooted.
+ * When the file is not already covered an anchored pattern is appended to the
+ * repository's exclude file, resolved via `git rev-parse --git-path
+ * info/exclude` so a linked worktree (where `.git` is a FILE) works, and
+ * anchored relative to `git rev-parse --show-toplevel` so a project root
+ * nested below the worktree root is not mis-rooted. `reason` names the command
+ * in the comment written beside the pattern.
+ *
+ * Coverage is confirmed, not assumed (#4485): a destination git already
+ * tracks is a failure, and so is one `git check-ignore` still reports as not
+ * ignored once the pattern is in place — a committed `.gitignore` negation
+ * outranks `info/exclude`. Git runs from the nearest existing directory above
+ * the destination, and no directory is created.
  */
-export function ensureLocalStateIgnored(localStatePath) {
-    const dir = dirname(localStatePath);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
+export function ensureFileIgnored(path, options) {
+    const cwd = nearestExistingDir(path);
     let topLevel;
     try {
-        topLevel = git(dir, ["rev-parse", "--show-toplevel"]);
+        topLevel = git(cwd, ["rev-parse", "--show-toplevel"]);
     }
     catch {
         return { status: "not-a-repo" };
     }
     if (!topLevel)
         return { status: "not-a-repo" };
-    try {
-        execFileSync("git", ["check-ignore", "-q", "--", localStatePath], {
-            cwd: dir,
-            stdio: "ignore",
-        });
-        return { status: "already-ignored" };
-    }
-    catch {
-        // Exit 1 means "not ignored" — carry on and add coverage.
-    }
     // git reports the toplevel with symlinks resolved (/private/var on macOS);
     // the caller's path usually is not (/var). Compare like for like or the
     // "relative" path escapes the repository entirely.
-    const realDir = realpathSync(dir);
-    const rel = relative(topLevel, join(realDir, basename(localStatePath)))
-        .split(sep)
-        .join("/");
+    const realPath = join(realpathSync(cwd), relative(cwd, path));
+    const rel = relative(topLevel, realPath).split(sep).join("/");
+    if (isGitTracked(cwd, realPath)) {
+        return { status: "failed", detail: `${rel} is tracked by git` };
+    }
+    if (isGitIgnored(cwd, realPath))
+        return { status: "already-ignored" };
     const pattern = "/" + escapeGitignorePattern(rel);
+    const overridden = {
+        status: "failed",
+        detail: `${rel} is still not ignored: a .gitignore rule overrides the exclude entry "${pattern}"`,
+    };
     try {
-        const excludePath = git(dir, ["rev-parse", "--path-format=absolute", "--git-path", "info/exclude"]);
+        const excludePath = git(cwd, ["rev-parse", "--path-format=absolute", "--git-path", "info/exclude"]);
         if (!excludePath)
             return { status: "failed", detail: "could not locate the git exclude file" };
         mkdirSync(dirname(excludePath), { recursive: true });
         const existing = existsSync(excludePath) ? readFileSync(excludePath, "utf-8") : "";
         if (existing.split(/\r?\n/).some((line) => line.trim() === pattern)) {
-            return { status: "already-ignored" };
+            return isGitIgnored(cwd, realPath) ? { status: "already-ignored" } : overridden;
         }
         const prefix = existing === "" || existing.endsWith("\n") ? "" : "\n";
         writeFileSync(excludePath, existing +
             prefix +
-            `\n# Added by 'primitive env use' — this machine's Primitive environment\n` +
-            `# selection is local state, not a team decision. Add the same pattern to a\n` +
-            `# committed .gitignore to make the coverage shared.\n` +
+            `\n# Added by '${options.reason}' — ${basename(path)} is per-machine Primitive\n` +
+            `# state, never committed. Add the same pattern to a committed .gitignore to\n` +
+            `# make the coverage shared.\n` +
             pattern +
             "\n");
+        if (!isGitIgnored(cwd, realPath))
+            return overridden;
         return { status: "excluded", excludePath, pattern };
     }
     catch (err) {
         return { status: "failed", detail: err?.message || String(err) };
     }
 }
+/**
+ * Makes sure `.primitive/local.json` is ignored before it is written.
+ *
+ * Templates scaffolded from now on carry the entry in their `.gitignore`, but
+ * projects created before this change do not — and `env use` writing an
+ * untracked-but-committable file would be exactly the "switching backends
+ * dirties the repo" problem this replaced. See {@link ensureFileIgnored}.
+ */
+export function ensureLocalStateIgnored(localStatePath) {
+    return ensureFileIgnored(localStatePath, { reason: "primitive env use" });
+}
 //# sourceMappingURL=local-state.js.map

package/dist/src/lib/local-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-state.js","sourceRoot":"","sources":["../../../src/lib/local-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE9D,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,IAAY;IAClE,MAAM,IAAI,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,4EAA4E;IAC5E,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,QAAQ,GAAG,MAAiC,CAAC;YAC/C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ;QACX,OAAO,EAAE,6BAA6B;QACtC,mBAAmB,EAAE,IAAI;KAC1B,CAAC;IACF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,IAAY;IAClE,MAAM,IAAI,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,IAAI,OAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,wEAAwE;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEnC,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,QAAQ,GAAG,MAAiC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,mBAAmB,CAAC;IACpC,aAAa,CACX,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,GAAG,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACxF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAkBD,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;QAC/B,GAAG;QACH,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;KACpC,CAAC,CAAC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAsB;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAE/C,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE;YAChE,GAAG,EAAE,GAAG;YACR,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IAED,2EAA2E;IAC3E,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;SACpE,KAAK,CAAC,GAAG,CAAC;SACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,GAAG,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;QACpG,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAC;QAE/F,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;YACpE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACvC,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,aAAa,CACX,WAAW,EACX,QAAQ;YACN,MAAM;YACN,2EAA2E;YAC3E,8EAA8E;YAC9E,uDAAuD;YACvD,OAAO;YACP,IAAI,CACP,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACtD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}
+{"version":3,"file":"local-state.js","sourceRoot":"","sources":["../../../src/lib/local-state.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/local-test-cases.d.ts

@@ -37,8 +37,11 @@ export interface LocalTestCaseScan {
 export type ManagedTestCases = Record<string, {
     id?: string;
 } | undefined>;
-/** Read the manifest's test-case rows, or nothing when it cannot be read. */
-export declare function readManagedTestCases(configDir: string): ManagedTestCases;
+/**
+ * Read the current environment's manifest test-case rows, or nothing when it
+ * cannot be read.
+ */
+export declare function readManagedTestCases(): ManagedTestCases;
 /**
  * The `*.toml` case files in a suite's sidecar directory, if it has one.
  *

package/dist/src/lib/local-test-cases.js

@@ -30,10 +30,13 @@ import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { basename, join } from "path";
 import { testCaseFileBasenames } from "./test-case-file-names.js";
 import { normalizeTestCaseKey } from "./test-case-keys.js";
-import { syncStateReadPath } from "./sync-paths.js";
-/** Read the manifest's test-case rows, or nothing when it cannot be read. */
-export function readManagedTestCases(configDir) {
-    const syncFile = syncStateReadPath(configDir);
+import { resolveSyncStateReadPath } from "./sync-paths.js";
+/**
+ * Read the current environment's manifest test-case rows, or nothing when it
+ * cannot be read.
+ */
+export function readManagedTestCases() {
+    const syncFile = resolveSyncStateReadPath();
     if (!existsSync(syncFile))
         return {};
     try {