kushi-agents 3.4.1

package/plugin/templates/weekly/onenote-stream.template.md

@@ -0,0 +1,106 @@
+# {{PROJECT_NAME}} — Weekly OneNote Summary
+
+**Week:** {{WEEK_START_DATE}} (Mon) – {{WEEK_END_DATE}} (Sun)
+**Project:** {{PROJECT_NAME}}
+**Notebook:** {{NOTEBOOK_NAME}}
+**Prepared:** {{PREPARED_DATE}}
+
+---
+
+## Executive Summary
+
+_2–4 sentence overview of what was captured in OneNote this week for this project: notes taken, decisions logged, ideas, follow-ups._
+
+---
+
+## Pages Created or Updated
+
+| Date | Section | Page Title | Type (New/Edit) | Summary |
+|------|---------|------------|-----------------|---------|
+|      |         |            |                 |         |
+
+---
+
+## Key Decisions Captured
+
+- **{{DECISION_TITLE}}** — _Logged on {{DATE}} in {{SECTION}} > {{PAGE_TITLE}}._
+
+---
+
+## Action Items / TODOs
+
+| # | Action | Owner | Due | Status | Source Page |
+|---|--------|-------|-----|--------|-------------|
+| 1 |        |       |     |        |             |
+
+---
+
+## Open Questions / Parking Lot
+
+- **{{QUESTION}}** — Captured {{DATE}} in {{PAGE_TITLE}}.
+
+---
+
+## Meeting Notes
+
+### {{MEETING_TITLE}} — {{DATE}}
+- **Section / Page:** {{SECTION}} > {{PAGE_TITLE}}
+- **Attendees:** {{PEOPLE}}
+- **Key points:** _bullet summary._
+- **Decisions:** _…_
+- **Action items:** _…_
+
+---
+
+## Ideas & Drafts
+
+- **{{IDEA_TITLE}}** ({{DATE}}, {{PAGE_TITLE}}) — _short summary._
+
+---
+
+## Daily Breakdown
+
+### Monday — {{DATE}}
+- **{{Section}} > {{Page}}** — _one-line summary of what was added._
+
+### Tuesday — {{DATE}}
+- **{{Section}} > {{Page}}** — _…_
+
+### Wednesday — {{DATE}}
+- **{{Section}} > {{Page}}** — _…_
+
+### Thursday — {{DATE}}
+- **{{Section}} > {{Page}}** — _…_
+
+### Friday — {{DATE}}
+- **{{Section}} > {{Page}}** — _…_
+
+### Saturday — {{DATE}}
+- _No notes._ / _…_
+
+### Sunday — {{DATE}}
+- _No notes._ / _…_
+
+---
+
+## Links, Attachments & References
+
+- [{{LINK_OR_FILE}}]({{URL}}) — referenced in {{PAGE_TITLE}} on {{DATE}}.
+
+---
+
+## Carry-Over to Next Week
+
+- _Unfinished notes, drafts to flesh out, follow-ups to schedule._
+
+---
+
+_Generated from OneNote notebook **{{NOTEBOOK_NAME}}**, pages matching project **{{PROJECT_NAME}}**, modified between {{WEEK_START_DATE}} and {{WEEK_END_DATE}}._
+
+## Validation
+
+> Thoroughness detector checklist — per `thoroughness-detector.instructions.md`. The skill ticks what it can verify automatically; `self-check` C12 scans these blocks.
+
+- [ ] bodies-present
+- [ ] no-link-only-stubs
+- [ ] coverage-notes-explain-any-gaps

package/plugin/templates/weekly/run-log.template.md

@@ -0,0 +1,88 @@
+# {{PROJECT_NAME}} — Weekly Summaries Run Log
+
+**Project:** {{PROJECT_NAME}}
+**Project folder:** {{PROJECT_FOLDER_PATH}}
+**Evidence root:** {{PROJECT_FOLDER_PATH}}\Evidence
+**Created:** {{CREATED_DATE}}
+**Last updated:** {{LAST_UPDATED_DATETIME}}
+
+---
+
+## Folder Structure (multi-user)
+
+```
+{{PROJECT_FOLDER_PATH}}\
+└── Evidence\
+    ├── run-log.md                ← this file (shared, append-only)
+    ├── contributors.yml          ← who contributes, which sources they own
+    ├── _Consolidated\            ← merged team view per week
+    │   └── YYYY-MM-DD_consolidated.md
+    └── <alias>\                  ← one folder per contributor (e.g. ushak\)
+        ├── Email\
+        │   └── YYYY-MM-DD_email-summary.md         (one per week, dated by Monday)
+        ├── Teams-Chats\
+        │   └── YYYY-MM-DD_teams-summary.md
+        ├── OneNote\
+        │   └── YYYY-MM-DD_onenote-summary.md
+        ├── SharePoint\
+        │   └── YYYY-MM-DD_sharepoint-summary.md
+        └── Meetings\
+            └── YYYY-MM-DD_meetings-summary.md
+```
+
+**Rules**
+- Each contributor only writes to their own `<alias>\` subfolder (no SharePoint co-authoring conflicts).
+- SharePoint folder content is shared; SharePoint summaries can be produced by any contributor.
+- Consolidation is a separate, opt-in merge step performed by the owner listed in `contributors.yml`.
+- Privacy: never run another person's mailbox/chat/OneNote against your tokens. The consolidator merges from each contributor's *summary*, not their raw data.
+
+File-naming convention: each summary is named with the **Monday** of the covered week (ISO `YYYY-MM-DD`), e.g. `2026-05-04_email-summary.md` covers Mon 2026-05-04 → Sun 2026-05-10.
+
+---
+
+## Run Status by (Week × Contributor)
+
+Legend: ✅ done · ⏳ in progress · ⬜ not run · ⚠️ partial / errors · ➖ skipped (no data) · — N/A
+
+| Week (Mon → Sun) | Contributor | Email | Teams Chats | OneNote | SharePoint | Meetings | Run on | Notes |
+|------------------|-------------|-------|-------------|---------|------------|----------|--------|-------|
+| {{YYYY-MM-DD}} → {{YYYY-MM-DD}} | {{alias}} | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |  |  |
+| {{YYYY-MM-DD}} → {{YYYY-MM-DD}} | _consolidated_ | ⬜ | ⬜ | ⬜ | ⬜ | ⬜ |  | Awaiting ≥2 contributors. |
+
+---
+
+## Run History (most recent first)
+
+### {{RUN_DATETIME}} — Week of {{WEEK_START}}
+- **Triggered by:** {{user request / scheduled}}
+- **Sources run:** {{Email, Teams, OneNote, SharePoint, Meetings}}
+- **Result:**
+  - Email → ✅ `Email\{{file}}.md` ({{N}} emails)
+  - Teams Chats → ✅ `Teams-Chats\{{file}}.md` ({{N}} messages across {{M}} chats)
+  - OneNote → ➖ no pages updated this week
+  - SharePoint → ✅ `SharePoint\{{file}}.md` ({{N}} files touched)
+  - Meetings → ⚠️ recap generated, transcript missing for {{meeting}}
+- **Notes / follow-ups:** _…_
+
+---
+
+## Known Gaps / To-Do
+
+- _Weeks or sources still pending, e.g._ "Week of 2026-04-20 — Meetings transcripts not yet available, retry after {{date}}."
+
+---
+
+## Configuration Snapshot
+
+| Setting | Value |
+|---------|-------|
+| Project name | {{PROJECT_NAME}} |
+| SharePoint root | {{SHAREPOINT_ROOT}} |
+| Matched project subfolder | {{MATCHED_SUBFOLDER}} (fuzzy score: {{SCORE}}) |
+| OneNote notebook | {{NOTEBOOK_NAME}} |
+| Week definition | Monday → Sunday |
+| Templates source | `<kushi-install>/templates/` |
+
+---
+
+_This file is auto-maintained and lives at `{{PROJECT_FOLDER_PATH}}\Evidence\run-log.md`. Before each run, check the **Run Status by Week** table; skip any (week × source) cell already marked ✅ unless a re-run is explicitly requested. After each run, update the table, append a Run History entry, and bump **Last updated**._

package/plugin/templates/weekly/sharepoint-stream.template.md

@@ -0,0 +1,121 @@
+# {{PROJECT_NAME}} — Weekly SharePoint Folder Summary
+
+**Week:** {{WEEK_START_DATE}} (Mon) – {{WEEK_END_DATE}} (Sun)
+**Project:** {{PROJECT_NAME}}
+**Root folder:** {{ROOT_FOLDER_PATH}}
+**Matched project subfolder:** {{MATCHED_SUBFOLDER}}  _(fuzzy match score: {{MATCH_SCORE}})_
+**Prepared:** {{PREPARED_DATE}}
+
+---
+
+## Executive Summary
+
+_2–4 sentence overview of activity in the project SharePoint folder this week: new docs, major edits, who was working on what._
+
+---
+
+## Files Added This Week
+
+| Date | File | Type | Author | Path | Summary |
+|------|------|------|--------|------|---------|
+|      |      |      |        |      |         |
+
+---
+
+## Files Modified This Week
+
+| Date | File | Modified By | Change Summary | Path |
+|------|------|-------------|----------------|------|
+|      |      |             |                |      |
+
+---
+
+## Files Renamed / Moved / Deleted
+
+- **{{FILE}}** — {{action}} by {{PERSON}} on {{DATE}}.
+
+---
+
+## Notable Documents
+
+### {{DOC_TITLE}}
+- **Path:** {{RELATIVE_PATH}}
+- **Type:** {{Word/PPT/Excel/PDF/…}}
+- **Author / Last editor:** {{PERSON}}
+- **Summary:** _what the doc contains and why it matters this week._
+
+---
+
+## Decisions / Sign-offs Captured in Documents
+
+- **{{DECISION}}** — found in {{DOC_TITLE}} ({{DATE}}).
+
+---
+
+## Action Items Surfaced from Documents
+
+| # | Action | Owner | Due | Source Doc |
+|---|--------|-------|-----|------------|
+| 1 |        |       |     |            |
+
+---
+
+## Daily Breakdown
+
+### Monday — {{DATE}}
+- **{{File}}** — {{added/modified}} by {{PERSON}}: _one-line summary._
+
+### Tuesday — {{DATE}}
+- _…_
+
+### Wednesday — {{DATE}}
+- _…_
+
+### Thursday — {{DATE}}
+- _…_
+
+### Friday — {{DATE}}
+- _…_
+
+### Saturday — {{DATE}}
+- _No file activity._ / _…_
+
+### Sunday — {{DATE}}
+- _No file activity._ / _…_
+
+---
+
+## Contributors This Week
+
+| Person | # Files Touched | Notes |
+|--------|-----------------|-------|
+|        |                 |       |
+
+---
+
+## Folder Structure Snapshot
+
+```
+{{MATCHED_SUBFOLDER}}/
+├── {{subfolder or file}}
+├── {{subfolder or file}}
+└── ...
+```
+
+---
+
+## Carry-Over to Next Week
+
+- _Drafts in progress, docs awaiting review, missing artifacts._
+
+---
+
+_Generated from SharePoint root **{{ROOT_FOLDER_PATH}}**, fuzzy-matched to subfolder **{{MATCHED_SUBFOLDER}}** for project **{{PROJECT_NAME}}**, file activity between {{WEEK_START_DATE}} and {{WEEK_END_DATE}}._
+
+## Validation
+
+> Thoroughness detector checklist — per `thoroughness-detector.instructions.md`. The skill ticks what it can verify automatically; `self-check` C12 scans these blocks.
+
+- [ ] bodies-present
+- [ ] no-link-only-stubs
+- [ ] coverage-notes-explain-any-gaps

package/plugin/templates/weekly/teams-stream.template.md

@@ -0,0 +1,121 @@
+# {{PROJECT_NAME}} — Weekly Teams Summary
+
+**Week:** {{WEEK_START_DATE}} (Mon) – {{WEEK_END_DATE}} (Sun)
+**Project:** {{PROJECT_NAME}}
+**Prepared:** {{PREPARED_DATE}}
+
+---
+
+## Executive Summary
+
+_2–4 sentence overview of the week across all Teams conversations: key decisions, biggest risks, notable progress._
+
+---
+
+## Key Decisions
+
+- **{{DECISION_TITLE}}** — _Decided by {{PERSON}} on {{DATE}} in {{CHAT_OR_CHANNEL}}._
+
+---
+
+## Action Items
+
+| # | Action | Owner | Due | Status | Source (Chat/Channel + Date) |
+|---|--------|-------|-----|--------|------------------------------|
+| 1 |        |       |     |        |                              |
+
+---
+
+## Open Questions / Blockers
+
+- **{{QUESTION}}** — Raised by {{PERSON}} ({{DATE}}) in {{CHAT_OR_CHANNEL}}. Awaiting: {{OWNER}}.
+
+---
+
+## Risks & Escalations
+
+- **{{RISK}}** — Severity: {{LOW/MED/HIGH}}. Owner: {{PERSON}}. Source: {{CHAT_OR_CHANNEL}}.
+
+---
+
+## Conversations Covered
+
+| Type | Name | Messages | Participants |
+|------|------|----------|--------------|
+| Channel | {{Team > Channel}} |  |  |
+| Group chat | {{Topic / members}} |  |  |
+| 1:1 | {{Person}} |  |  |
+
+---
+
+## Daily Breakdown
+
+### Monday — {{DATE}}
+- **{{Chat/Channel}}** — {{Person}}: _one-line summary of what was discussed._
+
+### Tuesday — {{DATE}}
+- **{{Chat/Channel}}** — {{Person}}: _one-line summary._
+
+### Wednesday — {{DATE}}
+- **{{Chat/Channel}}** — {{Person}}: _one-line summary._
+
+### Thursday — {{DATE}}
+- **{{Chat/Channel}}** — {{Person}}: _one-line summary._
+
+### Friday — {{DATE}}
+- **{{Chat/Channel}}** — {{Person}}: _one-line summary._
+
+### Saturday — {{DATE}}
+- _No project chatter._ / _{{Chat/Channel}} — …_
+
+### Sunday — {{DATE}}
+- _No project chatter._ / _{{Chat/Channel}} — …_
+
+---
+
+## Threads of Note
+
+### {{THREAD_TITLE / Channel post}}
+- **Where:** {{Team > Channel}} or {{Chat name}}
+- **Participants:** {{PEOPLE}}
+- **Messages:** {{N}}
+- **Outcome:** _summary of where the thread landed._
+
+---
+
+## People Active This Week
+
+| Person | Role | # Messages | Notes |
+|--------|------|------------|-------|
+|        |      |            |       |
+
+---
+
+## Files & Links Shared
+
+- [{{FILE_OR_LINK_NAME}}]({{URL}}) — shared by {{PERSON}} in {{CHAT_OR_CHANNEL}} on {{DATE}}.
+
+---
+
+## Meetings Referenced in Chat
+
+- **{{MEETING_TITLE}}** ({{DATE}}) — referenced in {{CHAT_OR_CHANNEL}}. Notes/recap link: {{URL}}.
+
+---
+
+## Carry-Over to Next Week
+
+- _Open threads, pending replies, follow-ups needed._
+
+---
+
+_Generated from Teams chats and channel messages matching project: **{{PROJECT_NAME}}** between {{WEEK_START_DATE}} and {{WEEK_END_DATE}}._
+
+## Validation
+
+> Thoroughness detector checklist — per `thoroughness-detector.instructions.md`. The skill ticks what it can verify automatically; `self-check` C12 scans these blocks.
+
+- [ ] bodies-present (full message-by-message reproduction; collapse only routine acks)
+- [ ] participants-captured
+- [ ] no-link-only-stubs (no `see Teams thread` without inline messages)
+- [ ] coverage-notes-explain-any-gaps

package/src/constants.mjs

@@ -0,0 +1,49 @@
+/** Default destination path relative to the user's project root (vscode target). */
+export const DEFAULT_DEST = '.kushi';
+
+/** Default destination for the `clawpilot` install target (absolute). */
+export const CLAWPILOT_DEST_SUBPATH = '.copilot/m-skills/kushi';
+
+/** Install target identifiers. */
+export const TARGET_VSCODE = 'vscode';
+export const TARGET_CLAWPILOT = 'clawpilot';
+
+/**
+ * In Clawpilot mode, the orchestrator agent file is duplicated as the
+ * top-level SKILL.md so Clawpilot's skill discovery (which expects
+ * `~/.copilot/m-skills/<name>/SKILL.md`) finds it.
+ */
+export const CLAWPILOT_AGENT_SOURCE = 'agents/kushi.agent.md';
+export const CLAWPILOT_SKILL_DEST = 'SKILL.md';
+
+/** Source directory inside the npm package that holds distributable assets. */
+export const PLUGIN_SOURCE_DIR = 'plugin';
+
+/** Asset subdirectories under plugin/ that get copied. */
+export const ASSET_DIRS = ['agents', 'instructions', 'prompts', 'skills', 'templates', 'reference-packs'];
+
+/** Files to exclude from consumer installs (relative to plugin/). */
+export const EXCLUDED_FILES = [];
+
+/** Directories to exclude from consumer installs (relative to plugin/). */
+export const EXCLUDED_DIRS = [];
+
+/** Files copied to the TARGET project's .github/ directory. */
+export const PROJECT_GITHUB_FILES = [];
+
+/** Directories copied to the TARGET project's .github/ directory. */
+export const PROJECT_GITHUB_DIRS = ['config'];
+
+/** Project-level .github files that must never be copied into consumer projects. */
+export const PROJECT_GITHUB_EXCLUDED_FILES = [
+  'config/m365-auth.json',
+  'config/m365-mutable.json'
+];
+
+/** VS Code settings keys → the .kushi subdirectory they point at. */
+export const SETTINGS_MAP = {
+  'chat.agentFilesLocations':        'agents',
+  'chat.promptFilesLocations':       'prompts',
+  'chat.instructionsFilesLocations': 'instructions',
+  'chat.agentSkillsLocations':       'skills'
+};

package/src/copy-assets.mjs

@@ -0,0 +1,183 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  ASSET_DIRS,
+  EXCLUDED_FILES,
+  EXCLUDED_DIRS,
+  PLUGIN_SOURCE_DIR,
+  PROJECT_GITHUB_FILES,
+  PROJECT_GITHUB_DIRS,
+  PROJECT_GITHUB_EXCLUDED_FILES,
+} from './constants.mjs';
+
+/**
+ * Recursively copy the four asset directories from the npm package
+ * into the absolute destination root, skipping files listed in EXCLUDED_FILES
+ * and (if an include filter is supplied) anything the profile doesn't want.
+ *
+ * @param {string} sourcePkgDir – root of the npm package (resolved via import.meta.url)
+ * @param {string} destAbsolute – absolute destination directory
+ * @param {(assetDir: string, relPath: string) => boolean} [includeFilter] – returns true to include a file/dir
+ * @returns {{ copied: number, details: Array<{ dir: string, count: number }> }}
+ */
+export function copyAssets(sourcePkgDir, destAbsolute, includeFilter) {
+  const destRoot = destAbsolute;
+  const srcGitHub = path.join(sourcePkgDir, PLUGIN_SOURCE_DIR);
+
+  let copied = 0;
+  const details = [];
+
+  for (const dir of ASSET_DIRS) {
+    const src = path.join(srcGitHub, dir);
+    const dest = path.join(destRoot, dir);
+
+    if (!fs.existsSync(src)) {
+      details.push({ dir, count: 0 });
+      continue;
+    }
+
+    copyDirFiltered(src, dest, dir, '', includeFilter);
+
+    const count = fs.existsSync(dest) ? countFiles(dest) : 0;
+    copied += count;
+    details.push({ dir, count });
+  }
+
+  return { copied, details };
+}
+
+/**
+ * Recursively copy a directory, skipping files that match EXCLUDED_FILES.
+ * @param {string} src  – source directory
+ * @param {string} dest – destination directory
+ * @param {string} assetDir – the top-level asset dir name (e.g. 'agents')
+ * @param {string} [relPrefix=''] – relative path prefix within the asset dir
+ * @param {(assetDir: string, relPath: string) => boolean} [includeFilter]
+ */
+function copyDirFiltered(src, dest, assetDir, relPrefix = '', includeFilter) {
+  let dirCreated = false;
+  const ensureDir = () => {
+    if (!dirCreated) {
+      fs.mkdirSync(dest, { recursive: true });
+      dirCreated = true;
+    }
+  };
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    const relPath = relPrefix ? `${relPrefix}/${entry.name}` : entry.name;
+    const excludeKey = `${assetDir}/${relPath}`;
+
+    if (entry.isDirectory()) {
+      if (EXCLUDED_DIRS.includes(excludeKey)) continue;
+      if (includeFilter && !includeFilter(assetDir, relPath)) continue;
+      copyDirFiltered(srcPath, destPath, assetDir, relPath, includeFilter);
+    } else {
+      if (EXCLUDED_FILES.includes(excludeKey)) continue;
+      if (includeFilter && !includeFilter(assetDir, relPath)) continue;
+      ensureDir();
+      try {
+        fs.cpSync(srcPath, destPath, { force: true });
+      } catch (err) {
+        if (err.code === 'EACCES') {
+          console.error(`\n  ✘ Permission denied writing to ${destPath}\n`);
+          process.exit(1);
+        }
+        throw err;
+      }
+    }
+  }
+}
+
+/**
+ * Recursively copy a project-level .github directory while excluding sensitive local-only files.
+ * @param {string} src
+ * @param {string} dest
+ * @param {string} projectDir
+ * @param {string} [relPrefix='']
+ */
+function copyProjectDirFiltered(src, dest, projectDir, relPrefix = '') {
+  fs.mkdirSync(dest, { recursive: true });
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    const relPath = relPrefix ? `${relPrefix}/${entry.name}` : entry.name;
+    const excludeKey = `${projectDir}/${relPath}`;
+
+    if (entry.isDirectory()) {
+      copyProjectDirFiltered(srcPath, destPath, projectDir, relPrefix ? `${relPrefix}/${entry.name}` : entry.name);
+      continue;
+    }
+
+    if (PROJECT_GITHUB_EXCLUDED_FILES.includes(excludeKey)) continue;
+
+    fs.cpSync(srcPath, destPath, { force: true });
+  }
+}
+
+/**
+ * Count files recursively in a directory.
+ * @param {string} dir
+ * @returns {number}
+ */
+function countFiles(dir) {
+  let count = 0;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      count += countFiles(path.join(dir, entry.name));
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
+/**
+ * Copy project-level files (hooks, copilot-instructions) to the target
+ * project's .github/ directory. Does not overwrite existing files.
+ *
+ * @param {string} sourcePkgDir – root of the npm package
+ * @returns {{ copied: string[], skipped: string[] }}
+ */
+export function copyProjectFiles(sourcePkgDir) {
+  const projectGitHub = path.join(process.cwd(), '.github');
+  const srcGitHub = path.join(sourcePkgDir, '.github');
+
+  const copied = [];
+  const skipped = [];
+
+  for (const file of PROJECT_GITHUB_FILES) {
+    const src = path.join(srcGitHub, file);
+    const dest = path.join(projectGitHub, file);
+
+    if (!fs.existsSync(src)) continue;
+
+    if (fs.existsSync(dest)) {
+      skipped.push(`.github/${file}`);
+      continue;
+    }
+
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.cpSync(src, dest);
+    copied.push(`.github/${file}`);
+  }
+
+  for (const dir of PROJECT_GITHUB_DIRS) {
+    const src = path.join(srcGitHub, dir);
+    const dest = path.join(projectGitHub, dir);
+
+    if (!fs.existsSync(src)) continue;
+
+    if (fs.existsSync(dest)) {
+      skipped.push(`.github/${dir}/`);
+      continue;
+    }
+
+    copyProjectDirFiltered(src, dest, dir);
+    copied.push(`.github/${dir}/`);
+  }
+
+  return { copied, skipped };
+}