agy-insights 0.7.0 → 0.7.1

package/README.es.md

@@ -36,7 +36,7 @@ npx agy-insights
 npx agy-insights@latest --text
 ```
 
-`@latest` hace que npx compruebe cada vez si hay una versión nueva. Sin él, una copia instalada globalmente (`npm install -g`) o en el proyecto actual tiene prioridad y no se actualiza nunca. Para fijar una versión concreta: `npx agy-insights@0.7.0`.
+`@latest` hace que npx compruebe cada vez si hay una versión nueva. Sin él, una copia instalada globalmente (`npm install -g`) o en el proyecto actual tiene prioridad y no se actualiza nunca. Para fijar una versión concreta: `npx agy-insights@0.7.1`.
 
 **Instalándolo globalmente:**
 
@@ -87,7 +87,7 @@ Arriba están el selector de periodo y los totales. Después, una gráfica de **
 | Hallazgo | Qué significa | Qué hacer |
 |---|---|---|
 | El agente vuelve a leer lo que ya tenía | Lee otra vez un trozo de fichero que ya estaba en la conversación | Sesiones más cortas, una por tarea, o `/compact`. No excluyas el fichero: lo necesita. |
-| Ficheros generados, compilados o de dependencias | Lecturas de `bin/`, `obj/`, `dist/`, `node_modules`, migraciones, lockfiles o logs | Si no hacían falta, exclúyelos (ver abajo) |
+| Ficheros generados, compilados o de dependencias | Lecturas de `bin/`, `obj/`, `dist/`, `node_modules`, migraciones, lockfiles o logs (nunca cuentan los ficheros propios de Antigravity en `~/.gemini`, como su brain, ni una carpeta `build/` o `bin/` que git mantiene en el repo, como una configuración de webpack) | Si no hacían falta, exclúyelos (ver abajo) |
 | Los mismos ficheros entran en muchas sesiones | Un fichero se lee en varias conversaciones distintas | Si es código central es normal; si es grande, dile al agente qué parte mirar |
 | Comandos con salidas muy largas | La salida de tests o builds entra entera | Pide ejecutar solo el test o proyecto afectado |
 | Sesiones muy largas | Todo lo acumulado se reenvía en cada turno | Una conversación nueva por tarea |

package/README.md

@@ -36,7 +36,7 @@ npx agy-insights
 npx agy-insights@latest --text
 ```
 
-`@latest` makes npx check for the newest version every time. Without it, a copy installed globally (`npm install -g`) or in the current project takes precedence and is never updated. To pin a version instead: `npx agy-insights@0.7.0`.
+`@latest` makes npx check for the newest version every time. Without it, a copy installed globally (`npm install -g`) or in the current project takes precedence and is never updated. To pin a version instead: `npx agy-insights@0.7.1`.
 
 **Globally:**
 
@@ -87,7 +87,7 @@ At the top, the period selector and the totals. Then a chart of **token usage pe
 | Finding | What it means | What to do |
 |---|---|---|
 | The agent re-reads what it already had | It reads again a chunk of a file that was already in the conversation | Shorter sessions, one per task, or `/compact`. Don't exclude the file: the agent needs it. |
-| Generated, build or dependency files are being read | Reads from `bin/`, `obj/`, `dist/`, `node_modules`, migrations, lockfiles or logs | If they weren't needed, exclude them (see below) |
+| Generated, build or dependency files are being read | Reads from `bin/`, `obj/`, `dist/`, `node_modules`, migrations, lockfiles or logs (Antigravity's own files in `~/.gemini`, such as its brain, never count; nor does a `build/` or `bin/` folder that git keeps in the repo, like a webpack config) | If they weren't needed, exclude them (see below) |
 | The same files enter many sessions | A file is read in several different conversations | Normal for core code; if it is large, tell the agent which part to look at |
 | Commands with very long output | The full output of tests or builds enters the context | Ask it to run only the affected test or project |
 | Very long sessions | Everything accumulated is resent on every turn | A new conversation per task |

package/docs/how-it-works.md

@@ -58,6 +58,10 @@ The project of each file is detected by walking up its path until a folder with
 
 All user-facing text lives in `lib/i18n.js`, in an `en` and an `es` table with the same keys (a test checks it). Modules read it through `t`, which always points at the current language. The language comes from `--lang`, then the `lang` config key, then the system locale (`LC_ALL`, `LC_MESSAGES`, `LANG`, `LANGUAGE`, or `Intl`): Spanish if it starts with `es`, English otherwise. Numbers follow it too (`en-US` / `es-ES`).
 
+Folder names alone are not enough for build output: `build/webpack/` or `bin/` often hold sources. When the file's repo is on this machine, `repoFiles()` asks git for the files it does not ignore (`git ls-files --cached --others --exclude-standard`, once per repo), and a file in that list is never kind `build`. `--map` does the same, since it lists files through git. Without git, or for a repo that is not on this machine, the folder name decides.
+
+Anything under `~/.gemini/` is kind `agent`: the agent's own brain (plans, artifacts, its logs) and skills. It is checked first and is not in `NON_SOURCE`, so those reads are never reported as generated files or proposed for exclusion, even when a path contains `out/` or ends in `.log`.
+
 Built-in file kinds are stable ids (`build`, `logs`, `generated`, `code .cs`…) and are only turned into text when shown, with `kindLabel()`. Kinds from `customKinds` are shown as the user wrote them.
 
 To add a message, add it to both tables. To add a language, add a table and teach `detect()` to pick it.

package/lib/history.js

@@ -5,6 +5,7 @@
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { spawnSync } = require('child_process');
 
 const DEFAULT_DIR = path.join(os.homedir(), '.gemini', 'antigravity-cli', 'conversations');
 const BYTES_PER_TOKEN = 4;
@@ -125,9 +126,18 @@ const key = (p) => norm(p).toLowerCase().replace(/\/+$/, '');
 // Kinds are stable ids; i18n.kindLabel() turns them into text.
 const NON_SOURCE = new Set(['node_modules', 'build', 'lockfiles', 'logs', 'generated']);
 
-function kind(p) {
+/**
+ * @param {string} p path with "/" separators
+ * @param {object} [opts]
+ * @param {boolean} [opts.inRepo] git says the file is part of the repo (not ignored): a build/ or bin/
+ *   folder then holds sources (webpack config, CLI scripts), not build output.
+ */
+function kind(p, { inRepo = false } = {}) {
+  // Antigravity's own data (the agent's brain: plans, artifacts, logs; and skills): it needs them, so they
+  // are never reported as generated or proposed for exclusion, whatever their names look like.
+  if (/(^|\/)\.gemini\//i.test(p)) return 'agent';
   if (/(^|\/)node_modules\//.test(p)) return 'node_modules';
-  if (/(^|\/)(dist|build|out|target|coverage|\.next|bin|obj)\//i.test(p)) return 'build';
+  if (!inRepo && /(^|\/)(dist|build|out|target|coverage|\.next|bin|obj)\//i.test(p)) return 'build';
   if (/(package-lock\.json|yarn\.lock|pnpm-lock\.yaml|packages\.lock\.json|\.lock)$/.test(p)) return 'lockfiles';
   if (/\.(log|map)$|\.min\.(js|css)$/.test(p)) return 'logs';
   if (/(^|\/)(tests?|__tests__|specs?)\//i.test(p) || /\.(test|spec|tests?)\.\w+$/i.test(p) || /Tests?\//.test(p)) return 'tests';
@@ -136,6 +146,17 @@ function kind(p) {
   return ext ? `code ${ext}` : 'other';
 }
 
+// Files of a git repo that git does not ignore (tracked, or untracked and not ignored), lowercased and
+// relative to the root; null when git cannot tell (no git, or the repo is not on this machine).
+const repoFilesCache = new Map();
+function repoFiles(root) {
+  if (!repoFilesCache.has(root)) {
+    const git = spawnSync('git', ['ls-files', '--cached', '--others', '--exclude-standard', '-z'], { cwd: root, encoding: 'utf8', maxBuffer: 1 << 28, windowsHide: true });
+    repoFilesCache.set(root, git.status === 0 ? new Set(git.stdout.split('\0').filter(Boolean).map((f) => f.toLowerCase())) : null);
+  }
+  return repoFilesCache.get(root);
+}
+
 // Project root of a file: an explicit workspace containing it, or else the nearest folder with a .git
 // entry, when the path exists on this machine. Null when unknown (e.g. a repo that was deleted).
 const rootCache = new Map();
@@ -229,7 +250,9 @@ class Counter {
  */
 async function analyze({ dir = DEFAULT_DIR, workspaces = [], customKinds = {}, since = null } = {}) {
   const custom = Object.entries(customKinds).map(([re, label]) => [new RegExp(re, 'i'), label]);
-  const classify = (p) => custom.find(([re]) => re.test(p))?.[1] || kind(p);
+  // A file git keeps in the repo is never build output, whatever its folder is called.
+  const classify = (p, root, rel) => custom.find(([re]) => re.test(p))?.[1]
+    || kind(p, { inRepo: Boolean(root && repoFiles(root)?.has(rel.toLowerCase())) });
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'agy-insights-'));
   const r = {
     dir, backend: nodeSqlite ? 'node:sqlite' : 'sql.js', conversations: 0, unreadable: 0, steps: 0, tokens: 0,
@@ -303,7 +326,7 @@ async function analyze({ dir = DEFAULT_DIR, workspaces = [], customKinds = {}, s
 
             // Folders and files are keyed by absolute path: several projects can share relative paths.
             const { root, project, rel, folderRel, folderAbs } = locate(file, workspaces);
-            const k = classify(file);
+            const k = classify(file, root, rel);
             const fields = { calls, tokens, rereads: isNew ? reread : 0, rereadTokens: reread * tokens };
             kinds.add(k, { ...fields, convs: once(seenKinds, k) }, { nonSource: NON_SOURCE.has(k) });
             projects.add(root || '', { ...fields, convs: once(seenProjects, root || '') }, { project });

package/lib/i18n.js

@@ -36,6 +36,7 @@ Options:
   done: (convs, found, out) => `${plural(convs, 'conversation', 'conversations')} analyzed, ${plural(found, 'finding', 'findings')}.\nReport: ${out}`,
 
   kinds: {
+    agent: "Antigravity's own files (brain, skills)",
     build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minified', generated: 'generated code / migrations',
     other: 'other', code: (ext) => `code ${ext}`,
   },
@@ -197,6 +198,7 @@ Opciones:
   done: (convs, found, out) => `${plural(convs, 'conversación analizada', 'conversaciones analizadas')}, ${plural(found, 'hallazgo', 'hallazgos')}.\nInforme: ${out}`,
 
   kinds: {
+    agent: 'ficheros propios de Antigravity (brain, skills)',
     build: 'build output (dist, bin, obj…)', logs: 'logs, maps, minificados', generated: 'código generado / migraciones',
     other: 'otros', code: (ext) => `código ${ext}`,
   },

package/lib/map.js

@@ -15,10 +15,10 @@ const SKIP_DIRS = new Set(['.git', 'node_modules', '.vs', '.vscode', '.idea', '.
 const BYTES_PER_TOKEN = 4;
 
 // Project files relative to `root`, with "/" separators: tracked plus untracked-but-not-ignored when
-// it is a git repo, else a plain walk.
+// it is a git repo (`inRepo`: none of them is ignored build output), else a plain walk.
 function listFiles(root) {
   const git = spawnSync('git', ['ls-files', '--cached', '--others', '--exclude-standard', '-z'], { cwd: root, encoding: 'utf8', maxBuffer: 1 << 28 });
-  if (git.status === 0) return [...new Set(git.stdout.split('\0').filter(Boolean))];
+  if (git.status === 0) return { files: [...new Set(git.stdout.split('\0').filter(Boolean))], inRepo: true };
   const out = [];
   const walk = (rel) => {
     for (const e of fs.readdirSync(path.join(root, rel), { withFileTypes: true })) {
@@ -27,7 +27,7 @@ function listFiles(root) {
     }
   };
   walk('');
-  return out;
+  return { files: out, inRepo: false };
 }
 
 // Line count of a text file; null for binaries or unreadable files.
@@ -71,11 +71,12 @@ function mainFolders(files, maxFolders) {
  */
 function buildMap(root, opts = {}) {
   const o = { ...DEFAULTS, ...opts };
-  const all = listFiles(root);
+  const { files: all, inRepo } = listFiles(root);
   const generated = new Set(), source = [];
   for (const f of all) {
-    const g = NON_SOURCE.has(kind(f)) ? generatedFolder(f) : null;
-    if (g) generated.add(g); else if (!NON_SOURCE.has(kind(f))) source.push(f);
+    const nonSource = NON_SOURCE.has(kind(f, { inRepo }));
+    const g = nonSource ? generatedFolder(f) : null;
+    if (g) generated.add(g); else if (!nonSource) source.push(f);
   }
   const reads = new Map((o.history || []).filter((h) => h.root).map((h) => [`${h.root}/${h.rel}`.toLowerCase(), h.calls]));
   const rootNorm = root.replace(/[\\/]+/g, '/').replace(/\/$/, '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-insights",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Measures Antigravity CLI token usage and shows which context is sent repeatedly or needlessly, in English or Spanish. Run: npx agy-insights@latest",
   "license": "MIT",
   "keywords": [