@rilaptra/digester 17.2.0-ai
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.
- package/README.md +152 -0
- package/dist/index.js +10221 -0
- package/package.json +62 -0
package/README.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# ⚡ DIGESTER
|
|
2
|
+
<div align="center">
|
|
3
|
+
|
|
4
|
+
```text
|
|
5
|
+
░███████ ░██ ░██
|
|
6
|
+
░██ ░██ ░██
|
|
7
|
+
░██ ░██ ░██ ░████████ ░███████ ░███████ ░████████ ░███████ ░██░████
|
|
8
|
+
░██ ░██ ░██░██ ░██ ░██ ░██ ░██ ░██ ░██ ░██ ░███
|
|
9
|
+
░██ ░██ ░██░██ ░██ ░█████████ ░███████ ░██ ░█████████ ░██
|
|
10
|
+
░██ ░██ ░██░██ ░███ ░██ ░██ ░██ ░██ ░██
|
|
11
|
+
░███████ ░██ ░█████░██ ░███████ ░███████ ░████ ░███████ ░██
|
|
12
|
+
░██
|
|
13
|
+
░███████
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
> **The Ultimate AI Operations Agent & Codebase Context Engine.**
|
|
22
|
+
> Built for speed on low-end hardware. Zero dependencies bloat. 100% Bun Native.
|
|
23
|
+
|
|
24
|
+
**Digester** is not just a context generator. It is a highly optimized CLI toolkit that turns your codebase into a liquid format for LLMs, automates your Git workflows with AI, traces dependencies, and protects your secrets—all running on a toaster-friendly memory footprint.
|
|
25
|
+
|
|
26
|
+
</div>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 🌟 Why Digester?
|
|
31
|
+
|
|
32
|
+
- **⚡ Blazingly Fast:** Powered by Bun, scanning thousands of files in milliseconds.
|
|
33
|
+
- **🎨 Custom TUI Engine:** No heavy prompt libraries. Built-in, zero-allocation UI components (Grid Select, Editors, Spinners).
|
|
34
|
+
- **🛡️ Security Guard:** AI scans your staged changes for leaked secrets (API Keys, tokens) _before_ you commit.
|
|
35
|
+
- **🧠 Dependency Tracing:** Recursively maps out imports from an entry point to create a focused context graph.
|
|
36
|
+
- **🌍 Remote Ops:** Clone, scan, and digest remote GitHub repositories in temporary sandboxes without polluting your disk.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 🚀 Key Features
|
|
41
|
+
|
|
42
|
+
### 1. 🤖 AI Auto-Ops Agent
|
|
43
|
+
|
|
44
|
+
Stop writing commit messages manually.
|
|
45
|
+
|
|
46
|
+
- **Auto-Commit:** Analyzes `git diff`, writes Conventional Commits, and generates a bullet-point Changelog.
|
|
47
|
+
- **Auto-Version:** Smart SemVer bumping (Major/Minor/Patch) based on code analysis.
|
|
48
|
+
- **Pre-Push Hooks:** Runs configured scripts or TS files before pushing to ensure quality.
|
|
49
|
+
|
|
50
|
+
### 2. 🗺️ Code Cartography
|
|
51
|
+
|
|
52
|
+
Understand your project instantly.
|
|
53
|
+
|
|
54
|
+
- **`digest tree`:** Visualize your project structure with smart file-type icons.
|
|
55
|
+
- **`digest trace`:** Generate a markdown digest _only_ for files related to a specific entry point (e.g., `src/index.ts`).
|
|
56
|
+
- **`digest git`:** Digest a remote repo URL directly (e.g., `digest git user/repo`).
|
|
57
|
+
|
|
58
|
+
### 3. 🛠️ Developer Experience (DX)
|
|
59
|
+
|
|
60
|
+
- **Auto-Build Watcher:** `digest autobuild` watches changes and recompiles with audio feedback.
|
|
61
|
+
- **Scaffolder:** `digest gen` creates new Commands or Managers instantly.
|
|
62
|
+
- **Self-Healing:** `digest update` pulls the latest version of itself and rebuilds locally.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 📥 Installation
|
|
67
|
+
|
|
68
|
+
Digester is optimized for **Bun**. Ensure you have it installed.
|
|
69
|
+
|
|
70
|
+
### Option A: From Source (Recommended)
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 1. Clone
|
|
74
|
+
git clone https://github.com/Rilaptra/digester.git
|
|
75
|
+
cd digester
|
|
76
|
+
|
|
77
|
+
# 2. Install Deps
|
|
78
|
+
bun install
|
|
79
|
+
|
|
80
|
+
# 3. Build & Setup (Adds to PATH)
|
|
81
|
+
bun run setup
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Option B: Quick Start (Dev Mode)
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
bun install
|
|
88
|
+
bun run dev
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## 🎮 Command Reference
|
|
94
|
+
|
|
95
|
+
| Command | Alias | Description |
|
|
96
|
+
| :----------------- | :-------- | :--------------------------------------------------------- |
|
|
97
|
+
| `digest scan` | `.` | Scan current directory and generate context. |
|
|
98
|
+
| `digest commit` | `ci` | **AI Agent:** Auto-commit, version bump, changelog, push. |
|
|
99
|
+
| `digest check` | `ck` | Scan staged changes for secret leaks/security risks. |
|
|
100
|
+
| `digest git` | `clone` | Clone & digest a remote Git repository (URL or user/repo). |
|
|
101
|
+
| `digest trace` | `deps` | Trace dependencies recursively from an entry file. |
|
|
102
|
+
| `digest tree` | `t` | Display project structure with icons & stats. |
|
|
103
|
+
| `digest source` | `src` | Self-digest: Scan the Digester source code itself. |
|
|
104
|
+
| `digest gen` | `new` | Scaffold new Commands or Managers. |
|
|
105
|
+
| `digest config` | `init` | Generate default `prompter.config.json`. |
|
|
106
|
+
| `digest autobuild` | `dev` | Watch mode with auto-recompile & sound alerts. |
|
|
107
|
+
| `digest update` | `upgrade` | Self-update Digester from the repo. |
|
|
108
|
+
| `digest set-key` | `auth` | Set your Google Gemini API Key. |
|
|
109
|
+
| `digest set-model` | `model` | Switch AI Models (Flash/Pro). |
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## ⚙️ Configuration
|
|
114
|
+
|
|
115
|
+
Customize behavior via `prompter.config.json`:
|
|
116
|
+
|
|
117
|
+
```json
|
|
118
|
+
{
|
|
119
|
+
"ignoredPatterns": ["node_modules", "dist", ".git", ".next"],
|
|
120
|
+
"ignoredExts": [".png", ".jpg", ".lock", ".tsbuildinfo"],
|
|
121
|
+
"maxFileSizeKB": 500,
|
|
122
|
+
"prePushScripts": ["lint", "test"]
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 🛡️ Architecture & Stack
|
|
129
|
+
|
|
130
|
+
Designed for **Resilience** and **Performance**.
|
|
131
|
+
|
|
132
|
+
- **Runtime:** [Bun](https://bun.sh) (Native Spawn, IO, SQLite)
|
|
133
|
+
- **Language:** TypeScript 5.0 (Strict)
|
|
134
|
+
- **Architecture:**
|
|
135
|
+
- **Core:** `Scanner`, `DependencyTracer`, `CommandLoader`
|
|
136
|
+
- **Managers:** `AIManager` (Gemini), `GitManager`, `ConfigManager`
|
|
137
|
+
- **Utils:** Zero-alloc Logger, Custom TUI System
|
|
138
|
+
- **Linter/Formatter:** Biome
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 👤 Author
|
|
143
|
+
|
|
144
|
+
**Rizqi Lasheva (Rilaptra)**
|
|
145
|
+
_Civil Engineering Student x Code Wizard._
|
|
146
|
+
|
|
147
|
+
- 🌐 [Eryzsh Dashboard](https://erzysh.vercel.app)
|
|
148
|
+
- 🐙 [GitHub](https://github.com/Rilaptra)
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
> _"Code by Human, Optimized by Logic, Powered by AI."_ ⚡
|