fln 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eugene Nesvetaev
+
+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,330 @@
+# 🥞 fln
+
+[![CI](https://github.com/nesvet/fln/actions/workflows/ci.yaml/badge.svg)](https://github.com/nesvet/fln/actions/workflows/ci.yaml)
+[![npm](https://img.shields.io/npm/v/fln)](https://www.npmjs.com/package/fln)
+[![license](https://img.shields.io/npm/l/fln)](LICENSE)
+
+**Your entire codebase → One AI-ready file.**
+
+Stop wrestling with file pickers and attachment limits — feed your whole project to any LLM in one shot.
+
+```bash
+fln .
+```
+
+Or run instantly:
+
+```bash
+npx fln . -o codebase.md
+```
+
+Works with **Claude**, **ChatGPT**, **Gemini**, **Grok**, **Cursor**, **Copilot**, and *any* AI tool.
+
+**`fln`** (short for *flatten*) is **language-agnostic** by design: TypeScript, Python, Java, Go, Rust, Bash, SQL, mixed monorepos — it treats everything as plain text, detects project metadata from common manifests (`package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `CMakeLists.txt`, `vcpkg.json`), respects `.gitignore`, and skips binaries by default.
+
+## Why fln exists
+
+If you use LLMs for real projects, you’ve hit these limits:
+
+- **Context windows** — large projects don’t fit.
+- **Upload friction** — selecting dozens of files for every session.
+- **Partial understanding** — AI sees fragments, not the architecture.
+- **Manual prep** — repeating the same setup context again and again.
+
+**`fln` removes that overhead.**  
+It turns your project into a single, structured snapshot that LLMs can actually reason about.
+
+## What fln enables
+
+**→ Full-context refactoring**  
+Ask architectural questions that are impossible file-by-file:
+> “Where is the real coupling here?”  
+> “What should be split into modules?”
+
+**→ Instant onboarding**  
+One markdown file instead of “start by opening these 12 folders”. Perfect for reading code on a tablet or onboarding new developers without an IDE.
+
+**→ Project-level code reviews**  
+Let AI detect patterns, inconsistencies, and risks across the entire codebase.
+
+**→ Auditable Snapshots**  
+Create a single, clean artifact of your codebase state for security reviews, compliance audits, or legal records without granting full repo access.
+
+**→ Dataset Preparation**  
+Generate clean, formatted data for RAG pipelines and fine-tuning custom models.
+
+**→ LLM-friendly diffs**  
+Flatten → commit → flatten again. See how the *whole project* changed structurally.
+
+## Compatible with your AI workflow
+
+- **Claude** — ideal for large architectural prompts (200K+ tokens).
+- **Gemini** — push massive codebases into 1M token windows.
+- **ChatGPT** — single-shot analysis without attachments.
+- **Cursor / Windsurf** — reference the full project in prompts.
+- **GitHub Copilot** — better context → better suggestions.
+- **Local LLMs** — datasets for RAG and fine-tuning.
+
+## Built for real projects
+
+- ⚡ **Fast parallel scanning** — thousands of files in seconds.
+- 🎯 **Smart filtering** — respects `.gitignore`, excludes binaries, configurable size limits.
+- 📁 **Intentional file order** — entry points and configs first, not alphabetical noise.
+- 🔄 **Auto-detection** — skips files previously generated by `fln`.
+- 📐 **Deterministic output** — same input → same snapshot.
+- 🧠 **Project metadata detection** — name & version from ecosystem-native manifests.
+- 🛠️ **Developer-friendly** — `Markdown` for humans, `JSON` for tooling, `--dry-run` mode for safety.
+- 🔒 **No surprises** — runs locally, no data leaves your machine.
+
+Zero dependencies on external services. Zero tracking. Just a tool that does its job.
+
+## Install
+
+```bash
+# npm
+npm install -g fln
+
+# one-liner (macOS/Linux)
+curl -fsSL "https://raw.githubusercontent.com/nesvet/fln/main/install.sh" | sh
+
+# one-liner (Windows)
+irm "https://raw.githubusercontent.com/nesvet/fln/main/install.ps1" | iex
+
+# or just run without installing
+npx fln . -o codebase.md
+```
+
+<details>
+<summary>More installation options</summary>
+
+### One-line installer options (macOS/Linux)
+
+Pin a version or custom install directory:
+
+```bash
+curl -fsSL "https://raw.githubusercontent.com/nesvet/fln/main/install.sh" | FLN_VERSION="<version>" INSTALL_DIR="$HOME/.local/bin" sh
+```
+
+### One-line installer options (Windows PowerShell)
+
+```powershell
+$env:FLN_VERSION = "<version>"
+$env:INSTALL_DIR = "$env:LOCALAPPDATA\\fln\\bin"
+irm "https://raw.githubusercontent.com/nesvet/fln/main/install.ps1" | iex
+```
+
+### Manual download (GitHub Releases)
+
+```bash
+curl -L "https://github.com/nesvet/fln/releases/latest/download/fln-macos-x64.tar.gz" | tar -xz -C /usr/local/bin
+chmod +x /usr/local/bin/fln
+fln --help
+```
+
+</details>
+
+## Usage
+
+```bash
+fln [directory] [options]
+```
+
+Examples:
+
+```bash
+# Flatten entire project
+fln .
+
+# Exclude tests and fixtures
+fln src -e "**/*.test.ts" -e "fixtures/"
+
+# Force include a file (even if ignored)
+fln . -i "dist/output.md"
+
+# Generate JSON for tooling
+fln . --no-contents --format json
+
+# Preview without writing
+fln . --dry-run
+```
+
+<details>
+<summary>All CLI options</summary>
+
+- `-o, --output <path>` Output file or directory
+- `-e, --exclude <glob>` Exclude patterns (repeatable)
+- `-i, --include <glob>` Force include patterns
+- `--include-hidden` Include hidden files and directories
+- `--no-gitignore` Ignore `.gitignore`
+- `--max-size <size>` Max file size (`10mb`, `512kb`)
+- `--max-total-size <size>` Max total included size
+- `--no-contents` Exclude file contents
+- `--no-tree` Exclude directory tree
+- `--format <md|json>` Output format
+- `--dry-run` Scan without writing output
+- `--follow-symlinks` Follow symlinks
+- `--no-ansi` Disable ANSI colors
+- `--no-sponsor-message` Hide support message (also: `FLN_NO_SPONSOR=1`)
+- `--generated-date <date>` Use this date in the "Generated" header (format: `YYYY-MM-DD HH:mm`)
+- `--banner <text>` Add text at the beginning
+- `--footer <text>` Add text at the end of the output
+- `-q, --quiet` Minimal output
+- `-V, --verbose` Verbose output with breakdown
+- `--debug` Debug output with file list
+- `-v, --version` Show version
+- `-h, --help` Show help
+
+</details>
+
+## CI/CD & Automation
+
+Integrate `fln` into your pipeline to keep your codebase “AI-ready” automatically.
+
+### GitHub Actions: Auto-generate Snapshots
+
+Generate a fresh `codebase.md` artifact on every push. Download it anytime to chat with LLMs about the *exact* state of your main branch or a specific PR without manual scanning.
+
+Create `.github/workflows/codebase-snapshot.yaml`:
+
+```yaml
+name: Snapshot Codebase
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+
+jobs:
+  snapshot:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Generate Snapshot
+        # Generates codebase.md without installing fln globally
+        run: npx fln . -o codebase.md --no-ansi
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: codebase-snapshot
+          path: codebase.md
+          retention-days: 7
+```
+
+### Git Hooks: Pre-commit Context Guard
+
+Prevent accidental “context bloat” (e.g., committing large datasets or wrong lockfiles) by failing commits if the flattened codebase exceeds a specific size. This ensures your project always fits within LLM context windows.
+
+Add to your pre-commit hook (e.g., via `husky` or `lint-staged`):
+
+```bash
+# Fails the commit if the flattened codebase exceeds 5MB (configurable)
+# --dry-run ensures no files are written to disk
+npx fln . --dry-run --max-total-size 5mb
+```
+
+## JavaScript API
+
+```typescript
+import { fln } from "fln";
+
+const result = await fln({
+  rootDirectory: "./src",
+  outputFile: "output.md",
+  excludePatterns: [ "*.test.ts", "fixtures/" ],
+  format: "md",
+  onProgress: (current, total) => {
+    console.log(`Progress: ${current}/${total}`);
+  }
+});
+
+console.log(`Processed ${result.files} files`);
+console.log(`Output: ${result.outputPath}`);
+console.log(`Tokens: ${result.outputTokenCount}`);
+```
+
+All CLI options are available via `FlnOptions`.
+
+
+## Advanced
+
+<details>
+<summary>Configuration file (.fln.json)</summary>
+
+```json
+{
+	"outputFile": "output.md",
+	"excludePatterns": [
+		"dist/",
+		"**/*.snap"
+	],
+	"includePatterns": [],
+	"includeHidden": false,
+	"useGitignore": true,
+	"maximumFileSizeBytes": "10mb",
+	"maximumTotalSizeBytes": "0",
+	"includeTree": true,
+	"includeContents": true,
+	"format": "md",
+	"followSymlinks": false,
+	"logLevel": "normal",
+	"generatedDate": "2026-02-09 12:00",
+	"banner": "This is a snapshot of the codebase.",
+	"footer": "End of snapshot."
+}
+```
+
+</details>
+
+<details>
+<summary>Output naming & formats</summary>
+
+- Uses project name + version if available (`package.json`, `pyproject.toml`, `Cargo.toml`, `vcpkg.json`, `go.mod`, or `CMakeLists.txt`)  
+- `md` includes tree + contents
+- `json` includes `rootDirectory`, `tree`, `stats`
+
+</details>
+
+<details>
+<summary>Runtime compatibility</summary>
+
+**Node.js**
+- Requires Node.js `>=18.3`
+- ESM-only package (`"type": "module"`)
+- CLI works via `npm i -g fln` or `npx fln`
+
+**Bun**
+- Requires Bun `>=1.0.0`
+- CLI works via `bun install -g fln` or `bunx fln`
+
+</details>
+
+## Preview
+
+Full real outputs are provided below. Each example is a compact project in [`examples/`](examples/). `fln` outputs the directory tree and file contents with **entry points and configs first** (intentional file order):
+
+- [TypeScript](examples/ts-app.md)
+- [Python](examples/python-app.md)
+- [Java](examples/java-app.md)
+- [Go](examples/go-app.md)
+- [Rust](examples/rust-app.md)
+
+## Support this project
+
+**fln is free, open-source, and maintained by one developer.**
+
+If it saves you time or improves your AI workflow:
+- ⭐️ Star the repo — it genuinely helps discoverability
+- 💙 Support on [Patreon](https://www.patreon.com/nesvet) — priority features & long-term maintenance
+
+## Contributing
+
+PRs and issues are welcome.  
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for setup and guidelines.
+
+## License
+
+MIT

package/dist/api/fln.d.ts

@@ -0,0 +1,3 @@
+import type { FlnOptions, FlnResult } from "./types";
+export declare function fln(options?: FlnOptions): Promise<FlnResult>;
+//# sourceMappingURL=fln.d.ts.map

package/dist/api/fln.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fln.d.ts","sourceRoot":"","sources":["../../src/api/fln.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAuBrD,wBAAsB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAsFtE"}

package/dist/api/fln.js

@@ -0,0 +1,71 @@
+import { relative, resolve, sep } from "node:path";
+import { parseByteSize, scanTree, writeOutput } from "$core";
+import { createLogger } from "$infra";
+import { defaultConfigFileName, getProjectMetadata, loadConfigFile, normalizeConfigFile, resolveConfig, resolveOutputPath } from "../config";
+export async function fln(options = {}) {
+    const rootDirectory = resolve(options.rootDirectory ?? process.cwd());
+    const projectMetadata = await getProjectMetadata(rootDirectory);
+    const configFilePath = resolve(rootDirectory, defaultConfigFileName);
+    const fileConfig = normalizeConfigFile(await loadConfigFile(configFilePath));
+    const format = options.format ?? fileConfig.format ?? "md";
+    const outputValue = options.outputFile ?? fileConfig.outputFile;
+    const outputFile = await resolveOutputPath(outputValue ? resolve(outputValue) : undefined, rootDirectory, format);
+    const userConfig = {
+        outputFile,
+        excludePatterns: options.excludePatterns,
+        includePatterns: options.includePatterns,
+        includeHidden: options.includeHidden,
+        useGitignore: options.useGitignore,
+        maximumFileSizeBytes: typeof options.maximumFileSizeBytes === "string" ?
+            parseByteSize(options.maximumFileSizeBytes) :
+            options.maximumFileSizeBytes,
+        maximumTotalSizeBytes: typeof options.maximumTotalSizeBytes === "string" ?
+            parseByteSize(options.maximumTotalSizeBytes) :
+            options.maximumTotalSizeBytes,
+        includeContents: options.includeContents,
+        includeTree: options.includeTree,
+        format,
+        followSymlinks: options.followSymlinks,
+        useAnsi: false,
+        logLevel: options.logLevel ?? "silent",
+        generatedDate: options.generatedDate,
+        banner: options.banner,
+        footer: options.footer
+    };
+    const config = resolveConfig(rootDirectory, fileConfig, userConfig);
+    const outputRelativePath = relative(rootDirectory, config.outputFile);
+    const outputRelativeNormalized = outputRelativePath.split(sep).join("/");
+    if (outputRelativeNormalized !== "" && !outputRelativeNormalized.startsWith("../") && outputRelativeNormalized !== "..")
+        config.excludedPaths = [outputRelativeNormalized];
+    if (!config.includeContents) {
+        config.maximumFileSizeBytes = Number.MAX_SAFE_INTEGER;
+        config.maximumTotalSizeBytes = 0;
+    }
+    if (config.maximumFileSizeBytes <= 0)
+        throw new Error("Max file size must be greater than 0.");
+    if (config.maximumTotalSizeBytes < 0)
+        throw new Error("Max total size must be 0 or greater.");
+    const logger = createLogger({
+        useAnsi: config.useAnsi,
+        logLevel: config.logLevel
+    });
+    const result = await scanTree({
+        projectName: projectMetadata.name,
+        ...config,
+        onProgress: options.onProgress
+    }, logger);
+    await writeOutput(result, config);
+    return {
+        projectName: result.projectName,
+        files: result.stats.files,
+        directories: result.stats.directories,
+        binary: result.stats.binary,
+        skipped: result.stats.skipped,
+        errors: result.stats.errors,
+        totalSizeBytes: result.stats.totalSizeBytes,
+        outputSizeBytes: result.stats.outputSizeBytes,
+        outputTokenCount: result.stats.outputTokenCount,
+        outputPath: config.outputFile,
+        _root: result.root
+    };
+}

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./fln";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,2 @@
+export * from "./fln";
+export * from "./types";

package/dist/api/types.d.ts

@@ -0,0 +1,34 @@
+import type { LogLevel, ProgressCallback } from "$core";
+export type FlnOptions = {
+    rootDirectory?: string;
+    outputFile?: string;
+    excludePatterns?: string[];
+    includePatterns?: string[];
+    includeHidden?: boolean;
+    useGitignore?: boolean;
+    maximumFileSizeBytes?: number | string;
+    maximumTotalSizeBytes?: number | string;
+    includeContents?: boolean;
+    includeTree?: boolean;
+    format?: "json" | "md";
+    followSymlinks?: boolean;
+    generatedDate?: string;
+    banner?: string;
+    footer?: string;
+    onProgress?: ProgressCallback;
+    logLevel?: LogLevel;
+};
+export type FlnResult = {
+    projectName: string;
+    files: number;
+    directories: number;
+    binary: number;
+    skipped: number;
+    errors: number;
+    totalSizeBytes: number;
+    outputSizeBytes: number;
+    outputTokenCount: number;
+    outputPath: string;
+    _root?: unknown;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAMxD,MAAM,MAAM,UAAU,GAAG;IAKxB,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAM3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAM3B,aAAa,CAAC,EAAE,OAAO,CAAC;IAMxB,YAAY,CAAC,EAAE,OAAO,CAAC;IAMvB,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAMvC,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAMxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAM1B,WAAW,CAAC,EAAE,OAAO,CAAC;IAMtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMvB,cAAc,CAAC,EAAE,OAAO,CAAC;IAKzB,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAM9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAKF,MAAM,MAAM,SAAS,GAAG;IAIvB,WAAW,EAAE,MAAM,CAAC;IAKpB,KAAK,EAAE,MAAM,CAAC;IAKd,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IAKf,OAAO,EAAE,MAAM,CAAC;IAKhB,MAAM,EAAE,MAAM,CAAC;IAKf,cAAc,EAAE,MAAM,CAAC;IAKvB,eAAe,EAAE,MAAM,CAAC;IAKxB,gBAAgB,EAAE,MAAM,CAAC;IAKzB,UAAU,EAAE,MAAM,CAAC;IAMnB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC"}

package/dist/api/types.js

@@ -0,0 +1 @@
+export {};

package/dist/cli/commandLine.d.ts

@@ -0,0 +1,2 @@
+export declare function runCommandLine(): Promise<void>;
+//# sourceMappingURL=commandLine.d.ts.map

package/dist/cli/commandLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandLine.d.ts","sourceRoot":"","sources":["../../src/cli/commandLine.ts"],"names":[],"mappings":"AAwCA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAkHpD"}

package/dist/cli/commandLine.js

@@ -0,0 +1,120 @@
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { fln } from "$api";
+import { collectExtensionStats, collectProcessedFiles, parseByteSize } from "$core";
+import { getTerminalInfo, incrementUsageCount, shouldShowSponsorMessage, shouldUseColors } from "$infra";
+import { VERSION } from "$version";
+import { formatHelpMessage } from "./help";
+import { OutputRenderer } from "./output";
+function isCI() {
+    return Boolean(process.env.CI ||
+        process.env.CONTINUOUS_INTEGRATION ||
+        process.env.BUILD_NUMBER ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.GITLAB_CI ||
+        process.env.CIRCLECI);
+}
+function shouldShowSponsor(runCount, noSponsorFlag) {
+    return (!noSponsorFlag &&
+        !isCI() &&
+        process.env.FLN_NO_SPONSOR !== "1" &&
+        shouldShowSponsorMessage(runCount));
+}
+export async function runCommandLine() {
+    const { values, positionals } = parseArgs({
+        options: {
+            output: { type: "string", short: "o" },
+            exclude: { type: "string", short: "e", multiple: true },
+            include: { type: "string", short: "i", multiple: true },
+            "include-hidden": { type: "boolean" },
+            "no-gitignore": { type: "boolean" },
+            "max-size": { type: "string" },
+            "max-total-size": { type: "string" },
+            "no-contents": { type: "boolean" },
+            "no-tree": { type: "boolean" },
+            format: { type: "string" },
+            "dry-run": { type: "boolean" },
+            quiet: { type: "boolean", short: "q" },
+            verbose: { type: "boolean", short: "V" },
+            debug: { type: "boolean" },
+            "no-ansi": { type: "boolean" },
+            "follow-symlinks": { type: "boolean" },
+            "no-sponsor-message": { type: "boolean" },
+            "generated-date": { type: "string" },
+            banner: { type: "string" },
+            footer: { type: "string" },
+            version: { type: "boolean", short: "v" },
+            help: { type: "boolean", short: "h" }
+        },
+        strict: true,
+        allowPositionals: true
+    });
+    if (values.version) {
+        console.info(VERSION);
+        process.exit(0);
+    }
+    if (values.help) {
+        const { supportsAnsi } = getTerminalInfo();
+        console.info(formatHelpMessage(supportsAnsi));
+        process.exit(0);
+    }
+    if (values.quiet && values.verbose)
+        throw new Error("Cannot use --quiet and --verbose together.");
+    if (values.quiet && values.debug)
+        throw new Error("Cannot use --quiet and --debug together.");
+    if (values.verbose && values.debug)
+        throw new Error("Cannot use --verbose and --debug together.");
+    const runCount = await incrementUsageCount();
+    const rootDirectory = resolve(process.cwd(), positionals[0] || ".");
+    const isDryRun = values["dry-run"] ?? false;
+    const logLevel = values.quiet ? "silent" : values.debug ? "debug" : values.verbose ? "verbose" : "normal";
+    const useAnsi = shouldUseColors() && !values["no-ansi"];
+    const renderer = new OutputRenderer({ logLevel, useAnsi });
+    const progress = renderer.createProgressBar(100);
+    const startTime = Date.now();
+    const result = await fln({
+        rootDirectory,
+        outputFile: isDryRun ?
+            (process.platform === "win32" ? "nul" : "/dev/null") :
+            (values.output ? resolve(values.output) : undefined),
+        excludePatterns: values.exclude,
+        includePatterns: values.include,
+        includeHidden: values["include-hidden"],
+        useGitignore: values["no-gitignore"] ? false : undefined,
+        maximumFileSizeBytes: values["max-size"] ? parseByteSize(values["max-size"]) : undefined,
+        maximumTotalSizeBytes: values["max-total-size"] ? parseByteSize(values["max-total-size"]) : undefined,
+        includeContents: values["no-contents"] ? false : undefined,
+        includeTree: values["no-tree"] ? false : undefined,
+        format: values.format,
+        followSymlinks: values["follow-symlinks"],
+        generatedDate: values["generated-date"],
+        banner: values.banner,
+        footer: values.footer,
+        onProgress: () => {
+            progress.increment();
+        },
+        logLevel
+    });
+    const elapsedMs = Date.now() - startTime;
+    progress.clear();
+    if (isDryRun && logLevel !== "silent")
+        console.info("Dry run mode — output was not written");
+    const breakdown = (logLevel === "verbose" || logLevel === "debug") && result._root ?
+        collectExtensionStats(result._root) :
+        undefined;
+    const processedFiles = logLevel === "debug" && result._root ?
+        collectProcessedFiles(result._root) :
+        undefined;
+    renderer.renderSuccess({
+        outputPath: result.outputPath,
+        result,
+        elapsedMs,
+        breakdown,
+        processedFiles
+    });
+    if (!isDryRun && logLevel !== "silent" && shouldShowSponsor(runCount, Boolean(values["no-sponsor-message"]))) {
+        console.info("");
+        console.info("💙 Support fln development: https://patreon.com/nesvet");
+        console.info("");
+    }
+}

package/dist/cli/help.d.ts

@@ -0,0 +1,2 @@
+export declare function formatHelpMessage(useAnsi: boolean): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAuC1D"}

package/dist/cli/help.js

@@ -0,0 +1,40 @@
+import { applyColor, colors } from "./output/styles";
+export function formatHelpMessage(useAnsi) {
+    const bold = (text) => applyColor(text, colors.bold, useAnsi);
+    const dim = (text) => applyColor(text, colors.dim, useAnsi);
+    const cyan = (text) => applyColor(text, colors.info, useAnsi);
+    const green = (text) => applyColor(text, colors.success, useAnsi);
+    return `${bold("fln")} ${dim("—")} Flatten your codebase into a single file for LLMs.
+
+${bold("Usage:")} fln ${cyan("[directory]")} ${dim("[...flags]")}
+
+${bold("Options:")}
+  ${cyan("-o, --output")} ${dim("<path>")}       Output file or directory path ${dim("(default: <name>-<version>.<ext>)")}
+  ${cyan("-e, --exclude")} ${dim("<glob>")}      Exclude patterns ${dim("(repeatable)")}
+  ${cyan("-i, --include")} ${dim("<glob>")}      Force include patterns ${dim("(repeatable)")}
+  ${cyan("    --include-hidden")}      Include hidden files and directories
+  ${cyan("    --no-gitignore")}        Ignore .gitignore files
+  ${cyan("    --max-size")} ${dim("<size>")}     Max file size ${dim("(e.g. 10mb, 512kb)")}
+  ${cyan("    --max-total-size")} ${dim("<size>")} Max total included size
+  ${cyan("    --no-contents")}         Exclude file contents
+  ${cyan("    --no-tree")}             Exclude directory tree
+  ${cyan("    --format")} ${dim("<md|json>")}    Output format ${dim("(default: md)")}
+  ${cyan("    --dry-run")}             Scan and report without writing output
+  ${cyan("    --follow-symlinks")}     Follow symlinks while scanning
+  ${cyan("    --no-ansi")}             Disable ANSI colors
+  ${cyan("    --no-sponsor-message")}  Hide support message ${dim("(also: FLN_NO_SPONSOR=1)")}
+  ${cyan("    --generated-date")} ${dim("<date>")} Use this date in the "Generated" header ${dim("(YYYY-MM-DD HH:mm)")}
+  ${cyan("    --banner")} ${dim("<text>")}       Add text at the beginning of the output
+  ${cyan("    --footer")} ${dim("<text>")}       Add text at the end of the output
+  ${cyan("-q, --quiet")}               Minimal output
+  ${cyan("-V, --verbose")}             Verbose output
+  ${cyan("    --debug")}               Debug output with file list
+  ${cyan("-v, --version")}             Show version
+  ${cyan("-h, --help")}                Show this help message
+
+${bold("Examples:")}
+  ${dim("$")} fln . ${cyan("-o")} output.md
+  ${dim("$")} fln src ${cyan("-e")} ${green('"*.test.ts"')} ${cyan("-e")} ${green('"fixtures/"')}
+  ${dim("$")} fln . ${cyan("--no-contents --format")} json
+`;
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./commandLine";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1 @@
+export * from "./commandLine";