mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-16 04:45:33 -08:00
99 lines
3.3 KiB
JavaScript
99 lines
3.3 KiB
JavaScript
// Plan2Code Web Console - the session meter's weights, count and wording.
|
|
//
|
|
// The source of truth for how much each piece of work weighs, how the count
|
|
// is folded out of ledger.ndjson, and what the pill says at each level. The
|
|
// count is never stored: it is always pointsFrom() over the ledger. No DOM
|
|
// access at module scope and no imports: the server, console.mjs, the page
|
|
// and `node --test` all import this file.
|
|
|
|
// The one place the weights live (FR-12). Tune here.
|
|
export const WEIGHTS = Object.freeze({
|
|
"pathfinder-chart": 2,
|
|
"pathfinder-question": 1,
|
|
plan: 2,
|
|
"revise-plan": 1,
|
|
document: 2,
|
|
"implement-phase": 2,
|
|
"implement-review-phase": 3,
|
|
review: 2,
|
|
"quick-task": 1,
|
|
init: 2,
|
|
"init-update": 2,
|
|
finalize: 1,
|
|
handoff: 0,
|
|
});
|
|
|
|
// Workflows whose launch itself scores WEIGHTS[workflow]. Pathfinder,
|
|
// implement and implement-review score only through the agent's `run`
|
|
// reports; dashboard and handoff never score.
|
|
export const LAUNCH_COUNTED = Object.freeze(
|
|
new Set(["plan", "revise-plan", "document", "review", "quick-task", "init", "init-update", "finalize"])
|
|
);
|
|
|
|
// The event names an agent may report in `run`.
|
|
export const RUN_EVENTS = new Set(Object.keys(WEIGHTS));
|
|
|
|
const weightOf = (key) => (Object.prototype.hasOwnProperty.call(WEIGHTS, key) ? WEIGHTS[key] : 0);
|
|
|
|
/**
|
|
* The session's points, folded from ledger entries in order. An id seen
|
|
* before is skipped, so a repeated `post` never counts twice.
|
|
*/
|
|
export function pointsFrom(entries) {
|
|
const seen = new Set();
|
|
let points = 0;
|
|
for (const entry of Array.isArray(entries) ? entries : []) {
|
|
if (!entry || typeof entry !== "object") continue;
|
|
if (entry.id !== undefined) {
|
|
if (seen.has(entry.id)) continue;
|
|
seen.add(entry.id);
|
|
}
|
|
if (entry.kind === "launch" && LAUNCH_COUNTED.has(entry.workflow)) points += weightOf(entry.workflow);
|
|
else if (entry.kind === "run") points += weightOf(entry.event);
|
|
}
|
|
return points;
|
|
}
|
|
|
|
export const YELLOW_AT = 4;
|
|
export const RED_AT = 6;
|
|
export const RING_FULL = 8;
|
|
|
|
export function levelFor(points) {
|
|
if (points < YELLOW_AT) return "green";
|
|
if (points < RED_AT) return "yellow";
|
|
return "red";
|
|
}
|
|
|
|
// How much of the ring is filled: full at RING_FULL, never below empty.
|
|
export function ringFraction(points) {
|
|
return Math.max(0, Math.min(points, RING_FULL)) / RING_FULL;
|
|
}
|
|
|
|
export const WORDS = Object.freeze({
|
|
green: "Session: fresh",
|
|
yellow: "Session: getting long",
|
|
red: "Session: time for a fresh start",
|
|
});
|
|
|
|
export function tooltipFor(points) {
|
|
const count = `${points} ${points === 1 ? "point" : "points"}`;
|
|
switch (levelFor(points)) {
|
|
case "green":
|
|
return `This session is fresh (${count}).`;
|
|
case "yellow":
|
|
return `This session is getting long (${count}). A fresh one will soon be sharper.`;
|
|
default:
|
|
return `This session has done a lot (${count}). The agent may start missing things.`;
|
|
}
|
|
}
|
|
|
|
export const RED_BANNER =
|
|
"This console session has done a lot. Starting a new console session will keep the agent sharp.";
|
|
|
|
// Everything the pill draws, from the ledger alone.
|
|
export function meterView(entries) {
|
|
const points = pointsFrom(entries);
|
|
const level = levelFor(points);
|
|
return { points, level, fraction: ringFraction(points), words: WORDS[level], tooltip: tooltipFor(points) };
|
|
}
|