@sonisoft/now-sdk-ext-cli 5.0.1 → 5.2.0

package/dist/commands/policy/status.d.ts

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+/**
+ * Reports what this invocation is permitted to do, and which layer decided.
+ *
+ * Exists because precedence bugs are otherwise invisible: a user sees "refused" with no
+ * way to tell whether the environment denied it, a flag denied it, or nothing granted
+ * it — and the fix is completely different in each case.
+ *
+ * Extends plain `Command`, not `AuthenticatedCommand`: answering "what may I do" must
+ * not require working credentials. Someone diagnosing a refusal should not have to get
+ * past auth first.
+ */
+export default class PolicyStatus extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'deny-execute': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'deny-write': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'read-only': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<{
+        permitted: Record<string, unknown>;
+        source: string;
+    }>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/policy/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/policy/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAQ,MAAM,aAAa,CAAA;AAK1C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,MAAM,CAAC,WAAW,SAIG;IACvB,MAAM,CAAC,cAAc,UAAO;IAC5B,MAAM,CAAC,QAAQ,WAIZ;IACH,MAAM,CAAC,KAAK;;;;MAIT;IAEY,GAAG,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;CA2ClF"}

package/dist/commands/policy/status.js

@@ -0,0 +1,67 @@
+import { Command, Flags } from '@oclif/core';
+import { checkRequirement, currentLayers, DENY_ENV } from '@sonisoft/now-sdk-ext-core';
+import { installCliPolicy } from '../../common/policy.js';
+/**
+ * Reports what this invocation is permitted to do, and which layer decided.
+ *
+ * Exists because precedence bugs are otherwise invisible: a user sees "refused" with no
+ * way to tell whether the environment denied it, a flag denied it, or nothing granted
+ * it — and the fix is completely different in each case.
+ *
+ * Extends plain `Command`, not `AuthenticatedCommand`: answering "what may I do" must
+ * not require working credentials. Someone diagnosing a refusal should not have to get
+ * past auth first.
+ */
+export default class PolicyStatus extends Command {
+    static description = 'Show what this invocation is permitted to change on the instance, and why.\n\n' +
+        'Changes are permitted by default. NEX_POLICY_DENY, set in the environment, ' +
+        'outranks every command-line flag — that is the only layer an agent driving this ' +
+        'CLI cannot reach.';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --read-only',
+        'NEX_POLICY_DENY=all <%= config.bin %> <%= command.id %>',
+    ];
+    static flags = {
+        'deny-execute': Flags.boolean({ description: 'Evaluate as if --deny-execute were passed.' }),
+        'deny-write': Flags.boolean({ description: 'Evaluate as if --deny-write were passed.' }),
+        'read-only': Flags.boolean({ description: 'Evaluate as if --read-only were passed.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(PolicyStatus);
+        const warnings = [];
+        installCliPolicy(flags, (m) => warnings.push(m));
+        const verbs = ['write', 'execute'];
+        const permitted = {};
+        for (const verb of verbs) {
+            const decision = checkRequirement({ target: 'instance', verbs: [verb] });
+            permitted[verb] = { allowed: decision.allowed, decidedBy: decision.decidingLayer };
+        }
+        const envSet = Boolean(process.env[DENY_ENV]);
+        const result = { permitted, source: envSet ? `${DENY_ENV} is set` : 'no environment lockdown' };
+        if (!this.jsonEnabled()) {
+            this.log('Instance changes');
+            for (const verb of verbs) {
+                const entry = permitted[verb];
+                const mark = entry.allowed ? 'permitted' : 'REFUSED  ';
+                this.log(`  ${verb.padEnd(8)} ${mark}  (${entry.decidedBy})`);
+            }
+            this.log('');
+            this.log('Reads are never gated.');
+            this.log(envSet
+                ? `${DENY_ENV} is set in the environment and outranks every flag.`
+                : `${DENY_ENV} is not set. Set it in your shell profile or container ` +
+                    `environment to deny changes in a way a command-line flag cannot undo.`);
+            // Ordered, because the order IS the behaviour.
+            this.log('');
+            this.log('Layers, highest priority first:');
+            for (const layer of currentLayers())
+                this.log(`  ${layer.name}`);
+            for (const warning of warnings)
+                this.warn(warning);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/policy/status.js.map

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

package/dist/common/authenticated-command.d.ts

@@ -6,7 +6,12 @@ export declare abstract class AuthenticatedCommand<T extends typeof Command> ext
     static baseFlags: {
         auth: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         'cred-store': Interfaces.BooleanFlag<boolean>;
+        'deny-execute': Interfaces.BooleanFlag<boolean>;
+        'deny-write': Interfaces.BooleanFlag<boolean>;
+        'log-dir': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'log-file': Interfaces.BooleanFlag<boolean>;
         'log-level': Interfaces.OptionFlag<"info" | "debug" | "warn" | "error" | "trace", Interfaces.CustomOptions>;
+        'read-only': Interfaces.BooleanFlag<boolean>;
     };
     static enableJsonFlag: boolean;
     protected _logger: Logger;
@@ -21,6 +26,13 @@ export declare abstract class AuthenticatedCommand<T extends typeof Command> ext
     }): Promise<any>;
     protected finally(_: Error | undefined): Promise<any>;
     init(): Promise<void>;
+    /**
+     * Whether --log-level was given on the command line rather than defaulted.
+     *
+     * oclif reports its own default as a parsed value, so `flags['log-level']` cannot
+     * distinguish "the user asked for info" from "nobody said anything".
+     */
+    private argvHasLogLevel;
     /**
      * Fail with remediation the user can act on.
      *

package/dist/common/authenticated-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authenticated-command.d.ts","sourceRoot":"","sources":["../../src/common/authenticated-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAA8B,MAAM,4BAA4B,CAAC;AAMpG,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAA;AAC7H,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAE/E,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,OAAO;IAElF,MAAM,CAAC,SAAS;;;;MAmBf;IAEC,MAAM,CAAC,cAAc,UAAO;IAChC,SAAS,CAAC,OAAO,EAAG,MAAM,CAAC;IACvB,SAAS,CAAC,IAAI,EAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEnC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAE/B;cAEa,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,GAAG,CAAC;cAUrD,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAK9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDlC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;CA0BjB"}
+{"version":3,"file":"authenticated-command.d.ts","sourceRoot":"","sources":["../../src/common/authenticated-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAgD,MAAM,EAAE,kBAAkB,EAA8B,MAAM,4BAA4B,CAAC;AAOlJ,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAA;AAC7H,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAE/E,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,OAAO;IAElF,MAAM,CAAC,SAAS;;;;;;;;;MA4Df;IAEC,MAAM,CAAC,cAAc,UAAO;IAChC,SAAS,CAAC,OAAO,EAAG,MAAM,CAAC;IACvB,SAAS,CAAC,IAAI,EAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAEnC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAE/B;cAEa,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,GAAG,CAAC;cA8BrD,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAO9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiFlC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;CA0BjB"}

package/dist/common/authenticated-command.js

@@ -1,7 +1,8 @@
 import { Command, Flags } from '@oclif/core';
 import { getCredentials } from "@servicenow/sdk-cli/dist/auth/index.js";
-import { ServiceNowInstance } from '@sonisoft/now-sdk-ext-core';
+import { configureLogging, flushLogs, isPolicyRefusal, ServiceNowInstance } from '@sonisoft/now-sdk-ext-core';
 import { LogFactory } from '../util/log-factory.js';
+import { installCliPolicy } from './policy.js';
 export class AuthenticatedCommand extends Command {
     //   // define flags that can be inherited by any command that extends BaseCommand
     static baseFlags = {
@@ -16,12 +17,53 @@ export class AuthenticatedCommand extends Command {
             helpGroup: 'GLOBAL',
             required: false,
         }),
+        // Changes are PERMITTED by default; these take permission away.
+        //
+        // Deliberately deny-direction rather than `--allow-write`. With a permissive
+        // default an allow-flag would grant nothing it did not already have, and it could
+        // not override NEX_POLICY_DENY either, so it would ship as a no-op. If the default
+        // ever flips to deny, the allow flags arrive in that same change.
+        //
+        // These are agent-reachable, which is fine: an agent can only ever RESTRICT itself
+        // with them. The layer an agent cannot reach is NEX_POLICY_DENY, which outranks
+        // every flag — that is what makes pointing nex at production meaningful.
+        'deny-execute': Flags.boolean({
+            description: 'Refuse background scripts, flow runs and ATF runs for this invocation.',
+            helpGroup: 'GLOBAL',
+            required: false,
+        }),
+        'deny-write': Flags.boolean({
+            description: 'Refuse any change to instance data for this invocation.',
+            helpGroup: 'GLOBAL',
+            required: false,
+        }),
+        'log-dir': Flags.string({
+            description: 'Directory to write log files to. Implies --log-file.',
+            helpGroup: 'GLOBAL',
+            required: false,
+        }),
+        // Logging to a file is opt-in. It used to be unconditional, writing
+        // ./logs/*.log into whatever directory nex happened to be run from — including
+        // CI checkouts — with no way to turn it off. See NEX-3.
+        'log-file': Flags.boolean({
+            description: 'Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs ' +
+                '(~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs ' +
+                'warnings and errors to stderr only.',
+            helpGroup: 'GLOBAL',
+            required: false,
+        }),
         'log-level': Flags.option({
             default: 'info',
             helpGroup: 'GLOBAL',
             options: ['debug', 'warn', 'error', 'info', 'trace'],
             summary: 'Specify level for logging.',
         })(),
+        'read-only': Flags.boolean({
+            description: 'Refuse every change to the instance — equivalent to ' +
+                '--deny-write --deny-execute. Reads are unaffected.',
+            helpGroup: 'GLOBAL',
+            required: false,
+        }),
     };
     // add the --json flag
     static enableJsonFlag = true;
@@ -37,15 +79,35 @@ export class AuthenticatedCommand extends Command {
         this._logger = logger;
     }
     async catch(err) {
+        // A refusal is a decision, not a crash. Render it as the CLI's own error with
+        // remediation, rather than letting a stack trace reach the user for something they
+        // asked for by passing a flag. Handled first, before the generic path below.
+        if (isPolicyRefusal(err)) {
+            this.authLogger?.warn("Refused by policy.", { message: err.message });
+            await flushLogs();
+            this.error(err.message, {
+                suggestions: [
+                    'Reads are unaffected — only changes to the instance were refused.',
+                    'Run `nex policy status` to see what is permitted and which layer decided.',
+                ],
+            });
+        }
         // authLogger is assigned partway through init(), so anything that throws
         // before that point — a missing required flag, for instance — arrived here
         // with it still undefined and produced "Cannot read properties of undefined
         // (reading 'error')", hiding the actual usage error behind a TypeError.
         this.authLogger?.error("Globally caught exception occurred.", err);
+        // Flush HERE, not only in finally(). super.catch() routes into oclif's error
+        // handler, which can terminate the process — so finally() is not guaranteed to
+        // run, and the record that just got logged is precisely the one worth keeping.
+        // Winston buffers, so without this the failure line is lost intermittently.
+        await flushLogs();
         return super.catch(err);
     }
     async finally(_) {
-        // called after run and catch regardless of whether or not the command errored
+        // called after run and catch regardless of whether or not the command errored.
+        // Covers the success path; the failure path already flushed in catch().
+        await flushLogs();
         return super.finally(_);
     }
     async init() {
@@ -63,8 +125,31 @@ export class AuthenticatedCommand extends Command {
         // value under that exact name. Reading `flags.logLevel` always yielded
         // undefined, silently pinning every command to 'info'.
         const logLevel = this.flags['log-level'] || 'info';
-        this.logger = LogFactory.createLogger(this.ctor.name, logLevel);
-        this.authLogger = LogFactory.createLogger("AuthenticatedCommand", logLevel);
+        const logDir = this.flags['log-dir'];
+        // Configure BEFORE creating any logger. Core's loggers are field initializers on
+        // ~43 manager classes and take no arguments, so this process-wide call is the only
+        // thing that reaches them — a per-logger level never did.
+        configureLogging({
+            // --log-dir implies --log-file; requiring both would make `--log-dir ./x` alone
+            // silently produce nothing, which reads as a broken flag.
+            dir: logDir,
+            file: Boolean(this.flags['log-file']) || Boolean(logDir),
+            level: logLevel,
+            // --json puts machine-readable output on stdout. Warnings on stderr do not
+            // corrupt it, but they do land in a terminal the caller is likely piping, so
+            // stay quiet unless the level was asked for explicitly.
+            ...(this.jsonEnabled() && !this.argvHasLogLevel() ? { consoleLevel: 'error' } : {}),
+        });
+        this.logger = LogFactory.createLogger(this.ctor.name);
+        this.authLogger = LogFactory.createLogger("AuthenticatedCommand");
+        // Install the permission ladder before anything can issue a request. Core's gate
+        // is inert until this runs, so ordering matters: after logging (so a malformed
+        // NEX_POLICY_DENY has somewhere to warn) and before the first credential fetch.
+        //
+        // Note there is no per-command classification. The gate sits at the HTTP layer and
+        // decides per REQUEST, so `update-set current` reading or writing depending on
+        // --set, and `script-sync sync` going both ways, need no special handling here.
+        installCliPolicy(this.flags, (message) => this.authLogger.warn(message));
         // const wrapper:CredentialWrapper = new CredentialWrapper();
         // const credential:Creds = await (flags.auth ? wrapper.getStoredCredentialsByAlias(flags.auth) : wrapper.getStoredCredentialsByAlias( 'fluent-default'));
         // const credentialArgs = {"_": "get-credentials", auth: flags.auth || "fluent-default"};
@@ -96,6 +181,15 @@ export class AuthenticatedCommand extends Command {
         };
         this.instance = new ServiceNowInstance(snSettings);
     }
+    /**
+     * Whether --log-level was given on the command line rather than defaulted.
+     *
+     * oclif reports its own default as a parsed value, so `flags['log-level']` cannot
+     * distinguish "the user asked for info" from "nobody said anything".
+     */
+    argvHasLogLevel() {
+        return this.argv.some((a) => a === '--log-level' || a.startsWith('--log-level='));
+    }
     /**
      * Fail with remediation the user can act on.
      *

package/dist/common/authenticated-command.js.map

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

package/dist/common/policy.d.ts

@@ -0,0 +1,32 @@
+import { type PolicyLayer, Verb } from '@sonisoft/now-sdk-ext-core';
+/**
+ * Builds and installs the permission ladder for one `nex` invocation.
+ *
+ * Changes are PERMITTED by default. This is not the strongest posture available — an
+ * agent that decides to run `nex bulk delete` still just does it — but it is the one
+ * that does not break every existing script and CI job, and the machinery is arranged
+ * so flipping is a one-line change (see DEFAULT_ALLOW below).
+ *
+ * What it does buy today: `NEX_POLICY_DENY`, set somewhere the agent cannot write,
+ * outranks every flag. That is the difference between "the agent probably will not
+ * write to prod" and "the agent cannot".
+ */
+export interface PolicyFlags {
+    'deny-execute'?: boolean;
+    'deny-write'?: boolean;
+    'read-only'?: boolean;
+}
+/** The verbs a set of flags takes away. */
+export declare function deniedByFlags(flags: PolicyFlags): Verb[];
+/**
+ * Assembles the ladder, highest priority first.
+ *
+ * Order is the whole design. `NEX_POLICY_DENY` sits above the flags so a flag cannot
+ * grant past it; the permissive default sits at the bottom so anything above it can
+ * take permission away.
+ */
+export declare function buildLayers(flags: PolicyFlags, warn: (message: string) => void): PolicyLayer[];
+/** Installs the policy for this process. Call once, from init(), before any request. */
+export declare function installCliPolicy(flags: PolicyFlags, warn: (message: string) => void): void;
+export { ALLOW_ENV, DENY_ENV } from '@sonisoft/now-sdk-ext-core';
+//# sourceMappingURL=policy.d.ts.map

package/dist/common/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/common/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,WAAW,EAEhB,IAAI,EACL,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,CAUxD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,EAAE,CAuB9F;AAwBD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAG1F;AAID,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,4BAA4B,CAAA"}

package/dist/common/policy.js

@@ -0,0 +1,68 @@
+import { allowFromEnvironment, DENY_ENV, denyFromEnvironment, denyLayer, grantLayer, installPolicy, setRemediationWriter, } from '@sonisoft/now-sdk-ext-core';
+/** The verbs a set of flags takes away. */
+export function deniedByFlags(flags) {
+    const denied = new Set();
+    if (flags['read-only']) {
+        denied.add('write');
+        denied.add('execute');
+    }
+    if (flags['deny-write'])
+        denied.add('write');
+    if (flags['deny-execute'])
+        denied.add('execute');
+    return [...denied];
+}
+/**
+ * Assembles the ladder, highest priority first.
+ *
+ * Order is the whole design. `NEX_POLICY_DENY` sits above the flags so a flag cannot
+ * grant past it; the permissive default sits at the bottom so anything above it can
+ * take permission away.
+ */
+export function buildLayers(flags, warn) {
+    const layers = [];
+    // 0. Operator lockdown. The only rung an agent cannot reach — and only when set
+    //    somewhere it cannot write. A project-local .mcp.json or a committed .env is
+    //    still editable by anything with file access; a shell profile is not.
+    const envDeny = denyFromEnvironment(process.env, warn);
+    if (envDeny)
+        layers.push(envDeny);
+    // 1. Per-invocation denials. Agent-reachable, but they only ever restrict.
+    const flagDenied = deniedByFlags(flags);
+    if (flagDenied.length > 0)
+        layers.push(denyLayer('command-line flag', flagDenied));
+    // 2. Grants from the environment. Inert while the default is permissive; kept in
+    //    place so the ladder does not have to be rebuilt when the default flips.
+    const envAllow = allowFromEnvironment(process.env, warn);
+    if (envAllow)
+        layers.push(envAllow);
+    // 3. THE DEFAULT. Delete this one layer to make `nex` deny-by-default; everything
+    //    above keeps working unchanged.
+    layers.push(grantLayer('default (changes permitted)', ['write', 'execute']));
+    return layers;
+}
+/**
+ * Explains a refusal in terms of what the user can actually do about it.
+ *
+ * Names the deciding layer, because "refused" without "by what" is unactionable — and
+ * the fix differs completely: unset an environment variable, or drop a flag.
+ */
+function remediation(verbs, missing, layer) {
+    const what = missing === 'execute' ? 'running scripts or flows' : 'changing instance data';
+    if (layer.startsWith(DENY_ENV)) {
+        return `Refused: ${what} is denied by ${DENY_ENV}. ` +
+            `This is set in the environment, not on the command line — unset it there to allow this.`;
+    }
+    if (layer === 'command-line flag') {
+        return `Refused: ${what} is denied by a flag on this command. ` +
+            `Remove --read-only / --deny-${missing} to allow it.`;
+    }
+    return `Refused: ${what} is not permitted (${layer}).`;
+}
+/** Installs the policy for this process. Call once, from init(), before any request. */
+export function installCliPolicy(flags, warn) {
+    installPolicy(buildLayers(flags, warn));
+    setRemediationWriter(remediation);
+}
+export { ALLOW_ENV, DENY_ENV } from '@sonisoft/now-sdk-ext-core';
+//# sourceMappingURL=policy.js.map

package/dist/common/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/common/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,aAAa,EAEb,oBAAoB,GAErB,MAAM,4BAA4B,CAAA;AAqBnC,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAQ,CAAA;IAC9B,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACnB,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,KAAK,CAAC,cAAc,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,IAA+B;IAC7E,MAAM,MAAM,GAAkB,EAAE,CAAA;IAEhC,gFAAgF;IAChF,iFAAiF;IACjF,0EAA0E;IAC1E,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACtD,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEjC,2EAA2E;IAC3E,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,CAAA;IAElF,iFAAiF;IACjF,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACxD,IAAI,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEnC,kFAAkF;IAClF,oCAAoC;IACpC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAE5E,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAsB,EAAE,OAAa,EAAE,KAAa;IACvE,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,wBAAwB,CAAA;IAE1F,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,YAAY,IAAI,iBAAiB,QAAQ,IAAI;YAClD,yFAAyF,CAAA;IAC7F,CAAC;IAED,IAAI,KAAK,KAAK,mBAAmB,EAAE,CAAC;QAClC,OAAO,YAAY,IAAI,wCAAwC;YAC7D,+BAA+B,OAAO,eAAe,CAAA;IACzD,CAAC;IAED,OAAO,YAAY,IAAI,sBAAsB,KAAK,IAAI,CAAA;AACxD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,IAA+B;IAClF,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;IACvC,oBAAoB,CAAC,WAAW,CAAC,CAAA;AACnC,CAAC;AAID,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,4BAA4B,CAAA"}

package/dist/util/log-factory.d.ts

@@ -1,5 +1,11 @@
 import { Logger } from "@sonisoft/now-sdk-ext-core";
 export declare class LogFactory {
-    static createLogger(name: string, level?: string): Logger;
+    /**
+     * The level is NOT a parameter any more. Core builds one logger for the process,
+     * so a per-logger level would only ever have applied to the two loggers created
+     * here and never to the ~43 inside core. Set it with `configureLogging({level})`,
+     * which AuthenticatedCommand.init does before calling this.
+     */
+    static createLogger(name: string): Logger;
 }
 //# sourceMappingURL=log-factory.d.ts.map

package/dist/util/log-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-factory.d.ts","sourceRoot":"","sources":["../../src/util/log-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,qBAAa,UAAU;WACL,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAe,GAAG,MAAM;CAI3E"}
+{"version":3,"file":"log-factory.d.ts","sourceRoot":"","sources":["../../src/util/log-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,qBAAa,UAAU;IACnB;;;;;OAKG;WACW,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGnD"}

package/dist/util/log-factory.js

@@ -1,8 +1,13 @@
 import { Logger } from "@sonisoft/now-sdk-ext-core";
 export class LogFactory {
-    static createLogger(name, level = 'info') {
-        const logger = new Logger(name, level);
-        return logger;
+    /**
+     * The level is NOT a parameter any more. Core builds one logger for the process,
+     * so a per-logger level would only ever have applied to the two loggers created
+     * here and never to the ~43 inside core. Set it with `configureLogging({level})`,
+     * which AuthenticatedCommand.init does before calling this.
+     */
+    static createLogger(name) {
+        return new Logger(name);
     }
 }
 //# sourceMappingURL=log-factory.js.map

package/dist/util/log-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-factory.js","sourceRoot":"","sources":["../../src/util/log-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,MAAM,OAAO,UAAU;IACZ,MAAM,CAAC,YAAY,CAAC,IAAY,EAAE,QAAgB,MAAM;QAC3D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}
+{"version":3,"file":"log-factory.js","sourceRoot":"","sources":["../../src/util/log-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,MAAM,OAAO,UAAU;IACnB;;;;;OAKG;IACI,MAAM,CAAC,YAAY,CAAC,IAAY;QACnC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACJ"}