From f02b3fa69d8b418cdee53e2fe34d13fce6d819c7 Mon Sep 17 00:00:00 2001
From: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
Date: Thu, 17 Sep 2026 08:58:16 +0800
Subject: [PATCH] docs(cli): classify the agent-directory command in the manual

`loopx agent-directory` shipped in #4544 without a manual-visibility
decision, so `examples/cli-help-manpage-smoke.py` fails on every `main` head
with `{'unclassified': ['agent-directory']}` and takes the full public smoke
sweep down with it.

The command produces the local, goal-scoped peer agent directory this host
can hand work to, so it belongs with the other maintainer-facing agent
commands instead of the help-only surface. `man/loopx.1` is regenerated from
`render_manpage()`, because the smoke asserts the checked-in manual equals the
renderer output.

Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
---
 loopx/help_surface.py | 4 ++++
 man/loopx.1           | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/loopx/help_surface.py b/loopx/help_surface.py
index 41eddaf702..fed0103b6f 100644
--- a/loopx/help_surface.py
+++ b/loopx/help_surface.py
@@ -258,6 +258,10 @@
                 "purpose": "Safely retire explicitly named orphaned global goal routes.",
             },
             {"command": "loopx register-agent", "purpose": "Register an automation agent."},
+            {
+                "command": "loopx agent-directory",
+                "purpose": "Produce the local, goal-scoped peer agent directory this host can hand work to.",
+            },
             {"command": "loopx lark-kanban", "purpose": "Project LoopX state into a Feishu/Lark Base board."},
             {
                 "command": "loopx presentation",
diff --git a/man/loopx.1 b/man/loopx.1
index a63b175ce9..caf3856e59 100644
--- a/man/loopx.1
+++ b/man/loopx.1
@@ -216,6 +216,9 @@ Safely retire explicitly named orphaned global goal routes.
 \fBloopx register\-agent\fR
 Register an automation agent.
 .TP
+\fBloopx agent\-directory\fR
+Produce the local, goal\-scoped peer agent directory this host can hand work to.
+.TP
 \fBloopx lark\-kanban\fR
 Project LoopX state into a Feishu/Lark Base board.
 .TP