perttool 0.5.4 → 0.6.0

package/dist/application/contract6-projection.d.ts

@@ -1,9 +1,10 @@
 import type { ActualWorkEvent } from "../actuals/source.js";
 import type { TargetActualsAdvanceResultV3 } from "./target-actuals-advance.js";
+import type { AdvanceResultV1 } from "./advance-history.js";
 import type { TargetActualsMutationResultV3 } from "./target-actuals-mutation.js";
 import { type TargetGovernanceWriteProjection } from "./target-governance-projection.js";
 import type { TargetGovernanceProjectMetadataResult } from "./target-governance-project.js";
 export declare function contract6ProjectResultToJson(result: TargetGovernanceProjectMetadataResult, source: string, sourceDigest: string, ok?: boolean): Readonly<Record<string, unknown>>;
 export declare function contract6WorkEventToJson(event: ActualWorkEvent): Readonly<Record<string, unknown>>;
-export declare function contract6MutationResultToJson(result: TargetActualsMutationResultV3 | TargetActualsAdvanceResultV3, operation: string, source: string, write: TargetGovernanceWriteProjection): Readonly<Record<string, unknown>>;
+export declare function contract6MutationResultToJson(result: TargetActualsMutationResultV3 | TargetActualsAdvanceResultV3 | AdvanceResultV1, operation: string, source: string, write: TargetGovernanceWriteProjection): Readonly<Record<string, unknown>>;
 //# sourceMappingURL=contract6-projection.d.ts.map

package/dist/application/contract6-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract6-projection.d.ts","sourceRoot":"","sources":["../../src/application/contract6-projection.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EACV,qCAAqC,EACtC,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qCAAqC,EAC7C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,EAAE,UAAY,GACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUnC;AAgDD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,GACrB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAenC;AAkBD,wBAAgB,6BAA6B,CAC3C,MAAM,EACF,6BAA6B,GAC7B,4BAA4B,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,+BAA+B,GACrC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqCnC"}
+{"version":3,"file":"contract6-projection.d.ts","sourceRoot":"","sources":["../../src/application/contract6-projection.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EACV,qCAAqC,EACtC,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qCAAqC,EAC7C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,EAAE,UAAY,GACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUnC;AAgDD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,GACrB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAenC;AAyCD,wBAAgB,6BAA6B,CAC3C,MAAM,EACF,6BAA6B,GAC7B,4BAA4B,GAC5B,eAAe,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,+BAA+B,GACrC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkDnC"}

package/dist/application/contract6-projection.js

@@ -73,12 +73,35 @@ function lifecycleToJson(result) {
             coverage: lifecycle.coverage,
         };
 }
+function advanceHistoryGuardToJson(value) {
+    return {
+        model_version: value.modelVersion,
+        status: value.status,
+        cause: value.cause,
+        repository_snapshot_id: value.repositorySnapshotId,
+        repository_relative_path: value.repositoryRelativePath,
+        head_commit_id: value.headCommitId,
+        source_digest: value.sourceDigest,
+        candidate_digest: value.candidateDigest,
+        source_modified_at: value.sourceModifiedAt,
+        source_bytes: value.sourceBytes,
+        candidate_bytes: value.candidateBytes,
+        diff_added_lines: value.diffAddedLines,
+        diff_removed_lines: value.diffRemovedLines,
+        destructive_entity_ids: value.destructiveEntityIds,
+        overlapping_entity_ids: value.overlappingEntityIds,
+        force_requested: value.forceRequested,
+    };
+}
 export function contract6MutationResultToJson(result, operation, source, write) {
     const base = targetGovernanceMutationResultToJson(result, operation, source, write);
     if ("advance" in result) {
+        const historyGuard = "historyGuard" in result ? result.historyGuard : undefined;
         return Object.freeze({
             ...base,
-            schema_version: "Perttool.MutationResult.v3",
+            schema_version: historyGuard === undefined
+                ? "Perttool.MutationResult.v3"
+                : "Perttool.AdvanceResult.v1",
             cli_contract_version: 6,
             lifecycle: null,
             advance: result.advance === null
@@ -93,6 +116,13 @@ export function contract6MutationResultToJson(result, operation, source, write)
                     ready_before: result.advance.readyBefore,
                     ready_after: result.advance.readyAfter,
                 },
+            ...(historyGuard === undefined
+                ? {}
+                : {
+                    history_guard: historyGuard === null
+                        ? null
+                        : advanceHistoryGuardToJson(historyGuard),
+                }),
         });
     }
     return Object.freeze({

package/dist/application/contract6-projection.js.map

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

package/dist/application/target-actuals-write.d.ts

@@ -3,5 +3,6 @@ import { type TargetGovernancePersistenceRequest } from "./target-governance-wri
 import type { TargetGovernanceWriteProjection } from "./target-governance-projection.js";
 import type { TargetActualsMutationResultV3 } from "./target-actuals-mutation.js";
 import type { TargetActualsAdvanceResultV3 } from "./target-actuals-advance.js";
-export declare function persistTargetActualsResult(result: TargetActualsMutationResultV3 | TargetActualsAdvanceResultV3, capability: TargetGrammar5Capability, request: TargetGovernancePersistenceRequest): Promise<TargetGovernanceWriteProjection>;
+import type { AdvanceResultV1 } from "./advance-history.js";
+export declare function persistTargetActualsResult(result: TargetActualsMutationResultV3 | TargetActualsAdvanceResultV3 | AdvanceResultV1, capability: TargetGrammar5Capability, request: TargetGovernancePersistenceRequest): Promise<TargetGovernanceWriteProjection>;
 //# sourceMappingURL=target-actuals-write.d.ts.map

package/dist/application/target-actuals-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target-actuals-write.d.ts","sourceRoot":"","sources":["../../src/application/target-actuals-write.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,+BAA+B,EAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAarC,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,6BAA6B,GAAG,4BAA4B,EACpE,UAAU,EAAE,wBAAwB,EACpC,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CA0C1C"}
+{"version":3,"file":"target-actuals-write.d.ts","sourceRoot":"","sources":["../../src/application/target-actuals-write.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,+BAA+B,EAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAa9B,wBAAsB,0BAA0B,CAC9C,MAAM,EACF,6BAA6B,GAC7B,4BAA4B,GAC5B,eAAe,EACnB,UAAU,EAAE,wBAAwB,EACpC,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CA0C1C"}

package/dist/application/target-actuals-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"target-actuals-write.js","sourceRoot":"","sources":["../../src/application/target-actuals-write.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EACL,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC;AAWtC,SAAS,eAAe,CACtB,OAA2C,EAC3C,OAAgB;IAEhB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAoE,EACpE,UAAoC,EACpC,OAA2C;IAE3C,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEnE,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,KAAK,UAAU;QACzB,CAAC,CAAC,MAAM,iCAAiC,CACrC,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV;YACE,aAAa,EAAE,MAAM,CAAC,cAAc;YACpC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;gBACtC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;SAChD,CACF;QACH,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG;YACtB,CAAC,CAAC,MAAM,gCAAgC,CACpC,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAC/B;YACH,CAAC,CAAC,MAAM,0CAA0C,CAC9C,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV;gBACE,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;aAChC,CACF,CAAC;IACV,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"target-actuals-write.js","sourceRoot":"","sources":["../../src/application/target-actuals-write.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EACL,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC;AActC,SAAS,eAAe,CACtB,OAA2C,EAC3C,OAAgB;IAEhB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAGmB,EACnB,UAAoC,EACpC,OAA2C;IAE3C,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEnE,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,KAAK,UAAU;QACzB,CAAC,CAAC,MAAM,iCAAiC,CACrC,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV;YACE,aAAa,EAAE,MAAM,CAAC,cAAc;YACpC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;gBACtC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;SAChD,CACF;QACH,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG;YACtB,CAAC,CAAC,MAAM,gCAAgC,CACpC,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAC/B;YACH,CAAC,CAAC,MAAM,0CAA0C,CAC9C,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,MAAM,EACd,aAAa,EACb,UAAU,EACV;gBACE,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;aAChC,CACF,CAAC;IACV,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFile } from "node:fs/promises";
+import { lstat, readFile } from "node:fs/promises";
 import process from "node:process";
 import { TextDecoder } from "node:util";
 import { analyzeDocument, selectNextTasks, } from "./application/contract6-actuals.js";
@@ -11,6 +11,7 @@ import { getProjectMetadata, } from "./application/project.js";
 import { planAdvance, planBatchMutation, planFinishActuals, planLifecycle, planMutation, } from "./application/contract6-mutation.js";
 import { renderTargetGovernanceDecision, renderTargetGovernanceProjectText, } from "./application/target-governance-projection.js";
 import { contract6MutationResultToJson, contract6ProjectResultToJson, contract6WorkEventToJson, } from "./application/contract6-projection.js";
+import { prepareAdvanceHistory, renderAdvanceHistoryGuard, withAdvanceHistoryRace, } from "./application/advance-history.js";
 import { persistTargetActualsResult, } from "./application/target-actuals-write.js";
 import { inspectTargetProjectHistoryFile, renderTargetProjectHistoryText, targetProjectHistoryResultToJson, } from "./application/target-project-history.js";
 import { observeTargetProjectVelocity, renderTargetVelocityObservationText, targetVelocityObservationResultToJson, } from "./application/target-velocity-observation.js";
@@ -25,6 +26,7 @@ import { renderActualsCommandUsageError, serializeActualsCommandUsageError, vali
 import { agentGuidanceResultToJson } from "./guidance/projection.js";
 import { agentGuidanceExitCode, renderAgentGuidanceText, } from "./guidance/text.js";
 import { documentContentFromBytes, readDocumentFile, } from "./io/document-file.js";
+import { recheckAdvanceHistoryBaseline, } from "./history/git-probe.js";
 import { createArtifactFile, createDocumentFile, replaceDocumentFile, SafeWriteConflictError, SafeWriteVerificationError, } from "./io/safe-write.js";
 import { formatDecimal } from "./model/rational.js";
 import { convertWithVelocity, durationSuffix } from "./model/units.js";
@@ -177,7 +179,24 @@ async function readDocument(source) {
     const content = source === "-"
         ? documentContentFromBytes(await readStdin())
         : await readDocumentFile(source);
-    return { text: content.text, digest: content.digest };
+    let modifiedAt = null;
+    if (source !== "-") {
+        try {
+            const metadata = await lstat(source, { bigint: true });
+            if (metadata.isFile() && !metadata.isSymbolicLink()) {
+                modifiedAt = new Date(Number(metadata.mtimeNs / 1000000n)).toISOString();
+            }
+        }
+        catch {
+            modifiedAt = null;
+        }
+    }
+    return {
+        text: content.text,
+        digest: content.digest,
+        bytes: content.bytes,
+        modifiedAt,
+    };
 }
 async function readStdin() {
     const chunks = [];
@@ -1543,6 +1562,10 @@ async function runAdvance(args) {
     const maxDiagnostics = boundedInteger(parsed.values.get("max-diagnostics"), "max-diagnostics", 100, 1, 1000);
     const sourceOperand = parsed.positionals[0];
     const writeRequest = editingWriteRequest(parsed, sourceOperand);
+    const forceRequested = parsed.flags.has("force-history-loss");
+    if (forceRequested && writeRequest.mode !== "in_place") {
+        throw new UsageError("--force-history-loss can only be used with --write");
+    }
     const source = sourceOperand === "-" ? "<stdin>" : sourceOperand;
     let input;
     try {
@@ -1551,23 +1574,54 @@ async function runAdvance(args) {
     catch (error) {
         return cliError(error instanceof Error ? error : new Error(String(error)), 3, "dag.advance", format === "json");
     }
-    const result = planAdvance(input.text, {
+    const planned = planAdvance(input.text, {
         maxDiagnostics,
         originalLabel: source,
         updatedLabel: "candidate",
         governance: governanceRequest(parsed, writeRequest),
     });
+    const initialWarningFailure = parsed.flags.has("warnings-as-errors") &&
+        (planned.diagnosticsTruncated ||
+            planned.diagnostics.some((diagnostic) => diagnostic.severity === "warning"));
+    const prepared = await prepareAdvanceHistory(input.text, planned, {
+        mode: writeRequest.mode === "out"
+            ? "out"
+            : writeRequest.mode,
+        sourceBytes: input.bytes,
+        sourceModifiedAt: input.modifiedAt,
+        ...(writeRequest.mode === "in_place"
+            ? { targetPath: sourceOperand }
+            : {}),
+        forceRequested,
+        warningDenied: initialWarningFailure,
+        maxDiagnostics,
+    });
+    let result = prepared.result;
     const warningFailure = parsed.flags.has("warnings-as-errors") &&
         (result.diagnosticsTruncated ||
             result.diagnostics.some((diagnostic) => diagnostic.severity === "warning"));
-    const ok = result.ok && !warningFailure;
+    let ok = result.ok && !warningFailure;
+    let historyRace = false;
     let writeResult = Object.freeze({
         mode: writeRequest.mode,
         target: writeRequest.target,
         written: false,
     });
-    if (result.ok) {
+    if (result.updatedText !== null) {
         try {
+            if (ok &&
+                writeRequest.mode === "in_place" &&
+                prepared.baseline !== null &&
+                prepared.baseline.status === "complete" &&
+                (result.historyGuard?.status === "passed" ||
+                    result.historyGuard?.status === "forced")) {
+                const recheck = await recheckAdvanceHistoryBaseline(prepared.baseline, sourceOperand);
+                if (!recheck.ok) {
+                    result = withAdvanceHistoryRace(result, recheck, maxDiagnostics);
+                    ok = false;
+                    historyRace = true;
+                }
+            }
             if (ok && writeRequest.mode !== "preview") {
                 writeResult = await persistGovernedResult(result, writeRequest, sourceOperand);
             }
@@ -1580,17 +1634,26 @@ async function runAdvance(args) {
         writeJson(contract6MutationResultToJson(ok ? result : Object.freeze({ ...result, ok: false }), "dag.advance", source, writeResult));
     }
     else {
-        if (ok && result.advance !== null) {
-            if (writeRequest.mode !== "preview") {
-                process.stderr.write(renderGovernanceWriteSummary("dag.advance", writeResult, result.updatedDigest));
-            }
-            else {
-                process.stdout.write(parsed.flags.has("diff") ? (result.diff ?? "") : (result.updatedText ?? ""));
-                if (!parsed.flags.has("diff")) {
-                    process.stderr.write(`PREVIEW dag.advance changed=${result.changed} original_digest=${result.originalDigest} updated_digest=${result.updatedDigest}\n`);
+        if (result.advance !== null) {
+            if (ok) {
+                if (writeRequest.mode !== "preview") {
+                    process.stderr.write(renderGovernanceWriteSummary("dag.advance", writeResult, result.updatedDigest));
+                }
+                else {
+                    process.stdout.write(parsed.flags.has("diff") ? (result.diff ?? "") : (result.updatedText ?? ""));
+                    if (!parsed.flags.has("diff")) {
+                        process.stderr.write(`PREVIEW dag.advance changed=${result.changed} original_digest=${result.originalDigest} updated_digest=${result.updatedDigest}\n`);
+                    }
                 }
             }
-            process.stderr.write(renderAdvanceSummary(result.advance));
+            if (ok ||
+                result.historyGuard?.status === "blocked" ||
+                result.historyGuard?.status === "forced") {
+                process.stderr.write(renderAdvanceSummary(result.advance));
+            }
+        }
+        if (result.historyGuard !== null) {
+            process.stderr.write(renderAdvanceHistoryGuard(result.historyGuard));
         }
         if (result.governance !== null) {
             process.stderr.write(renderTargetGovernanceDecision(result.governance));
@@ -1602,7 +1665,7 @@ async function runAdvance(args) {
             process.stderr.write(`DIAGNOSTICS_TRUNCATED true limit=${maxDiagnostics}\n`);
         }
     }
-    return ok ? 0 : 1;
+    return ok ? 0 : historyRace ? 5 : 1;
 }
 function rationalJson(value, unit, precision) {
     return {