ag-toolkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Riya Amemiya
+
+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.ja.md

@@ -0,0 +1,33 @@
+# aglib
+
+`aglib` は `agbd` と `agrb` CLIツール間で共有される機能を提供するライブラリです。
+
+## 含まれる機能
+
+- **UIコンポーネント:** Inkを使用した対話的なUIコンポーネント。
+- **Git操作:** `simple-git`をラップしたGitコマンド操作ユーティリティ。
+- **設定管理:** 設定ファイルの読み込みや書き込み、管理機能。
+- **その他ユーティリティ:** 引数パーサーやバリデーション関数など。
+
+## 開発
+
+このライブラリは`agbd`および`agrb`プロジェクトから利用されることを想定しています。
+
+```bash
+# 依存関係のインストール
+bun install
+
+# ビルド
+bun run build
+
+# 開発（watch）
+bun run dev
+
+# Lint（チェック／自動修正）
+bun run test
+bun run lint
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,33 @@
+# aglib
+
+`aglib` is a library that provides shared functionality for the `agbd` and `agrb` CLI tools.
+
+## Features Included
+
+- **UI Components:** Interactive UI components using Ink.
+- **Git Operations:** Git command utilities wrapping `simple-git`.
+- **Configuration Management:** Functions for reading, writing, and managing configuration files.
+- **Other Utilities:** Argument parsers, validation functions, etc.
+
+## Development
+
+This library is intended to be used by the `agbd` and `agrb` projects.
+
+```bash
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Development (watch)
+bun run dev
+
+# Lint (check/fix)
+bun run test
+bun run lint
+```
+
+## License
+
+MIT

package/dist/components/ConfigEditor.d.ts

@@ -0,0 +1,14 @@
+export type ConfigItem<T> = {
+    key: keyof T;
+    type: "string" | "number" | "boolean" | "array" | "select";
+    options?: string[];
+};
+type ConfigEditorProps<T extends Record<string, unknown>> = {
+    toolName: string;
+    configItems: ConfigItem<T>[];
+    defaultConfig: T;
+    loadConfig: () => Promise<T>;
+    writeConfig: (config: T) => Promise<void>;
+};
+export declare const ConfigEditor: <T extends Record<string, unknown>>({ toolName, configItems, defaultConfig, loadConfig, writeConfig, }: ConfigEditorProps<T>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/ConfigEditor.js

@@ -0,0 +1,196 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput } from "ink";
+import SelectInput from "ink-select-input";
+import Spinner from "ink-spinner";
+import { useEffect, useMemo, useState } from "react";
+import { formatConfigValue } from "../lib/format.js";
+import { isDeepEqual } from "../lib/isDeepEqual.js";
+import { BooleanItem, Item } from "./ConfigEditorItem.js";
+export const ConfigEditor = ({ toolName, configItems, defaultConfig, loadConfig, writeConfig, }) => {
+    const { exit } = useApp();
+    const [config, setConfig] = useState(null);
+    const [initialConfig, setInitialConfig] = useState(null);
+    const [status, setStatus] = useState("loading");
+    const [editingItem, setEditingItem] = useState(null);
+    const [inputBuffer, setInputBuffer] = useState("");
+    const [inputError, setInputError] = useState(null);
+    const isDirty = useMemo(() => config && initialConfig ? !isDeepEqual(config, initialConfig) : false, [config, initialConfig]);
+    useEffect(() => {
+        (async () => {
+            const loadedConfig = await loadConfig();
+            const fullConfig = { ...defaultConfig, ...loadedConfig };
+            setConfig(fullConfig);
+            setInitialConfig(JSON.parse(JSON.stringify(fullConfig)));
+            setStatus("selecting");
+        })();
+    }, [loadConfig, defaultConfig]);
+    const handleSave = async () => {
+        if (config) {
+            setStatus("saving");
+            await writeConfig(config);
+            setStatus("done");
+            exit();
+        }
+    };
+    useInput((input) => {
+        if (status !== "selecting") {
+            return;
+        }
+        if (input.toLowerCase() === "q") {
+            if (isDirty) {
+                setStatus("confirm_quit");
+            }
+            else {
+                exit();
+            }
+            return;
+        }
+        if (input.toLowerCase() === "s") {
+            handleSave();
+        }
+    }, { isActive: status === "selecting" });
+    const items = config
+        ? configItems.map((item) => ({
+            label: `${String(item.key)}: ${formatConfigValue(config[item.key])}`,
+            value: item.key,
+        }))
+        : [];
+    const handleSelect = (selected) => {
+        const item = configItems.find((i) => i.key === selected.value);
+        if (!config || !item) {
+            return;
+        }
+        setEditingItem(item);
+        setStatus("editing");
+        const value = config[item.key];
+        switch (item.type) {
+            case "string":
+            case "number":
+                setInputBuffer(value !== undefined ? String(value) : "");
+                break;
+            case "array":
+                setInputBuffer(Array.isArray(value) && value.length > 0 ? value.join(", ") : "");
+                break;
+        }
+        setInputError(null);
+    };
+    const cancelEditing = () => {
+        setEditingItem(null);
+        setInputBuffer("");
+        setInputError(null);
+        setStatus("selecting");
+    };
+    const commitEditing = () => {
+        if (!config || !editingItem)
+            return;
+        const { key, type } = editingItem;
+        let nextValue;
+        switch (type) {
+            case "string": {
+                const trimmed = inputBuffer.trim();
+                nextValue = trimmed.length > 0 ? trimmed : undefined;
+                break;
+            }
+            case "number": {
+                const valueText = inputBuffer.trim();
+                if (valueText.length === 0) {
+                    nextValue = undefined;
+                }
+                else {
+                    const parsed = Number.parseInt(valueText, 10);
+                    if (Number.isNaN(parsed) || parsed < 0) {
+                        setInputError("Please enter an integer >= 0");
+                        return;
+                    }
+                    nextValue = parsed;
+                }
+                break;
+            }
+            case "array":
+                nextValue = inputBuffer
+                    .split(",")
+                    .map((part) => part.trim())
+                    .filter((part) => part.length > 0);
+                break;
+            default:
+                cancelEditing();
+                return;
+        }
+        setConfig({ ...config, [key]: nextValue });
+        cancelEditing();
+    };
+    useInput((input, key) => {
+        if (status !== "editing" || !editingItem)
+            return;
+        if (key.escape) {
+            cancelEditing();
+            return;
+        }
+        if (editingItem.type === "string" ||
+            editingItem.type === "number" ||
+            editingItem.type === "array") {
+            if (key.return) {
+                commitEditing();
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setInputBuffer((prev) => prev.slice(0, -1));
+                return;
+            }
+            if (input && !key.ctrl && !key.meta) {
+                setInputBuffer((prev) => prev + input);
+            }
+        }
+    }, { isActive: status === "editing" });
+    const handleBooleanChange = (item) => {
+        if (config && editingItem) {
+            setConfig({ ...config, [editingItem.key]: item.value });
+            cancelEditing();
+        }
+    };
+    const handleSelectChange = (item) => {
+        if (config && editingItem) {
+            setConfig({ ...config, [editingItem.key]: item.value });
+            cancelEditing();
+        }
+    };
+    const handleQuitConfirm = (item) => {
+        if (item.value === "yes") {
+            exit();
+        }
+        else {
+            setStatus("selecting");
+        }
+    };
+    const renderEditor = () => {
+        if (!editingItem)
+            return null;
+        switch (editingItem.type) {
+            case "boolean":
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Set value for \"", String(editingItem.key), "\":"] }), _jsx(SelectInput, { items: [
+                                { label: "true", value: true },
+                                { label: "false", value: false },
+                            ], onSelect: handleBooleanChange, itemComponent: BooleanItem })] }));
+            case "select":
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Set value for \"", String(editingItem.key), "\":"] }), _jsx(SelectInput, { items: editingItem.options?.map((opt) => ({
+                                label: opt,
+                                value: opt,
+                            })), onSelect: handleSelectChange, itemComponent: Item })] }));
+            case "string":
+            case "number":
+            case "array": {
+                let prompt = "Enter a string";
+                if (editingItem.type === "number")
+                    prompt = "Enter a number (>= 0)";
+                if (editingItem.type === "array")
+                    prompt = "Enter comma-separated values";
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [prompt, " (leave empty to unset):"] }), _jsx(Text, { color: "cyan", children: inputBuffer || "<empty>" }), _jsx(Text, { color: "gray", children: "Enter: save / Esc: cancel" }), inputError && _jsx(Text, { color: "red", children: inputError })] }));
+            }
+        }
+        return null;
+    };
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Text, { bold: true, children: [toolName, " Configuration Editor"] }), status === "loading" && (_jsxs(Text, { children: [_jsx(Spinner, {}), " Loading configuration..."] })), status === "selecting" && config && (_jsxs(_Fragment, { children: [_jsx(Box, { marginTop: 1, children: _jsx(SelectInput, { items: items, onSelect: handleSelect, itemComponent: Item }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["Select an item to edit. 'S' to save, 'Q' to exit.", isDirty && _jsx(Text, { color: "yellow", children: " (unsaved)" })] }) })] })), status === "editing" && renderEditor(), status === "confirm_quit" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "yellow", children: "Unsaved changes detected. Exit?" }), _jsx(SelectInput, { items: [
+                            { label: "No", value: "no" },
+                            { label: "Yes", value: "yes" },
+                        ], onSelect: handleQuitConfirm })] })), status === "saving" && _jsx(Text, { children: "\uD83D\uDCBE Saving configuration..." })] }));
+};

package/dist/components/ConfigEditorItem.d.ts

@@ -0,0 +1,3 @@
+import type { ItemProps } from "ink-select-input";
+export declare const Item: ({ label, isSelected }: ItemProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BooleanItem: ({ label, isSelected }: ItemProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/ConfigEditorItem.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from "ink";
+export const Item = ({ label, isSelected }) => (_jsx(Text, { color: isSelected ? "cyan" : undefined, children: label }));
+export const BooleanItem = ({ label, isSelected }) => (_jsx(Text, { color: isSelected ? "cyan" : undefined, children: label === "true" ? (_jsx(Text, { color: "green", children: "true" })) : (_jsx(Text, { color: "red", children: "false" })) }));

package/dist/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ConfigEditor.js";
+export * from "./ConfigEditorItem.js";

package/dist/components/index.js

@@ -0,0 +1,2 @@
+export * from "./ConfigEditor.js";
+export * from "./ConfigEditorItem.js";

package/dist/git.d.ts

@@ -0,0 +1,61 @@
+export type BranchType = "local" | "remote";
+export interface BranchInfo {
+    ref: string;
+    name: string;
+    type: BranchType;
+    remote?: string;
+    lastCommitDate: Date | null;
+    lastCommitSha: string | null;
+    lastCommitSubject: string | null;
+    isMerged: boolean;
+    ahead: number;
+    behind: number;
+}
+export declare class GitOperations {
+    private git;
+    constructor(workingDir?: string);
+    getCurrentBranch(): Promise<string>;
+    isWorkdirClean(): Promise<boolean>;
+    fetchAll(): Promise<void>;
+    getBranchInfos(options?: {
+        includeRemote?: boolean;
+    }): Promise<BranchInfo[]>;
+    deleteLocalBranch(branch: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    deleteRemoteBranch(branch: {
+        remote: string;
+        name: string;
+    }): Promise<void>;
+    detectDefaultBranch(remote?: string): Promise<string | null>;
+    private getBaseBranch;
+    private getAheadBehind;
+    private getMergedSet;
+    private listBranches;
+    private parseBranchLine;
+    getAllBranches(): Promise<string[]>;
+    getLocalBranches(): Promise<string[]>;
+    branchExists(branch: string): Promise<boolean>;
+    private resolveBranchRef;
+    setupCherryPick(targetBranch: string): Promise<string>;
+    getMergeBase(branch1: string, branch2: string): Promise<string>;
+    getCommitsToCherryPick(from: string, to: string): Promise<string[]>;
+    cherryPick(commitSha: string, options?: {
+        allowEmpty?: boolean;
+    }): Promise<void>;
+    continueCherryPick(): Promise<void>;
+    skipCherryPick(): Promise<void>;
+    abortCherryPick(): Promise<void>;
+    resolveConflictWithStrategy(strategy: "ours" | "theirs"): Promise<void>;
+    finishCherryPick(currentBranch: string, tempBranchName: string, options?: {
+        createBackup?: boolean;
+    }): Promise<void>;
+    cleanupCherryPick(tempBranchName: string, originalBranch: string): Promise<void>;
+    performLinearRebase(currentBranch: string, targetBranch: string, progressCallback?: (message: string) => void, options?: {
+        continueOnConflict?: boolean;
+    }): Promise<void>;
+    getCommitSubject(sha: string): Promise<string>;
+    startAutostash(): Promise<string | null>;
+    popStash(stashRef: string): Promise<void>;
+    pushWithLease(branch: string): Promise<void>;
+}