poi-plugin-remodel-assistant 1.2.5-beta.1 → 1.2.5-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-remodel-assistant",
-  "version": "1.2.5-beta.1",
+  "version": "1.2.5-beta.2",
   "description": "View enhanced KanColle improvement data, manage improvement plans, and receive improvement recommendations.",
   "main": "index.js",
   "author": {

package/views/new-interface/app/decision-snapshot-jobs.js

@@ -5,8 +5,6 @@ exports.executeDecisionSnapshotJob = exports.resetDecisionSnapshotJobState = exp
 
 var _pluginMeta = require("../../shared/plugin-meta");
 
-var _kcraTrace__ = require("../../shared/__kcra-trace__");
-
 var _planDecisionIndex = require("../incremental/plan-decision-index");
 
 var _decisionSnapshotDomain = require("../decisions/domain/decision-snapshot-domain");
@@ -76,20 +74,7 @@ const publishDecisionSnapshot = ({
     assignmentFindings: effective.assignmentFindings || [],
     assignmentDiagnostics: [...(userAllocation && userAllocation.assignmentDiagnostics || []), ...(effective.assignmentDiagnostics || [])]
   };
-  const alignmentFindings = logPublishedDecisionSnapshotAlignment(snapshot, effective.currentInventoryBindings || {});
-  (0, _kcraTrace__.__KCRA_TRACE__)('snapshot.publish.summary', {
-    itemCount: snapshot.items.length,
-    workbenchCount: snapshot.workbenchItems.length,
-    retainedBindingCount: snapshot.retainedBindingCurrentIds.length,
-    bindingCount: Object.keys(snapshot.assignmentPersistenceBindings || {}).length,
-    bindingTransitions: snapshot.assignmentBindingTransitions,
-    assignmentFindings: snapshot.assignmentFindings,
-    assignmentDiagnosticCount: snapshot.assignmentDiagnostics.length,
-    alignmentFindings
-  });
-  (0, _kcraTrace__.__KCRA_TRACE__)('snapshot.publish.full', snapshot, {
-    full: true
-  });
+  logPublishedDecisionSnapshotAlignment(snapshot, effective.currentInventoryBindings || {});
   return snapshot;
 };
 
@@ -292,18 +277,20 @@ const buildFullDecisionSnapshotPayload = input => {
     useitems: job.useitems || {},
     resourceBudget: job.resourceBudget || {}
   });
-};
+}; // Transient projection caches only. They are optimization state, never Plan/Binding authority.
+// Clearing them must be semantically equivalent to a Full rebuild from current Reality.
+
 
 exports.buildFullDecisionSnapshotPayload = buildFullDecisionSnapshotPayload;
-let baseIncrementalSnapshotState = null;
-let effectiveIncrementalSnapshotState = null;
+let baseIncrementalProjectionCacheState = null;
+let effectiveIncrementalProjectionCacheState = null;
 
 const buildDecisionSnapshotPayload = (input, profile = null) => {
   const job = input || {};
 
   if (_pluginMeta.FORCE_FULL_DECISION_REBUILD) {
-    baseIncrementalSnapshotState = null;
-    effectiveIncrementalSnapshotState = null;
+    baseIncrementalProjectionCacheState = null;
+    effectiveIncrementalProjectionCacheState = null;
     return buildFullDecisionSnapshotPayload(job, profile);
   }
 
@@ -316,15 +303,15 @@ const buildDecisionSnapshotPayload = (input, profile = null) => {
 
   const baseResult = (0, _planDecisionIndex.buildIncrementalDecisionSnapshot)(_extends({}, job, {
     currentInventoryBindings: baseBindings,
-    previous: baseIncrementalSnapshotState,
+    previous: baseIncrementalProjectionCacheState,
     allocationScope: 'user',
     profile: prefixedProfile(profile, 'base')
   }));
   measureProfile(profile, 'base-core-total', phaseStartedAt, {
-    hadPrevious: Boolean(baseIncrementalSnapshotState),
+    hadPrevious: Boolean(baseIncrementalProjectionCacheState),
     planGroupCount: Object.keys(job.plans || {}).length
   });
-  baseIncrementalSnapshotState = baseResult.state;
+  baseIncrementalProjectionCacheState = baseResult.state;
   const base = baseResult.value;
   observeAllocationStage(job, 'UserAllocation', _extends({
     mode: 'incremental'
@@ -367,8 +354,8 @@ const buildDecisionSnapshotPayload = (input, profile = null) => {
   // incremental diff remains the correctness gate and recomputes every changed
   // Plan/Binding target.
 
-  const effectivePrevious = effectiveIncrementalSnapshotState || baseResult.state;
-  const seededEffectiveFromBase = !effectiveIncrementalSnapshotState && Boolean(baseResult.state);
+  const effectivePrevious = effectiveIncrementalProjectionCacheState || baseResult.state;
+  const seededEffectiveFromBase = !effectiveIncrementalProjectionCacheState && Boolean(baseResult.state);
   const effectiveResult = (0, _planDecisionIndex.buildIncrementalDecisionSnapshot)(_extends({}, job, {
     plans: composition.plans,
     currentInventoryBindings: effectiveBindings,
@@ -381,7 +368,7 @@ const buildDecisionSnapshotPayload = (input, profile = null) => {
     seededFromBase: seededEffectiveFromBase,
     planGroupCount: Object.keys(composition.plans || {}).length
   });
-  effectiveIncrementalSnapshotState = effectiveResult.state;
+  effectiveIncrementalProjectionCacheState = effectiveResult.state;
   const effective = effectiveResult.value;
   observeAllocationStage(job, 'ConsumableAllocation', _extends({
     mode: 'incremental'
@@ -404,8 +391,8 @@ const buildDecisionSnapshotPayload = (input, profile = null) => {
 exports.buildDecisionSnapshotPayload = buildDecisionSnapshotPayload;
 
 const resetDecisionSnapshotJobState = () => {
-  baseIncrementalSnapshotState = null;
-  effectiveIncrementalSnapshotState = null;
+  baseIncrementalProjectionCacheState = null;
+  effectiveIncrementalProjectionCacheState = null;
 };
 
 exports.resetDecisionSnapshotJobState = resetDecisionSnapshotJobState;

package/views/new-interface/app/decision-snapshot-service.js

@@ -9,6 +9,8 @@ var _startupPerformance = require("../../shared/startup-performance");
 
 var _equipmentBlacklistDomain = require("../equipment/domain/equipment-blacklist-domain");
 
+var _pluginResourcePaths = require("../../shared/plugin-resource-paths");
+
 var _decisionSnapshotJobs = require("./decision-snapshot-jobs");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -173,7 +175,8 @@ const requestDecisionSnapshot = inputs => {
     planRouteSelections: inputs.planRouteSelections,
     routeAcquisitionIndex: inputs.routeAcquisitionIndex || {},
     currentInventoryBindings: inputs.currentInventoryBindings || {},
-    lowPriorityEquipmentIds: (0, _equipmentBlacklistDomain.getLowPriorityEquipmentIds)(inputs.equipmentBlacklist)
+    lowPriorityEquipmentIds: (0, _equipmentBlacklistDomain.getLowPriorityEquipmentIds)(inputs.equipmentBlacklist),
+    startupSnapshotPath: (0, _pluginResourcePaths.getStartupSnapshotPath)()
   };
 
   if (workerRuntime() === 'inline') {

package/views/new-interface/app/decision-snapshot-worker.js

@@ -7,10 +7,33 @@ const {
   executeDecisionSnapshotJob
 } = require('./decision-snapshot-jobs');
 
+const {
+  writePersistentStartupDecisionSnapshot
+} = require('./startup-decision-snapshot-storage');
+
+let startupSnapshotPersistTimer = null;
+let pendingStartupSnapshotPersistence = null;
+
 const send = message => {
   if (parentPort) parentPort.postMessage(message);else if (typeof process.send === 'function') process.send(message);
 };
 
+const scheduleStartupSnapshotPersistence = (filePath, snapshot) => {
+  if (!filePath || !snapshot) return;
+  pendingStartupSnapshotPersistence = {
+    filePath,
+    snapshot
+  };
+  if (startupSnapshotPersistTimer) clearTimeout(startupSnapshotPersistTimer);
+  startupSnapshotPersistTimer = setTimeout(() => {
+    startupSnapshotPersistTimer = null;
+    const pending = pendingStartupSnapshotPersistence;
+    pendingStartupSnapshotPersistence = null;
+    if (!pending) return;
+    writePersistentStartupDecisionSnapshot(pending.snapshot, pending.filePath);
+  }, 1000);
+};
+
 const respond = (requestId, job) => {
   try {
     const result = executeDecisionSnapshotJob(job);
@@ -18,7 +41,10 @@ const respond = (requestId, job) => {
       requestId,
       ok: true,
       result
-    });
+    }); // Persistence is deliberately scheduled only after the calculated snapshot
+    // has been returned to Poi. It therefore cannot delay renderer publication.
+
+    scheduleStartupSnapshotPersistence(job && job.startupSnapshotPath, result);
   } catch (error) {
     send({
       requestId,

package/views/new-interface/app/new-interface-area.js

@@ -17,8 +17,6 @@ var _core = require("@blueprintjs/core");
 
 var _pluginMeta = require("../../shared/plugin-meta");
 
-var _kcraTrace__ = require("../../shared/__kcra-trace__");
-
 var _startupPerformance = require("../../shared/startup-performance");
 
 var _dataPackageDomain = require("../../shared/domain/data-package-domain");
@@ -29,6 +27,8 @@ var _decisionFoundationService = require("./decision-foundation-service");
 
 var _decisionSnapshotService = require("./decision-snapshot-service");
 
+var _startupDecisionSnapshotStorage = require("./startup-decision-snapshot-storage");
+
 var _decisionSnapshotRequestGate = require("./decision-snapshot-request-gate");
 
 var _search = require("../../shared/search");
@@ -205,8 +205,9 @@ class NewInterfaceArea extends _react.Component {
     this.plansOverrideBase = null;
     this.decisionSnapshotTaskId = 0;
     this.decisionSnapshotRequestGate = (0, _decisionSnapshotRequestGate.createDecisionSnapshotRequestGate)();
-    this.decisionSnapshotRefreshQueued = false;
-    this.pendingDecisionAfterReady = [];
+    this.decisionSnapshotInvalidationQueue = [];
+    this.decisionSnapshotInvalidationDrainScheduled = false;
+    this.decisionRealityReadyCallbacks = [];
     this.exclusionRecommendationTaskId = 0;
     const workbenchFilters = (0, _uiPreferences.getWorkbenchFilters)(_pluginStateStorage.pluginConfig);
     this.state = {
@@ -245,16 +246,29 @@ class NewInterfaceArea extends _react.Component {
     this.planEquipmentAssignments = persistedPlanEquipmentAssignments();
     const snapshotInputs = decisionSnapshotInputsFor(props, this.state, this.plansOverride, this.plansOverrideBase, this.planEquipmentAssignments);
     const processCacheStartedAt = (0, _startupPerformance.startupPerformanceNow)();
-    this.currentDecisionSnapshot = (0, _legacyAssignmentRecovery.hasUnfinishedLegacyAssignmentRecovery)((0, _pluginStateStorage.getPluginStateSnapshot)()) ? null : (0, _decisionSnapshotCache.readProcessDecisionSnapshotCache)(snapshotInputs);
+    const legacyRecoveryPending = (0, _legacyAssignmentRecovery.hasUnfinishedLegacyAssignmentRecovery)((0, _pluginStateStorage.getPluginStateSnapshot)());
+    const processSnapshot = legacyRecoveryPending ? null : (0, _decisionSnapshotCache.readProcessDecisionSnapshotCache)(snapshotInputs);
+    const startupSnapshot = !legacyRecoveryPending && !processSnapshot ? (0, _startupDecisionSnapshotStorage.readPersistentStartupDecisionSnapshot)() : null;
+    this.currentDecisionSnapshot = processSnapshot || startupSnapshot;
     (0, _startupPerformance.measureStartupPerformance)('decision.process-cache-lookup', processCacheStartedAt, {
-      cacheHit: Boolean(this.currentDecisionSnapshot)
+      cacheHit: Boolean(processSnapshot),
+      persistentStartupHit: Boolean(startupSnapshot)
     });
 
-    if (!this.currentDecisionSnapshot) {
+    if (!processSnapshot) {
       (0, _startupPerformance.markStartupPerformance)('decision.process-cache-miss-detail', (0, _decisionSnapshotCache.inspectDecisionSnapshotCache)(snapshotInputs));
     }
 
-    this.currentDecisionSnapshotInputs = this.currentDecisionSnapshot ? snapshotInputs : null;
+    if (startupSnapshot) {
+      (0, _startupPerformance.markStartupPerformance)('decision.persistent-startup-snapshot-published', {
+        itemCount: Array.isArray(startupSnapshot.items) ? startupSnapshot.items.length : 0
+      });
+    } // A persistent startup snapshot is presentation-only stale state. Never give
+    // it current input identity: componentDidMount must still run the current
+    // Reality Full path instead of treating the stale snapshot as an exact cache hit.
+
+
+    this.currentDecisionSnapshotInputs = processSnapshot ? snapshotInputs : null;
     this.decisionSnapshotFeedbackGuard = (0, _decisionSnapshotRequestGate.createDecisionSnapshotFeedbackGuard)();
     this.latestStableStateValidation = null;
     if (this.currentDecisionSnapshot) this.state.decisionSnapshotLoading = false;
@@ -307,8 +321,11 @@ class NewInterfaceArea extends _react.Component {
     this.mounted = false;
     this.decisionSnapshotTaskId += 1;
     this.decisionSnapshotRequestGate.reset();
-    this.decisionSnapshotRefreshQueued = false;
-    this.pendingDecisionAfterReady = [];
+    this.decisionSnapshotInvalidationQueue.splice(0).forEach(item => {
+      if (item && typeof item.resolve === 'function') item.resolve(null);
+    });
+    this.decisionSnapshotInvalidationDrainScheduled = false;
+    this.decisionRealityReadyCallbacks = [];
     this.exclusionRecommendationTaskId += 1;
     this.stopObservingWorkspaceSize();
     this.setEquipmentDividerRef(null);
@@ -743,9 +760,6 @@ var _initialiseProps = function () {
           snapshot
         });
         this.latestStableStateValidation = stableValidation;
-        (0, _kcraTrace__.__KCRA_TRACE__)('validator.stable-state', stableValidation, {
-          full: true
-        });
         return {
           ok: true,
           stableValidation
@@ -774,7 +788,7 @@ var _initialiseProps = function () {
 
       if (!snapshotInputs.equipmentRealityReady) {
         (0, _startupPerformance.markStartupPerformance)('decision.waiting-for-reality');
-        if (afterReady) this.pendingDecisionAfterReady.push(afterReady);
+        if (afterReady) this.decisionRealityReadyCallbacks.push(afterReady);
         return Promise.resolve(null);
       }
 
@@ -782,15 +796,6 @@ var _initialiseProps = function () {
         planGroupCount: Object.keys(snapshotInputs.plans || {}).length,
         bindingCount: Object.keys(snapshotInputs.currentInventoryBindings || {}).length
       });
-      (0, _kcraTrace__.__KCRA_TRACE__)('snapshot.request.inputs', {
-        plans: snapshotInputs.plans,
-        planRouteSelections: snapshotInputs.planRouteSelections,
-        currentInventoryBindings: snapshotInputs.currentInventoryBindings,
-        equipmentRealityReady: snapshotInputs.equipmentRealityReady,
-        actualEquipInventory: snapshotInputs.actualEquipInventory
-      }, {
-        full: true
-      });
       const recoveryStartedAt = (0, _startupPerformance.startupPerformanceNow)();
       const recovery = (0, _pluginStateCommands.runPendingLegacyAssignmentRecovery)({
         equipInventory: snapshotInputs.actualEquipInventory
@@ -816,8 +821,8 @@ var _initialiseProps = function () {
         });
       }
 
-      const deferredAfterReady = afterReady || this.pendingDecisionAfterReady.length > 0 ? snapshot => {
-        const callbacks = this.pendingDecisionAfterReady.splice(0);
+      const deferredAfterReady = afterReady || this.decisionRealityReadyCallbacks.length > 0 ? snapshot => {
+        const callbacks = this.decisionRealityReadyCallbacks.splice(0);
         callbacks.forEach(callback => callback(snapshot));
         if (afterReady) afterReady(snapshot);
       } : null;
@@ -838,32 +843,49 @@ var _initialiseProps = function () {
       const activeRequest = this.decisionSnapshotRequestGate.readActive();
 
       if (activeRequest) {
-        if (afterReady) this.pendingDecisionAfterReady.push(afterReady);
-
-        if (!this.decisionSnapshotRefreshQueued) {
-          this.decisionSnapshotRefreshQueued = true;
-          activeRequest.then(() => {
-            if (!this.mounted) return null;
-            this.decisionSnapshotRefreshQueued = false;
-            const callbacks = this.pendingDecisionAfterReady.splice(0);
-
-            if (!this.decisionSnapshotRequestGate.shouldRefresh(this.getDecisionSnapshotInputs())) {
-              callbacks.forEach(callback => {
-                if (this.currentDecisionSnapshot) callback(this.currentDecisionSnapshot);
-              });
-              return this.currentDecisionSnapshot;
+        // Snapshot invalidations are a FIFO work queue, not a coalescing flag. Each
+        // invalidation is consumed after the current isolated Snapshot finishes. A
+        // queued item intentionally reads the latest Reality when it starts; this
+        // runtime requires eventual consistency, not historical event replay.
+        const queued = new Promise(resolve => {
+          this.decisionSnapshotInvalidationQueue.push({
+            afterReady,
+            resolve
+          });
+        });
+
+        if (!this.decisionSnapshotInvalidationDrainScheduled) {
+          this.decisionSnapshotInvalidationDrainScheduled = true;
+
+          const drain = () => {
+            if (!this.mounted) {
+              this.decisionSnapshotInvalidationDrainScheduled = false;
+              this.decisionSnapshotInvalidationQueue.splice(0).forEach(item => item.resolve(null));
+              return null;
+            }
+
+            const item = this.decisionSnapshotInvalidationQueue.shift();
+
+            if (!item) {
+              this.decisionSnapshotInvalidationDrainScheduled = false;
+              return null;
             }
 
             return this.scheduleDecisionSnapshotRefresh({
-              afterReady: snapshot => callbacks.forEach(callback => callback(snapshot))
+              afterReady: item.afterReady
+            }).then(snapshot => {
+              item.resolve(snapshot);
+              return drain();
+            }, () => {
+              item.resolve(null);
+              return drain();
             });
-          }, () => {
-            this.decisionSnapshotRefreshQueued = false;
-            if (this.mounted && this.decisionSnapshotRequestGate.shouldRefresh(this.getDecisionSnapshotInputs())) this.scheduleDecisionSnapshotRefresh();
-          });
+          };
+
+          activeRequest.then(drain, drain);
         }
 
-        return activeRequest;
+        return queued;
       }
 
       const taskId = this.decisionSnapshotTaskId + 1;
@@ -1030,9 +1052,6 @@ var _initialiseProps = function () {
         snapshot: this.currentDecisionSnapshot
       });
       this.latestStableStateValidation = result;
-      (0, _kcraTrace__.__KCRA_TRACE__)('validator.manual-stable-state', result, {
-        full: true
-      });
       return result;
     }
   });

package/views/new-interface/app/startup-decision-snapshot-storage.js

@@ -0,0 +1,84 @@
+"use strict";
+
+exports.__esModule = true;
+exports.STARTUP_DECISION_SNAPSHOT_SCHEMA = exports.STARTUP_DECISION_SNAPSHOT_FORMAT = exports.clearPersistentStartupDecisionSnapshot = exports.writePersistentStartupDecisionSnapshot = exports.readPersistentStartupDecisionSnapshot = void 0;
+
+var _fs = _interopRequireDefault(require("fs"));
+
+var _path = _interopRequireDefault(require("path"));
+
+var _pluginMeta = require("../../shared/plugin-meta");
+
+var _pluginResourcePaths = require("../../shared/plugin-resource-paths");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const v8 = require('v8');
+
+const STARTUP_DECISION_SNAPSHOT_FORMAT = `${_pluginMeta.PLUGIN_ID}.startup-decision-snapshot`;
+exports.STARTUP_DECISION_SNAPSHOT_FORMAT = STARTUP_DECISION_SNAPSHOT_FORMAT;
+const STARTUP_DECISION_SNAPSHOT_SCHEMA = 2;
+exports.STARTUP_DECISION_SNAPSHOT_SCHEMA = STARTUP_DECISION_SNAPSHOT_SCHEMA;
+
+const isPlainObject = value => value != null && typeof value === 'object' && !Array.isArray(value);
+
+const snapshotEnvelope = snapshot => ({
+  format: STARTUP_DECISION_SNAPSHOT_FORMAT,
+  schemaVersion: STARTUP_DECISION_SNAPSHOT_SCHEMA,
+  snapshot
+}); // Startup Snapshot is disposable derived presentation state. The renderer reads
+// it synchronously so the previous UI can paint before the current-Reality Full.
+// V8 structured serialization is used because the Decision Snapshot is already
+// transferred through advanced IPC and is not guaranteed to be JSON-serializable.
+
+
+const readPersistentStartupDecisionSnapshot = () => {
+  const filePath = (0, _pluginResourcePaths.getStartupSnapshotPath)();
+
+  try {
+    if (!_fs.default.existsSync(filePath)) return null;
+    const value = v8.deserialize(_fs.default.readFileSync(filePath));
+
+    if (!isPlainObject(value) || value.format !== STARTUP_DECISION_SNAPSHOT_FORMAT || Number(value.schemaVersion) !== STARTUP_DECISION_SNAPSHOT_SCHEMA || !isPlainObject(value.snapshot)) {
+      return null;
+    }
+
+    return value.snapshot;
+  } catch (error) {
+    return null;
+  }
+}; // This function is intended for the Decision worker, never the Poi renderer.
+// Cache durability is deliberately best-effort: a partial/corrupt write simply
+// becomes a cache miss at the next startup and the normal Full path rebuilds it.
+
+
+exports.readPersistentStartupDecisionSnapshot = readPersistentStartupDecisionSnapshot;
+
+const writePersistentStartupDecisionSnapshot = (snapshot, filePath = null) => {
+  if (!isPlainObject(snapshot)) return false;
+  const targetPath = filePath || (0, _pluginResourcePaths.getStartupSnapshotPath)();
+  const directory = filePath ? _path.default.dirname(targetPath) : (0, _pluginResourcePaths.getStartupSnapshotDirectory)();
+
+  try {
+    _fs.default.mkdirSync(directory, {
+      recursive: true
+    });
+
+    _fs.default.writeFileSync(targetPath, v8.serialize(snapshotEnvelope(snapshot)));
+
+    return true;
+  } catch (error) {
+    return false;
+  }
+};
+
+exports.writePersistentStartupDecisionSnapshot = writePersistentStartupDecisionSnapshot;
+
+const clearPersistentStartupDecisionSnapshot = () => {
+  try {
+    _fs.default.unlinkSync((0, _pluginResourcePaths.getStartupSnapshotPath)());
+  } catch (error) {// Best-effort cache cleanup: missing/unremovable cache is not fatal.
+  }
+};
+
+exports.clearPersistentStartupDecisionSnapshot = clearPersistentStartupDecisionSnapshot;

package/views/new-interface/incremental/plan-decision-index.js

@@ -1,7 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
-exports.buildIncrementalDecisionSnapshot = void 0;
+exports.buildIncrementalDecisionSnapshot = exports.plansAcceptingEquipmentIds = exports.buildPlanAcceptIndex = void 0;
 
 var _decisionChainDomain = require("../decisions/domain/decision-chain-domain");
 
@@ -81,23 +81,64 @@ const projectDecisionItemDay = (item, today, ownedShipMasterIds, edgeCostResolve
     routeChoice,
     planCost
   });
-};
+}; // Accept Index is an inverted structural dependency index: equipmentId -> Plan target ids
+// whose compiled Route Metadata contains that equipment state. It is deliberately
+// conservative and has no Allocation authority. False positives only cause a cheap
+// Plan recomputation; false negatives would be a correctness defect.
+//
+// Build this index from durable Plan intent + structural Route Metadata, not from
+// the previous pending-planning projection. Completed Plans intentionally have no
+// pending occurrences, but an Equipment Reality change may make their completion
+// predicate false again; they must therefore remain discoverable here.
+
+
+const buildPlanAcceptIndex = ({
+  plans = {},
+  preparedGraph = null,
+  routeAcquisitionIndex = {}
+} = {}) => {
+  const acceptedByEquipmentId = {};
+
+  const add = (equipmentId, planId) => {
+    const equipment = Number(equipmentId);
+    const plan = Number(planId);
+    if (!Number.isInteger(equipment) || equipment <= 0 || !Number.isInteger(plan) || plan <= 0) return;
+    if (!acceptedByEquipmentId[equipment]) acceptedByEquipmentId[equipment] = new Set();
+    acceptedByEquipmentId[equipment].add(plan);
+  };
 
-const plansInFamilies = (foundation, plans, itemIds) => {
-  const affectedFamilies = new Set();
-  const ids = itemIds || [];
-  ids.forEach(id => {
-    const dependency = foundation.dependencyIndex || {};
-    const familyKey = (dependency.familyByItem || {})[id];
-    if (familyKey) affectedFamilies.add(familyKey);
-  });
-  return Object.keys(plans || {}).map(Number).filter(id => {
-    const dependency = foundation.dependencyIndex || {};
-    const familyKey = (dependency.familyByItem || {})[id];
-    return affectedFamilies.has(familyKey) || (itemIds || []).includes(id);
+  Object.keys(plans || {}).forEach(rawPlanId => {
+    const planId = Number(rawPlanId);
+    if (!Number.isInteger(planId) || planId <= 0) return;
+    (0, _planFactsDomain.configuredPlanGoals)(plans[rawPlanId] || {}).forEach(goal => {
+      const targetLevel = Number(goal && goal.star);
+      if (!Number.isInteger(targetLevel) || targetLevel < 0) return;
+      const metadata = (0, _currentStartCandidateDomain.buildPlanRouteMetadata)({
+        preparedGraph,
+        target: {
+          id: planId,
+          level: targetLevel
+        },
+        routeAcquisitionIndex
+      });
+      Object.keys(metadata && metadata.stateIndex || {}).forEach(key => {
+        const state = metadata.stateIndex[key];
+        add(state && state.equipmentId, planId);
+      });
+    });
   });
+  return Object.keys(acceptedByEquipmentId).reduce((result, equipmentId) => {
+    result[equipmentId] = Array.from(acceptedByEquipmentId[equipmentId]).sort((a, b) => a - b);
+    return result;
+  }, {});
 };
 
+exports.buildPlanAcceptIndex = buildPlanAcceptIndex;
+
+const plansAcceptingEquipmentIds = (acceptIndex = {}, equipmentIds = []) => numericIds((equipmentIds || []).reduce((result, equipmentId) => result.concat(acceptIndex[Number(equipmentId)] || []), []));
+
+exports.plansAcceptingEquipmentIds = plansAcceptingEquipmentIds;
+
 const changedRouteSelectionTargets = (previousSelections = {}, nextSelections = {}) => {
   const previous = previousSelections || {};
   const next = nextSelections || {};
@@ -231,10 +272,14 @@ const buildIncrementalDecisionSnapshot = ({
         affectedPlanCount: 0,
         recomputedPlanCount: 0,
         affectedPlanIds: [],
+        routePlanningWorkPlanIds: [],
         recomputedPlanIds: [],
+        recomputedRoutePlanningPlanIds: [],
         recomputedDecisionItemCount: 0,
         recomputedDecisionItemIds: [],
+        decisionProjectionDirtyItemIds: [],
         recomputedTodayEntryPlanCount: 0,
+        todayProjectionDirtyPlanIds: [],
         dateChanged: false,
         durationMs: Date.now() - startedAt
       }
@@ -261,9 +306,11 @@ const buildIncrementalDecisionSnapshot = ({
   phaseStartedAt = profileNow();
   const edgeCostResolver = (0, _edgeCostIndex.createEdgeCostResolver)(foundation.edgeCostIndex || {});
   const decisionItemById = previous ? _extends({}, previous.decisionItemById || {}) : {};
-  const evolutionTargetIds = evolutionTargets(foundation.effectiveData || []);
-  const recomputedDecisionItemIds = previous ? numericIds(changedPlanIds.concat(changedInventoryItemIds).concat(changedDecisionSelectionItemIds).concat(changedInventoryBindingTargets).concat(foundationAffectedIds).concat(changedLowPriorityItemIds).concat(ownedShipsChanged ? rowIds : [])) : rowIds;
-  recomputedDecisionItemIds.forEach(id => {
+  const evolutionTargetIds = evolutionTargets(foundation.effectiveData || []); // Projection dirty-set: these ids rebuild Decision presentation/facts only.
+  // They are not concrete Binding work and carry no Allocation authority.
+
+  const decisionProjectionDirtyItemIds = previous ? numericIds(changedPlanIds.concat(changedInventoryItemIds).concat(changedDecisionSelectionItemIds).concat(changedInventoryBindingTargets).concat(foundationAffectedIds).concat(changedLowPriorityItemIds).concat(ownedShipsChanged ? rowIds : [])) : rowIds;
+  decisionProjectionDirtyItemIds.forEach(id => {
     if (!rowsById[id]) return;
     decisionItemById[id] = (0, _decisionDomain.buildDecisionItem)(rowsById[id], {
       plans,
@@ -285,12 +332,12 @@ const buildIncrementalDecisionSnapshot = ({
     if (!rowsById[id]) delete decisionItemById[id];
   });
   measureProfile(profile, 'decision-items', phaseStartedAt, {
-    recomputedDecisionItemCount: recomputedDecisionItemIds.length
+    recomputedDecisionItemCount: decisionProjectionDirtyItemIds.length
   });
   phaseStartedAt = profileNow();
   const dayItemById = previous ? _extends({}, previous.dayItemById || {}) : {};
-  const dayAffectedItemIds = !previous || dateChanged || ownedShipsChanged ? rowIds : recomputedDecisionItemIds;
-  dayAffectedItemIds.forEach(id => {
+  const dayProjectionDirtyItemIds = !previous || dateChanged || ownedShipsChanged ? rowIds : decisionProjectionDirtyItemIds;
+  dayProjectionDirtyItemIds.forEach(id => {
     if (!decisionItemById[id]) return;
     dayItemById[id] = projectDecisionItemDay(decisionItemById[id], initialDay, ownedShipMasterIds, edgeCostResolver);
   });
@@ -299,25 +346,47 @@ const buildIncrementalDecisionSnapshot = ({
   });
   const dayItems = rowIds.map(id => dayItemById[id]).filter(Boolean);
   measureProfile(profile, 'day-projection', phaseStartedAt, {
-    affectedItemCount: dayAffectedItemIds.length,
+    affectedItemCount: dayProjectionDirtyItemIds.length,
     dayItemCount: dayItems.length
   });
   phaseStartedAt = profileNow();
   const routePlanningById = previous ? _extends({}, previous.routePlanningById || {}) : {};
   const planEntryById = previous ? _extends({}, previous.planEntryById || {}) : {};
-  const routeAffectedSeeds = numericIds(changedPlanIds.concat(changedInventoryItemIds).concat(changedAcquisitionItemIds).concat(changedSelectionTargets).concat(changedInventoryBindingTargets).concat(foundationAffectedIds));
-  const affectedPlanIds = previous ? numericIds(routeAffectedSeeds.concat(plansInFamilies(foundation, plans, routeAffectedSeeds))) : numericIds(Object.keys(plans));
-  const recomputedPlanIds = [];
-  const activeAffectedPlanIds = affectedPlanIds.filter(id => Object.prototype.hasOwnProperty.call(plans, id) || Object.prototype.hasOwnProperty.call(plans, String(id)));
-  const affectedPlans = activeAffectedPlanIds.reduce((result, id) => {
+  const previousAcceptIndex = previous ? previous.planAcceptIndex || buildPlanAcceptIndex({
+    plans,
+    preparedGraph: foundation.improvementGraph || null,
+    routeAcquisitionIndex
+  }) : {};
+  const currentAcceptIndex = buildPlanAcceptIndex({
+    plans,
+    preparedGraph: foundation.improvementGraph || null,
+    routeAcquisitionIndex
+  });
+  const inventoryRoutePlanningCandidateIds = previous ? plansAcceptingEquipmentIds(previousAcceptIndex, changedInventoryItemIds) : []; // Acquisition facts participate in compiled Route Metadata. Use both the old and
+  // current Accept Index so additions and removals are symmetric: a Plan affected
+  // only before or only after the acquisition change is still rediscovered.
+
+  const acquisitionRoutePlanningCandidateIds = previous ? numericIds(plansAcceptingEquipmentIds(previousAcceptIndex, changedAcquisitionItemIds).concat(plansAcceptingEquipmentIds(currentAcceptIndex, changedAcquisitionItemIds))) : []; // Route selection and Binding changes already carry target Plan ids. Foundation
+  // `affectedItemIds` is structurally closed by the Foundation engine (including
+  // topology-family propagation), so expanding families again here would be a
+  // second dependency authority.
+
+  const directRoutePlanningSeedIds = numericIds(changedPlanIds.concat(changedSelectionTargets).concat(changedInventoryBindingTargets).concat(foundationAffectedIds)); // Route Planning work-set: legal-route analysis is read-only and Plan-local.
+  // This set must not be confused with the concrete Assignment Coordinator,
+  // which still performs one ordered frozen Allocation round below.
+
+  const routePlanningWorkPlanIds = previous ? numericIds(directRoutePlanningSeedIds.concat(inventoryRoutePlanningCandidateIds).concat(acquisitionRoutePlanningCandidateIds)) : numericIds(Object.keys(plans));
+  const recomputedRoutePlanningPlanIds = [];
+  const activeRoutePlanningWorkPlanIds = routePlanningWorkPlanIds.filter(id => Object.prototype.hasOwnProperty.call(plans, id) || Object.prototype.hasOwnProperty.call(plans, String(id)));
+  const routePlanningWorkPlans = activeRoutePlanningWorkPlanIds.reduce((result, id) => {
     result[id] = plans[id] || plans[String(id)] || {};
     return result;
   }, {});
 
-  if (activeAffectedPlanIds.length > 0) {
+  if (activeRoutePlanningWorkPlanIds.length > 0) {
     const refreshed = (0, _currentStartCandidateDomain.buildCurrentStartPlanningStates)({
       data: foundation.effectiveData || [],
-      plans: affectedPlans,
+      plans: routePlanningWorkPlans,
       equipLevels,
       equipInventory,
       routeAcquisitionIndex,
@@ -329,23 +398,23 @@ const buildIncrementalDecisionSnapshot = ({
     });
     refreshed.forEach(planning => {
       routePlanningById[Number(planning.id)] = planning;
-      recomputedPlanIds.push(Number(planning.id));
+      recomputedRoutePlanningPlanIds.push(Number(planning.id));
     });
   }
 
-  affectedPlanIds.forEach(id => {
+  routePlanningWorkPlanIds.forEach(id => {
     if (!Object.prototype.hasOwnProperty.call(plans, id) && !Object.prototype.hasOwnProperty.call(plans, String(id))) {
       delete routePlanningById[id];
       delete planEntryById[id];
     }
   });
   measureProfile(profile, 'route-planning', phaseStartedAt, {
-    affectedPlanCount: affectedPlanIds.length,
-    recomputedPlanCount: recomputedPlanIds.length
+    affectedPlanCount: routePlanningWorkPlanIds.length,
+    recomputedPlanCount: recomputedRoutePlanningPlanIds.length
   });
   phaseStartedAt = profileNow();
-  const todayAffectedPlanIds = !previous || dateChanged || ownedShipsChanged ? numericIds(Object.keys(plans)) : numericIds(affectedPlanIds.concat(changedDecisionSelectionItemIds).concat(changedLowPriorityItemIds));
-  todayAffectedPlanIds.forEach(id => {
+  const todayProjectionDirtyPlanIds = !previous || dateChanged || ownedShipsChanged ? numericIds(Object.keys(plans)) : numericIds(routePlanningWorkPlanIds.concat(changedDecisionSelectionItemIds).concat(changedLowPriorityItemIds));
+  todayProjectionDirtyPlanIds.forEach(id => {
     const item = dayItemById[id];
     const planning = routePlanningById[id] || defaultRoutePlanning(item || {
       id,
@@ -366,7 +435,7 @@ const buildIncrementalDecisionSnapshot = ({
   });
   const projectedWorkbenchItems = (0, _decisionDomain.sortDecisionItems)(rowIds.reduce((result, id) => result.concat(planEntryById[id] || []), []));
   measureProfile(profile, 'today-entry-projection', phaseStartedAt, {
-    affectedPlanCount: todayAffectedPlanIds.length,
+    affectedPlanCount: todayProjectionDirtyPlanIds.length,
     workbenchCount: projectedWorkbenchItems.length
   });
   phaseStartedAt = profileNow();
@@ -377,7 +446,10 @@ const buildIncrementalDecisionSnapshot = ({
   const allocationRetainedBindingCurrentIds = (0, _currentStartAssignmentDomain.finalRetainedBindingCurrentIds)({
     plans,
     routePlannings: numericIds(Object.keys(routePlanningById)).map(id => routePlanningById[id])
-  });
+  }); // Concrete Binding authority. The Coordinator itself is the synchronous
+  // authority-ordered consumer; incremental dirty-sets above only avoid rebuilding
+  // read-only Plan/Projection inputs and never decide inventory ownership.
+
   const ownership = (0, _currentStartAssignmentDomain.reconcileCurrentStartAssignments)({
     entries: projectedWorkbenchItems,
     equipInventory,
@@ -463,13 +535,17 @@ const buildIncrementalDecisionSnapshot = ({
       changedPlanIds,
       changedAcquisitionItemCount: changedAcquisitionItemIds.length,
       changedAcquisitionItemIds,
-      affectedPlanCount: affectedPlanIds.length,
-      recomputedPlanCount: recomputedPlanIds.length,
-      affectedPlanIds,
-      recomputedPlanIds,
-      recomputedDecisionItemCount: recomputedDecisionItemIds.length,
-      recomputedDecisionItemIds,
-      recomputedTodayEntryPlanCount: todayAffectedPlanIds.length,
+      affectedPlanCount: routePlanningWorkPlanIds.length,
+      affectedPlanIds: routePlanningWorkPlanIds,
+      recomputedPlanCount: recomputedRoutePlanningPlanIds.length,
+      routePlanningWorkPlanIds,
+      recomputedPlanIds: recomputedRoutePlanningPlanIds,
+      recomputedRoutePlanningPlanIds,
+      recomputedDecisionItemCount: decisionProjectionDirtyItemIds.length,
+      recomputedDecisionItemIds: decisionProjectionDirtyItemIds,
+      decisionProjectionDirtyItemIds,
+      recomputedTodayEntryPlanCount: todayProjectionDirtyPlanIds.length,
+      todayProjectionDirtyPlanIds,
       dateChanged,
       durationMs: Date.now() - startedAt
     }
@@ -485,6 +561,7 @@ const buildIncrementalDecisionSnapshot = ({
       acquisitionSignatures: currentAcquisitionSignatures,
       routeAcquisitionIndexRef: routeAcquisitionIndex,
       routePlanningById,
+      planAcceptIndex: currentAcceptIndex,
       planEntryById,
       planRouteSelections,
       decisionSelections,

package/views/new-interface/shared/components/detail-panel.js

@@ -383,7 +383,8 @@ class DetailPanel extends _react.Component {
     const showUpgradeRoute = mode === 'equipment' && item && Number(item.id) === Number(upgradeRouteItemId);
     const executionLevel = hasResolvedExecutionItem ? currentExecutionLevel(displayItem) : null;
     const selectablePlanEntries = isPlanWorkbenchItem && Array.isArray(item.planEntries) ? item.planEntries : [];
-    const relatedPlans = isPlanWorkbenchItem && selectablePlanEntries.length === 0 ? buildRelatedPlanReferences(item) : [];
+    const allRelatedPlans = isPlanWorkbenchItem ? buildRelatedPlanReferences(item) : [];
+    const relatedPlans = selectablePlanEntries.length === 0 ? allRelatedPlans : allRelatedPlans.filter(reference => reference.kind === 'consumable');
     return _react.default.createElement(_react.default.Fragment, null, _react.default.createElement("div", {
       className: "decision-detail-dock is-open"
     }, _react.default.createElement("aside", {

package/views/shared/plugin-resource-paths.js

@@ -1,7 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
-exports.getPluginStatePaths = exports.getPluginBackupDirectory = exports.getPluginStateDirectory = exports.getPluginDataDirectory = exports.resolvePoiAppDataPath = void 0;
+exports.getPluginStatePaths = exports.getStartupSnapshotPath = exports.getStartupSnapshotDirectory = exports.getPluginBackupDirectory = exports.getPluginStateDirectory = exports.getPluginDataDirectory = exports.resolvePoiAppDataPath = void 0;
 
 var _os = _interopRequireDefault(require("os"));
 
@@ -45,6 +45,14 @@ const getPluginBackupDirectory = () => _path.default.join(getPluginDataDirectory
 
 exports.getPluginBackupDirectory = getPluginBackupDirectory;
 
+const getStartupSnapshotDirectory = () => _path.default.join(getPluginDataDirectory(), 'startup-snapshot');
+
+exports.getStartupSnapshotDirectory = getStartupSnapshotDirectory;
+
+const getStartupSnapshotPath = () => _path.default.join(getStartupSnapshotDirectory(), 'current.bin');
+
+exports.getStartupSnapshotPath = getStartupSnapshotPath;
+
 const getPluginStatePaths = () => {
   const base = getPluginStateDirectory();
   return {

package/views/shared/plugin-state-commands.js

@@ -3,8 +3,6 @@
 exports.__esModule = true;
 exports.commitDecisionSnapshotRuntimeState = exports.commitCurrentPlanRuntimeState = exports.finalizeLegacyAssignmentRecoveryFromSnapshot = exports.runPendingLegacyAssignmentRecovery = void 0;
 
-var _kcraTrace__ = require("./__kcra-trace__");
-
 var _pluginStateStorage = require("./plugin-state-storage");
 
 var _currentStartSelectionDomain = require("../new-interface/plan/domain/current-start-selection-domain");
@@ -33,15 +31,6 @@ const runPendingLegacyAssignmentRecovery = ({
     };
   }
 
-  (0, _kcraTrace__.__KCRA_TRACE__)('recovery.pending.input', {
-    stateRevision: Number(snapshot.revision) || 0,
-    routeSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(snapshot),
-    assignments: (0, _pluginStateSchema.getStatePlanEquipmentAssignments)(snapshot),
-    recovery: snapshot.migration && snapshot.migration.assignmentRecovery,
-    equipInventory
-  }, {
-    full: true
-  });
   const result = (0, _legacyAssignmentRecovery.recoverLegacyAssignmentState)({
     plans: snapshot.user && snapshot.user.plans || {},
     currentRouteSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(snapshot),
@@ -53,13 +42,6 @@ const runPendingLegacyAssignmentRecovery = ({
     state: snapshot,
     audit: result.audit
   };
-  (0, _kcraTrace__.__KCRA_TRACE__)('recovery.pending.candidate', {
-    routeSelections: result.routeSelections,
-    assignments: result.assignments,
-    audit: result.audit
-  }, {
-    full: true
-  });
   const state = (0, _pluginStateStorage.mutatePluginState)(draft => {
     (0, _pluginStateSchema.setStateCurrentStartSelections)(draft, result.routeSelections);
     (0, _pluginStateSchema.setStatePlanEquipmentAssignments)(draft, result.assignments);
@@ -68,14 +50,6 @@ const runPendingLegacyAssignmentRecovery = ({
     const cleanup = draft.migration.assignmentCleanup;
     if (cleanup) (0, _pluginStateSchema.setStatePendingRebindCurrentIds)(draft, []);
   });
-  (0, _kcraTrace__.__KCRA_TRACE__)('recovery.pending.persisted', {
-    stateRevision: Number(state.revision) || 0,
-    routeSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(state),
-    assignments: (0, _pluginStateSchema.getStatePlanEquipmentAssignments)(state),
-    audit: state.migration && state.migration.assignmentRecovery
-  }, {
-    full: true
-  });
   return {
     changed: true,
     state,
@@ -101,14 +75,6 @@ const finalizeLegacyAssignmentRecoveryFromSnapshot = ({
     };
   }
 
-  (0, _kcraTrace__.__KCRA_TRACE__)('recovery.validation.input', {
-    stateRevision: Number(state.revision) || 0,
-    recovery,
-    assignmentBindingTransitions: snapshot && snapshot.assignmentBindingTransitions || [],
-    assignmentFindings: snapshot && snapshot.assignmentFindings || []
-  }, {
-    full: true
-  });
   const protectedIds = new Set((recovery.protectedLegacyRouteCurrentIds || []).map(value => String(value || '').trim()).filter(Boolean));
   const invalidProtectedIds = Array.from(new Set((snapshot && snapshot.assignmentBindingTransitions || []).filter(transition => transition && transition.type === 'invalid-persisted-binding-released' && protectedIds.has(String(transition.currentId || '').trim())).map(transition => String(transition.currentId || '').trim()).filter(Boolean)));
 
@@ -130,14 +96,6 @@ const finalizeLegacyAssignmentRecoveryFromSnapshot = ({
         routeValidationFailedCurrentIds: invalidProtectedIds
       });
     });
-    (0, _kcraTrace__.__KCRA_TRACE__)('recovery.validation.degraded-and-retry', {
-      invalidProtectedIds,
-      routeSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(committed),
-      assignments: (0, _pluginStateSchema.getStatePlanEquipmentAssignments)(committed),
-      audit: committed.migration && committed.migration.assignmentRecovery
-    }, {
-      full: true
-    });
     return {
       changed: true,
       retry: true,
@@ -153,13 +111,6 @@ const finalizeLegacyAssignmentRecoveryFromSnapshot = ({
       routeValidationFailedCurrentIds: []
     });
   });
-  (0, _kcraTrace__.__KCRA_TRACE__)('recovery.validation.completed', {
-    routeSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(committed),
-    assignments: (0, _pluginStateSchema.getStatePlanEquipmentAssignments)(committed),
-    audit: committed.migration && committed.migration.assignmentRecovery
-  }, {
-    full: true
-  });
   return {
     changed: true,
     retry: false,
@@ -243,38 +194,15 @@ const commitDecisionSnapshotRuntimeState = ({
   const pendingChanged = Array.isArray(pendingRebind) && pendingRebind.length > 0;
 
   if (sameValue(nextSelections, currentSelections) && sameValue(nextAssignments, currentAssignments) && !pendingChanged) {
-    (0, _kcraTrace__.__KCRA_TRACE__)('state.binding-commit.noop', {
-      stateRevision: Number(snapshot.revision) || 0,
-      activeCurrentIds: Array.from(active),
-      assignments: currentAssignments
-    });
     return snapshot;
   }
 
-  (0, _kcraTrace__.__KCRA_TRACE__)('state.binding-commit.before', {
-    stateRevision: Number(snapshot.revision) || 0,
-    activeCurrentIds: Array.from(active),
-    currentAssignments,
-    proposedAssignments: nextAssignments,
-    currentSelections,
-    nextSelections,
-    pendingRebind
-  }, {
-    full: true
-  });
   const committed = (0, _pluginStateStorage.mutatePluginState)(state => {
     (0, _pluginStateSchema.setStateCurrentStartSelections)(state, nextSelections);
     (0, _pluginStateSchema.setStatePlanEquipmentAssignments)(state, nextAssignments);
     const stateCleanup = state.migration && state.migration.assignmentCleanup;
     if (stateCleanup && pendingChanged) (0, _pluginStateSchema.setStatePendingRebindCurrentIds)(state, []);
   });
-  (0, _kcraTrace__.__KCRA_TRACE__)('state.binding-commit.after', {
-    stateRevision: Number(committed.revision) || 0,
-    assignments: (0, _pluginStateSchema.getStatePlanEquipmentAssignments)(committed),
-    routeSelections: (0, _pluginStateSchema.getStateCurrentStartSelections)(committed)
-  }, {
-    full: true
-  });
   return committed;
 };