@ksuchoi216/ahe 0.1.1 → 0.1.6

package/.codex/ahe-shared/config.yaml

@@ -0,0 +1,8 @@
+agent_md: 80
+product_md: 180
+instructions_md: 180
+feature_list_json: 180
+progress_md: 180
+session_handoff_md: 180
+todo_md: 180
+total: 750

package/.codex/hooks/ahe-hook.js

@@ -18,6 +18,7 @@ const AHE_PROGRESS_DIRECTIVE = [
     "   - Check `feature-list.json` as a derived tracker.",
     "   - Check `PROGRESS.md`.",
     "   - Use `ahe-thinking` as the internal decision layer before choosing the next action.",
+    "   - Before reading large harness files wholesale, let `ahe-thinking` run the `ahe-compression` size detector and call `ahe-compression` if compression is required.",
     "",
     "3. Review code through CodeGraph when available:",
     "   - Prefer CodeGraph MCP or CodeGraph exploration for code review and impact context after the preflight command succeeds.",
@@ -89,6 +90,96 @@ function isExactAheInitCommand(prompt) {
     );
 }
 
+function isBroadAheIntent(prompt) {
+    if (isExactAheCommand(prompt) || isExactAheInitCommand(prompt)) {
+        return false;
+    }
+    
+    const p = normalizePrompt(prompt);
+    
+    const hasAction = /(add|new|update|change|track|manage)/.test(p);
+    const hasTarget = /(product|feature|instruction|requirement|spec|work|todo)/.test(p);
+    
+    if (!(hasAction && hasTarget)) {
+        return false;
+    }
+    
+    const falsePositives = [
+        /what is/,
+        /explain/,
+        /how to/,
+        /how do/,
+        /file/,
+        /error/,
+        /issue/
+    ];
+    
+    for (const fp of falsePositives) {
+        if (fp.test(p)) return false;
+    }
+    
+    return true;
+}
+
+function getAdaptiveDirective(prompt) {
+    return [
+        AHE_DIRECTIVE_MARKER,
+        "AHE automatic operation activated.",
+        "",
+        `Original prompt: "${prompt}"`,
+        "",
+        "The user provided a broad natural-language AHE work intent.",
+        "Operate as the Awesome Harness Engineering router with an adaptive workflow:",
+        "",
+        "1. Run CodeGraph preflight before inspecting harness status:",
+        "   - Check whether the CodeGraph CLI is installed with `command -v codegraph`.",
+        "   - If the `codegraph` command is not installed, report `NOT INSTALLATION of codegraph`, skip `codegraph init` and `codegraph sync`, and continue with normal repo inspection.",
+        "   - If `.codegraph/` does not exist, run `codegraph init` before reviewing code.",
+        "   - If `.codegraph/` exists, run `codegraph sync` before reviewing code.",
+        "",
+        "2. Inspect current harness state before choosing a workflow:",
+        "   - Check `AGENTS.md`.",
+        "   - Check `docs/PRODUCT.md` and `docs/INSTRUCTIONS.md` as the product/specification source of truth.",
+        "   - Check `feature-list.json` as a derived tracker.",
+        "   - Check `PROGRESS.md`.",
+        "   - Use `ahe-thinking` as the internal decision layer before choosing the next action.",
+        "   - Before reading large harness files wholesale, let `ahe-thinking` run the `ahe-compression` size detector and call `ahe-compression` if compression is required.",
+        "",
+        "3. Review code through CodeGraph when available.",
+        "",
+        "4. Make the first response a simple harness engineering status report table before proceeding:",
+        "   - Start the response with a concise status report table.",
+        "   - Use this consistent Markdown table format:",
+        "     | Item | Content |",
+        "     |---|---|",
+        "     | AGENTS.md | Exists/missing, purpose status, and any obvious issue. |",
+        "     | PRODUCT.md | Exists/missing, completion state, and whether product scope needs work. |",
+        "     | INSTRUCTIONS.md | Exists/missing, and whether instruction boundaries need work. |",
+        "     | feature-list.json | Valid/missing/invalid, unfinished feature summary, and all-done status. |",
+        "     | PROGRESS.md | Exists/missing and current session state. |",
+        "   - Keep the table short and readable.",
+        "   - Do not include the next step inside the table.",
+        "",
+        "5. Decide the next AHE workflow with `ahe-thinking` based on the original prompt:",
+        "   - Classify the user intent from the original prompt as: `product/spec changes`, `instruction changes`, `feature/todo tracking`, or `unclear AHE work`.",
+        "   - Route product/spec changes to `ahe-spec`.",
+        "   - Route instruction changes to `ahe-spec`, and create `docs/INSTRUCTIONS.md` from the template when needed.",
+        "   - Route feature/todo tracking to `ahe-update`.",
+        "   - Route unclear AHE work to `ahe-conversation`.",
+        "",
+        "6. Ask for clarification instead of guessing:",
+        "   - If the request is vague, ask exactly one detail question before editing.",
+        "   - Call `ahe-conversation` for missing `Why`, `What`, or `How`.",
+        "   - Continue only after one safe next step is clear.",
+        "",
+        "7. After the table, classify the harness into exactly one state.",
+        "   - Use exactly one state: `harness engineering not enough`, `in the middle of building features`, or `completed all`.",
+        "   - Do not include the next step inside the table.",
+        "   - Continue automatically after classification.",
+        "   - Follow this loop: `thinking -> conversation if needed -> execution -> thinking`.",
+    ].join("\\n");
+}
+
 function normalizePrompt(prompt) {
     return prompt.trim().toLowerCase();
 }
@@ -130,6 +221,14 @@ async function main() {
                 }
             };
             process.stdout.write(JSON.stringify(output) + "\n");
+        } else if (isBroadAheIntent(parsed.prompt)) {
+            const output = {
+                hookSpecificOutput: {
+                    hookEventName: "UserPromptSubmit",
+                    additionalContext: getAdaptiveDirective(parsed.prompt)
+                }
+            };
+            process.stdout.write(JSON.stringify(output) + "\n");
         }
     }
 }

package/.codex/skills/ahe-compression/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: ahe-compression
+description: Internal AHE compression workflow for detecting oversized harness-engineering files and compacting them before AHE thinking reads or routes large context. Use when AGENTS.md, docs/PRODUCT.md, docs/INSTRUCTIONS.md, feature-list.json, PROGRESS.md, SESSION-HANDOFF.md, docs/todo.md, or other AHE harness artifacts have too many lines or waste context.
+---
+
+# AHE Compression
+
+This is an internal AHE workflow skill, not a user-facing command.
+
+Do not treat `$ahe-compression` as a user command.
+Use it after `ahe-thinking` decides that harness context is too large to read
+efficiently.
+
+## Size Detection
+
+Run the deterministic line-count preflight before reading full harness files:
+
+```bash
+sh .codex/skills/ahe-compression/scripts/check-harness-size.sh
+```
+
+The script checks these AHE-managed files when they exist:
+
+- `AGENTS.md`
+- `docs/PRODUCT.md`
+- `docs/INSTRUCTIONS.md`
+- `feature-list.json`
+- `PROGRESS.md`
+- `SESSION-HANDOFF.md`
+- `docs/todo.md`
+
+Default thresholds are configured in `.codex/ahe-shared/config.yaml`:
+
+- `agent_md`: 80
+- `product_md`: 180
+- `instructions_md`: 180
+- `feature_list_json`: 180
+- `progress_md`: 180
+- `session_handoff_md`: 180
+- `todo_md`: 180
+- `total`: 750 (combined harness context limit)
+
+Override thresholds only when the workspace has an explicit local rule using environment variables (e.g., `AHE_AGENT_MD_LIMIT`, `AHE_FILE_LINE_LIMIT`, `AHE_TOTAL_LINE_LIMIT`):
+
+```bash
+AHE_AGENT_MD_LIMIT=100 AHE_TOTAL_LINE_LIMIT=900 sh .codex/skills/ahe-compression/scripts/check-harness-size.sh
+```
+
+Exit code meanings:
+
+- `0`: no compression needed.
+- `2`: compression needed.
+- Output ending in `COMPRESSION_REQUIRED`: compression needed.
+- Any other nonzero code: detector failed; fall back to `wc -l` on the same
+  file set and continue the decision manually.
+
+## Compression Decision
+
+- If the detector exits `2`, compress before normal AHE routing continues.
+- If only one file exceeds the per-file threshold, compress that file first.
+- If total harness context exceeds the total threshold, compress the largest
+  AHE-managed files until the total is under the threshold.
+- If `AGENTS.md` is oversized, obey the local `AGENTS.md` instructions before
+  editing it. Compress only sections that local rules allow. If no section is
+  safely editable, report the blocker and compress other harness files instead.
+- Do not read an oversized file wholesale after detection. Read headings,
+  current-status sections, JSON keys, or bounded line ranges needed to preserve
+  behavior.
+
+## Compression Rules
+
+- Preserve active requirements, current decisions, incomplete work, blockers,
+  dependencies, and verification evidence.
+- Preserve required headers and file formats for `PROGRESS.md`,
+  `SESSION-HANDOFF.md`, `feature-list.json`, and `AGENTS.md`.
+- Keep `feature-list.json` valid JSON. Shorten old completed-feature evidence,
+  but preserve each feature `id`, `name`, `description`, `dependencies`,
+  `status`, and current unfinished details.
+- Keep `docs/PRODUCT.md` and `docs/INSTRUCTIONS.md` as the current harness
+  contract. Remove duplicate historical wording only when the active contract
+  remains clear.
+- Keep `PROGRESS.md` focused on current status, recent completed work,
+  decisions that still matter, blockers, and latest verification.
+- Keep `SESSION-HANDOFF.md` focused on the startup path for the next session,
+  important files, open questions, and current verification status.
+- Back up material before deleting substantial historical context by moving it
+  under `.ahe/backups/compression-YYYYMMDD-HHMMSS/` when that context may still
+  be useful.
+
+## Completion
+
+- Re-run the size detector after compression.
+- Run JSON validation when `feature-list.json` changed.
+- Run the repository's normal harness verification command when compression
+  changed tracked harness files.
+- Update `PROGRESS.md` and `SESSION-HANDOFF.md` with the compression evidence
+  when they changed or when compression affects the active workflow.

package/.codex/skills/ahe-compression/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "AHE Compression"
+  short_description: "Compress oversized harness context"
+  default_prompt: "Use $ahe-compression to compact oversized AHE harness files before continuing."
+policy:
+  allow_implicit_invocation: false

package/.codex/skills/ahe-compression/scripts/check-harness-size.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env sh
+set -eu
+
+limit_agent_md=180
+limit_product_md=180
+limit_instructions_md=180
+limit_feature_list_json=180
+limit_progress_md=180
+limit_session_handoff_md=180
+limit_todo_md=180
+limit_total=750
+
+config_file=".codex/ahe-shared/config.yaml"
+if [ -f "${config_file}" ]; then
+  while IFS= read -r line || [ -n "$line" ]; do
+    line="${line#"${line%%[![:space:]]*}"}"
+    line="${line%"${line##*[![:space:]]}"}"
+    case "$line" in
+      "" | \#*) continue ;;
+    esac
+    
+    key="${line%%:*}"
+    val="${line#*:}"
+    key="${key%"${key##*[![:space:]]}"}"
+    val="${val#"${val%%[![:space:]]*}"}"
+    
+    case "$val" in
+      ''|*[!0-9]*) continue ;;
+    esac
+
+    case "$key" in
+      agent_md) limit_agent_md="$val" ;;
+      product_md) limit_product_md="$val" ;;
+      instructions_md) limit_instructions_md="$val" ;;
+      feature_list_json) limit_feature_list_json="$val" ;;
+      progress_md) limit_progress_md="$val" ;;
+      session_handoff_md) limit_session_handoff_md="$val" ;;
+      todo_md) limit_todo_md="$val" ;;
+      total) limit_total="$val" ;;
+    esac
+  done < "${config_file}"
+fi
+
+limit_agent_md="${AHE_AGENT_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_agent_md}}"
+limit_product_md="${AHE_PRODUCT_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_product_md}}"
+limit_instructions_md="${AHE_INSTRUCTIONS_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_instructions_md}}"
+limit_feature_list_json="${AHE_FEATURE_LIST_JSON_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_feature_list_json}}"
+limit_progress_md="${AHE_PROGRESS_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_progress_md}}"
+limit_session_handoff_md="${AHE_SESSION_HANDOFF_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_session_handoff_md}}"
+limit_todo_md="${AHE_TODO_MD_LIMIT:-${AHE_FILE_LINE_LIMIT:-$limit_todo_md}}"
+total_limit="${AHE_TOTAL_LINE_LIMIT:-$limit_total}"
+
+total_lines=0
+compression_required=0
+
+if [ "$#" -eq 0 ]; then
+  set -- \
+    "AGENTS.md" \
+    "docs/PRODUCT.md" \
+    "docs/INSTRUCTIONS.md" \
+    "feature-list.json" \
+    "PROGRESS.md" \
+    "SESSION-HANDOFF.md" \
+    "docs/todo.md"
+fi
+
+for file_path in "$@"; do
+  if [ ! -f "${file_path}" ]; then
+    continue
+  fi
+
+  line_count="$(wc -l < "${file_path}")"
+  line_count="${line_count#"${line_count%%[![:space:]]*}"}"
+  line_count="${line_count%"${line_count##*[![:space:]]}"}"
+  total_lines=$((total_lines + line_count))
+
+  current_limit=180
+  case "${file_path}" in
+    "AGENTS.md") current_limit="${limit_agent_md}" ;;
+    "docs/PRODUCT.md") current_limit="${limit_product_md}" ;;
+    "docs/INSTRUCTIONS.md") current_limit="${limit_instructions_md}" ;;
+    "feature-list.json") current_limit="${limit_feature_list_json}" ;;
+    "PROGRESS.md") current_limit="${limit_progress_md}" ;;
+    "SESSION-HANDOFF.md") current_limit="${limit_session_handoff_md}" ;;
+    "docs/todo.md") current_limit="${limit_todo_md}" ;;
+    *) current_limit="${AHE_FILE_LINE_LIMIT:-180}" ;;
+  esac
+
+  if [ "${line_count}" -ge "${current_limit}" ]; then
+    compression_required=1
+    printf 'COMPRESS\t%s\t%s\tlimit=%s\n' "${file_path}" "${line_count}" "${current_limit}"
+  else
+    printf 'OK\t%s\t%s\tlimit=%s\n' "${file_path}" "${line_count}" "${current_limit}"
+  fi
+done
+
+if [ "${total_lines}" -ge "${total_limit}" ]; then
+  compression_required=1
+  printf 'COMPRESS_TOTAL\t%s\tlimit=%s\n' "${total_lines}" "${total_limit}"
+else
+  printf 'OK_TOTAL\t%s\tlimit=%s\n' "${total_lines}" "${total_limit}"
+fi
+
+if [ "${compression_required}" -eq 1 ]; then
+  printf 'COMPRESSION_REQUIRED\n'
+  exit 2
+fi
+
+printf 'COMPRESSION_NOT_REQUIRED\n'

package/.codex/skills/ahe-spec/SKILL.md

@@ -22,7 +22,7 @@ Use it after `ahe-thinking` decides that specification work must continue.
 
 - `docs/PRODUCT.md` is the canonical home for product specification details collected during `ahe init`.
 - Clarify product goal, scope, and success criteria when `docs/PRODUCT.md` needs to change.
-- Clarify project instructions when `docs/INSTRUCTIONS.md` needs to change.
+- Clarify project instructions when `docs/INSTRUCTIONS.md` needs to change. If `docs/INSTRUCTIONS.md` is missing, create it from `.codex/ahe-shared/templates/INSTRUCTIONS.md` first, then ask what additional instructions belong under `## CAN CHANGE INSTRUCTIONS`.
 - Draft the relevant specification updates in chat and ask for user approval.
 - Ask recursively for more detail until the affected specification areas are clear and approved.
 

package/.codex/skills/ahe-thinking/SKILL.md

@@ -56,6 +56,14 @@ safely.
 
 ## Next-Step Decision
 
+- Before reading full harness files, decide whether compression is needed.
+  Run `sh .codex/skills/ahe-compression/scripts/check-harness-size.sh` when the
+  script exists (which checks against configurable thresholds in `.codex/ahe-shared/config.yaml`),
+  or fall back to `wc -l` over `AGENTS.md`, `docs/PRODUCT.md`, `docs/INSTRUCTIONS.md`, 
+  `feature-list.json`, `PROGRESS.md`, `SESSION-HANDOFF.md`, and `docs/todo.md`.
+- If the detector reports `COMPRESSION_REQUIRED` or exits with code `2`, call
+  `ahe-compression` before normal routing. Do not spend context reading the
+  oversized files wholesale first.
 - If `docs/PRODUCT.md` or `docs/INSTRUCTIONS.md` is missing or empty, classify the state as
   `harness engineering not enough` and prioritize product/instructions specification work.
 - `docs/PRODUCT.md` and `docs/INSTRUCTIONS.md` form the required harness contract. `docs/PRODUCT.md` is the product/specification source of truth, and
@@ -69,6 +77,14 @@ safely.
 - If tracked work is complete and no obvious essential harness gap remains,
   classify the state as `completed all` and ask for the next task.
 
+## Broad User Intent Routing
+
+When the user provides a broad natural-language work intent (e.g., "add features", "update spec"), use their original prompt to determine the exact path:
+- Route **product/spec changes** to `ahe-spec`.
+- Route **instruction changes** to `ahe-spec`.
+- Route **feature/todo tracking** to `ahe-update`.
+- Route **unclear AHE work** to `ahe-conversation` and ask exactly one detail question before editing if the request is vague.
+
 ## Conversation Handoff
 
 If clarity is missing, call `ahe-conversation` with the exact missing `Why`,

package/README.md

@@ -29,14 +29,14 @@ npx --yes --package=file:. ahe install
 
 ### CLI Commands
 
-| Command | Description |
-|---|---|
-| `ahe install` | Install AHE skills into `.codex/` |
-| `ahe install --force` | Overwrite existing installation |
+| Command                | Description                                     |
+| ---------------------- | ----------------------------------------------- |
+| `ahe install`          | Install AHE skills into `.codex/`               |
+| `ahe install --force`  | Overwrite existing installation                 |
 | `ahe install --backup` | Backup existing installation before overwriting |
-| `ahe uninstall` | Remove all AHE skills, shared assets, and hooks |
-| `ahe doctor` | Check installation health and integrity |
-| `ahe version` | Print the current version |
+| `ahe uninstall`        | Remove all AHE skills, shared assets, and hooks |
+| `ahe doctor`           | Check installation health and integrity         |
+| `ahe version`          | Print the current version                       |
 
 ---
 
@@ -46,10 +46,10 @@ AHE works inside **Codex chat**. After installing via the terminal, open Codex c
 
 ### Chat Commands
 
-| Command | What it does |
-|---|---|
+| Command    | What it does                                                                                                            |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------- |
 | `ahe init` | **Start a new harness.** Creates harness skeleton files, asks about your project, and writes the product specification. |
-| `ahe` | **Continue existing work.** Inspects the current state, reports status, decides the next step, and keeps working. |
+| `ahe`      | **Continue existing work.** Inspects the current state, reports status, decides the next step, and keeps working.       |
 
 > **Note:** Only exact commands trigger AHE. Normal messages like "explain ahe" or "what does ahe do" will not start any workflow.
 
@@ -82,15 +82,16 @@ $ ahe install
 
 ### Skills Overview
 
-AHE is composed of five internal skills that coordinate automatically:
+AHE is composed of six core skills that coordinate automatically:
 
-| Skill | Role |
-|---|---|
-| **ahe-init** | Entry point for new projects. Creates harness files, asks for project info, then calls ahe-spec and ahe-update. |
-| **ahe-thinking** | Internal decision engine. Evaluates clarity on **Why** / **What** / **How** for each work unit and routes to the right action. |
-| **ahe-conversation** | Internal question protocol. Asks exactly one focused question at a time when information is missing. |
-| **ahe-spec** | Writes and updates `docs/PRODUCT.md` (canonical source of truth) and `docs/INSTRUCTIONS.md`. |
-| **ahe-update** | Syncs tracking artifacts: `feature-list.json`, `PROGRESS.md`, `SESSION-HANDOFF.md`. |
+| Skill                | Role                                                                                                                                              |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **ahe-init**         | Entry point for new projects. Creates harness files, asks for project info, then calls ahe-spec and ahe-update.                                   |
+| **ahe-thinking**     | Internal decision engine. Evaluates clarity on **Why** / **What** / **How** for each work unit and routes to the right action.                    |
+| **ahe-compression**  | Internal size detector & compressor. Monitors file sizes via configurable thresholds (`config.yaml`) and compresses bloated files before reading. |
+| **ahe-conversation** | Internal question protocol. Asks exactly one focused question at a time when information is missing.                                              |
+| **ahe-spec**         | Writes and updates `docs/PRODUCT.md` (canonical source of truth) and `docs/INSTRUCTIONS.md`.                                                      |
+| **ahe-update**       | Syncs tracking artifacts: `feature-list.json`, `PROGRESS.md`, `SESSION-HANDOFF.md`.                                                               |
 
 ### Process Flow
 
@@ -113,7 +114,8 @@ flowchart TD
     Step2 --> Step3["<b>Step 3: ahe-update</b><br/>Sync feature-list.json<br/>and PROGRESS.md"]
     Step3 --> Done["Harness ready ✓"]
 
-    Feature --> Thinking["<b>ahe-thinking</b><br/>Check Why / What / How"]
+    Feature --> Compression["<b>ahe-compression</b><br/>Check & compress oversized files"]
+    Compression --> Thinking["<b>ahe-thinking</b><br/>Check Why / What / How"]
     Thinking --> Clear{"Clear enough<br/>to proceed?"}
     Clear -->|"No"| Convo["<b>ahe-conversation</b><br/>Ask one focused question"]
     Convo --> UserAnswer["User answers"]
@@ -143,10 +145,11 @@ flowchart TD
    - **"Not enough spec"** → routes to `ahe-init` to fill gaps.
    - **"Building features"** → picks the next unfinished feature from `feature-list.json`.
    - **"All completed"** → asks the user for the next task.
-4. **ahe-thinking** checks clarity (Why / What / How) for the current work unit.
-5. If unclear → **ahe-conversation** asks exactly one question, then re-evaluates.
-6. If clear → executes the next safe step.
-7. **ahe-update** syncs all tracking artifacts at the end.
+4. **ahe-thinking** checks file sizes using **ahe-compression** and compresses oversized files based on `config.yaml` thresholds.
+5. **ahe-thinking** checks clarity (Why / What / How) for the current work unit.
+6. If unclear → **ahe-conversation** asks exactly one question, then re-evaluates.
+7. If clear → executes the next safe step.
+8. **ahe-update** syncs all tracking artifacts at the end.
 
 #### Execution Loop
 
@@ -169,9 +172,11 @@ your-project/
 │   │   ├── ahe-init/           # New-start workflow skill
 │   │   ├── ahe-conversation/   # Internal question protocol
 │   │   ├── ahe-thinking/       # Internal decision engine
+│   │   ├── ahe-compression/    # Internal size detector & compressor
 │   │   ├── ahe-spec/           # Specification writer
 │   │   └── ahe-update/         # Tracking artifact syncer
 │   ├── ahe-shared/
+│   │   ├── config.yaml         # Compression thresholds & configuration
 │   │   ├── templates/          # Harness file templates
 │   │   └── schemas/            # Validation schemas
 │   └── hooks/
@@ -199,6 +204,13 @@ your-project/
 
 If you are an AI agent working on this repository, please strictly follow the guidelines in [AGENTS.md](AGENTS.md). It includes critical instructions regarding the definition of done, verification commands, and file modification rules (e.g., you must update `PROGRESS.md` and `feature-list.json` appropriately).
 
+## References
+
+This repository was greatly influenced by the following projects:
+
+- [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent): Greatly influenced the code structure of this project.
+- [learn-harness-engineering](https://github.com/walkinglabs/learn-harness-engineering): Provided the harness engineering templates used in this project.
+
 ## License
 
 MIT

package/bin/ahe

@@ -19,9 +19,12 @@ readonly PACKAGE_ROOT="$(CDPATH= cd -- "${SCRIPT_DIR}/.." && pwd)"
 readonly SOURCE_SKILLS_DIR="${PACKAGE_ROOT}/.codex/skills"
 readonly SOURCE_SHARED_DIR="${PACKAGE_ROOT}/.codex/ahe-shared"
 readonly SOURCE_HOOKS_DIR="${PACKAGE_ROOT}/.codex/hooks"
+readonly AHE_CONFIG_BLOCK_START="# BEGIN AHE MANAGED CONFIG"
+readonly AHE_CONFIG_BLOCK_END="# END AHE MANAGED CONFIG"
 readonly MANAGED_SKILLS=(
   "ahe-init"
   "ahe-conversation"
+  "ahe-compression"
   "ahe-thinking"
   "ahe-spec"
   "ahe-update"
@@ -48,6 +51,48 @@ backup_existing_installation() {
   mv "${target_dir}" "${backup_root}/${backup_name}-${timestamp}"
 }
 
+cleanup_ahe_config_entries() {
+  local config_path="$1"
+  local temp_path=""
+
+  if [ ! -f "${config_path}" ]; then
+    return 0
+  fi
+
+  temp_path="${config_path}.ahe-cleanup"
+  awk -v block_start="${AHE_CONFIG_BLOCK_START}" -v block_end="${AHE_CONFIG_BLOCK_END}" '
+    function is_ahe_header(line) {
+      return line ~ /^\[agents\."?ahe[-_][^]]*"?\]$/ ||
+        line ~ /^\[hooks\.state\."ahe[^"]*"\]$/ ||
+        line ~ /^\[plugins\."?ahe[^]]*"?\]$/ ||
+        line ~ /^\[plugins\."@ksuchoi216\/ahe[^"]*"\]$/
+    }
+
+    $0 == block_start {
+      skip = 1
+      next
+    }
+
+    $0 == block_end {
+      skip = 0
+      next
+    }
+
+    /^\[/ {
+      if (is_ahe_header($0)) {
+        skip = 1
+        next
+      }
+      skip = 0
+    }
+
+    skip != 1 {
+      print
+    }
+  ' "${config_path}" > "${temp_path}"
+  mv "${temp_path}" "${config_path}"
+}
+
 install_skill() {
   local force="false"
   local backup="false"
@@ -82,10 +127,13 @@ install_skill() {
   local target_skills_dir="${PWD}/.codex/skills"
   local target_shared_dir="${PWD}/.codex/ahe-shared"
   local target_hooks_dir="${PWD}/.codex/hooks"
+  local target_config_path="${PWD}/.codex/config.toml"
   local backup_dir="${PWD}/.codex/_backups"
   local skill_name=""
   local skill_target=""
 
+  cleanup_ahe_config_entries "${target_config_path}"
+
   for skill_name in "${MANAGED_SKILLS[@]}"; do
     skill_target="${target_skills_dir}/${skill_name}"
 
@@ -168,6 +216,11 @@ doctor() {
     fi
   done
 
+  if [ ! -f "${target_shared_dir}/config.yaml" ]; then
+    printf 'Missing: %s/config.yaml\n' "${target_shared_dir}" >&2
+    exit 1
+  fi
+
   if [ ! -d "${target_shared_dir}/templates" ]; then
     printf 'Missing: %s/templates\n' "${target_shared_dir}" >&2
     exit 1
@@ -190,6 +243,7 @@ uninstall_skill() {
   local target_skills_dir="${PWD}/.codex/skills"
   local target_shared_dir="${PWD}/.codex/ahe-shared"
   local target_hooks_dir="${PWD}/.codex/hooks"
+  local target_config_path="${PWD}/.codex/config.toml"
   local skill_name=""
 
   echo "Uninstalling AHE skills from ${PWD}/.codex..."
@@ -200,6 +254,7 @@ uninstall_skill() {
 
   rm -rf "${target_shared_dir}"
   rm -rf "${target_hooks_dir}"
+  cleanup_ahe_config_entries "${target_config_path}"
 
   echo "AHE skills uninstalled successfully."
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksuchoi216/ahe",
-  "version": "0.1.1",
+  "version": "0.1.6",
   "description": "Codex chat workflow skill installer for Awesome Harness Engineering",
   "publishConfig": {
     "access": "public"
@@ -30,4 +30,4 @@
     ".codex/"
   ],
   "license": "MIT"
-}
+}