@descryy/runtime-environment-profile 0.3.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/credential-store.d.ts

@@ -1,31 +1,14 @@
 /**
- * Credential storage — DEC-270: "Credentials stored locally, in the OS
- * keychain on the user's machine — not on a Descry server." This repo has
- * no server component (`descry-core` CLAUDE.md, "Repo split"), so that
- * guarantee is entirely a local-storage concern here.
- *
+ * DEC-270: credentials stored locally (OS keychain), never on a server.
  * `CredentialStore` is the seam a real OS-keychain backend (`keytar` or
- * equivalent) plugs into later. **Chosen for this pass:
- * `EncryptedFileCredentialStore`, an at-rest AES-256-GCM file store, not a
- * real keychain integration** — disclosed per the "honest degradation"
- * rule (`descry-core` CLAUDE.md rule 7), not silently passed off as the
- * real thing:
- *
- *  - Neither this repo's root `package.json` nor `descry-core`'s already
- *    depends on `keytar` or any keychain wrapper (checked before writing
- *    this file), and `keytar` itself is an unmaintained native module
- *    (prebuilt binaries, no upstream releases since 2021) — exactly the
- *    "heavy new dependency added without checking existing ones" this
- *    pass was told to avoid, for a package that would need per-platform
- *    native builds to even test in CI.
- *  - `node:crypto` is already a dependency of this repo (`randomUUID` is
- *    used in `backend-observation`, `browser`, `controller`,
- *    `evidence-store`) and needs no native build step, so the interim
- *    implementation is buildable and testable everywhere `node --test`
- *    already runs.
- *  - The interface below does not leak this choice: a future
- *    `KeychainCredentialStore` satisfies the same three methods and every
- *    caller (including the safety gate) is unaffected by the swap.
+ * equivalent) plugs into later. This pass uses `EncryptedFileCredentialStore`
+ * (AES-256-GCM file store) instead, disclosed per honest-degradation
+ * (rule 7) rather than passed off as a real keychain:
+ *  - `keytar` is unmaintained (no releases since 2021, native prebuilt
+ *    binaries) and neither this repo nor `descry-core` already depends on it.
+ *  - `node:crypto` is already used elsewhere in this repo, no native build.
+ *  - The interface doesn't leak this choice — a future
+ *    `KeychainCredentialStore` is a drop-in swap.
  */
 export interface CredentialStore {
     /** Stores `secret` under `credentialRef`, overwriting any existing value for that ref. */
@@ -36,22 +19,15 @@ export interface CredentialStore {
     delete(credentialRef: string): Promise<void>;
 }
 /**
- * AES-256-GCM file-at-rest fallback. One file per `credentialRef`, named
- * by the SHA-256 hash of the ref rather than the ref itself — so scoping
- * is enforced structurally (a lookup under a different ref hashes to a
- * different filename and simply finds nothing) rather than only by
- * convention, and so a ref containing characters unsafe for a filename
- * never needs special-casing.
+ * AES-256-GCM file-at-rest fallback. Each `credentialRef` is stored under
+ * the SHA-256 hash of the ref, not the ref itself — scoping is structural
+ * (wrong ref hashes to a different, absent file) and unsafe filename
+ * characters never need special-casing.
  *
- * The AES key is a 32-byte value generated once and written to
- * `master.key` inside the store directory, `chmod`'d to `0o600`
- * (owner-only) immediately after write — the directory itself is created
- * `0o700`. This protects against other *users* on a shared machine, not
- * against another *process running as the same user*, which is the
- * limitation a real OS keychain (backed by the platform's own access
- * control / user login secret) does not have. That gap is exactly why
- * this is documented as an interim fallback rather than the intended
- * long-term implementation.
+ * The AES key lives in `master.key` under the store dir, both chmod'd
+ * 0o600/0o700 owner-only. This protects against other users on a shared
+ * machine, not another process running as the same user — a real OS
+ * keychain doesn't have that gap, which is why this is interim.
  */
 export declare class EncryptedFileCredentialStore implements CredentialStore {
     private readonly baseDir;

package/dist/credential-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,kGAAkG;IAClG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxD,mGAAmG;IACnG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,4BAA6B,YAAW,eAAe;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,UAAU,CAAgC;gBAEtC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAM7C,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBvD,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD,OAAO,CAAC,SAAS;YAKH,eAAe;YAOf,uBAAuB;CAUtC"}
+{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,kGAAkG;IAClG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxD,mGAAmG;IACnG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAkBD;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,YAAW,eAAe;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,UAAU,CAAgC;gBAEtC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAM7C,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2BvD,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD,OAAO,CAAC,SAAS;YAKH,eAAe;YAOf,uBAAuB;CAUtC"}

package/dist/credential-store.js

@@ -1,31 +1,14 @@
 /**
- * Credential storage — DEC-270: "Credentials stored locally, in the OS
- * keychain on the user's machine — not on a Descry server." This repo has
- * no server component (`descry-core` CLAUDE.md, "Repo split"), so that
- * guarantee is entirely a local-storage concern here.
- *
+ * DEC-270: credentials stored locally (OS keychain), never on a server.
  * `CredentialStore` is the seam a real OS-keychain backend (`keytar` or
- * equivalent) plugs into later. **Chosen for this pass:
- * `EncryptedFileCredentialStore`, an at-rest AES-256-GCM file store, not a
- * real keychain integration** — disclosed per the "honest degradation"
- * rule (`descry-core` CLAUDE.md rule 7), not silently passed off as the
- * real thing:
- *
- *  - Neither this repo's root `package.json` nor `descry-core`'s already
- *    depends on `keytar` or any keychain wrapper (checked before writing
- *    this file), and `keytar` itself is an unmaintained native module
- *    (prebuilt binaries, no upstream releases since 2021) — exactly the
- *    "heavy new dependency added without checking existing ones" this
- *    pass was told to avoid, for a package that would need per-platform
- *    native builds to even test in CI.
- *  - `node:crypto` is already a dependency of this repo (`randomUUID` is
- *    used in `backend-observation`, `browser`, `controller`,
- *    `evidence-store`) and needs no native build step, so the interim
- *    implementation is buildable and testable everywhere `node --test`
- *    already runs.
- *  - The interface below does not leak this choice: a future
- *    `KeychainCredentialStore` satisfies the same three methods and every
- *    caller (including the safety gate) is unaffected by the swap.
+ * equivalent) plugs into later. This pass uses `EncryptedFileCredentialStore`
+ * (AES-256-GCM file store) instead, disclosed per honest-degradation
+ * (rule 7) rather than passed off as a real keychain:
+ *  - `keytar` is unmaintained (no releases since 2021, native prebuilt
+ *    binaries) and neither this repo nor `descry-core` already depends on it.
+ *  - `node:crypto` is already used elsewhere in this repo, no native build.
+ *  - The interface doesn't leak this choice — a future
+ *    `KeychainCredentialStore` is a drop-in swap.
  */
 import { randomBytes, createCipheriv, createDecipheriv, createHash } from "node:crypto";
 import { mkdir, readFile, writeFile, unlink, chmod } from "node:fs/promises";
@@ -35,23 +18,22 @@ import { join } from "node:path";
 const ALGORITHM = "aes-256-gcm";
 const KEY_BYTES = 32;
 const IV_BYTES = 12;
+// Pinned to 16 bytes on both cipher directions (S-1): unpinned, `setAuthTag`
+// accepts any shorter tag and GCM authenticates against only that many
+// bytes (a real tag's 4/8/12-byte prefix all pass). Pinning here, plus the
+// length check in retrieve() below, is what forces full 2^128 forgery
+// resistance instead of whatever length is present on disk.
+const AUTH_TAG_BYTES = 16;
 /**
- * AES-256-GCM file-at-rest fallback. One file per `credentialRef`, named
- * by the SHA-256 hash of the ref rather than the ref itself — so scoping
- * is enforced structurally (a lookup under a different ref hashes to a
- * different filename and simply finds nothing) rather than only by
- * convention, and so a ref containing characters unsafe for a filename
- * never needs special-casing.
+ * AES-256-GCM file-at-rest fallback. Each `credentialRef` is stored under
+ * the SHA-256 hash of the ref, not the ref itself — scoping is structural
+ * (wrong ref hashes to a different, absent file) and unsafe filename
+ * characters never need special-casing.
  *
- * The AES key is a 32-byte value generated once and written to
- * `master.key` inside the store directory, `chmod`'d to `0o600`
- * (owner-only) immediately after write — the directory itself is created
- * `0o700`. This protects against other *users* on a shared machine, not
- * against another *process running as the same user*, which is the
- * limitation a real OS keychain (backed by the platform's own access
- * control / user login secret) does not have. That gap is exactly why
- * this is documented as an interim fallback rather than the intended
- * long-term implementation.
+ * The AES key lives in `master.key` under the store dir, both chmod'd
+ * 0o600/0o700 owner-only. This protects against other users on a shared
+ * machine, not another process running as the same user — a real OS
+ * keychain doesn't have that gap, which is why this is interim.
  */
 export class EncryptedFileCredentialStore {
     baseDir;
@@ -67,7 +49,7 @@ export class EncryptedFileCredentialStore {
         await mkdir(this.entriesDir, { recursive: true, mode: 0o700 });
         const key = await this.loadOrCreateKey();
         const iv = randomBytes(IV_BYTES);
-        const cipher = createCipheriv(ALGORITHM, key, iv);
+        const cipher = createCipheriv(ALGORITHM, key, iv, { authTagLength: AUTH_TAG_BYTES });
         const ciphertext = Buffer.concat([cipher.update(secret, "utf8"), cipher.final()]);
         const envelope = {
             iv: iv.toString("base64"),
@@ -86,8 +68,16 @@ export class EncryptedFileCredentialStore {
         const key = await this.loadOrCreateKey();
         const raw = await readFile(path, "utf8");
         const envelope = JSON.parse(raw);
-        const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, "base64"));
-        decipher.setAuthTag(Buffer.from(envelope.authTag, "base64"));
+        const authTag = Buffer.from(envelope.authTag, "base64");
+        // Reject on length before setAuthTag/final(): anything but a full
+        // 16-byte tag (truncated, or written by a pre-S-1 build) must fail
+        // loudly rather than risk authenticating against a shortened tag.
+        if (authTag.length !== AUTH_TAG_BYTES) {
+            throw new Error(`EncryptedFileCredentialStore: refusing to decrypt "${credentialRef}" -- authTag is ${String(authTag.length)} bytes, expected exactly ${String(AUTH_TAG_BYTES)}. ` +
+                "This envelope is either tampered with or was written before authTagLength was pinned (S-1); it cannot be safely decrypted as-is.");
+        }
+        const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, "base64"), { authTagLength: AUTH_TAG_BYTES });
+        decipher.setAuthTag(authTag);
         const plaintext = Buffer.concat([
             decipher.update(Buffer.from(envelope.ciphertext, "base64")),
             decipher.final(),

package/dist/credential-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,MAAM,SAAS,GAAG,aAAa,CAAC;AAChC,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,QAAQ,GAAG,EAAE,CAAC;AAQpB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,4BAA4B;IACtB,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,OAAO,CAAS;IACzB,UAAU,GAA2B,IAAI,CAAC;IAElD,YAAY,OAAuC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,aAAqB,EAAE,MAAc;QAC/C,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAsB;YAClC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzB,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC/C,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC1C,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,aAAqB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtF,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC3D,QAAQ,CAAC,KAAK,EAAE;SACjB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAqB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,aAAqB;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}
+{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"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"}

package/dist/profile.d.ts

@@ -1,38 +1,24 @@
 /**
- * Environment profile — DEC-270 (`documents/decisions-inbox/
- * DEC-270-environment-profiles-declare-safety-not-infer-it.md`), building on
- * DEC-266's four target kinds (local booted, local attached, remote
- * dev/staging/preview, production).
+ * DEC-270, building on DEC-266's four target kinds (local booted, local
+ * attached, remote dev/staging/preview, production).
  *
- * A profile is a **user-named** target: no fixed vocabulary. "staging"
- * means different things at different companies, so nothing here
- * pattern-matches on `name` — the safety level below is the only thing
- * that governs what is permitted, and it is always set explicitly by the
- * user, never guessed from the name or the URL.
+ * A profile is user-named, no fixed vocabulary — nothing here pattern-matches
+ * on `name`; `safetyLevel` alone governs what's permitted, always set
+ * explicitly by the user, never guessed from name or URL.
  *
- * `credentialRef` is a reference into a `CredentialStore` (see
- * `credential-store.ts`), never the raw secret — this type is safe to log,
- * serialize or hand to a planner without ever exposing what it points at.
+ * `credentialRef` is a reference into a `CredentialStore`, never the raw
+ * secret — safe to log, serialize, or hand to a planner.
  *
- * `mode` and `remoteLogSource` are RT-197/DEC-271's addition. Until this
- * pass `EnvironmentProfile` had no field naming which of DEC-266's four
- * kinds a given profile actually was — `@descryy/runtime-remote-log-ingestion`
- * existed with real tests and zero callers, and there was no profile-level
- * place for a "remote/production" target to declare where its logs live,
- * so nothing could have called it. `mode` closes that: it is what
- * `packages/orchestrator/src/profile-backend-observation.ts` reads to
- * choose DEC-271's mechanism — a real `InboundProxy` for `"localBooted"`,
+ * `mode`/`remoteLogSource` (RT-197/DEC-271) name which of DEC-266's four
+ * kinds a profile is; `profile-backend-observation.ts` reads `mode` to pick
+ * DEC-271's mechanism — `InboundProxy` for `"localBooted"`,
  * `remote-log-ingestion` for `"remote"`/`"production"`, never both.
  */
 import type { RemoteLogSourceConfig } from "@descryy/runtime-remote-log-ingestion";
 /** Set once by the user per profile. Never inferred from `name` (DEC-270's core rule). */
 export declare const SAFETY_LEVELS: readonly ["readOnly", "write", "destructiveWithApproval"];
 export type SafetyLevel = (typeof SAFETY_LEVELS)[number];
-/**
- * DEC-266's four target kinds, named as a closed union for the first time
- * (RT-197). Set once by the user per profile, same discipline as
- * `safetyLevel` — never inferred from `name` or `url`.
- */
+/** DEC-266's four target kinds, closed union (RT-197). Never inferred, like `safetyLevel`. */
 export declare const PROFILE_MODES: readonly ["localBooted", "localAttached", "remote", "production"];
 export type ProfileMode = (typeof PROFILE_MODES)[number];
 export interface EnvironmentProfile {
@@ -41,37 +27,29 @@ export interface EnvironmentProfile {
     readonly url: string;
     readonly safetyLevel: SafetyLevel;
     /**
-     * Opaque key into a `CredentialStore` — never the raw secret itself.
-     * Scoped to this profile only: two profiles must never share a
-     * `credentialRef`, so a credential entered for one is never retrievable
-     * under another's identity, even by accident (DEC-270).
+     * Opaque key into a `CredentialStore` — never the raw secret. Scoped per
+     * profile: two profiles must never share a `credentialRef` (DEC-270).
      */
     readonly credentialRef: string;
     /** Which of DEC-266's four kinds this profile targets. Governs DEC-271's mechanism choice — see this file's own header. */
     readonly mode: ProfileMode;
     /**
-     * DEC-271's "ask, don't guess" input for the remote/production mechanism
-     * — where the user says their logs live, per
-     * `@descryy/runtime-remote-log-ingestion`'s `RemoteLogSourceConfig`. Only
-     * meaningful for `mode: "remote"` or `mode: "production"`;
-     * `validateProfile` rejects it on a `"localBooted"`/`"localAttached"`
-     * profile rather than silently ignoring it, because a caller that set it
-     * there believed it would be honored and it would not have been.
+     * DEC-271's "ask, don't guess" input for remote/production log location.
+     * Only meaningful for `mode: "remote"`/`"production"` — `validateProfile`
+     * rejects it on a local mode rather than silently ignoring it, since a
+     * caller that set it there expected it to be honored.
      *
      * `null`/absent on a remote or production profile is a real, honest
-     * state — DEC-271's own "or a plain 'not observable here' when there's
-     * nothing to work with" — not an error. This type has no dependency in
-     * the other direction: `@descryy/runtime-remote-log-ingestion` does not
-     * import from this package.
+     * state, not an error. No reverse dependency: `runtime-remote-log-ingestion`
+     * does not import from this package.
      */
     readonly remoteLogSource?: RemoteLogSourceConfig | null;
 }
 export type ProfileValidationError = "EMPTY_NAME" | "EMPTY_CREDENTIAL_REF" | "INVALID_URL" | "INVALID_SAFETY_LEVEL" | "INVALID_MODE" | "REMOTE_LOG_SOURCE_NOT_ALLOWED_FOR_MODE";
 /**
- * Structural validation only — no attempt to reach `url` or verify the
- * credential exists. Reachability and secret presence are runtime
- * concerns; this stays a pure check so it can run before either is
- * possible (e.g. while a setup form is still being filled in).
+ * Structural validation only — doesn't reach `url` or verify the
+ * credential exists (runtime concerns), so it can run while a setup form
+ * is still being filled in.
  */
 export declare function validateProfile(input: {
     readonly name: string;
@@ -81,12 +59,7 @@ export declare function validateProfile(input: {
     readonly mode: string;
     readonly remoteLogSource?: RemoteLogSourceConfig | null;
 }): readonly ProfileValidationError[];
-/**
- * Validates and constructs a profile in one step. Throws with every
- * validation error joined, rather than the first one only, so a caller
- * building a setup form doesn't have to fix and resubmit one field at a
- * time.
- */
+/** Throws with every validation error joined, not just the first, so a setup form can show all problems at once. */
 export declare function createEnvironmentProfile(input: {
     readonly name: string;
     readonly url: string;

package/dist/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAEnF,0FAA0F;AAC1F,eAAO,MAAM,aAAa,2DAA4D,CAAC;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,aAAa,mEAAoE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2HAA2H;IAC3H,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,MAAM,sBAAsB,GAC9B,YAAY,GACZ,sBAAsB,GACtB,aAAa,GACb,sBAAsB,GACtB,cAAc,GACd,wCAAwC,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD,GAAG,SAAS,sBAAsB,EAAE,CA6BpC;AAWD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD,GAAG,kBAAkB,CAarB"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAEnF,0FAA0F;AAC1F,eAAO,MAAM,aAAa,2DAA4D,CAAC;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,8FAA8F;AAC9F,eAAO,MAAM,aAAa,mEAAoE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2HAA2H;IAC3H,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,MAAM,sBAAsB,GAC9B,YAAY,GACZ,sBAAsB,GACtB,aAAa,GACb,sBAAsB,GACtB,cAAc,GACd,wCAAwC,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD,GAAG,SAAS,sBAAsB,EAAE,CA2BpC;AAWD,oHAAoH;AACpH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzD,GAAG,kBAAkB,CAarB"}

package/dist/profile.js

@@ -1,42 +1,27 @@
 /**
- * Environment profile — DEC-270 (`documents/decisions-inbox/
- * DEC-270-environment-profiles-declare-safety-not-infer-it.md`), building on
- * DEC-266's four target kinds (local booted, local attached, remote
- * dev/staging/preview, production).
+ * DEC-270, building on DEC-266's four target kinds (local booted, local
+ * attached, remote dev/staging/preview, production).
  *
- * A profile is a **user-named** target: no fixed vocabulary. "staging"
- * means different things at different companies, so nothing here
- * pattern-matches on `name` — the safety level below is the only thing
- * that governs what is permitted, and it is always set explicitly by the
- * user, never guessed from the name or the URL.
+ * A profile is user-named, no fixed vocabulary — nothing here pattern-matches
+ * on `name`; `safetyLevel` alone governs what's permitted, always set
+ * explicitly by the user, never guessed from name or URL.
  *
- * `credentialRef` is a reference into a `CredentialStore` (see
- * `credential-store.ts`), never the raw secret — this type is safe to log,
- * serialize or hand to a planner without ever exposing what it points at.
+ * `credentialRef` is a reference into a `CredentialStore`, never the raw
+ * secret — safe to log, serialize, or hand to a planner.
  *
- * `mode` and `remoteLogSource` are RT-197/DEC-271's addition. Until this
- * pass `EnvironmentProfile` had no field naming which of DEC-266's four
- * kinds a given profile actually was — `@descryy/runtime-remote-log-ingestion`
- * existed with real tests and zero callers, and there was no profile-level
- * place for a "remote/production" target to declare where its logs live,
- * so nothing could have called it. `mode` closes that: it is what
- * `packages/orchestrator/src/profile-backend-observation.ts` reads to
- * choose DEC-271's mechanism — a real `InboundProxy` for `"localBooted"`,
+ * `mode`/`remoteLogSource` (RT-197/DEC-271) name which of DEC-266's four
+ * kinds a profile is; `profile-backend-observation.ts` reads `mode` to pick
+ * DEC-271's mechanism — `InboundProxy` for `"localBooted"`,
  * `remote-log-ingestion` for `"remote"`/`"production"`, never both.
  */
 /** Set once by the user per profile. Never inferred from `name` (DEC-270's core rule). */
 export const SAFETY_LEVELS = ["readOnly", "write", "destructiveWithApproval"];
-/**
- * DEC-266's four target kinds, named as a closed union for the first time
- * (RT-197). Set once by the user per profile, same discipline as
- * `safetyLevel` — never inferred from `name` or `url`.
- */
+/** DEC-266's four target kinds, closed union (RT-197). Never inferred, like `safetyLevel`. */
 export const PROFILE_MODES = ["localBooted", "localAttached", "remote", "production"];
 /**
- * Structural validation only — no attempt to reach `url` or verify the
- * credential exists. Reachability and secret presence are runtime
- * concerns; this stays a pure check so it can run before either is
- * possible (e.g. while a setup form is still being filled in).
+ * Structural validation only — doesn't reach `url` or verify the
+ * credential exists (runtime concerns), so it can run while a setup form
+ * is still being filled in.
  */
 export function validateProfile(input) {
     const errors = [];
@@ -55,9 +40,7 @@ export function validateProfile(input) {
     if (!PROFILE_MODES.includes(input.mode)) {
         errors.push("INVALID_MODE");
     }
-    // A log source declared on a mode DEC-271 never reads it for is a
-    // silently-ignored setting, not a harmless extra -- rejected rather than
-    // dropped, so the caller who set it learns it would not have been honored.
+    // Rejected rather than silently dropped -- caller learns it wouldn't be honored.
     if (input.remoteLogSource != null &&
         (input.mode === "localBooted" || input.mode === "localAttached")) {
         errors.push("REMOTE_LOG_SOURCE_NOT_ALLOWED_FOR_MODE");
@@ -73,12 +56,7 @@ function isParsableUrl(url) {
         return false;
     }
 }
-/**
- * Validates and constructs a profile in one step. Throws with every
- * validation error joined, rather than the first one only, so a caller
- * building a setup form doesn't have to fix and resubmit one field at a
- * time.
- */
+/** Throws with every validation error joined, not just the first, so a setup form can show all problems at once. */
 export function createEnvironmentProfile(input) {
     const errors = validateProfile(input);
     if (errors.length > 0) {

package/dist/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAU,CAAC;AAGvF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AA2C/F;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAO/B;IACC,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IACD,kEAAkE;IAClE,yEAAyE;IACzE,2EAA2E;IAC3E,IACE,KAAK,CAAC,eAAe,IAAI,IAAI;QAC7B,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,EAChE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAOxC;IACC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;QACzC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;KAC/C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,yBAAyB,CAAU,CAAC;AAGvF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAoC/F;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAO/B;IACC,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IACD,iFAAiF;IACjF,IACE,KAAK,CAAC,eAAe,IAAI,IAAI;QAC7B,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,EAChE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,wBAAwB,CAAC,KAOxC;IACC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;QACzC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;KAC/C,CAAC;AACJ,CAAC"}

package/dist/safety-gate.d.ts

@@ -1,11 +1,8 @@
 /**
- * Safety gate — the enforcement point DEC-270 requires: "Any destructive
- * action checks the profile's declared level before running, not the
- * environment's name or the fact that it's 'not prod.'"
- *
- * This function does not wire itself into any caller — DEC-270 only asks
- * that it exist and be correct; the runners that actually perform
- * destructive actions (a different lane's work) call it before acting.
+ * DEC-270's enforcement point: destructive actions check the profile's
+ * declared safety level, never the environment's name or "not prod."
+ * Not wired to any caller here — runners that perform destructive actions
+ * (a different lane) call this before acting.
  */
 import type { EnvironmentProfile } from "./profile.ts";
 export declare const GATE_DECISIONS: readonly ["allow", "deny", "requiresApproval"];
@@ -29,10 +26,9 @@ export interface ProposedAction {
  * | `write`                    | allow             | allow                  | deny        |
  * | `destructiveWithApproval`  | allow             | allow                  | requiresApproval |
  *
- * `write` denies destructive rather than escalating it to approval — a
- * profile owner who chose `write` explicitly did not choose
- * `destructiveWithApproval`, and DEC-270's whole point is that the level
- * is declared, not inferred or auto-upgraded.
+ * `write` denies destructive rather than escalating to approval — an
+ * owner who chose `write` did not choose `destructiveWithApproval`;
+ * DEC-270 requires the level be declared, not auto-upgraded.
  */
 export declare function evaluateAction(profile: EnvironmentProfile, action: ProposedAction): GateDecision;
 //# sourceMappingURL=safety-gate.d.ts.map

package/dist/safety-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safety-gate.d.ts","sourceRoot":"","sources":["../src/safety-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,cAAc,gDAAiD,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY,CAQhG"}
+{"version":3,"file":"safety-gate.d.ts","sourceRoot":"","sources":["../src/safety-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,cAAc,gDAAiD,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY,CAQhG"}

package/dist/safety-gate.js

@@ -1,11 +1,8 @@
 /**
- * Safety gate — the enforcement point DEC-270 requires: "Any destructive
- * action checks the profile's declared level before running, not the
- * environment's name or the fact that it's 'not prod.'"
- *
- * This function does not wire itself into any caller — DEC-270 only asks
- * that it exist and be correct; the runners that actually perform
- * destructive actions (a different lane's work) call it before acting.
+ * DEC-270's enforcement point: destructive actions check the profile's
+ * declared safety level, never the environment's name or "not prod."
+ * Not wired to any caller here — runners that perform destructive actions
+ * (a different lane) call this before acting.
  */
 export const GATE_DECISIONS = ["allow", "deny", "requiresApproval"];
 /**
@@ -17,10 +14,9 @@ export const GATE_DECISIONS = ["allow", "deny", "requiresApproval"];
  * | `write`                    | allow             | allow                  | deny        |
  * | `destructiveWithApproval`  | allow             | allow                  | requiresApproval |
  *
- * `write` denies destructive rather than escalating it to approval — a
- * profile owner who chose `write` explicitly did not choose
- * `destructiveWithApproval`, and DEC-270's whole point is that the level
- * is declared, not inferred or auto-upgraded.
+ * `write` denies destructive rather than escalating to approval — an
+ * owner who chose `write` did not choose `destructiveWithApproval`;
+ * DEC-270 requires the level be declared, not auto-upgraded.
  */
 export function evaluateAction(profile, action) {
     if (action.destructive) {

package/dist/safety-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety-gate.js","sourceRoot":"","sources":["../src/safety-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAU,CAAC;AAc7E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B,EAAE,MAAsB;IAChF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,WAAW,KAAK,yBAAyB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;IACzF,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"safety-gate.js","sourceRoot":"","sources":["../src/safety-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAU,CAAC;AAc7E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B,EAAE,MAAsB;IAChF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,WAAW,KAAK,yBAAyB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;IACzF,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@descryy/runtime-environment-profile",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Environment profiles per DEC-270/DEC-266: a user-named target (local booted/attached, remote dev/staging/preview, production) carrying a declared safety level, scoped credentials, and the safety-gate enforcement point destructive actions must call before running.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-runtime.git",
+    "directory": "packages/environment-profile"
+  },
   "engines": {
     "node": ">=22.5"
   },
@@ -24,6 +29,6 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-remote-log-ingestion": "0.3.0"
+    "@descryy/runtime-remote-log-ingestion": "0.4.0"
   }
 }