@getmikie/cli 1.1.97 → 1.1.99

package/bin/mikie.mjs

@@ -23,6 +23,7 @@ import {
   detectUpdateTopology,
   externalRecoveryInvocation,
   parseUpdateHandoff,
+  parseTrajectoryReconciliationReceipt,
   runUpdateTransaction,
 } from "../lib/update.mjs";
 
@@ -163,6 +164,19 @@ All commands execute the compiled Mikie native engine.`);
           throw new Error("candidate owned-adapter settlement failed");
         }
       },
+      reconcileTrajectoryStore: async (reconciliationBinary) => {
+        const reconciliation = await commands.run(
+          reconciliationBinary,
+          ["reconcile-trajectory-store-v2", "--json"],
+          { shell: false, capture: true },
+        );
+        if (reconciliation.code !== 0) {
+          throw new Error("trajectory-store reconciliation failed");
+        }
+        parseTrajectoryReconciliationReceipt(reconciliation.stdout, {
+          allowNotConfigured: true,
+        });
+      },
     });
     const result = await runUpdateTransaction({
       handoff,

package/lib/update.mjs

@@ -20,6 +20,7 @@ import { isDeepStrictEqual } from "node:util";
 const WRAPPER_PACKAGE = "@getmikie/cli";
 const HANDOFF_SCHEMA = "mikie.update-handoff.v1";
 const REPAIR_SCHEMA = "mikie.claude-hook-repair.v1";
+const TRAJECTORY_RECONCILIATION_SCHEMA = "mikie.trajectory-store-reconciliation.v1";
 const RERUN_COMMAND = "npx -y @getmikie/cli@latest update";
 const MAX_COMMAND_OUTPUT_BYTES = 1024 * 1024;
 const DEFAULT_COMMAND_TIMEOUT_MS = 30_000;
@@ -640,6 +641,30 @@ function parseRepairReceipt(stdout) {
   return { receipt, skipped };
 }
 
+export function parseTrajectoryReconciliationReceipt(stdout, { allowNotConfigured = false } = {}) {
+  let receipt;
+  try {
+    receipt = JSON.parse(stdout.trim());
+  } catch {
+    throw new Error("trajectory-store reconciliation returned invalid JSON");
+  }
+  const ready =
+    receipt?.status === "ready" &&
+    ["fresh", "migrated_v1"].includes(receipt.activation);
+  const notConfigured =
+    allowNotConfigured &&
+    receipt?.status === "not_configured" &&
+    receipt.activation === null;
+  if (
+    !hasExactKeys(receipt, ["schema_version", "status", "activation"]) ||
+    receipt.schema_version !== TRAJECTORY_RECONCILIATION_SCHEMA ||
+    (!ready && !notConfigured)
+  ) {
+    throw new Error("trajectory-store reconciliation returned an invalid receipt");
+  }
+  return receipt;
+}
+
 function recoveryCommand(currentVersion) {
   return `npm install --global ${WRAPPER_PACKAGE}@${currentVersion}`;
 }
@@ -715,7 +740,11 @@ export async function runUpdateTransaction({
         {
           shell: false,
           capture: true,
-          environment: { npm_config_prefix: stagingPrefix },
+          environment: {
+            npm_config_prefix: stagingPrefix,
+            MIKIE_UPDATE_CANDIDATE_STAGING: stagingPrefix,
+            MIKIE_UPDATE_CANDIDATE_TOKEN: snapshot.lease.token,
+          },
         },
       );
       if (stagedInstall.code !== 0) throw new Error("exact staged npm install failed");
@@ -784,6 +813,7 @@ export async function runUpdateTransaction({
       const settlementRequired = repairResult.receipt.action === "migrated";
       await files.decideCommit(snapshot, { settlementRequired });
       commitDecided = true;
+      await files.reconcileTrajectoryStore(snapshot);
       if (settlementRequired) {
         const settlement = await commands.run(candidate.binary, handoff.repair_command, {
           shell: false,
@@ -1231,6 +1261,7 @@ export function createFilesystemAdapter({
   processId = process.pid,
   isProcessAlive = processIsAlive,
   settleProviderRepair,
+  reconcileTrajectoryStore,
   activationBoundary,
 }) {
   const currentRoots = validateInstallationLayout(currentLayout);
@@ -1244,6 +1275,7 @@ export function createFilesystemAdapter({
     typeof transactionRoot !== "string" ||
     !path.isAbsolute(transactionRoot) ||
     (settleProviderRepair !== undefined && typeof settleProviderRepair !== "function") ||
+    (reconcileTrajectoryStore !== undefined && typeof reconcileTrajectoryStore !== "function") ||
     (activationBoundary !== undefined && typeof activationBoundary !== "function")
   ) {
     throw new Error("unsafe Mikie update filesystem path");
@@ -2203,6 +2235,10 @@ export function createFilesystemAdapter({
     }
     const snapshot = await hydrateJournal(lease, expectedJournalToken);
     if (snapshot.phase === "commit_decided") {
+      if (!reconcileTrajectoryStore) {
+        throw new Error("trajectory-store reconciliation is unavailable");
+      }
+      await reconcileTrajectoryStore(snapshot.preparedCandidate.finalLauncher, snapshot);
       if (!settleProviderRepair) {
         throw new Error("candidate owned-adapter settlement is unavailable");
       }
@@ -2214,6 +2250,10 @@ export function createFilesystemAdapter({
       return;
     }
     if (snapshot.phase === "commit_decided_no_repair") {
+      if (!reconcileTrajectoryStore) {
+        throw new Error("trajectory-store reconciliation is unavailable");
+      }
+      await reconcileTrajectoryStore(snapshot.preparedCandidate.finalLauncher, snapshot);
       snapshot.phase = "committed";
       await writeJournal(snapshot);
       await cleanupCommittedActivation(snapshot);
@@ -2713,6 +2753,13 @@ export function createFilesystemAdapter({
       snapshot.phase = settlementRequired ? "commit_decided" : "commit_decided_no_repair";
       await writeJournal(snapshot);
     },
+    async reconcileTrajectoryStore(snapshot) {
+      const binary = snapshot?.preparedCandidate?.finalLauncher;
+      if (!reconcileTrajectoryStore || typeof binary !== "string" || !path.isAbsolute(binary)) {
+        throw new Error("trajectory-store reconciliation is unavailable");
+      }
+      await reconcileTrajectoryStore(binary, snapshot);
+    },
     async locateCandidate(request) {
       const candidate = await locateCandidate(request);
       const candidateRoots = validateInstallationLayout(candidate);
@@ -2938,6 +2985,17 @@ export async function recoverExternalNpmUpdate(transactionRoot, expectedAuthorit
         throw new Error("candidate owned-adapter settlement failed");
       }
     },
+    reconcileTrajectoryStore: async (binary) => {
+      const result = await commands.run(
+        binary,
+        ["reconcile-trajectory-store-v2", "--json"],
+        { shell: false, capture: true },
+      );
+      if (result.code !== 0) {
+        throw new Error("trajectory-store reconciliation failed");
+      }
+      parseTrajectoryReconciliationReceipt(result.stdout, { allowNotConfigured: true });
+    },
   });
   const lease = await files.beginTransaction();
   await files.endTransaction(lease);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmikie/cli",
-  "version": "1.1.97",
+  "version": "1.1.99",
   "description": "Native Mikie relay launcher for MCP clients",
   "license": "Apache-2.0",
   "repository": {
@@ -11,19 +11,23 @@
   "bin": {
     "mikie": "bin/mikie.mjs"
   },
+  "scripts": {
+    "postinstall": "node ./scripts/reconcile-install.mjs"
+  },
   "files": [
     "bin",
     "lib",
+    "scripts",
     "README.md"
   ],
   "engines": {
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@getmikie/darwin-arm64": "1.1.97",
-    "@getmikie/darwin-x64": "1.1.97",
-    "@getmikie/linux-x64-gnu": "1.1.97",
-    "@getmikie/win32-x64": "1.1.97"
+    "@getmikie/darwin-arm64": "1.1.99",
+    "@getmikie/darwin-x64": "1.1.99",
+    "@getmikie/linux-x64-gnu": "1.1.99",
+    "@getmikie/win32-x64": "1.1.99"
   },
   "publishConfig": {
     "access": "public",

package/scripts/reconcile-install.mjs

@@ -0,0 +1,59 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { resolveNativeBinary } from "../lib/launcher.mjs";
+import {
+  createCommandAdapter,
+  parseTrajectoryReconciliationReceipt,
+} from "../lib/update.mjs";
+
+const RECONCILIATION_ARGUMENTS = ["reconcile-trajectory-store-v2", "--json"];
+const TRANSACTION_TOKEN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+function pathIdentity(value, platform) {
+  const pathApi = platform === "win32" ? path.win32 : path.posix;
+  if (typeof value !== "string" || !pathApi.isAbsolute(value)) return null;
+  const identity = pathApi.normalize(pathApi.resolve(value));
+  return platform === "win32" ? identity.toLowerCase() : identity;
+}
+
+export function isTransactionStagedInstall(
+  environment = process.env,
+  platform = process.platform,
+) {
+  const marker = pathIdentity(environment.MIKIE_UPDATE_CANDIDATE_STAGING, platform);
+  const npmPrefix = pathIdentity(environment.npm_config_prefix, platform);
+  return (
+    marker !== null &&
+    marker === npmPrefix &&
+    TRANSACTION_TOKEN.test(environment.MIKIE_UPDATE_CANDIDATE_TOKEN ?? "")
+  );
+}
+
+export async function reconcileInstalledTrajectory({
+  environment = process.env,
+  platform = process.platform,
+  resolveBinary = resolveNativeBinary,
+  commands = createCommandAdapter({ environment, platform }),
+} = {}) {
+  if (isTransactionStagedInstall(environment, platform)) {
+    return { status: "staged_candidate" };
+  }
+  const binary = await resolveBinary();
+  const result = await commands.run(binary, RECONCILIATION_ARGUMENTS, { shell: false });
+  if (result.code !== 0) {
+    throw new Error("native trajectory-store reconciliation failed");
+  }
+  return parseTrajectoryReconciliationReceipt(result.stdout, { allowNotConfigured: true });
+}
+
+const scriptIdentity = pathIdentity(fileURLToPath(import.meta.url), process.platform);
+const invokedIdentity = pathIdentity(process.argv[1], process.platform);
+if (scriptIdentity !== null && scriptIdentity === invokedIdentity) {
+  try {
+    await reconcileInstalledTrajectory();
+  } catch (error) {
+    console.error(`Mikie install reconciliation failed: ${error.message}`);
+    process.exitCode = 1;
+  }
+}