kushi-agents 3.14.0 → 3.15.0

package/bin/cli.mjs

@@ -25,6 +25,8 @@ if (args.includes('--help') || args.includes('-h')) {
   Options:
     --dest <path>       Override destination (relative for vscode, absolute for clawpilot)
     --force             Overwrite existing destination without asking
+    --yes, -y           Accept the default destination and skip the project-root
+                        check (useful for scripted or agent-driven installs)
     --no-settings       Skip .vscode/settings.json update (vscode target only)
     --no-instructions   Skip .github/copilot-instructions.md merge (vscode target only)
     --help, -h          Show this help
@@ -55,6 +57,7 @@ if (args.includes('--clawpilot')) {
 const options = {
   dest: getFlag('--dest'),
   force: args.includes('--force'),
+  yes: args.includes('--yes') || args.includes('-y'),
   noSettings: args.includes('--no-settings'),
   noInstructions: args.includes('--no-instructions'),
   target,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kushi-agents",
-  "version": "3.14.0",
+  "version": "3.15.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/src/constants.mjs

@@ -40,6 +40,46 @@ export const PROJECT_GITHUB_EXCLUDED_FILES = [
   'config/m365-mutable.json'
 ];
 
+/**
+ * Files / directories that indicate the cwd is a sane install target.
+ *
+ * Two flavors:
+ *   - 'code'       — a software project root (any common ecosystem).
+ *   - 'engagement' — a Kushi engagement folder (Evidence/State/integrations live here,
+ *                    or this dir already has a prior Kushi install / reference pack).
+ *
+ * Either flavor suppresses the "this directory does not look like a project root"
+ * warning. If neither is present and the directory is non-empty, the installer
+ * shows an actionable warning. If the directory is empty, it shows a friendly
+ * INFO message instead — empty dirs are the normal "starting fresh" case.
+ */
+export const PROJECT_MARKERS = [
+  // ── code project roots ──────────────────────────────────────────────────
+  { name: 'package.json',      kind: 'code', type: 'file' },
+  { name: '.git',              kind: 'code', type: 'dir'  },
+  { name: 'pyproject.toml',    kind: 'code', type: 'file' },
+  { name: 'requirements.txt',  kind: 'code', type: 'file' },
+  { name: 'Cargo.toml',        kind: 'code', type: 'file' },
+  { name: 'go.mod',            kind: 'code', type: 'file' },
+  { name: 'pom.xml',           kind: 'code', type: 'file' },
+  { name: 'build.gradle',      kind: 'code', type: 'file' },
+  { name: 'build.gradle.kts',  kind: 'code', type: 'file' },
+  { name: 'composer.json',     kind: 'code', type: 'file' },
+  { name: 'Gemfile',           kind: 'code', type: 'file' },
+  { name: 'mix.exs',           kind: 'code', type: 'file' },
+  // ── .NET (glob, not literal name) ───────────────────────────────────────
+  { glob: /\.csproj$/i,        kind: 'code', type: 'file' },
+  { glob: /\.fsproj$/i,        kind: 'code', type: 'file' },
+  { glob: /\.sln$/i,           kind: 'code', type: 'file' },
+  // ── Kushi engagement folders ────────────────────────────────────────────
+  { name: 'Evidence',          kind: 'engagement', type: 'dir'  },
+  { name: 'State',             kind: 'engagement', type: 'dir'  },
+  { name: 'integrations.yml',  kind: 'engagement', type: 'file' },
+  { name: 'integrations.yaml', kind: 'engagement', type: 'file' },
+  { name: '.kushi',            kind: 'engagement', type: 'dir'  },
+  { name: '.kushi-reference',  kind: 'engagement', type: 'dir'  },
+];
+
 /** VS Code settings keys → the .kushi subdirectory they point at. */
 export const SETTINGS_MAP = {
   'chat.agentFilesLocations':        'agents',

package/src/main.mjs

@@ -10,6 +10,7 @@ import {
   CLAWPILOT_AGENT_SOURCE,
   CLAWPILOT_SKILL_DEST,
   PLUGIN_SOURCE_DIR,
+  PROJECT_MARKERS,
 } from './constants.mjs';
 import { promptForDestination } from './prompt.mjs';
 import { copyAssets, copyProjectFiles } from './copy-assets.mjs';
@@ -82,14 +83,8 @@ export async function main(options = {}) {
  */
 async function installVscode(options, resolved, version) {
   const projectRoot = process.cwd();
-  const hasProjectMarker =
-    fs.existsSync(path.join(projectRoot, 'package.json')) ||
-    fs.existsSync(path.join(projectRoot, '.git'));
-
-  if (!hasProjectMarker) {
-    console.warn(
-      '  WARN: This directory does not look like a project root (no package.json or .git found). Proceeding anyway.\n',
-    );
+  if (!options.yes) {
+    warnIfNotProjectRoot(projectRoot);
   }
 
   let dest;
@@ -112,6 +107,8 @@ async function installVscode(options, resolved, version) {
       console.error('\n  Destination must be within the current project.\n');
       process.exit(1);
     }
+  } else if (options.yes) {
+    dest = DEFAULT_DEST;
   } else {
     dest = await promptForDestination(DEFAULT_DEST);
   }
@@ -276,4 +273,90 @@ async function confirmOverwriteIfExists(fullDest, displayDest, force) {
     console.log('\n  Cancelled.\n');
     process.exit(0);
   }
+}
+
+/**
+ * Detect whether the cwd looks like a sane install target and, if not, print
+ * an actionable message. Three cases:
+ *
+ *   1. A code marker (package.json, .git, pyproject.toml, *.csproj, ...) or an
+ *      engagement marker (Evidence/, State/, integrations.yml, .kushi/, ...)
+ *      is present → silent, proceed.
+ *   2. The directory is empty → friendly INFO ("starting fresh — Kushi will
+ *      create a new install here"). Empty dirs are the normal first-run case
+ *      and should not produce a WARN.
+ *   3. The directory has files but no recognized marker → WARN with the
+ *      actual fix (run `git init`, cd to an engagement folder, or pass --yes
+ *      to skip this check in scripted use).
+ *
+ * @param {string} projectRoot
+ */
+function warnIfNotProjectRoot(projectRoot) {
+  const marker = findProjectMarker(projectRoot);
+  if (marker) return;
+
+  let entries;
+  try {
+    entries = fs
+      .readdirSync(projectRoot)
+      .filter((n) => n !== '.DS_Store' && n !== 'Thumbs.db');
+  } catch {
+    entries = [];
+  }
+
+  if (entries.length === 0) {
+    console.log(
+      '  INFO: Empty directory detected — Kushi will create a fresh install here.\n',
+    );
+    return;
+  }
+
+  console.warn(
+    '  WARN: This directory has files but no recognized project marker',
+  );
+  console.warn(
+    '        (e.g. package.json, .git, pyproject.toml, *.csproj, or a Kushi',
+  );
+  console.warn(
+    '        engagement folder containing Evidence/, State/, or integrations.yml).',
+  );
+  console.warn('');
+  console.warn('  If this is intentional, press Enter to accept the default path.');
+  console.warn('  Otherwise, Ctrl+C and either:');
+  console.warn('    • run `git init` first (for a new code project), or');
+  console.warn('    • cd into your engagement folder (where Evidence/ lives), or');
+  console.warn('    • re-run with `--yes` to suppress this check in scripted use.\n');
+}
+
+/**
+ * Return the first matching project/engagement marker in `dir`, or null.
+ * @param {string} dir
+ * @returns {{ name: string, kind: 'code'|'engagement', type: 'file'|'dir' } | null}
+ */
+function findProjectMarker(dir) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+
+  for (const marker of PROJECT_MARKERS) {
+    if (marker.glob) {
+      const hit = entries.find(
+        (e) => e.isFile() && marker.glob.test(e.name),
+      );
+      if (hit) return { name: hit.name, kind: marker.kind, type: 'file' };
+      continue;
+    }
+    const hit = entries.find((e) => e.name === marker.name);
+    if (!hit) continue;
+    if (marker.type === 'dir' && hit.isDirectory()) {
+      return { name: marker.name, kind: marker.kind, type: 'dir' };
+    }
+    if (marker.type === 'file' && hit.isFile()) {
+      return { name: marker.name, kind: marker.kind, type: 'file' };
+    }
+  }
+  return null;
 }