@genoventures-labs/deckhand 0.1.0

package/dist/ui/theme.js

@@ -0,0 +1,22 @@
+import { styleText } from "node:util";
+const colorEnabled = process.env.NO_COLOR === undefined &&
+    process.env.FORCE_COLOR !== "0" &&
+    Boolean(process.stdout.isTTY);
+export function paint(style, text) {
+    if (!colorEnabled)
+        return text;
+    return styleText(style, text);
+}
+export const theme = {
+    brand: (text) => paint(["bold", "cyan"], text),
+    muted: (text) => paint("dim", text),
+    heading: (text) => paint(["bold", "white"], text),
+    ok: (text) => paint("green", text),
+    fail: (text) => paint("red", text),
+    warn: (text) => paint("yellow", text),
+    info: (text) => paint("cyan", text),
+    label: (text) => paint("bold", text),
+    path: (text) => paint("dim", text),
+};
+export const VERSION = "0.1.0";
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;IAClC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG;IAC/B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEhC,MAAM,UAAU,KAAK,CAAC,KAAsC,EAAE,IAAY;IACxE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IACtD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC;IACzD,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IAC1C,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC1C,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC7C,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@genoventures-labs/deckhand",
+  "version": "0.1.0",
+  "description": "Deckhand: Eve CLI that routes Vercel AI Gateway to git and the GitHub CLI.",
+  "keywords": [
+    "cli",
+    "ai-gateway",
+    "eve",
+    "github",
+    "git",
+    "automation"
+  ],
+  "license": "MIT",
+  "author": "Bobby Backlogs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bobbybacklogs/LlamaPull.git"
+  },
+  "type": "module",
+  "bin": {
+    "deckhand": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "agent",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "eve:dev": "eve dev",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ai": "^7.0.93",
+    "commander": "^14.0.0",
+    "eve": "^0.54.3",
+    "yaml": "^2.9.1",
+    "zod": "^4.0.16"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/github-actions/gated-sync.yml

@@ -0,0 +1,35 @@
+# Gated local sync. Required reviewers on environment `deckhand-gate`
+# must approve before commit. Push stays disabled in the matching YAML.
+
+name: Deckhand gated sync
+
+on:
+  schedule:
+    - cron: "0 2 * * 2-6" # 18:00 America/Los_Angeles (PST) weekdays
+  workflow_dispatch:
+
+jobs:
+  inspect:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand status
+
+  execute:
+    needs: inspect
+    environment: deckhand-gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand runs apply gated-sync --approve
+        env:
+          DECKHAND_RUN_APPROVED: "1"
+          AI_GATEWAY_API_KEY: ${{ secrets.AI_GATEWAY_API_KEY }}

package/templates/github-actions/morning-pull.yml

@@ -0,0 +1,42 @@
+# Deckhand gated run: fast-forward pull at 05:00 America/Los_Angeles.
+# GitHub cron is UTC. 13:00 UTC = 05:00 PST (standard time).
+# Adjust to 12:00 UTC during PDT, or run from a self-hosted runner with the YAML timezone.
+#
+# Gate: create a GitHub Environment named `deckhand-gate` and add required reviewers.
+# The inspect job always runs. The execute job waits for that environment.
+
+name: Deckhand morning pull
+
+on:
+  schedule:
+    - cron: "0 13 * * *"
+  workflow_dispatch:
+
+jobs:
+  inspect:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand doctor
+      - run: deckhand status
+
+  execute:
+    needs: inspect
+    if: github.event_name == 'workflow_dispatch' || github.event_name == 'schedule'
+    environment: deckhand-gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand runs apply morning-pull --approve
+        env:
+          DECKHAND_RUN_APPROVED: "1"

package/templates/github-actions/nightly-checks.yml

@@ -0,0 +1,33 @@
+name: Deckhand nightly checks
+
+on:
+  schedule:
+    - cron: "0 7 * * *" # 23:00 America/Los_Angeles (PST)
+  workflow_dispatch:
+
+jobs:
+  inspect:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand checks
+        continue-on-error: true
+
+  execute:
+    needs: inspect
+    environment: deckhand-gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand runs apply nightly-checks --approve
+        env:
+          DECKHAND_RUN_APPROVED: "1"
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/templates/github-actions/weekday-status.yml

@@ -0,0 +1,17 @@
+name: Deckhand weekday status
+
+on:
+  schedule:
+    - cron: "0 16 * * 1-5" # 08:00 America/Los_Angeles (PST)
+  workflow_dispatch:
+
+jobs:
+  inspect:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+      - run: npm install --global @genoventures-labs/deckhand
+      - run: deckhand status

package/templates/runs/gated-sync.yaml

@@ -0,0 +1,19 @@
+# yaml-language-server: $schema=../schema/gated-run.v1.json
+apiVersion: deckhand/v1
+kind: GatedRun
+metadata:
+  name: gated-sync
+  description: Stage and commit local diffs at 6pm. Push stays off until the gate and sync.push are both enabled.
+spec:
+  schedule:
+    cron: "0 18 * * 1-5"
+    timezone: America/Los_Angeles
+  action: sync
+  workspace: .
+  gate:
+    enabled: true
+    environment: deckhand-gate
+    requireCleanTree: false
+    requireChecks: false
+  sync:
+    push: false

package/templates/runs/morning-pull.yaml

@@ -0,0 +1,17 @@
+# yaml-language-server: $schema=../schema/gated-run.v1.json
+apiVersion: deckhand/v1
+kind: GatedRun
+metadata:
+  name: morning-pull
+  description: Fast-forward pull at 5am local time (Pacific).
+spec:
+  schedule:
+    cron: "0 5 * * *"
+    timezone: America/Los_Angeles
+  action: pull
+  workspace: .
+  gate:
+    enabled: true
+    environment: deckhand-gate
+    requireCleanTree: true
+    requireChecks: false

package/templates/runs/nightly-checks.yaml

@@ -0,0 +1,17 @@
+# yaml-language-server: $schema=../schema/gated-run.v1.json
+apiVersion: deckhand/v1
+kind: GatedRun
+metadata:
+  name: nightly-checks
+  description: Surface PR / Actions status at 11pm. Gated so noisy check failures wait for a reviewer.
+spec:
+  schedule:
+    cron: "0 23 * * *"
+    timezone: America/Los_Angeles
+  action: checks
+  workspace: .
+  gate:
+    enabled: true
+    environment: deckhand-gate
+    requireCleanTree: true
+    requireChecks: false

package/templates/runs/weekday-status.yaml

@@ -0,0 +1,17 @@
+# yaml-language-server: $schema=../schema/gated-run.v1.json
+apiVersion: deckhand/v1
+kind: GatedRun
+metadata:
+  name: weekday-status
+  description: Print git status every weekday morning. Ungated — inspect only.
+spec:
+  schedule:
+    cron: "0 8 * * 1-5"
+    timezone: America/Los_Angeles
+  action: status
+  workspace: .
+  gate:
+    enabled: false
+    environment: deckhand-gate
+    requireCleanTree: false
+    requireChecks: false

package/templates/schema/gated-run.v1.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/bobbybacklogs/LlamaPull/templates/schema/gated-run.v1.json",
+  "title": "Deckhand GatedRun",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": { "const": "deckhand/v1" },
+    "kind": { "const": "GatedRun" },
+    "metadata": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string" }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "required": ["schedule", "action"],
+      "additionalProperties": false,
+      "properties": {
+        "schedule": {
+          "type": "object",
+          "required": ["cron"],
+          "additionalProperties": false,
+          "properties": {
+            "cron": {
+              "type": "string",
+              "description": "5-field cron. GitHub Actions schedules are UTC; timezone is for local/self-hosted runners and documentation."
+            },
+            "timezone": { "type": "string", "default": "UTC" }
+          }
+        },
+        "action": {
+          "type": "string",
+          "enum": ["status", "pull", "sync", "checks", "actions-list"]
+        },
+        "workspace": { "type": "string", "default": "." },
+        "gate": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "environment": {
+              "type": "string",
+              "default": "deckhand-gate",
+              "description": "GitHub Environment name. Add required reviewers on that environment to hold the execute job."
+            },
+            "requireCleanTree": { "type": "boolean", "default": true },
+            "requireChecks": { "type": "boolean", "default": false }
+          }
+        },
+        "sync": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "push": { "type": "boolean", "default": false },
+            "message": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}