mobile-context-trimmer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 isonka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# mobile-context-trimmer
+
+TypeScript CLI and library that scans native **iOS** and **Android** repositories and builds a token-budgeted markdown context bundle for LLMs.
+
+## Why this exists
+
+Mobile codebases mix Swift/Kotlin sources with Xcode and Gradle noise. Plain “scan everything” bundles waste budget on generated or churn-heavy files, while missing the files that actually changed recently. This tool applies **mobile-aware defaults** (extensions, ignores) and ranks files using **TF‑IDF-style relevance**, **git recency with Xcode-safe rules**, and **file-type priority**—similar to `context-trimmer`, but tuned for native apps.
+
+## How ranking works
+
+Each file gets a weighted score from three signals:
+
+| Signal | Description |
+| --- | --- |
+| **Query match** | TF × IDF over query terms in file content (corpus = scanned files). Rare terms that appear in few files count more than words that appear everywhere. |
+| **Recency** | Last commit time from batched `git log` (first-seen path wins), normalized across the set. **Xcode-safe:** paths under `.xcodeproj/`, `*.pbxproj`, and `xcuserdata` **do not** use git timestamps (they are excluded from the git map and use **filesystem `mtime`** instead), so Xcode constantly rewriting the project file does not drown out real Swift/Kotlin activity. |
+| **File type** | Extension weights (e.g. `.swift` / `.kt` favored over `.xml` / `.properties`). |
+
+Default weights: keyword **0.55**, recency **0.30**, type **0.15** (recency matters more on mobile than in generic JS repos).
+
+Files are then selected in **rank order** until the token budget is exhausted. When you pass a **non-empty `--query`**, the bundler applies a default **keyword relevance floor** (`minKeywordScore: 0`): files with **no lexical match** to the query (`keywordScore <= 0`) are **dropped** before budgeting, so recently touched A/B experiment stubs cannot crowd out on-topic files. Raise the floor with `--min-keyword-score` to demand stronger matches; use **`--min-keyword-score -1`** to disable the floor while keeping ranking.
+
+**Tail noise from recency:** Utilities can clear the keyword floor from a **spurious** hit (e.g. `subscriptions` as a property name) while **recency still applies at full strength**, so combined scores can stay high (~0.3–0.45) and a **low** `--min-combined-score` (near 0) will not remove them.
+
+Two levers work together:
+
+1. **Recency dampening** (on by default when `--query` is non-empty): recency is scaled by `min(1, keywordScore / reference)` with default reference **~0.055** (`DEFAULT_KEYWORD_RECENCY_REFERENCE`). Weak lexical matches no longer inherit the full 30% recency term. **`--keyword-recency-reference 0`** restores legacy behavior (no dampening). Lower the reference to dampen more aggressively.
+
+2. **Combined score floor:** With a query, the CLI now defaults **`--min-combined-score` to `0.1`** (`DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY`). Calibrate on your repo—many iOS codebases land in roughly the **0.08–0.15** band for separating boilerplate tails from task files; raise toward **0.2** if utilities still slip through. **`--min-combined-score -1`** disables the floor.
+
+## Quick start
+
+```bash
+npx mobile-context-trimmer --dir ./MyApp --query "fix login crash" --budget 32000 --out mobile-context.md
+```
+
+Stricter tail (defaults already apply dampening + combined floor `0.1`; raise if needed):
+
+```bash
+npx mobile-context-trimmer --dir ./MyApp --query "add subscriptions to menu" --min-combined-score 0.15 --budget 32000 --out mobile-context.md
+```
+
+Stream to stdout (omit `--out`):
+
+```bash
+npx mobile-context-trimmer --dir ./MyApp --query "navigation stack" --budget 16000
+```
+
+## CLI options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `--dir` | `string` | current working directory | Project root to scan |
+| `--query` | `string` | `""` | Task or keywords for ranking (optional but recommended) |
+| `--budget` | `number` | `32000` | Approximate token budget (char/4 estimator) |
+| `--out` | `string` | none | Write markdown bundle to this path |
+| `--min-keyword-score` | `number` | `0` when `--query` is set; disabled when query empty | Omit files with `keywordScore` at or below this value. Negative value disables the floor. |
+| `--min-combined-score` | `number` | **`0.1`** when `--query` is set | Omit ranked files whose combined `score` is **strictly below** this value. **`-1`** disables. |
+| `--keyword-recency-reference` | `number` | **`~0.055`** | Recency dampening reference (see above). **`0`** disables dampening. |
+
+### Ranking & bundle gate flags (reference)
+
+These three flags only affect behavior when you pass a **non-empty `--query`** (except `--min-keyword-score`, which is ignored when the query is empty).
+
+| Flag | Effect |
+| --- | --- |
+| **`--min-keyword-score`** | Drops files whose lexical **keyword score** (TF×IDF) is **≤** this value before spending token budget. **Default with query: `0`** (drops files with no query match). **`-1`** disables this floor. Raise it (e.g. `0.02`) if incidental token hits still get through. |
+| **`--min-combined-score`** | Drops files whose **weighted rank score** (keyword + damped recency + type) is **&lt;** this value. **Default with query: `0.1`**. **`-1`** disables. Tune roughly **0.08–0.15** on many iOS repos; increase toward **0.2** if utility files still fill the tail. |
+| **`--keyword-recency-reference`** | Controls **recency dampening**: recency is scaled by `min(1, keywordScore / reference)`. **Default: ~`0.055`**. **`0`** turns dampening off (legacy: full recency weight even for weak keyword hits). **Lower** the reference to dampen recency more aggressively for weak matches. |
+
+## Scanning defaults
+
+**Extensions (whitelist):** `.swift`, `.m`, `.mm`, `.h`, `.plist`, `.kt`, `.kts`, `.java`, `.xml`, `.gradle`, `.properties`
+
+**Always ignored (in addition to `.gitignore` / `.trimmerignore`):** e.g. `Pods/`, `DerivedData/`, `.gradle/`, `build/`, Core Data `*.xcmapping.xml`, common IDE and web artifacts. See `getDefaultMobileIgnorePatterns()` in source.
+
+The CLI uses **metadata-first** scanning (`includeContent: false` during walk) and reads file contents only while ranking and bundling.
+
+## Example output
+
+```markdown
+# Mobile Context Bundle
+
+- Files included: 2
+- Tokens used: 120
+- Files skipped due to budget: 5
+- Files skipped below keyword relevance floor: 6
+- Files skipped below combined rank score: 3
+
+## File: `ios/App/AppDelegate.swift`
+
+- Absolute path: `/path/to/MyApp/ios/App/AppDelegate.swift`
+- Estimated tokens: 80
+- Rank score: 0.812345
+- Keyword score: 0.401000
+
+```
+// file content
+```
+```
+
+## Library usage
+
+```ts
+import {
+  scanMobileFiles,
+  rankMobileFiles,
+  createDefaultTokenizer,
+  buildBundle,
+  DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY,
+  formatBundleMarkdown,
+} from "mobile-context-trimmer";
+
+const rootDir = process.cwd();
+const files = await scanMobileFiles({ rootDir, includeContent: false });
+const ranked = await rankMobileFiles(files, {
+  query: "push notification",
+  rootDir,
+});
+const tokenizer = createDefaultTokenizer();
+const bundle = await buildBundle(ranked, {
+  tokenBudget: 32000,
+  tokenizer,
+  minKeywordScore: 0,
+  minCombinedScore: DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY,
+});
+console.log(formatBundleMarkdown(bundle, rootDir));
+```
+
+## Development
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+### CI
+
+[GitHub Actions](.github/workflows/ci.yml) runs **`npm ci`**, **`npm test`**, and **`npm run build`** on **push** and **pull request** to `main` or `master` (Node 18, 20, 22).
+
+### Publishing to npm
+
+- `package.json` includes **`publishConfig.access: "public"`** for scoped or first-time public packages.
+- Set **`repository`**, **`bugs`**, and **`homepage`** in `package.json` to your GitHub URLs if they differ from the template.
+- From a clean tree: `npm run build && npm test`, then `npm publish` (with npm login and version bump as needed).
+
+Tests include unit coverage for scanner, tokenizer, bundler, ranker (TF‑IDF), Xcode path heuristics, optional git recency, and a CLI end-to-end run.
+
+## Contributing
+
+Pull requests should stay focused, include tests for behavior changes, and pass `npm test && npm run build`.
+
+## License
+
+MIT

package/dist/bundler.d.ts

@@ -0,0 +1,43 @@
+import { type MobileScannedFile } from "./scanner.js";
+import { type Tokenizer } from "./tokenizer.js";
+/** Default `--min-combined-score` when `--query` is set (bundle stage). Use `-1` on the CLI to omit. */
+export declare const DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY = 0.1;
+export interface BundleOptions {
+    tokenBudget: number;
+    tokenizer: Tokenizer;
+    /**
+     * When set, files from ranked output with `keywordScore <= minKeywordScore` are omitted
+     * so high-recency boilerplate cannot fill the bundle. Ignored for inputs without `keywordScore`.
+     * Use `0` to require strictly positive lexical relevance vs the query.
+     */
+    minKeywordScore?: number;
+    /**
+     * When set, ranked files with combined `score` (keyword + recency + type) **strictly below**
+     * this value are omitted so weakly relevant but recently touched utilities do not fill the tail.
+     */
+    minCombinedScore?: number;
+}
+export interface BundleItem {
+    path: string;
+    content: string;
+    estimatedTokens: number;
+    /** Present when the bundled file came from ranked output. */
+    score?: number;
+    /** Present when the bundled file came from ranked output. */
+    keywordScore?: number;
+}
+export interface BundleResult {
+    items: BundleItem[];
+    usedTokens: number;
+    skippedFully: number;
+    skippedBelowRelevance: number;
+    skippedBelowCombinedScore: number;
+}
+/**
+ * Builds a markdown-ready bundle within a token budget.
+ */
+export declare function buildBundle(files: MobileScannedFile[], options: BundleOptions): Promise<BundleResult>;
+/**
+ * Formats bundle output as markdown.
+ */
+export declare function formatBundleMarkdown(bundle: BundleResult, rootDir: string): string;

package/dist/bundler.js

@@ -0,0 +1,99 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+/** Default `--min-combined-score` when `--query` is set (bundle stage). Use `-1` on the CLI to omit. */
+export const DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY = 0.1;
+/**
+ * Builds a markdown-ready bundle within a token budget.
+ */
+export async function buildBundle(files, options) {
+    const items = [];
+    let usedTokens = 0;
+    let skippedFully = 0;
+    let skippedBelowRelevance = 0;
+    let skippedBelowCombinedScore = 0;
+    const floor = options.minKeywordScore;
+    const minCombined = options.minCombinedScore;
+    for (const file of files) {
+        if (floor !== undefined && hasKeywordScore(file)) {
+            if (file.keywordScore <= floor) {
+                skippedBelowRelevance += 1;
+                continue;
+            }
+        }
+        if (minCombined !== undefined && hasRankScore(file)) {
+            if (file.score < minCombined) {
+                skippedBelowCombinedScore += 1;
+                continue;
+            }
+        }
+        const content = file.content ?? (await fs.readFile(file.absolutePath, "utf8"));
+        if (content.trim().length === 0) {
+            continue;
+        }
+        const estimatedTokens = options.tokenizer.estimateTokens(content);
+        if (estimatedTokens === 0) {
+            continue;
+        }
+        if (usedTokens + estimatedTokens > options.tokenBudget) {
+            skippedFully += 1;
+            continue;
+        }
+        const item = {
+            path: file.relativePath,
+            content,
+            estimatedTokens
+        };
+        if (hasRankScore(file)) {
+            item.score = file.score;
+        }
+        if (hasKeywordScore(file)) {
+            item.keywordScore = file.keywordScore;
+        }
+        items.push(item);
+        usedTokens += estimatedTokens;
+    }
+    return { items, usedTokens, skippedFully, skippedBelowRelevance, skippedBelowCombinedScore };
+}
+function hasKeywordScore(file) {
+    return ("keywordScore" in file &&
+        typeof file.keywordScore === "number" &&
+        !Number.isNaN(file.keywordScore));
+}
+function hasRankScore(file) {
+    return ("score" in file &&
+        typeof file.score === "number" &&
+        !Number.isNaN(file.score));
+}
+/**
+ * Formats bundle output as markdown.
+ */
+export function formatBundleMarkdown(bundle, rootDir) {
+    const sections = bundle.items.map((item) => {
+        const lines = [
+            `## File: \`${item.path}\``,
+            "",
+            `- Absolute path: \`${path.resolve(rootDir, item.path)}\``,
+            `- Estimated tokens: ${item.estimatedTokens}`
+        ];
+        if (item.score !== undefined) {
+            lines.push(`- Rank score: ${item.score.toFixed(6)}`);
+        }
+        if (item.keywordScore !== undefined) {
+            lines.push(`- Keyword score: ${item.keywordScore.toFixed(6)}`);
+        }
+        lines.push("", "```", item.content, "```");
+        return lines.join("\n");
+    });
+    return [
+        "# Mobile Context Bundle",
+        "",
+        `- Files included: ${bundle.items.length}`,
+        `- Tokens used: ${bundle.usedTokens}`,
+        `- Files skipped due to budget: ${bundle.skippedFully}`,
+        `- Files skipped below keyword relevance floor: ${bundle.skippedBelowRelevance}`,
+        `- Files skipped below combined rank score: ${bundle.skippedBelowCombinedScore}`,
+        "",
+        ...sections
+    ].join("\n");
+}
+//# sourceMappingURL=bundler.js.map

package/dist/bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { buildBundle, DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY, formatBundleMarkdown } from "./bundler.js";
+import { rankMobileFiles } from "./ranker.js";
+import { scanMobileFiles } from "./scanner.js";
+import { createDefaultTokenizer } from "./tokenizer.js";
+void yargs(hideBin(process.argv))
+    .scriptName("mobile-context-trimmer")
+    .usage("$0 --dir ./repo --budget 32000 --out mobile-context.md")
+    .option("dir", {
+    type: "string",
+    default: process.cwd(),
+    describe: "Root directory of iOS/Android project"
+})
+    .option("budget", {
+    type: "number",
+    default: 32000,
+    describe: "Token budget for selected files"
+})
+    .option("out", {
+    type: "string",
+    describe: "Optional output markdown file path"
+})
+    .option("query", {
+    type: "string",
+    default: "",
+    describe: "Optional task/query to rank files before bundling"
+})
+    .option("min-keyword-score", {
+    type: "number",
+    describe: "Keyword relevance floor when --query is set (default: 0, omit files with no query match). Use a negative value to disable."
+})
+    .option("min-combined-score", {
+    type: "number",
+    describe: `Minimum weighted rank score to include a file (default ${DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY} when --query is set). Use -1 to disable. Calibrate ~0.08–0.15 for many iOS repos.`
+})
+    .option("keyword-recency-reference", {
+    type: "number",
+    describe: "Keyword TF-IDF reference for recency dampening when --query is set (default ~0.055). Lower = stricter. Use 0 to disable dampening."
+})
+    .command("$0", "Build a mobile context bundle", () => { }, async (argv) => {
+    const rootDir = path.resolve(String(argv.dir));
+    const budget = Math.max(1, Math.floor(Number(argv.budget)));
+    const queryTrim = String(argv.query ?? "").trim();
+    const rawMin = argv["min-keyword-score"];
+    let minKeywordScore;
+    if (queryTrim) {
+        if (rawMin !== undefined && rawMin < 0) {
+            minKeywordScore = undefined;
+        }
+        else {
+            minKeywordScore = rawMin !== undefined ? rawMin : 0;
+        }
+    }
+    const files = await scanMobileFiles({ rootDir, includeContent: false });
+    const kwRef = argv["keyword-recency-reference"];
+    const rankedFiles = await rankMobileFiles(files, {
+        query: String(argv.query ?? ""),
+        rootDir,
+        ...(kwRef !== undefined && !Number.isNaN(kwRef) ? { keywordRecencyReference: kwRef } : {})
+    });
+    const rawCombined = argv["min-combined-score"];
+    let minCombinedScore;
+    if (queryTrim) {
+        if (rawCombined !== undefined && !Number.isNaN(rawCombined)) {
+            minCombinedScore = rawCombined < 0 ? undefined : rawCombined;
+        }
+        else {
+            minCombinedScore = DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY;
+        }
+    }
+    const bundle = await buildBundle(rankedFiles, {
+        tokenBudget: budget,
+        tokenizer: createDefaultTokenizer(),
+        minKeywordScore,
+        minCombinedScore
+    });
+    const output = formatBundleMarkdown(bundle, rootDir);
+    if (argv.out) {
+        const outPath = path.resolve(String(argv.out));
+        await fs.writeFile(outPath, output, "utf8");
+        process.stderr.write(`mobile-context-trimmer: wrote ${bundle.items.length} files (${bundle.usedTokens} tokens) to ${outPath}\n`);
+        return;
+    }
+    process.stdout.write(`${output}\n`);
+})
+    .help()
+    .strict()
+    .parseAsync();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Returns the package name for quick sanity checks.
+ */
+export declare function getLibraryName(): string;
+/**
+ * Returns default file extensions for native iOS/Android scanning.
+ */
+export declare function getDefaultMobileExtensions(): string[];
+/**
+ * Returns default ignore patterns for native mobile repositories.
+ */
+export declare function getDefaultMobileIgnorePatterns(): string[];
+export type MobilePlatform = "ios" | "android" | "mixed" | "unknown";
+/**
+ * Detects mobile platform focus from a list of file paths.
+ */
+export declare function detectMobilePlatform(paths: string[]): MobilePlatform;
+export { scanMobileFiles, type MobileScannedFile, type MobileScanOptions } from "./scanner.js";
+export { createDefaultTokenizer, estimateChar4Tokens, type Tokenizer } from "./tokenizer.js";
+export { buildBundle, DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY, formatBundleMarkdown, type BundleItem, type BundleOptions, type BundleResult } from "./bundler.js";
+export { DEFAULT_KEYWORD_RECENCY_REFERENCE, rankMobileFiles, tokenizeQuery, computeKeywordScoreFromStats, isGitRecencyUnreliablePath, type RankMobileOptions, type RankedMobileFile } from "./ranker.js";

package/dist/index.js

@@ -0,0 +1,87 @@
+/**
+ * Returns the package name for quick sanity checks.
+ */
+export function getLibraryName() {
+    return "mobile-context-trimmer";
+}
+/**
+ * Returns default file extensions for native iOS/Android scanning.
+ */
+export function getDefaultMobileExtensions() {
+    return [
+        ".swift",
+        ".m",
+        ".mm",
+        ".h",
+        ".plist",
+        ".kt",
+        ".kts",
+        ".java",
+        ".xml",
+        ".gradle",
+        ".properties"
+    ];
+}
+/**
+ * Returns default ignore patterns for native mobile repositories.
+ */
+export function getDefaultMobileIgnorePatterns() {
+    return [
+        ".git/",
+        "node_modules/",
+        "Pods/",
+        "DerivedData/",
+        ".gradle/",
+        ".idea/",
+        "build/",
+        "**/build/",
+        ".cxx/",
+        ".dart_tool/",
+        ".next/",
+        ".turbo/",
+        "*.xcworkspace/xcuserdata/",
+        "*.xcodeproj/xcuserdata/",
+        "*.xcmapping.xml"
+    ];
+}
+/**
+ * Detects mobile platform focus from a list of file paths.
+ */
+export function detectMobilePlatform(paths) {
+    let hasIos = false;
+    let hasAndroid = false;
+    for (const rawPath of paths) {
+        const normalized = rawPath.toLowerCase();
+        if (normalized.endsWith(".swift") ||
+            normalized.endsWith(".m") ||
+            normalized.endsWith(".mm") ||
+            normalized.endsWith(".plist") ||
+            normalized.includes("/ios/") ||
+            normalized.includes(".xcodeproj")) {
+            hasIos = true;
+        }
+        if (normalized.endsWith(".kt") ||
+            normalized.endsWith(".kts") ||
+            normalized.endsWith(".java") ||
+            normalized.endsWith("androidmanifest.xml") ||
+            normalized.includes("/android/") ||
+            normalized.includes("build.gradle")) {
+            hasAndroid = true;
+        }
+    }
+    if (hasIos && hasAndroid) {
+        return "mixed";
+    }
+    if (hasIos) {
+        return "ios";
+    }
+    if (hasAndroid) {
+        return "android";
+    }
+    return "unknown";
+}
+export { scanMobileFiles } from "./scanner.js";
+export { createDefaultTokenizer, estimateChar4Tokens } from "./tokenizer.js";
+export { buildBundle, DEFAULT_MIN_COMBINED_SCORE_WITH_QUERY, formatBundleMarkdown } from "./bundler.js";
+export { DEFAULT_KEYWORD_RECENCY_REFERENCE, rankMobileFiles, tokenizeQuery, computeKeywordScoreFromStats, isGitRecencyUnreliablePath } from "./ranker.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,SAAS;QACT,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO;QACL,OAAO;QACP,eAAe;QACf,OAAO;QACP,cAAc;QACd,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,WAAW;QACX,OAAO;QACP,aAAa;QACb,QAAQ;QACR,SAAS;QACT,2BAA2B;QAC3B,yBAAyB;QACzB,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAID;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAe;IAClD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,IACE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7B,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC1B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC5B,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,EACjC,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,IACE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC1B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC5B,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC1C,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;YAChC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,EACnC,CAAC;YACD,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,eAAe,EAAkD,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAkB,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,qCAAqC,EACrC,oBAAoB,EAIrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,eAAe,EACf,aAAa,EACb,4BAA4B,EAC5B,0BAA0B,EAG3B,MAAM,aAAa,CAAC"}

package/dist/ranker.d.ts

@@ -0,0 +1,49 @@
+import { type MobileScannedFile } from "./scanner.js";
+/**
+ * Keyword TF‑IDF score at or above this value earns full recency weight; weaker matches scale recency down linearly.
+ * Tuned so incidental hits (e.g. `subscriptions` as a property name) do not inherit a full 30% recency boost.
+ */
+export declare const DEFAULT_KEYWORD_RECENCY_REFERENCE = 0.055;
+export interface RankMobileOptions {
+    query: string;
+    /** Repository root; required for git recency and path resolution. */
+    rootDir: string;
+    keywordWeight?: number;
+    recencyWeight?: number;
+    typeWeight?: number;
+    typePriority?: Record<string, number>;
+    /**
+     * When the query has tokens, recency is multiplied by `min(1, keywordScore / reference)` unless disabled.
+     * Set to `0` to disable dampening (legacy full recency). Default: {@link DEFAULT_KEYWORD_RECENCY_REFERENCE}.
+     */
+    keywordRecencyReference?: number;
+}
+export interface RankedMobileFile extends MobileScannedFile {
+    score: number;
+    keywordScore: number;
+    recencyScore: number;
+    typeScore: number;
+    lastModifiedEpochMs: number;
+}
+interface FileKeywordStats {
+    relativePath: string;
+    matchesByToken: Map<string, number>;
+    contentTokenCount: number;
+}
+/**
+ * Paths where git timestamps are dominated by Xcode merges/rewrites; use filesystem mtime instead.
+ */
+export declare function isGitRecencyUnreliablePath(relativePath: string): boolean;
+/**
+ * Ranks mobile files using TF-IDF-style query match, Xcode-safe recency, and extension priority.
+ */
+export declare function rankMobileFiles(files: MobileScannedFile[], options: RankMobileOptions): Promise<RankedMobileFile[]>;
+/**
+ * Tokenizes a free text query into searchable terms.
+ */
+export declare function tokenizeQuery(query: string): string[];
+/**
+ * Computes TF-IDF style score using precomputed per-file stats and corpus IDF.
+ */
+export declare function computeKeywordScoreFromStats(stats: FileKeywordStats | undefined, queryTokens: string[], inverseDocumentFrequency: Map<string, number>): number;
+export {};

package/dist/ranker.js

@@ -0,0 +1,234 @@
+import { promises as fs } from "node:fs";
+import { promisify } from "node:util";
+import { execFile } from "node:child_process";
+import path from "node:path";
+const execFileAsync = promisify(execFile);
+/**
+ * Keyword TF‑IDF score at or above this value earns full recency weight; weaker matches scale recency down linearly.
+ * Tuned so incidental hits (e.g. `subscriptions` as a property name) do not inherit a full 30% recency boost.
+ */
+export const DEFAULT_KEYWORD_RECENCY_REFERENCE = 0.055;
+const DEFAULT_TYPE_PRIORITY = {
+    ".swift": 1,
+    ".kt": 1,
+    ".kts": 0.95,
+    ".java": 0.9,
+    ".xml": 0.8,
+    ".plist": 0.7,
+    ".gradle": 0.75,
+    ".properties": 0.5
+};
+/**
+ * Paths where git timestamps are dominated by Xcode merges/rewrites; use filesystem mtime instead.
+ */
+export function isGitRecencyUnreliablePath(relativePath) {
+    const normalized = relativePath.split(path.sep).join("/").toLowerCase();
+    if (normalized.includes(".xcodeproj/")) {
+        return true;
+    }
+    if (normalized.endsWith(".pbxproj")) {
+        return true;
+    }
+    if (normalized.includes(".xcuserdata/")) {
+        return true;
+    }
+    if (normalized.includes(".xcworkspace/xcuserdata/")) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Ranks mobile files using TF-IDF-style query match, Xcode-safe recency, and extension priority.
+ */
+export async function rankMobileFiles(files, options) {
+    const rootDir = path.resolve(options.rootDir);
+    const tokens = tokenizeQuery(options.query);
+    const keywordWeight = options.keywordWeight ?? 0.55;
+    const recencyWeight = options.recencyWeight ?? 0.3;
+    const typeWeight = options.typeWeight ?? 0.15;
+    const priority = {
+        ...DEFAULT_TYPE_PRIORITY,
+        ...normalizeTypePriority(options.typePriority ?? {})
+    };
+    const recencyRef = options.keywordRecencyReference === 0
+        ? null
+        : (options.keywordRecencyReference ?? DEFAULT_KEYWORD_RECENCY_REFERENCE);
+    const keywordStats = await buildKeywordStats(files, tokens);
+    const idf = buildInverseDocumentFrequency(keywordStats, tokens);
+    const timestamps = await readMobileModifiedTimestamps(rootDir, files);
+    const recencyRange = buildRange(Array.from(timestamps.values()));
+    const ranked = [];
+    for (const file of files) {
+        const stats = keywordStats.get(file.relativePath);
+        const keywordScore = computeKeywordScoreFromStats(stats, tokens, idf);
+        const lastModifiedEpochMs = timestamps.get(file.relativePath) ?? 0;
+        const recencyScore = normalizeFromRange(lastModifiedEpochMs, recencyRange.min, recencyRange.max);
+        const typeScore = priority[file.extension] ?? 0;
+        const recencyMultiplier = tokens.length === 0 || recencyRef === null ? 1 : Math.min(1, keywordScore / recencyRef);
+        const score = keywordScore * keywordWeight +
+            recencyScore * recencyWeight * recencyMultiplier +
+            typeScore * typeWeight;
+        const content = file.content ?? (await fs.readFile(file.absolutePath, "utf8"));
+        ranked.push({
+            ...file,
+            score,
+            keywordScore,
+            recencyScore,
+            typeScore,
+            lastModifiedEpochMs,
+            content
+        });
+    }
+    return ranked.sort((a, b) => b.score - a.score || a.relativePath.localeCompare(b.relativePath));
+}
+/**
+ * Tokenizes a free text query into searchable terms.
+ */
+export function tokenizeQuery(query) {
+    return query
+        .toLowerCase()
+        .split(/[^a-z0-9_]+/)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 1);
+}
+/**
+ * Computes TF-IDF style score using precomputed per-file stats and corpus IDF.
+ */
+export function computeKeywordScoreFromStats(stats, queryTokens, inverseDocumentFrequency) {
+    if (!stats || queryTokens.length === 0) {
+        return 0;
+    }
+    let total = 0;
+    for (const token of queryTokens) {
+        const matches = stats.matchesByToken.get(token) ?? 0;
+        const tf = matches / Math.max(1, stats.contentTokenCount);
+        total += tf * (inverseDocumentFrequency.get(token) ?? 0);
+    }
+    return total;
+}
+function countTokenOccurrences(text, token) {
+    if (!token) {
+        return 0;
+    }
+    const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`\\b${escaped}\\b`, "gi");
+    return text.match(regex)?.length ?? 0;
+}
+function buildInverseDocumentFrequency(statsByPath, queryTokens) {
+    const totalDocs = Math.max(1, statsByPath.size);
+    const result = new Map();
+    for (const token of queryTokens) {
+        let docsContainingToken = 0;
+        for (const stats of statsByPath.values()) {
+            if ((stats.matchesByToken.get(token) ?? 0) > 0) {
+                docsContainingToken += 1;
+            }
+        }
+        const idf = Math.log((1 + totalDocs) / (1 + docsContainingToken)) + 1;
+        result.set(token, idf);
+    }
+    return result;
+}
+async function buildKeywordStats(files, tokens) {
+    const result = new Map();
+    await Promise.all(files.map(async (file) => {
+        const content = file.content ?? (await fs.readFile(file.absolutePath, "utf8"));
+        const lowered = content.toLowerCase();
+        const contentTokenCount = Math.max(1, lowered.split(/\s+/).length);
+        const matchesByToken = new Map();
+        for (const token of tokens) {
+            matchesByToken.set(token, countTokenOccurrences(lowered, token));
+        }
+        result.set(file.relativePath, {
+            relativePath: file.relativePath,
+            matchesByToken,
+            contentTokenCount
+        });
+    }));
+    return result;
+}
+async function readMobileModifiedTimestamps(rootDir, files) {
+    const output = new Map();
+    const gitTimestamps = await readGitTimestampsBatch(rootDir);
+    await Promise.all(files.map(async (file) => {
+        const fullPath = path.resolve(rootDir, file.relativePath);
+        if (isGitRecencyUnreliablePath(file.relativePath)) {
+            try {
+                const stat = await fs.stat(fullPath);
+                output.set(file.relativePath, stat.mtimeMs);
+            }
+            catch {
+                output.set(file.relativePath, 0);
+            }
+            return;
+        }
+        const gitTs = gitTimestamps.get(file.relativePath) ?? 0;
+        if (gitTs > 0) {
+            output.set(file.relativePath, gitTs);
+            return;
+        }
+        try {
+            const stat = await fs.stat(fullPath);
+            output.set(file.relativePath, stat.mtimeMs);
+        }
+        catch {
+            output.set(file.relativePath, 0);
+        }
+    }));
+    return output;
+}
+async function readGitTimestampsBatch(rootDir) {
+    const output = new Map();
+    try {
+        const { stdout } = await execFileAsync("git", ["log", "--name-only", "--format=%ct"], {
+            cwd: rootDir
+        });
+        const lines = stdout.split(/\r?\n/);
+        let currentTimestamp = 0;
+        for (const rawLine of lines) {
+            const line = rawLine.trim();
+            if (!line) {
+                continue;
+            }
+            if (/^\d+$/.test(line)) {
+                currentTimestamp = Number.parseInt(line, 10) * 1000;
+                continue;
+            }
+            if (currentTimestamp <= 0) {
+                continue;
+            }
+            const normalizedPath = line.split(path.sep).join("/");
+            if (isGitRecencyUnreliablePath(normalizedPath)) {
+                continue;
+            }
+            if (!output.has(normalizedPath)) {
+                output.set(normalizedPath, currentTimestamp);
+            }
+        }
+    }
+    catch {
+        return output;
+    }
+    return output;
+}
+function buildRange(values) {
+    if (values.length === 0) {
+        return { min: 0, max: 0 };
+    }
+    return { min: Math.min(...values), max: Math.max(...values) };
+}
+function normalizeFromRange(value, min, max) {
+    if (max <= min) {
+        return 0;
+    }
+    return (value - min) / (max - min);
+}
+function normalizeTypePriority(priority) {
+    const normalized = {};
+    for (const [ext, score] of Object.entries(priority)) {
+        const key = ext.startsWith(".") ? ext.toLowerCase() : `.${ext.toLowerCase()}`;
+        normalized[key] = score;
+    }
+    return normalized;
+}
+//# sourceMappingURL=ranker.js.map

package/dist/ranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.js","sourceRoot":"","sources":["../src/ranker.ts"],"names":[],"mappings":"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"}

package/dist/scanner.d.ts

@@ -0,0 +1,21 @@
+export interface MobileScanOptions {
+    rootDir: string;
+    extensions?: string[];
+    includeContent?: boolean;
+    includeHidden?: boolean;
+}
+export interface MobileScannedFile {
+    absolutePath: string;
+    relativePath: string;
+    extension: string;
+    sizeBytes: number;
+    content?: string;
+}
+/**
+ * Scans a mobile repository with iOS/Android-aware defaults.
+ */
+export declare function scanMobileFiles(options: MobileScanOptions): Promise<MobileScannedFile[]>;
+/**
+ * Normalizes extension strings with leading dots and lowercase.
+ */
+export declare function normalizeExtensions(extensions: string[]): Set<string>;

package/dist/scanner.js

@@ -0,0 +1,79 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import ignore from "ignore";
+import { getDefaultMobileExtensions, getDefaultMobileIgnorePatterns } from "./index.js";
+/**
+ * Scans a mobile repository with iOS/Android-aware defaults.
+ */
+export async function scanMobileFiles(options) {
+    const rootDir = path.resolve(options.rootDir);
+    const includeContent = options.includeContent ?? false;
+    const includeHidden = options.includeHidden ?? false;
+    const extensions = normalizeExtensions(options.extensions ?? getDefaultMobileExtensions());
+    const ig = await createIgnoreMatcher(rootDir, includeHidden);
+    const files = [];
+    await walk(rootDir, rootDir, ig, extensions, includeContent, files);
+    return files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+}
+/**
+ * Normalizes extension strings with leading dots and lowercase.
+ */
+export function normalizeExtensions(extensions) {
+    return new Set(extensions.map((ext) => (ext.startsWith(".") ? ext.toLowerCase() : `.${ext.toLowerCase()}`)));
+}
+async function walk(rootDir, currentDir, ig, extensions, includeContent, out) {
+    const entries = await fs.readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const absolutePath = path.join(currentDir, entry.name);
+        const relativePath = normalizeRelativePath(path.relative(rootDir, absolutePath));
+        if (!relativePath || ig.ignores(relativePath)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            await walk(rootDir, absolutePath, ig, extensions, includeContent, out);
+            continue;
+        }
+        if (!entry.isFile()) {
+            continue;
+        }
+        const extension = path.extname(entry.name).toLowerCase();
+        if (!extensions.has(extension)) {
+            continue;
+        }
+        const stat = await fs.stat(absolutePath);
+        const content = includeContent ? await fs.readFile(absolutePath, "utf8") : undefined;
+        out.push({
+            absolutePath,
+            relativePath,
+            extension,
+            sizeBytes: stat.size,
+            content
+        });
+    }
+}
+async function createIgnoreMatcher(rootDir, includeHidden) {
+    const ig = ignore();
+    ig.add(getDefaultMobileIgnorePatterns());
+    ig.add(await readIgnoreFile(path.join(rootDir, ".gitignore")));
+    ig.add(await readIgnoreFile(path.join(rootDir, ".trimmerignore")));
+    if (!includeHidden) {
+        ig.add(".*");
+    }
+    return ig;
+}
+async function readIgnoreFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return content
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && !line.startsWith("#"));
+    }
+    catch {
+        return [];
+    }
+}
+function normalizeRelativePath(value) {
+    return value.split(path.sep).join("/");
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}

package/dist/tokenizer.d.ts

@@ -0,0 +1,11 @@
+export interface Tokenizer {
+    estimateTokens(text: string): number;
+}
+/**
+ * Char-based token estimation (chars/4) for lightweight defaults.
+ */
+export declare function estimateChar4Tokens(text: string): number;
+/**
+ * Creates the default tokenizer implementation.
+ */
+export declare function createDefaultTokenizer(): Tokenizer;

package/dist/tokenizer.js

@@ -0,0 +1,20 @@
+/**
+ * Char-based token estimation (chars/4) for lightweight defaults.
+ */
+export function estimateChar4Tokens(text) {
+    if (!text) {
+        return 0;
+    }
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Creates the default tokenizer implementation.
+ */
+export function createDefaultTokenizer() {
+    return {
+        estimateTokens(text) {
+            return estimateChar4Tokens(text);
+        }
+    };
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,cAAc,CAAC,IAAY;YACzB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "mobile-context-trimmer",
+  "version": "0.1.0",
+  "description": "CLI and library for building LLM context bundles for native iOS and Android projects",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "mobile-context-trimmer": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm test && npm run build"
+  },
+  "keywords": [
+    "ios",
+    "android",
+    "mobile",
+    "swift",
+    "kotlin",
+    "llm",
+    "context",
+    "cli",
+    "typescript",
+    "codebase",
+    "xcode",
+    "gradle"
+  ],
+  "author": "isonka",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/isonka/mobile-context-trimmer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/isonka/mobile-context-trimmer/issues"
+  },
+  "homepage": "https://github.com/isonka/mobile-context-trimmer#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "dependencies": {
+    "ignore": "^7.0.5",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@emnapi/core": "1.9.2",
+    "@emnapi/runtime": "1.9.2",
+    "@types/node": "^25.5.2",
+    "@types/yargs": "^17.0.35",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.3"
+  }
+}