@adhdev/mesh-shared 0.9.82-rc.267

package/dist/index.mjs

@@ -0,0 +1,260 @@
+// src/json.ts
+function readRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function readString(...values) {
+  for (const value of values) {
+    if (typeof value !== "string") continue;
+    const trimmed = value.trim();
+    if (trimmed) return trimmed;
+  }
+  return void 0;
+}
+function readNumber(...values) {
+  for (const value of values) {
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+  }
+  return void 0;
+}
+function readBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
+function readStringArray(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [];
+}
+function joinRepoPath(root, relativePath) {
+  const normalizedRoot = typeof root === "string" ? root.trim().replace(/[\\/]+$/, "") : "";
+  const normalizedPath = typeof relativePath === "string" ? relativePath.trim() : "";
+  if (!normalizedPath) return void 0;
+  if (/^(?:[A-Za-z]:[\\/]|\/)/.test(normalizedPath)) return normalizedPath;
+  if (!normalizedRoot) return void 0;
+  return `${normalizedRoot}/${normalizedPath.replace(/^[\\/]+/, "")}`;
+}
+
+// src/git-normalize.ts
+function scoreGitUpstreamFreshness(status) {
+  switch (status) {
+    case "fresh":
+      return 30;
+    case "no_upstream":
+      return 4;
+    case "unchecked":
+    case void 0:
+      return 0;
+    case "stale":
+      return -10;
+    case "unavailable":
+      return -15;
+    default:
+      return 0;
+  }
+}
+function readGitSubmodules(value, parentRepoRoot) {
+  if (!Array.isArray(value)) return void 0;
+  const submodules = value.map((entry) => {
+    const submodule = readRecord(entry);
+    const path = readString(submodule.path);
+    const commit = readString(submodule.commit);
+    const repoPath = readString(submodule.repoPath, submodule.repo_root) ?? joinRepoPath(parentRepoRoot, path);
+    if (!path || !commit) return null;
+    const result = {
+      path,
+      commit,
+      dirty: readBoolean(submodule.dirty) ?? false,
+      outOfSync: readBoolean(submodule.outOfSync, submodule.out_of_sync) ?? false,
+      lastCheckedAt: readNumber(submodule.lastCheckedAt, submodule.last_checked_at) ?? Date.now()
+    };
+    if (repoPath) result.repoPath = repoPath;
+    const error = readString(submodule.error);
+    if (error) result.error = error;
+    return result;
+  }).filter((entry) => entry !== null);
+  return submodules.length > 0 ? submodules : void 0;
+}
+function hasGitStatusEvidence(status) {
+  return readBoolean(status.isGitRepo) !== void 0 || Boolean(readString(status.branch, status.upstream, status.upstreamStatus, status.upstream_status, status.headCommit)) || Boolean(readString(status.repoRoot, status.repo_root, status.workspace)) || readNumber(
+    status.ahead,
+    status.behind,
+    status.staged,
+    status.modified,
+    status.untracked,
+    status.deleted,
+    status.renamed,
+    status.lastCheckedAt,
+    status.last_checked_at
+  ) !== void 0 || Array.isArray(status.submodules) && status.submodules.length > 0;
+}
+function normalizeGitStatus(status, node, options) {
+  const explicitIsGitRepo = readBoolean(status.isGitRepo);
+  if (!Object.keys(status).length || !hasGitStatusEvidence(status)) return void 0;
+  const isGitRepo = explicitIsGitRepo ?? true;
+  const conflictFiles = Array.isArray(status.conflictFiles) ? status.conflictFiles.filter((entry) => typeof entry === "string") : [];
+  const conflictCount = readNumber(status.conflicts) ?? conflictFiles.length;
+  const hasConflicts = readBoolean(status.hasConflicts) ?? conflictCount > 0;
+  const repoRoot = readString(status.repoRoot, status.repo_root, node.repoRoot, node.repo_root, status.workspace, node.workspace) || void 0;
+  const submodules = readGitSubmodules(status.submodules, repoRoot);
+  const upstreamStatus = readString(status.upstreamStatus, status.upstream_status);
+  const upstreamFetchedAt = readNumber(status.upstreamFetchedAt, status.upstream_fetched_at);
+  const upstreamFetchError = readString(status.upstreamFetchError, status.upstream_fetch_error);
+  const error = readString(status.error);
+  const staged = readNumber(status.staged) ?? 0;
+  const modified = readNumber(status.modified) ?? 0;
+  const untracked = readNumber(status.untracked) ?? 0;
+  const deleted = readNumber(status.deleted) ?? 0;
+  const renamed = readNumber(status.renamed) ?? 0;
+  return {
+    workspace: readString(status.workspace, node.workspace) || "",
+    repoRoot: repoRoot ?? null,
+    isGitRepo,
+    branch: readString(status.branch) ?? null,
+    headCommit: readString(status.headCommit) ?? null,
+    headMessage: readString(status.headMessage) ?? null,
+    upstream: readString(status.upstream) ?? null,
+    upstreamStatus: upstreamStatus ?? "unchecked",
+    ...upstreamFetchedAt !== void 0 ? { upstreamFetchedAt } : {},
+    ...upstreamFetchError ? { upstreamFetchError } : {},
+    ahead: readNumber(status.ahead) ?? 0,
+    behind: readNumber(status.behind) ?? 0,
+    staged,
+    modified,
+    untracked,
+    deleted,
+    renamed,
+    dirty: readBoolean(status.dirty, status.isDirty, status.is_dirty) ?? (staged + modified + untracked + deleted + renamed > 0 || hasConflicts),
+    hasConflicts,
+    conflictFiles,
+    stashCount: readNumber(status.stashCount, status.stash_count) ?? 0,
+    lastCheckedAt: options?.lastCheckedAt ?? readNumber(status.lastCheckedAt, status.last_checked_at) ?? Date.now(),
+    ...submodules ? { submodules } : {},
+    ...error ? { error } : {}
+  };
+}
+function scoreGitStatusCandidate(git) {
+  if (!git) return Number.NEGATIVE_INFINITY;
+  let score = 0;
+  if (git.isGitRepo === true) score += 50;
+  if (git.isGitRepo === false) score -= 10;
+  if (git.branch) score += 20;
+  if (git.headCommit) score += 20;
+  if (git.upstream) score += 10;
+  score += scoreGitUpstreamFreshness(git.upstreamStatus);
+  if (typeof git.ahead === "number") score += 2;
+  if (typeof git.behind === "number") score += 2;
+  if (Array.isArray(git.submodules) && git.submodules.length > 0) score += 4 + git.submodules.length;
+  if (git.error) score -= 20;
+  return score;
+}
+function pickBestTransitGitStatus(node, options) {
+  const rawGit = readRecord(node.lastGit ?? node.last_git);
+  const gitResult = readRecord(rawGit.result);
+  const directStatus = readRecord(rawGit.status);
+  const nestedStatus = readRecord(gitResult.status);
+  const rawProbe = readRecord(node.lastProbe ?? node.last_probe);
+  const probeGit = readRecord(rawProbe.git);
+  const probeGitResult = readRecord(probeGit.result);
+  const probeDirectStatus = readRecord(probeGit.status);
+  const probeNestedStatus = readRecord(probeGitResult.status);
+  const lastCheckedAt = options?.lastCheckedAt;
+  let best = null;
+  for (const status of [directStatus, nestedStatus, probeDirectStatus, probeNestedStatus]) {
+    const normalized = normalizeGitStatus(status, node, { lastCheckedAt: lastCheckedAt ?? Date.now() });
+    if (!normalized) continue;
+    const score = scoreGitStatusCandidate(normalized);
+    if (!best || score > best.score) best = { git: normalized, score };
+  }
+  return best?.git;
+}
+
+// src/session-normalize.ts
+function deriveSyntheticSessionId(record) {
+  const parts = [
+    readString(record.workspace),
+    readString(record.providerType, record.provider),
+    readString(record.role),
+    readString(record.state, record.status),
+    readString(record.title),
+    readString(record.createdAt, record.created_at),
+    readString(record.startedAt, record.started_at)
+  ].filter((part) => Boolean(part));
+  if (parts.length === 0) return void 0;
+  return `synthetic:${parts.join("|")}`;
+}
+function normalizeMeshSessionRecord(entry) {
+  const record = readRecord(entry);
+  const sessionId = readString(record.sessionId, record.session_id, record.id) ?? deriveSyntheticSessionId(record);
+  if (!sessionId) return null;
+  return {
+    sessionId,
+    ...readString(record.providerType, record.provider) ? { providerType: readString(record.providerType, record.provider) } : {},
+    ...readString(record.state, record.status) ? { state: readString(record.state, record.status) } : {},
+    ...readString(record.chatStatus, record.chat_status) ? { chatStatus: readString(record.chatStatus, record.chat_status) } : {},
+    ...readString(record.lifecycle) ? { lifecycle: readString(record.lifecycle) } : {},
+    ...readString(record.surfaceKind, record.surface_kind) ? { surfaceKind: readString(record.surfaceKind, record.surface_kind) } : {},
+    ...readString(record.recoveryState, record.recovery_state) ? { recoveryState: readString(record.recoveryState, record.recovery_state) } : {},
+    ...readString(record.workspace) ? { workspace: readString(record.workspace) } : {},
+    ...readString(record.title) ? { title: readString(record.title) } : {},
+    ...readString(record.role) ? { role: readString(record.role) } : {},
+    ...readBoolean(record.isSelfCoordinator, record.is_self_coordinator) !== void 0 ? { isSelfCoordinator: readBoolean(record.isSelfCoordinator, record.is_self_coordinator) } : {},
+    ...readString(record.statusNote, record.status_note) ? { statusNote: readString(record.statusNote, record.status_note) } : {},
+    ...readString(record.createdAt, record.created_at) ? { createdAt: readString(record.createdAt, record.created_at) } : {},
+    ...readString(record.startedAt, record.started_at) ? { startedAt: readString(record.startedAt, record.started_at) } : {},
+    ...readString(record.lastActivityAt, record.last_activity_at) ? { lastActivityAt: readString(record.lastActivityAt, record.last_activity_at) } : {},
+    ...readBoolean(record.isCached, record.is_cached) !== void 0 ? { isCached: readBoolean(record.isCached, record.is_cached) } : {}
+  };
+}
+
+// src/git-summarize.ts
+function summarizeGitShape(status) {
+  const record = readRecord(status);
+  if (!Object.keys(record).length) return null;
+  const submodules = Array.isArray(record.submodules) ? record.submodules.map((entry) => {
+    const sub = readRecord(entry);
+    return {
+      path: readString(sub.path) ?? null,
+      commit: readString(sub.commit)?.slice(0, 12) ?? null,
+      dirty: readBoolean(sub.dirty) ?? false,
+      outOfSync: readBoolean(sub.outOfSync, sub.out_of_sync) ?? false
+    };
+  }) : [];
+  return {
+    isGitRepo: readBoolean(record.isGitRepo),
+    workspace: readString(record.workspace) ?? null,
+    repoRoot: readString(record.repoRoot, record.repo_root) ?? null,
+    branch: readString(record.branch) ?? null,
+    upstream: readString(record.upstream) ?? null,
+    upstreamStatus: readString(record.upstreamStatus, record.upstream_status) ?? null,
+    headCommit: readString(record.headCommit, record.head_commit)?.slice(0, 12) ?? null,
+    ahead: readNumber(record.ahead) ?? null,
+    behind: readNumber(record.behind) ?? null,
+    dirtyCounts: {
+      staged: readNumber(record.staged) ?? 0,
+      modified: readNumber(record.modified) ?? 0,
+      untracked: readNumber(record.untracked) ?? 0,
+      deleted: readNumber(record.deleted) ?? 0,
+      renamed: readNumber(record.renamed) ?? 0
+    },
+    lastCheckedAt: readNumber(record.lastCheckedAt, record.last_checked_at) ?? null,
+    submoduleCount: submodules.length,
+    submodules
+  };
+}
+export {
+  hasGitStatusEvidence,
+  joinRepoPath,
+  normalizeGitStatus,
+  normalizeMeshSessionRecord,
+  pickBestTransitGitStatus,
+  readBoolean,
+  readGitSubmodules,
+  readNumber,
+  readRecord,
+  readString,
+  readStringArray,
+  scoreGitStatusCandidate,
+  scoreGitUpstreamFreshness,
+  summarizeGitShape
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json.ts","../src/git-normalize.ts","../src/session-normalize.ts","../src/git-summarize.ts"],"sourcesContent":["/**\n * Pure JSON-record reading primitives shared by the cloud (web-core / P2P transit)\n * and standalone (daemon-core / local IPC) mesh normalizers.\n *\n * These operate only on plain JS values — no Node/DOM APIs, no transport, no git\n * exec — so both cores can import them without violating the core↔core dependency\n * ban. They are the single source of truth for the field-coercion rules that the\n * two transports previously hand-synced (and drifted on).\n */\n\nexport type JsonRecord = Record<string, unknown>\n\nexport function readRecord(value: unknown): JsonRecord {\n    return value && typeof value === 'object' && !Array.isArray(value) ? value as JsonRecord : {}\n}\n\nexport function readString(...values: unknown[]): string | undefined {\n    for (const value of values) {\n        if (typeof value !== 'string') continue\n        const trimmed = value.trim()\n        if (trimmed) return trimmed\n    }\n    return undefined\n}\n\nexport function readNumber(...values: unknown[]): number | undefined {\n    for (const value of values) {\n        if (typeof value === 'number' && Number.isFinite(value)) return value\n    }\n    return undefined\n}\n\nexport function readBoolean(...values: unknown[]): boolean | undefined {\n    for (const value of values) {\n        if (typeof value === 'boolean') return value\n    }\n    return undefined\n}\n\nexport function readStringArray(value: unknown): string[] {\n    return Array.isArray(value)\n        ? value.filter((entry): entry is string => typeof entry === 'string' && entry.trim().length > 0)\n        : []\n}\n\n/**\n * Join a (possibly absent) repo root with a relative submodule path. Returns the\n * path unchanged when it is already absolute, and undefined when nothing usable\n * can be derived — callers must treat the result as optional.\n */\nexport function joinRepoPath(root: string | undefined, relativePath: string | undefined): string | undefined {\n    const normalizedRoot = typeof root === 'string' ? root.trim().replace(/[\\\\/]+$/, '') : ''\n    const normalizedPath = typeof relativePath === 'string' ? relativePath.trim() : ''\n    if (!normalizedPath) return undefined\n    if (/^(?:[A-Za-z]:[\\\\/]|\\/)/.test(normalizedPath)) return normalizedPath\n    if (!normalizedRoot) return undefined\n    return `${normalizedRoot}/${normalizedPath.replace(/^[\\\\/]+/, '')}`\n}\n","/**\n * Canonical git-status normalizers shared by the cloud (web-core) and standalone\n * (daemon-core router) mesh paths. Previously each transport hand-maintained its\n * own copy and they drifted (e.g. submodule drop rules, evidence checks); this is\n * the one implementation both import.\n */\n\nimport { joinRepoPath, readBoolean, readNumber, readRecord, readString, type JsonRecord } from './json'\nimport type { GitRepoStatus, GitSubmoduleStatus, GitUpstreamFreshness } from './types'\n\nexport function scoreGitUpstreamFreshness(status: GitUpstreamFreshness | undefined): number {\n    switch (status) {\n        case 'fresh':\n            return 30\n        case 'no_upstream':\n            return 4\n        case 'unchecked':\n        case undefined:\n            return 0\n        case 'stale':\n            return -10\n        case 'unavailable':\n            return -15\n        default:\n            return 0\n    }\n}\n\nexport function readGitSubmodules(value: unknown, parentRepoRoot?: string): GitSubmoduleStatus[] | undefined {\n    if (!Array.isArray(value)) return undefined\n    const submodules = value\n        .map(entry => {\n            const submodule = readRecord(entry)\n            const path = readString(submodule.path)\n            const commit = readString(submodule.commit)\n            const repoPath = readString(submodule.repoPath, submodule.repo_root)\n                ?? joinRepoPath(parentRepoRoot, path)\n            // repoPath is only used for the submodule node's display workspace, which is\n            // allowed to be empty. The cloud P2P transit path can deliver submodule entries\n            // without repoPath (and a per-node git object without a derivable repoRoot), so\n            // dropping on missing repoPath would silently strip every submodule graph node.\n            // Keep any submodule that carries both path and commit.\n            if (!path || !commit) return null\n            const result: GitSubmoduleStatus = {\n                path,\n                commit,\n                dirty: readBoolean(submodule.dirty) ?? false,\n                outOfSync: readBoolean(submodule.outOfSync, submodule.out_of_sync) ?? false,\n                lastCheckedAt: readNumber(submodule.lastCheckedAt, submodule.last_checked_at) ?? Date.now(),\n            }\n            if (repoPath) result.repoPath = repoPath\n            const error = readString(submodule.error)\n            if (error) result.error = error\n            return result\n        })\n        .filter((entry): entry is GitSubmoduleStatus => entry !== null)\n    return submodules.length > 0 ? submodules : undefined\n}\n\nexport function hasGitStatusEvidence(status: JsonRecord): boolean {\n    // BUG FIX: a transit-reshaped git status that carries only a repoRoot/workspace\n    // (e.g. cloud P2P stripped the branch/upstream/counters but kept the path) must\n    // NOT be dropped — otherwise the node loses its git object and any submodules\n    // hanging off it. Treat a present repoRoot/repo_root/workspace as evidence too.\n    return readBoolean(status.isGitRepo) !== undefined\n        || Boolean(readString(status.branch, status.upstream, status.upstreamStatus, status.upstream_status, status.headCommit))\n        || Boolean(readString(status.repoRoot, status.repo_root, status.workspace))\n        || readNumber(\n            status.ahead,\n            status.behind,\n            status.staged,\n            status.modified,\n            status.untracked,\n            status.deleted,\n            status.renamed,\n            status.lastCheckedAt,\n            status.last_checked_at,\n        ) !== undefined\n        || (Array.isArray(status.submodules) && status.submodules.length > 0)\n}\n\nexport function normalizeGitStatus(\n    status: JsonRecord,\n    node: JsonRecord,\n    options?: { lastCheckedAt?: number },\n): GitRepoStatus | undefined {\n    const explicitIsGitRepo = readBoolean(status.isGitRepo)\n    if (!Object.keys(status).length || !hasGitStatusEvidence(status)) return undefined\n    const isGitRepo = explicitIsGitRepo ?? true\n    const conflictFiles = Array.isArray(status.conflictFiles)\n        ? status.conflictFiles.filter((entry): entry is string => typeof entry === 'string')\n        : []\n    const conflictCount = readNumber(status.conflicts) ?? conflictFiles.length\n    const hasConflicts = readBoolean(status.hasConflicts) ?? conflictCount > 0\n    // node.workspace is in the fallback chain so a transit node carrying its path only\n    // on the node (not the inner git object) still yields a parentRepoRoot for submodules.\n    const repoRoot = readString(status.repoRoot, status.repo_root, node.repoRoot, node.repo_root, status.workspace, node.workspace) || undefined\n    const submodules = readGitSubmodules(status.submodules, repoRoot)\n    const upstreamStatus = readString(status.upstreamStatus, status.upstream_status)\n    const upstreamFetchedAt = readNumber(status.upstreamFetchedAt, status.upstream_fetched_at)\n    const upstreamFetchError = readString(status.upstreamFetchError, status.upstream_fetch_error)\n    const error = readString(status.error)\n    const staged = readNumber(status.staged) ?? 0\n    const modified = readNumber(status.modified) ?? 0\n    const untracked = readNumber(status.untracked) ?? 0\n    const deleted = readNumber(status.deleted) ?? 0\n    const renamed = readNumber(status.renamed) ?? 0\n    return {\n        workspace: readString(status.workspace, node.workspace) || '',\n        repoRoot: repoRoot ?? null,\n        isGitRepo,\n        branch: readString(status.branch) ?? null,\n        headCommit: readString(status.headCommit) ?? null,\n        headMessage: readString(status.headMessage) ?? null,\n        upstream: readString(status.upstream) ?? null,\n        upstreamStatus: (upstreamStatus as GitUpstreamFreshness) ?? 'unchecked',\n        ...(upstreamFetchedAt !== undefined ? { upstreamFetchedAt } : {}),\n        ...(upstreamFetchError ? { upstreamFetchError } : {}),\n        ahead: readNumber(status.ahead) ?? 0,\n        behind: readNumber(status.behind) ?? 0,\n        staged,\n        modified,\n        untracked,\n        deleted,\n        renamed,\n        dirty: readBoolean(status.dirty, status.isDirty, status.is_dirty) ?? (staged + modified + untracked + deleted + renamed > 0 || hasConflicts),\n        hasConflicts,\n        conflictFiles,\n        stashCount: readNumber(status.stashCount, status.stash_count) ?? 0,\n        lastCheckedAt: options?.lastCheckedAt ?? readNumber(status.lastCheckedAt, status.last_checked_at) ?? Date.now(),\n        ...(submodules ? { submodules } : {}),\n        ...(error ? { error } : {}),\n    }\n}\n\nexport function scoreGitStatusCandidate(git: GitRepoStatus | undefined): number {\n    if (!git) return Number.NEGATIVE_INFINITY\n    let score = 0\n    if (git.isGitRepo === true) score += 50\n    if (git.isGitRepo === false) score -= 10\n    if (git.branch) score += 20\n    if (git.headCommit) score += 20\n    if (git.upstream) score += 10\n    score += scoreGitUpstreamFreshness(git.upstreamStatus)\n    if (typeof git.ahead === 'number') score += 2\n    if (typeof git.behind === 'number') score += 2\n    if (Array.isArray(git.submodules) && git.submodules.length > 0) score += 4 + git.submodules.length\n    if (git.error) score -= 20\n    return score\n}\n\n/**\n * Pick the best git status out of the four transit envelope slots a mesh node can\n * carry: lastGit.status, lastGit.result.status, lastProbe.git.status,\n * lastProbe.git.result.status. Returns undefined when none carry git evidence.\n */\nexport function pickBestTransitGitStatus(node: JsonRecord, options?: { lastCheckedAt?: number }): GitRepoStatus | undefined {\n    const rawGit = readRecord(node.lastGit ?? node.last_git)\n    const gitResult = readRecord(rawGit.result)\n    const directStatus = readRecord(rawGit.status)\n    const nestedStatus = readRecord(gitResult.status)\n    const rawProbe = readRecord(node.lastProbe ?? node.last_probe)\n    const probeGit = readRecord(rawProbe.git)\n    const probeGitResult = readRecord(probeGit.result)\n    const probeDirectStatus = readRecord(probeGit.status)\n    const probeNestedStatus = readRecord(probeGitResult.status)\n    const lastCheckedAt = options?.lastCheckedAt\n    let best: { git: GitRepoStatus; score: number } | null = null\n    for (const status of [directStatus, nestedStatus, probeDirectStatus, probeNestedStatus]) {\n        const normalized = normalizeGitStatus(status, node, { lastCheckedAt: lastCheckedAt ?? Date.now() })\n        if (!normalized) continue\n        const score = scoreGitStatusCandidate(normalized)\n        if (!best || score > best.score) best = { git: normalized, score }\n    }\n    return best?.git\n}\n","/**\n * Canonical mesh-session record normalizer shared by the cloud (web-core) mesh\n * paths. Parses an already-transit-shaped session record into a typed\n * RepoMeshSessionStatus.\n */\n\nimport { readBoolean, readRecord, readString } from './json'\nimport type { RepoMeshSessionStatus } from './types'\n\n/**\n * Build a deterministic synthetic session id from a record that has no explicit\n * id. Two transit refreshes of the same logical session produce the same id so\n * downstream dedupe stays stable across refreshes (a random id would create a new\n * node every poll). Derived from the stable identifying fields available on the\n * record; prefixed \"synthetic:\" so callers can tell it apart from a real id.\n */\nfunction deriveSyntheticSessionId(record: ReturnType<typeof readRecord>): string | undefined {\n    const parts = [\n        readString(record.workspace),\n        readString(record.providerType, record.provider),\n        readString(record.role),\n        readString(record.state, record.status),\n        readString(record.title),\n        readString(record.createdAt, record.created_at),\n        readString(record.startedAt, record.started_at),\n    ].filter((part): part is string => Boolean(part))\n    if (parts.length === 0) return undefined\n    return `synthetic:${parts.join('|')}`\n}\n\nexport function normalizeMeshSessionRecord(entry: unknown): RepoMeshSessionStatus | null {\n    const record = readRecord(entry)\n    // BUG FIX: cloud transit can reshape/strip the explicit id field. Fall back\n    // through sessionId → session_id → id, then to a DETERMINISTIC synthetic id\n    // derived from record content so the session survives the round trip instead\n    // of being dropped (and so dedupe stays stable across refreshes). Return null\n    // ONLY when the record carries no identifying fields at all.\n    const sessionId = readString(record.sessionId, record.session_id, record.id)\n        ?? deriveSyntheticSessionId(record)\n    if (!sessionId) return null\n    return {\n        sessionId,\n        ...(readString(record.providerType, record.provider) ? { providerType: readString(record.providerType, record.provider) } : {}),\n        ...(readString(record.state, record.status) ? { state: readString(record.state, record.status) } : {}),\n        ...(readString(record.chatStatus, record.chat_status) ? { chatStatus: readString(record.chatStatus, record.chat_status) } : {}),\n        ...(readString(record.lifecycle) ? { lifecycle: readString(record.lifecycle) as RepoMeshSessionStatus['lifecycle'] } : {}),\n        ...(readString(record.surfaceKind, record.surface_kind) ? { surfaceKind: readString(record.surfaceKind, record.surface_kind) as RepoMeshSessionStatus['surfaceKind'] } : {}),\n        ...(readString(record.recoveryState, record.recovery_state) ? { recoveryState: readString(record.recoveryState, record.recovery_state) } : {}),\n        ...(readString(record.workspace) ? { workspace: readString(record.workspace) } : {}),\n        ...(readString(record.title) ? { title: readString(record.title) } : {}),\n        ...(readString(record.role) ? { role: readString(record.role) } : {}),\n        ...(readBoolean(record.isSelfCoordinator, record.is_self_coordinator) !== undefined ? { isSelfCoordinator: readBoolean(record.isSelfCoordinator, record.is_self_coordinator) } : {}),\n        ...(readString(record.statusNote, record.status_note) ? { statusNote: readString(record.statusNote, record.status_note) } : {}),\n        ...(readString(record.createdAt, record.created_at) ? { createdAt: readString(record.createdAt, record.created_at) } : {}),\n        ...(readString(record.startedAt, record.started_at) ? { startedAt: readString(record.startedAt, record.started_at) } : {}),\n        ...(readString(record.lastActivityAt, record.last_activity_at) ? { lastActivityAt: readString(record.lastActivityAt, record.last_activity_at) } : {}),\n        ...(readBoolean(record.isCached, record.is_cached) !== undefined ? { isCached: readBoolean(record.isCached, record.is_cached) } : {}),\n    }\n}\n","/**\n * Canonical compact git-shape summarizer used by debug/log surfaces on both the\n * cloud (daemon-cloud mesh command summarizer) and standalone (daemon-core router\n * RepoMeshStatusDebug) paths. Produces a small, log-safe projection of a git\n * status record — commit SHAs are truncated to 12 chars.\n *\n * Transport-specific envelope unwrapping (result / result.status / top-level)\n * stays in the caller; this takes an already-unwrapped status record.\n */\n\nimport { readBoolean, readNumber, readRecord, readString } from './json'\n\nexport function summarizeGitShape(status: unknown): Record<string, unknown> | null {\n    const record = readRecord(status)\n    if (!Object.keys(record).length) return null\n    const submodules = Array.isArray(record.submodules)\n        ? record.submodules.map((entry: unknown) => {\n            const sub = readRecord(entry)\n            return {\n                path: readString(sub.path) ?? null,\n                commit: readString(sub.commit)?.slice(0, 12) ?? null,\n                dirty: readBoolean(sub.dirty) ?? false,\n                outOfSync: readBoolean(sub.outOfSync, sub.out_of_sync) ?? false,\n            }\n        })\n        : []\n    return {\n        isGitRepo: readBoolean(record.isGitRepo),\n        workspace: readString(record.workspace) ?? null,\n        repoRoot: readString(record.repoRoot, record.repo_root) ?? null,\n        branch: readString(record.branch) ?? null,\n        upstream: readString(record.upstream) ?? null,\n        upstreamStatus: readString(record.upstreamStatus, record.upstream_status) ?? null,\n        headCommit: readString(record.headCommit, record.head_commit)?.slice(0, 12) ?? null,\n        ahead: readNumber(record.ahead) ?? null,\n        behind: readNumber(record.behind) ?? null,\n        dirtyCounts: {\n            staged: readNumber(record.staged) ?? 0,\n            modified: readNumber(record.modified) ?? 0,\n            untracked: readNumber(record.untracked) ?? 0,\n            deleted: readNumber(record.deleted) ?? 0,\n            renamed: readNumber(record.renamed) ?? 0,\n        },\n        lastCheckedAt: readNumber(record.lastCheckedAt, record.last_checked_at) ?? null,\n        submoduleCount: submodules.length,\n        submodules,\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/json.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure JSON-record reading primitives shared by the cloud (web-core / P2P transit)
+ * and standalone (daemon-core / local IPC) mesh normalizers.
+ *
+ * These operate only on plain JS values — no Node/DOM APIs, no transport, no git
+ * exec — so both cores can import them without violating the core↔core dependency
+ * ban. They are the single source of truth for the field-coercion rules that the
+ * two transports previously hand-synced (and drifted on).
+ */
+export type JsonRecord = Record<string, unknown>;
+export declare function readRecord(value: unknown): JsonRecord;
+export declare function readString(...values: unknown[]): string | undefined;
+export declare function readNumber(...values: unknown[]): number | undefined;
+export declare function readBoolean(...values: unknown[]): boolean | undefined;
+export declare function readStringArray(value: unknown): string[];
+/**
+ * Join a (possibly absent) repo root with a relative submodule path. Returns the
+ * path unchanged when it is already absolute, and undefined when nothing usable
+ * can be derived — callers must treat the result as optional.
+ */
+export declare function joinRepoPath(root: string | undefined, relativePath: string | undefined): string | undefined;

package/dist/session-normalize.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical mesh-session record normalizer shared by the cloud (web-core) mesh
+ * paths. Parses an already-transit-shaped session record into a typed
+ * RepoMeshSessionStatus.
+ */
+import type { RepoMeshSessionStatus } from './types';
+export declare function normalizeMeshSessionRecord(entry: unknown): RepoMeshSessionStatus | null;

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Canonical pure-shape mesh/git status types.
+ *
+ * These are the single source of truth for the data shapes that cross the
+ * cloud (P2P/transit) and standalone (local IPC) boundaries. daemon-core and
+ * web-core re-export these so neither side can drift its own copy. Pure type
+ * declarations only — no runtime, no dependency on either core.
+ */
+export type GitUpstreamFreshness = 'fresh' | 'unchecked' | 'stale' | 'no_upstream' | 'unavailable';
+export type GitFailureReason = 'not_git_repo' | 'git_not_installed' | 'timeout' | 'path_outside_repo' | 'dirty_index_required' | 'conflict' | 'invalid_args' | 'nothing_to_commit' | 'git_command_failed';
+export interface GitRepoIdentity {
+    workspace: string;
+    repoRoot: string | null;
+    isGitRepo: boolean;
+}
+export interface GitSubmoduleStatus {
+    /** Submodule path relative to repo root */
+    path: string;
+    /** Current commit SHA the submodule is at */
+    commit: string;
+    /**
+     * Path to the submodule repo (absolute). Optional: cloud P2P transit can
+     * deliver submodule entries without a derivable repo path, and graph
+     * rendering only uses this for a display field that is allowed to be empty.
+     */
+    repoPath?: string;
+    /** Whether the submodule has uncommitted changes */
+    dirty: boolean;
+    /** Whether the submodule commit differs from what the parent repo expects */
+    outOfSync: boolean;
+    /** Last checked timestamp */
+    lastCheckedAt: number;
+    /** Error message if submodule status could not be read */
+    error?: string;
+}
+export interface DaemonBuildBehind {
+    /** Full build commit baked into the running daemon. */
+    buildCommit: string;
+    /** Short build commit. */
+    buildCommitShort: string;
+    /** HEAD commit the build commit is behind (repo or submodule). */
+    head: string;
+    /** Where the comparison matched: 'root' or the submodule path. */
+    scope: string;
+    /**
+     * Whether any package changed between buildCommit..HEAD affects the daemon
+     * runtime (daemon-core, standalone, session-host, terminal-mux, ghostty,
+     * mcp-server). When false, only web/render packages changed — the daemon does
+     * NOT need a rebuild/restart; only the web deploy is pending. Conservative:
+     * when the changed-package set can't be determined it defaults to true.
+     */
+    isDaemonAffecting: boolean;
+    /** Distinct package names changed between buildCommit..HEAD (best-effort). */
+    affectedPackages?: string[];
+    warning: string;
+}
+export interface GitRepoStatus extends GitRepoIdentity {
+    branch: string | null;
+    headCommit: string | null;
+    headMessage: string | null;
+    upstream: string | null;
+    /** Whether ahead/behind was verified against a freshly fetched upstream ref. */
+    upstreamStatus: GitUpstreamFreshness;
+    /** Timestamp for the fetch that refreshed upstream refs when upstreamStatus === 'fresh'. */
+    upstreamFetchedAt?: number;
+    /** Error from the last refresh attempt when upstreamStatus === 'stale'. */
+    upstreamFetchError?: string;
+    ahead: number;
+    behind: number;
+    staged: number;
+    modified: number;
+    untracked: number;
+    deleted: number;
+    renamed: number;
+    /** Aggregate dirty flag including root worktree changes, conflicts, stash, and submodule drift. */
+    dirty: boolean;
+    hasConflicts: boolean;
+    conflictFiles: string[];
+    stashCount: number;
+    lastCheckedAt: number;
+    /** Submodule statuses when auto-discover is enabled */
+    submodules?: GitSubmoduleStatus[];
+    /**
+     * Set when the running daemon's build commit is a STRICT ancestor of this
+     * repo's HEAD (or a submodule HEAD) — i.e. the live daemon predates committed
+     * code in this workspace and is awaiting a deploy/restart to catch up.
+     * Omitted entirely when no staleness is provable.
+     */
+    daemonBuildBehind?: DaemonBuildBehind;
+    error?: string;
+    reason?: GitFailureReason;
+}
+export interface RepoMeshSessionStatus {
+    sessionId: string;
+    providerType?: string;
+    state?: string;
+    chatStatus?: string;
+    lifecycle?: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted';
+    surfaceKind?: 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
+    recoveryState?: string | null;
+    workspace?: string | null;
+    title?: string | null;
+    role?: string | null;
+    isSelfCoordinator?: boolean;
+    statusNote?: string | null;
+    createdAt?: string | null;
+    startedAt?: string | null;
+    lastActivityAt?: string | null;
+    isCached?: boolean;
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@adhdev/mesh-shared",
+  "version": "0.9.82-rc.267",
+  "description": "ADHDev mesh-shared — pure mesh/git status normalizers shared by daemon-core and web-core",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup && npm run build:types",
+    "build:types": "tsc -p tsconfig.json --emitDeclarationOnly --declaration --declarationMap false",
+    "dev": "tsup --watch --no-clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "adhdev",
+    "mesh",
+    "git-status",
+    "normalizer"
+  ],
+  "author": "vilmire",
+  "license": "AGPL-3.0-or-later",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vilmire/adhdev.git",
+    "directory": "packages/mesh-shared"
+  },
+  "homepage": "https://github.com/vilmire/adhdev#readme"
+}