linkany 0.0.2 → 0.0.3

package/README.md

@@ -146,6 +146,7 @@
 - 默认写入：`${manifestPath}.log.jsonl`
 - 每行是一条 JSON（完整 `Result`），包含：执行步骤、错误、耗时、变更摘要。
 - 可通过 `opts.auditLogPath` 指定自定义路径。
+- 如需完全关闭审计（由上层自行处理），传 `opts.audit=false`；CLI 对应 `--no-audit`。
 
 ## Options（opts）
 

package/dist/cli.js

@@ -41,7 +41,8 @@ function parseCommonOptions(args) {
     const dryRun = hasFlag(args, ['--dry-run']);
     const includePlanText = hasFlag(args, ['--plan']);
     const auditLogPath = popFlagValue(args, ['--audit-log']);
-    return { dryRun, includePlanText, auditLogPath };
+    const audit = hasFlag(args, ['--no-audit']) ? false : undefined;
+    return { dryRun, includePlanText, auditLogPath, audit };
 }
 async function resolveManifestPath(args) {
     const m = popFlagValue(args, ['-m', '--manifest']);
@@ -61,10 +62,10 @@ Usage:
   linkany manifest show
   linkany manifest clear
 
-  linkany add --source <path> --target <path> [--kind file|dir] [--atomic|--no-atomic] [-m <manifest>] [--dry-run] [--plan]
-  linkany remove <key> [--keep-link] [-m <manifest>] [--dry-run] [--plan]
-  linkany install [-m <manifest>] [--dry-run] [--plan]
-  linkany uninstall [-m <manifest>] [--dry-run] [--plan]
+  linkany add --source <path> --target <path> [--kind file|dir] [--atomic|--no-atomic] [-m <manifest>] [--dry-run] [--plan] [--no-audit]
+  linkany remove <key> [--keep-link] [-m <manifest>] [--dry-run] [--plan] [--no-audit]
+  linkany install [-m <manifest>] [--dry-run] [--plan] [--no-audit]
+  linkany uninstall [-m <manifest>] [--dry-run] [--plan] [--no-audit]
 `;
     process.stdout.write(msg.trimStart());
     process.stdout.write('\n');

package/dist/core/audit.js

@@ -9,6 +9,8 @@ export async function appendAudit(logPath, result) {
     await fs.appendFile(logPath, line, 'utf8');
 }
 export async function tryAppendAuditStep(result, manifestPath, opts) {
+    if (opts?.audit === false)
+        return result;
     const logPath = opts?.auditLogPath ?? (manifestPath ? `${path.resolve(manifestPath)}.log.jsonl` : undefined);
     if (!logPath)
         return result;

package/dist/core/runner.js

@@ -24,7 +24,9 @@ export async function runOperation(input) {
     if (input.finalize) {
         res = await input.finalize(res);
     }
-    res = await tryAppendAuditStep(res, input.manifestPath, input.opts);
+    if (input.opts?.audit !== false) {
+        res = await tryAppendAuditStep(res, input.manifestPath, input.opts);
+    }
     logger?.info?.(`[linkany] ${input.operation} ${res.ok ? 'ok' : 'fail'} (${res.durationMs}ms)`);
     return res;
 }

package/dist/types.d.ts

@@ -55,6 +55,13 @@ export interface Logger {
     error(msg: string): void;
 }
 export interface CommonOptions {
+    /**
+     * Whether to append an audit log entry for this operation.
+     * Default: true.
+     *
+     * Set to false if the caller wants to fully disable audit logging and handle it themselves.
+     */
+    audit?: boolean;
     /**
      * If provided, we append one JSON line per operation (Result summary).
      * Default strategy (V1): `${manifestPath}.log.jsonl` when manifestPath is known.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkany",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",