ctxtop 4.0.0 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHECKSUMS.sha256 +59 -42
  4. package/README.md +351 -330
  5. package/bin/ah-statusline.mjs +30 -0
  6. package/bin/ctxtop.mjs +330 -5
  7. package/config/default_flightcheck.json +19 -0
  8. package/config/modelCatalog.json +165 -0
  9. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  10. package/hooks/handlers/config-change.mjs +402 -0
  11. package/hooks/handlers/hookIo.mjs +56 -0
  12. package/hooks/handlers/post-model-switch.mjs +111 -0
  13. package/hooks/handlers/post-tool-use.mjs +117 -16
  14. package/hooks/handlers/pre-model-switch.mjs +823 -24
  15. package/hooks/handlers/pre-tool-use.mjs +271 -4
  16. package/hooks/handlers/stop-gate.mjs +297 -11
  17. package/hooks/handlers/user-prompt-submit.mjs +224 -0
  18. package/hooks/hooks.json +50 -0
  19. package/hooks/post_tool_use.mjs +8 -0
  20. package/hooks/register.js +48 -9
  21. package/hooks/session_start.mjs +11 -1
  22. package/hooks/stop.mjs +11 -1
  23. package/package.json +11 -4
  24. package/packages/antigravity/package.json +1 -1
  25. package/packages/claude-code/package.json +1 -1
  26. package/packages/core/package.json +1 -1
  27. package/packages/engine-node/package.json +1 -1
  28. package/packages/mcp/package.json +1 -1
  29. package/packages/mcp/src/server.mjs +1 -1
  30. package/packages/pro/package.json +1 -1
  31. package/plugin.json +1 -1
  32. package/sidecars/horizon-daemon/server.mjs +38 -2
  33. package/skills/handoff/SKILL.md +8 -0
  34. package/src/adapters/antigravity/index.mjs +31 -1
  35. package/src/adapters/claude-code/index.mjs +40 -1
  36. package/src/cli/horizon_hud.mjs +254 -52
  37. package/src/config/modelCatalog.json +84 -0
  38. package/src/core/bucket_b_runtime.mjs +1200 -0
  39. package/src/core/constants.mjs +191 -4
  40. package/src/core/detectors_det01_to_16.mjs +54 -5
  41. package/src/core/doc_indexer.mjs +338 -0
  42. package/src/core/layer5_hygiene.mjs +118 -0
  43. package/src/core/parser.mjs +2 -1
  44. package/src/core/paths.mjs +3 -2
  45. package/src/core/rsl_clash_auditor.mjs +423 -0
  46. package/src/core/rsl_distiller.mjs +372 -0
  47. package/src/core/rsl_ledger.mjs +969 -0
  48. package/src/core/rsl_triage.mjs +909 -0
  49. package/src/core/session_auditor.mjs +658 -0
  50. package/src/core/shield_manager.mjs +1417 -0
  51. package/src/core/task_quota_router.mjs +1 -1
  52. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  53. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  54. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +305 -0
  55. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  56. package/src/core-isomorphic/config/anthropicModelCatalog.json +404 -1
  57. package/src/core-isomorphic/config/catalogLoader.mjs +546 -46
  58. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  59. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  60. package/src/core-isomorphic/economics/cacheGravity.mjs +18 -0
  61. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  62. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  63. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  64. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  65. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  66. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  67. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  68. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  69. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  70. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  71. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  72. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  73. package/src/core-isomorphic/index.js +1 -0
  74. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +36 -12
  75. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +293 -237
  76. package/src/core-isomorphic/ui/modViews.mjs +35 -9
  77. package/src/diagnostics/claudeHookCapabilities.mjs +396 -0
  78. package/src/diagnostics/doctorEngine.mjs +95 -3
  79. package/src/engine-node/db/probe.mjs +234 -2
  80. package/src/engine-node/index.mjs +3 -0
  81. package/src/engine-node/sensors/blindspots.mjs +13 -6
  82. package/src/hooks/antigravity_rsl_hook.mjs +250 -0
  83. package/src/hooks/claude_rsl_hook.mjs +288 -0
  84. package/src/hooks/post_invocation.mjs +196 -4
  85. package/src/hooks/pre_invocation.mjs +732 -22
  86. package/src/hooks/session_start.mjs +39 -1
  87. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  88. package/src/utils/sessionCalibration.mjs +657 -0
  89. package/src/webview/horizon_panel.html +1325 -317
@@ -0,0 +1,551 @@
1
+ /**
2
+ * @file src/core-isomorphic/guards/slopsquatGate.mjs
3
+ * Guardrail #6 (`SLOPSQUAT_DEP_GATE`): Supply-Chain Slopsquatting & Conflation Gate.
4
+ *
5
+ * Pure isomorphic module (Mod Law 4 compliant: zero `node:*` imports, zero network I/O).
6
+ * - Phase 1 (`<5ms` offline): Parses `npm`/`pnpm`/`yarn`/`bun`/`pip`/`uv`/`poetry`/`cargo` install commands,
7
+ * auto-allows existing manifest/lockfile deps, `workspace:*`/`file:` protocols, and private `.npmrc` /
8
+ * `--index-url` scopes, and detects Damerau-Levenshtein-1 typos + empirical LLM package conflations.
9
+ * - Phase 2 (Optional metadata evaluation): Evaluates registry metadata with strict fail-open semantics
10
+ * on offline/timeout faults (`0%` false-deny on airgapped or private-registry environments).
11
+ */
12
+
13
+ /**
14
+ * Canonical high-traffic packages across npm, PyPI, and Crates used for distance-1 slopsquat detection.
15
+ */
16
+ export const POPULAR_ECOSYSTEM_PACKAGES = Object.freeze({
17
+ npm: Object.freeze([
18
+ 'react', 'react-dom', 'next', 'vue', 'svelte', 'angular', 'solid-js', 'preact',
19
+ 'express', 'fastify', 'koa', 'hono', 'nestjs', 'socket.io', 'ws', 'cors', 'helmet',
20
+ 'lodash', 'underscore', 'ramda', 'immer', 'rxjs', 'zustand', 'jotai', 'redux',
21
+ 'axios', 'node-fetch', 'undici', 'ky', 'got', 'superagent', 'graphql', 'apollo-server',
22
+ 'typescript', 'tslib', 'tsx', 'ts-node', 'esbuild', 'vite', 'rollup', 'webpack', 'parcel',
23
+ 'eslint', 'prettier', 'biome', 'stylelint', 'husky', 'lint-staged', 'jscodeshift',
24
+ 'vitest', 'jest', 'mocha', 'chai', 'sinon', 'playwright', 'cypress', 'puppeteer',
25
+ 'tailwindcss', 'postcss', 'autoprefixer', 'sass', 'less', 'clsx', 'classnames', 'tailwind-merge',
26
+ 'lucide-react', 'heroicons', 'framer-motion', 'radix-ui', 'cmdk', 'sonner', 'vaul',
27
+ 'zod', 'yup', 'joi', 'valibot', 'ajv', 'superstruct', 'typebox',
28
+ 'prisma', '@prisma/client', 'drizzle-orm', 'typeorm', 'sequelize', 'mongoose', 'knex', 'pg',
29
+ 'mysql2', 'sqlite3', 'better-sqlite3', 'ioredis', 'redis', 'mongodb',
30
+ 'dotenv', 'cross-env', 'chalk', 'picocolors', 'kleur', 'ora', 'inquirer', 'prompts',
31
+ 'commander', 'yargs', 'minimist', 'cac', 'arg', 'execa', 'zx', 'glob', 'fast-glob', 'chokidar',
32
+ 'date-fns', 'dayjs', 'moment', 'luxon', 'uuid', 'nanoid', 'ulid', 'semver', 'ms', 'debug',
33
+ 'jsonwebtoken', 'jose', 'bcrypt', 'bcryptjs', 'argon2', 'passport', 'next-auth', 'lucia',
34
+ 'stripe', 'openai', 'anthropic', 'langchain', 'ai', 'cheerio', 'jsdom', 'marked', 'shiki',
35
+ 'winston', 'pino', 'morgan', 'sentry', 'bullmq', 'nodemailer', 'resend', 'sharp', 'multer'
36
+ ]),
37
+ pypi: Object.freeze([
38
+ 'requests', 'urllib3', 'httpx', 'aiohttp', 'fastapi', 'uvicorn', 'starlette', 'flask',
39
+ 'django', 'gunicorn', 'celery', 'werkzeug', 'jinja2', 'itsdangerous', 'click', 'typer',
40
+ 'rich', 'tqdm', 'colorama', 'loguru', 'structlog', 'pydantic', 'pydantic-settings',
41
+ 'marshmallow', 'attrs', 'sqlalchemy', 'alembic', 'psycopg2', 'psycopg2-binary', 'asyncpg',
42
+ 'pymongo', 'redis', 'pymysql', 'aiosqlite', 'peewee', 'tortoise-orm', 'sqlmodel',
43
+ 'numpy', 'pandas', 'scipy', 'matplotlib', 'seaborn', 'plotly', 'polars', 'pyarrow',
44
+ 'scikit-learn', 'torch', 'torchvision', 'torchaudio', 'tensorflow', 'keras', 'jax',
45
+ 'transformers', 'datasets', 'accelerate', 'diffusers', 'tokenizers', 'huggingface-hub',
46
+ 'openai', 'anthropic', 'langchain', 'llama-index', 'tiktoken', 'chromadb', 'qdrant-client',
47
+ 'pytest', 'pytest-asyncio', 'pytest-cov', 'hypothesis', 'coverage', 'mypy', 'ruff', 'black',
48
+ 'isort', 'flake8', 'pylint', 'bandit', 'pre-commit', 'tox', 'nox', 'virtualenv', 'poetry',
49
+ 'boto3', 'botocore', 's3transfer', 'google-cloud-storage', 'azure-storage-blob',
50
+ 'cryptography', 'pyjwt', 'bcrypt', 'passlib', 'pynacl', 'certifi', 'charset-normalizer',
51
+ 'idna', 'pyyaml', 'toml', 'tomli', 'python-dotenv', 'python-multipart', 'python-dateutil',
52
+ 'pytz', 'arrow', 'pendulum', 'pillow', 'opencv-python', 'beautifulsoup4', 'lxml', 'scrapy',
53
+ 'selenium', 'playwright', 'paramiko', 'fabric', 'psutil', 'tenacity', 'orjson', 'ujson'
54
+ ]),
55
+ cargo: Object.freeze([
56
+ 'serde', 'serde_json', 'tokio', 'reqwest', 'clap', 'anyhow', 'thiserror', 'tracing',
57
+ 'tracing-subscriber', 'futures', 'async-trait', 'axum', 'actix-web', 'hyper', 'tower',
58
+ 'sqlx', 'diesel', 'rusqlite', 'redis', 'rand', 'regex', 'chrono', 'time', 'uuid',
59
+ 'itertools', 'rayon', 'crossbeam', 'parking_lot', 'once_cell', 'lazy_static', 'bytes',
60
+ 'log', 'env_logger', 'eyre', 'color-eyre', 'tempfile', 'proptest', 'criterion', 'syn',
61
+ 'quote', 'proc-macro2', 'bindgen', 'cc', 'sha2', 'hmac', 'base64', 'hex', 'url', 'dotenvy'
62
+ ])
63
+ });
64
+
65
+ /**
66
+ * Empirically observed LLM package hallucinations & cross-package conflations (USENIX / Socket / Phylum).
67
+ */
68
+ export const KNOWN_LLM_CONFLATIONS = Object.freeze({
69
+ 'react-codeshift': 'Conflation of `jscodeshift` and `react-codemod`',
70
+ 'unused-imports': 'Conflation of `eslint-plugin-unused-imports`',
71
+ 'nextjs-auth': 'Hallucinated conflation of `next-auth`',
72
+ 'tailwind-merge-classes': 'Hallucinated conflation of `tailwind-merge` + `clsx`',
73
+ 'zod-validator': 'Hallucinated wrapper around `zod`',
74
+ 'prisma-orm': 'Hallucinated alias for `prisma` / `@prisma/client`',
75
+ 'lucide-icons': 'Hallucinated conflation of `lucide-react`',
76
+ 'shadcn-ui-react': 'Hallucinated npm package (`shadcn` uses CLI component copy)',
77
+ 'express-jwt-auth': 'Hallucinated conflation of `express-jwt`',
78
+ 'axios-retry-client': 'Hallucinated conflation of `axios-retry`',
79
+ 'jest-dom-extended': 'Hallucinated conflation of `@testing-library/jest-dom`',
80
+ 'chalk-cli-colors': 'Hallucinated conflation of `chalk` + `cli-color`',
81
+ 'dotenv-safe-cli': 'Hallucinated conflation of `dotenv-safe` + `dotenv-cli`',
82
+ 'huggingface-cli': 'PyPI slopsquat for `huggingface-hub` (which provides the `huggingface-cli` binary)',
83
+ 'fastapi-cors': 'Hallucinated PyPI package (`CORSMiddleware` is built into `fastapi`)',
84
+ 'openai-whisper-api': 'Hallucinated conflation of `openai` + `openai-whisper`',
85
+ 'python-dotenv-cli': 'Hallucinated conflation of `python-dotenv`',
86
+ 'boto3-stubs-all': 'Hallucinated conflation of `boto3-stubs`',
87
+ 'urllib4': 'Hallucinated successor to `urllib3`',
88
+ 'sklearn-utils': 'Hallucinated companion to `scikit-learn`'
89
+ });
90
+
91
+ const FLAGS_WITH_VALUE = new Set([
92
+ '--registry',
93
+ '--index-url',
94
+ '--extra-index-url',
95
+ '-i',
96
+ '-r',
97
+ '--requirement',
98
+ '-c',
99
+ '--constraint',
100
+ '-w',
101
+ '--workspace',
102
+ '--filter',
103
+ '--prefix',
104
+ '-C',
105
+ '--dir',
106
+ '--features',
107
+ '--trusted-host',
108
+ '--target',
109
+ '-t',
110
+ '--cache-dir',
111
+ '--find-links',
112
+ '-f'
113
+ ]);
114
+
115
+ /**
116
+ * Computes optimal string alignment (Damerau-Levenshtein) distance with fast early exit for `> 1`.
117
+ *
118
+ * @param {string} a
119
+ * @param {string} b
120
+ * @returns {number} `0`, `1`, or `2` (`2` means distance `>= 2`)
121
+ */
122
+ export function damerauLevenshteinMax1(a = '', b = '') {
123
+ if (a === b) return 0;
124
+ const la = a.length;
125
+ const lb = b.length;
126
+ if (Math.abs(la - lb) > 1) return 2;
127
+
128
+ const prevPrev = new Array(lb + 1).fill(0);
129
+ const prev = new Array(lb + 1).fill(0);
130
+ const curr = new Array(lb + 1).fill(0);
131
+ for (let j = 0; j <= lb; j++) prev[j] = j;
132
+
133
+ for (let i = 1; i <= la; i++) {
134
+ curr[0] = i;
135
+ let rowMin = curr[0];
136
+ for (let j = 1; j <= lb; j++) {
137
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1;
138
+ let val = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
139
+ if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
140
+ val = Math.min(val, prevPrev[j - 2] + 1);
141
+ }
142
+ curr[j] = val;
143
+ if (val < rowMin) rowMin = val;
144
+ }
145
+ if (rowMin > 1) return 2;
146
+ for (let j = 0; j <= lb; j++) {
147
+ prevPrev[j] = prev[j];
148
+ prev[j] = curr[j];
149
+ }
150
+ }
151
+ return prev[lb] <= 1 ? prev[lb] : 2;
152
+ }
153
+
154
+ /**
155
+ * Normalizes a package specifier token into `{ name, raw, isLocalOrProtocol, scope }`.
156
+ *
157
+ * @param {string} rawSpec
158
+ * @param {'npm' | 'pypi' | 'cargo'} ecosystem
159
+ */
160
+ export function normalizePackageSpec(rawSpec = '', ecosystem = 'npm') {
161
+ const raw = String(rawSpec || '').trim().replace(/^['"]|['"]$/g, '');
162
+ if (!raw) return null;
163
+
164
+ if (
165
+ raw === '.' ||
166
+ raw.startsWith('./') ||
167
+ raw.startsWith('../') ||
168
+ raw.startsWith('/') ||
169
+ raw.startsWith('workspace:') ||
170
+ raw.startsWith('file:') ||
171
+ raw.startsWith('link:') ||
172
+ raw.startsWith('portal:') ||
173
+ raw.startsWith('git+') ||
174
+ raw.startsWith('http://') ||
175
+ raw.startsWith('https://') ||
176
+ raw.startsWith('github:') ||
177
+ /\.(?:tgz|tar\.gz|whl|zip)$/i.test(raw)
178
+ ) {
179
+ return { raw, name: raw, scope: '', isLocalOrProtocol: true };
180
+ }
181
+
182
+ if (ecosystem === 'npm') {
183
+ if (raw.startsWith('@')) {
184
+ const slashIdx = raw.indexOf('/');
185
+ if (slashIdx <= 1) return null;
186
+ const scope = raw.slice(0, slashIdx).toLowerCase();
187
+ const rest = raw.slice(slashIdx + 1);
188
+ const atVerIdx = rest.indexOf('@');
189
+ const pkgPart = atVerIdx > 0 ? rest.slice(0, atVerIdx) : rest;
190
+ const verPart = atVerIdx > 0 ? rest.slice(atVerIdx + 1) : '';
191
+ if (verPart.startsWith('workspace:') || verPart.startsWith('file:') || verPart.startsWith('link:')) {
192
+ return { raw, name: `${scope}/${pkgPart}`.toLowerCase(), scope, isLocalOrProtocol: true };
193
+ }
194
+ return {
195
+ raw,
196
+ name: `${scope}/${pkgPart}`.toLowerCase(),
197
+ scope,
198
+ isLocalOrProtocol: false
199
+ };
200
+ }
201
+ const atIdx = raw.indexOf('@');
202
+ const name = (atIdx > 0 ? raw.slice(0, atIdx) : raw).toLowerCase();
203
+ const verPart = atIdx > 0 ? raw.slice(atIdx + 1) : '';
204
+ if (verPart.startsWith('workspace:') || verPart.startsWith('file:') || verPart.startsWith('link:')) {
205
+ return { raw, name, scope: '', isLocalOrProtocol: true };
206
+ }
207
+ return { raw, name, scope: '', isLocalOrProtocol: false };
208
+ }
209
+
210
+ if (ecosystem === 'pypi') {
211
+ // Strip extras `pkg[standard]` and PEP 440 version operators `==`, `>=`, `<=`, `~=`, `!=`, `<`, `>`
212
+ const base = raw.split(/[=<>~!;\s[]/)[0].trim().toLowerCase().replace(/_/g, '-');
213
+ if (!base) return null;
214
+ return { raw, name: base, scope: '', isLocalOrProtocol: false };
215
+ }
216
+
217
+ // cargo
218
+ const base = raw.split('@')[0].trim().toLowerCase();
219
+ return base ? { raw, name: base, scope: '', isLocalOrProtocol: false } : null;
220
+ }
221
+
222
+ /**
223
+ * Parses a shell command string to extract package-manager install invocations.
224
+ *
225
+ * @param {string} command
226
+ * @returns {Array<{ ecosystem: 'npm'|'pypi'|'cargo', manager: string, packages: Array<object>, hasCustomRegistry: boolean, isLockfileSyncOnly: boolean }>}
227
+ */
228
+ export function parsePackageInstallCommands(command = '') {
229
+ const cmdText = String(command || '').trim();
230
+ if (!cmdText) return [];
231
+
232
+ const segments = cmdText.split(/\s*(?:&&|\|\||;|\n)\s*/).filter(Boolean);
233
+ const invocations = [];
234
+
235
+ for (const seg of segments) {
236
+ const tokens = seg.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) || [];
237
+ if (tokens.length === 0) continue;
238
+
239
+ // Strip leading env assignments `FOO=bar`
240
+ let idx = 0;
241
+ while (idx < tokens.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[idx])) idx += 1;
242
+ if (idx >= tokens.length) continue;
243
+
244
+ const bin = tokens[idx].replace(/^['"]|['"]$/g, '').toLowerCase();
245
+ let ecosystem = null;
246
+ let manager = bin;
247
+ let argStart = -1;
248
+ let isLockfileSyncOnly = false;
249
+
250
+ if (bin === 'npm' || bin === 'pnpm' || bin === 'yarn' || bin === 'bun') {
251
+ const sub = (tokens[idx + 1] || '').toLowerCase();
252
+ if (sub === 'ci' || sub === 'dedupe') {
253
+ invocations.push({
254
+ ecosystem: 'npm',
255
+ manager: bin,
256
+ packages: [],
257
+ hasCustomRegistry: false,
258
+ isLockfileSyncOnly: true
259
+ });
260
+ continue;
261
+ }
262
+ if (['install', 'i', 'add', 'in', 'ins'].includes(sub)) {
263
+ ecosystem = 'npm';
264
+ argStart = idx + 2;
265
+ } else if (bin === 'yarn' && !sub.startsWith('-') && tokens.length === idx + 1) {
266
+ isLockfileSyncOnly = true;
267
+ invocations.push({
268
+ ecosystem: 'npm',
269
+ manager: 'yarn',
270
+ packages: [],
271
+ hasCustomRegistry: false,
272
+ isLockfileSyncOnly
273
+ });
274
+ continue;
275
+ }
276
+ } else if (bin === 'pip' || bin === 'pip3') {
277
+ if ((tokens[idx + 1] || '').toLowerCase() === 'install') {
278
+ ecosystem = 'pypi';
279
+ argStart = idx + 2;
280
+ }
281
+ } else if ((bin === 'python' || bin === 'python3') && tokens[idx + 1] === '-m' && /^pip3?$/i.test(tokens[idx + 2] || '')) {
282
+ if ((tokens[idx + 3] || '').toLowerCase() === 'install') {
283
+ ecosystem = 'pypi';
284
+ manager = 'pip';
285
+ argStart = idx + 4;
286
+ }
287
+ } else if (bin === 'uv') {
288
+ const sub = (tokens[idx + 1] || '').toLowerCase();
289
+ if (sub === 'add') {
290
+ ecosystem = 'pypi';
291
+ argStart = idx + 2;
292
+ } else if (sub === 'pip' && (tokens[idx + 2] || '').toLowerCase() === 'install') {
293
+ ecosystem = 'pypi';
294
+ argStart = idx + 3;
295
+ }
296
+ } else if (bin === 'poetry' && (tokens[idx + 1] || '').toLowerCase() === 'add') {
297
+ ecosystem = 'pypi';
298
+ argStart = idx + 2;
299
+ } else if (bin === 'cargo' && (tokens[idx + 1] || '').toLowerCase() === 'add') {
300
+ ecosystem = 'cargo';
301
+ argStart = idx + 2;
302
+ }
303
+
304
+ if (!ecosystem || argStart < 0) continue;
305
+
306
+ let hasCustomRegistry = false;
307
+ let hasRequirementManifestFlag = false;
308
+ let hasCargoLocalOrGit = false;
309
+ const rawPkgSpecs = [];
310
+
311
+ for (let i = argStart; i < tokens.length; i++) {
312
+ const tok = tokens[i].replace(/^['"]|['"]$/g, '');
313
+ if (!tok) continue;
314
+
315
+ if (
316
+ tok.startsWith('--registry=') ||
317
+ tok.startsWith('--index-url=') ||
318
+ tok.startsWith('--extra-index-url=')
319
+ ) {
320
+ hasCustomRegistry = true;
321
+ continue;
322
+ }
323
+ if (tok === '--registry' || tok === '--index-url' || tok === '--extra-index-url' || tok === '-i') {
324
+ hasCustomRegistry = true;
325
+ i += 1;
326
+ continue;
327
+ }
328
+ if (tok === '-r' || tok === '--requirement' || tok.startsWith('--requirement=')) {
329
+ hasRequirementManifestFlag = true;
330
+ if (tok === '-r' || tok === '--requirement') i += 1;
331
+ continue;
332
+ }
333
+ if (tok === '-e' || tok === '--editable') {
334
+ const nextTok = (tokens[i + 1] || '').replace(/^['"]|['"]$/g, '');
335
+ if (nextTok.startsWith('.') || nextTok.startsWith('/')) {
336
+ i += 1;
337
+ continue;
338
+ }
339
+ }
340
+ if (ecosystem === 'cargo' && (tok === '--path' || tok === '--git')) {
341
+ hasCargoLocalOrGit = true;
342
+ i += 1;
343
+ continue;
344
+ }
345
+ if (FLAGS_WITH_VALUE.has(tok)) {
346
+ i += 1;
347
+ continue;
348
+ }
349
+ if (tok.startsWith('-')) continue;
350
+
351
+ const parsed = normalizePackageSpec(tok, ecosystem);
352
+ if (parsed) rawPkgSpecs.push(parsed);
353
+ }
354
+
355
+ if (hasCargoLocalOrGit && rawPkgSpecs.every((p) => !p.raw.includes('@'))) {
356
+ for (const p of rawPkgSpecs) p.isLocalOrProtocol = true;
357
+ }
358
+
359
+ invocations.push({
360
+ ecosystem,
361
+ manager,
362
+ packages: rawPkgSpecs,
363
+ hasCustomRegistry,
364
+ isLockfileSyncOnly: rawPkgSpecs.length === 0 && !hasRequirementManifestFlag
365
+ ? true
366
+ : rawPkgSpecs.length === 0 && hasRequirementManifestFlag
367
+ });
368
+ }
369
+
370
+ return invocations;
371
+ }
372
+
373
+ /**
374
+ * Evaluates Guardrail #6 (`SLOPSQUAT_DEP_GATE`) across Phase 1 (offline `<5ms`) and optional Phase 2 metadata.
375
+ *
376
+ * @param {object} input
377
+ * @param {string} input.command
378
+ * @param {Iterable<string>} [input.manifestDeps] - Existing manifest/lockfile package names
379
+ * @param {Iterable<string>} [input.workspacePackages] - Monorepo workspace package names
380
+ * @param {Iterable<string>} [input.privateScopes] - Private scopes from `.npmrc` (e.g. `['@corp', '@internal']`)
381
+ * @param {Record<string, { exists?: boolean, ageDays?: number, weeklyDownloads?: number, offline?: boolean, timedOut?: boolean, error?: string }>} [input.registryMetadata]
382
+ */
383
+ export function evaluateSlopsquatCommand(input = {}) {
384
+ const invocations = parsePackageInstallCommands(input.command || '');
385
+ if (invocations.length === 0) {
386
+ return {
387
+ triggered: false,
388
+ decision: 'allow',
389
+ reason: 'No package install invocation detected',
390
+ findings: [],
391
+ tokensSavedEst: 0
392
+ };
393
+ }
394
+
395
+ const manifestSet = new Set(
396
+ Array.from(input.manifestDeps || [], (d) => String(d).toLowerCase().replace(/_/g, '-'))
397
+ );
398
+ const workspaceSet = new Set(
399
+ Array.from(input.workspacePackages || [], (d) => String(d).toLowerCase())
400
+ );
401
+ const privateScopeSet = new Set(
402
+ Array.from(input.privateScopes || [], (s) =>
403
+ (String(s).startsWith('@') ? String(s) : `@${s}`).toLowerCase()
404
+ )
405
+ );
406
+ const registryMetaMap = input.registryMetadata || null;
407
+
408
+ const findings = [];
409
+
410
+ for (const inv of invocations) {
411
+ if (inv.isLockfileSyncOnly || inv.packages.length === 0) continue;
412
+
413
+ const canonicalList = POPULAR_ECOSYSTEM_PACKAGES[inv.ecosystem] || [];
414
+ const canonicalSet = new Set(canonicalList.map((p) => p.toLowerCase()));
415
+
416
+ for (const pkg of inv.packages) {
417
+ if (pkg.isLocalOrProtocol) continue;
418
+ const normalizedKey =
419
+ inv.ecosystem === 'pypi' ? pkg.name.replace(/_/g, '-') : pkg.name.toLowerCase();
420
+
421
+ // 1. Existing manifest / lockfile / monorepo workspace allowlist
422
+ if (
423
+ manifestSet.has(normalizedKey) ||
424
+ manifestSet.has(pkg.name) ||
425
+ workspaceSet.has(pkg.name)
426
+ ) {
427
+ continue;
428
+ }
429
+
430
+ // 2. Private `.npmrc` scope or custom `--registry` / `--index-url` allowlist (0% false-deny!)
431
+ if (pkg.scope && privateScopeSet.has(pkg.scope)) {
432
+ continue;
433
+ }
434
+ if (inv.hasCustomRegistry) {
435
+ continue;
436
+ }
437
+
438
+ // 3. Canonical popular package fast-allow
439
+ if (canonicalSet.has(normalizedKey)) {
440
+ continue;
441
+ }
442
+
443
+ // 4. Phase 1a: Known LLM package conflation / hallucination dictionary
444
+ if (Object.prototype.hasOwnProperty.call(KNOWN_LLM_CONFLATIONS, normalizedKey)) {
445
+ findings.push({
446
+ package: pkg.name,
447
+ ecosystem: inv.ecosystem,
448
+ phase: 1,
449
+ kind: 'LLM_CONFLATION',
450
+ detail: KNOWN_LLM_CONFLATIONS[normalizedKey]
451
+ });
452
+ continue;
453
+ }
454
+
455
+ // 5. Phase 1b: Damerau-Levenshtein distance == 1 against canonical ecosystem top list
456
+ let closestTarget = null;
457
+ if (normalizedKey.length >= 4) {
458
+ for (const popular of canonicalList) {
459
+ if (damerauLevenshteinMax1(normalizedKey, popular) === 1) {
460
+ closestTarget = popular;
461
+ break;
462
+ }
463
+ }
464
+ }
465
+ if (closestTarget) {
466
+ findings.push({
467
+ package: pkg.name,
468
+ ecosystem: inv.ecosystem,
469
+ phase: 1,
470
+ kind: 'TYPOSQUAT_DISTANCE_1',
471
+ suggestedPackage: closestTarget,
472
+ detail: `Edit-distance 1 from canonical \`${closestTarget}\``
473
+ });
474
+ continue;
475
+ }
476
+
477
+ // 6. Phase 1c: Suspicious LLM affix hallucination (`<popular>-official`, `python-<popular>` when canonical exists)
478
+ const strippedAffix = normalizedKey
479
+ .replace(/^(?:python-|py-|node-|npm-)/, '')
480
+ .replace(/(?:-official|-sdk-v2|-js-sdk|-py)$/, '');
481
+ if (
482
+ strippedAffix !== normalizedKey &&
483
+ strippedAffix.length >= 4 &&
484
+ canonicalSet.has(strippedAffix)
485
+ ) {
486
+ findings.push({
487
+ package: pkg.name,
488
+ ecosystem: inv.ecosystem,
489
+ phase: 1,
490
+ kind: 'AFFIX_HALLUCINATION',
491
+ suggestedPackage: strippedAffix,
492
+ detail: `Suspicious affix wrapper around canonical \`${strippedAffix}\``
493
+ });
494
+ continue;
495
+ }
496
+
497
+ // 7. Phase 2 (Opt-in / Mocked Registry Metadata): Fail-open on offline/timeout!
498
+ if (registryMetaMap && Object.prototype.hasOwnProperty.call(registryMetaMap, pkg.name)) {
499
+ const meta = registryMetaMap[pkg.name] || {};
500
+ if (meta.offline || meta.timedOut || meta.error) {
501
+ // Strict fail-open: never block or nag when offline or timed out on unflagged packages
502
+ continue;
503
+ }
504
+ if (meta.exists === false) {
505
+ findings.push({
506
+ package: pkg.name,
507
+ ecosystem: inv.ecosystem,
508
+ phase: 2,
509
+ kind: 'UNPUBLISHED_404_HALLUCINATION',
510
+ detail: `Package \`${pkg.name}\` returned 404 Not Found on ${inv.ecosystem} registry`
511
+ });
512
+ } else if (
513
+ typeof meta.ageDays === 'number' &&
514
+ meta.ageDays < 14 &&
515
+ typeof meta.weeklyDownloads === 'number' &&
516
+ meta.weeklyDownloads < 50
517
+ ) {
518
+ findings.push({
519
+ package: pkg.name,
520
+ ecosystem: inv.ecosystem,
521
+ phase: 2,
522
+ kind: 'LOW_REPUTATION_NEW_PACKAGE',
523
+ detail: `Newly published (${meta.ageDays}d old, ${meta.weeklyDownloads} weekly downloads)`
524
+ });
525
+ }
526
+ }
527
+ }
528
+ }
529
+
530
+ if (findings.length === 0) {
531
+ return {
532
+ triggered: false,
533
+ decision: 'allow',
534
+ reason: 'All package specifiers verified or allowlisted',
535
+ findings: [],
536
+ tokensSavedEst: 0
537
+ };
538
+ }
539
+
540
+ // Always use human-in-the-loop `ask` (never blind `deny` that blocks legitimate obscure packages)
541
+ return {
542
+ triggered: true,
543
+ decision: 'ask',
544
+ code: 'SLOPSQUAT_DEP_GATE',
545
+ reason: `[Quota & Supply-Chain Shield] Unverified package install (${findings
546
+ .map((f) => `${f.package}: ${f.detail}`)
547
+ .join('; ')}). Confirm package name before running install scripts.`,
548
+ findings,
549
+ tokensSavedEst: 1800
550
+ };
551
+ }
@@ -20,6 +20,7 @@ export * from './coach/ttlWatchdog.mjs';
20
20
  export * from './coach/stateBatonHydrator.mjs';
21
21
  export * from './coach/savedQuotaLedger.mjs';
22
22
  export * from './guards/circuitBreakers.mjs';
23
+ export * from './guards/docIndexCore.mjs';
23
24
  export * from './ui/modViews.mjs';
24
25
  export * from './ui/horizonGrid.mjs';
25
26
  export * from './ui/costRadarSvg.mjs';
@@ -45,6 +45,7 @@ function computeBreakEvenRatioFromRates(
45
45
  write1hTokens = 0,
46
46
  ttlTier = '5m'
47
47
  ) {
48
+ if (rates?.unknownModel) return null;
48
49
  const mults = rates?.multipliers || { write5m: 1.25, write1h: 2.0, read: 0.05 };
49
50
  const w5 = Math.max(0, Number(write5mTokens || 0));
50
51
  const w1 = Math.max(0, Number(write1hTokens || 0));
@@ -262,6 +263,18 @@ function buildCumulativeCacheRoi(state, currentRates) {
262
263
  function addTurnCostToCumulative(cumulative, turnCost) {
263
264
  const { uncachedInput, cacheWrite5m, cacheWrite1h, cacheRead, output, thinking } =
264
265
  turnCost.tokens;
266
+ cumulative.uncachedInputTokens += uncachedInput;
267
+ cumulative.cacheWrite5mTokens += cacheWrite5m;
268
+ cumulative.cacheWrite1hTokens += cacheWrite1h;
269
+ cumulative.cacheReadTokens += cacheRead;
270
+ cumulative.outputTokens += output;
271
+ cumulative.thinkingTokens += thinking;
272
+
273
+ if (turnCost.unknownModel || turnCost.costsUSD?.totalActualSpendUSD === null) {
274
+ cumulative.hasUnknownModelCost = true;
275
+ return;
276
+ }
277
+
265
278
  const {
266
279
  actualCacheSpendUSD,
267
280
  uncachedCacheEquivalentUSD,
@@ -269,12 +282,6 @@ function addTurnCostToCumulative(cumulative, turnCost) {
269
282
  totalUncachedEquivalentUSD
270
283
  } = turnCost.costsUSD;
271
284
 
272
- cumulative.uncachedInputTokens += uncachedInput;
273
- cumulative.cacheWrite5mTokens += cacheWrite5m;
274
- cumulative.cacheWrite1hTokens += cacheWrite1h;
275
- cumulative.cacheReadTokens += cacheRead;
276
- cumulative.outputTokens += output;
277
- cumulative.thinkingTokens += thinking;
278
285
  cumulative.actualCacheSpendUSD = Number(
279
286
  (cumulative.actualCacheSpendUSD + actualCacheSpendUSD).toFixed(6)
280
287
  );
@@ -556,8 +563,17 @@ export function ingestModTurnEvent(currentState, event = {}, options = {}) {
556
563
  return state;
557
564
  }
558
565
 
559
- const ttlTier = state.promptCache?.ttlTier === '1h' ? '1h' : '5m';
560
- const breakdown = extractNormalizedTokenBreakdown({ ...usage, cacheTtlTier: ttlTier });
566
+ const priorTtlTier = state.promptCache?.ttlTier === '1h' ? '1h' : '5m';
567
+ const initialBreakdown = extractNormalizedTokenBreakdown({ ...usage, cacheTtlTier: priorTtlTier });
568
+ const ttlTier =
569
+ !isSubagent && initialBreakdown.write1hTokens > 0 ? '1h' : priorTtlTier;
570
+ if (!isSubagent && ttlTier === '1h' && state.promptCache) {
571
+ state.promptCache.ttlTier = '1h';
572
+ }
573
+ const breakdown =
574
+ ttlTier === priorTtlTier
575
+ ? initialBreakdown
576
+ : extractNormalizedTokenBreakdown({ ...usage, cacheTtlTier: ttlTier });
561
577
  const uncachedInput = breakdown.uncachedInputTokens;
562
578
  const write5mTokens = breakdown.effectiveWrite5mTokens;
563
579
  const write1hTokens = breakdown.effectiveWrite1hTokens;
@@ -779,8 +795,8 @@ export function ingestModTurnEvent(currentState, event = {}, options = {}) {
779
795
  cacheWriteTokens: totalWriteTokens,
780
796
  nowMs,
781
797
  ttlSeconds: ttlTier === '1h' ? 3600 : 300,
782
- inputPer1M: fullTurnCost.rates.inputPer1M,
783
- readPer1M: fullTurnCost.rates.readPer1M
798
+ inputPer1M: fullTurnCost.rates.inputPer1M ?? 0,
799
+ readPer1M: fullTurnCost.rates.readPer1M ?? 0
784
800
  });
785
801
  }
786
802
  if (!isSubagent) {
@@ -861,7 +877,7 @@ export function ingestStatusLinePayload(currentState, statusPayload = {}, option
861
877
  const pc = statusPayload.prompt_cache || {};
862
878
  const rl = statusPayload.rate_limits || {};
863
879
 
864
- const ttlInfo = parseTtlInfo(pc.ttl ?? state.promptCache.ttlTier);
880
+ let ttlInfo = parseTtlInfo(pc.ttl ?? state.promptCache.ttlTier);
865
881
  state.promptCache.ttlTier = ttlInfo.ttlTier;
866
882
 
867
883
  const hasCurrentUsage =
@@ -879,10 +895,18 @@ export function ingestStatusLinePayload(currentState, statusPayload = {}, option
879
895
  currentUsage.cacheWrite1hTokens !== undefined ||
880
896
  currentUsage.cache_creation !== undefined);
881
897
 
882
- const breakdown = extractNormalizedTokenBreakdown({
898
+ let breakdown = extractNormalizedTokenBreakdown({
883
899
  ...currentUsage,
884
900
  cacheTtlTier: state.promptCache.ttlTier
885
901
  });
902
+ if (pc.ttl === undefined && breakdown.write1hTokens > 0 && state.promptCache.ttlTier !== '1h') {
903
+ state.promptCache.ttlTier = '1h';
904
+ ttlInfo = { ttlTier: '1h', ttlSeconds: 3600 };
905
+ breakdown = extractNormalizedTokenBreakdown({
906
+ ...currentUsage,
907
+ cacheTtlTier: '1h'
908
+ });
909
+ }
886
910
  const uncachedInput = breakdown.uncachedInputTokens;
887
911
  const write5mTokens = breakdown.effectiveWrite5mTokens;
888
912
  const write1hTokens = breakdown.effectiveWrite1hTokens;