pi-daddy 0.51.0 → 0.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +11 -32
  3. package/dist/governance/approval-prompt.d.ts +4 -0
  4. package/dist/governance/approval-prompt.d.ts.map +1 -1
  5. package/dist/governance/approval-prompt.js +4 -5
  6. package/dist/governance/approval-prompt.js.map +1 -1
  7. package/dist/governance/permission-question.d.ts +4 -0
  8. package/dist/governance/permission-question.d.ts.map +1 -0
  9. package/dist/governance/permission-question.js +102 -0
  10. package/dist/governance/permission-question.js.map +1 -0
  11. package/dist/kernel/chain.d.ts +1 -0
  12. package/dist/kernel/chain.d.ts.map +1 -1
  13. package/dist/kernel/chain.js.map +1 -1
  14. package/dist/kernel/dashboard-observation.d.ts +15 -5
  15. package/dist/kernel/dashboard-observation.d.ts.map +1 -1
  16. package/dist/kernel/dashboard-observation.js.map +1 -1
  17. package/dist/products/activity-summary.d.ts +8 -0
  18. package/dist/products/activity-summary.d.ts.map +1 -0
  19. package/dist/products/activity-summary.js +101 -0
  20. package/dist/products/activity-summary.js.map +1 -0
  21. package/dist/products/activity-timeline.d.ts +4 -1
  22. package/dist/products/activity-timeline.d.ts.map +1 -1
  23. package/dist/products/activity-timeline.js +9 -1
  24. package/dist/products/activity-timeline.js.map +1 -1
  25. package/dist/products/dashboard-activity.d.ts +9 -0
  26. package/dist/products/dashboard-activity.d.ts.map +1 -0
  27. package/dist/products/dashboard-activity.js +119 -0
  28. package/dist/products/dashboard-activity.js.map +1 -0
  29. package/dist/products/dashboard-cli.d.ts +2 -1
  30. package/dist/products/dashboard-cli.d.ts.map +1 -1
  31. package/dist/products/dashboard-cli.js +8 -5
  32. package/dist/products/dashboard-cli.js.map +1 -1
  33. package/dist/products/dashboard-components.d.ts +10 -0
  34. package/dist/products/dashboard-components.d.ts.map +1 -0
  35. package/dist/products/dashboard-components.js +196 -0
  36. package/dist/products/dashboard-components.js.map +1 -0
  37. package/dist/products/dashboard-layout.js +20 -4
  38. package/dist/products/dashboard-layout.js.map +1 -1
  39. package/dist/products/dashboard-panels.d.ts.map +1 -1
  40. package/dist/products/dashboard-panels.js +128 -67
  41. package/dist/products/dashboard-panels.js.map +1 -1
  42. package/dist/products/dashboard-recap.d.ts +1 -1
  43. package/dist/products/dashboard-recap.d.ts.map +1 -1
  44. package/dist/products/dashboard-recap.js +12 -16
  45. package/dist/products/dashboard-recap.js.map +1 -1
  46. package/dist/products/dashboard-screen.d.ts +5 -2
  47. package/dist/products/dashboard-screen.d.ts.map +1 -1
  48. package/dist/products/dashboard-screen.js +92 -36
  49. package/dist/products/dashboard-screen.js.map +1 -1
  50. package/dist/products/dashboard-session-client.d.ts +6 -5
  51. package/dist/products/dashboard-session-client.d.ts.map +1 -1
  52. package/dist/products/dashboard-session-client.js.map +1 -1
  53. package/dist/products/ecosystem-versions.d.ts +2 -0
  54. package/dist/products/ecosystem-versions.d.ts.map +1 -1
  55. package/extensions/activity-timeline.ts +7 -1
  56. package/extensions/approvals.ts +7 -0
  57. package/extensions/dashboard-live.ts +45 -5
  58. package/extensions/dashboard-observation.ts +1 -3
  59. package/extensions/delegate-chain.ts +2 -0
  60. package/extensions/delegation-artifacts.ts +26 -4
  61. package/extensions/delegation-operations.ts +12 -4
  62. package/extensions/delegation.ts +4 -0
  63. package/extensions/ecosystem-versions.ts +25 -3
  64. package/extensions/execute-child.ts +4 -0
  65. package/extensions/run-delegation.ts +2 -0
  66. package/extensions/runtime-snapshot.ts +8 -4
  67. package/extensions/session.ts +2 -2
  68. package/package.json +1 -1
  69. package/src/governance/approval-prompt.ts +7 -6
  70. package/src/governance/permission-question.ts +108 -0
  71. package/src/kernel/chain.ts +1 -0
  72. package/src/kernel/dashboard-observation.ts +15 -1
  73. package/src/products/activity-summary.ts +101 -0
  74. package/src/products/activity-timeline.ts +11 -0
  75. package/src/products/dashboard-activity.ts +136 -0
  76. package/src/products/dashboard-cli.ts +20 -6
  77. package/src/products/dashboard-components.ts +219 -0
  78. package/src/products/dashboard-layout.ts +27 -6
  79. package/src/products/dashboard-panels.ts +128 -76
  80. package/src/products/dashboard-recap.ts +15 -15
  81. package/src/products/dashboard-screen.ts +101 -38
  82. package/src/products/dashboard-session-client.ts +7 -1
  83. package/src/products/ecosystem-versions.ts +2 -0
@@ -0,0 +1,108 @@
1
+ import { basename } from "node:path";
2
+ import { stripVTControlCharacters } from "node:util";
3
+ import type { ApprovalUI, PromptRequest } from "./approval-prompt.ts";
4
+
5
+ const DETAILS = "View permission details";
6
+ const BACK = "Back to decision";
7
+ const NEXT = "Next page";
8
+ const PREVIOUS = "Previous page";
9
+
10
+ /** Only these strings belong on the terminal; the original values still identify the grant. */
11
+ function clean(text: string): string {
12
+ return stripVTControlCharacters(text.replace(/\r\n?/g, "\n"))
13
+ .replace(/[\u0000-\u0009\u000b-\u001f\u007f-\u009f\u061c\u200b-\u200f\u202a-\u202e\u2066-\u2069]/gu, " ")
14
+ .replace(/[\u2028\u2029]/gu, "\n");
15
+ }
16
+
17
+ function oneLine(value: string, limit: number): string {
18
+ const chars = [...value.trim().replace(/\s+/gu, " ")];
19
+ return chars.length <= limit
20
+ ? chars.join("")
21
+ : chars
22
+ .slice(0, limit - 1)
23
+ .join("")
24
+ .trimEnd() + "…";
25
+ }
26
+
27
+ function headline(request: PromptRequest): string {
28
+ const actions: Record<string, string> = {
29
+ "tool:bash": "run shell commands",
30
+ "tool:write": "write files",
31
+ "tool:edit": "edit files",
32
+ "tool:delegate": "delegate work to another agent",
33
+ };
34
+ const subject = request.path === "delegate" ? "this delegated agent" : oneLine(clean(request.subject), 80);
35
+ const action = actions[request.capability] ?? `use ${oneLine(clean(request.capability), 90)}`;
36
+ return `Allow ${subject} to ${action}?`;
37
+ }
38
+
39
+ function scopeHint(request: PromptRequest): string {
40
+ if (request.bindingKey) return "Remembered choices apply only to this exact request.";
41
+ return request.path === "delegate"
42
+ ? "A session choice also covers other unnamed delegated agents."
43
+ : "A remembered choice also covers other tasks for this agent.";
44
+ }
45
+
46
+ /** Render the full, untrusted brief in pages so choices stay reachable on a typical terminal. */
47
+ function detailLines(request: PromptRequest): string[] {
48
+ const rows = [
49
+ `Permission: ${clean(request.capability)}`,
50
+ `Agent: ${clean(request.subject)}`,
51
+ ...(request.project ? [`Permission project: ${clean(request.project)}`] : []),
52
+ ...(request.workspace ? [`Requested workspace: ${clean(request.workspace)}`] : []),
53
+ scopeHint(request),
54
+ ...(request.bindingKey ? ["Reuse requires the same task, tools, parent and bound context."] : []),
55
+ "",
56
+ "Requested task",
57
+ clean(request.task ?? "").trim() || "No task description supplied.",
58
+ ];
59
+ return rows
60
+ .join("\n")
61
+ .split("\n")
62
+ .flatMap((line) => {
63
+ const chunks = line.match(/.{1,58}(?:\s+|$)|.{1,58}/gu);
64
+ return chunks ? chunks.map((chunk) => chunk.trimEnd()) : [""];
65
+ });
66
+ }
67
+
68
+ /** Details are informational. The same decision and its original deadline stay in force across pages. */
69
+ export async function selectPermission(
70
+ ui: ApprovalUI,
71
+ request: PromptRequest,
72
+ labels: string[],
73
+ signal: AbortSignal,
74
+ ): Promise<string | undefined> {
75
+ const task = clean(request.task ?? "")
76
+ .split("\n")
77
+ .find((line) => line.trim());
78
+ const title = [
79
+ headline(request),
80
+ ...(task ? [`Requested task: ${oneLine(task, 115)}`] : []),
81
+ ...(request.project
82
+ ? [`Permission project: ${oneLine(clean(basename(request.project) || request.project), 60)}`]
83
+ : []),
84
+ ...(request.capability === "tool:bash" ? ["Shell access can change files and run other commands."] : []),
85
+ ...(request.recheckReason ? [request.recheckReason] : []),
86
+ scopeHint(request),
87
+ ].join("\n");
88
+ const choices = [...labels, DETAILS];
89
+ let lines: string[] | undefined;
90
+ let page = -1;
91
+ while (!signal.aborted) {
92
+ if (page < 0) {
93
+ const choice = await ui.select(title, choices, { signal });
94
+ if (choice !== DETAILS) return choice;
95
+ lines ??= detailLines(request);
96
+ page = 0;
97
+ } else {
98
+ const pages = Math.ceil(lines!.length / 8);
99
+ const title = [`Permission details · ${page + 1}/${pages}`, ...lines!.slice(page * 8, page * 8 + 8)].join("\n");
100
+ const options = [BACK, ...(page + 1 < pages ? [NEXT] : []), ...(page > 0 ? [PREVIOUS] : [])];
101
+ const nav = await ui.select(title, options, { signal });
102
+ if (nav === undefined || !options.includes(nav)) return undefined;
103
+ if (nav === BACK) page = -1;
104
+ else page += nav === NEXT ? 1 : -1;
105
+ }
106
+ }
107
+ return undefined;
108
+ }
@@ -155,6 +155,7 @@ export interface ChainStep {
155
155
  operation_id?: string;
156
156
  definitionId?: string;
157
157
  task: string;
158
+ dashboardSummary?: string;
158
159
  agent?: string;
159
160
  tools?: string[];
160
161
  model?: string;
@@ -46,6 +46,20 @@ export interface DashboardSourceSnapshot extends DashboardSourceUpdate {
46
46
  staleAfterMs: number;
47
47
  availability: "observed" | "closed";
48
48
  }
49
+ /** Session-local display metadata from the same elected child that published the reference. */
50
+ export interface DashboardResultDescription {
51
+ agent?: string;
52
+ summary?: string;
53
+ content: "answer" | "partial" | "record";
54
+ state: "not-started" | "uncertain" | "failed" | "settled" | "unknown";
55
+ observedAt: string;
56
+ }
57
+ export interface DashboardSavedEvidence {
58
+ operationId: string;
59
+ executionId: string;
60
+ sha256: string;
61
+ description?: DashboardResultDescription;
62
+ }
49
63
  export interface DashboardOwnerObservation {
50
64
  version: 1;
51
65
  sessionId: string;
@@ -57,7 +71,7 @@ export interface DashboardOwnerObservation {
57
71
  logicalOwnerId?: string;
58
72
  turn?: DashboardContribution;
59
73
  activity?: DashboardContribution[];
60
- artifacts?: Array<{ operationId: string; executionId: string; sha256: string }>;
74
+ artifacts?: DashboardSavedEvidence[];
61
75
  resources: { scope: "owner-process"; sampledAt: string; rssBytes: number; hostHealth: "unknown" };
62
76
  capture: { transcripts: boolean; diagnostics: boolean };
63
77
  }
@@ -0,0 +1,101 @@
1
+ const privateMarkers = [
2
+ /https?:\/\/|(?:^|[\s("'=])(?:\/|~\/|[A-Z]:[\\/])/i,
3
+ /[a-z\d._%+-]+@[a-z\d.-]+\.[a-z]{2,}/i,
4
+ /\b(?:[\da-f]{32,}|[A-Za-z\d_\-]{36,})\b/i,
5
+ /\b(?:Bearer\s+\S|(?:password|token|api[_ -]?key|secret)\s*[:=]|(?:sk-|ghp_|github_pat_|AKIA)[\w-]{8,})/i,
6
+ ];
7
+
8
+ /** Public display text is a separate field from the task, prompt and reasoning. */
9
+ export function safeDashboardSummary(value: unknown): string | undefined {
10
+ if (typeof value !== "string" || value.length > 160 || /[\p{Cc}\p{Cf}]/u.test(value)) return;
11
+ const line = value.trim().replace(/\s+/g, " ");
12
+ if (!line || privateMarkers.some((pattern) => pattern.test(line))) return;
13
+ return line;
14
+ }
15
+
16
+ export const dashboardSummaryDescription =
17
+ "Give this child a short purpose for the user's dashboard, e.g. 'Check that stale cache entries refresh'. " +
18
+ "Use public task terms only. Omit secrets, paths, IDs, links and private material. Display only.";
19
+
20
+ export function dashboardContentEnabled(env: NodeJS.ProcessEnv): boolean {
21
+ return (
22
+ !["off", "0"].includes(env.PI_DADDY_ACTIVITY_TIMELINE?.trim() ?? "") &&
23
+ !["off", "metadata-only"].includes(env.PI_DADDY_ACTIVITY_CONTENT?.trim() ?? "")
24
+ );
25
+ }
26
+
27
+ /** Only fixed descriptions cross the observation boundary for regular tools. */
28
+ export function toolPurpose(tool: string, args?: unknown): string {
29
+ const params = args && typeof args === "object" ? (args as Record<string, unknown>) : {};
30
+ if (tool === "bash" && typeof params.command === "string" && /^\s*npm\s+(?:test|run\s+test)\s*$/.test(params.command))
31
+ return "Run the project tests";
32
+ if (tool === "read" && typeof params.path === "string" && params.path.length <= 4096) {
33
+ const path = params.path.replaceAll("\\", "/");
34
+ if (/(^|\/)README(?:\.[^/]+)?$/i.test(path)) return "Read the project guide";
35
+ if (/(^|\/)SKILL\.md$/.test(path)) return "Read a skill's instructions";
36
+ if (/(^|\/)(?:tests?|__tests__)\/|(?:\.test|\.spec)\.[^/]+$/i.test(path)) return "Read a test file";
37
+ if (/(^|\/)\.principal\/reports\//.test(path)) return "Read a saved report";
38
+ }
39
+ if (tool === "principal_workflow") {
40
+ switch (params.action) {
41
+ case "prepare":
42
+ return "Prepare the next step";
43
+ case "inspect":
44
+ return "Check the state of a workflow step";
45
+ case "complete":
46
+ return "Record the result of a workflow step";
47
+ }
48
+ }
49
+ switch (tool) {
50
+ case "read":
51
+ return "Read a project file";
52
+ case "grep":
53
+ return "Search file contents";
54
+ case "find":
55
+ return "Find project files";
56
+ case "ls":
57
+ return "List files in a folder";
58
+ case "edit":
59
+ return "Edit a file";
60
+ case "write":
61
+ return "Write a file";
62
+ case "bash":
63
+ return "Run a shell command";
64
+ case "delegate": {
65
+ switch (params.agent) {
66
+ case "review":
67
+ return "Request an independent review";
68
+ case "test-review":
69
+ return "Ask a reviewer to check the tests";
70
+ case "investigate":
71
+ return "Ask a subagent to investigate";
72
+ case "build":
73
+ return "Ask a subagent to implement a change";
74
+ case "plan":
75
+ return "Ask a subagent to prepare a plan";
76
+ default:
77
+ return "Ask a subagent to work on a task";
78
+ }
79
+ }
80
+ case "delegate_all":
81
+ return "Assign tasks to multiple subagents";
82
+ case "delegate_chain":
83
+ return "Assign a sequence of tasks to subagents";
84
+ case "delegate_describe":
85
+ return "Check a subagent's instructions";
86
+ case "principal_workflow":
87
+ return "Manage a workflow step";
88
+ case "codemode":
89
+ return "Run a group of tool calls";
90
+ default:
91
+ return "Use a project tool";
92
+ }
93
+ }
94
+
95
+ export function observedPurpose(tool: string, args: unknown, allowSummary: boolean): string {
96
+ if (tool === "delegate" && allowSummary && args && typeof args === "object") {
97
+ const summary = safeDashboardSummary((args as Record<string, unknown>).dashboardSummary);
98
+ if (summary) return summary;
99
+ }
100
+ return toolPurpose(tool, args);
101
+ }
@@ -1,4 +1,5 @@
1
1
  /** Durable, local-only activity facts. Timeline events never infer skill compliance or provider reasoning. */
2
+ import { safeDashboardSummary } from "./activity-summary.ts";
2
3
  import { createHash, randomUUID } from "node:crypto";
3
4
  import { constants } from "node:fs";
4
5
  import { appendFile, mkdir, open, readFile, realpath, rename, writeFile } from "node:fs/promises";
@@ -52,6 +53,7 @@ export interface ActivityEvent {
52
53
  model?: string;
53
54
  thinking?: string;
54
55
  trigger?: ActivityTrigger;
56
+ dashboardSummary?: string;
55
57
  prompt?: ContentReference;
56
58
  final?: ContentReference;
57
59
  skill?: ActivitySkill;
@@ -75,8 +77,10 @@ export interface TimelineTask {
75
77
  model?: string;
76
78
  thinking?: string;
77
79
  trigger?: ActivityTrigger;
80
+ dashboardSummary?: string;
78
81
  prompt?: ContentReference;
79
82
  final?: ContentReference;
83
+ lastPurpose?: string;
80
84
  skills: TimelineSkill[];
81
85
  agents: Array<{ id: string; parentTaskId?: string; agent: string; state: string }>;
82
86
  }
@@ -146,6 +150,8 @@ function eventOf(value: unknown): ActivityEvent | null {
146
150
  (event.final && !validRef(event.final))
147
151
  )
148
152
  return null;
153
+ if (event.dashboardSummary !== undefined && safeDashboardSummary(event.dashboardSummary) !== event.dashboardSummary)
154
+ return null;
149
155
  if (
150
156
  event.skill &&
151
157
  (!validId(event.skill.name) ||
@@ -192,6 +198,7 @@ export function parseActivityTimeline(text: string): ActivityTimeline {
192
198
  if (event.cwd) task.cwd = event.cwd;
193
199
  }
194
200
  if (event.kind === "task_started") {
201
+ task.dashboardSummary = event.dashboardSummary;
195
202
  task.model = event.model;
196
203
  task.thinking = event.thinking;
197
204
  task.trigger = event.trigger;
@@ -199,6 +206,7 @@ export function parseActivityTimeline(text: string): ActivityTimeline {
199
206
  task.agent = event.agent ?? task.agent;
200
207
  task.parentTaskId = event.parentTaskId ?? task.parentTaskId;
201
208
  }
209
+ if (event.kind === "tool_started") task.lastPurpose = event.dashboardSummary;
202
210
  if (event.kind === "task_finished") {
203
211
  task.endedAt = event.at;
204
212
  task.final = event.final;
@@ -626,13 +634,16 @@ export class ActivityTimelineRecorder {
626
634
  prompt: string,
627
635
  model?: string,
628
636
  thinking?: string,
637
+ dashboardSummary?: string,
629
638
  ): Promise<void> {
630
639
  if (!this.enabled) return;
631
640
  this.taskId = taskId;
641
+ const purpose = this.contentEnabled && safeDashboardSummary(dashboardSummary);
632
642
  await this.append("task_started", {
633
643
  parentTaskId,
634
644
  agentId: taskId,
635
645
  agent,
646
+ ...(purpose ? { dashboardSummary: purpose } : {}),
636
647
  model,
637
648
  thinking,
638
649
  prompt: await this.content(prompt),
@@ -0,0 +1,136 @@
1
+ import type { DashboardContribution } from "../kernel/dashboard-observation.ts";
2
+ import type { TimelineTask } from "./activity-timeline.ts";
3
+ import { safeDashboardSummary, toolPurpose } from "./activity-summary.ts";
4
+ import type { DashboardItem } from "./dashboard-screen.ts";
5
+
6
+ const clean = (value: string) =>
7
+ value
8
+ .replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "")
9
+ .replace(/[\p{Cc}\p{Cf}]/gu, " ")
10
+ .trim();
11
+
12
+ export function activityTaskTitle(task: TimelineTask): string {
13
+ const lastAction = task.lastEvent?.kind === "tool_started" || task.status !== "active";
14
+ const observed = lastAction
15
+ ? (safeDashboardSummary(task.lastPurpose) ?? (task.lastEvent?.tool ? toolPurpose(task.lastEvent.tool) : undefined))
16
+ : undefined;
17
+ const purpose = safeDashboardSummary(task.dashboardSummary) ?? observed;
18
+ if (purpose) return task.agent ? `${purpose} · ${clean(task.agent)}` : purpose;
19
+ if (task.agent) return `${clean(task.agent)} task`;
20
+ if (task.trigger?.type === "custom") return "Handle an extension request";
21
+ if (task.status === "finished") return "Pi finished its turn";
22
+ return task.status === "active" ? "Pi is working on your request" : "Pi handled your request";
23
+ }
24
+
25
+ /** Ledger entries retain authoritative state and identity. Only the same owner's matching execution may add a title. */
26
+ export function applyOwnerTaskTitles(items: DashboardItem[], tasks: TimelineTask[], rootId: string): DashboardItem[] {
27
+ const known = new Map(tasks.filter((task) => task.rootId === rootId && task.agent).map((task) => [task.id, task]));
28
+ return items.map((item) => {
29
+ const task = known.get(item.key);
30
+ return task && (task.dashboardSummary || task.lastPurpose) ? { ...item, label: activityTaskTitle(task) } : item;
31
+ });
32
+ }
33
+
34
+ interface Story {
35
+ events: DashboardContribution[];
36
+ label: string;
37
+ status: string;
38
+ group?: string;
39
+ calls: number;
40
+ legacy?: boolean;
41
+ }
42
+
43
+ /** Group only matching tool observations within a turn. Preserve failures, interleaving, and original records in Details. */
44
+ export function activityStoryItems(
45
+ events: DashboardContribution[],
46
+ generation: string,
47
+ disconnected: boolean,
48
+ ): DashboardItem[] {
49
+ const stories: Story[] = [];
50
+ const starts = new Map<string, Story>();
51
+ for (const event of events) {
52
+ const raw = clean(event.label);
53
+ const toolEvent = /^(.+): tool (start|end)$/.exec(raw);
54
+ if (!toolEvent) {
55
+ if (raw === "agent_start" || raw === "agent_end") starts.clear();
56
+ stories.push({
57
+ events: [event],
58
+ label: raw === "agent_start" ? "Pi started a turn" : raw === "agent_end" ? "Pi finished its turn" : raw,
59
+ status: "observed",
60
+ calls: 1,
61
+ });
62
+ continue;
63
+ }
64
+ const [, name, phase] = toolEvent;
65
+ const call = event.details?.find((line) => /^Call: \d+$/.test(line));
66
+ const key = call && `${name}:${call}`;
67
+ let story = phase === "end" && key ? starts.get(key) : undefined;
68
+ if (story) {
69
+ starts.delete(key!);
70
+ // A call finishing after a different action belongs at the time its result arrived.
71
+ stories.splice(stories.indexOf(story), 1);
72
+ story.events.push(event);
73
+ } else {
74
+ const purpose = event.details?.find((line) => line.startsWith("Purpose: "))?.slice(9);
75
+ story = {
76
+ events: [event],
77
+ label: safeDashboardSummary(purpose) ?? toolPurpose(name!),
78
+ status: "observed",
79
+ group: name,
80
+ calls: 1,
81
+ legacy: !key,
82
+ };
83
+ }
84
+ if (phase === "start" && key) starts.set(key, story);
85
+ story.status = event.state === "failed" ? "failed" : phase === "end" ? "finished" : "Started";
86
+ stories.push(story);
87
+ }
88
+ const grouped: Story[] = [];
89
+ for (const story of stories) {
90
+ const last = grouped.at(-1);
91
+ if (
92
+ last &&
93
+ story.legacy &&
94
+ last.legacy &&
95
+ story.group === last.group &&
96
+ story.label === last.label &&
97
+ story.status !== "failed" &&
98
+ last.status !== "failed"
99
+ ) {
100
+ // Older Pi observations have no call identity. Count raw records, never inferred commands.
101
+ last.events.push(...story.events);
102
+ last.status = "observed";
103
+ } else if (
104
+ last &&
105
+ !story.legacy &&
106
+ !last.legacy &&
107
+ story.group &&
108
+ story.group === last.group &&
109
+ story.status === "finished" &&
110
+ last.status === story.status &&
111
+ story.label === last.label
112
+ ) {
113
+ last.events.push(...story.events);
114
+ last.calls++;
115
+ } else grouped.push(story);
116
+ }
117
+ return grouped.reverse().map(({ events: raw, label, calls, status, legacy }) => ({
118
+ key: `activity:${generation}:${raw[0]!.id}`,
119
+ label: legacy && raw.length > 1 ? `${label} (${raw.length} events)` : calls > 1 ? `${label} (×${calls})` : label,
120
+ status: disconnected ? "last-observed" : status,
121
+ elapsed: "",
122
+ briefDetails: [
123
+ label,
124
+ ...(disconnected ? ["Last seen before the dashboard disconnected."] : []),
125
+ ...(status === "failed"
126
+ ? ["Pi reported an error."]
127
+ : status === "Started"
128
+ ? ["Pi reported starting this action. No finish is in these recent events."]
129
+ : []),
130
+ ],
131
+ details: raw.map(
132
+ (event) =>
133
+ `${event.details?.find((line) => line.startsWith("Observed: "))?.slice(10) ?? "Time unavailable"} · ${clean(event.label)}${event.state === "failed" ? " · error" : ""}`,
134
+ ),
135
+ }));
136
+ }
@@ -1,4 +1,5 @@
1
1
  #!/usr/bin/env node
2
+ import type { DashboardAcknowledgment } from "./dashboard-session-client.ts";
2
3
  import { dashboardFile, dashboardTimeline, dashboardSelectedDetail } from "./dashboard-file-cache.ts";
3
4
  /**
4
5
  * `pi-daddy-dashboard` — the view of one ledger or activity timeline plus session model controls.
@@ -11,6 +12,7 @@ import { readFile } from "node:fs/promises";
11
12
  import { resolve } from "node:path";
12
13
  import { pathToFileURL } from "node:url";
13
14
  import { createInterface, emitKeypressEvents, type Key } from "node:readline";
15
+ import { applyOwnerTaskTitles } from "./dashboard-activity.ts";
14
16
  import { parseDashboardLedger } from "./dashboard-projection.ts";
15
17
  import { renderDashboard } from "./dashboard-render.ts";
16
18
  import {
@@ -66,7 +68,7 @@ export interface DashboardFrameOptions {
66
68
  notice?: string;
67
69
  pending?: boolean;
68
70
  connected?: boolean;
69
- acknowledgment?: string;
71
+ acknowledgment?: DashboardAcknowledgment;
70
72
  command?: string;
71
73
  }
72
74
 
@@ -139,6 +141,7 @@ async function compactFrame(options: DashboardFrameOptions): Promise<string> {
139
141
  current: string | undefined,
140
142
  currentStatus: string | undefined;
141
143
  let content: { title: string; text: string } | undefined;
144
+ let governedLedger = false;
142
145
  const aliases = options.activityAliases ?? new ActivityTimelineAliases();
143
146
  if (options.protocol !== undefined && options.protocol !== DASHBOARD_PROTOCOL_VERSION)
144
147
  return renderDashboardScreen({
@@ -164,7 +167,12 @@ async function compactFrame(options: DashboardFrameOptions): Promise<string> {
164
167
  const timeline = options.session?.observation
165
168
  ? { ...parsed, tasks: parsed.tasks.filter((task) => task.rootId === options.session!.activity?.rootId) }
166
169
  : parsed;
167
- items = activityDashboardItems(timeline, aliases, options.now ?? new Date()).map((item) => ({
170
+ items = activityDashboardItems(
171
+ timeline,
172
+ aliases,
173
+ options.now ?? new Date(),
174
+ Boolean(options.session?.observation),
175
+ ).map((item) => ({
168
176
  ...item,
169
177
  timelinePath: path,
170
178
  }));
@@ -188,6 +196,7 @@ async function compactFrame(options: DashboardFrameOptions): Promise<string> {
188
196
  projection.nodes = projection.nodes.filter((node) => admitted.has(node.executionId));
189
197
  }
190
198
  items = ledgerDashboardItems(projection);
199
+ governedLedger = true;
191
200
  if (projection.corrupt.length) problem = `Ledger unavailable: ${projection.corrupt.length} corrupt line(s)`;
192
201
  }
193
202
  } catch (error) {
@@ -206,11 +215,18 @@ async function compactFrame(options: DashboardFrameOptions): Promise<string> {
206
215
  ? await dashboardFile(activity.path)
207
216
  : await readFile(activity.path, "utf8");
208
217
  const parsed = dashboardTimeline(activity.path, text);
218
+ if (governedLedger && options.session?.observation)
219
+ items = applyOwnerTaskTitles(items, parsed.tasks, activity.rootId);
209
220
  const timeline = {
210
221
  ...parsed,
211
222
  tasks: parsed.tasks.filter((task) => activityTaskKey(task.rootId, task.id) === key),
212
223
  };
213
- const item = activityDashboardItems(timeline, aliases, options.now ?? new Date())[0];
224
+ const item = activityDashboardItems(
225
+ timeline,
226
+ aliases,
227
+ options.now ?? new Date(),
228
+ Boolean(options.session?.observation),
229
+ )[0];
214
230
  if (item) {
215
231
  current = item.label;
216
232
  currentStatus = item.status;
@@ -369,9 +385,7 @@ export async function runDashboard(argv = process.argv.slice(2), env: NodeJS.Pro
369
385
  activityAliases: display.aliases,
370
386
  session: connection.state.snapshot ?? connection.state.lastObserved,
371
387
  connected: Boolean(connection.state.snapshot),
372
- acknowledgment: connection.state.acknowledgment
373
- ? `${connection.state.acknowledgment.action}: ${connection.state.acknowledgment.state} · ${connection.state.acknowledgment.effect}`
374
- : undefined,
388
+ acknowledgment: connection.state.acknowledgment,
375
389
  ...(interactive
376
390
  ? {
377
391
  height: process.stdout.rows || 24,