Git for the intent behind agent-written code. Records what your coding agent decided and why, and links every commit to it.
JavaScript ai-codingclaudeclaude-codeclaude-code-pluginclicoding-agentsdeveloper-toolsgitllmtypescript
import type { MouseEvent } from "react";
import type { LineageViewModel, ViewSession } from "../../cli/src/view/model.js";
import { formatStamp } from "./format.js";
import { branchPath, type GitMessageRow, type GitRow, LANE_COLORS } from "./gitLayout.js";
import { type PersonFilter, peopleOf } from "./people.js";
import type { SessionGraph } from "./sessionLayout.js";
/**
* Draws the project's sessions as a git graph (Story 8.7): one dot per session
* in start order, lanes for branches of sessions, and the session title as its
* label. Clicking a row opens that session's messages
* in place. The geometry comes from `sessionLayout.ts`; this file only renders.
*/
/** How far below the session row the line into its opened messages turns right. */
export const OPEN_LINK_DROP = 18;
function color(index: number): string {
return `var(--l${index % LANE_COLORS})`;
}
function SessionRow({
row,
session,
showAuthor,
dimmed,
selected,
open,
searchHit,
captured,
onOpen,
onOpenCard,
onContinue,
}: {
row: GitMessageRow;
session: ViewSession;
/** Whose session it is: shown for a teammate's, never for your own. */
showAuthor: boolean;
/** Left out by the person filter: kept in place, faded, so the lines stay whole. */
dimmed: boolean;
selected: boolean;
/** Its messages are open below the row. */
open: boolean;
/** The session's title or status matches the search (Story 8.14). */
searchHit: boolean;
/** Suggested + open captured items the session stands for (Story 15.3). */
captured?: number | undefined;
/** Opens or folds the session's messages (the arrow on the left). */
onOpen: (sessionId: string) => void;
/** Opens the session's card (a click anywhere on the row, and the capture badge). */
onOpenCard: (sessionId: string) => void;
onContinue: (continues: NonNullable<ViewSession["messages"][number]["continues"]>) => void;
}) {
const continues = session.messages[0]?.continues;
// A session with no messages anchors nowhere: its items live only in the
// Captured list, so its row gets no badge (Story 15.3).
const badge = session.messages.length === 0 ? undefined : captured;
const style = { top: row.y - row.height / 2, height: row.height };
const count = session.messages.length;
const className = [
"git-row session-row",
selected ? "is-selected" : "",
open ? "is-open" : "",
searchHit ? "is-search-hit" : "",
dimmed ? "is-dimmed" : "",
]
.filter(Boolean)
.join(" ");
return (
// A div, not a button: the row holds the toggle and the capture badge
// (Story 15.3), and a button may not nest one. The box opens the session's
// card; the arrow beside it opens the messages.
<div
role="button"
tabIndex={0}
className={className}
style={style}
onClick={(event: MouseEvent) => {
event.stopPropagation();
onOpenCard(session.sessionId);
}}
onKeyDown={(event) => {
// The toggle and the badge handle their own keys; only the row's own
// focus reaches here.
if (event.target !== event.currentTarget) return;
if (event.key !== "Enter" && event.key !== " ") return;
event.preventDefault();
onOpenCard(session.sessionId);
}}
title={session.status.goal || session.title}
>
<button
type="button"
className="session-toggle"
aria-expanded={open}
aria-label={open ? "Fold this session's messages" : "Open this session's messages"}
title={open ? "Fold the messages" : "Open the messages"}
onClick={(event: MouseEvent) => {
event.stopPropagation();
onOpen(session.sessionId);
}}
>
{open ? "▾" : "▸"}
</button>
<span className="git-time">{session.startedAt ? formatStamp(session.startedAt) : ""}</span>
<span className="git-title">{session.title || session.sessionId}</span>
{badge === undefined ? null : (
<button
type="button"
className="capture-mark session-capture"
title={`${badge} captured item${badge === 1 ? "" : "s"} from this session`}
onClick={(event: MouseEvent) => {
event.stopPropagation();
onOpenCard(session.sessionId);
}}
>
{badge}
</button>
)}
{showAuthor && session.author ? (
<span className="muted session-author" title={`Recorded by ${session.author}`}>
{session.author}
</span>
) : null}
<span className="muted session-count">
{count} message{count === 1 ? "" : "s"}
</span>
{session.unrecordedMessages ? (
<span className="muted unrecorded" title="The side model at session end is off">
{session.unrecordedMessages} not recorded
</span>
) : null}
{continues ? (
<span
className="git-continues"
title={`Open ${continues.sessionTitle} at ${continues.label ?? continues.id}`}
onClick={(event: MouseEvent) => {
event.stopPropagation();
onContinue(continues);
}}
>
↑ {continues.label ?? continues.id}
</span>
) : null}
{row.head ? <span className="left-off">left off here</span> : null}
</div>
);
}
export function SessionMap({
model,
graph,
selectedSessionId,
openIds,
highlightSessionIds,
person = null,
captured,
onOpen,
onOpenCard,
onContinue,
}: {
model: LineageViewModel;
graph: SessionGraph;
selectedSessionId: string | null;
/** Sessions whose messages are open below their rows. */
openIds: ReadonlySet<string>;
/** Sessions whose title or status matched the map search. */
highlightSessionIds: ReadonlySet<string>;
/** The person filter: everyone when left out. */
person?: PersonFilter;
/** Suggested + open captured items, by session id (Story 15.3). */
captured?: ReadonlyMap<string, number> | undefined;
/** Opens or folds a session's messages (its arrow). */
onOpen: (sessionId: string) => void;
/** Opens a session's card (its row, or its capture badge). */
onOpenCard: (sessionId: string) => void;
onContinue: (sessionId: string, messageId: string) => void;
}) {
const { git } = graph;
const segments = new Map(git.segments.map((segment) => [segment.id, segment]));
// Grouped once: filtering every row per segment was quadratic, seconds at 10,000 sessions.
const rowsBySegment = new Map<string, GitRow[]>();
for (const row of git.rows) {
const rows = rowsBySegment.get(row.segmentId);
if (rows === undefined) rowsBySegment.set(row.segmentId, [row]);
else rows.push(row);
}
const people = peopleOf(model);
const open: (row: GitRow) => void = (row) => {
if (row.kind === "message") onOpen(row.message.id);
};
return (
<div className="git-graph session-map" style={{ width: git.width, height: git.height }}>
<svg
className="git-lanes"
width={git.graphWidth}
height={git.height}
aria-hidden="true"
focusable="false"
>
{git.segments.map((segment) => {
const start = branchPath(segment, git.laneX);
const rows = rowsBySegment.get(segment.id) ?? [];
const x = git.laneX[segment.lane] ?? 0;
return (
<g key={segment.id} stroke={color(segment.colorIndex)} fill="none">
{start ? <path d={start} strokeWidth={2.5} /> : null}
{rows.slice(1).map((row, at) => {
const previous = rows[at];
if (!previous) return null;
return (
<path
key={`${row.segmentId}-${at}`}
d={`M${x},${previous.y} L${x},${row.y}`}
strokeWidth={2.5}
/>
);
})}
</g>
);
})}
{git.rows.map((row) => {
if (row.kind !== "message" || row.spaceTop === undefined) return null;
// An opened session: a line from its dot down into its messages below.
const x = git.laneX[segments.get(row.segmentId)?.lane ?? 0] ?? 0;
const y = row.spaceTop + OPEN_LINK_DROP;
return (
<path
key={`${row.message.id}-open`}
d={`M${x},${row.y} L${x},${y} L${git.graphWidth + 4},${y}`}
stroke={color(row.colorIndex)}
strokeWidth={1.5}
strokeDasharray="3 3"
fill="none"
/>
);
})}
{git.rows.map((row) => {
if (row.kind !== "message") return null;
const x = git.laneX[segments.get(row.segmentId)?.lane ?? 0] ?? 0;
return row.first ? (
<circle
key={row.message.id}
cx={x}
cy={row.y}
r={6}
fill="var(--bg)"
stroke={color(row.colorIndex)}
strokeWidth={3}
className="session-dot"
onClick={() => open(row)}
/>
) : (
<circle
key={row.message.id}
cx={x}
cy={row.y}
r={4.5}
fill={color(row.colorIndex)}
className="session-dot"
onClick={() => open(row)}
/>
);
})}
</svg>
<div className="git-rows" style={{ left: git.graphWidth + 8, width: git.rowWidth }}>
{git.rows.map((row) => {
const session = row.kind === "message" ? graph.sessions.get(row.message.id) : undefined;
if (row.kind !== "message" || !session) return null;
return (
<SessionRow
key={row.message.id}
row={row}
session={session}
showAuthor={people.showAuthor(session)}
dimmed={!people.matches(session, person)}
selected={selectedSessionId === session.sessionId}
open={openIds.has(session.sessionId)}
searchHit={highlightSessionIds.has(session.sessionId)}
captured={captured?.get(session.sessionId)}
onOpen={onOpen}
onOpenCard={onOpenCard}
onContinue={(continues) => onContinue(continues.sessionId, continues.id)}
/>
);
})}
</div>
</div>
);
}