@marcopeg/hal 1.0.18 → 1.0.20

package/README.md

@@ -182,6 +182,10 @@ These keys are injected for every message, even without any `context` configurat
 | `sys.time` | Current time, `HH:MM:SS` |
 | `sys.ts` | Current Unix timestamp (seconds) |
 | `sys.tz` | Timezone name (e.g. `Europe/Berlin`) |
+| `engine.name` | Engine identifier (e.g. `claude`, `copilot`) |
+| `engine.command` | CLI command used to invoke the engine |
+| `engine.model` | AI model from config (only present when explicitly set) |
+| `engine.defaultModel` | HAL default model applied (only present when `engine.model` is omitted; see [Model defaults](#model-defaults)) |
 
 #### Custom context via config
 
@@ -267,9 +271,10 @@ Default settings applied to all projects. Any setting defined in a project overr
 |-----|-------------|---------|
 | `globals.engine.name` | Engine: `claude`, `copilot`, `codex`, `opencode` | `"claude"` |
 | `globals.engine.command` | Override the CLI command path | _(engine name)_ |
-| `globals.engine.model` | Override the AI model | _(engine default)_ |
+| `globals.engine.model` | Override the AI model (see [Model defaults](#model-defaults)) | _(per engine)_ |
 | `globals.engine.session` | Use persistent sessions (`--resume` / `--continue`) | `true` |
 | `globals.engine.sessionMsg` | Message sent when renewing session (e.g. `/clean`) | `"hi!"` |
+| `globals.engine.codex.*` | Codex permission flags (see [Engine Configuration](#engine-configuration)) | all `false` |
 | `globals.logging.level` | Log level: `debug`, `info`, `warn`, `error` | `"info"` |
 | `globals.logging.flow` | Write logs to terminal | `true` |
 | `globals.logging.persist` | Write logs to file | `false` |
@@ -294,9 +299,10 @@ Each project entry creates one Telegram bot connected to one directory.
 | `access.allowedUserIds` | No | Override the global user whitelist for this bot |
 | `engine.name` | No | Override the engine for this project |
 | `engine.command` | No | Override the CLI command path |
-| `engine.model` | No | Override the AI model |
+| `engine.model` | No | Override the AI model (see [Model defaults](#model-defaults)) |
 | `engine.session` | No | Use persistent sessions for this project |
 | `engine.sessionMsg` | No | Message used when renewing session |
+| `engine.codex.*` | No | Codex permission flags (see [Engine Configuration](#engine-configuration)) |
 | `transcription.showTranscription` | No | Override transcription display |
 | `dataDir` | No | Override user data directory (see below) |
 | `context` | No | Per-project context overrides (see [Context Injection](#context-injection)) |
@@ -447,16 +453,24 @@ In this example:
 - **frontend** uses GitHub Copilot with the `gpt-5-mini` model
 - **legacy** is inactive and will be skipped at boot
 
-The `engine` object supports five fields:
+The `engine` object supports five fields. Engine-specific sub-objects (e.g. `codex`) can be used to control permissions and behavior per engine.
 
 | Field | Description | Default |
 |-------|-------------|---------|
 | `name` | Engine identifier: `claude`, `copilot`, `codex`, `opencode` | `"claude"` |
 | `command` | Custom path to the CLI binary | _(engine name)_ |
-| `model` | AI model override (omit to use the engine's default) | _(engine default)_ |
+| `model` | AI model override (omit for engine or HAL default; see [Model defaults](#model-defaults)) | _(per engine)_ |
 | `session` | Use persistent sessions (`--resume` / `--continue`) | `true` |
 | `sessionMsg` | Message sent when renewing session (e.g. `/clean`) | `"hi!"` |
 
+When using the Codex engine, the `engine` object also accepts a `codex` block:
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `codex.networkAccess` | Allow outbound network in shell commands | `false` |
+| `codex.fullDiskAccess` | Unrestricted filesystem access (implies network) | `false` |
+| `codex.dangerouslyEnableYolo` | Disable all sandboxing and approvals | `false` |
+
 #### Claude Code
 
 - **CLI:** `claude` — install and authenticate via [Claude Code CLI](https://github.com/anthropics/claude-code) (see [Prerequisites](#prerequisites)).
@@ -475,8 +489,9 @@ The `engine` object supports five fields:
 
 - **CLI:** `codex` — install and authenticate via [Codex CLI](https://github.com/openai/codex-cli) (see [Prerequisites](#prerequisites)).
 - **Project file:** `AGENTS.md`.
-- **Config:** `engine.name: "codex"`. Optional: `engine.command`, `engine.model` (e.g. `gpt-5.1-codex-mini`), `engine.session`, `engine.sessionMsg`.
+- **Config:** `engine.name: "codex"`. Optional: `engine.command`, `engine.model` (e.g. `gpt-5.1-codex-mini`), `engine.session`, `engine.sessionMsg`, and the permission flags under `engine.codex` (see table above).
 - **Sessions:** When `engine.session` is `true`, the CLI is invoked with `codex exec resume --last` to continue the most recent session; otherwise `codex exec` starts a fresh run. `/clean` sends `engine.sessionMsg` without resuming, so the engine starts a new session; the engine's reply is sent to the user (same behaviour as Copilot).
+- **Permission flags:** HAL always passes `--skip-git-repo-check` so Codex runs without the trusted-directory check. You can escalate via `engine.codex`: `networkAccess` (allow outbound HTTP etc.), `fullDiskAccess` (unrestricted filesystem; implies network), or `dangerouslyEnableYolo` (disable all sandboxing and approvals). Higher tiers supersede lower ones. **Warning:** Use `dangerouslyEnableYolo` only in hardened environments (e.g. Docker, VMs). The example config in `examples/hal.config.json` enables all three codex flags for the Obsidian project so you can try full permissions locally.
 
 #### GitHub Copilot Models
 
@@ -502,7 +517,16 @@ When using the `copilot` engine, the following models are available via `engine.
 | `gpt-5-mini` | OpenAI GPT-5 Mini |
 | `gpt-4.1` | OpenAI GPT-4.1 |
 
-If `engine.model` is omitted, the engine uses its own default model.
+#### Model defaults
+
+When `engine.model` is omitted (neither in globals nor project config), behavior depends on the engine:
+
+- **Engine default** — Codex, Copilot, and Cursor: HAL does not pass a model flag, so the CLI picks its own default (Cursor passes `--model auto`).
+- **HAL default** — Claude Code and OpenCode: HAL passes a built-in default so the engine always receives a model. Defaults are defined in `src/default-models.ts`:
+  - Claude Code: `default` (account-recommended model)
+  - OpenCode: `opencode/gpt-5-nano` (free Zen model)
+
+To change HAL defaults, edit `src/default-models.ts`.
 
 ## Directory Structure
 
@@ -618,6 +642,7 @@ The fully-resolved context that would be sent to the AI for this message — ide
 | `bot.*` | `bot.userId`, `bot.username`, `bot.firstName`, `bot.chatId`, `bot.messageId`, `bot.timestamp`, `bot.datetime`, `bot.messageType` |
 | `sys.*` | `sys.date`, `sys.time`, `sys.datetime`, `sys.ts`, `sys.tz` |
 | `project.*` | `project.name`, `project.cwd`, `project.slug` |
+| `engine.*` | `engine.name`, `engine.command`, `engine.model` (if set), `engine.defaultModel` (if HAL default applied) |
 | custom | Any keys defined in `context` config blocks, after `${}` / `#{}` / `@{}` substitution and context hook transforms |
 
 Use `/context` (the built-in global command) to inspect the exact keys available at runtime.

package/dist/bot/commands/git/callback.d.ts

@@ -0,0 +1,8 @@
+import type { Context, NextFunction } from "grammy";
+import type { ProjectContext } from "../../../types.js";
+/**
+ * Callback query handler for `/git_clean` inline keyboard interactions.
+ * Recognizes data prefixed with `gc:` and ignores all other callbacks.
+ */
+export declare function createGitCallbackHandler(ctx: ProjectContext): (gramCtx: Context, next: NextFunction) => Promise<void>;
+//# sourceMappingURL=callback.d.ts.map

package/dist/bot/commands/git/callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,cAAc,IAC5C,SAAS,OAAO,EAAE,MAAM,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CA8EnE"}

package/dist/bot/commands/git/callback.js

@@ -0,0 +1,72 @@
+import { InlineKeyboard } from "grammy";
+import { gitExec } from "./exec.js";
+/**
+ * Callback query handler for `/git_clean` inline keyboard interactions.
+ * Recognizes data prefixed with `gc:` and ignores all other callbacks.
+ */
+export function createGitCallbackHandler(ctx) {
+    return async (gramCtx, next) => {
+        const data = gramCtx.callbackQuery?.data;
+        if (!data?.startsWith("gc:")) {
+            return next();
+        }
+        const { config, logger } = ctx;
+        const cwd = config.cwd;
+        try {
+            if (data.startsWith("gc:select:")) {
+                const file = data.slice("gc:select:".length);
+                const keyboard = new InlineKeyboard()
+                    .text("Confirm", `gc:confirm:${file}`)
+                    .text("Cancel", "gc:cancel");
+                await gramCtx.editMessageText(`Revert \`${file}\` and lose the changes?`, { parse_mode: "Markdown", reply_markup: keyboard });
+                await gramCtx.answerCallbackQuery();
+                return;
+            }
+            if (data === "gc:all") {
+                const keyboard = new InlineKeyboard()
+                    .text("Confirm", "gc:confirm:__all__")
+                    .text("Cancel", "gc:cancel");
+                await gramCtx.editMessageText("Revert *all* uncommitted changes and lose them?", { parse_mode: "Markdown", reply_markup: keyboard });
+                await gramCtx.answerCallbackQuery();
+                return;
+            }
+            if (data.startsWith("gc:confirm:")) {
+                const target = data.slice("gc:confirm:".length);
+                if (target === "__all__") {
+                    await gitExec(cwd, ["restore", "."]);
+                    // Also clean untracked files
+                    await gitExec(cwd, ["clean", "-fd"]).catch(() => { });
+                    await gramCtx.editMessageText("All uncommitted changes reverted.", {
+                        reply_markup: undefined,
+                    });
+                }
+                else {
+                    await gitExec(cwd, ["restore", target]);
+                    await gramCtx.editMessageText(`Restored \`${target}\`.`, {
+                        parse_mode: "Markdown",
+                        reply_markup: undefined,
+                    });
+                }
+                await gramCtx.answerCallbackQuery();
+                return;
+            }
+            if (data === "gc:cancel") {
+                await gramCtx.editMessageText("Cancelled.", {
+                    reply_markup: undefined,
+                });
+                await gramCtx.answerCallbackQuery();
+                return;
+            }
+        }
+        catch (err) {
+            logger.error({ data, error: err instanceof Error ? err.message : String(err) }, "git_clean callback failed");
+            try {
+                await gramCtx.answerCallbackQuery({ text: "Operation failed." });
+            }
+            catch {
+                // ignore
+            }
+        }
+    };
+}
+//# sourceMappingURL=callback.js.map

package/dist/bot/commands/git/callback.js.map

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

package/dist/bot/commands/git/clean.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "grammy";
+import type { ProjectContext } from "../../../types.js";
+export declare function createGitCleanHandler(ctx: ProjectContext): (gramCtx: Context) => Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/bot/commands/git/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/clean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYxD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,IACzC,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAkD/C"}

package/dist/bot/commands/git/clean.js

@@ -0,0 +1,50 @@
+import { InlineKeyboard } from "grammy";
+import { gitExec } from "./exec.js";
+/** Parse `git status --short` into a list of file paths. */
+function parseChangedFiles(statusOutput) {
+    return statusOutput
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => line.slice(3)); // strip status flags + space (e.g. " M src/file.ts")
+}
+export function createGitCleanHandler(ctx) {
+    return async (gramCtx) => {
+        const { config, logger } = ctx;
+        const cwd = config.cwd;
+        const messageText = gramCtx.message?.text ?? "";
+        const fileArg = messageText.replace(/^\/git_clean\s*/, "").trim();
+        try {
+            const { stdout } = await gitExec(cwd, ["status", "--short"]);
+            const files = parseChangedFiles(stdout);
+            if (files.length === 0) {
+                await gramCtx.reply("Working tree is clean.");
+                return;
+            }
+            if (fileArg) {
+                if (!files.includes(fileArg)) {
+                    await gramCtx.reply(`File \`${fileArg}\` has no uncommitted changes.`, { parse_mode: "Markdown" });
+                    return;
+                }
+                await gitExec(cwd, ["restore", fileArg]);
+                await gramCtx.reply(`Restored \`${fileArg}\`.`, {
+                    parse_mode: "Markdown",
+                });
+                return;
+            }
+            const keyboard = new InlineKeyboard();
+            for (const file of files) {
+                keyboard.text(file, `gc:select:${file}`).row();
+            }
+            keyboard.text("Reset all", "gc:all").row();
+            await gramCtx.reply("Select file(s) to revert:", {
+                reply_markup: keyboard,
+            });
+        }
+        catch (err) {
+            logger.error({ error: err instanceof Error ? err.message : String(err) }, "/git_clean failed");
+            await gramCtx.reply(`Failed to check changes: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+}
+//# sourceMappingURL=clean.js.map

package/dist/bot/commands/git/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../../../src/bot/commands/git/clean.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,4DAA4D;AAC5D,SAAS,iBAAiB,CAAC,YAAoB;IAC7C,OAAO,YAAY;SAChB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qDAAqD;AACxF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAmB;IACvD,OAAO,KAAK,EAAE,OAAgB,EAAiB,EAAE;QAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAElE,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAExC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7B,MAAM,OAAO,CAAC,KAAK,CACjB,UAAU,OAAO,gCAAgC,EACjD,EAAE,UAAU,EAAE,UAAU,EAAE,CAC3B,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;gBACzC,MAAM,OAAO,CAAC,KAAK,CAAC,cAAc,OAAO,KAAK,EAAE;oBAC9C,UAAU,EAAE,UAAU;iBACvB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YACjD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;YAE3C,MAAM,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE;gBAC/C,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3D,mBAAmB,CACpB,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,CACjB,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/bot/commands/git/commit.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "grammy";
+import type { ProjectContext } from "../../../types.js";
+export declare function createGitCommitHandler(ctx: ProjectContext): (gramCtx: Context) => Promise<void>;
+//# sourceMappingURL=commit.d.ts.map

package/dist/bot/commands/git/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,IAC1C,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAyF/C"}

package/dist/bot/commands/git/commit.js

@@ -0,0 +1,72 @@
+import { createAgent } from "../../../agent/index.js";
+import { gitExec } from "./exec.js";
+const COMMIT_MSG_PROMPT = `Generate a concise git commit message (one line, max 72 chars) for the following changes. Return ONLY the commit message, no quotes or explanation.
+
+`;
+export function createGitCommitHandler(ctx) {
+    return async (gramCtx) => {
+        const { config, logger } = ctx;
+        const cwd = config.cwd;
+        const messageText = gramCtx.message?.text ?? "";
+        const userMessage = messageText.replace(/^\/git_commit\s*/, "").trim();
+        try {
+            await gitExec(cwd, ["add", "."]);
+            const { stdout: statusOut } = await gitExec(cwd, [
+                "status",
+                "--porcelain",
+            ]);
+            if (!statusOut.trim()) {
+                await gramCtx.reply("Nothing to commit — working tree is clean.");
+                return;
+            }
+            let commitMessage;
+            if (userMessage) {
+                commitMessage = userMessage;
+            }
+            else {
+                const statusMsg = await gramCtx.reply("_Generating commit message..._", { parse_mode: "Markdown" });
+                try {
+                    const { stdout: diffOut } = await gitExec(cwd, [
+                        "diff",
+                        "--cached",
+                        "--stat",
+                    ]);
+                    const agent = createAgent(ctx);
+                    const generated = await agent.call(`${COMMIT_MSG_PROMPT}${diffOut || statusOut}`);
+                    commitMessage = generated.trim().replace(/^["']|["']$/g, "");
+                    try {
+                        await gramCtx.api.deleteMessage(gramCtx.chat.id, statusMsg.message_id);
+                    }
+                    catch {
+                        // ignore delete errors
+                    }
+                }
+                catch (err) {
+                    try {
+                        await gramCtx.api.deleteMessage(gramCtx.chat.id, statusMsg.message_id);
+                    }
+                    catch {
+                        // ignore delete errors
+                    }
+                    logger.error({ error: err instanceof Error ? err.message : String(err) }, "AI commit message generation failed");
+                    await gramCtx.reply("Failed to generate commit message. Please provide one:\n`/git_commit your message here`", { parse_mode: "Markdown" });
+                    return;
+                }
+            }
+            const { stdout: commitOut } = await gitExec(cwd, [
+                "commit",
+                "-m",
+                commitMessage,
+            ]);
+            const summary = commitOut.trim().split("\n")[0] ?? "Committed.";
+            await gramCtx.reply(`\`\`\`\n${summary}\n\`\`\``, {
+                parse_mode: "Markdown",
+            });
+        }
+        catch (err) {
+            logger.error({ error: err instanceof Error ? err.message : String(err) }, "/git_commit failed");
+            await gramCtx.reply(`Commit failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+}
+//# sourceMappingURL=commit.js.map

package/dist/bot/commands/git/commit.js.map

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

package/dist/bot/commands/git/exec.d.ts

@@ -0,0 +1,6 @@
+export declare function gitExec(cwd: string, args: string[]): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function isGitRepo(cwd: string): Promise<boolean>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/bot/commands/git/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/exec.ts"],"names":[],"mappings":"AAKA,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7C;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7D"}

package/dist/bot/commands/git/exec.js

@@ -0,0 +1,16 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function gitExec(cwd, args) {
+    return execFileAsync("git", args, { cwd, timeout: 30_000 });
+}
+export async function isGitRepo(cwd) {
+    try {
+        await gitExec(cwd, ["rev-parse", "--is-inside-work-tree"]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/bot/commands/git/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../../src/bot/commands/git/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,IAAc;IAEd,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/bot/commands/git/index.d.ts

@@ -0,0 +1,6 @@
+export { createGitCallbackHandler } from "./callback.js";
+export { createGitCleanHandler } from "./clean.js";
+export { createGitCommitHandler } from "./commit.js";
+export { createGitInitHandler } from "./init.js";
+export { createGitStatusHandler } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/bot/commands/git/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/bot/commands/git/index.js

@@ -0,0 +1,6 @@
+export { createGitCallbackHandler } from "./callback.js";
+export { createGitCleanHandler } from "./clean.js";
+export { createGitCommitHandler } from "./commit.js";
+export { createGitInitHandler } from "./init.js";
+export { createGitStatusHandler } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/bot/commands/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/bot/commands/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/bot/commands/git/init.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "grammy";
+import type { ProjectContext } from "../../../types.js";
+export declare function createGitInitHandler(ctx: ProjectContext): (gramCtx: Context) => Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/bot/commands/git/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,IACxC,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAyB/C"}

package/dist/bot/commands/git/init.js

@@ -0,0 +1,22 @@
+import { gitExec, isGitRepo } from "./exec.js";
+export function createGitInitHandler(ctx) {
+    return async (gramCtx) => {
+        const { config, logger } = ctx;
+        const cwd = config.cwd;
+        try {
+            if (await isGitRepo(cwd)) {
+                await gramCtx.reply("Already a git repository.");
+                return;
+            }
+            await gitExec(cwd, ["init"]);
+            await gitExec(cwd, ["add", "."]);
+            await gitExec(cwd, ["commit", "-m", "Initial commit"]);
+            await gramCtx.reply("Git repository initialized with initial commit.");
+        }
+        catch (err) {
+            logger.error({ error: err instanceof Error ? err.message : String(err) }, "/git_init failed");
+            await gramCtx.reply(`Failed to initialize git repository: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/bot/commands/git/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/bot/commands/git/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,UAAU,oBAAoB,CAAC,GAAmB;IACtD,OAAO,KAAK,EAAE,OAAgB,EAAiB,EAAE;QAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAEvB,IAAI,CAAC;YACH,IAAI,MAAM,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YAED,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAEvD,MAAM,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3D,kBAAkB,CACnB,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,CACjB,wCAAwC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/bot/commands/git/status.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "grammy";
+import type { ProjectContext } from "../../../types.js";
+export declare function createGitStatusHandler(ctx: ProjectContext): (gramCtx: Context) => Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/bot/commands/git/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/bot/commands/git/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,IAC1C,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAmB/C"}

package/dist/bot/commands/git/status.js

@@ -0,0 +1,18 @@
+import { gitExec } from "./exec.js";
+export function createGitStatusHandler(ctx) {
+    return async (gramCtx) => {
+        const { config, logger } = ctx;
+        try {
+            const { stdout } = await gitExec(config.cwd, ["status"]);
+            const output = stdout.trim() || "Nothing to report.";
+            await gramCtx.reply(`\`\`\`\n${output}\n\`\`\``, {
+                parse_mode: "Markdown",
+            });
+        }
+        catch (err) {
+            logger.error({ error: err instanceof Error ? err.message : String(err) }, "/git_status failed");
+            await gramCtx.reply(`Failed to get git status: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/bot/commands/git/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/bot/commands/git/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,sBAAsB,CAAC,GAAmB;IACxD,OAAO,KAAK,EAAE,OAAgB,EAAiB,EAAE;QAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,oBAAoB,CAAC;YACrD,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,UAAU,EAAE;gBAC/C,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3D,oBAAoB,CACrB,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,CACjB,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/bot/commands/help.js

@@ -4,7 +4,7 @@ const DEFAULT_TEMPLATE = "${HAL_COMMANDS}";
 export function createHelpHandler(ctx) {
     return async (gramCtx) => {
         const helpCfg = ctx.config.commands.help;
-        const template = helpCfg?.message ?? DEFAULT_TEMPLATE;
+        const template = helpCfg.message ?? DEFAULT_TEMPLATE;
         const message = await resolveCommandMessage(template, ctx, gramCtx);
         await gramCtx.reply(message, { parse_mode: "Markdown" });
     };

package/dist/bot/commands/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/bot/commands/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,gGAAgG;AAChG,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAE3C,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,OAAO,KAAK,EAAE,OAAgB,EAAiB,EAAE;QAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEzC,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/bot/commands/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,gGAAgG;AAChG,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAE3C,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,OAAO,KAAK,EAAE,OAAgB,EAAiB,EAAE;QAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEzC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/bot/commands/loader.d.ts

@@ -1,23 +1,30 @@
 import type pino from "pino";
+export type CommandSource = "builtin" | "git" | "project" | "system" | "skill";
 export interface CommandEntry {
     command: string;
     description: string;
     filePath: string;
     skillPrompt?: string;
     public?: boolean;
+    source: CommandSource;
+}
+export interface CommandEnabledFlags {
+    start: boolean;
+    help: boolean;
+    reset: boolean;
+    clean: boolean;
+    git: boolean;
 }
-/**
- * Commands that are always registered with Telegram, regardless of
- * whether custom .mjs files or skills exist.
- */
 export declare const BUILTIN_COMMANDS: CommandEntry[];
+export declare const GIT_COMMANDS: CommandEntry[];
 /**
  * Scan command directories and optionally the skills dir, then return the merged list.
+ * When `enabled` flags are provided, disabled built-in/git commands are excluded.
  *
  * Precedence (lowest → highest):
  *   engine skills  <  global .hal/commands  <  project .hal/commands
  */
-export declare function loadCommands(projectCwd: string, configDir: string, logger: pino.Logger, skillsDir?: string): Promise<CommandEntry[]>;
+export declare function loadCommands(projectCwd: string, configDir: string, logger: pino.Logger, skillsDir?: string, enabled?: CommandEnabledFlags): Promise<CommandEntry[]>;
 /**
  * Resolve a skill entry by command name from the engine's skills directory.
  * Returns null if the skill doesn't exist or its SKILL.md can't be parsed.

package/dist/bot/commands/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/bot/commands/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAmOD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,EAS1C,CAAC;AAIF;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA4B9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAcf"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/bot/commands/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAuOD,eAAO,MAAM,gBAAgB,EAAE,YAAY,EAyB1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,YAAY,EAyBtC,CAAC;AAWF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC,CAuCzB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA6B9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAcf"}