@ksuchoi216/ahe 0.1.6 → 0.1.10

package/packages/ahe-antigravity/bin/ahe-antigravity

@@ -0,0 +1,325 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [ -L "${SCRIPT_PATH}" ]; do
+  SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "${SCRIPT_PATH}")" && pwd)"
+  SCRIPT_PATH="$(readlink "${SCRIPT_PATH}")"
+  case "${SCRIPT_PATH}" in
+    /*) ;;
+    *) SCRIPT_PATH="${SCRIPT_DIR}/${SCRIPT_PATH}" ;;
+  esac
+done
+
+readonly SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "${SCRIPT_PATH}")" && pwd)"
+readonly PACKAGE_ROOT="$(CDPATH= cd -- "${SCRIPT_DIR}/.." && pwd)"
+readonly SOURCE_SKILLS_DIR="${PACKAGE_ROOT}/skills"
+readonly AGY_MODEL="Gemini 3.1 Pro (High)"
+readonly MANAGED_SKILLS=("ahe-ship" "ahe-git")
+
+build_execution_prompt() {
+  local plan_markdown="$1"
+
+  printf '%s\n' "Reconcile this saved AHE plan against the current repository state."
+  printf '%s\n' "Overwrite the original .plans/ file with the refreshed plan, then execute the refreshed plan exactly."
+  printf '\n'
+  printf '%s\n' "# Saved Plan"
+  printf '%s' "${plan_markdown}"
+
+  case "${plan_markdown}" in
+    *$'\n')
+      ;;
+    *)
+      printf '\n'
+      ;;
+  esac
+  printf '\n'
+
+  printf '%s\n' "When every requirement is fully complete and verified, print the exact line AHE_PLAN_COMPLETE."
+}
+
+usage() {
+  cat <<'EOF'
+Usage:
+  ahe-antigravity install [--force]
+  ahe-antigravity uninstall
+  ahe-antigravity doctor
+  ahe-antigravity ahe-ship <plan-path>
+  ahe-antigravity ahe-git [repo-root]
+EOF
+}
+
+resolve_plan_path() {
+  local plan_path="$1"
+
+  if [ -z "${plan_path}" ]; then
+    printf 'Usage: ahe-antigravity ahe-ship <plan-path>\n' >&2
+    exit 1
+  fi
+
+  if [ "${plan_path#/}" = "${plan_path}" ]; then
+    plan_path="${PWD}/${plan_path}"
+  fi
+
+  if [ ! -f "${plan_path}" ]; then
+    printf 'Plan file does not exist: %s\n' "${plan_path}" >&2
+    exit 1
+  fi
+
+  printf '%s\n' "${plan_path}"
+}
+
+read_plan_markdown() {
+  local plan_path="$1"
+  cat "${plan_path}"
+}
+
+
+ahe_ship_plan() {
+  local plan_path
+  plan_path="$(resolve_plan_path "${1:-}")"
+
+  if ! command -v agy >/dev/null 2>&1; then
+    printf 'Missing required executable: agy\n' >&2
+    exit 1
+  fi
+
+  local execution_prompt
+  execution_prompt="$(build_execution_prompt "$(read_plan_markdown "${plan_path}")")"
+
+  local stdout_path
+  local stderr_path
+  stdout_path="$(mktemp)"
+  stderr_path="$(mktemp)"
+
+  local status=0
+  if printf '%s\n' "${execution_prompt}" | agy --model "${AGY_MODEL}" >"${stdout_path}" 2>"${stderr_path}"; then
+    status=0
+  else
+    status=$?
+  fi
+
+  cat "${stdout_path}"
+  cat "${stderr_path}" >&2
+
+  local combined_output
+  combined_output="$(cat "${stdout_path}")"$'\n'"$(cat "${stderr_path}")"
+  rm -f "${stdout_path}" "${stderr_path}"
+
+  if [ "${status}" -ne 0 ]; then
+    printf 'agy execution failed for %s\n' "${plan_path}" >&2
+    exit "${status}"
+  fi
+
+  case "${combined_output}" in
+    *AHE_PLAN_COMPLETE*)
+      rm -f "${plan_path}"
+      ;;
+    *)
+      printf 'agy completed without required marker AHE_PLAN_COMPLETE for %s\n' "${plan_path}" >&2
+      exit 1
+      ;;
+  esac
+}
+
+build_git_execution_prompt() {
+  local repo_root="$1"
+
+  printf '%s\n' "Run the ahe-git skill workflow on the repository at: ${repo_root}"
+  printf '%s\n' "You must follow the AHE Git skill instructions exactly."
+  printf '\n'
+  printf '%s\n' "When the full workflow is finished successfully with no skipped work, print the exact line AHE_GIT_COMPLETE."
+}
+
+ahe_git() {
+  local repo_root="${1:-$PWD}"
+
+  if [ ! -d "${repo_root}" ]; then
+    printf 'Target path is not a directory: %s\n' "${repo_root}" >&2
+    exit 1
+  fi
+
+  repo_root="$(CDPATH= cd -- "${repo_root}" && pwd)"
+
+  if ! command -v agy >/dev/null 2>&1; then
+    printf 'Missing required executable: agy\n' >&2
+    exit 1
+  fi
+
+  local execution_prompt
+  execution_prompt="$(build_git_execution_prompt "${repo_root}")"
+
+  local stdout_path
+  local stderr_path
+  stdout_path="$(mktemp)"
+  stderr_path="$(mktemp)"
+
+  local status=0
+  if printf '%s\n' "${execution_prompt}" | agy --model "${AGY_MODEL}" >"${stdout_path}" 2>"${stderr_path}"; then
+    status=0
+  else
+    status=$?
+  fi
+
+  cat "${stdout_path}"
+  cat "${stderr_path}" >&2
+
+  local combined_output
+  combined_output="$(cat "${stdout_path}")"$'\n'"$(cat "${stderr_path}")"
+  rm -f "${stdout_path}" "${stderr_path}"
+
+  if [ "${status}" -ne 0 ]; then
+    printf 'agy execution failed for ahe-git in %s\n' "${repo_root}" >&2
+    exit "${status}"
+  fi
+
+  case "${combined_output}" in
+    *AHE_GIT_COMPLETE*)
+      ;;
+    *)
+      printf 'agy completed without required marker AHE_GIT_COMPLETE for ahe-git in %s\n' "${repo_root}" >&2
+      exit 1
+      ;;
+  esac
+}
+
+install_skill() {
+  local force="false"
+
+  while [ "$#" -gt 0 ]; do
+    case "$1" in
+      --force)
+        force="true"
+        ;;
+      --backup)
+        # Ignored for Antigravity, but accepted for compatibility with root script
+        ;;
+      *)
+        printf 'Unknown install option: %s\n' "$1" >&2
+        usage >&2
+        exit 1
+        ;;
+    esac
+    shift
+  done
+
+  if [ ! -d "${SOURCE_SKILLS_DIR}" ]; then
+    printf 'Packaged skill files are missing: %s\n' "${SOURCE_SKILLS_DIR}" >&2
+    exit 1
+  fi
+
+  # Determine target directory
+  local target_skills_dir="${HOME}/.gemini/config/skills"
+  local skill_name=""
+  local skill_target=""
+  
+  for skill_name in "${MANAGED_SKILLS[@]}"; do
+    skill_target="${target_skills_dir}/${skill_name}"
+
+    if [ -e "${skill_target}" ]; then
+      if [ "${force}" != "true" ]; then
+        cat <<EOF >&2
+AHE Antigravity skill ${skill_name} is already installed at:
+  ${skill_target}
+
+Re-run with --force to overwrite.
+EOF
+        exit 1
+      else
+        rm -rf "${skill_target}"
+      fi
+    fi
+  done
+
+  mkdir -p "${target_skills_dir}"
+  for skill_name in "${MANAGED_SKILLS[@]}"; do
+    cp -R "${SOURCE_SKILLS_DIR}/${skill_name}" "${target_skills_dir}/${skill_name}"
+  done
+
+  cat <<EOF
+AHE Antigravity skills installed at:
+  ${target_skills_dir}
+EOF
+}
+
+doctor() {
+  printf '=== antigravity ===\n'
+
+  local target_skills_dir="${HOME}/.gemini/config/skills"
+  local skill_name=""
+  local skill_md=""
+  local errors=0
+
+  for skill_name in "${MANAGED_SKILLS[@]}"; do
+    skill_md="${target_skills_dir}/${skill_name}/SKILL.md"
+    if [ ! -f "${skill_md}" ]; then
+      printf 'Missing: %s\n' "${skill_md}" >&2
+      errors=$((errors + 1))
+    fi
+  done
+
+  if ! command -v agy >/dev/null 2>&1; then
+    printf 'Missing required executable: agy\n' >&2
+    errors=$((errors + 1))
+  fi
+
+  if [ "${errors}" -gt 0 ]; then
+    printf 'AHE Antigravity skill installation is unhealthy (%d errors).\n' "${errors}" >&2
+    exit 1
+  fi
+  printf 'AHE Antigravity skill installation looks healthy.\n\n'
+}
+
+uninstall_skill() {
+  local target_skills_dir="${HOME}/.gemini/config/skills"
+  local skill_name=""
+  local skill_target=""
+
+  echo "Uninstalling AHE Antigravity skills from ${target_skills_dir}..."
+  
+  for skill_name in "${MANAGED_SKILLS[@]}"; do
+    skill_target="${target_skills_dir}/${skill_name}"
+    rm -rf "${skill_target}"
+  done
+
+  echo "AHE Antigravity skills uninstalled successfully."
+}
+
+main() {
+  if [ "$#" -eq 0 ]; then
+    usage
+    exit 1
+  fi
+
+  local command="$1"
+  shift
+
+  case "${command}" in
+    install)
+      install_skill "$@"
+      ;;
+    uninstall)
+      uninstall_skill
+      ;;
+    doctor)
+      doctor
+      ;;
+    ahe-ship)
+      ahe_ship_plan "$@"
+      ;;
+    ahe-git)
+      ahe_git "$@"
+      ;;
+    -h|--help|help)
+      usage
+      exit 0
+      ;;
+    *)
+      printf 'Unknown command: %s\n' "${command}" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

package/packages/ahe-antigravity/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@ahe/antigravity",
+  "version": "0.1.8",
+  "description": "Awesome Harness Engineering Antigravity skill package",
+  "author": "ksuchoi216",
+  "license": "MIT"
+}

package/packages/ahe-antigravity/skills/ahe-git/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: ahe-git
+description: Use in Antigravity to execute an ahe-git run via the `ahe-antigravity ahe-git` command.
+---
+
+# AHE Git (Antigravity)
+
+`ahe-git` is a user-facing AHE command independent from the normal AHE agent network.
+
+Use this skill only to orchestrate safe Git pulls and commits across the active repository and its nested Git repositories or submodules.
+
+## Workflow
+
+1. **Discover**: Scan for both `.git` directories and `.git` files to find all nested repositories, worktrees, and submodules. Normalize and deduplicate the repo roots. Process them deepest-first (so submodules commit before parent gitlink updates).
+2. **Safe Pull**: For each repo, run `git fetch` and inspect the current branch and upstream state:
+   - If the repo is clean and upstream is ahead, fast-forward with `git pull --ff-only`.
+   - If the repo is already at upstream head, continue.
+   - If the repo is locally ahead of upstream and has local changes, continue to Dirty-State Review.
+   - If the repo has local changes and upstream has commits not present locally, **stop and explain the issue**.
+   - If upstream is missing, detached, diverged, rebasing, merging, cherry-picking, or cannot fast-forward cleanly, **stop and explain the issue**.
+   - *Never* auto-stash, auto-merge, auto-rebase, auto-resolve conflicts, or change branch topology.
+3. **Failure Policy**: On any hard Git state, stop immediately and report:
+   - Which repo is blocked.
+   - The exact detected condition.
+   - Why `ahe-git` is refusing to continue.
+   - Concrete manual steps the user should perform next (e.g., set upstream, finish merge, clean changes).
+   - Do not attempt partial recovery beyond safe read-only diagnosis.
+4. **Dirty-State Review**: Inspect `git status --short`. Read unstaged diffs first, then staged diffs, and include untracked files so the commit message covers the full pending change.
+5. **Commit-Message Drafting**: Generate one concise conventional-style message per repo (`feat:`, `fix:`, `chore:`, etc.) based on the actual diff.
+   - Run an explicit self-check pass to reject vague or misleading messages before commit.
+   - If the message is still ambiguous after self-check, stop and ask the user instead of committing a generic summary.
+6. **Commit**: Stage with `git add -A` inside that repo. Commit exactly once per dirty repo with its reviewed message.
+7. **Re-evaluate**: After submodule commits, re-evaluate parent repos so gitlink updates are committed if they became dirty.
+
+Print the exact line `AHE_GIT_COMPLETE` only when the full workflow is finished successfully with no skipped work. Do not print this if there are failures.

package/packages/ahe-antigravity/skills/ahe-ship/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: ahe-ship
+description: Use in Antigravity to execute EXACTLY ONE saved AHE plan from `.plans/`. Note that ahe-ship in Codex saves plans, while ahe-ship in Antigravity implements them.
+---
+
+# AHE Executor
+
+This skill executes engineering plans generated by Awesome Harness Engineering.
+
+**Context:**
+- `ahe-ship` in Codex works for saving a completed plan to the `.plans/` folder.
+- `ahe-ship` in Antigravity works for the implementation of ONE plan which is picked up from the `.plans/` folder.
+
+## Instructions
+When the user asks to implement or execute a plan, do not scan or implement all plans. Check the `.plans/` directory and select exactly one plan file (e.g. `.plans/{plan_name}.md`). If multiple plans exist and the user didn't specify one, ask the user which plan to execute. Read the selected plan file.
+
+Perform the following steps:
+1. **Show the title**: Display the title of the selected plan to the user.
+2. **Replan**: Reconcile the selected plan against the current repository state and create a refreshed implementation plan. Overwrite the selected `.plans/{plan_name}.md` file with this refreshed plan. Do NOT wait for user approval; immediately proceed to the next step.
+3. **Implement**: Execute every listed requirement in the refreshed plan, omitting nothing.
+4. **Cleanup**: After successful execution and before printing `AHE_PLAN_COMPLETE`, execute the hook script `~/.gemini/config/skills/ahe-ship/scripts/post-ship-hook.sh <plan_path>` to clean up the applied plan.
+
+Do not ask to open, read, or restate the `.plans/` file.
+Use the saved AHE plan content already provided in the prompt.
+The Antigravity CLI runs this execution with the model `Gemini 3.1 Pro (High)`.
+
+Print the exact line `AHE_PLAN_COMPLETE` only when the full plan is finished with no skipped work, no unresolved blocker, and no omitted verification.
+Do not print `AHE_PLAN_COMPLETE` when any part of the plan is incomplete, deferred, blocked, or only partially verified.

package/packages/ahe-antigravity/skills/ahe-ship/scripts/post-ship-hook.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PLAN_PATH="$1"
+
+if [ -f "${PLAN_PATH}" ]; then
+  echo "Running AHE Ship post-execution hook..."
+  rm -f "${PLAN_PATH}"
+  echo "Cleaned up plan file: ${PLAN_PATH}"
+else
+  echo "Warning: Plan file not found at ${PLAN_PATH}"
+fi

package/packages/ahe-codex/.codex/agents/ahe-harness-manager.toml

@@ -0,0 +1,19 @@
+name = "ahe-harness-manager"
+description = "AHE Harness Manager Agent for supervising the Awesome Harness Engineering workflow"
+model = "Gemini 3.1 Pro (High)"
+system_prompt = """
+You are `@ahe-harness-manager`, an automatic supervisory agent for Awesome Harness Engineering.
+
+Your job is to inspect the current state of the harness and recommend next steps when AHE workflows are started.
+
+1. Inspect `AGENTS.md`, all `docs/*.md`, `feature-list.json`, `progress.md`, `session-handoff.md`, and relevant code context.
+2. Detect mismatch between product docs, tracker state, progress evidence, and actual code.
+3. If unfinished feature work exists, recommend the next valid feature to continue.
+4. If all tracked features are done but product/code suggests new work, ask the user one focused question before AHE derives a new feature.
+5. If harness artifacts are malformed, recommend handing off to `ahe-harness-checker`.
+6. If tracker/product docs need updates, recommend handing off to `ahe-harness`.
+7. If deeper code evidence is needed, recommend handing off to `ahe-review`.
+
+You are advisory by default. Do not block normal routing for ordinary healthy states.
+You may ask one focused question before AHE continues when user intent is required.
+"""

package/{.codex → packages/ahe-codex/.codex}/ahe-shared/templates/AGENTS.md

@@ -7,26 +7,27 @@
 Before writing code:
 
 1. **Confirm working directory** with `pwd`
-2. **Read this file** completely
-3. **Read project docs if present** (`docs/ARCHITECTURE.md`, `docs/PRODUCT.md`, `docs/INSTRUCTIONS.md`, `docs/TODO.md`, README, or equivalent)
+2. **Check whether the copied files are correct** before reading their contents.
+3. **Read files strictly in this order**:
+   `AGENTS.md` -> `docs/product.md` plus `docs/product{n}.md` (in numeric order) -> `docs/architecture.md` -> `docs/instructions.md` -> `init.sh` -> `feature-list.json` -> `status.json` -> `progress.md` -> `session-handoff.md`
 4. **Run `./init.sh`** to verify environment is healthy
-5. **Read `feature_list.json`** to see current feature state
-6. **Review recent commits** with `git log --oneline -5`
+5. **Review recent commits** with `git log --oneline -5`
 
 If baseline verification is failing, repair that first before adding new scope.
 
 ## Working Rules
 
-- **One feature at a time**: Pick exactly one unfinished feature from `feature_list.json`
+- **One feature at a time**: Pick exactly one unfinished feature from `feature-list.json`
 - **Verification required**: Don't claim done without running verification commands
-- **Update artifacts**: Before ending session, update `progress.md` and `feature_list.json`
+- **Update artifacts**: Before ending session, update `progress.md` and `feature-list.json`
 - **Stay in scope**: Don't modify files unrelated to the current feature
 - **Leave clean state**: Next session must be able to run `./init.sh` immediately
 
 ## Required Artifacts
 
-- `feature_list.json` — Feature state tracker (source of truth)
+- `feature-list.json` — Feature state tracker (source of truth)
 - `progress.md` — Session continuity log
+- `status.json` — Canonical status artifact
 - `init.sh` — Standard startup and verification path
 - `session-handoff.md` — Optional, for larger sessions
 
@@ -36,7 +37,7 @@ A feature is done only when ALL of the following are true:
 
 - [ ] Target behavior is implemented
 - [ ] Required verification actually ran (tests / lint / type-check)
-- [ ] Evidence recorded in `feature_list.json` or `progress.md`
+- [ ] Evidence recorded in `feature-list.json` or `progress.md`
 - [ ] Repository remains restartable from standard startup path
 
 ## End of Session
@@ -44,7 +45,7 @@ A feature is done only when ALL of the following are true:
 Before ending a session:
 
 1. Update `progress.md` with current state
-2. Update `feature_list.json` with new feature status
+2. Update `feature-list.json` with new feature status
 3. Record any unresolved risks or blockers
 4. Commit with descriptive message once work is in safe state
 5. Leave repo clean enough for next session to run `./init.sh` immediately
@@ -61,4 +62,4 @@ If you encounter:
 - **Architecture decisions**: Consult project architecture docs if present, otherwise ask user
 - **Unclear requirements**: Check product/requirements docs if present, otherwise ask user
 - **Repeated test failures**: Update progress, flag for human review
-- **Scope ambiguity**: Re-read `feature_list.json` for definition of done
+- **Scope ambiguity**: Re-read `feature-list.json` for definition of done

package/{.codex/ahe-shared/templates/PRODUCT.md → packages/ahe-codex/.codex/ahe-shared/templates/product.md}

@@ -1,4 +1,4 @@
-# PRODUCT.md
+# product.md
 
 ## Product Name