kushi-agents 4.2.3 → 4.3.0

package/.github/copilot-instructions.kushi.md

@@ -2,9 +2,9 @@
 
 This workspace has [Kushi](https://gim-home.github.io/kushi/) installed under `.kushi/`. Kushi captures multi-source project evidence (Email, Teams, OneNote, SharePoint, Meetings, CRM, ADO) via **WorkIQ** and answers cited questions over the captured evidence.
 
-### Routing — no `@Kushi` prefix required
+### Routing — verbs are prompts
 
-When the user types any of the following verbs followed by a project name, route to the corresponding Kushi prompt in `.kushi/prompts/` (no `@Kushi` needed):
+Every Kushi verb is a **prompt file** in `.kushi/prompts/<verb>.prompt.md` with `agent: kushi` in its frontmatter. When the user types one of the verbs below (with or without `@Kushi`), open the prompt and execute its instructions — do **not** shell out to `npx kushi-agents <verb>`. The `kushi-agents` npm package is the installer that put `.kushi/` on disk; it does not run verbs.
 
 | Verb                       | Prompt to run    |
 | -------------------------- | ---------------- |
@@ -21,6 +21,8 @@ When the user types any of the following verbs followed by a project name, route
 
 Project Q&A also auto-dispatches when the user names a known project under the engagement root **and** asks a question about it — no prefix needed.
 
+If a prompt file is missing for a verb the user typed, tell them "the `<verb>` prompt isn't installed in this profile" — do not shell out to reinstall. Re-installing is only appropriate when the user **explicitly** says "install kushi", "upgrade kushi", or "reinstall kushi".
+
 ### Hard rules (enforced by Kushi skills)
 
 - **WorkIQ-first** for all M365 sources. `m365_*` / Microsoft Graph calls are only allowed as a classified fallback after a documented WorkIQ failure.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kushi-agents",
-  "version": "4.2.3",
+  "version": "4.3.0",
   "description": "Install Kushi — multi-source project evidence agent with snapshot+stream capture across Email, Teams, OneNote, SharePoint, Meetings, CRM, ADO. WorkIQ-only for M365 sources (Graph / m365_* FORBIDDEN as fallbacks; user-paste is first-class). Host-agnostic.",
   "type": "module",
   "bin": {

package/plugin/agents/kushi.agent.md

@@ -1,11 +1,14 @@
 ---
+name: Kushi
 description: "Kushi — multi-source project evidence + Q&A agent. Snapshot + stream capture across Email, Teams, OneNote, SharePoint, Meetings, CRM, ADO; plus read-only natural-language Q&A over the captured evidence. WorkIQ-first for capture, citation-only for answers. Host-agnostic. USE WHEN the user says any of: PRODUCER VERBS — \"bootstrap a new project\", \"set up project evidence for <X>\", \"add me to project <X>\", \"add contributor to <X>\", \"refresh <X>\", \"do it all for <X>\", \"weekly extract for <X>\", \"regenerate state for <X>\", \"consolidate <X>\", \"status of <X>\"; OR Q&A — the message names a known project (any subfolder under the engagement root) AND asks a question about it (\"what is …\", \"what's the MACC for <X>\", \"who is the EM on <X>\", \"status of <X>\", \"summarize <X>\", \"what was decided about <X>\", \"what's in the deck for <X>\", \"what action items for <X>\", \"<project-name> + <topic>\")."
-tools: ["*"]
+argument-hint: "Name a project (e.g. 'bootstrap HCA', 'refresh AGCO last 14 days', 'ask HCA what's the MACC?'). Kushi routes to the right verb prompt — never run `npx kushi-agents <verb>` in the terminal."
+tools:
+  [vscode/vscodeAPI, execute/getTerminalOutput, execute/runInTerminal, read/readFile, read/terminalSelection, read/terminalLastCommand, agent, edit, search, web, browser, 'workiq/*', 'github/*']
 ---
 
 # @Kushi — Project Evidence Orchestrator
 
-Kushi is a multi-source evidence + state agent for consulting / engineering engagements. It captures **snapshots** (current state of entities) and **streams** (timestamped events) from Email, Teams, OneNote, SharePoint, Meetings, CRM, and ADO, and renders an outcome-based **State** view.
+Kushi is a multi-source evidence + state agentfor consulting / engineering engagements. It captures **snapshots** (current state of entities) and **streams** (timestamped events) from Email, Teams, OneNote, SharePoint, Meetings, CRM, and ADO, and renders an outcome-based **State** view.
 
 ## Install profiles
 

package/plugin/prompts/aggregate.prompt.md

@@ -1,7 +1,18 @@
----
-description: "Aggregate (pull + consolidate) without building State/."
----
-
+---
+name: aggregate
+description: "Aggregate (pull + consolidate) without building State/."
+argument-hint: "Project name (engagement folder, fuzzy-matched); optional window"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, execute/getTerminalOutput, 'workiq/*']
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:window:Optional window — last N days, since YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD (default 7 days)}
+```
+
 # Aggregate
 
 Run `aggregate-project` for the named project.

package/plugin/prompts/apply-ado.prompt.md

@@ -1,8 +1,17 @@
----
-name: apply-ado
-description: Apply approved ADO updates from a proposed.md (gated). Currently a preview-stub — writes a planned.jsonl, no real ADO calls yet.
----
-
+---
+name: apply-ado
+description: "Apply approved ADO updates from a proposed.md (gated). Currently a preview-stub — writes a planned.jsonl, no real ADO calls yet."
+argument-hint: "Project name; runs in dry-mode (writes planned.jsonl, no ADO calls)"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, 'github/*']
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
+
 # /apply-ado
 
 Route to `@Kushi apply ado <project>`.

package/plugin/prompts/ask.prompt.md

@@ -1,10 +1,20 @@
 ---
 name: ask
-description: Read-only Q&A over a bootstrapped project's State/, Evidence/, and snapshot/ files. Cited; no source pulls; no outbound. Auto-routes when you name a project + ask a question.
+description: "Read-only Q&A over a bootstrapped project's State/, Evidence/, and snapshot/ files. Cited; no source pulls; no outbound. Auto-routes when you name a project + ask a question."
+argument-hint: "Project name + a question about it"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
 ---
 
-# /ask
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:question:Your question, e.g. ''what is the MACC?''}
+```
 
+# /ask
+
 Route to `@Kushi ask <project> <question>`.
 
 Loads the cheapest set of files needed to answer (`State/<topic>.md` first, then latest `Evidence/<alias>/_Consolidated/`, then per-source weekly files, then `external-context/`, then `<project>/SharePoint/snapshot/files/`), emits inline `[source: <alias>/<folder>/<file> · YYYY-MM-DD]` citations, warns if the relevant source is older than `chat.freshness_warn_days` (default 14), and ends with a Confidence line.

package/plugin/prompts/bootstrap.prompt.md

@@ -1,10 +1,20 @@
 ---
 name: bootstrap
-description: First-time setup for a new project — scaffold folders, lay configs side-by-side, do an initial 30-day pull, build State.
+description: "First-time setup for a new project — scaffold folders, lay configs side-by-side, do an initial 30-day pull, build State."
+argument-hint: "Project name (fuzzy-matched under engagement-root); optional initial pull window"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, execute/getTerminalOutput, 'workiq/*']
 ---
 
-# /bootstrap
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:window:Optional initial pull window — last N days, since YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD (default 30 days)}
+```
 
+# /bootstrap
+
 Route to `@Kushi bootstrap <project>`.
 
 Inputs the agent will resolve:

package/plugin/prompts/consolidate.prompt.md

@@ -1,10 +1,20 @@
 ---
 name: consolidate
-description: Merge all contributors' weekly streams into _Consolidated/ for a given window.
+description: "Merge all contributors' weekly streams into _Consolidated/ for a given window."
+argument-hint: "Project name; optional window"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, execute/getTerminalOutput, 'workiq/*']
 ---
 
-# /consolidate
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:window:Optional window — last N days, since YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD (default 7 days)}
+```
 
+# /consolidate
+
 Route to `@Kushi consolidate <project> <window>`.
 
 Default window: `last 7 days`.

package/plugin/prompts/fde-intake.prompt.md

@@ -1,8 +1,17 @@
----
-name: fde-intake
-description: Author or update the FDE Intake document — first artifact in an FDE engagement. Answers the 6 canonical FDE Intake questions, grounded in project Evidence + the FDE reference pack.
----
-
+---
+name: fde-intake
+description: "Author or update the FDE Intake document — first artifact in an FDE engagement. Answers the 6 canonical FDE Intake questions, grounded in project Evidence + the FDE reference pack."
+argument-hint: "Project name; authors or updates FDE Intake at Reports/00-FDE-Intake-<project>.md"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
+
 # /fde-intake
 
 Route to `@Kushi fde-intake <project>`.

package/plugin/prompts/fde-report.prompt.md

@@ -1,8 +1,18 @@
----
-name: fde-report
-description: Generate an FDE-shaped engagement report in one of five shapes (weekly default / short / long / fitness / stage-readiness), grounded in project Evidence + the FDE reference pack. Read-only; no outbound.
----
-
+---
+name: fde-report
+description: "Generate an FDE-shaped engagement report in one of five shapes (weekly default / short / long / fitness / stage-readiness), grounded in project Evidence + the FDE reference pack. Read-only; no outbound."
+argument-hint: "Project name; optional shape (weekly|short|long|fitness|stage-readiness, default weekly)"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:shape:Optional report shape — weekly (default), short, long, fitness, or stage-readiness}
+```
+
 # /fde-report
 
 Route to `@Kushi fde-report <project> [shape]`.

package/plugin/prompts/fde-triage.prompt.md

@@ -1,8 +1,17 @@
----
-name: fde-triage
-description: Produce the full FDE Triage bundle — 7 companion files (analysis, fitness, risk, 6Q, mobilization readiness, executive readout, global reuse, validation warnings) at <project>/Reports/triage/<YYYY-MM-DD>/.
----
-
+---
+name: fde-triage
+description: "Produce the full FDE Triage bundle — 7 companion files (analysis, fitness, risk, 6Q, mobilization readiness, executive readout, global reuse, validation warnings) at <project>/Reports/triage/<YYYY-MM-DD>/."
+argument-hint: "Project name; produces 7-file triage bundle at Reports/triage/<YYYY-MM-DD>/"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
+
 # /fde-triage
 
 Route to `@Kushi fde-triage <project>`.

package/plugin/prompts/propose-ado.prompt.md

@@ -1,8 +1,17 @@
----
-name: propose-ado
-description: Read-only ADO update proposal — generate proposed.md from the latest consolidated evidence. NO writes to ADO.
----
-
+---
+name: propose-ado
+description: "Read-only ADO update proposal — generate proposed.md from the latest consolidated evidence. NO writes to ADO."
+argument-hint: "Project name; read-only ADO proposal preview"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, 'github/*']
+---
+
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
+
 # /propose-ado
 
 Route to `@Kushi propose ado <project>`.

package/plugin/prompts/refresh.prompt.md

@@ -1,10 +1,20 @@
 ---
 name: refresh
-description: Incremental refresh — pull only what changed since the last run, then rebuild State.
+description: "Incremental refresh — pull only what changed since the last run, then rebuild State."
+argument-hint: "Project name; optional window (defaults to watermark since last run, else last 7 days)"
+agent: kushi
+tools: [search, read/readFile, edit, agent, execute/runInTerminal, execute/getTerminalOutput, 'workiq/*']
 ---
 
-# /refresh
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+${input:window:Optional window — last N days, since YYYY-MM-DD, or YYYY-MM-DD..YYYY-MM-DD (default: from last-run watermark)}
+```
 
+# /refresh
+
 Route to `@Kushi refresh <project>`.
 
 Window resolution (per `refresh-project` skill):

package/plugin/prompts/state.prompt.md

@@ -1,10 +1,19 @@
 ---
 name: state
-description: Re-render State/ from existing Evidence — does NO source pulls.
+description: "Re-render State/ from existing Evidence — does NO source pulls."
+argument-hint: "Project name; rebuilds State/ from existing Evidence, no source pulls"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
 ---
 
-# /state
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
 
+# /state
+
 Route to `@Kushi state <project>`.
 
 Pure renderer. Reads:

package/plugin/prompts/status.prompt.md

@@ -1,10 +1,19 @@
 ---
 name: status
-description: Show run-log — what's been pulled, when, watermarks, recent errors.
+description: "Show run-log — what's been pulled, when, watermarks, recent errors."
+argument-hint: "Project name; shows run-log: last_pulled, watermarks, item counts, recent errors"
+agent: kushi
+tools: [search, read/readFile, edit, agent]
 ---
 
-# /status
+## User Input
+
+```text
+${input:project:Project name, e.g. HCA}
+```
 
+# /status
+
 Route to `@Kushi status <project>`.
 
 Reads `<engagement-root>/<project>/Evidence/run-log.yml` and renders: