feat: mantis project can read text from a file

Add --file <path> so the text to project can come from a file instead of an
inline argument. The positional is now optional ([text]); pass exactly one of
text or --file (both → error, neither → the existing "provide text" error).
Missing file reports a clean "File not found" rather than a raw ENOENT.

File reading stays at the command layer; ProjectionService is unchanged (still
receives text), so the `mantis use project` tool surface is unaffected.

Bumps 3.5.0 -> 3.5.1.

Author: AnasMaar

README.md

@@ -79,7 +79,7 @@ See the [Claude Code guide](https://mantis.csail.mit.edu/docs/mantis-cli/claude-
 | `mantis use <tool>` | Call any MCP tool (JSON output) |
 | `mantis create map <file>` | Build a map from a local CSV/XLSX |
 | `mantis create codebase [root]` | Index a repo into CSV; add `--create-map` to embed it |
-| `mantis project <text> --map-id <id>` | Project text onto a map; returns the new point's URI |
+| `mantis project <text\|--file f> --map-id <id>` | Project text (or a file's contents) onto a map; returns the new point's URI |
 
 ## The `mantis use` toolbox
 

bin/mantis.js

@@ -512,17 +512,26 @@ addMapOptions(create
 
 
 program
-  .command('project <text>')
+  .command('project [text]')
   .description('Project text onto a map; persists a point and returns its URI')
   .requiredOption('--map-id <id>', 'target map (UUID or Mantis link)')
+  .option('--file <path>', 'read the text to project from a file instead of an argument')
   .option('--embedding <json>', 'project a raw embedding instead of text (JSON array)')
   .option('--service-name <name>', 'embedding service override')
   .option('--model <name>', 'embedding model override')
   .option('--no-persist', 'preview coordinates only, without creating a point')
   .action(async (text, opts) => {
     try {
+      if (text && opts.file) {
+        throw new Error('Pass either a text argument or --file, not both.');
+      }
+      let source = text;
+      if (opts.file) {
+        if (!fs.existsSync(opts.file)) throw new Error(`File not found: ${opts.file}`);
+        source = fs.readFileSync(opts.file, 'utf8');
+      }
       const embedding = opts.embedding ? JSON.parse(opts.embedding) : undefined;
-      const result = await projection.project(text, {
+      const result = await projection.project(source, {
         mapId: opts.mapId,
         embedding,
         serviceName: opts.serviceName,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mantisai-cli",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "Mantis CLI — spaces, maps, and MCP tools for AI coding agents",
   "type": "module",
   "license": "MIT",