From aa32983f87a2f7f0d5c30d69e99c1fedbc36ca32 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 17 May 2026 16:59:09 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20fix=20documentation=20drift=20=E2=80=94?=
 =?UTF-8?q?=20engine=5Flog=5Fdir=20path=20and=20ado/mod.rs=20lifecycle=20c?=
 =?UTF-8?q?ommands?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docs/template-markers.md: correct {{ engine_log_dir }} from ~/.copilot/logs to
  $HOME/.copilot/logs, matching src/engine.rs log_dir(). Add explanation that tilde
  does not expand inside double-quoted bash strings, which would cause the directory
  check to always fail and silently prevent log collection.
- AGENTS.md: remove references to unimplemented lifecycle CLI commands (disable,
  remove, list, run, status, secrets) from the ado/mod.rs description; only the
  'enable' command is currently implemented.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 AGENTS.md                | 2 +-
 docs/template-markers.md | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 49561a50..0f888099 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -78,7 +78,7 @@ Every compiled pipeline runs as three sequential jobs:
 │   ├── configure.rs      # `configure` CLI command — orchestration shim atop `src/ado/`
 │   ├── enable.rs         # `enable` CLI command — registers ADO build definitions for compiled pipelines and ensures they are enabled
 │   ├── ado/              # Shared Azure DevOps REST helpers (auth, list/match/PATCH/POST)
-│   │   └── mod.rs        # Used by `configure` and the lifecycle commands (enable, disable, remove, list, run, status, secrets)
+│   │   └── mod.rs        # Used by `configure` and the `enable` command (ADO REST helpers: auth, list/match/PATCH/POST)
 │   ├── detect.rs         # Agentic pipeline detection (helper for `configure`)
 │   ├── ndjson.rs         # NDJSON parsing utilities
 │   ├── sanitize.rs       # Input sanitization for safe outputs
diff --git a/docs/template-markers.md b/docs/template-markers.md
index 00ee91e7..b18fa986 100644
--- a/docs/template-markers.md
+++ b/docs/template-markers.md
@@ -216,7 +216,9 @@ ADO access tokens (`AZURE_DEVOPS_EXT_PAT`, `SYSTEM_ACCESSTOKEN`) are not part of
 
 ## {{ engine_log_dir }}
 
-Should be replaced with the engine's log directory path, generated by `Engine::log_dir()`. For Copilot: `~/.copilot/logs`. Used by log collection steps to copy engine logs to pipeline artifacts.
+Should be replaced with the engine's log directory path, generated by `Engine::log_dir()`. For Copilot: `$HOME/.copilot/logs`. Used by log collection steps to copy engine logs to pipeline artifacts.
+
+> **Note:** `$HOME` is used instead of `~` because tilde does not expand inside double-quoted strings in bash. Using `~` would cause the directory check (`[ -d "~/.copilot/logs" ]`) to always fail, silently preventing log collection.
 
 ## {{ pool }}