kushi-agents 4.2.3 → 4.4.0

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:

package/plugin/reference-packs/README.md

@@ -33,7 +33,7 @@ Skills must always:
 What does **not** go in a pack:
 
 - Per-engagement data (lives under `<project>/Evidence/`)
-- Per-user identity / configs (lives in `<workspace>/.kushi/config/project-evidence.yml`)
+- Per-user identity / configs (lives in `<workspace>/.kushi/config/user/project-evidence.yml`)
 - Skill behavior (lives in `plugin/skills/<skill>/SKILL.md`)
 - Cross-cutting agent doctrine (lives in `plugin/instructions/*.instructions.md`)
 

package/plugin/skills/ask-project/SKILL.md

@@ -40,7 +40,7 @@ In order, stop on first hit:
 1. Exact `<engagement-root>/<project>/Evidence/` folder.
 2. Fuzzy match against `discovery.project_aliases` in any `<engagement-root>/<project>/Evidence/<alias>/.settings.yml`.
 3. `<engagement-root>/<project>/external-context/` (lighter-weight projects without full bootstrap).
-4. `<workspace>/.kushi/config/project-evidence.yml` `active_projects` list.
+4. `<workspace>/.kushi/config/user/project-evidence.yml` `active_projects` list.
 
 If zero matches → ask user. If multiple → list candidates and ask user to pick. **Echo the resolved root path before answering** so the user can confirm.
 

package/plugin/skills/bootstrap-project/SKILL.md

@@ -31,6 +31,8 @@ The active profile is read from `kushi-install.json#profile` next to this agent
 
 After every run (success or coverage-gaps), write `<project>/bootstrap-status.md` per the format contract in `instructions/bootstrap-status-format.instructions.md`. This is the project's fast-orientation artifact — required tables, normalized status vocabulary (`resolved`, `populated`, `unsynced`, `degraded-list-only`, `throttled-tooManyRequests`, `ado-not-complete`, `completed-with-coverage-gaps`), one-line final status. Do NOT inline run history here; that goes in `update-status.md`.
 
+> **Multi-contributor safety (kushi v4.4.0+)**: this file is shared via OneDrive. Per `multi-user-shared-files.instructions.md`, every write MUST: (a) absorb sibling conflict copies, (b) preserve other aliases' rows in `## Contributors who have bootstrapped this project`, (c) cite the discovering alias in per-source rows. Same rules apply to `<project>/integrations.yml`, `<project>/OPEN-QUESTIONS-DRAFT.md`, `<project>/Evidence/run-log.yml`, `<project>/Evidence/contributors.yml`.
+
 ## Inputs
 
 - `<project>` — engagement name (fuzzy-matched per `engagement-root-resolution.instructions.md`).
@@ -41,7 +43,7 @@ After every run (success or coverage-gaps), write `<project>/bootstrap-status.md
 
 ### Step 0 — Identity resolution (REQUIRED, never asks the user)
 
-Per `identity-resolution.instructions.md`. Read `<workspace>/.kushi/config/project-evidence.yml`:
+Per `identity-resolution.instructions.md`. Read `<workspace>/.kushi/config/user/project-evidence.yml`:
 
 * If `alias`, `email`, or `display_name` is missing / `<auto>` / matches a placeholder → call WorkIQ once:
   ```
@@ -49,7 +51,7 @@ Per `identity-resolution.instructions.md`. Read `<workspace>/.kushi/config/proje
   ```
   Map `upn → email`, `displayName → display_name`, `mailNickname → alias` (fallback `email.split('@')[0]`).
 * Persist resolved values back to the YAML (preserve comments).
-* Echo one line: `✓ Identity: <displayName> <<UPN>> (alias=<alias>). Edit .kushi/config/project-evidence.yml to override.`
+* Echo one line: `✓ Identity: <displayName> <<UPN>> (alias=<alias>). Edit .kushi/config/user/project-evidence.yml to override.`
 * If all three are already explicit non-placeholder values → skip silently.
 
 Hard stop if WorkIQ returns auth error or empty — print the WorkIQ sign-in hint and exit. Never fall back to asking the user.
@@ -59,13 +61,13 @@ Hard stop if WorkIQ returns auth error or empty — print the WorkIQ sign-in hin
 Verify in order. Stop on hard failures.
 
 1. **OS + host runtime** — display OS + Node/PowerShell version. Informational.
-2. **WorkIQ install (REQUIRED, hard stop)** — read `<workspace>/.kushi/config/project-evidence.yml workiq.cli_path`. If missing, probe known paths:
+2. **WorkIQ install (REQUIRED, hard stop)** — read `<workspace>/.kushi/config/user/project-evidence.yml workiq.cli_path`. If missing, probe known paths:
    - `$HOME\.kushi\bin\workiq.cmd`
    - `$env:LOCALAPPDATA\Programs\WorkIQ\workiq.cmd`
    - `$env:ProgramFiles\WorkIQ\workiq.cmd`
    If found, persist path. If not found, ask user for path (or to install). Test with `<workiq.cli_path> --help`. Without WorkIQ, M365 sources will all fail — STOP.
 3. **Conditional az login** — only if `<engagement-root>/.project-evidence/crm/config.yml` OR `<engagement-root>/.project-evidence/ado/config.yml` exists. Per `az-auth-conditional.instructions.md`. Soft warning on failure, never blocking.
-4. **Engagement-root resolution** — per `engagement-root-resolution.instructions.md`. Persist to `<workspace>/.kushi/config/project-evidence.yml engagement_root` if newly resolved.
+4. **Engagement-root resolution** — per `engagement-root-resolution.instructions.md`. Persist to `<workspace>/.kushi/config/user/project-evidence.yml engagement_root` if newly resolved.
 
 Display SETUP summary table with ✅ / ⚙️ / ❌ / ⚠️ / ➖ markers.
 
@@ -77,8 +79,8 @@ Required live files:
 
 | Live file | Template source |
 |---|---|
-| `<workspace>/.kushi/config/project-evidence.yml` | `templates/init/project-evidence.template.yml` (seeded by installer) |
-| `<workspace>/.kushi/config/integrations.yml` | `templates/init/integrations.template.yml` (seeded by installer) |
+| `<workspace>/.kushi/config/user/project-evidence.yml` | `templates/init/project-evidence.template.yml` (seeded by installer) |
+| `<workspace>/.kushi/config/shared/integrations.yml` | `templates/init/integrations.template.yml` (seeded by installer) |
 | `<engagement-root>/.project-evidence/m365/m365-auth.json` | `templates/init/m365-auth.template.json` |
 | `<engagement-root>/.project-evidence/m365/m365-mutable.json` | `templates/init/m365-mutable.template.json` |
 | `<engagement-root>/<project>/integrations.yml` | `templates/init/project-integrations.template.yml` |

package/plugin/skills/intro/SKILL.md

@@ -138,7 +138,7 @@ Present this verbatim:
 
 Before opening, check whether any project is already bootstrapped:
 
-1. Read `<workspace>/.kushi/config/project-evidence.yml` (personal config). If `active_projects` has entries, pick the most recent as the demo target — substitute that name into `{{active_project}}` placeholders below.
+1. Read `<workspace>/.kushi/config/user/project-evidence.yml` (personal config). If `active_projects` has entries, pick the most recent as the demo target — substitute that name into `{{active_project}}` placeholders below.
 2. If none, propose a fictional project named **Contoso Discovery** and tell the user that Try-it prompts will use that name; they can substitute their own at any time.
 
 ### Navigation Keywords
@@ -444,6 +444,6 @@ Reply `next` to see the closing cheat sheet, or `done` to exit.
 - Rule 1.2: Mode selection must always present BOTH options — never auto-route to one mode.
 - Rule 1.3: In walkthrough mode, each moment must wait for `next` / `skip` / `done` / `try` before advancing — never auto-advance.
 - Rule 1.4: `done` must work at every moment — never trap the user.
-- Rule 1.5: Try-it prompts must use the active project name from `<workspace>/.kushi/config/project-evidence.yml`, OR the placeholder `Contoso Discovery` if no projects are configured. Never invent a real-sounding project name.
+- Rule 1.5: Try-it prompts must use the active project name from `<workspace>/.kushi/config/user/project-evidence.yml`, OR the placeholder `Contoso Discovery` if no projects are configured. Never invent a real-sounding project name.
 - Rule 1.6: Skill descriptions in this file must match `kushi.agent.md` and the live `SKILL.md` files — `self-check` D-checks catch drift.
 - Rule 1.7: Demo moments must reflect the actual verb count in `kushi.agent.md`. If a verb is added or removed, this file must be updated in the same commit (`self-check` warns on drift).

package/plugin/skills/propose-ado-update/SKILL.md

@@ -27,7 +27,7 @@ This skill does **NOT** create a new top-level config file. It reads from the co
 
 **Resolution is fully deterministic** — never ask the user for paths the bootstrap layer already resolved:
 
-1. `<engagement-root>` ← `<workspace>/.kushi/config/project-evidence.yml engagement_root` (per `engagement-root-resolution.instructions.md`).
+1. `<engagement-root>` ← `<workspace>/.kushi/config/user/project-evidence.yml engagement_root` (per `engagement-root-resolution.instructions.md`).
 2. `<project>` folder ← fuzzy-match per `engagement-root-resolution.instructions.md` (knownSections → active_projects → subfolders).
 3. `<project>/integrations.yml ado.engagement_id` — REQUIRED. If `0` or missing → see "Prerequisites" below; never invent an ID.
 4. `<project>/integrations.yml ado.writes` — if missing, append the block from `<KUSHI_ROOT>/plugin/templates/ado-update/integrations-ado-writes.example.yml` and stop for user confirmation of `fieldRefName`.

package/plugin/templates/init/azuredevops.template.json

@@ -0,0 +1,159 @@
+{
+  "azureDevOps": {
+    "organizationUrl": "https://dev.azure.com/IndustrySolutions",
+    "project": "IS Engagements",
+    "apiVersion": "7.1",
+    "resource": "499b84ac-1321-427f-aa17-267ca6975798",
+    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
+    "allowedTenantIds": [
+      "72f988bf-86f1-41af-91ab-2d7cd011db47"
+    ],
+    "workItemTypes": {
+      "engagement": "Engagement",
+      "activity": "Activity"
+    },
+    "queryTemplates": {
+      "engagementByExactTitle": "SELECT [System.Id], [System.Title], [System.State], [System.ChangedDate] FROM WorkItems WHERE [System.TeamProject] = '@project' AND [System.WorkItemType] = '@engagementType' AND [System.Title] = '@title' ORDER BY [System.ChangedDate] DESC",
+      "engagementByPartialTitle": "SELECT [System.Id], [System.Title], [System.State], [System.ChangedDate] FROM WorkItems WHERE [System.TeamProject] = '@project' AND [System.WorkItemType] = '@engagementType' AND [System.Title] CONTAINS '@titlePart' ORDER BY [System.ChangedDate] DESC",
+      "activityByParentEngagementId": "SELECT [System.Id], [System.Title], [System.State], [System.ChangedDate] FROM WorkItems WHERE [System.TeamProject] = '@project' AND [System.WorkItemType] = '@activityType' AND [System.Parent] = @engagementId ORDER BY [System.ChangedDate] DESC"
+    },
+    "fieldMappings": {
+      "common": {
+        "id": "System.Id",
+        "title": "System.Title",
+        "state": "System.State",
+        "assignedTo": "System.AssignedTo",
+        "tags": "System.Tags",
+        "changedDate": "System.ChangedDate",
+        "parent": "System.Parent",
+        "historyWrite": "System.History"
+      },
+      "activity": {
+        "activityType": "Custom.activity_type",
+        "goal": "Custom.activity_goal",
+        "successCriteria": "Custom.activity_successcriteria",
+        "startDate": "Custom.activity_startdate",
+        "endDate": "Custom.activity_enddate",
+        "rrStatus": "Custom.activity_rr_status",
+        "rr1Type": "Custom.activity_rr1_type",
+        "assignedResource1": "Custom.AssignedResource1",
+        "rrStartDate1": "Custom.RRStartDate1",
+        "rrEndDate1": "Custom.RREndDate1",
+        "rr2Type": "Custom.activity_rr2_type",
+        "assignedResource2": "Custom.AssignedResource2",
+        "rrStartDate2": "Custom.RRStartDate2",
+        "rrEndDate2": "Custom.RREndDate2",
+        "country": "Custom.Country"
+      },
+      "engagement": {
+        "_comment_status": "Confirm exact engagement status field reference name",
+        "status": "System.State",
+        "_comment_customer": "Confirm exact customer/account field reference name",
+        "customer": "",
+        "_comment_primaryLead": "Confirm exact engagement owner/lead field reference name",
+        "primaryLead": "System.AssignedTo",
+        "_comment_joinKeyIsCrmOpportunityGuid": "Confirm this field exists in this process template",
+        "isCrmId": "Custom.ISCRMID",
+        "_comment_msxOpportunityId": "Optional if available in your process template",
+        "msxOpportunityId": "Custom.MSXOpportunityID"
+      },
+      "discussion": {
+        "_comment_historyRead": "History is available as revisions; confirm whether dedicated comments API should be the primary read path",
+        "historyWrite": "System.History",
+        "useCommentsApiRead": true,
+        "useCommentsApiWrite": false
+      }
+    },
+    "joinMapping": {
+      "crmToAdo": {
+        "primary": "Custom.ISCRMID",
+        "secondary": "System.Title"
+      }
+    },
+    "activity": {
+      "activityTypeField": "Custom.activity_type",
+      "advisoryValue": "Advisory",
+      "defaultState": "02 Active",
+      "defaultTags": "#FDE; #recon"
+    },
+    "queries": {
+      "maxSearchResults": 10,
+      "partialMatchEnabled": true,
+      "partialMatchMinScore": 0.6,
+      "searchFields": [
+        "System.Title",
+        "System.Tags"
+      ],
+      "defaultOrderBy": "[System.ChangedDate] DESC"
+    },
+    "linking": {
+      "preferredModel": "System.Parent",
+      "fallbackAllowed": false,
+      "allowPartialMatchSelection": true,
+      "candidateLimit": 5
+    },
+    "discussion": {
+      "mode": "history",
+      "sourceOfTruthForTranscriptUpdates": true,
+      "writeTarget": "pending-decision",
+      "contextReadSources": [
+        "engagement",
+        "activity",
+        "allChildren"
+      ],
+      "includeTranscriptSource": true,
+      "maxEntryChars": 8000,
+      "dedupe": {
+        "enabled": true,
+        "keyPattern": "meetingDate|transcriptId",
+        "includeWorkItemId": true
+      },
+      "template": {
+        "header": "Meeting Update",
+        "sections": [
+          "MeetingDate",
+          "Participants",
+          "Summary",
+          "Decisions",
+          "Actions",
+          "Risks",
+          "TranscriptSource"
+        ]
+      }
+    },
+    "contextRead": {
+      "dualSource": true,
+      "preferAdoDiscussion": true,
+      "includeCrmDuringMigration": true,
+      "childWorkItemDiscovery": {
+        "enabled": true,
+        "includeAllChildren": true,
+        "includeChildDiscussions": true,
+        "preferredChildTypeForExecution": "Activity",
+        "preferredActivityTypeValue": "Advisory"
+      },
+      "precedence": [
+        "ado.engagement.discussion",
+        "ado.children.discussion",
+        "ado.activity.discussion",
+        "ado.engagement",
+        "ado.children",
+        "ado.activities",
+        "crm.profile",
+        "crm.notes",
+        "transcript.unposted",
+        "external.docs"
+      ]
+    },
+    "validation": {
+      "requireExplicitSelectionOnAmbiguousMatch": true,
+      "requiredFieldsOnCreate": [
+        "System.Title",
+        "Custom.activity_type"
+      ],
+      "requiredFieldsOnLink": [
+        "System.Parent"
+      ]
+    }
+  }
+}