@agentrica/mcp 0.3.1 → 0.3.2

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/README.en.md CHANGED
@@ -24,7 +24,7 @@ You need Node 22 or later, with npm.
24
24
  **Claude Code**, from your project folder:
25
25
 
26
26
  ```sh
27
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1
27
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2
28
28
  ```
29
29
 
30
30
  On first start npx downloads the package from npm. The version stays the one you set until you change it: role updates do not arrive unless you choose them.
@@ -36,7 +36,7 @@ On first start npx downloads the package from npm. The version stays the one you
36
36
  "mcpServers": {
37
37
  "agentrica": {
38
38
  "command": "npx",
39
- "args": ["-y", "@agentrica/mcp@0.3.1"]
39
+ "args": ["-y", "@agentrica/mcp@0.3.2"]
40
40
  }
41
41
  }
42
42
  }
@@ -45,7 +45,7 @@ On first start npx downloads the package from npm. The version stays the one you
45
45
  **Least privilege (recommended).** Install the package in its own folder and start it with Node's permission model: the server can only read that folder, and Node blocks file writes, network connections and child processes. The server needs none of them, so it works the same; the permissions limit the damage of any future defect.
46
46
 
47
47
  ```sh
48
- npm install -g --ignore-scripts @agentrica/mcp@0.3.1
48
+ npm install -g --ignore-scripts @agentrica/mcp@0.3.2
49
49
  npm root -g
50
50
  ```
51
51
 
@@ -72,7 +72,7 @@ Put the task in quotes: Claude Code splits arguments on spaces.
72
72
  **Squad.** With `--agents` the server loads only the agents you list: agent ids and department codes, comma-separated, case-insensitive. For example the whole software department plus the accessibility agent:
73
73
 
74
74
  ```sh
75
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1 --agents aisa,aiwda-08
75
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2 --agents aisa,aiwda-08
76
76
  ```
77
77
 
78
78
  The command menu shows only the squad's prompts, and `elenca_agenti` and `agente` see only those agents too. Without `--agents` all 56 agents are available. An unknown id or code stops the server with a message naming it, in the client's logs. In Claude Code prompts do not enter the model's context (we checked with `/context`): a squad makes the menu shorter, it does not save tokens.
@@ -93,14 +93,13 @@ Number 01 in each department is the director: it coordinates the specialists and
93
93
  With `--panel` the server also opens a page on your computer where you follow the project and make the choices the agent asks you for, instead of answering in the terminal:
94
94
 
95
95
  ```sh
96
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1 --panel
96
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2 --panel
97
97
  ```
98
98
 
99
- Then ask the agent to open the panel (`open_panel` tool): the page opens in your browser. It shows:
99
+ Then ask the agent to open the panel (`open_panel` tool): the page opens in your browser. It has three pages, with a menu at the top counting pending choices and findings:
100
100
 
101
- - **Da decidere** (to decide): pending choices, with options and reasons; your answer, with an optional note, goes back to the agent;
102
- - **Agenti in uso** (agents in use): the Agentrica agents called in this session, with the start of the task;
103
- - **Fasi** (phases): the project phases, the open phase with backlog and acceptance criteria;
101
+ - **Sessione** (session): pending choices (*Da decidere*, to decide), with options and reasons, whose answer, with an optional note, goes back to the agent; next to them, the Agentrica agents called in this session (*Agenti in uso*, agents in use), with the start of the task;
102
+ - **Piano** (plan): the open phase with backlog and acceptance criteria, and all project phases;
104
103
  - **Rilievi** (findings): open findings from phases and audits, by priority and department.
105
104
 
106
105
  With the panel the model has two more tools:
@@ -138,6 +137,7 @@ The agents' text comes from the `agents/` files of the installed version. To upd
138
137
 
139
138
  ## Versions
140
139
 
140
+ - **0.3.2**: the panel has three pages (Sessione, Piano, Rilievi) with a menu counting pending choices and findings; agents and server behaviour unchanged.
141
141
  - **0.3.1**: the panel hides closed findings and counts new files separately; the `agente` tool only accepts department codes in ids; common rules with a shared severity scale (P0–P3) and a scale for the software department.
142
142
  - **0.3.0**: local panel with `--panel`: phases, backlog, findings, agents in use and choices made from the page (`open_panel` and `ask_user` tools). Without `--panel` nothing changes.
143
143
  - **0.2.1**: name `io.github.flgisimone/agentrica` for the official MCP registry; agents and behaviour unchanged.
package/README.md CHANGED
@@ -22,7 +22,7 @@ Serve Node 22 o successivo, con npm.
22
22
  **Claude Code**, dalla cartella del tuo progetto:
23
23
 
24
24
  ```sh
25
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1
25
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2
26
26
  ```
27
27
 
28
28
  Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicata finché non la cambi tu: un aggiornamento dei ruoli non arriva senza che tu lo scelga.
@@ -34,7 +34,7 @@ Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicat
34
34
  "mcpServers": {
35
35
  "agentrica": {
36
36
  "command": "npx",
37
- "args": ["-y", "@agentrica/mcp@0.3.1"]
37
+ "args": ["-y", "@agentrica/mcp@0.3.2"]
38
38
  }
39
39
  }
40
40
  }
@@ -43,7 +43,7 @@ Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicat
43
43
  **Permessi minimi (consigliato).** Installa il pacchetto in una cartella sua e avvialo con il permission model di Node: il server può solo leggere quella cartella, e Node blocca scritture su file, connessioni di rete e processi figli. Il server non ne ha bisogno, quindi funziona uguale; i permessi limitano i danni di un eventuale difetto futuro.
44
44
 
45
45
  ```sh
46
- npm install -g --ignore-scripts @agentrica/mcp@0.3.1
46
+ npm install -g --ignore-scripts @agentrica/mcp@0.3.2
47
47
  npm root -g
48
48
  ```
49
49
 
@@ -70,7 +70,7 @@ Metti il compito fra virgolette: Claude Code separa gli argomenti con gli spazi.
70
70
  **Squadra.** Con `--agents` il server carica solo gli agenti che indichi: id di agenti e sigle di reparti, separati da virgole, senza distinguere maiuscole. Per esempio tutto il reparto software più l'agente dell'accessibilità:
71
71
 
72
72
  ```sh
73
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1 --agents aisa,aiwda-08
73
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2 --agents aisa,aiwda-08
74
74
  ```
75
75
 
76
76
  Nel menu dei comandi restano solo i prompt della squadra, e anche `elenca_agenti` e `agente` vedono solo quelli. Senza `--agents` ci sono tutti i 56 agenti. Un id o una sigla sconosciuti fermano il server con un messaggio che li nomina, nei log del client. In Claude Code i prompt non entrano nel contesto del modello (lo abbiamo verificato con `/context`): la squadra rende il menu più corto, ma non fa risparmiare token.
@@ -93,14 +93,13 @@ I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli
93
93
  Con `--panel` il server apre anche una pagina sul tuo computer da cui segui il progetto e prendi le scelte che l'agente ti chiede, invece di rispondere nel terminale:
94
94
 
95
95
  ```sh
96
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.1 --panel
96
+ claude mcp add agentrica -- npx -y @agentrica/mcp@0.3.2 --panel
97
97
  ```
98
98
 
99
- Poi chiedi all'agente di aprire il pannello (tool `open_panel`): la pagina si apre nel browser. Mostra:
99
+ Poi chiedi all'agente di aprire il pannello (tool `open_panel`): la pagina si apre nel browser. Ha tre pagine, con il menu in alto che conta le scelte in attesa e i rilievi:
100
100
 
101
- - **Da decidere**: le scelte in attesa, con le opzioni e le motivazioni; la risposta, con una nota facoltativa, torna all'agente;
102
- - **Agenti in uso**: gli agenti di Agentrica chiamati in questa sessione, con l'inizio del compito;
103
- - **Fasi**: le fasi del progetto, la fase aperta con backlog e criteri di accettazione;
101
+ - **Sessione**: le scelte da prendere (*Da decidere*), con le opzioni e le motivazioni, la cui risposta, con una nota facoltativa, torna all'agente; accanto, gli agenti di Agentrica chiamati in questa sessione (*Agenti in uso*), con l'inizio del compito;
102
+ - **Piano**: la fase in corso con backlog e criteri di accettazione, e tutte le fasi del progetto;
104
103
  - **Rilievi**: i rilievi aperti delle fasi e quelli degli audit, per priorità e reparto.
105
104
 
106
105
  Con il pannello il modello ha due tool in più:
@@ -138,6 +137,7 @@ Il testo degli agenti viene dai file di `agents/` della versione installata. Per
138
137
 
139
138
  ## Versioni
140
139
 
140
+ - **0.3.2**: pannello in tre pagine (Sessione, Piano, Rilievi) con menu e contatori delle scelte in attesa e dei rilievi; agenti e comportamento del server invariati.
141
141
  - **0.3.1**: pannello che nasconde i rilievi chiusi e conta a parte i file nuovi; id del tool `agente` limitato alle sigle dei reparti; regole comuni con una scala di gravità condivisa (P0–P3) e una scala per il reparto software.
142
142
  - **0.3.0**: pannello locale con `--panel`: fasi, backlog, rilievi, agenti in uso e scelte da prendere dalla pagina (tool `open_panel` e `ask_user`). Senza `--panel` nulla cambia.
143
143
  - **0.2.1**: nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale; agenti e comportamento invariati.
@@ -160,6 +160,7 @@ function renderPhases({ project }) {
160
160
  ? [
161
161
  el("h3", {}, inline(open.title), ` — ${open.status}`),
162
162
  open.goal && el("p", { class: "goal" }, inline(open.goal)),
163
+ el("h3", {}, "Backlog"),
163
164
  open.tasks.length
164
165
  ? table(
165
166
  ["Task", "Descrizione", "Priorità", "Stato"],
@@ -178,15 +179,12 @@ function renderPhases({ project }) {
178
179
  open.criteria.length > 0 && el("h3", {}, "Criteri di accettazione"),
179
180
  open.criteria.length > 0 && el("ul", { class: "criteria" }, open.criteria.map((c) => el("li", {}, inline(c)))),
180
181
  ]
181
- : []),
182
+ : [empty("Nessuna fase in corso: tutte le fasi sono completate, sospese o da aprire.")]),
182
183
  );
183
- // Aperto solo senza una fase in corso: altrimenti la tabella completa spinge giù i rilievi.
184
- const all = $("phases").querySelector("details");
185
- const wasOpen = all ? all.open : !open;
186
184
  $("phases").replaceChildren(
187
185
  project.phases.length === 0
188
186
  ? empty("Nessuna fase trovata in plan/README.md.")
189
- : el("details", { open: wasOpen }, el("summary", {}, `Tutte le fasi (${project.phases.length})`), table(
187
+ : table(
190
188
  ["Fase", "Contenuto", "Stato"],
191
189
  project.phases.map((p) =>
192
190
  el(
@@ -197,7 +195,7 @@ function renderPhases({ project }) {
197
195
  el("td", {}, p.status),
198
196
  ),
199
197
  ),
200
- )),
198
+ ),
201
199
  );
202
200
  }
203
201
 
@@ -249,9 +247,34 @@ function renderFindings({ project }) {
249
247
  );
250
248
  }
251
249
 
250
+ function renderCounts({ project, questions }) {
251
+ const waiting = questions.length;
252
+ const findings = project.findings.length;
253
+ $("count-sessione").textContent = waiting ? String(waiting) : "";
254
+ $("count-rilievi").textContent = String(findings);
255
+ // Il solo numero non dice cosa conta: il nome completo è per i lettori di schermo.
256
+ $("count-sessione").parentElement.setAttribute("aria-label", waiting ? `Sessione, ${waiting} da decidere` : "Sessione");
257
+ $("count-rilievi").parentElement.setAttribute("aria-label", `Rilievi, ${findings} aperti`);
258
+ }
259
+
260
+ // Una vista per volta, scelta dall'hash: avanti e indietro del browser funzionano senza toccare il server.
261
+ const VIEWS = ["sessione", "piano", "rilievi"];
262
+
263
+ function showView(moveFocus) {
264
+ const name = location.hash.slice(1);
265
+ const current = VIEWS.includes(name) ? name : VIEWS[0];
266
+ for (const view of document.querySelectorAll(".view")) view.hidden = view.dataset.view !== current;
267
+ for (const tab of document.querySelectorAll(".tabs a")) {
268
+ if (tab.dataset.view === current) tab.setAttribute("aria-current", "page");
269
+ else tab.removeAttribute("aria-current");
270
+ }
271
+ if (moveFocus) document.querySelector(`#view-${current} h1`).focus();
272
+ }
273
+
252
274
  function render() {
253
275
  if (!state) return;
254
276
  renderHeader(state);
277
+ renderCounts(state);
255
278
  renderQuestions(state);
256
279
  renderActivity(state);
257
280
  renderPhases(state);
@@ -281,6 +304,8 @@ function connect() {
281
304
  };
282
305
  }
283
306
 
307
+ window.addEventListener("hashchange", () => showView(true));
308
+ showView(false);
284
309
  connect();
285
310
  refresh();
286
311
  setInterval(() => document.visibilityState === "visible" && refresh(), REFRESH_MS);
@@ -11,34 +11,54 @@
11
11
  <body>
12
12
  <header class="top">
13
13
  <div class="wrap top-row">
14
- <h1 class="brand">Agentrica <span aria-hidden="true">·</span> pannello</h1>
14
+ <p class="brand">Agentrica <span aria-hidden="true">·</span> pannello</p>
15
15
  <p class="meta" id="project">Caricamento…</p>
16
16
  <p class="link" id="link" role="status">Collegamento in corso…</p>
17
17
  </div>
18
+ <nav class="wrap tabs" aria-label="Sezioni del pannello">
19
+ <a href="#sessione" data-view="sessione">Sessione <span class="count" id="count-sessione"></span></a>
20
+ <a href="#piano" data-view="piano">Piano</a>
21
+ <a href="#rilievi" data-view="rilievi">Rilievi <span class="count" id="count-rilievi"></span></a>
22
+ </nav>
18
23
  </header>
24
+ <div id="announce" class="sr-only" aria-live="polite"></div>
19
25
  <main class="wrap">
20
26
  <p class="problems" id="problems" hidden></p>
21
- <div class="live">
22
- <section aria-labelledby="h-decide" class="card">
23
- <h2 id="h-decide">Da decidere</h2>
24
- <div id="announce" class="sr-only" aria-live="polite"></div>
25
- <div id="questions"></div>
27
+
28
+ <div id="view-sessione" class="view" data-view="sessione">
29
+ <h1 class="sr-only" tabindex="-1">Sessione</h1>
30
+ <div class="live">
31
+ <section aria-labelledby="h-decide" class="card">
32
+ <h2 id="h-decide">Da decidere</h2>
33
+ <div id="questions"></div>
34
+ </section>
35
+ <section aria-labelledby="h-agents" class="card">
36
+ <h2 id="h-agents">Agenti in uso</h2>
37
+ <div id="activity"></div>
38
+ </section>
39
+ </div>
40
+ </div>
41
+
42
+ <div id="view-piano" class="view" data-view="piano" hidden>
43
+ <h1 class="sr-only" tabindex="-1">Piano</h1>
44
+ <section aria-labelledby="h-open" class="card">
45
+ <h2 id="h-open">Fase in corso</h2>
46
+ <div id="open-phase"></div>
47
+ </section>
48
+ <section aria-labelledby="h-phases" class="card">
49
+ <h2 id="h-phases">Tutte le fasi</h2>
50
+ <div id="phases"></div>
26
51
  </section>
27
- <section aria-labelledby="h-agents" class="card">
28
- <h2 id="h-agents">Agenti in uso</h2>
29
- <div id="activity"></div>
52
+ </div>
53
+
54
+ <div id="view-rilievi" class="view" data-view="rilievi" hidden>
55
+ <h1 class="sr-only" tabindex="-1">Rilievi</h1>
56
+ <section aria-labelledby="h-findings" class="card">
57
+ <h2 id="h-findings">Rilievi aperti</h2>
58
+ <div id="filters" class="filters" role="group" aria-label="Filtra per reparto"></div>
59
+ <div id="findings"></div>
30
60
  </section>
31
61
  </div>
32
- <section aria-labelledby="h-phases" class="card">
33
- <h2 id="h-phases">Fasi</h2>
34
- <div id="open-phase"></div>
35
- <div id="phases"></div>
36
- </section>
37
- <section aria-labelledby="h-findings" class="card">
38
- <h2 id="h-findings">Rilievi</h2>
39
- <div id="filters" class="filters" role="group" aria-label="Filtra per reparto"></div>
40
- <div id="findings"></div>
41
- </section>
42
62
  </main>
43
63
  </body>
44
64
  </html>
@@ -41,7 +41,7 @@ code { background: var(--secondary); border-radius: 4px; padding: 0 0.25em; }
41
41
  .wrap { max-width: 1200px; margin: 0 auto; padding: 0 16px; }
42
42
 
43
43
  .top { border-bottom: 1px solid var(--border); background: var(--card); }
44
- .top-row { display: flex; flex-wrap: wrap; gap: 4px 24px; align-items: baseline; padding-block: 12px; }
44
+ .top-row { display: flex; flex-wrap: wrap; gap: 4px 24px; align-items: baseline; padding-block: 12px 4px; }
45
45
  .top p { margin: 0; }
46
46
  .brand { font-size: 1rem; font-weight: 700; margin: 0; }
47
47
  .meta, .link { color: var(--muted-foreground); }
@@ -49,7 +49,17 @@ code { background: var(--secondary); border-radius: 4px; padding: 0 0.25em; }
49
49
  .link[data-state="ok"]::before { content: "● "; color: var(--aiwda); }
50
50
  .link[data-state="off"] { color: var(--destructive); }
51
51
 
52
- main { display: grid; gap: 16px; padding-block: 16px 48px; }
52
+ .tabs { display: flex; gap: 4px; overflow-x: auto; }
53
+ .tabs a { color: var(--muted-foreground); text-decoration: none; padding: 10px 14px 8px; border-bottom: 2px solid transparent; white-space: nowrap; font-weight: 600; }
54
+ .tabs a:hover { color: var(--foreground); }
55
+ .tabs a[aria-current="page"] { color: var(--foreground); border-bottom-color: var(--aisa); }
56
+ .count:not(:empty) { display: inline-block; min-width: 1.6em; margin-left: 4px; padding: 0 6px; border-radius: 999px; background: var(--secondary); color: var(--foreground); font-size: 0.8rem; text-align: center; }
57
+ #count-sessione:not(:empty) { background: var(--aibpd); color: var(--background); }
58
+
59
+ main.wrap { display: grid; gap: 16px; padding-block: 16px 48px; }
60
+ .view { display: grid; gap: 16px; }
61
+ .view[hidden] { display: none; }
62
+ h1:focus { outline: none; }
53
63
  .live { display: grid; gap: 16px; }
54
64
  @media (min-width: 960px) { .live { grid-template-columns: 3fr 2fr; align-items: start; } }
55
65
 
@@ -89,6 +99,7 @@ th, td { text-align: left; padding: 6px 10px 6px 0; border-top: 1px solid var(--
89
99
  thead th { border-top: 0; color: var(--muted-foreground); font-weight: 600; font-size: 0.9rem; }
90
100
  tr.current td { color: var(--foreground); font-weight: 600; }
91
101
  .status-done { color: var(--aiwda); }
102
+ th.mono, td:last-child { white-space: nowrap; }
92
103
  .goal { margin: 0 0 8px; }
93
104
  ul.criteria { margin: 0; padding-left: 1.2em; }
94
105
 
@@ -1,5 +1,5 @@
1
1
  /** Versione del server, uguale a quella di package.json (lo controlla prompt.test.ts). */
2
- export const VERSION = "0.3.1";
2
+ export const VERSION = "0.3.2";
3
3
  /** Cerca un agente per id, senza distinguere maiuscole e minuscole («aisa-02» o «AISA-02»). */
4
4
  export function findAgent(catalog, id) {
5
5
  const wanted = id.toUpperCase();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentrica/mcp",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "mcpName": "io.github.flgisimone/agentrica",
5
5
  "description": "I 56 agenti IA di Agentrica come server MCP locale (stdio): un prompt per agente e due tool in sola lettura.",
6
6
  "license": "MIT",