@howaboua/pi-agent-board 0.0.6 → 0.0.7

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # @howaboua/pi-agent-board
2
2
 
3
+ ## 0.0.7
4
+
5
+ - Board settings now open on Enabled with On and Off choices.
6
+ - Board guidance reserves direct messages for assignments and urgent action, regardless of messaging tool; posts do not wake idle agents.
7
+ - Board guidance skips report posts without a new peer-relevant finding, decision, ownership change or blocker.
8
+ - Board guidance keeps distinct topics in focused threads instead of catch-alls.
9
+
3
10
  ## 0.0.6
4
11
 
5
12
  - Requires Node.js 22.19 or newer.
package/README.md CHANGED
@@ -27,7 +27,7 @@ Reload Pi after installation. Ask the agent to post a note to the board, then ru
27
27
  ## Board settings
28
28
 
29
29
  - `/board` opens the viewer.
30
- - `/board settings` offers consolidation, automatic summaries and the global summary model: Luna or Custom.
30
+ - `/board settings` opens on **Enabled** to switch Board on or off. **Scope** selects session, folder or global settings. The panel also offers consolidation, automatic summaries and the global summary model: Luna or Custom.
31
31
  - `/board status` shows the current board and enablement.
32
32
  - `/board on` enables the board for this session.
33
33
  - `/board off` disables it without deleting history.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@howaboua/pi-agent-board",
3
- "version": "0.0.6",
3
+ "version": "0.0.7",
4
4
  "description": "Standalone agent message boards and a read-only browser viewer for Pi",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -54,7 +54,7 @@
54
54
  "@earendil-works/pi-ai": ">=1.1.0",
55
55
  "@earendil-works/pi-coding-agent": ">=1.5.0",
56
56
  "@earendil-works/pi-tui": ">=1.1.0",
57
- "@howaboua/pi-codex-conversion": ">=4.0.10"
57
+ "@howaboua/pi-codex-conversion": ">=5.0.0"
58
58
  },
59
59
  "peerDependenciesMeta": {
60
60
  "@howaboua/pi-codex-conversion": {
@@ -65,6 +65,6 @@
65
65
  "access": "public"
66
66
  },
67
67
  "devDependencies": {
68
- "@howaboua/pi-codex-conversion": "4.0.10"
68
+ "@howaboua/pi-codex-conversion": "5.0.0"
69
69
  }
70
70
  }
@@ -17,8 +17,8 @@ export function boardBriefing(
17
17
  state,
18
18
  member ? "Follow your assigned scope." : "",
19
19
  gpt
20
- ? "Channels=workstreams; threads=topics. Reuse relevant channels; new channel only for distinct coordination need≠task/result announcement. Read≠subscribe; subscribe to threads→replies, channels→new threads."
21
- : "Channels group workstreams, threads group topics. Reuse a relevant channel. Create one only for a distinct coordination need, not task or result announcements. Reading does not subscribe: subscribe to relevant threads for replies, channels for new threads.",
20
+ ? "Channels=workstreams; threads=focused topics, not catch-alls. Reuse matching threads/channels; distinct topics→separate threads, distinct coordination needs→new channels, not task/results. Read≠subscribe; threads→replies, channels→new threads."
21
+ : "Channels group workstreams; threads cover focused topics, not catch-alls. Reuse matching threads and channels; separate distinct topics into threads. Create channels for distinct coordination needs, not task or result announcements. Reading does not subscribe: subscribe to threads for replies, channels for new threads.",
22
22
  ]
23
23
  .filter(Boolean)
24
24
  .join(" ");
@@ -33,7 +33,7 @@ export async function openBoardSettings(
33
33
  return;
34
34
  }
35
35
  let scope: BoardScope = "session";
36
- let selected = "scope";
36
+ let selected = "enabled";
37
37
  const sessionId = ctx.sessionManager.getSessionId();
38
38
  while (true) {
39
39
  try {
@@ -41,18 +41,18 @@ export async function openBoardSettings(
41
41
  const action = await ctx.ui.custom<Action>((tui, theme, _kb, done) => {
42
42
  const list = new SettingsList(
43
43
  [
44
+ {
45
+ id: "enabled",
46
+ label: "Enabled",
47
+ currentValue: board.enabled(ctx) ? "On" : "Off",
48
+ values: ["Off", "On"],
49
+ },
44
50
  {
45
51
  id: "scope",
46
52
  label: "Scope",
47
53
  currentValue: scope,
48
54
  values: ["session", "folder", "global"],
49
55
  },
50
- {
51
- id: "enabled",
52
- label: "Board",
53
- currentValue: board.enabled(ctx) ? "on" : "off",
54
- values: ["off", "on"],
55
- },
56
56
  {
57
57
  id: "automatic",
58
58
  label: "Automatic summaries",
@@ -106,6 +106,9 @@ export async function openBoardSettings(
106
106
  ...wrap(
107
107
  `${tabs ? "Tab switch tab · " : ""}↑/↓ select · Enter/Space change · Esc close`,
108
108
  ).map((line) => theme.fg("dim", line)),
109
+ ...wrap("Settings saved immediately").map((line) =>
110
+ theme.fg("dim", line),
111
+ ),
109
112
  rule,
110
113
  ].map((line) => truncateToWidth(line, width, ""));
111
114
  },
@@ -139,7 +142,7 @@ export async function openBoardSettings(
139
142
  if (binding(ctx).upstream)
140
143
  throw new Error("Change Board settings in the owning root session");
141
144
  if (action.id === "enabled")
142
- await board.setSetting(ctx, scope, action.value === "on");
145
+ await board.setSetting(ctx, scope, action.value === "On");
143
146
  else if (action.id === "automatic")
144
147
  board.setAutomaticSummaries(ctx, action.value === "on");
145
148
  else if (action.id === "model") {
package/src/guidance.ts CHANGED
@@ -18,38 +18,40 @@ export interface CommsFeature extends FeatureSettings {
18
18
  function communicationGuidance(
19
19
  notes: boolean,
20
20
  board: boolean,
21
- agents: boolean,
22
21
  gpt = false,
23
22
  ): string {
24
23
  return [
25
24
  board
26
25
  ? gpt
27
- ? "Board→peer findings/discovery, ownership/decisions/blockers affecting peers. Self-contained detail welcome; direct discovery≠parent relay. Existing thread replies; known shared peers→link≠repeat. No ack/status spam/duplicate completion reports."
28
- : "Board: share findings, discoveries, ownership, decisions and blockers that change peers' work. Self-contained detail lets peers read directly, without a parent relay. Reply in existing threads. Link rather than repeat for peers with known Board access. Skip acknowledgements, routine status and duplicate completion reports."
26
+ ? "Board→new peer-work findings/decisions/ownership/blockers only; no change→no post. Peers read directly; no parent relay. No idle wake; active subscribers may be interrupted."
27
+ : "Board: post only findings, decisions, ownership changes or blockers that change peers' work. Peers read posts directly; do not relay them through the parent. Posts do not wake idle agents but may interrupt active subscribers."
29
28
  : "",
30
29
  notes
31
30
  ? [
31
+ gpt
32
+ ? "Notes writes don't wake peers."
33
+ : "Notes writes do not wake peers.",
32
34
  board
33
35
  ? gpt
34
- ? "Notes→current work/progress/recovery + Board references."
35
- : "Notes: current work, progress and recovery, with Board references."
36
+ ? "Notes→recovery; link Board evidence."
37
+ : "Notes holds recovery checkpoints; link Board evidence."
36
38
  : "",
37
39
  gpt
38
- ? "Keep Notes checkpoints. Known recipient access→brief outcome/blocker + path; recipient READS checkpoint≠request full report."
39
- : "Keep checkpoints in Notes. When the recipient is known to have access, return a brief outcome or blocker plus its path. The recipient reads the checkpoint for details rather than asking for a full report.",
40
+ ? "Known recipient Notes access→brief outcome/blocker + checkpoint path; recipient reads checkpoint instead of requesting its contents."
41
+ : "With known recipient Notes access, return a brief outcome or blocker plus the checkpoint path; the recipient reads the checkpoint instead of requesting its contents.",
40
42
  ]
41
43
  .filter(Boolean)
42
44
  .join(" ")
43
45
  : "",
44
46
  notes || board
45
47
  ? gpt
46
- ? `${notes && board ? "Notes/Board" : notes ? "Notes" : "Board"} available here≠recipient access. Unknown/unshared access→self-contained actions taken/findings/unresolved state, not bare references.`
47
- : `${notes && board ? "Notes and Board" : notes ? "Notes" : "Board"} availability here does not establish recipient access. If access is unknown or unshared, send a self-contained account of what you did, found and left unresolved, not just private references.`
48
+ ? `${notes && board ? "Notes/Board" : notes ? "Notes" : "Board"} available here≠recipient access. Known access→link≠repeat; otherwise self-contained actions/findings/unresolved state.`
49
+ : `${notes && board ? "Notes and Board" : notes ? "Notes" : "Board"} availability here does not establish recipient access. Link rather than repeat when access is known; otherwise give a self-contained account of actions, findings and unresolved state.`
48
50
  : "",
49
- agents && notes && board
51
+ notes || board
50
52
  ? gpt
51
- ? "agents→assignments/urgent action≠default peer knowledge bus."
52
- : "Use agents for assignments and urgent action, not as the default peer knowledge relay."
53
+ ? "Direct messages→assignments or urgent action, not status or courtesy updates."
54
+ : "Use direct messages for assignments or urgent action, not status or courtesy updates."
53
55
  : "",
54
56
  ]
55
57
  .filter(Boolean)
@@ -73,11 +75,9 @@ export function registerCommunicationGuidance(
73
75
  (ctx) => Boolean(notes?.enabled(ctx) || board?.enabled(ctx)),
74
76
  async (ctx, windowId, messages) => {
75
77
  // Feature owners supply enablement independently of provider declarations.
76
- // Shepherdr keeps agents active, including as a nested Code/Notebook tool.
77
78
  const capabilities = [
78
79
  notes?.enabled(ctx) ?? false,
79
80
  board?.enabled(ctx) ?? false,
80
- pi.getActiveTools().includes("agents"),
81
81
  Boolean(notes?.gptPromptMode() || board?.gptPromptMode()),
82
82
  ] as const;
83
83
  const routing = communicationGuidance(...capabilities);