mulmoterminal 8.5.0 → 8.6.0

package/README.md

@@ -1763,6 +1763,18 @@ narrow and tall for one record you are discussing — and each position keeps it
   bring, and a warning listing the files that can run code. Nothing is installed from the viewer —
   it shows the `npx skills add …` line to copy and run yourself. Your search words go to skills.sh
   only when you press **Search**.
+- **Processes** — **More features** → **Processes** shows what mulmoterminal has left running.
+  The **Processes** tab lists each tmux session with the process tree under its panes — `yarn dev`,
+  vite, MCP bridges, the agent itself — with CPU, memory and how long each has run, and an **End**
+  button per process (SIGTERM, then SIGKILL if the same process is still there a few seconds later).
+  A session's own shell is not offered: close its terminal in the grid, or end a session that is
+  open nowhere from Settings > Sessions. Busy and day-old
+  processes are highlighted, never ended for you. It reads only while the page is open. The
+  **Worktrees** tab lists the managed worktrees of the folders your terminals have run in and what
+  keeps each from going — uncommitted or untracked files, commits not in the base branch, a
+  terminal standing in it. One with none of those gets a **Remove** button (the worktree and its
+  merged branch); nothing is removed automatically. Gitignored files (a local `.env`, `node_modules/`)
+  do not hold a worktree back, but they go with it, so the row and the confirmation name them.
 - **Grid of parallel sessions** — the ＋ Terminal / grid view runs many sessions at once,
   auto-sizing by count across pages. Cell borders signal state at a glance — **working**
   (pulsing blue), **blocked** (amber — needs a permission / answer), **done** (blue —

package/common/blueprint/targets.ts

@@ -45,6 +45,9 @@ export function targetsViewOf(raw: string | null): TargetsView {
   if (!json.ok) return { targets: null, problem: `${TARGETS_FILE} is not JSON` };
   const parsed = targetsFileSchema.safeParse(json.value);
   if (!parsed.success) return { targets: null, problem: `${TARGETS_FILE} does not hold a list of targets` };
+  // The id is each row's identity on screen; the pack's own check refuses a repeat for the same reason.
+  const ids = parsed.data.targets.map((target) => target.id);
+  if (new Set(ids).size !== ids.length) return { targets: null, problem: `${TARGETS_FILE} lists a target id twice` };
   return { targets: parsed.data.targets, problem: null };
 }
 

package/common/sessionProcesses.ts

@@ -0,0 +1,64 @@
+// What the Processes page shows: each tmux session and the process tree under its panes (#2219).
+//
+// In `common/` because both sides decide from it: the server builds it from `ps` and tmux
+// (server/session/session-processes.ts), and the page reads it back and highlights from it.
+import { isRecord } from "./isRecord.js";
+import { isUnknownArray } from "./isUnknownArray.js";
+
+export interface SessionProcess {
+  pid: number;
+  ppid: number;
+  /** How far below the pane's root process, for indenting. The root is 0. */
+  depth: number;
+  command: string;
+  rssKb: number;
+  elapsedSeconds: number;
+  /** With `pid`, what a kill request names, so a reused pid is never the one killed. */
+  startedAt: string;
+  /** Percent of one core since the previous read; null on the first read, which has no baseline. */
+  cpuPercent: number | null;
+}
+
+export interface SessionProcesses {
+  sessionId: string;
+  /** Where the session runs, when this server remembers it. */
+  cwd: string | null;
+  /** Preorder, so each process sits under its parent. */
+  processes: SessionProcess[];
+}
+
+// A process this busy is the one a person opened the page to find.
+export const HOT_CPU_PERCENT = 50;
+// A day: a `yarn dev` left running since yesterday is worth a second look, not a kill.
+export const LONG_RUNNING_SECONDS = 86_400;
+
+export const isHot = (process: SessionProcess): boolean => process.cpuPercent !== null && process.cpuPercent >= HOT_CPU_PERCENT;
+export const isLongRunning = (process: SessionProcess): boolean => process.elapsedSeconds >= LONG_RUNNING_SECONDS;
+
+/** The pane's own root process. Ending it is ending the session, which has its own route. */
+export const isPaneRoot = (process: SessionProcess): boolean => process.depth === 0;
+
+const isSessionProcess = (value: unknown): value is SessionProcess =>
+  isRecord(value) &&
+  typeof value.pid === "number" &&
+  typeof value.ppid === "number" &&
+  typeof value.depth === "number" &&
+  typeof value.command === "string" &&
+  typeof value.rssKb === "number" &&
+  typeof value.elapsedSeconds === "number" &&
+  typeof value.startedAt === "string" &&
+  (value.cpuPercent === null || typeof value.cpuPercent === "number");
+
+const isSessionProcesses = (value: unknown): value is SessionProcesses =>
+  isRecord(value) &&
+  typeof value.sessionId === "string" &&
+  (value.cwd === null || typeof value.cwd === "string") &&
+  isUnknownArray(value.processes) &&
+  value.processes.every(isSessionProcess);
+
+/** A `GET /api/processes` body, or null when it is not one. A session that does not parse is
+ *  dropped rather than the whole list: one odd row should not blank the page. */
+export function readProcessesBody(body: unknown): SessionProcesses[] | null {
+  if (!isRecord(body) || !isUnknownArray(body.sessions)) return null;
+  return body.sessions.filter(isSessionProcesses);
+}

package/common/worktreeCleanup.ts

@@ -0,0 +1,95 @@
+// Which managed worktrees can go (#2219). Nothing is removed automatically: the page lists every
+// worktree with what holds it back, and a person removes a candidate with a button.
+//
+// In `common/` because both sides decide from it: the server gathers the facts
+// (server/git/worktree-cleanup.ts), the page shows the verdict and the reasons.
+import { isRecord } from "./isRecord.js";
+import { isUnknownArray } from "./isUnknownArray.js";
+
+export interface WorktreeCleanupRow {
+  /** The main checkout — what `POST /api/worktrees/cleanup/remove` takes as `repoDir`. */
+  repo: string;
+  base: string;
+  path: string;
+  branch: string | null;
+  /** The commit the branch was at when `merged` was decided — the only commit its deletion may take. */
+  head: string;
+  exists: boolean;
+  /** Uncommitted or untracked files: removing it would lose them. */
+  dirty: boolean;
+  /** Gitignored entries, which `git worktree remove` deletes WITHOUT counting the tree as dirty — a
+   *  local `.env` as much as a `node_modules`. Not a blocker, since nearly every worktree has some;
+   *  named to the person instead. At most `IGNORED_LISTED_MAX`; `ignoredCount` is the total. */
+  ignored: string[];
+  ignoredCount: number;
+  /** Every commit on it is already in the base. Ancestry, so a squash-merged branch reads as
+   *  unmerged — the safe direction. */
+  merged: boolean;
+  /** An agent session belongs to it, or a pane of ours stands in it (a plain shell counts). */
+  inUse: boolean;
+}
+
+export const IGNORED_LISTED_MAX = 20;
+
+/** The entries `git status --porcelain --ignored` marks `!!`. An ignored directory is one entry
+ *  (`node_modules/`): git does not descend into it. */
+export const parseIgnoredEntries = (porcelain: string): string[] =>
+  porcelain.split("\n").flatMap((line) => (line.startsWith("!! ") && line.length > 3 ? [line.slice(3)] : []));
+
+/** Dirty and ignored from ONE `git status --porcelain --ignored`. Null output is a status that
+ *  failed: then nothing is known to be safe to lose, so it reads as dirty — a blocker. */
+export function worktreeStatus(porcelain: string | null): { dirty: boolean; ignored: string[] } {
+  if (porcelain === null) return { dirty: true, ignored: [] };
+  const lines = porcelain.split("\n").filter((line) => line.trim() !== "");
+  return { dirty: lines.some((line) => !line.startsWith("!! ")), ignored: parseIgnoredEntries(porcelain) };
+}
+
+/** The ignored files a person was shown when they confirmed a removal. */
+export interface ConfirmedIgnored {
+  ignored: string[];
+  ignoredCount: number;
+}
+
+/** A removal request's confirmed ignored files, or null when the request does not carry them. */
+export function readConfirmedIgnored(body: Record<string, unknown>): ConfirmedIgnored | null {
+  const { ignored, ignoredCount } = body;
+  if (!isUnknownArray(ignored) || !ignored.every((entry) => typeof entry === "string") || typeof ignoredCount !== "number") return null;
+  return { ignored, ignoredCount };
+}
+
+/** Whether what would be deleted now is what was confirmed: an ignored file created since the list
+ *  was read would otherwise go without ever having been named. */
+export const sameIgnored = (confirmed: ConfirmedIgnored, now: ConfirmedIgnored): boolean =>
+  confirmed.ignoredCount === now.ignoredCount && confirmed.ignored.join("\n") === now.ignored.join("\n");
+
+export const CLEANUP_BLOCKERS = ["missing", "dirty", "unmerged", "inUse"] as const;
+export type CleanupBlocker = (typeof CLEANUP_BLOCKERS)[number];
+
+/** What keeps a worktree from being a removal candidate, in a fixed order. Empty means it can go. */
+export function cleanupBlockers(row: WorktreeCleanupRow): CleanupBlocker[] {
+  const holds: Record<CleanupBlocker, boolean> = { missing: !row.exists, dirty: row.dirty, unmerged: !row.merged, inUse: row.inUse };
+  return CLEANUP_BLOCKERS.filter((blocker) => holds[blocker]);
+}
+
+export const isCleanupCandidate = (row: WorktreeCleanupRow): boolean => cleanupBlockers(row).length === 0;
+
+const isCleanupRow = (value: unknown): value is WorktreeCleanupRow =>
+  isRecord(value) &&
+  typeof value.repo === "string" &&
+  typeof value.base === "string" &&
+  typeof value.path === "string" &&
+  (value.branch === null || typeof value.branch === "string") &&
+  typeof value.head === "string" &&
+  typeof value.exists === "boolean" &&
+  typeof value.dirty === "boolean" &&
+  isUnknownArray(value.ignored) &&
+  value.ignored.every((entry) => typeof entry === "string") &&
+  typeof value.ignoredCount === "number" &&
+  typeof value.merged === "boolean" &&
+  typeof value.inUse === "boolean";
+
+/** A `GET /api/worktrees/cleanup` body, or null when it is not one. */
+export function readWorktreeCleanupBody(body: unknown): WorktreeCleanupRow[] | null {
+  if (!isRecord(body) || !isUnknownArray(body.worktrees)) return null;
+  return body.worktrees.filter(isCleanupRow);
+}

package/dist/assets/{abnfDiagram-O67JEVCF-DyCC_1de.js → abnfDiagram-O67JEVCF-DXlZgdtc.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-Bta0VZsa.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-CBAglyfH.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-D-ijksGR.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core--AlGb2iN.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{m as e,t}from"./mermaid-parser.core-BvQdcEc9.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-B5s8ZEtK.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-nGmKdp-b.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-DLkUQwjT.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/dist/assets/architecture-7GRP2DOG-XtAJZbRy.js

@@ -0,0 +1 @@
+import"./chunk-FOHPRMQF-DzxwRta7.js";import{M as e}from"./mermaid-parser.core-BvQdcEc9.js";export{e as createArchitectureServices};