akm-cli 0.9.8 → 0.9.9

package/dist/commands/migrate/config-extra-params.js

@@ -1,61 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Legacy `extraParams` -> first-class-field lift (#852, following #815), as
- * an `akm migrate` concern.
- *
- * This used to run silently, in memory, on every config load
- * (`liftLegacyEngineExtraParams` called from `parseAndValidateConfigText`)
- * and never wrote the result back — so the lift, and its warning, recurred
- * forever. config.json is akm-owned plain JSON; the lift is deterministic
- * and total, so — like the dead-residue cleanup in `./dead-residue.ts` —
- * it belongs in `akm migrate`, run once, persisted. `parseAndValidateConfigText`
- * now fails closed on an unmigrated config instead of lifting it.
- */
-import { acquireConfigLock, backupExistingConfig, parseConfigText, readConfigText, writeConfigAtomic, } from "../../core/config/config-io.js";
-import { liftLegacyEngineExtraParams } from "../../core/extra-params.js";
-function readRawConfig(configPath) {
-    const text = readConfigText(configPath);
-    if (text === undefined)
-        return undefined;
-    return parseConfigText(text, configPath);
-}
-/**
- * Read-only: what `akm migrate apply` would lift (or flag as conflicting) in
- * `config.json`'s `extraParams`. Never touches disk. Returns an empty plan
- * when the config file does not exist.
- */
-export function findConfigExtraParamsLift(configPath) {
-    const raw = readRawConfig(configPath);
-    if (!raw)
-        return { lifted: [], conflicts: [] };
-    const { lifted, conflicts } = liftLegacyEngineExtraParams(raw);
-    return { lifted, conflicts };
-}
-/**
- * Persist the legacy extraParams -> first-class field lift to `config.json`,
- * once. Best-effort like `removeDeadResidue`: a genuine conflict (extraParams
- * and the first-class field set to different values) is left untouched here
- * — `parseAndValidateConfigText` already hard-rejects that config at every
- * load with the exact mismatch, so a second, weaker error here would only be
- * noise — and is reported back via `conflicts` instead.
- */
-export function applyConfigExtraParamsLift(configPath) {
-    const raw = readRawConfig(configPath);
-    if (!raw)
-        return { applied: false, lifted: [], conflicts: [] };
-    const { config, lifted, conflicts } = liftLegacyEngineExtraParams(raw);
-    if (conflicts.length > 0 || lifted.length === 0) {
-        return { applied: false, lifted, conflicts };
-    }
-    const release = acquireConfigLock();
-    try {
-        backupExistingConfig(configPath);
-        writeConfigAtomic(configPath, config);
-    }
-    finally {
-        release();
-    }
-    return { applied: true, lifted, conflicts: [] };
-}

package/dist/commands/migrate/dead-residue.js

@@ -1,113 +0,0 @@
-/**
- * Dead pre-0.9.0 `$STASH/.akm` residue: superseded filesystem layouts with no
- * live reader or writer anywhere in src/ (each verified by grep before being
- * listed — see #889 for the audit). The largest, `.akm/proposals/`, was
- * replaced by the `proposals` table in state.db in 0.9.0 and measured 135 MB
- * on a real bundle.
- *
- * This lives under `migrate/` because removing a superseded layout IS
- * migration — the tail end of the moves that created these paths' replacements.
- * It was first shipped as a bolted-on `akm health --clean-dead-residue` flag
- * plus a health advisory; that was the wrong shape (a special-purpose switch
- * apologizing for migrations that did not finish their own job) and was
- * removed. `akm migrate status` reports what is here; `akm migrate apply`
- * removes it, exactly as it applies every other pending migration.
- */
-import fs from "node:fs";
-import path from "node:path";
-const DEAD_RESIDUE_PATHS = [
-    { name: "proposals", reason: "superseded by the `proposals` table in $DATA/state.db (0.9.0)" },
-    { prefix: "runs.archived-", reason: "orphaned archive of a directory that no longer exists" },
-    {
-        name: "archive",
-        reason: "legacy consolidation archive; current prune writes .akm/memory-cleanup/archive/ instead",
-    },
-    { name: "graph.json", reason: "superseded by the graph_* tables in $DATA/index.db" },
-    { name: "consolidate-journal.json", reason: "legacy consolidation journal; unused" },
-    { name: "proposals.db", reason: "empty legacy database file" },
-    { name: "mv-transactions", reason: "legacy fs-txn journal location; unused" },
-];
-function dirSizeBytes(target) {
-    let total = 0;
-    let entries;
-    try {
-        entries = fs.readdirSync(target, { withFileTypes: true });
-    }
-    catch {
-        return 0;
-    }
-    for (const entry of entries) {
-        const entryPath = path.join(target, entry.name);
-        if (entry.isDirectory()) {
-            total += dirSizeBytes(entryPath);
-        }
-        else if (entry.isFile()) {
-            try {
-                total += fs.statSync(entryPath).size;
-            }
-            catch {
-                // Skip files that vanish or are inaccessible between readdir and stat.
-            }
-        }
-    }
-    return total;
-}
-function sizeOf(target) {
-    const st = fs.statSync(target);
-    return st.isDirectory() ? dirSizeBytes(target) : st.size;
-}
-/**
- * Find every Tier-1 dead-residue path that actually exists under
- * `$STASH/.akm`, with its computed size. Read-only — never deletes.
- */
-export function findDeadResidueEntries(stashDir) {
-    const akmDir = path.join(stashDir, ".akm");
-    let names;
-    try {
-        names = fs.readdirSync(akmDir);
-    }
-    catch {
-        return [];
-    }
-    const found = [];
-    for (const spec of DEAD_RESIDUE_PATHS) {
-        const matches = spec.name !== undefined ? [spec.name] : names.filter((n) => n.startsWith(spec.prefix ?? "\0"));
-        for (const name of matches) {
-            if (!names.includes(name))
-                continue;
-            const absolutePath = path.join(akmDir, name);
-            let sizeBytes;
-            try {
-                sizeBytes = sizeOf(absolutePath);
-            }
-            catch {
-                continue; // vanished between readdir and stat
-            }
-            found.push({ relativePath: path.join(".akm", name), absolutePath, sizeBytes, reason: spec.reason });
-        }
-    }
-    return found;
-}
-/**
- * Delete every Tier-1 dead-residue path found under `$STASH/.akm`. Only
- * invoked when the caller has explicitly opted in (`akm health
- * --clean-dead-residue`) — never as a side effect of a plain `akm health`
- * read. Best-effort per-path: one failure does not abort the rest.
- */
-export function removeDeadResidue(stashDir) {
-    const entries = findDeadResidueEntries(stashDir);
-    return entries.map((entry) => {
-        try {
-            fs.rmSync(entry.absolutePath, { recursive: true, force: true });
-            return { relativePath: entry.relativePath, sizeBytes: entry.sizeBytes, removed: true };
-        }
-        catch (error) {
-            return {
-                relativePath: entry.relativePath,
-                sizeBytes: entry.sizeBytes,
-                removed: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    });
-}

package/dist/commands/migrate/stale-txn.js

@@ -1,49 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Stale durable-transaction journals (`$DATA/txn/<rootNs24>/<id>/journal.json`,
- * see `core/fs-txn.ts`) that never got recovered — a crash mid-transaction
- * left a journal on disk with no process left to finish or roll it back.
- * `akm health` used to only report these and point at a troubleshooting doc
- * (issue: an advisory that tells the user to go read docs instead of the
- * tool recovering its own interrupted state). Recovery IS a migration
- * concern like dead `.akm/` residue: `akm migrate status` names what is
- * here for the stash root, `akm migrate apply` recovers it, exactly like
- * `dead-residue.ts`.
- *
- * Recovery goes through {@link recoverTxnsForRoot}, which requires every
- * live kind's registrar to be IMPORTED first so its handler is registered
- * (see fs-txn.ts's module docs). `proposal/repository.ts` registers the
- * `proposal`/`proposal-reject` kinds specifically so "ANY recovery entry
- * point ... can finish or roll back an interrupted proposal mutation for a
- * root it touches" (its own comment on the registration) — this module is
- * exactly that kind of entry point.
- */
-import { canonicalTxnRoot, listTxnJournalsTolerant, recoverTxnsForRoot } from "../../core/fs-txn.js";
-// Side-effect import: registers the `proposal`/`proposal-reject` txn kinds
-// so recovery below can roll them forward/back for the stash root.
-import "../proposal/repository.js";
-/**
- * Find every durable-transaction journal bound to `stashDir`'s namespace.
- * Read-only, tolerant of a corrupt journal (counted, not thrown on) — mirrors
- * `findDeadResidueEntries`'s read-only/never-mutates contract.
- */
-export function findStaleTxnEntries(stashDir) {
-    const root = canonicalTxnRoot(stashDir);
-    const { matches } = listTxnJournalsTolerant((j) => canonicalTxnRoot(j.root) === root);
-    return matches.map(({ journal }) => journalToEntry(journal));
-}
-function journalToEntry(journal) {
-    return { transactionId: journal.transactionId, kind: journal.kind, phase: journal.phase, root: journal.root };
-}
-/**
- * Recover every durable transaction bound to `stashDir`'s namespace: roll
- * back journals before their kind's commit point, roll forward the rest.
- * The counterpart to {@link findStaleTxnEntries}, invoked only from `akm
- * migrate apply`.
- */
-export async function recoverStaleTxns(stashDir) {
-    const recovered = await recoverTxnsForRoot(stashDir);
-    return recovered.map(journalToEntry);
-}