Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

2.2 KB
Raw Blame
/**
 * Branch-reconcile persists its last inventory (`remaining`) so the Schedule view
 * can offer per-row actions. Disappearance establishes missing source, never
 * preservation. Callers must retain it as an obligation without an exact receipt.
 */
import { readCheckoutPathPresence, readLocalBranchPresence } from './repoCleanupObservation.js';

// Rows that bind a retirement-receipt obligation are evidence, not display data.
export const isObligationRow = row => ['retirement-review-pending', 'retirement-receipt-unverified',
  'retirement-provenance-unverified'].includes(row?.reason);

/**
 * Stored inventory rows whose checkout (or, for a branch-only row, local branch)
 * is gone from the repository. A row whose branch survives but whose checkout is
 * gone still has unproven preservation; the next sweep lists the branch afresh.
 * Unreadable paths are not absent. Git read errors reject for the caller to retain.
 *
 * @param {string} repoPath
 * @param {object[]} rows
 * @param {{ includeObligations?: boolean }} [options] Include missing originals for display only; never prune these obligations.
 * @returns {Promise<object[]>}
 */
export async function findGoneInventoryRows(repoPath, rows, { includeObligations = false } = {}) {
  if (!Array.isArray(rows) || !rows.length) return [];
  const gone = [];
  for (const row of rows) {
    // A remote-only hold has no local ref by definition. Only a new forge scan
    // can establish that its remote preservation obligation is gone.
    if (row?.reason === 'remote-branch-held') continue;
    if (!includeObligations && (isObligationRow(row) || row?.reason === 'claim-reservation-owner-unverified')) continue;
    if (typeof row?.path === 'string' && row.path) {
      const present = await readCheckoutPathPresence(row.path);
      if (present === null) throw new Error('checkout-presence-unavailable');
      if (present === false) gone.push(row);
    } else if (typeof row?.branch === 'string' && row.branch) {
      const present = await readLocalBranchPresence(repoPath, row.branch);
      if (present === null) throw new Error('branch-presence-unavailable');
      if (present === false) gone.push(row);
    }
  }
  return gone;
}