fivocell 4.1.9 → 4.2.1

package/dist/core/agents-md.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURSORRULES_TEMPLATE = exports.AGENTS_MD_TEMPLATE = exports.CELL_RULES_MARKER = exports.CURSORRULES_FILENAME = exports.AGENTS_MD_FILENAME = void 0;
+exports.isCellRulesFile = isCellRulesFile;
+exports.writeAgentsMd = writeAgentsMd;
+exports.writeCursorRules = writeCursorRules;
+exports.writeCellRules = writeCellRules;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.AGENTS_MD_FILENAME = 'AGENTS.md';
+exports.CURSORRULES_FILENAME = '.cursorrules';
+exports.CELL_RULES_MARKER = '# fivo-cell:rules:v1';
+exports.AGENTS_MD_TEMPLATE = `${exports.CELL_RULES_MARKER}
+# FIVO Cell — AI Memory Rules
+
+FIVO Cell is installed and configured for this project. Use its MCP tools
+(named \`cell_*\`) to maintain permanent memory across sessions.
+
+## The @cell Convention
+
+Whenever the user types \`@cell\` in their message (e.g. "@cell what did I
+just edit?" or "@cell fix this bug"), you MUST do the following BEFORE
+responding:
+
+1. **Call \`cell_get_context\` FIRST** to load this project's full context.
+2. **Pass \`project\` as the current folder name** — derive it from
+   \`path.basename(process.cwd())\` or the absolute path the IDE is open
+   in. If unsure, call \`cell_list_projects\` and pick the matching one.
+3. **Also pass \`tool\`** set to your IDE/tool name so the block is
+   formatted for you (e.g. \`antigravity\`, \`cursor\`, \`opencode\`,
+   \`claude-code\`, \`codex\`, \`windsurf\`, \`copilot\`, \`aider\`).
+4. **Use the returned context** to inform your answer — it contains the
+   last session, recent file edits (live events), blind spots, style
+   hints, predictions, and tried approaches.
+
+## Common Cell Tools
+
+| Task | Tool |
+|------|------|
+| Load project context (\`@cell\`) | \`cell_get_context\` |
+| Open a work session | \`cell_session_start\` |
+| Close a session with key decisions | \`cell_session_end\` |
+| See recent sessions | \`cell_session_recent\` |
+| See recent file saves | \`cell_watch_events\` |
+| Start the file watcher | \`cell_watch_start\` |
+| Stop the file watcher | \`cell_watch_stop\` |
+| Detect code risks (try/catch, null checks, validation) | \`cell_blindspots\` |
+| Scan the project | \`cell_scan\` |
+| Log an error you hit | \`cell_log_error\` |
+| Log how you fixed it | \`cell_log_fix\` |
+| Log a key decision | \`cell_log_decision\` |
+| List all registered projects | \`cell_list_projects\` |
+
+There are 67 cell tools in total. Run \`cell --help\` to see all of them.
+
+## Session Discipline
+
+- **At the start of a non-trivial task** (multi-file work, refactor,
+  feature, debugging session): call \`cell_session_start\` to open a
+  session.
+- **At the end** (or before a long break): call \`cell_session_end\` with
+  \`keyDecisions\` summarising what you decided and \`filesTouched\`
+  listing the files you changed.
+- If the user switches tools (e.g. Cursor → Antigravity) within a
+  project, the bridge context is auto-loaded — read it from the @cell
+  block to understand what was just done.
+
+## Watcher Awareness
+
+- If the watcher is active, the @cell block includes the most recent
+  file edits. Trust those for "what did I just edit" questions.
+- If the user reports a file change you don't know about, call
+  \`cell_watch_events\` directly.
+
+## Anti-Patterns to Avoid
+
+- Do NOT guess a project name. If unsure, call \`cell_list_projects\`.
+- Do NOT skip \`cell_get_context\` when @cell is in the prompt — the
+  whole point of the convention is automatic context.
+- Do NOT call \`cell_get_context\` for every message. Only when @cell
+  appears, or when context is genuinely needed.
+- Do NOT modify or remove this file. To regenerate it, run
+  \`cell scan\` again (it is idempotent — existing files are kept).
+
+## Regeneration
+
+This file is auto-generated by \`cell scan\`. To remove it: \`cell scan --no-rules\`.
+`;
+exports.CURSORRULES_TEMPLATE = `${exports.CELL_RULES_MARKER}
+# FIVO Cell — Cursor Rules
+
+When the user types \`@cell\` in chat or Composer, you MUST call the
+\`cell_get_context\` MCP tool FIRST, with \`project\` set to the current
+folder name and \`tool\` set to \`cursor\`. Then use the returned block
+to inform your response. See AGENTS.md for the full convention.
+`;
+function isCellRulesFile(content) {
+    return content.includes(exports.CELL_RULES_MARKER);
+}
+function writeAgentsMd(projectPath, opts = {}) {
+    const filePath = path.join(projectPath, exports.AGENTS_MD_FILENAME);
+    if (fs.existsSync(filePath) && !opts.overwrite) {
+        return 'exists';
+    }
+    try {
+        fs.writeFileSync(filePath, exports.AGENTS_MD_TEMPLATE, 'utf8');
+        return 'written';
+    }
+    catch {
+        return 'skipped';
+    }
+}
+function writeCursorRules(projectPath, opts = {}) {
+    const filePath = path.join(projectPath, exports.CURSORRULES_FILENAME);
+    if (fs.existsSync(filePath) && !opts.overwrite) {
+        return 'exists';
+    }
+    try {
+        fs.writeFileSync(filePath, exports.CURSORRULES_TEMPLATE, 'utf8');
+        return 'written';
+    }
+    catch {
+        return 'skipped';
+    }
+}
+function writeCellRules(projectPath, opts = {}) {
+    const agentsMd = writeAgentsMd(projectPath, opts);
+    const cursorRules = opts.cursor === false ? 'skipped' : writeCursorRules(projectPath, opts);
+    return { agentsMd, cursorRules };
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/core/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../src/core/agents-md.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmGA,0CAEC;AAED,sCAWC;AAED,4CAWC;AAED,wCAIC;AArID,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,kBAAkB,GAAG,WAAW,CAAC;AACjC,QAAA,oBAAoB,GAAG,cAAc,CAAC;AACtC,QAAA,iBAAiB,GAAG,sBAAsB,CAAC;AAE3C,QAAA,kBAAkB,GAAG,GAAG,yBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ErD,CAAC;AAEW,QAAA,oBAAoB,GAAG,GAAG,yBAAiB;;;;;;;CAOvD,CAAC;AAQF,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,aAAa,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0BAAkB,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,0BAAkB,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,4BAAoB,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,4BAAoB,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,OAAkD,EAAE;IACtG,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}

package/dist/daemon/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiDrD,QAAA,MAAM,GAAG,6CAAY,CAAC;AAItB,QAAA,MAAM,OAAO;;;mBAGuB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChD,CAAC;AAulFF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiDrD,QAAA,MAAM,GAAG,6CAAY,CAAC;AAItB,QAAA,MAAM,OAAO;;;mBAGuB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChD,CAAC;AA2oFF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC"}

package/dist/daemon/server.js

@@ -1766,7 +1766,7 @@ const MCP_TOOLS = [
     { name: 'cell_deep_scan', description: 'Deep scan codebase', inputSchema: { type: 'object', properties: { dir: { type: 'string' }, project: { type: 'string' } }, required: ['dir'] } },
     { name: 'cell_scan_report', description: 'Full scan report', inputSchema: { type: 'object', properties: { project: { type: 'string' } }, required: ['project'] } },
     { name: 'cell_send_signal', description: 'Send learning signal', inputSchema: { type: 'object', properties: { type: { type: 'string' }, originalCode: { type: 'string' }, editedCode: { type: 'string' }, file: { type: 'string' }, language: { type: 'string' } }, required: ['type'] } },
-    { name: 'cell_get_context', description: 'Full context injection', inputSchema: { type: 'object', properties: { project: { type: 'string' }, tool: { type: 'string' } }, required: ['project'] } },
+    { name: 'cell_get_context', description: 'Full context injection. Pass `project` (folder name), or `cwd` (full path, auto-resolves basename), or omit to use daemon cwd. Pass `tool` for tool-specific formatting (cursor, antigravity, opencode, claude-code, codex, windsurf, copilot, aider).', inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project name (folder basename). Optional if cwd is provided.' }, cwd: { type: 'string', description: 'Absolute path to the project root. Will be resolved to its basename.' }, tool: { type: 'string', description: 'AI tool name for formatting' } }, required: [] } },
     { name: 'cell_scan_full_pc', description: 'Scan entire PC for all code projects', inputSchema: { type: 'object', properties: {} } },
     { name: 'cell_behavior_summary', description: 'Behavioral summary', inputSchema: { type: 'object', properties: { project: { type: 'string' } }, required: ['project'] } },
     { name: 'cell_log_error', description: 'Log an error encounter', inputSchema: { type: 'object', properties: { project: { type: 'string' }, file: { type: 'string' }, errorType: { type: 'string' }, errorMessage: { type: 'string' }, line: { type: 'number' } }, required: ['errorType', 'errorMessage'] } },
@@ -1869,9 +1869,65 @@ async function handleMCPToolCall(name, args) {
             }
             case 'cell_get_context': {
                 const { buildContext, formatContextForTool } = require('../core/prompt-builder');
-                const ctx = buildContext(args.project, args.tool);
-                const toolName = args.tool || (args.project ? 'claude-code' : undefined);
-                return { content: [{ type: 'text', text: formatContextForTool(ctx, toolName, args.project) }], context: ctx };
+                // Auto-detect project name when AI doesn't know it. Order of resolution:
+                //   1. args.project (explicit) — highest priority
+                //   2. args.cwd (IDE's current dir basename) — Antigravity/Cursor pass this
+                //   3. process.cwd() of the daemon (last resort)
+                // If still nothing, return a helpful error listing registered projects.
+                const explicitProject = args.project;
+                const cwdArg = args.cwd;
+                const path = require('path');
+                const fs = require('fs');
+                let resolvedProject = explicitProject;
+                if (!resolvedProject && cwdArg) {
+                    try {
+                        if (fs.existsSync(cwdArg)) {
+                            resolvedProject = path.basename(path.resolve(cwdArg));
+                        }
+                        else {
+                            // Maybe they passed just a folder name
+                            resolvedProject = path.basename(cwdArg);
+                        }
+                    }
+                    catch { /* fall through */ }
+                }
+                if (!resolvedProject) {
+                    try {
+                        resolvedProject = path.basename(process.cwd());
+                    }
+                    catch { /* ignore */ }
+                }
+                // If we have a project but no data, check if it's actually registered.
+                // If not, return a useful error with the list of known projects.
+                if (resolvedProject) {
+                    try {
+                        const { ProjectRegistry } = require('../core/project-registry');
+                        const reg = new ProjectRegistry();
+                        const projects = reg.listProjects();
+                        const known = projects.find((p) => p.name === resolvedProject || p.path === path.resolve(resolvedProject || ''));
+                        if (!known) {
+                            // Project name might still work if it matches `cwd` of a previous scan
+                            // or if it's the same as a directory basename. Don't error out — just
+                            // let buildContext handle the empty-data case naturally.
+                        }
+                    }
+                    catch { /* ignore */ }
+                }
+                const ctx = buildContext(resolvedProject, args.tool);
+                const toolName = args.tool || (resolvedProject ? 'claude-code' : undefined);
+                const formatted = formatContextForTool(ctx, toolName, resolvedProject);
+                // When no project resolved, prepend a hint to the output so the AI knows
+                // what to do next.
+                let hint = '';
+                if (!explicitProject && !cwdArg) {
+                    hint = '> Tip: pass `project` (folder name) or `cwd` (full path) for richer context.\n\n';
+                }
+                return {
+                    content: [{ type: 'text', text: hint + formatted }],
+                    context: ctx,
+                    resolvedProject: resolvedProject || null,
+                    hint: !explicitProject && !cwdArg ? 'pass `project` or `cwd` for richer context' : undefined,
+                };
             }
             case 'cell_scan_full_pc': {
                 const { scanFullPC } = require('../pc-scanner');