kushi-agents 3.4.1 → 3.4.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.
Files changed (5) hide show
  1. package/README.md +10 -6
  2. package/package.json +1 -1
  3. package/plugin/agents/kushi.agent.md +2 -2
  4. package/plugin/skills/bootstrap-project/SKILL.md +1 -1
  5. package/plugin/skills/refresh-project/SKILL.md +1 -1
package/README.md CHANGED
@@ -37,9 +37,9 @@ Kushi ships in three tiers. Pick how much you take — the default (`standard`)
37
37
  | **`full`** | standard + `state` (renders the opinionated `State/` rollup) | You want everything, including the outcome-based State/ files. |
38
38
 
39
39
  ```bash
40
- npx github:gim-home/kushi --clawpilot # default = standard
41
- npx github:gim-home/kushi --clawpilot --profile core # aggregator only
42
- npx github:gim-home/kushi --clawpilot --profile full # everything
40
+ npx kushi-agents --clawpilot # default = standard
41
+ npx kushi-agents --clawpilot --profile core # aggregator only
42
+ npx kushi-agents --clawpilot --profile full # everything
43
43
  ```
44
44
 
45
45
  The Evidence/ folder produced by every profile is a **stable public contract** — external systems can read from it without depending on Kushi internals. See [Concepts → Profiles and report packs](https://gim-home.github.io/kushi/concepts/profiles-and-packs/) and the [Evidence contract](https://gim-home.github.io/kushi/reference/evidence-contract/).
@@ -85,7 +85,7 @@ To switch profiles later, re-run with `--force` (cleanly handles downgrades):
85
85
  npx kushi-agents --clawpilot --profile core --force
86
86
  ```
87
87
 
88
- > **Internal GitHub install (Microsoft org members)**: `npx github:gim-home/kushi …` works identically and pulls straight from the private repo without going through npm.
88
+ > **Bleeding-edge from GitHub (Microsoft org members only)**: `npx github:gim-home/kushi …` works identically and pulls straight from the source repo — useful for testing pre-release commits. Stick to `npx kushi-agents` for everything else.
89
89
 
90
90
  See [Install](https://gim-home.github.io/kushi/getting-started/install/) for flags, prerequisites, and per-user config.
91
91
 
@@ -146,13 +146,17 @@ See [docs/reference/where-things-live.md](docs/reference/where-things-live.md) f
146
146
 
147
147
  ## Contributing
148
148
 
149
- Before committing changes to the plugin payload, run the self-check:
149
+ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contributor guide — repo layout, dev environment setup, the pre-commit checklist (self-check + mkdocs + npm pack), commit conventions, and how to add new skills/instructions/templates.
150
+
151
+ Quick pre-commit check:
150
152
 
151
153
  ```powershell
152
154
  pwsh plugin/skills/self-check/run.ps1 -Deep
155
+ mkdocs build --strict
156
+ npm pack --dry-run
153
157
  ```
154
158
 
155
- It validates frontmatter, agent inventory, prompt → skill routing, cross-links, the verbs table in this README, and the layout diagram in `docs/reference/where-things-live.md`.
159
+ The self-check validates frontmatter, agent inventory, prompt → skill routing, profile manifest, reference packs, cross-links, the verbs table in this README, and the layout diagram in `docs/reference/where-things-live.md`. Full reference: [docs/reference/self-check.md](docs/reference/self-check.md).
156
160
 
157
161
  ## License
158
162
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kushi-agents",
3
- "version": "3.4.1",
3
+ "version": "3.4.2",
4
4
  "description": "Install Kushi — multi-source project evidence agent with snapshot+stream capture across Email, Teams, OneNote, SharePoint, Meetings, CRM, ADO. WorkIQ-first, host-agnostic.",
5
5
  "type": "module",
6
6
  "bin": {
package/plugin/agents/kushi.agent.md CHANGED
@@ -9,7 +9,7 @@ Kushi is a multi-source evidence + state agent for consulting / engineering enga
9
9
 
10
10
  ## Install profiles
11
11
 
12
- Kushi ships in three profiles. The installed profile is recorded in `kushi-install.json` next to this agent file. Verbs that aren't installed for the current profile should be surfaced as: *"This verb requires the `<profile>` profile. Re-install with `npx github:gim-home/kushi --clawpilot --profile <profile> --force`."*
12
+ Kushi ships in three profiles. The installed profile is recorded in `kushi-install.json` next to this agent file. Verbs that aren't installed for the current profile should be surfaced as: *"This verb requires the `<profile>` profile. Re-install with `npx kushi-agents --clawpilot --profile <profile> --force`."*
13
13
 
14
14
  | Profile | What's installed | Verbs available |
15
15
  |---|---|---|
@@ -77,7 +77,7 @@ When a user message arrives:
77
77
  - If the message starts with an explicit producer verb → use it.
78
78
  - Else if the message contains a known project name AND a question shape (interrogative, "status of", "summarize", bare `<project> <topic>`) → `ask`.
79
79
  - Else → ask the user to clarify.
80
- 2. **Profile check**: confirm the chosen verb is listed in `kushi-install.json#verbs`. If not, surface: *"Verb `<verb>` requires the `<profile>` profile. Re-install with `npx github:gim-home/kushi --clawpilot --profile <profile> --force`."* and stop.
80
+ 2. **Profile check**: confirm the chosen verb is listed in `kushi-install.json#verbs`. If not, surface: *"Verb `<verb>` requires the `<profile>` profile. Re-install with `npx kushi-agents --clawpilot --profile <profile> --force`."* and stop.
81
81
  3. Identify the **project** (fuzzy-match against `m365-mutable.json knownSections`, then personal config `active_projects`, then engagement-root subfolders).
82
82
  4. Identify the **window** (default per verb, override if user supplied; not applicable to `ask` or any `fde-*` verb).
83
83
  5. Identify the **source** (only for `pull <source>`; otherwise all enabled).
package/plugin/skills/bootstrap-project/SKILL.md CHANGED
@@ -105,7 +105,7 @@ If multiple contributors already exist, dispatch `consolidate-evidence`. For fir
105
105
 
106
106
  If `kushi-install.json#profile` is `full` → dispatch `build-state` to render `State/*.md` from the freshly-pulled Evidence.
107
107
 
108
- If `standard` (or `core`) → **skip this step**. Note in the run summary: *"State/ rollup skipped (profile = `standard`). To enable, re-install with `npx github:gim-home/kushi --clawpilot --profile full --force`."*
108
+ If `standard` (or `core`) → **skip this step**. Note in the run summary: *"State/ rollup skipped (profile = `standard`). To enable, re-install with `npx kushi-agents --clawpilot --profile full --force`."*
109
109
 
110
110
  ### Step 7 — Verify + summary
111
111
 
package/plugin/skills/refresh-project/SKILL.md CHANGED
@@ -56,7 +56,7 @@ If `Evidence/contributors.yml` lists more than one alias and any of them have ne
56
56
 
57
57
  If `kushi-install.json#profile` is `full` → dispatch `build-state` if any source had ANY new data this run (new snapshot diffs or new stream events). Otherwise skip with note "no new evidence — state unchanged".
58
58
 
59
- If `standard` (or `core`) → **skip this step**. Note in the run summary: *"State/ rollup skipped (profile = `standard`). To enable, re-install with `npx github:gim-home/kushi --clawpilot --profile full --force`."*
59
+ If `standard` (or `core`) → **skip this step**. Note in the run summary: *"State/ rollup skipped (profile = `standard`). To enable, re-install with `npx kushi-agents --clawpilot --profile full --force`."*
60
60
 
61
61
  ### Step 5 — Run summary
62
62