hoi4-agent-tools 4.3.0 → 4.5.0

package/dist/hoi4_agent_tools/focus/drift.js

@@ -72,6 +72,40 @@ export function assertFocusPlanAuthority(drift, authority) {
         currentPlanHash: drift.currentPlanHash,
     });
 }
+/**
+ * True when the source changed in meaning after the plan was imported, so regenerating from the
+ * plan would overwrite those changes. A formatting-only change (the source still imports to the
+ * plan's original baseline), a source that already equals the plan, and an unchanged source are not
+ * semantic drift. This is deliberately independent of whether the plan itself was edited: a plan
+ * edit plus an external formatting change reports `conflict`, which is still safe to apply.
+ */
+export function hasSemanticSourceDrift(drift) {
+    if (!drift.sourceChanged)
+        return false;
+    if (drift.status === 'tree_removed')
+        return true;
+    return (drift.currentPlanHash !== drift.importedPlanHash &&
+        drift.currentPlanHash !== drift.savedPlanHash);
+}
+/**
+ * Refuses to regenerate a tree from a plan when the source changed in meaning after the plan was
+ * imported. Applying the plan would overwrite those external changes with stale plan values.
+ * Re-import the source with the inspect tool, reapply the intended change to the fresh plan, and
+ * retry.
+ */
+export function assertNoSemanticSourceDrift(drift, sourcePath) {
+    if (!hasSemanticSourceDrift(drift))
+        return;
+    throw new ServiceError('FOCUS_SOURCE_CHANGED_SINCE_PLAN', 'The focus source changed in meaning after the plan was imported; rewriting from the plan would overwrite those changes. Import the current source with hoi4.focus_inspect, reapply the intended edit to the fresh plan, and retry', {
+        relativePath: sourcePath,
+        status: drift.status,
+        savedSourceHash: drift.savedSourceHash,
+        currentSourceHash: drift.currentSourceHash,
+        savedPlanHash: drift.savedPlanHash,
+        currentPlanHash: drift.currentPlanHash,
+        importedPlanHash: drift.importedPlanHash,
+    });
+}
 export function detectContinuousFocusDrift(savedPlan, currentDocument) {
     const currentSourceHash = sha256Bytes(currentDocument.bytes);
     const savedPlanHash = focusPlanHash(savedPlan);

package/dist/hoi4_agent_tools/focus/service.js

@@ -5,7 +5,7 @@ import { ServiceError } from '../core/result.js';
 import { parseClausewitz } from '../core/source/index.js';
 import { TRANSACTION_MAX_DIAGNOSTICS } from '../core/transaction-limits.js';
 import { PACKAGE_VERSION } from '../version.js';
-import { assertFocusPlanAuthority, detectContinuousFocusDrift, detectFocusDrift, } from './drift.js';
+import { assertFocusPlanAuthority, assertNoSemanticSourceDrift, detectContinuousFocusDrift, detectFocusDrift, } from './drift.js';
 import { importContinuousFocusPalettes, importFocusTrees } from './importer.js';
 import { layoutFocusTree, layoutFocusTreeAsync } from './layout.js';
 import { lintContinuousFocusPalette, lintFocusTree } from './lint.js';
@@ -191,8 +191,11 @@ export class FocusWorkbench {
         const drift = targetCreated
             ? missingTargetDrift(input.plan, document)
             : detectFocusDrift(input.plan, document, input.references);
-        if (!targetCreated)
+        if (!targetCreated) {
+            if (input.onSemanticSourceDrift === 'refuse')
+                assertNoSemanticSourceDrift(drift, input.relativePath);
             assertFocusPlanAuthority(drift, input.authority ?? 'plan');
+        }
         const layout = input.layout ??
             (await layoutFocusTreeAsync(input.plan, input.signal === undefined ? {} : { signal: input.signal }));
         const after = updateFocusTreeSource(document, targetCreated ? undefined : drift.currentSourcePlan, input.plan, layout);
@@ -414,8 +417,11 @@ export class FocusWorkbench {
         const drift = targetCreated
             ? missingTargetDrift(input.plan, document)
             : detectContinuousFocusDrift(input.plan, document);
-        if (!targetCreated)
+        if (!targetCreated) {
+            if (input.onSemanticSourceDrift === 'refuse')
+                assertNoSemanticSourceDrift(drift, input.relativePath);
             assertFocusPlanAuthority(drift, input.authority ?? 'plan');
+        }
         const after = updateContinuousFocusPaletteSource(document, targetCreated ? undefined : drift.currentSourcePlan, input.plan);
         const afterHash = sha256Bytes(after);
         const operationId = deterministicId('continuous_focus_change', {

package/dist/hoi4_agent_tools/focus/tool-operations.js

@@ -147,6 +147,7 @@ export async function prepareFocusRewrite(engine, workbench, input, context) {
             plan,
             createIfMissing,
             authority: 'plan',
+            onSemanticSourceDrift: 'refuse',
             ...(context.principal === undefined ? {} : { principal: context.principal }),
             artifacts: reviewArtifacts,
             readDependencies: readDependenciesFromScannedFiles(snapshot.files),
@@ -301,6 +302,7 @@ export async function prepareFocusRewrite(engine, workbench, input, context) {
         plan,
         createIfMissing,
         authority: 'plan',
+        onSemanticSourceDrift: 'refuse',
         layout: proposed.layout,
         ...(context.principal === undefined ? {} : { principal: context.principal }),
         index: snapshot.index,