configre 2.1.0 → 2.1.4

package/README.md

@@ -124,7 +124,24 @@ const cfg = Configre(configPath);
 
 Secrets activate automatically when the base configuration or selected profile has a corresponding `.secret.cjs` file, or when `secrets.enc.json` already exists. No options are needed. Loading remains synchronous, and your application reads the result through ordinary properties such as `cfg.api.key`.
 
-> The demo reports `API key configured:` without printing the key. Avoid logging `cfg` in your application: it contains the decrypted secrets.
+> The demo reports `API key configured:` without printing the key. Avoid logging `cfg` in your application: it contains the decrypted secrets. Use `cfg.print()` to log configuration with secret fields omitted.
+
+```javascript
+const cfg = Configre(configPath);
+cfg.print();
+```
+
+`print()` calls Configre's `log.debug`; enable its output with `DEBUG=Configre:*`.
+It omits fields supplied by the base and selected profile's `.secret.cjs` files,
+including when loaded from the encrypted file. Public siblings in nested objects
+remain visible; arrays supplied by secrets are omitted entirely. It does not
+modify the configuration or log automatically on load. `cfg.print()` logs its
+current values, including changes made after loading. The method is non-enumerable
+and does not appear in `Object.keys(cfg)`, object spreads or JSON output.
+`new Configre(configPath).print()` is also supported. If your configuration already
+has a field named `print`, that value is preserved; use the constructor API to print it.
+Sensitivity is determined by secret-file fields, not by names such as `password`
+or `token`: keep sensitive values in `.secret.cjs` files, not in public settings.
 
 ### 1. Start the demo on the administrator machine
 
@@ -224,9 +241,11 @@ If this server is not authorized yet, Configre automatically:
 1. Creates its local identity, if needed.
 2. Writes `demo/secrets/config/recipients/truco.pub`.
 3. Creates and pushes a commit containing only that public-key file.
-4. Stops startup with a message explaining that the administrator must publish an updated encrypted file.
+4. Logs a warning and continues with public configuration only until the administrator publishes an updated encrypted file.
+
+Publishing a public key does not let the server decrypt the existing ciphertext. While authorization is pending, `cfg` preserves the public defaults and selected public profile; fields that exist only in the encrypted file are absent. Repeating the command does not publish another registration commit for the same key. If Git registration fails, Configre logs a warning and still returns public settings; the next Configre load retries registration.
 
-This first stop is expected: publishing a public key does not let the server decrypt the existing ciphertext. Repeating the command does not publish another registration commit for the same key.
+Configre uses `log.info` when it creates identity files, writes Git exclusions, creates the recipients directory or a public-key file, updates the encrypted file, and successfully pushes the public key. Messages contain operation names and file paths, never secret values or key contents. These messages use the existing `Configre` LemonLog namespace; use `DEBUG=Configre:*` to display them. Unchanged files and previously published public keys do not generate another creation or publication log.
 
 ### 4. Include the server in the encrypted file
 
@@ -281,7 +300,7 @@ To revoke this server, remove `demo/secrets/config/recipients/truco.pub`, run th
 - Each OS user has one identity reused across projects; authorization is per project. A service running under another OS user needs its own registration. All authorized identities can decrypt all profiles in the project's encrypted file.
 - Public recipient files must contain a single RSA-3072 public key in PEM format, with exponent 65537, as generated by Configre. Other file extensions are ignored, and duplicate keys do not add recipients. The administrator is always included.
 - Registration uses an isolated Git index and publishes only the public-key file. It preserves unrelated staged and unstaged changes, runs no commit or pre-push hooks, and does not push local tags, merge, rebase or force-push. Failed registrations can be retried at the next startup; each Git command has a 30-second timeout. An authorized server loads secrets without Git commands or project writes.
-- Registration names must start with a letter or digit and contain only letters, digits, dots, underscores or hyphens. If another key already occupies `truco.pub`, Configre stops without overwriting it; use a distinct profile or resolve the key replacement explicitly.
+- Registration names must start with a letter or digit and contain only letters, digits, dots, underscores or hyphens. If another key already occupies `truco.pub`, registration stops without overwriting it, and configuration loading continues with a warning and public settings only; use a distinct profile or resolve the key replacement explicitly.
 - Configre appends Git exclusions without removing existing rules and refuses to proceed on the administrator if editable secret modules are already tracked. It does not untrack files or rewrite history. It also prepares `.gitignore` when no repository exists yet.
 - The administrator's `.secret.cjs` files are the source of truth for values, and `recipients/` is the source of truth for authorization. Removing all recipient files revokes them on the next administrator reload; old ciphertext does not restore them. Recover accidentally deleted public-key files from Git before reloading. Missing Git exclusions and ciphertext are regenerated on the administrator, and existing secret modules are never overwritten.
 - Back up the administrator's editable secrets and private identity securely. Never share or commit `identity.pem`. On POSIX, its directory must have owner-only permissions (`0700`) and the private file must have owner-only permissions (`0600`); on Windows, protection depends on the user profile's filesystem permissions. Private identities and secret input files cannot be symlinks.

package/demo/secrets/demo.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 
 const configPath = join(import.meta.dirname, "config");
 const cfg = Configre(configPath);
+cfg.print();
 console.info("API key configured:", Boolean(cfg.api.key));
 console.info(`Set api.key in ${join(configPath, "index.secret.cjs")} and run this demo again.`);
 console.info(`New servers automatically publish their public key in ${join(configPath, "recipients")}. Pull and rerun here to authorize them.`);

package/index.js

@@ -9,6 +9,28 @@ import loadSecrets from "./secrets/index.js";
 const requireConfig = createRequire(import.meta.url);
 const log = lemonlog("Configre");
 
+function omitSecrets(settings, secrets) {
+    for (const [key, value] of Object.entries(secrets)) {
+        if (!Object.hasOwn(settings, key)) continue;
+        const current = settings[key];
+        if (value !== null && typeof value === "object" && !Array.isArray(value) &&
+            current !== null && typeof current === "object" && !Array.isArray(current)) {
+            omitSecrets(current, value);
+            if (Object.keys(current).length === 0) delete settings[key];
+        } else {
+            delete settings[key];
+        }
+    }
+}
+
+function printSettings(settings, secretSettings) {
+    const output = merge({}, settings);
+    for (const secrets of secretSettings) {
+        omitSecrets(output, secrets);
+    }
+    log.debug(output);
+}
+
 class ConfigreClass {
     constructor(pathOrDir) {
         if (typeof pathOrDir !== "string" || pathOrDir.length === 0) {
@@ -83,6 +105,10 @@ class ConfigreClass {
     get() {
         return merge({}, this.defaultSettings, this.profileSettings, ...this.secretSettings);
     }
+
+    print() {
+        printSettings(this.get(), this.secretSettings);
+    }
 }
 
 // Wrapper function to support both constructor and function usage
@@ -90,7 +116,14 @@ function Configre(path) {
     if (this instanceof Configre) {
         return new ConfigreClass(path);
     } else {
-        return new ConfigreClass(path).get();
+        const config = new ConfigreClass(path);
+        const settings = config.get();
+        if (!Object.hasOwn(settings, "print")) {
+            Object.defineProperty(settings, "print", {
+                value: () => printSettings(settings, config.secretSettings)
+            });
+        }
+        return settings;
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "configre",
-  "version": "2.1.0",
+  "version": "2.1.4",
   "description": "🔧 Effortlessly Tailor Your Settings",
   "type": "module",
   "engines": {

package/secrets/identity.js

@@ -3,12 +3,15 @@ import os from "node:os";
 import path from "node:path";
 import { generatePrivateKey, parsePrivateKey, parsePublicKey } from "./crypto.js";
 import { stat, readText, withLock } from "./files.js";
+import log from "./log.js";
 
 function loadIdentity() {
     const directory = path.join(os.homedir(), ".config", "configre");
     const privatePath = path.join(directory, "identity.pem");
     const publicPath = path.join(directory, "identity.pub");
-    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    if (fs.mkdirSync(directory, { recursive: true, mode: 0o700 })) {
+        log.info("Created identity directory", directory);
+    }
     const info = stat(directory);
     if (!info.isDirectory() || (process.platform !== "win32" && (info.mode & 0o077) !== 0)) {
         throw new Error(`Configre secrets: identity directory must be private and not a symlink at ${directory}`);
@@ -32,10 +35,12 @@ function loadIdentity() {
                 throw new Error("Configre secrets: private identity is missing; restore it instead of replacing it");
             }
             fs.writeFileSync(privatePath, generatePrivateKey(), { flag: "wx", mode: 0o600 });
+            log.info("Created private identity file", privatePath);
         }
         const identity = parsePrivateKey(readText(privatePath, true));
         if (!stat(publicPath)) {
             fs.writeFileSync(publicPath, identity.publicKey, { flag: "wx", mode: 0o644 });
+            log.info("Created public identity file", publicPath);
         }
         return readIdentity();
     });

package/secrets/index.js

@@ -5,6 +5,7 @@ import { isDeepStrictEqual } from "node:util";
 import { createRequire } from "node:module";
 import loadIdentity from "./identity.js";
 import registerRecipient from "./register.js";
+import log from "./log.js";
 import { parsePublicKey, validateSecrets, encrypt, decrypt } from "./crypto.js";
 import { stat, readText, readJSON, withLock, writeEncrypted } from "./files.js";
 
@@ -63,11 +64,15 @@ function prepareIgnore(paths) {
     const lines = existing.split(/\r?\n/).filter(line => line && !line.startsWith("#"));
     if (!isDeepStrictEqual(lines.slice(-rules.length), rules)) {
         fs.appendFileSync(ignorePath, (existing && !existing.endsWith("\n") ? "\n" : "") + rules.join("\n") + "\n");
+        log.info("Wrote Git exclusions for secret files", ignorePath);
     }
 }
 
 function loadRecipients(directory, identity) {
-    if (!stat(directory)) fs.mkdirSync(directory, { mode: 0o700 });
+    if (!stat(directory)) {
+        fs.mkdirSync(directory, { mode: 0o700 });
+        log.info("Created recipients directory", directory);
+    }
     if (!stat(directory).isDirectory()) {
         throw new Error("Configre secrets: recipients must be a directory, not a symlink");
     }
@@ -129,36 +134,45 @@ function loadSecrets(configPath, configFile, profile) {
     if (!hasLocal && !hasEncrypted) return [];
 
     const identity = loadIdentity();
-    if (names.length === 0 && hasEncrypted) {
-        try {
+    try {
+        if (names.length === 0 && hasEncrypted) {
             return selectSecrets(validateBundle(decrypt(readJSON(paths.encrypted), identity)), paths, profile);
-        } catch (error) {
-            if (error.code !== "CONFIGRE_NOT_AUTHORIZED") throw error;
-            registerRecipient(paths, identity, profile);
-            throw new Error("Configre secrets: not authorized yet; public key is published in Git. The administrator must pull, reload Configre and publish secrets.enc.json; then pull the updated encrypted file and restart this machine");
         }
-    }
 
-    const bundle = withLock(paths.encrypted, () => {
-        const names = localFiles(paths);
-        const hasEncrypted = !!stat(paths.encrypted);
-        const envelope = hasEncrypted ? readJSON(paths.encrypted) : null;
-        const previous = hasEncrypted ? validateBundle(decrypt(envelope, identity)) : null;
-        if (names.length === 0 && hasEncrypted) return previous;
+        const bundle = withLock(paths.encrypted, () => {
+            const names = localFiles(paths);
+            const hasEncrypted = !!stat(paths.encrypted);
+            const envelope = hasEncrypted ? readJSON(paths.encrypted) : null;
+            const previous = hasEncrypted ? validateBundle(decrypt(envelope, identity)) : null;
+            if (names.length === 0 && hasEncrypted) return previous;
 
-        prepareIgnore(paths);
-        const settings = { files: Object.fromEntries(names.map(name => [name, readSecret(path.join(paths.parent, name))])) };
-        const recipients = loadRecipients(paths.recipients, identity);
-        if (hasEncrypted) {
-            const previousRecipients = envelope.recipients.map(({ fingerprint, publicKey }) => ({ fingerprint, publicKey }));
-            if (isDeepStrictEqual(settings, previous) && isDeepStrictEqual(recipients, previousRecipients)) {
-                return settings;
+            prepareIgnore(paths);
+            const settings = { files: Object.fromEntries(names.map(name => [name, readSecret(path.join(paths.parent, name))])) };
+            const recipients = loadRecipients(paths.recipients, identity);
+            if (hasEncrypted) {
+                const previousRecipients = envelope.recipients.map(({ fingerprint, publicKey }) => ({ fingerprint, publicKey }));
+                if (isDeepStrictEqual(settings, previous) && isDeepStrictEqual(recipients, previousRecipients)) {
+                    return settings;
+                }
             }
+            writeEncrypted(paths.encrypted, encrypt(settings, recipients));
+            log.info(hasEncrypted ? "Updated encrypted secrets file" : "Created encrypted secrets file", paths.encrypted);
+            return settings;
+        });
+        return selectSecrets(bundle, paths, profile);
+    } catch (error) {
+        if (error.code !== "CONFIGRE_NOT_AUTHORIZED") throw error;
+        let registration = "Public key is published in Git. The administrator must pull, reload Configre and publish secrets.enc.json; then pull the updated encrypted file and reload Configre.";
+        try {
+            registerRecipient(paths, identity, profile);
+        } catch (registrationError) {
+            registration = registrationError.code === "CONFIGRE_REGISTRATION_FAILED"
+                ? registrationError.message
+                : "Automatic public-key registration failed; check Git and file permissions, then reload Configre to retry.";
         }
-        writeEncrypted(paths.encrypted, encrypt(settings, recipients));
-        return settings;
-    });
-    return selectSecrets(bundle, paths, profile);
+        log.warn("Secrets not authorized; continuing with public settings only.", registration, "Public key:", identity.publicPath);
+        return [];
+    }
 }
 
 export default loadSecrets;

package/secrets/log.js

@@ -0,0 +1,3 @@
+import lemonlog from "lemonlog";
+
+export default lemonlog("Configre");

package/secrets/register.js

@@ -2,11 +2,14 @@ import fs from "node:fs";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import config from "./config.js";
+import log from "./log.js";
 import { parsePublicKey } from "./crypto.js";
 import { stat, readText, withLock } from "./files.js";
 
 function registrationError(message) {
-    return new Error(`Configre secrets: not authorized; automatic registration ${message}`);
+    const error = new Error(`Configre secrets: not authorized; automatic registration ${message}`);
+    error.code = "CONFIGRE_REGISTRATION_FAILED";
+    return error;
 }
 
 function git(directory, args, operation, options = {}) {
@@ -84,9 +87,15 @@ function registerRecipient(paths, identity, profile) {
             git(root, ["update-index", "--add", "--cacheinfo", "100644", blob, relative], "adding the public key to the isolated index", { env });
             const tree = git(root, ["write-tree"], "building the registration tree", { env }).trim();
             const commit = git(root, ["commit-tree", tree, "-p", head, "-m", `Configre: register ${profile}`], "creating the public-key commit (Git author identity must be configured)").trim();
-            fs.mkdirSync(directory, { recursive: true });
-            if (!stat(filename)) fs.writeFileSync(filename, publicKey, { flag: "wx", mode: 0o644 });
+            if (fs.mkdirSync(directory, { recursive: true })) {
+                log.info("Created recipients directory", directory);
+            }
+            if (!stat(filename)) {
+                fs.writeFileSync(filename, publicKey, { flag: "wx", mode: 0o644 });
+                log.info("Created public-key registration file", filename);
+            }
             git(root, ["push", "--no-verify", "--no-follow-tags", "--", remote, `${commit}:${remoteBranch}`], "pushing the public-key commit");
+            log.info("Published public key to Git", filename);
             if (git(root, ["symbolic-ref", "--quiet", "HEAD"], "checking the current branch").trim() !== branch) {
                 throw registrationError("published the public key, but the local branch changed concurrently; synchronize the checkout");
             }

package/test/secrets.test.js

@@ -7,6 +7,7 @@ import { spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
 import test from "node:test";
 import Configre from "../index.js";
+import log from "../secrets/log.js";
 import { generatePrivateKey, parsePrivateKey, encrypt } from "../secrets/crypto.js";
 
 const sentinel = "synthetic-secret-for-configre-tests";
@@ -17,6 +18,9 @@ test.before(() => {
 });
 
 function fixture(t, { seed = true } = {}) {
+    const logs = { info: [], warn: [] };
+    t.mock.method(log, "info", (...args) => logs.info.push(args));
+    t.mock.method(log, "warn", (...args) => logs.warn.push(args));
     const root = fs.mkdtempSync(path.join(os.tmpdir(), "configre-secrets-"));
     const homes = [0, 1, 2].map(index => path.join(root, `home-${index}`));
     let home = homes[0];
@@ -36,7 +40,7 @@ function fixture(t, { seed = true } = {}) {
     }
     t.after(() => fs.rmSync(root, { recursive: true, force: true }));
     return {
-        root, config, homes,
+        root, config, homes, logs,
         local: path.join(config, "index.secret.cjs"),
         encrypted: path.join(config, "secrets.enc.json"),
         recipients: path.join(config, "recipients"),
@@ -54,6 +58,15 @@ function load(f) {
     return Configre(f.config);
 }
 
+function assertPublicOnly(f, logs, warning) {
+    const count = logs.warn.length;
+    const config = load(f);
+    assert.equal(config.api.key, "");
+    assert.equal(logs.warn.length, count + 1);
+    assert.match(logs.warn.at(-1).join(" "), warning);
+    return config;
+}
+
 function envelope(f) {
     return JSON.parse(fs.readFileSync(f.encrypted, "utf8"));
 }
@@ -67,6 +80,105 @@ function consumerCopy(f, name) {
     return { config };
 }
 
+test("print logs public configuration without creating secret artifacts", t => {
+    const f = fixture(t, { seed: false });
+    const calls = [];
+    t.mock.method(Object.getPrototypeOf(log), "debug", (...args) => calls.push(args));
+    const config = new Configre(f.config);
+
+    assert.equal(calls.length, 0);
+    config.print();
+    assert.deepEqual(calls, [[config.get()]]);
+    assert.equal(fs.existsSync(f.homes[0]), false);
+});
+
+test("function results expose print without changing enumerable data and log current settings", t => {
+    const f = fixture(t, { seed: false });
+    const calls = [];
+    t.mock.method(Object.getPrototypeOf(log), "debug", (...args) => calls.push(args));
+    const cfg = Configre(f.config);
+    const expected = new Configre(f.config).get();
+
+    assert.equal(typeof cfg.print, "function");
+    assert.deepEqual(Object.keys(cfg), Object.keys(expected));
+    assert.deepEqual({ ...cfg }, expected);
+    assert.equal(JSON.stringify(cfg), JSON.stringify(expected));
+    cfg.api.host = "updated";
+    cfg.print();
+    assert.deepEqual(calls, [[{ ...expected, api: { key: "", host: "updated" } }]]);
+    assert.equal(cfg.api.host, "updated");
+});
+
+test("a public print field remains configuration data", t => {
+    const f = fixture(t, { seed: false });
+    fs.writeFileSync(path.join(f.config, "index.cjs"), 'module.exports = { print: false };');
+    assert.equal(Configre(f.config).print, false);
+    const calls = [];
+    t.mock.method(Object.getPrototypeOf(log), "debug", (...args) => calls.push(args));
+    new Configre(f.config).print();
+    assert.equal(calls[0][0].print, false);
+});
+
+test("print omits local and encrypted secret fields without changing effective settings", t => {
+    const f = fixture(t);
+    const calls = [];
+    t.mock.method(Object.getPrototypeOf(log), "debug", (...args) => calls.push(args));
+    writeSettings(f, {
+        api: { key: sentinel },
+        list: [sentinel],
+        privateGroup: { value: sentinel },
+        optional: null,
+        empty: "",
+        enabled: false,
+        count: 0
+    });
+    fs.writeFileSync(path.join(f.config, "testhost.secret.cjs"),
+        `module.exports = { api: { other: ${JSON.stringify(sentinel)} }, privateGroup: "public-looking" };`);
+
+    load(f);
+    for (const source of [f, consumerCopy(f, "debug-consumer")]) {
+        const config = new Configre(source.config);
+        const before = config.get();
+        const secretsBefore = structuredClone(config.secretSettings);
+        config.print();
+
+        assert.deepEqual(calls.at(-1), [{ api: { host: "profile" } }]);
+        assert.equal(JSON.stringify(calls).includes(sentinel), false);
+        assert.deepEqual(config.get(), before);
+        assert.deepEqual(config.secretSettings, secretsBefore);
+        assert.equal(before.api.key, sentinel);
+        assert.equal(before.list[0], sentinel);
+        assert.equal(before.list[1], 2);
+        const cfg = Configre(source.config);
+        cfg.api.key = sentinel + "-updated";
+        cfg.api.host = "updated";
+        cfg.print();
+        assert.deepEqual(calls.at(-1), [{ api: { host: "updated" } }]);
+        assert.equal(JSON.stringify(calls).includes(sentinel), false);
+        assert.equal(cfg.api.key, sentinel + "-updated");
+    }
+    const result = spawnSync(process.execPath, ["-e", `
+        const os = require('node:os');
+        os.homedir = () => process.env.CONFIGRE_TEST_HOME;
+        const Configre = require(process.env.CONFIGRE_TEST_MODULE);
+        Configre(process.env.CONFIGRE_TEST_PATH).print();
+    `, "--", "--config=testhost"], {
+        encoding: "utf8",
+        env: {
+            ...process.env, DEBUG: "Configre:*",
+            CONFIGRE_TEST_HOME: f.homes[0],
+            CONFIGRE_TEST_MODULE: path.join(import.meta.dirname, "..", "index.js"),
+            CONFIGRE_TEST_PATH: path.join(f.root, "debug-consumer")
+        }
+    });
+    assert.equal(result.status, 0, result.stderr);
+    const output = result.stdout + result.stderr;
+    assert.match(output, /Configre:debug/);
+    assert.match(output, /host: 'profile'/);
+    assert.equal(output.includes(sentinel), false);
+    assert.equal(output.includes("privateGroup"), false);
+});
+
 function git(directory, args) {
     const result = spawnSync("git", ["-C", directory, ...args], { encoding: "utf8" });
     assert.equal(result.status, 0, result.stderr);
@@ -110,6 +222,45 @@ test("missing secret counterparts leave configuration and identity untouched", t
     assert.equal(new Configre(f.config).get().api.key, "");
     assert.deepEqual(fs.readdirSync(f.config), files);
     assert.equal(fs.existsSync(f.homes[0]), false);
+    assert.deepEqual(f.logs, { info: [], warn: [] });
+});
+
+test("an unauthorized machine keeps public settings and omits every encrypted field", t => {
+    const f = fixture(t);
+    writeSettings(f, { api: { key: sentinel }, encryptedOnly: { token: sentinel } });
+    load(f);
+    const consumer = consumerCopy(f, "unauthorized-consumer");
+    f.useHome(1);
+    const config = assertPublicOnly(consumer, f.logs, /not authorized.*public settings/i);
+    assert.deepEqual(config, { api: { key: "", host: "profile" }, list: [1, 2] });
+    assert.equal(Object.hasOwn(config, "encryptedOnly"), false);
+    assert.deepEqual(new Configre(consumer.config).get(), config);
+    assert.equal(JSON.stringify(f.logs).includes(sentinel), false);
+    const result = spawnSync(process.execPath, ["-e", `
+        const assert = require('node:assert/strict');
+        const os = require('node:os');
+        os.homedir = () => process.env.CONFIGRE_TEST_HOME;
+        const Configre = require(process.env.CONFIGRE_TEST_MODULE);
+        const cfg = Configre(process.env.CONFIGRE_TEST_PATH);
+        assert.equal(cfg.api.key, '');
+        assert.equal(Object.hasOwn(cfg, 'encryptedOnly'), false);
+        console.info('Application started');
+    `], {
+        encoding: "utf8",
+        env: {
+            ...process.env, DEBUG: "Configre:*",
+            CONFIGRE_TEST_HOME: f.homes[1],
+            CONFIGRE_TEST_MODULE: path.join(import.meta.dirname, "..", "index.js"),
+            CONFIGRE_TEST_PATH: consumer.config
+        }
+    });
+    assert.equal(result.status, 0, result.stderr);
+    const output = result.stdout + result.stderr;
+    assert.match(output, /Secrets not authorized; continuing with public settings only/);
+    assert.match(output, /Application started/);
+    assert.equal(output.includes(sentinel), false);
+    assert.equal(output.includes("BEGIN PRIVATE KEY"), false);
+    assert.equal(output.includes("BEGIN PUBLIC KEY"), false);
 });
 
 for (const profile of ["testhost", "testhost.dev", "forced"]) {
@@ -135,7 +286,12 @@ test("an existing empty secret module initializes secrets and reuses generated f
     const ignore = path.join(f.config, ".gitignore");
     fs.writeFileSync(ignore, "# existing rules\n*.log");
     const config = load(f);
+    const initialLogs = f.logs.info.length;
     assert.deepEqual(config, Configre(f.config));
+    assert.equal(f.logs.info.length, initialLogs);
+    for (const filename of [path.dirname(f.privatePath(0)), f.privatePath(0), f.publicPath(0), ignore, f.recipients, f.encrypted]) {
+        assert.ok(f.logs.info.some(([message, target]) => /Created|Wrote/.test(message) && target === filename));
+    }
     const original = fs.readFileSync(f.privatePath(0));
     const published = fs.readFileSync(f.publicPath(0), "utf8");
     assert.equal(parsePrivateKey(original).publicKey, published);
@@ -156,6 +312,9 @@ test("an existing empty secret module initializes secrets and reuses generated f
     assert.equal(fs.existsSync(f.encrypted + ".lock"), false);
     writeSettings(f);
     assert.equal(load(f).api.key, sentinel);
+    assert.deepEqual(f.logs.info.at(-1), ["Updated encrypted secrets file", f.encrypted]);
+    assert.equal(JSON.stringify(f.logs).includes(sentinel), false);
+    assert.equal(JSON.stringify(f.logs).includes("BEGIN PRIVATE KEY"), false);
 });
 
 test("missing administrator files are recreated without losing values or authorized recipients", t => {
@@ -198,7 +357,7 @@ test("removing every recipient revokes access without restoring keys from old ci
     assert.notDeepEqual(fs.readFileSync(f.encrypted), encrypted);
     const consumer = consumerCopy(f, "revoked-consumer");
     f.useHome(1);
-    assert.throws(() => load(consumer), /not authorized/);
+    assertPublicOnly(consumer, f.logs, /not authorized/);
 });
 
 test("secrets merge last with profiles, arrays, JSON values and the constructor API", t => {
@@ -337,7 +496,7 @@ test("grant and revoke work across isolated machines without consumer project wr
     const after = fs.readdirSync(consumer.config).map(name => [name, fs.readFileSync(path.join(consumer.config, name))]);
     assert.deepEqual(after, before);
     f.useHome(2);
-    assert.throws(() => load(consumer), /not authorized/);
+    assertPublicOnly(consumer, f.logs, /not authorized/);
     f.useHome(0);
     fs.unlinkSync(path.join(f.recipients, "developer.pub"));
     load(f);
@@ -346,9 +505,9 @@ test("grant and revoke work across isolated machines without consumer project wr
     assert.notEqual(revoked.iv, shared.iv);
     fs.copyFileSync(f.encrypted, path.join(consumer.config, "secrets.enc.json"));
     f.useHome(1);
-    assert.throws(() => load(consumer), /not authorized/);
+    assertPublicOnly(consumer, f.logs, /not authorized/);
     writeSettings({ local: path.join(consumer.config, "index.secret.cjs") }, { api: { key: "replacement" } });
-    assert.throws(() => load(consumer), /not authorized/);
+    assertPublicOnly(consumer, f.logs, /not authorized/);
     assert.deepEqual(JSON.parse(fs.readFileSync(path.join(consumer.config, "secrets.enc.json"))), revoked);
     fs.writeFileSync(path.join(consumer.config, "secrets.enc.json"), JSON.stringify(shared));
     fs.unlinkSync(path.join(consumer.config, "index.secret.cjs"));
@@ -633,7 +792,11 @@ test("a server publishes only its public key once and receives automatic authori
     fs.writeFileSync(untracked, sentinel);
     const index = git(f.checkout, ["ls-files", "--stage", "-z"]);
     f.useHome(1);
-    assert.throws(() => load(f.consumer), /public key is published in Git/);
+    assertPublicOnly(f.consumer, f.logs, /public key is published in Git/i);
+    const registeredPath = fs.realpathSync(f.registration);
+    assert.ok(f.logs.info.some(([message, filename]) => message === "Created public-key registration file" && filename === registeredPath));
+    assert.deepEqual(f.logs.info.at(-1), ["Published public key to Git", registeredPath]);
+    const registrationLogs = f.logs.info.length;
     const published = git(f.remote, ["rev-parse", "main"]).trim();
     assert.equal(git(f.checkout, ["rev-parse", "HEAD"]).trim(), published);
     assert.equal(git(f.remote, ["diff-tree", "--no-commit-id", "--name-only", "-r", "main"]).trim(), "config/recipients/testhost.pub");
@@ -645,7 +808,8 @@ test("a server publishes only its public key once and receives automatic authori
     assert.equal(fs.readFileSync(untracked, "utf8"), sentinel);
     assert.equal(git(f.remote, ["show", "main:tracked.txt"]), "initial\n");
     assert.equal(git(f.remote, ["tag", "--list"]), "");
-    assert.throws(() => load(f.consumer), /public key is published in Git/);
+    assertPublicOnly(f.consumer, f.logs, /public key is published in Git/i);
+    assert.equal(f.logs.info.length, registrationLogs);
     assert.equal(git(f.remote, ["rev-parse", "main"]).trim(), published);
 
     f.useHome(0);
@@ -657,7 +821,9 @@ test("a server publishes only its public key once and receives automatic authori
     git(f.root, ["push", "--quiet"]);
     git(f.checkout, ["pull", "--quiet", "--ff-only"]);
     f.useHome(1);
+    const warnings = f.logs.warn.length;
     assert.equal(load(f.consumer).api.key, sentinel);
+    assert.equal(f.logs.warn.length, warnings);
     f.useHome(0);
     writeSettings(f, { api: { key: sentinel + "-updated" } });
     load(f);
@@ -679,18 +845,16 @@ test("a rejected registration push preserves the branch and staging area and can
     const head = git(f.checkout, ["rev-parse", "HEAD"]);
     const index = fs.readFileSync(path.join(f.checkout, ".git", "index"));
     f.useHome(1);
-    assert.throws(() => load(f.consumer), error => {
-        assert.match(error.message, /failed while pushing the public-key commit/);
-        assert.equal(error.stack.includes(sentinel), false);
-        return true;
-    });
+    assertPublicOnly(f.consumer, f.logs, /failed while pushing the public-key commit/);
+    assert.equal(JSON.stringify(f.logs).includes(sentinel), false);
+    assert.equal(f.logs.info.some(([message]) => message === "Published public key to Git"), false);
     assert.equal(git(f.checkout, ["rev-parse", "HEAD"]), head);
     assert.equal(git(f.remote, ["rev-parse", "main"]), head);
     assert.deepEqual(fs.readFileSync(path.join(f.checkout, ".git", "index")), index);
     assert.equal(fs.existsSync(path.join(f.checkout, ".git", "configre-registration.lock")), false);
     assert.equal(fs.readdirSync(path.join(f.checkout, ".git")).some(name => name.startsWith("configre-registration-")), false);
     fs.unlinkSync(hook);
-    assert.throws(() => load(f.consumer), /public key is published in Git/);
+    assertPublicOnly(f.consumer, f.logs, /public key is published in Git/i);
     assert.equal(git(f.remote, ["rev-list", "--count", "main"]).trim(), "2");
 });
 
@@ -706,9 +870,9 @@ test("registration recovers when publication succeeded before the local branch a
     git(interrupted, ["add", "tracked.txt"]);
     fs.writeFileSync(tracked, "unstaged work\n");
     f.useHome(1);
-    assert.throws(() => load(f.consumer), /public key is published in Git/);
+    assertPublicOnly(f.consumer, f.logs, /public key is published in Git/i);
     const published = git(f.remote, ["rev-parse", "main"]);
-    assert.throws(() => load({ config: path.join(interrupted, "config") }), /public key is published in Git/);
+    assertPublicOnly({ config: path.join(interrupted, "config") }, f.logs, /public key is published in Git/i);
     git(interrupted, ["pull", "--quiet", "--ff-only"]);
     assert.equal(git(interrupted, ["rev-parse", "HEAD"]), published);
     assert.equal(git(f.remote, ["rev-parse", "main"]), published);
@@ -721,16 +885,16 @@ test("registration refuses to publish unrelated local commits or guess a branch"
     const remoteHead = git(f.remote, ["rev-parse", "main"]);
     git(f.checkout, ["checkout", "--quiet", "--detach"]);
     f.useHome(1);
-    assert.throws(() => load(f.consumer), /detached HEAD/);
+    assertPublicOnly(f.consumer, f.logs, /detached HEAD/);
     git(f.checkout, ["checkout", "--quiet", "main"]);
     git(f.checkout, ["branch", "--unset-upstream"]);
-    assert.throws(() => load(f.consumer), /upstream remote/);
+    assertPublicOnly(f.consumer, f.logs, /upstream remote/);
     git(f.checkout, ["branch", "--set-upstream-to=origin/main"]);
     fs.writeFileSync(path.join(f.checkout, "tracked.txt"), "unpublished work\n");
     git(f.checkout, ["add", "tracked.txt"]);
     git(f.checkout, ["commit", "--quiet", "-m", "Unpublished work"]);
     const localHead = git(f.checkout, ["rev-parse", "HEAD"]);
-    assert.throws(() => load(f.consumer), /local branch to match its upstream/);
+    assertPublicOnly(f.consumer, f.logs, /local branch to match its upstream/);
     assert.equal(git(f.checkout, ["rev-parse", "HEAD"]), localHead);
     assert.equal(git(f.remote, ["rev-parse", "main"]), remoteHead);
     assert.equal(fs.existsSync(f.registration), false);
@@ -742,11 +906,11 @@ test("registration rejects profile collisions, unsafe names and damaged encrypte
     const previousArgs = process.argv;
     process.argv = [...previousArgs.filter(arg => !arg.startsWith("--config=")), "--config=../escape"];
     t.after(() => { process.argv = previousArgs; });
-    assert.throws(() => load(f.consumer), /requires a profile/);
+    assertPublicOnly(f.consumer, f.logs, /requires a profile/);
     process.argv = previousArgs;
     fs.mkdirSync(path.dirname(f.registration));
     fs.copyFileSync(f.publicPath(2), f.registration);
-    assert.throws(() => load(f.consumer), /different key for this profile/);
+    assertPublicOnly(f.consumer, f.logs, /different key for this profile/);
     assert.equal(fs.readFileSync(f.registration, "utf8"), fs.readFileSync(f.publicPath(2), "utf8"));
     fs.unlinkSync(f.registration);
     fs.copyFileSync(f.publicPath(2), path.join(f.recipients, "testhost.pub"));
@@ -754,7 +918,7 @@ test("registration rejects profile collisions, unsafe names and damaged encrypte
     git(f.root, ["commit", "--quiet", "-m", "Existing server identity"]);
     git(f.root, ["push", "--quiet"]);
     const remoteHead = git(f.remote, ["rev-parse", "main"]);
-    assert.throws(() => load(f.consumer), /different published key/);
+    assertPublicOnly(f.consumer, f.logs, /different published key/);
     const damaged = envelope(f);
     damaged.extra = sentinel;
     fs.writeFileSync(path.join(f.consumer.config, "secrets.enc.json"), JSON.stringify(damaged));