Git as an Exec LM Tool {WIP}

docs/agents.md

@@ -22,7 +22,7 @@ Try out any of our ready-to-use _**FREE**_ agents:
 
 * [Git Commit Message Agent](https://github.com/enola-dev/git-commit-message-agent)
 
-Or [Contact Us](support.md) to have us build an 🥷 Agent for YOU?
+Or [Contact Us](support.md) to have a custom 🥷 Agent built for YOU?
 
 Or _[make your own](tutorial/agents.md)!_
 

docs/use/index.md

@@ -68,7 +68,7 @@ PS: The [`enolac`](../download/latest/enolac) script contains the line above.
 
 ## JBang
 
-After [installing JBang](https://www.jbang.dev/download/), please [do](https://github.com/enola-dev/enola/issues/1641):
+After [installing JBang](https://www.jbang.dev/download/), please run the [following](https://github.com/enola-dev/enola/issues/1641) commands:
 
     jbang catalog add --name enola-dev https://raw.githubusercontent.com/enola-dev/jbang-catalog/main/jbang-catalog.json
     jbang --fresh app install enola@enola-dev

models/enola.dev/ai/agent.schema.yaml

@@ -69,7 +69,7 @@ properties:
   tools:
     type: array
     description: The tools to which the agent has access; see https://docs.enola.dev/concepts/tool.
-# TODO tools
+# TODO prompt
 # TODO planning
 # TODO examples
 # TODO tests

models/enola.dev/ai/exec.schema.yaml

@@ -0,0 +1,36 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright 2025 The Enola <https://enola.dev> Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$id: https://enola.dev/exec
+# TODO Make this file actually served at its $id URL!
+$schema: https://json-schema.org/draft/2020-12/schema
+title: Enola.dev Process Execution
+# TODO description: See https://docs.enola.dev/concepts/exec/.
+# TODO x-intellij-html-description: See <a href="https://docs.enola.dev/concepts/agent/">docs.enola.dev</a>.
+examples:
+  - ../../git-scm.com/git.exec.yaml
+
+type: object
+properties:
+# NB: Descriptions are copy/pasted in //docs/concepts/exec.md; please keep them (manually, for now) in sync!
+
+# TODO Add schema for (e.g.) ../../git-scm.com/git.exec.yaml here!
+
+# TODO Write Enola Java code to validate all models/**.[json|yaml] incl. this one.
+
+# TODO Eventually contribute this to https://www.schemastore.org
+
+# TODO Write an exec.proto transliteration of this and allow text proto files

models/git-scm.com/git-TODO.schema.yaml

@@ -0,0 +1,231 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright 2025 The Enola <https://enola.dev> Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+tools:
+  - name: git_status
+    description: Shows the working tree status
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+      required:
+        - repo_path
+      title: GitStatus
+  - name: git_diff_unstaged
+    description: Shows changes in the working directory that are not yet staged
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        context_lines:
+          default: 3
+          title: Context Lines
+          type: integer
+      required:
+        - repo_path
+      title: GitDiffUnstaged
+  - name: git_diff_staged
+    description: Shows changes that are staged for commit
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        context_lines:
+          default: 3
+          title: Context Lines
+          type: integer
+      required:
+        - repo_path
+      title: GitDiffStaged
+  - name: git_diff
+    description: Shows differences between branches or commits
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        target:
+          title: Target
+          type: string
+        context_lines:
+          default: 3
+          title: Context Lines
+          type: integer
+      required:
+        - repo_path
+        - target
+      title: GitDiff
+  - name: git_commit
+    description: Records changes to the repository
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        message:
+          title: Message
+          type: string
+      required:
+        - repo_path
+        - message
+      title: GitCommit
+  - name: git_add
+    description: Adds file contents to the staging area
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        files:
+          items:
+            type: string
+          title: Files
+          type: array
+      required:
+        - repo_path
+        - files
+      title: GitAdd
+  - name: git_reset
+    description: Unstages all staged changes
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+      required:
+        - repo_path
+      title: GitReset
+  - name: git_log
+    description: Shows the commit logs
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        max_count:
+          default: 10
+          title: Max Count
+          type: integer
+      required:
+        - repo_path
+      title: GitLog
+  - name: git_create_branch
+    description: Creates a new branch from an optional base branch
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        branch_name:
+          title: Branch Name
+          type: string
+        base_branch:
+          anyOf:
+            - type: string
+            - type: 'null'
+          default:
+          title: Base Branch
+      required:
+        - repo_path
+        - branch_name
+      title: GitCreateBranch
+  - name: git_checkout
+    description: Switches branches
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        branch_name:
+          title: Branch Name
+          type: string
+      required:
+        - repo_path
+        - branch_name
+      title: GitCheckout
+  - name: git_show
+    description: Shows the contents of a commit
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+        revision:
+          title: Revision
+          type: string
+      required:
+        - repo_path
+        - revision
+      title: GitShow
+  - name: git_init
+    description: Initialize a new Git repository
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          title: Repo Path
+          type: string
+      required:
+        - repo_path
+      title: GitInit
+  - name: git_branch
+    description: List Git branches
+    inputSchema:
+      type: object
+      properties:
+        repo_path:
+          description: The path to the Git repository.
+          title: Repo Path
+          type: string
+        branch_type:
+          description: Whether to list local branches ('local'), remote branches ('remote')
+            or all branches('all').
+          title: Branch Type
+          type: string
+        contains:
+          anyOf:
+            - type: string
+            - type: 'null'
+          default:
+          description: The commit sha that branch should contain. Do not pass anything
+            to this param if no commit sha is specified
+          title: Contains
+        not_contains:
+          anyOf:
+            - type: string
+            - type: 'null'
+          default:
+          description: The commit sha that branch should NOT contain. Do not pass anything
+            to this param if no commit sha is specified
+          title: Not Contains
+      required:
+        - repo_path
+        - branch_type
+      title: GitBranch

models/git-scm.com/git.exec.yaml

@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright 2025 The Enola <https://enola.dev> Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$schema: https://enola.dev/exec
+$id: https://enola.dev/exec/git
+
+# Originally inspired by
+# https://github.com/modelcontextprotocol/servers/blob/338d8af7a6d117b848d42e07b9ac480e16b80343/src/git/src/mcp_server_git/server.py#L21
+
+actions:
+  status:
+    description: Shows the working tree status
+    inSchemaRef: git.schema.yaml#/$defs/status
+    command: git
+    args: [status, -C, "{{in.repo_path}}"]
+    out: "Repository Status: {{OUT}} {{ERR}}"
+
+  commit:
+    description: Records changes to the repository
+    inSchemaRef: git.schema.yaml#/$defs/commit
+    command: git
+    args: [commit, -C, "{{in.repo_path}}", -m, "{{in.message}}"]
+    out: "{{OUT}} {{ERR}}"
+
+# TODO Add everything missing from
+#   https://github.com/modelcontextprotocol/servers/blob/338d8af7a6d117b848d42e07b9ac480e16b80343/src/git/src/mcp_server_git/server.py#L221
+
+sets:
+  all-read:
+    - status
+  all-read-and-commit:
+    - all-read
+    - commit
+  all-write:
+    - commit
+  all:
+    - all-read
+    - all-write