geeto 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,152 @@
+# Geeto
+
+> AI-Powered Git Workflow Automation
+
+[![npm version](https://badge.fury.io/js/%40geeto%2Fcore.svg)](https://badge.fury.io/js/%40geeto%2Fcore)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+Streamline your Git workflow with intelligent branch naming, commit messages, and Trello integration—powered by AI (Gemini, GitHub Copilot, OpenRouter).
+
+## Features
+
+- **Multiple AI Providers** - Gemini, GitHub Copilot, OpenRouter
+- **Smart Branch Naming** - AI-generated branch names from diffs or Trello cards
+- **Conventional Commits** - Auto-generated commit messages following best practices
+- **Trello Integration** - Link branches to Trello cards, generate task lists for AI agents
+- **Checkpoint Recovery** - Resume interrupted workflows from any step
+- **Cross-Platform** - macOS, Linux, Windows
+
+## Installation
+
+### NPM/Bun
+
+```bash
+npm install -g @geeto/core
+# or
+bun install -g @geeto/core
+```
+
+### From Source
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/install.sh | bash -s -- --no-label
+```
+
+**Requirements:** Node.js ≥ 18, Bun ≥ 1.0, Git ≥ 2.0
+
+## Uninstallation
+
+### NPM/Bun
+
+```bash
+npm uninstall -g @geeto/core
+# or
+bun remove -g @geeto/core
+```
+
+### From Source
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/rust142/geeto/main/tools/uninstall.sh | bash
+```
+
+## Quick Start
+
+### 1. Run
+
+```bash
+geeto
+```
+
+On first run, Geeto will automatically guide you through AI provider setup:
+
+- **Gemini** - Enter your API key (get one at [Google AI Studio](https://makersuite.google.com/app/apikey))
+- **OpenRouter** - Enter your API key (get one at [OpenRouter](https://openrouter.ai/keys))
+- **GitHub Copilot** - Auto-configured (requires [GitHub CLI](https://cli.github.com/))
+
+All configurations are saved locally in `.geeto/` directory.
+
+### 2. Follow the Workflow
+
+Geeto guides you through 6 steps:
+
+1. **Stage** - Select files to commit
+2. **Branch** - AI-generated branch name
+3. **Commit** - AI-generated commit message
+4. **Push** - Push to remote
+5. **Merge** - Merge to target branch
+6. **Cleanup** - Delete merged branches
+
+### CLI Flags
+
+```bash
+geeto --stage          # Start from stage step
+geeto --branch         # Start from branch creation
+geeto --commit         # Start from commit step
+geeto --push           # Start from push step
+geeto --merge          # Start from merge step
+geeto --cleanup        # Branch cleanup workflow
+geeto --trello         # Trello integration menu
+geeto --settings       # Configure AI providers
+```
+
+### Trello Integration
+
+Generate task instruction files for AI agents:
+
+```bash
+geeto --trello-generate
+```
+
+Creates `.github/instructions/tasks.instructions.md` (VSCode) or editor-specific paths with:
+
+- Step-by-step task list from Trello
+- AI agent instructions (execute one task at a time)
+- Backend/Frontend best practices
+
+## Development
+
+```bash
+# Setup
+git clone https://github.com/rust142/geeto.git
+cd geeto
+bun install
+
+# Build
+bun run build
+
+# Development mode
+bun run dev
+
+# Lint & Type Check
+bun run check:fast
+bun run check:full
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+## Contributing
+
+We welcome contributions! Please:
+
+1. Fork the repository
+2. Create a branch: `dev#your-feature`
+3. Make your changes
+4. Run tests: `bun run check:fast && bun run check:full`
+5. Submit a Pull Request to `develop` branch
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## Support
+
+If you find Geeto helpful, consider supporting the project:
+
+- ☕ [Buy me a coffee on Saweria](https://saweria.co/rust142)
+- ⭐ Star this repository
+- 🐛 Report bugs and suggest features
+- 📢 Share with others
+
+## License
+
+This project is licensed under the MIT License.

package/lib/api/copilot-adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Try SDK availability first; fallback to CLI ping for model enable checks.
+ */
+export declare const pingModel: (model: string) => Promise<boolean>;
+export declare const isCliAvailable: () => boolean;
+declare const _default: {
+    pingModel: (model: string) => Promise<boolean>;
+    isCliAvailable: () => boolean;
+};
+export default _default;
+//# sourceMappingURL=copilot-adapter.d.ts.map

package/lib/api/copilot-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-adapter.d.ts","sourceRoot":"","sources":["../../src/api/copilot-adapter.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAoB9D,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,OAOjC,CAAA;;uBA7BsC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;0BAsB9B,OAAO;;AASzC,wBAGC"}

package/lib/api/copilot-adapter.js

@@ -0,0 +1,41 @@
+import { exec } from '../utils/exec.js';
+import { log } from '../utils/logging.js';
+/**
+ * Try SDK availability first; fallback to CLI ping for model enable checks.
+ */
+export const pingModel = async (model) => {
+    try {
+        const sdk = await import('./copilot-sdk.js');
+        if (sdk && typeof sdk.isAvailable === 'function') {
+            const ok = await sdk.isAvailable();
+            if (ok) {
+                return true;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    try {
+        exec(`copilot -p "ping" --model ${model}`, true);
+        return true;
+    }
+    catch (error) {
+        log.info('Copilot CLI ping failed: ' + String(error));
+        return false;
+    }
+};
+export const isCliAvailable = () => {
+    try {
+        exec('copilot --version', true);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+export default {
+    pingModel,
+    isCliAvailable,
+};
+//# sourceMappingURL=copilot-adapter.js.map

package/lib/api/copilot-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-adapter.js","sourceRoot":"","sources":["../../src/api/copilot-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAa,EAAoB,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAC5C,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAA;YAClC,IAAI,EAAE,EAAE,CAAC;gBACP,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,6BAA6B,KAAK,EAAE,EAAE,IAAI,CAAC,CAAA;QAChD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,2BAA2B,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACrD,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAY,EAAE;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,eAAe;IACb,SAAS;IACT,cAAc;CACf,CAAA"}

package/lib/api/copilot-sdk.d.ts

@@ -0,0 +1,48 @@
+export declare const MIN_COPILOT_VERSION = "0.0.400";
+/**
+ * Parse version string to numeric value for comparison.
+ */
+export declare const parseParts: (v: string) => number;
+/**
+ * Find the best (newest) copilot binary from known locations.
+ * Uses file-based caching to avoid slow exec calls on every startup.
+ */
+export declare const findBestCopilotBinary: () => {
+    path: string;
+    version: string;
+} | null;
+/**
+ * Check if Copilot CLI version is compatible with SDK.
+ * Automatically finds the newest copilot binary to bypass PATH cache issues.
+ * Returns true if compatible, false otherwise.
+ */
+export declare const checkCopilotCliVersion: () => boolean;
+export declare const isAvailable: () => Promise<boolean>;
+export declare const stopClient: () => Promise<void>;
+export declare const generateBranchName: (text: string, correction?: string, model?: string) => Promise<string | null>;
+export declare const generateCommitMessage: (diff: string, correction?: string, model?: string) => Promise<string | null>;
+/**
+ * Detailed model info and helpers for formatted choices
+ */
+type ModelDetail = {
+    id: string;
+    name: string;
+    inputTokenLimit: number | null;
+    outputTokenLimit: number | null;
+    needsEnable: boolean;
+    isPremium: boolean;
+    multiplier: number | null;
+    label: string;
+    value: string;
+};
+export declare const getAvailableModelsDetailed: () => Promise<ModelDetail[] | null>;
+export declare const getAvailableModelChoices: (defaultModelId?: string) => Promise<{
+    label: string;
+    value: string;
+}[]>;
+declare const _default: {
+    generateBranchName: (text: string, correction?: string, model?: string) => Promise<string | null>;
+    generateCommitMessage: (diff: string, correction?: string, model?: string) => Promise<string | null>;
+};
+export default _default;
+//# sourceMappingURL=copilot-sdk.d.ts.map

package/lib/api/copilot-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk.d.ts","sourceRoot":"","sources":["../../src/api/copilot-sdk.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAY5C;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,MAItC,CAAA;AA+CD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAoD5E,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,OAuBzC,CAAA;AAwED,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,OAAO,CAEnD,CAAA;AAED,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAe/C,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAiCvB,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAgCvB,CAAA;AAED;;GAEG;AACH,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,0BAA0B,QAAa,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAyG/E,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAU,iBAAiB,MAAM;WA6B/B,MAAM;WAAS,MAAM;IAsB3D,CAAA;;+BAzPO,MAAM,eACC,MAAM,UACX,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;kCAoCjB,MAAM,eACC,MAAM,UACX,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;;AAiNzB,wBAGC"}