kushi-agents 6.1.1 → 6.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kushi-agents",
-  "version": "6.1.1",
+  "version": "6.1.2",
   "description": "Install Kushi — multi-source project evidence agent with Comprehensive Structured Capture (CSC) into weekly-only files across Email, Teams, OneNote, Loop, SharePoint, Meetings, CRM, ADO. Meetings retain a sibling verbatim/ audit folder. WorkIQ-only for M365 sources (Graph / m365_* FORBIDDEN as fallbacks; user-paste is first-class). Host-agnostic.",
   "type": "module",
   "bin": {

package/plugin/instructions/evidence-layout-canonical.instructions.md

@@ -62,8 +62,8 @@ Concretely, a pull skill MUST NOT create or write to any of these (representativ
 | `<project>/_Weekly Summaries/` | `<project>/Evidence/<alias>/<source>/weekly/` |
 | `<project>/Meetings/` (at project root) | `<project>/Evidence/<alias>/meetings/` |
 | `<project>/Teams/` (at project root) | `<project>/Evidence/<alias>/teams/` |
-| `<project>/SharePoint/` (at project root) | `<project>/Evidence/<alias>/sharepoint/` |
-| `<project>/CRM/`, `<project>/ADO/` (at project root) | `<project>/Evidence/<alias>/{crm,ado}/` |
+| `<project>/SharePoint/` (at project root) | `<project>/Evidence/_shared/sharepoint/` (project-scoped; v6.1.2+) |
+| `<project>/CRM/`, `<project>/ADO/` (at project root) | `<project>/Evidence/_shared/{crm,ado}/` |
 | any `<project>/<source>-context/`, `<project>/<source>-summary/`, etc. | `<project>/Evidence/<alias>/<source>/weekly/` |
 
 `State/`, `Reports/`, `integrations.yml` are the **only** top-level siblings of `Evidence/` that pull/refresh skills are allowed to leave alone (they are written by `build-state`, `aggregate-project`, and bootstrap respectively — not by pull-* skills).
@@ -83,7 +83,7 @@ If alias is ambiguous (legacy folder pre-dates multi-user), default to the curre
 
 By contract, downstream skills walk:
 
-- `Evidence/*/email/`, `Evidence/*/teams/`, `Evidence/*/meetings/`, `Evidence/*/onenote/`, `Evidence/*/sharepoint/`, `Evidence/*/crm/`, `Evidence/*/ado/`
+- `Evidence/*/email/`, `Evidence/*/teams/`, `Evidence/*/meetings/`, `Evidence/*/onenote/`, `Evidence/_shared/sharepoint/`, `Evidence/_shared/crm/`, `Evidence/_shared/ado/`
 
 Anything outside these paths is invisible to them — by design. The path IS the contract. There is no "also scan sibling folders" fallback.
 

package/plugin/runners/bootstrap.mjs

@@ -26,6 +26,7 @@ import {
   aliasRoot, projectSharedFile, userFile, USER_FILES,
 } from './lib/layout.mjs';
 import { writeAtomic, pathExists } from './lib/evidence.mjs';
+import { writeRefreshReport, appendRunLog } from './lib/runlog.mjs';
 
 function parseArgs(argv) {
   const args = { force: false, dryRun: false, lookbackDays: null, interactive: false };
@@ -254,7 +255,7 @@ const USER_DIRS = [
   USER_FILES.discovery,
   USER_FILES.deferredRetries,
   USER_FILES.refreshReports,
-  'email', 'teams', 'meetings', 'onenote', 'sharepoint',
+  'email', 'teams', 'meetings', 'onenote',
   'crm-notes', 'ado-notes',
 ];
 
@@ -327,6 +328,63 @@ async function main() {
     });
   }
 
+  const startedAt = new Date(); // capture when scaffold started (before report)
+  // v6.1.2: write bootstrap report to refresh-reports/<ts>_bootstrap.md per
+  // run-reports doctrine. Bootstrap is scaffold-only (no HTTP, no pulls), so
+  // the report enumerates files/dirs created vs. existed, plus optional
+  // dateFloor + interactive outcomes. Diagnostics-only; never blocks.
+  let reportPath = null;
+  if (!args.dryRun) {
+    try {
+      const created = log.created.map(p => path.relative(root, p) || '.');
+      const existed = log.existed.map(p => path.relative(root, p) || '.');
+      const summaryLine = `bootstrap ${args.alias}: created=${created.length} existed=${existed.length}` +
+        (dateFloorReport && dateFloorReport.fields?.length ? ` dateFloor=${dateFloorReport.dateFloor}` : '') +
+        (interactiveReport && interactiveReport.fields?.length ? ` interactive=${interactiveReport.fields.length}` : '');
+      const details = {
+        mode: 'bootstrap',
+        contributor: args.alias,
+        started: startedAt.toISOString(),
+        ended: new Date().toISOString(),
+        scope: 'scaffold-only (no HTTP, no pulls)',
+        what_was_done: {
+          configs_probed: ['integrations.yml', 'project-info.md', 'external-links.yml', 'contributors.yml'],
+          shared_dirs: SHARED_DIRS,
+          user_dirs: USER_DIRS,
+          per_user_files: ['boundaries.yml', 'external-links.local.yml', '_ledger.yml'],
+          counts: {
+            created: created.length,
+            existed: existed.length,
+          },
+        },
+        created,
+        existed,
+        date_floor: dateFloorReport || null,
+        interactive: interactiveReport || null,
+        skips_and_gaps: [
+          'Bootstrap is scaffold-only — no source pulls performed.',
+          'Run `kushi discover <project>` next to populate boundaries.yml/integrations.yml.',
+          'Then `kushi refresh <project>` to capture per-source CSC weekly files.',
+        ],
+      };
+      const r = await writeRefreshReport(args.project, args.alias, {
+        type: 'bootstrap',
+        summary: summaryLine,
+        details,
+      });
+      reportPath = r?.path || null;
+      try {
+        await appendRunLog(args.project, {
+          mode: 'bootstrap',
+          contributor: args.alias,
+          status: 'ok',
+          summary: summaryLine,
+          report: reportPath ? path.relative(root, reportPath) : null,
+        });
+      } catch { /* run-log is diagnostics-only */ }
+    } catch { /* bootstrap-report is diagnostics-only, never block */ }
+  }
+
   emit({
     status: 'ok',
     project: root,
@@ -334,6 +392,7 @@ async function main() {
     created: log.created.map(p => path.relative(root, p) || '.'),
     existed: log.existed.map(p => path.relative(root, p) || '.'),
     dry_run: args.dryRun,
+    ...(reportPath ? { report: path.relative(root, reportPath) } : {}),
     ...(dateFloorReport ? { date_floor: dateFloorReport } : {}),
     ...(interactiveReport ? { interactive: interactiveReport } : {}),
   });

package/plugin/runners/discover.mjs

@@ -66,8 +66,8 @@ function buildPrompt(source, projectName, scope = null) {
     meetings: `Find recurring Teams meeting series related to project "${projectName}".`,
     onenote: `Find OneNote sections related to project "${projectName}".`,
     sharepoint: `Find SharePoint sites or libraries related to project "${projectName}".`,
-    crm: `Find Dataverse CRM incidents/requests related to project "${projectName}" in iscrm.crm.dynamics.com.`,
-    ado: `Find Azure DevOps engagement work items in IndustrySolutions/IS Engagements related to project "${projectName}".`,
+    crm: `Search the user's indexed M365 content (emails, OneNote pages, SharePoint/OneDrive documents, Teams messages) for Dataverse CRM request/incident identifiers that relate to project "${projectName}". CRM IDs typically look like FE-2026-001458, REQ-12345, INC-9, or 6+ digit numerics, and appear in email signatures/subjects, project briefs, status decks, or Loop pages from iscrm.crm.dynamics.com. Return the request_id (preferred) or incident_number you see most consistently associated with the project.`,
+    ado: `Search the user's indexed M365 content (emails, OneNote pages, SharePoint/OneDrive documents, Teams messages) for Azure DevOps work items related to project "${projectName}" in the IndustrySolutions/IS Engagements org. Engagement work items are typically referenced by 5–7 digit numeric IDs in URLs like dev.azure.com/IndustrySolutions/IS%20Engagements/_workitems/edit/123456 or in shorthand like "AB#123456" / "WI 123456". Return the engagement_id (top-level "Engagement" work item id, preferred) or work_item_id you see most consistently associated with the project.`,
   };
   const fields = {
     email: 'value (full folder path like "Inbox/Northwind"), confidence (high|medium|low)',

package/plugin/runners/lib/csc-pull.mjs

@@ -69,8 +69,10 @@ export function buildPullPrompt({ source, project, entity, weekStart, scope, opt
     if (scope?.notebookName) lines.push(`Restrict to notebook "${scope.notebookName}".`);
     lines.push('One CSC block per page touched in the week.');
   } else if (source === 'sharepoint') {
-    lines.push(`Find SharePoint files within site "${entity}" modified between ${fromYmd} and ${toYmd}, inclusive.`);
+    lines.push(`Find SharePoint files within site "${entity}" — including its top-level document libraries and the first level of folders inside each library (depth 1) — modified between ${fromYmd} and ${toYmd}, inclusive.`);
+    lines.push('For each file, capture: filename, full server-relative path, last_modified timestamp, last_modified_by, and any external links (http/https URLs to other systems, e.g. external SharePoint sites, ADO/CRM/Jira, Loop, OneDrive, third-party docs) referenced in the document body or metadata.');
     lines.push('One CSC block per file touched in the week.');
+    lines.push('In the CSC block, place the captured external links into `topics` as a comma-separated list of bare URLs (or `_none_` if none), and use `summary` for a one-line description of what changed in the file.');
   } else {
     throw new Error(`csc-pull: unsupported source "${source}"`);
   }

package/plugin/runners/lib/layout.mjs

@@ -5,10 +5,10 @@
 import path from 'node:path';
 
 /** Sources whose record bodies are project-scoped (live under Evidence/_shared/). */
-export const SHARED_SOURCES = new Set(['crm', 'ado']);
+export const SHARED_SOURCES = new Set(['crm', 'ado', 'sharepoint']);
 
 /** Sources whose captures are per-user (live under Evidence/<alias>/<source>/). */
-export const USER_SOURCES = new Set(['email', 'teams', 'meetings', 'onenote', 'sharepoint']);
+export const USER_SOURCES = new Set(['email', 'teams', 'meetings', 'onenote']);
 
 /** Per-user note folders for shared sources (annotations only, not record bodies). */
 export const USER_NOTE_DIRS = { crm: 'crm-notes', ado: 'ado-notes' };
@@ -35,8 +35,8 @@ export function sharedRoot(project) {
 
 /** Evidence/_shared/<source>/ — only for SHARED_SOURCES. */
 export function sharedSourceDir(project, source) {
-  if (!SHARED_SOURCES.has(source) && source !== 'sharepoint') {
-    throw new Error(`layout: source "${source}" is not a shared source (allowed: ${[...SHARED_SOURCES, 'sharepoint'].join(', ')})`);
+  if (!SHARED_SOURCES.has(source)) {
+    throw new Error(`layout: source "${source}" is not a shared source (allowed: ${[...SHARED_SOURCES].join(', ')})`);
   }
   return path.join(sharedRoot(project), source);
 }

package/plugin/runners/test/integration/bootstrap.integration.test.mjs

@@ -45,7 +45,7 @@ test('scaffolds project skeleton on empty dir', async () => {
   const ledger = YAML.parse(await fs.readFile(path.join(p, 'Evidence', 'ushak', '_ledger.yml'), 'utf8'));
   assert.deepEqual(ledger, { entries: {} });
   for (const d of ['_discovery', '_deferred-retries', 'refresh-reports',
-                   'email', 'teams', 'meetings', 'onenote', 'sharepoint',
+                   'email', 'teams', 'meetings', 'onenote',
                    'crm-notes', 'ado-notes']) {
     await fs.access(path.join(p, 'Evidence', 'ushak', d));
   }