agentrinse 0.0.0 → 0.1.0

package/README.md

@@ -2,53 +2,39 @@
 
 Safe, local-first cleanup for agentic development.
 
-AgentRinse inventories agent state and developer residue, explains why
-resources are protected, produces content-addressed cleanup plans, and applies
-only actions that still pass every safety check.
-
-> [!IMPORTANT]
-> `0.0.0` is a package-reservation release. It is not supported for cleanup
-> against real developer state. The first supported release will be `0.1.0`.
-
-## Reservation Release
-
-The implemented mutation boundary under development is intentionally narrow:
-
-- removes only exact rebuildable artifact directories declared in config
-- supports `node_modules`, `dist`, `dist-runtime`, `build`, `.next`, `.turbo`,
-  `.cache`, `coverage`, `target`, and `.venv`
-- revalidates path, realpath, inode, device, recursive metadata fingerprint,
-  newest descendant mtime, measured bytes, configured scope, current working
-  directory, and process ownership after acquiring the apply lock
-- rejects artifact roots and descendants that cross filesystem mount
-  boundaries
-- rejects sockets, pipes, devices, and other non-regular filesystem entries
-- rechecks size, age, and plan expiration immediately before each mutation
-- atomically renames an artifact to a same-parent tombstone before recursive
-  removal, repeats fingerprint and process checks on the isolated tree, and
-  performs a final synchronous inode check at the deletion boundary
-- journals every transition and records the recovery path for partial actions
-
-Codex, Claude Code, Cursor, GitHub Copilot CLI, Zed, OpenCode, Grok Build, Git,
-and Docker are report-only. Provider state, worktrees, images, containers,
-volumes, branches, stashes, credentials, configuration, plugins, skills, and
-memories are not cleanup targets.
+AgentRinse inventories agent state and developer residue, explains why each
+resource is protected or eligible, creates content-addressed cleanup plans,
+and applies only actions that still pass every safety check.
+
+Version `0.1.0` supports one mutating action: removing exact rebuildable
+artifact directories declared under explicit project roots. Provider state,
+Git worktrees, and Docker resources remain report-only.
 
 ## Install
 
-Do not install `0.0.0` for operational cleanup. Maintainers may verify the
-reservation package with:
+Node.js 22 or newer is required.
 
 ```bash
 npm install --global agentrinse
 agentrinse --version
 ```
 
-The command must report `0.0.0`. Node.js 22 or newer is required.
+One-off use also works:
+
+```bash
+npx agentrinse@0.1.0 doctor
+```
+
+## Quickstart
 
-## Configure
+Create a default configuration without overwriting an existing file:
 
-Artifact cleanup is disabled until project roots are explicitly declared.
+```bash
+agentrinse config init
+agentrinse config path
+```
+
+Edit the generated JSON and add explicit artifact roots:
 
 ```json
 {
@@ -71,69 +57,129 @@ Artifact cleanup is disabled until project roots are explicitly declared.
 }
 ```
 
-Project roots must be unique canonical absolute real directories inside the
-audited home; paths reached through symlinked ancestors are rejected. Artifact
-targets cannot overlap. AgentRinse never discovers arbitrary projects or
-expands wildcards.
+Run diagnostics before the first audit:
 
-## Use
+```bash
+agentrinse config validate
+agentrinse doctor
+```
 
-Audit and save immutable evidence:
+Audit and save exact evidence:
 
 ```bash
-agentrinse audit \
-  --home "$HOME" \
-  --config agentrinse.json \
-  --json \
-  --output audit.json
+agentrinse audit --home "$HOME" --output audit.json
 ```
 
-Create a bounded cleanup plan:
+Create and review a bounded plan:
+
+```bash
+agentrinse plan --audit audit.json --output plan.json
+cat plan.json
+```
+
+Apply only after reviewing the plan:
+
+```bash
+agentrinse apply --plan plan.json
+```
+
+Interactive apply asks for confirmation. Automation must pass `--yes`.
+
+## Mutation Boundary
+
+AgentRinse can remove only these configured artifact names:
+
+- `node_modules`
+- `dist`
+- `dist-runtime`
+- `build`
+- `.next`
+- `.turbo`
+- `.cache`
+- `coverage`
+- `target`
+- `.venv`
+
+Before removal it revalidates configured scope, canonical paths, device and
+inode identity, recursive metadata fingerprint, measured bytes, newest
+descendant age, mount boundaries, current working directory ownership,
+same-user processes, and plan expiration. The exact target is atomically moved
+to a same-parent tombstone and verified again before deletion.
+
+AgentRinse never removes provider sessions, transcripts, databases,
+credentials, configuration, plugins, skills, memories, Git branches, stashes,
+worktrees, Docker images, containers, networks, volumes, or build cache in
+`0.1.0`.
+
+## Operations
+
+```bash
+agentrinse history
+agentrinse show run <run-id>
+agentrinse show plan <plan-id>
+agentrinse show resource <resource-id>
+agentrinse lock status
+```
+
+A stale lock can be recovered only after AgentRinse proves the recorded local
+process identity no longer exists:
+
+```bash
+agentrinse lock status
+agentrinse lock recover --yes
+```
+
+Generate shell completion without modifying shell startup files:
+
+```bash
+agentrinse completion bash
+agentrinse completion zsh
+agentrinse completion fish
+```
+
+## Machine Output
+
+`agentrinse audit --json` emits a versioned command envelope. Long audits can
+emit incremental event records:
 
 ```bash
-agentrinse plan \
-  --audit audit.json \
-  --config agentrinse.json \
-  --output plan.json
+agentrinse audit --ndjson
 ```
 
-Review `plan.json`, then apply it:
+Create a non-executable report for issue filing:
 
 ```bash
-agentrinse apply \
-  --plan plan.json \
-  --config agentrinse.json \
-  --yes
+agentrinse audit --json --redact > audit-redacted.json
 ```
 
-Without `--yes`, apply requires an interactive terminal confirmation. JSON
-output requires `--yes` so prompts can never corrupt stdout. A plan is rejected
-when it expires, changes, no longer matches the config, or contains inconsistent
-action totals. An action whose authorization expires during a run is recorded
-as `skipped-stale`, not deleted.
+Redaction replaces paths, salts identifiers per report, removes host fields,
+and strips candidate actions. Persisted state and `--output` evidence remain
+exact so they can be used for planning.
 
-Run journals are stored under `$XDG_STATE_HOME/agentrinse/runs` or
-`$HOME/.local/state/agentrinse/runs`. Use `--state-dir` to select another
-location.
+## Platform Support
 
-## Safety
+| Platform       | `0.1.0` support                                     |
+| -------------- | --------------------------------------------------- |
+| macOS          | audit and safe artifact apply                       |
+| Linux          | audit and safe artifact apply                       |
+| WSL            | Linux contract inside the WSL filesystem            |
+| native Windows | audit-only; mutation remains blocked before `1.0.0` |
 
-- discovery and planning never mutate
-- unknown state is protected
-- symlinks are not followed
-- no process is killed
-- no `sudo`
-- no Docker volume deletion
-- no generic `--force`
-- no wildcard deletion
-- one apply run holds the exclusive state lock
-- AgentRinse never removes its own working directory, lock, or journal
+Git and `lsof` are required for the complete diagnostic and process-ownership
+contract. Docker is optional. Doctor can detect the optional external Mole
+tool on macOS.
 
-AgentRinse fails closed around ordinary concurrent developer tools. It does not
-claim isolation from a hostile process already running as the same OS user;
-that process can directly alter the user's files and AgentRinse state.
+## Documentation
 
-See `docs/safety.md` for the complete mutation contract.
+- [Configuration](docs/configuration.md)
+- [Automation](docs/automation.md)
+- [Recovery](docs/recovery.md)
+- [Platform support](docs/platforms.md)
+- [Safety model](docs/safety.md)
+- [Adapter matrix](docs/adapters.md)
+- [Development](docs/development.md)
+- [Releasing](docs/releasing.md)
+- [Product specification](docs/product-spec.md)
 
 ## Development
 
@@ -144,9 +190,8 @@ pnpm smoke
 pnpm pack:check
 ```
 
-Development, tests, smoke runs, and destructive proof use temporary synthetic
-homes only. Never point `0.0.0` or an unreleased development build at a
-workstation home.
+Tests and smoke runs use guarded temporary synthetic roots. Never point an
+unreleased build at real developer state.
 
 ## License
 

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import { main } from "./main.js";
+import { CommandInterruptedError } from "./core/interruption.js";
 main().catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
     process.stderr.write(`agentrinse: ${message}\n`);
-    process.exitCode = 1;
+    process.exitCode = error instanceof CommandInterruptedError ? error.exitCode : 1;
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,GAAG,KAAK,YAAY,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC,CAAC,CAAC"}

package/dist/commands/apply.d.ts

@@ -5,11 +5,17 @@ export type ApplyCommandOptions = {
     stateDir?: string;
     yes: boolean;
     json: boolean;
+    signal?: AbortSignal;
 };
 export type ApplyCommandResult = {
     run: CleanupRun;
     journalPath: string;
     output: string;
 };
+export type ConfirmApplyDependencies = {
+    isInteractive?: () => boolean;
+    question?: (prompt: string, signal?: AbortSignal) => Promise<string>;
+};
+export declare function confirmApply(actionCount: number, signal?: AbortSignal, dependencies?: ConfirmApplyDependencies): Promise<boolean>;
 export declare function executeApplyCommand(options: ApplyCommandOptions): Promise<ApplyCommandResult>;
 //# sourceMappingURL=apply.d.ts.map

package/dist/commands/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAgCF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE,CAAC;AAyBF,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAeD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B"}

package/dist/commands/apply.js

@@ -1,27 +1,53 @@
 import { createInterface } from "node:readline/promises";
 import { resolve } from "node:path";
-import { loadConfig } from "../config/load.js";
+import { loadConfigForHome } from "../config/load.js";
 import { cleanupPlanSchema } from "../contracts/plan.js";
 import { applyCleanupPlan } from "../core/apply.js";
+import { CommandInterruptedError } from "../core/interruption.js";
 import { readJsonFile } from "../state/json-file.js";
 import { resolveStateRoot } from "../state/layout.js";
-import { VERSION } from "../version.js";
-async function confirmApply(actionCount) {
-    if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        throw new Error("apply requires --yes when stdin or stdout is not an interactive terminal");
-    }
+async function defaultQuestion(promptText, signal) {
     const prompt = createInterface({
         input: process.stdin,
         output: process.stdout,
     });
     try {
-        const answer = await prompt.question(`Apply ${actionCount} safe cleanup action(s)? [y/N] `);
-        return ["y", "yes"].includes(answer.trim().toLowerCase());
+        return signal === undefined
+            ? await prompt.question(promptText)
+            : await prompt.question(promptText, { signal });
     }
     finally {
         prompt.close();
     }
 }
+function interruptionFrom(signal) {
+    if (signal?.aborted !== true) {
+        return undefined;
+    }
+    return signal.reason instanceof CommandInterruptedError
+        ? signal.reason
+        : new CommandInterruptedError("apply interrupted");
+}
+export async function confirmApply(actionCount, signal, dependencies = {}) {
+    const initialInterruption = interruptionFrom(signal);
+    if (initialInterruption !== undefined) {
+        throw initialInterruption;
+    }
+    if (!(dependencies.isInteractive ?? (() => process.stdin.isTTY && process.stdout.isTTY))()) {
+        throw new Error("apply requires --yes when stdin or stdout is not an interactive terminal");
+    }
+    try {
+        const answer = await (dependencies.question ?? defaultQuestion)(`Apply ${actionCount} safe cleanup action(s)? [y/N] `, signal);
+        return ["y", "yes"].includes(answer.trim().toLowerCase());
+    }
+    catch (error) {
+        const interruption = interruptionFrom(signal);
+        if (interruption !== undefined) {
+            throw interruption;
+        }
+        throw error;
+    }
+}
 function renderRun(run, journalPath) {
     const applied = run.actions.filter((action) => action.status === "applied").length;
     const skipped = run.actions.filter((action) => action.status === "skipped-stale").length;
@@ -38,19 +64,17 @@ export async function executeApplyCommand(options) {
     if (options.json && !options.yes) {
         throw new Error("apply --json requires --yes");
     }
-    if (VERSION === "0.0.0") {
-        throw new Error("apply is unavailable in the unsupported 0.0.0 reservation release");
-    }
     const input = await readJsonFile(resolve(options.plan));
     const plan = cleanupPlanSchema.parse(input);
-    const config = await loadConfig(options.config);
-    if (!options.yes && !(await confirmApply(plan.actions.length))) {
+    const { config } = await loadConfigForHome(plan.home, options.config);
+    if (!options.yes && !(await confirmApply(plan.actions.length, options.signal))) {
         throw new Error("apply cancelled");
     }
     const result = await applyCleanupPlan({
         input,
         config,
         stateRoot: resolveStateRoot(plan.home, options.stateDir),
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
     });
     return {
         run: result.run,

package/dist/commands/apply.js.map

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

package/dist/commands/audit.d.ts

@@ -2,11 +2,17 @@ import type { AuditReport } from "../contracts/report.js";
 export type AuditCommandOptions = {
     home: string;
     config?: string;
-    json: boolean;
+    json?: boolean;
+    ndjson?: boolean;
+    redact?: boolean;
     output?: string;
+    stateDir?: string;
+    now?: () => Date;
+    emit?: (output: string) => void;
 };
 export type AuditCommandResult = {
     report: AuditReport;
+    statePath: string;
     output: string;
 };
 export declare function executeAuditCommand(options: AuditCommandOptions): Promise<AuditCommandResult>;

package/dist/commands/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAa1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAqH7B"}

package/dist/commands/audit.js

@@ -1,22 +1,113 @@
+import { randomUUID } from "node:crypto";
 import { resolve } from "node:path";
 import { createAuditAdapters } from "../adapters/registry.js";
-import { loadConfig } from "../config/load.js";
+import { loadConfigForHome } from "../config/load.js";
 import { runAudit } from "../core/audit.js";
+import { redactAuditReport, redactAuditValue } from "../core/redaction.js";
+import { createCommandEnvelope, createCommandEvent, jsonDocument, ndjsonRecord, } from "../machine-output.js";
 import { renderAudit } from "../output.js";
 import { writeJsonAtomic } from "../state/json-file.js";
+import { resolveStateRoot, stateLayout } from "../state/layout.js";
 export async function executeAuditCommand(options) {
-    const config = await loadConfig(options.config);
-    const report = await runAudit({
-        home: resolve(options.home),
-        config,
-        adapters: createAuditAdapters(config),
-    });
-    if (options.output !== undefined) {
-        await writeJsonAtomic(resolve(options.output), report);
+    if (options.json === true && options.ndjson === true) {
+        throw new Error("audit accepts only one of --json or --ndjson");
     }
-    return {
-        report,
-        output: options.json ? `${JSON.stringify(report, null, 2)}\n` : renderAudit(report),
+    if (options.redact === true && options.json !== true && options.ndjson !== true) {
+        throw new Error("audit --redact requires --json or --ndjson");
+    }
+    const clock = options.now ?? (() => new Date());
+    const commandId = randomUUID();
+    const salt = randomUUID();
+    const ndjson = [];
+    let sequence = 0;
+    const emitEvent = (event, timestamp, data) => {
+        const value = createCommandEvent({
+            event,
+            timestamp,
+            command: "audit",
+            commandId,
+            sequence: (sequence += 1),
+            ...(data === undefined ? {} : { data }),
+        });
+        const output = ndjsonRecord(value);
+        if (options.emit === undefined) {
+            ndjson.push(output);
+        }
+        else {
+            options.emit(output);
+        }
     };
+    const home = resolve(options.home);
+    const { config } = await loadConfigForHome(home, options.config);
+    const startedAt = clock().toISOString();
+    if (options.ndjson === true) {
+        emitEvent("command.started", startedAt, options.redact === true ? { home: "$HOME" } : { home });
+    }
+    try {
+        const report = await runAudit({
+            home,
+            config,
+            adapters: createAuditAdapters(config),
+            now: clock,
+            ...(options.ndjson === true
+                ? {
+                    onEvent: (event) => {
+                        emitEvent(event.type, event.timestamp, options.redact === true ? redactAuditValue(event.data, home, salt) : event.data);
+                    },
+                }
+                : {}),
+        });
+        const layout = stateLayout(resolveStateRoot(home, options.stateDir));
+        const statePath = resolve(layout.audits, `${report.auditId}.json`);
+        await writeJsonAtomic(statePath, report, {
+            privateDirectories: [layout.root, layout.audits],
+        });
+        if (options.output !== undefined) {
+            await writeJsonAtomic(resolve(options.output), report);
+        }
+        const selectedReport = options.redact === true ? redactAuditReport(report, salt) : report;
+        if (options.ndjson === true) {
+            emitEvent("command.completed", report.completedAt, {
+                auditId: options.redact === true
+                    ? redactAuditValue({ auditId: report.auditId }, home, salt).auditId
+                    : report.auditId,
+                status: report.probes.some((probe) => probe.status === "degraded") ||
+                    report.diagnostics.length > 0
+                    ? "degraded"
+                    : "ok",
+                probes: report.probes.length,
+                findings: report.findings.length,
+            });
+        }
+        const status = report.probes.some((probe) => probe.status === "degraded") || report.diagnostics.length > 0
+            ? "degraded"
+            : "ok";
+        return {
+            report,
+            statePath,
+            output: options.ndjson === true
+                ? ndjson.join("")
+                : options.json === true
+                    ? jsonDocument(createCommandEnvelope({
+                        command: "audit",
+                        startedAt: report.startedAt,
+                        completedAt: report.completedAt,
+                        status,
+                        data: selectedReport,
+                        diagnostics: selectedReport.diagnostics,
+                    }))
+                    : renderAudit(report),
+        };
+    }
+    catch (error) {
+        if (options.ndjson === true) {
+            const data = {
+                status: "failed",
+                error: error instanceof Error ? error.message : String(error),
+            };
+            emitEvent("command.completed", clock().toISOString(), options.redact === true ? redactAuditValue(data, home, salt) : data);
+        }
+        throw error;
+    }
 }
 //# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAcxD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,MAAM;QACN,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC;KACtC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;KACpF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"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"}

package/dist/commands/completion.d.ts

@@ -0,0 +1,4 @@
+export declare const completionShells: readonly ["bash", "zsh", "fish"];
+export type CompletionShell = (typeof completionShells)[number];
+export declare function renderCompletion(shell: string): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,YAAI,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AA4FhE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWtD"}