project-agent-client 0.1.0__tar.gz

project_agent_client-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: project-agent-client
+Version: 0.1.0
+Summary: Remote Project Agent command-line client
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Project Agent CLI
+
+Install the client with `python -m pip install project-agent-client`, or install
+from this repository with `python -m pip install ./apps/cli`. Build a wheel
+with `python -m build apps/cli` for distribution. The installed
+entry point is `project-agent`; do not install it into the same environment as
+the legacy backend package, which exposes the same command name.
+
+This separately packaged client forwards Task, Query, Sprint and Proposal scene
+commands, Quest Task handoffs, and explicitly supported Context, Doc Hub,
+Meeting, Bootstrap, Attribute, Report, Monitoring and Scheduled commands.
+The service must implement and authorize each operation; this client cannot
+override a service-side rejection. Scene receipts and the stdout, stderr and
+exit code of bridged commands are preserved. Administrative database and
+upgrade operations are not exposed through this client. The server's database
+location is never selected by a client-supplied path.
+
+Configure `PROJECT_SERVICE_URL` and set `PROJECT_SERVICE_TOKEN` to a Magic
+Campus API Key (access token), or to an existing service grant. The client sends
+it as `Authorization: Bearer <token>`; it does not need Magic Campus account
+API settings or service database credentials. HTTPS is required
+except for a local loopback service. The client does not automatically retry a
+write because a network failure can leave its outcome unknown. Legacy Doc Hub
+JSON-file arguments are read on the client and sent as inline JSON; paths are
+never read on the server. A Magic Campus API Key acts only for its verified
+user; it cannot delegate another actor. Commands that mutate data require an
+active user and the applicable project membership. Existing trusted Agent
+grants can still supply a verified per-request actor.
+
+With a personal Magic Campus API Key, Task and Sprint scene writes continue to
+enforce their actor and business rules, and Task Quest commands remain available
+with their own authorization checks. Proposal `list` is readable, while
+`approve` and `reject` require a trusted service grant because the existing
+policy does not yet enforce approval eligibility. For Story/People Quest
+sources, personal keys may use status, query and detail; private query scopes
+must match the caller's active Magic Campus identity. The source operations
+ingest, publish-source, reconcile and history require a trusted service grant
+and an active actor: history also updates the shared review journal. The grant
+must bind the actor or explicitly allow per-request delegation. The CLI bridge supports the
+read-only context commands, Doc Hub reads (`get-root`, `index`, `access target`,
+`access plan`), `meeting parse-time`, `meeting tasks pending`, `mind read`,
+`loop list`, and `monitoring evaluate-followups`; it also supports
+`attribute apply` and `meeting save`, which check project membership.
+
+Other bridge commands require a configured trusted service grant: context
+member/identity management, onboarding, all bootstrap commands (including
+`checkpoint` and `loop-state`, which update state), Doc Hub writes, report,
+monitoring writes, scheduled runs, meeting task plan/placement/run/resume, and
+loop writes. These commands do not yet all enforce caller authorization. The
+service grant must have a bound actor or explicitly trust per-request delegation
+for writes. A personal API Key cannot be used to bypass this restriction.
+
+With a trusted service grant, meeting `tasks run` and `tasks resume` execute on the service, using the bound
+actor. Existing plans must resolve to that actor; a resume batch with a plan
+for another actor is rejected. Task writes use the service-side Quest handoff.
+Meeting notifications are sent by the service's `magic-campus` executable, so
+that executable and its account configuration must be available in the service
+runtime; an absent executable leaves the notification pending for retry.
+The meeting-assistant skill uses the same `PROJECT_SERVICE_URL` and
+`PROJECT_SERVICE_TOKEN` for meeting state when those are set, and does not
+fall back to a local database if the remote service is unavailable.
+
+When an explicitly trusted Agent credential uses `trustActorRefs: true`, the
+runtime must set `PROJECT_SERVICE_ACTOR_REF` to the current verified actor JSON
+(e.g. `{"userId":"..."}`) for CLI bridge operations which need a user. A bound
+actor credential does not need this variable. The service validates that actor
+is active and rejects a conflicting actor in the command input.

project_agent_client-0.1.0/README.md

@@ -0,0 +1,67 @@
+# Project Agent CLI
+
+Install the client with `python -m pip install project-agent-client`, or install
+from this repository with `python -m pip install ./apps/cli`. Build a wheel
+with `python -m build apps/cli` for distribution. The installed
+entry point is `project-agent`; do not install it into the same environment as
+the legacy backend package, which exposes the same command name.
+
+This separately packaged client forwards Task, Query, Sprint and Proposal scene
+commands, Quest Task handoffs, and explicitly supported Context, Doc Hub,
+Meeting, Bootstrap, Attribute, Report, Monitoring and Scheduled commands.
+The service must implement and authorize each operation; this client cannot
+override a service-side rejection. Scene receipts and the stdout, stderr and
+exit code of bridged commands are preserved. Administrative database and
+upgrade operations are not exposed through this client. The server's database
+location is never selected by a client-supplied path.
+
+Configure `PROJECT_SERVICE_URL` and set `PROJECT_SERVICE_TOKEN` to a Magic
+Campus API Key (access token), or to an existing service grant. The client sends
+it as `Authorization: Bearer <token>`; it does not need Magic Campus account
+API settings or service database credentials. HTTPS is required
+except for a local loopback service. The client does not automatically retry a
+write because a network failure can leave its outcome unknown. Legacy Doc Hub
+JSON-file arguments are read on the client and sent as inline JSON; paths are
+never read on the server. A Magic Campus API Key acts only for its verified
+user; it cannot delegate another actor. Commands that mutate data require an
+active user and the applicable project membership. Existing trusted Agent
+grants can still supply a verified per-request actor.
+
+With a personal Magic Campus API Key, Task and Sprint scene writes continue to
+enforce their actor and business rules, and Task Quest commands remain available
+with their own authorization checks. Proposal `list` is readable, while
+`approve` and `reject` require a trusted service grant because the existing
+policy does not yet enforce approval eligibility. For Story/People Quest
+sources, personal keys may use status, query and detail; private query scopes
+must match the caller's active Magic Campus identity. The source operations
+ingest, publish-source, reconcile and history require a trusted service grant
+and an active actor: history also updates the shared review journal. The grant
+must bind the actor or explicitly allow per-request delegation. The CLI bridge supports the
+read-only context commands, Doc Hub reads (`get-root`, `index`, `access target`,
+`access plan`), `meeting parse-time`, `meeting tasks pending`, `mind read`,
+`loop list`, and `monitoring evaluate-followups`; it also supports
+`attribute apply` and `meeting save`, which check project membership.
+
+Other bridge commands require a configured trusted service grant: context
+member/identity management, onboarding, all bootstrap commands (including
+`checkpoint` and `loop-state`, which update state), Doc Hub writes, report,
+monitoring writes, scheduled runs, meeting task plan/placement/run/resume, and
+loop writes. These commands do not yet all enforce caller authorization. The
+service grant must have a bound actor or explicitly trust per-request delegation
+for writes. A personal API Key cannot be used to bypass this restriction.
+
+With a trusted service grant, meeting `tasks run` and `tasks resume` execute on the service, using the bound
+actor. Existing plans must resolve to that actor; a resume batch with a plan
+for another actor is rejected. Task writes use the service-side Quest handoff.
+Meeting notifications are sent by the service's `magic-campus` executable, so
+that executable and its account configuration must be available in the service
+runtime; an absent executable leaves the notification pending for retry.
+The meeting-assistant skill uses the same `PROJECT_SERVICE_URL` and
+`PROJECT_SERVICE_TOKEN` for meeting state when those are set, and does not
+fall back to a local database if the remote service is unavailable.
+
+When an explicitly trusted Agent credential uses `trustActorRefs: true`, the
+runtime must set `PROJECT_SERVICE_ACTOR_REF` to the current verified actor JSON
+(e.g. `{"userId":"..."}`) for CLI bridge operations which need a user. A bound
+actor credential does not need this variable. The service validates that actor
+is active and rejects a conflicting actor in the command input.

project_agent_client-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "project-agent-client"
+version = "0.1.0"
+description = "Remote Project Agent command-line client"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
+
+[project.scripts]
+project-agent = "project_agent_client.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+project_agent_client = ["help.json"]

project_agent_client-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

project_agent_client-0.1.0/src/project_agent_client/__init__.py

@@ -0,0 +1 @@
+"""Client for the Project Backend Service."""

project_agent_client-0.1.0/src/project_agent_client/cli.py

@@ -0,0 +1,170 @@
+"""Forward supported Project Agent commands to the backend service."""
+
+import argparse
+from importlib import metadata, resources
+import json
+import os
+from pathlib import Path
+import sys
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlsplit
+from urllib.request import HTTPRedirectHandler, Request, build_opener
+
+
+class _NoRedirect(HTTPRedirectHandler):
+    def redirect_request(self, req, fp, code, msg, headers, newurl):
+        return None
+
+
+def _open_url(request, timeout):
+    return build_opener(_NoRedirect()).open(request, timeout=timeout)
+
+
+def _failure(code: str, message: str) -> dict:
+    return {"status": "failed", "results": [{"operationId": "request", "action": "transport", "status": "failed", "error": {"code": code, "message": message}}]}
+
+
+_SCENES = {"task": ("apply", "maintain"), "query": ("apply",),
+           "sprint": ("apply", "rollover"), "proposal": ("apply",),
+           "quest": ("publish-task", "sync-task", "status", "pending", "reconcile-task-create")}
+_ENDPOINTS = {"task": "tasks", "query": "query", "sprint": "sprints", "proposal": "proposals", "quest": "quest"}
+_BRIDGE = {
+    ("attribute", "apply"), ("onboarding", "apply"),
+    *(("bootstrap", name) for name in ("apply", "init", "record-loop-result", "checkpoint", "loop-state", "mark")),
+    *(("context", name) for name in ("resolve-group", "resolve-binding", "project-binding", "list-relationships", "resolve-user", "search-user", "get-user", "add-project-member", "set-project-owner", "upsert-user-identity")),
+    *(("doc-hub", name) for name in ("set-provider", "bind-space", "bind-root", "get-root", "register", "sync-manifest", "remove", "classify", "relate", "read", "propose-updates", "index")),
+    *(("doc-hub", "access", name) for name in ("target", "record", "plan")),
+    *(("meeting", name) for name in ("save", "parse-time")),
+    *(("meeting", "tasks", name) for name in ("pending", "plan", "placement", "run", "resume")),
+    *(("report", name) for name in ("apply", "build")),
+    *(("monitoring", name) for name in ("plan", "run", "evaluate-followups")),
+    ("scheduled", "run"), ("mind", "read"),
+    *(("loop", name) for name in ("list", "record-result", "enqueue-bootstrap")),
+}
+_INLINE_JSON_FLAGS = {"--payload-json", "--default-policy-json", "--manifest-json", "--content-json"}
+_TIMEOUT_SECONDS = 200  # The service allows up to 180 seconds; never auto-retry a write.
+_MAX_INLINE_BYTES = 4 * 1024 * 1024
+
+
+def _command(argv):
+    # Longest matching fixed path wins (e.g. meeting tasks plan).
+    for command in sorted(_BRIDGE, key=len, reverse=True):
+        if tuple(argv[:len(command)]) == command:
+            return command, argv[len(command):]
+    return None, []
+
+
+def _inline_file_arguments(arguments):
+    """Read legacy JSON-file options on the client, never on the server."""
+    output = list(arguments)
+    for index, token in enumerate(output):
+        option, sep, value = token.partition('=')
+        if option not in _INLINE_JSON_FLAGS:
+            continue
+        target = index if sep else index + 1
+        if target >= len(output):
+            continue
+        raw = value if sep else output[target]
+        if raw.lstrip().startswith(('{', '[')):
+            continue
+        path = Path(raw).expanduser()
+        if path.is_file():
+            if path.stat().st_size > _MAX_INLINE_BYTES:
+                raise ValueError('JSON input file is too large')
+            content = path.read_text(encoding='utf-8')
+            output[target] = option + '=' + content if sep else content
+    return output
+
+
+def run(argv: list[str], stdin, stdout, environ, open_url=_open_url, stderr=None) -> int:
+    stderr = stderr if stderr is not None else sys.stderr
+    if argv == ['--version']:
+        try:
+            version = metadata.version('project-agent-client')
+        except metadata.PackageNotFoundError:
+            version = '0.1.0'
+        stdout.write(version + '\n')
+        return 0
+    if argv and argv[-1] == '--help':
+        command_name = ' '.join(argv[:-1])
+        if not command_name:
+            names = sorted(set(_SCENES) | {command[0] for command in _BRIDGE})
+            stdout.write('Usage: project-agent [OPTIONS] COMMAND [ARGS]...\n\nCommands: ' + ', '.join(names) + '\n')
+            return 0
+        if command_name == 'quest':
+            stdout.write('Usage: project-agent quest COMMAND [ARGS]...\n\nCommands: publish-task, sync-task, status, pending, reconcile-task-create\n')
+            return 0
+        if command_name in {'quest publish-task', 'quest sync-task', 'quest status', 'quest pending', 'quest reconcile-task-create'}:
+            stdout.write('Usage: project-agent ' + command_name + ' --input @-\n')
+            return 0
+        catalog = json.loads(resources.files('project_agent_client').joinpath('help.json').read_text(encoding='utf-8'))
+        if command_name in catalog:
+            stdout.write(catalog[command_name])
+            return 0
+    command, arguments = _command(argv)
+    is_bridge = command is not None
+    if not is_bridge:
+        parser = argparse.ArgumentParser(prog="project-agent")
+        commands = parser.add_subparsers(dest="command", required=True)
+        for name, supported_actions in _SCENES.items():
+            subparser = commands.add_parser(name)
+            actions = subparser.add_subparsers(dest="action", required=True)
+            for action in supported_actions:
+                subcommand = actions.add_parser(action)
+                subcommand.add_argument("--input", required=True, choices=["@-"])
+        args = parser.parse_args(argv)
+
+    base_url = environ.get("PROJECT_SERVICE_URL", "").strip().rstrip("/")
+    token = environ.get("PROJECT_SERVICE_TOKEN", "").strip()
+    try:
+        parsed = urlsplit(base_url)
+        valid_url = (parsed.scheme == "https" or (parsed.scheme == "http" and parsed.hostname in {"127.0.0.1", "localhost", "::1"})) and bool(parsed.netloc) and not (parsed.username or parsed.password or parsed.query or parsed.fragment)
+    except ValueError:
+        valid_url = False
+    if not valid_url or not token:
+        receipt = _failure("service_configuration_error", "Project service URL or token is not configured.")
+    else:
+        try:
+            if is_bridge:
+                arguments = _inline_file_arguments(arguments)
+                # Most legacy commands do not read stdin. Avoid blocking the caller.
+                wants_stdin = any(item == '--input' or item.startswith('--input=') for item in arguments)
+                body = {"command": list(command), "arguments": arguments, "stdin": stdin.read() if wants_stdin else ''}
+                if environ.get('PROJECT_SERVICE_ACTOR_REF', '').strip():
+                    body['actorRef'] = json.loads(environ['PROJECT_SERVICE_ACTOR_REF'])
+                path = '/v1/cli/execute'
+            else:
+                body = json.loads(stdin.read())
+                path = f"/v1/{_ENDPOINTS[args.command]}/{args.action}"
+            payload = json.dumps(body, ensure_ascii=False).encode("utf-8")
+        except (ValueError, UnicodeError, OSError):
+            receipt = _failure("cli_contract_mismatch", "Input is invalid or a local input file could not be read.")
+        else:
+            request = Request(base_url + path, data=payload, method="POST", headers={"Authorization": "Bearer " + token, "Content-Type": "application/json", "Accept": "application/json"})
+            try:
+                with open_url(request, timeout=_TIMEOUT_SECONDS) as response:
+                    receipt = json.load(response)
+                if is_bridge:
+                    if not isinstance(receipt, dict) or not isinstance(receipt.get('stdout'), str) or not isinstance(receipt.get('stderr'), str) or type(receipt.get('exitCode')) is not int:
+                        receipt = _failure("invalid_service_response", "Project service returned an invalid command result.")
+                    else:
+                        stdout.write(receipt['stdout'])
+                        stderr.write(receipt['stderr'])
+                        return receipt['exitCode']
+                else:
+                    valid_statuses = {"ok", "clarification_required", "failed", "partial_success"}
+                    if not isinstance(receipt, dict) or (args.action != "maintain" and receipt.get("status") not in valid_statuses) or (args.action == "maintain" and not isinstance(receipt.get("status"), str)):
+                        receipt = _failure("invalid_service_response", "Project service returned an invalid receipt.")
+            except HTTPError as exc:
+                receipt = _failure("service_request_rejected", f"Project service rejected the request (HTTP {exc.code}).")
+            except (URLError, TimeoutError, OSError, ValueError):
+                receipt = _failure("service_unavailable", "Project service could not be reached or returned an invalid response; the write outcome may be unknown.")
+
+    stdout.write(json.dumps(receipt, ensure_ascii=False) + "\n")
+    if not is_bridge and args.action == "maintain" and receipt.get("status") != "failed":
+        return 0
+    return {"ok": 0, "clarification_required": 2}.get(receipt.get("status"), 1)
+
+
+def main() -> None:
+    raise SystemExit(run(sys.argv[1:], sys.stdin, sys.stdout, os.environ))

project_agent_client-0.1.0/src/project_agent_client/help.json

@@ -0,0 +1,75 @@
+{
+  "attribute": "                                                                                \n Usage: project-agent attribute [OPTIONS] COMMAND [ARGS]...                     \n                                                                                \n 发现、读取和更新所有业务实体的扩展属性。                                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply                                                                        │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "attribute apply": "                                                                                \n Usage: project-agent attribute apply [OPTIONS]                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  [required]                                          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap": "                                                                                \n Usage: project-agent bootstrap [OPTIONS] COMMAND [ARGS]...                     \n                                                                                \n 初始化项目、Owner、项目群 binding 和参与人等基础数据。                         \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply               一次完成 bootstrap init/ack、ledger 写入和下一           │\n│                     checkpoint 读取。                                        │\n│ init                创建项目基础记录，并可同时写入项目群 binding             │\n│                     与初始参与人。                                           │\n│ record-loop-result  记录一次 bootstrap loop 动作的 success/failed/skipped    │\n│                     结果；仅作复盘和下次 loop-state 诊断，不决定业务下一步。 │\n│ checkpoint          读取并校准 bootstrap                                     │\n│                     阶段状态：返回群绑定、对齐字段缺口、引导/确认消息落账和… │\n│ loop-state          读取 bootstrap checkpoint，登记本轮 loop attempt，并返 … │\n│                     stuck/blocker 诊断；下一步动作仍由                       │\n│                     project-lifecycle-manager skill 发起。                   │\n│ mark                登记 bootstrap 里程碑消息已发出（alignment_intro_sent /  │\n│                     execution_confirmation_sent / kickoff_sent），并返回最 … │\n│                     checkpoint。                                             │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap apply": "                                                                                \n Usage: project-agent bootstrap apply [OPTIONS]                                 \n                                                                                \n 一次完成 bootstrap init/ack、ledger 写入和下一 checkpoint 读取。               \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap checkpoint": "                                                                                \n Usage: project-agent bootstrap checkpoint [OPTIONS]                            \n                                                                                \n 读取并校准 bootstrap                                                           \n 阶段状态：返回群绑定、对齐字段缺口、引导/确认消息落账和下一步动作。            \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap init": "                                                                                \n Usage: project-agent bootstrap init [OPTIONS]                                  \n                                                                                \n 创建项目基础记录，并可同时写入项目群 binding 与初始参与人。                    \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id                 <str>  项目内部 canonical                    │\n│                                        projectId。不要直接传群 ID 或外部文 … │\n│                                        ID；只有外部信号时先用 context        │\n│                                        命令解析。                            │\n│                                        [required]                            │\n│ *  --project-name               <str>  项目展示名。写入 project 基础信息。   │\n│                                        [required]                            │\n│ *  --owner-user-id              <str>  项目 Owner 的内部 userId。 [required] │\n│ *  --primary-goal               <str>  项目当前主目标，用于 Project Mind     │\n│                                        和文档初始内容。                      │\n│                                        [required]                            │\n│    --target-release-date        <str>  目标发布日期，格式 YYYY-MM-DD。       │\n│    --timezone                   <str>  项目默认时区，未显式传入时默认        │\n│                                        Asia/Shanghai。                       │\n│                                        [default: Asia/Shanghai]              │\n│    --channel                    <str>  聊天/消息渠道名，例如 feishu 或       │\n│                                        magic-campus。用于 binding            │\n│                                        解析和来源边界校验；文档平台请用      │\n│                                        --provider。                          │\n│    --project-group-id           <str>  要绑定的项目群 ID。传入后会按 channe… │\n│                                        规则写入 project_group binding。      │\n│    --participant-user-id        <str>  额外参与人 userId。可重复传多次。     │\n│    --help                              Show this message and exit.           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap loop-state": "                                                                                \n Usage: project-agent bootstrap loop-state [OPTIONS]                            \n                                                                                \n 读取 bootstrap checkpoint，登记本轮 loop attempt，并返回 stuck/blocker         \n 诊断；下一步动作仍由 project-lifecycle-manager skill 发起。                    \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id             <str>  项目内部 canonical                        │\n│                                    projectId。不要直接传群 ID 或外部文档     │\n│                                    ID；只有外部信号时先用 context 命令解析。 │\n│                                    [required]                                │\n│    --stuck-threshold        <int>  同一 nextAction 被 loop-state             │\n│                                    看到多少次后判定 stuck。                  │\n│                                    [default: 3]                              │\n│    --help                          Show this message and exit.               │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap mark": "                                                                                \n Usage: project-agent bootstrap mark [OPTIONS]                                  \n                                                                                \n 登记 bootstrap 里程碑消息已发出（alignment_intro_sent /                        \n execution_confirmation_sent / kickoff_sent），并返回最新 checkpoint。          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│ *  --milestone         <str>  已发出的里程碑消息：alignment_intro_sent /     │\n│                               execution_confirmation_sent / kickoff_sent。   │\n│                               [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "bootstrap record-loop-result": "                                                                                \n Usage: project-agent bootstrap record-loop-result [OPTIONS]                    \n                                                                                \n 记录一次 bootstrap loop 动作的 success/failed/skipped 结果；仅作复盘和下次     \n loop-state 诊断，不决定业务下一步。                                            \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id          <str>  项目内部 canonical projectId。不要直接传群   │\n│                                 ID 或外部文档 ID；只有外部信号时先用 contex… │\n│                                 命令解析。                                   │\n│                                 [required]                                   │\n│ *  --next-action         <str>  本次执行对应的 checkpoint nextAction。       │\n│                                 [required]                                   │\n│ *  --outcome             <str>  执行结果：success / failed / skipped。       │\n│                                 [required]                                   │\n│    --stage               <str>  执行阶段，例如 provider_write / fetch_verif… │\n│                                 / mark。                                     │\n│    --reason              <str>  执行结果的简短原因。                         │\n│    --details-json        <str>  可选结构化细节 JSON。                        │\n│    --help                       Show this message and exit.                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context": "                                                                                \n Usage: project-agent context [OPTIONS] COMMAND [ARGS]...                       \n                                                                                \n 做群绑定、成员/身份管理和项目上下文解析；项目事实读取走 query apply。          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ resolve-group         按群 ID                                                │\n│                       查询绑定到哪个项目，常用于把外部群信号解析成内部       │\n│                       projectId。                                            │\n│ resolve-binding       按来源信号组合解析 binding，适合已有 chat-id 或        │\n│                       subject 的场景。                                       │\n│ project-binding       按项目 ID 读取项目绑定的群/会话信息。                  │\n│ list-relationships    读取项目当前关系；传 --include-closed                  │\n│                       可查询历史关闭关系。                                   │\n│ resolve-user          把外部用户标识解析成内部 userId。                      │\n│ search-user           按本地展示名或已保存身份资料模糊搜索内部用户；只查本 … │\n│ get-user              读取内部用户及其外部身份映射。                         │\n│ add-project-member    把一个内部 userId 添加为项目 active member。           │\n│ set-project-owner     设置项目 Owner；无现任 Owner 时可接受历史提名。        │\n│ upsert-user-identity  写入或更新外部身份与内部 userId 的映射。               │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context add-project-member": "                                                                                \n Usage: project-agent context add-project-member [OPTIONS]                      \n                                                                                \n 把一个内部 userId 添加为项目 active member。                                   \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│    --project-id        <str>  目标项目的 canonical projectId。               │\n│    --channel           <str>  聊天/消息渠道名，例如 feishu 或                │\n│                               magic-campus。用于 binding                     │\n│                               解析和来源边界校验；文档平台请用 --provider。  │\n│    --group-id          <str>  群聊 ID 信号。用于 resolve-group 或            │\n│                               project_group 边界校验，不是内部 projectId。   │\n│ *  --user-id           <str>  要加入项目的内部 canonical userId。 [required] │\n│    --attributes        <str>  扩展属性 JSON 数组；未知属性会自动创建。       │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context get-user": "                                                                                \n Usage: project-agent context get-user [OPTIONS]                                \n                                                                                \n 读取内部用户及其外部身份映射。                                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --user-id           <str>  内部 canonical userId。 [required]             │\n│    --project-id        <str>  提供项目作用域时返回该项目内的用户扩展属性。   │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context list-relationships": "                                                                                \n Usage: project-agent context list-relationships [OPTIONS]                      \n                                                                                \n 读取项目当前关系；传 --include-closed 可查询历史关闭关系。                     \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id            <str>  项目内部 canonical projectId。不要直接传 … │\n│                                   ID 或外部文档 ID；只有外部信号时先用       │\n│                                   context 命令解析。                         │\n│                                   [required]                                 │\n│    --include-closed               同时返回已关闭的历史关系。                 │\n│    --source-kind           <str>  调用来源类型。传 project_group             │\n│                                   时会启用来源群与 projectId 的边界校验。    │\n│    --channel               <str>  聊天/消息渠道名，例如 feishu 或            │\n│                                   magic-campus。用于 binding                 │\n│                                   解析和来源边界校验；文档平台请用           │\n│                                   --provider。                               │\n│    --delivery-to           <str>  来源投递目标标识。和 chat-id / subject /   │\n│                                   group-id 一起参与 project_group binding    │\n│                                   解析。                                     │\n│    --chat-id               <str>  聊天会话 ID。Feishu 项目群常见值为 oc_xxx  │\n│                                   或 chat:oc_xxx；CLI 会按既有规则做规范化。 │\n│    --subject               <str>  来源主体 ID，例如会话主体或用户主体。仅在  │\n│                                   binding 解析需要该信号时传入。             │\n│    --group-id              <str>  群聊 ID 信号。用于 resolve-group 或        │\n│                                   project_group 边界校验，不是内部           │\n│                                   projectId。                                │\n│    --help                         Show this message and exit.                │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context project-binding": "                                                                                \n Usage: project-agent context project-binding [OPTIONS]                         \n                                                                                \n 按项目 ID 读取项目绑定的群/会话信息。                                          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id         <str>  项目内部 canonical projectId。不要直接传群 I… │\n│                                或外部文档 ID；只有外部信号时先用 context     │\n│                                命令解析。                                    │\n│                                [required]                                    │\n│    --source-kind        <str>  调用来源类型。传 project_group                │\n│                                时会启用来源群与 projectId 的边界校验。       │\n│    --channel            <str>  聊天/消息渠道名，例如 feishu 或               │\n│                                magic-campus。用于 binding                    │\n│                                解析和来源边界校验；文档平台请用 --provider。 │\n│    --delivery-to        <str>  来源投递目标标识。和 chat-id / subject /      │\n│                                group-id 一起参与 project_group binding       │\n│                                解析。                                        │\n│    --chat-id            <str>  聊天会话 ID。Feishu 项目群常见值为 oc_xxx 或  │\n│                                chat:oc_xxx；CLI 会按既有规则做规范化。       │\n│    --subject            <str>  来源主体 ID，例如会话主体或用户主体。仅在     │\n│                                binding 解析需要该信号时传入。                │\n│    --group-id           <str>  群聊 ID 信号。用于 resolve-group 或           │\n│                                project_group 边界校验，不是内部 projectId。  │\n│    --help                      Show this message and exit.                   │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context resolve-binding": "                                                                                \n Usage: project-agent context resolve-binding [OPTIONS]                         \n                                                                                \n 按来源信号组合解析 binding，适合已有 chat-id 或 subject 的场景。               \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --channel             <str>  聊天/消息渠道名，例如 feishu 或                 │\n│                              magic-campus。用于 binding                      │\n│                              解析和来源边界校验；文档平台请用 --provider。   │\n│                              [default: feishu]                               │\n│ --binding-kind        <str>  binding 类型。常见值为 project_group。          │\n│ --delivery-to         <str>  来源投递目标标识。和 chat-id / subject /        │\n│                              group-id 一起参与 project_group binding 解析。  │\n│ --chat-id             <str>  聊天会话 ID。Feishu 项目群常见值为 oc_xxx 或    │\n│                              chat:oc_xxx；CLI 会按既有规则做规范化。         │\n│ --subject             <str>  来源主体 ID，例如会话主体或用户主体。仅在       │\n│                              binding 解析需要该信号时传入。                  │\n│ --group-id            <str>  群聊 ID 信号。用于 resolve-group 或             │\n│                              project_group 边界校验，不是内部 projectId。    │\n│ --help                       Show this message and exit.                     │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context resolve-group": "                                                                                \n Usage: project-agent context resolve-group [OPTIONS]                           \n                                                                                \n 按群 ID 查询绑定到哪个项目，常用于把外部群信号解析成内部 projectId。           \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --group-id            <str>  外部群 ID，例如 Feishu 的 oc_xxx 或          │\n│                                 chat:oc_xxx。                                │\n│                                 [required]                                   │\n│    --channel             <str>  聊天/消息渠道名，例如 feishu 或              │\n│                                 magic-campus。用于 binding                   │\n│                                 解析和来源边界校验；文档平台请用             │\n│                                 --provider。                                 │\n│                                 [default: feishu]                            │\n│    --binding-kind        <str>  binding 类型。留空时按命令默认解析，常见为   │\n│                                 project_group。                              │\n│    --help                       Show this message and exit.                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context resolve-user": "                                                                                \n Usage: project-agent context resolve-user [OPTIONS]                            \n                                                                                \n 把外部用户标识解析成内部 userId。                                              \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --channel                    <str>  聊天/消息渠道名，例如 feishu 或       │\n│                                        magic-campus。用于 binding            │\n│                                        解析和来源边界校验；文档平台请用      │\n│                                        --provider。                          │\n│                                        [required]                            │\n│ *  --external-subject-id        <str>  外部平台上的用户主体 ID，例如         │\n│                                        open_id。                             │\n│                                        [required]                            │\n│    --help                              Show this message and exit.           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context search-user": "                                                                                \n Usage: project-agent context search-user [OPTIONS]                             \n                                                                                \n 按本地展示名或已保存身份资料模糊搜索内部用户；只查本地数据，只读，不写库。     \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --channel        <str>  聊天/消息渠道名，例如 feishu 或                   │\n│                            magic-campus。用于 binding                        │\n│                            解析和来源边界校验；文档平台请用 --provider。     │\n│                            [required]                                        │\n│ *  --query          <str>  本地搜索文本，例如姓名、昵称、别名、邮箱或手机号… │\n│                            [required]                                        │\n│    --help                  Show this message and exit.                       │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context set-project-owner": "                                                                                \n Usage: project-agent context set-project-owner [OPTIONS]                       \n                                                                                \n 设置项目 Owner；无现任 Owner 时可接受历史提名。                                \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id           <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│                                  [required]                                  │\n│ *  --user-id              <str>  目标 Owner 的 canonical userId。 [required] │\n│ *  --actor-user-id        <str>  执行这次正式写操作的内部 userId。需要审计 … │\n│                                  owner 校验的命令应显式传入。                │\n│                                  [required]                                  │\n│    --accept                      以被提名用户身份接受无现任 Owner            │\n│                                  时创建的提名。                              │\n│    --source-kind          <str>  调用来源类型。传 project_group              │\n│                                  时会启用来源群与 projectId 的边界校验。     │\n│    --channel              <str>  聊天/消息渠道名，例如 feishu 或             │\n│                                  magic-campus。用于 binding                  │\n│                                  解析和来源边界校验；文档平台请用            │\n│                                  --provider。                                │\n│    --delivery-to          <str>  来源投递目标标识。和 chat-id / subject /    │\n│                                  group-id 一起参与 project_group binding     │\n│                                  解析。                                      │\n│    --chat-id              <str>  聊天会话 ID。Feishu 项目群常见值为 oc_xxx   │\n│                                  或 chat:oc_xxx；CLI 会按既有规则做规范化。  │\n│    --subject              <str>  来源主体 ID，例如会话主体或用户主体。仅在   │\n│                                  binding 解析需要该信号时传入。              │\n│    --group-id             <str>  群聊 ID 信号。用于 resolve-group 或         │\n│                                  project_group 边界校验，不是内部            │\n│                                  projectId。                                 │\n│    --help                        Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "context upsert-user-identity": "                                                                                \n Usage: project-agent context upsert-user-identity [OPTIONS]                    \n                                                                                \n 写入或更新外部身份与内部 userId 的映射。                                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --channel                    <str>  聊天/消息渠道名，例如 feishu 或       │\n│                                        magic-campus。用于 binding            │\n│                                        解析和来源边界校验；文档平台请用      │\n│                                        --provider。                          │\n│                                        [required]                            │\n│ *  --external-subject-id        <str>  外部平台上的用户主体 ID，例如         │\n│                                        open_id。                             │\n│                                        [required]                            │\n│ *  --display-name               <str>  展示名。 [required]                   │\n│    --user-id                    <str>  已有内部                              │\n│                                        userId。留空时由后端分配或复用。      │\n│    --profile-json               <str>  额外身份资料 JSON 字符串。            │\n│    --help                              Show this message and exit.           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub": "                                                                                \n Usage: project-agent doc-hub [OPTIONS] COMMAND [ARGS]...                       \n                                                                                \n 管理 Doc Hub 根节点、空间和文档条目。                                          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ set-provider  经用户二次确认后切换新文档默认平台；不迁移已有文档。           │\n│ bind-space    把项目绑定到某个外部文档空间。                                 │\n│ bind-root     配置某个 provider 的 Doc Hub 根节点。                          │\n│ get-root      读取某个 provider 当前配置的 Doc Hub 根节点。                  │\n│ register      注册一条外部文档记录到 Doc Hub。                               │\n│ remove        从 Doc Hub 索引移除文档条目，不删除外部文件。                  │\n│ classify      给 Doc Hub 条目设置逻辑类型。                                  │\n│ relate        为两个 Doc Hub 条目建立关系。                                  │\n│ index         构建项目的 Doc Hub 索引视图。                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub access": "                                                                                \n Usage: project-agent doc-hub access [OPTIONS] COMMAND [ARGS]...                \n                                                                                \n 管理项目文档空间访问授权记录。                                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ target  解析项目成员对应的文档空间授权目标。                                 │\n│ record  记录一次远端文档空间权限检查或授权结果。                             │\n│ plan    列出需要运行时逐个检查 Drive 权限的项目成员。                        │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub access plan": "                                                                                \n Usage: project-agent doc-hub access plan [OPTIONS]                             \n                                                                                \n 列出需要运行时逐个检查 Drive 权限的项目成员。                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│    --provider          <str>  外部文档平台 provider，例如 feishu 或          │\n│                               google-drive。用于文档与 doc-hub 归属；doc-hu… │\n│                               register/sync-manifest                         │\n│                               未传时沿用已登记同一文档的 provider，否则与    │\n│                               bind-space                                     │\n│                               一样使用项目默认平台；其他命令按各自默认值。   │\n│                               [default: feishu]                              │\n│ *  --channel           <str>  聊天/消息渠道名，例如 feishu 或                │\n│                               magic-campus。用于 binding                     │\n│                               解析和来源边界校验；文档平台请用 --provider。  │\n│                               [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub access record": "                                                                                \n Usage: project-agent doc-hub access record [OPTIONS]                           \n                                                                                \n 记录一次远端文档空间权限检查或授权结果。                                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id                 <str>  项目内部 canonical                    │\n│                                        projectId。不要直接传群 ID 或外部文 … │\n│                                        ID；只有外部信号时先用 context        │\n│                                        命令解析。                            │\n│                                        [required]                            │\n│    --provider                   <str>  外部文档平台 provider，例如 feishu  … │\n│                                        google-drive。用于文档与 doc-hub      │\n│                                        归属；doc-hub register/sync-manifest  │\n│                                        未传时沿用已登记同一文档的            │\n│                                        provider，否则与 bind-space           │\n│                                        一样使用项目默认平台；其他命令按各自… │\n│                                        [default: feishu]                     │\n│ *  --external-space-id          <str>  provider 侧空间或目录 ID。 [required] │\n│ *  --principal-email            <str>  Google Drive 权限目标 email。         │\n│                                        [required]                            │\n│    --role                       <str>  目标权限角色，默认 writer。           │\n│                                        [default: writer]                     │\n│ *  --status                     <str>  granted、already_writer、upgraded 或  │\n│                                        failed。                              │\n│                                        [required]                            │\n│ *  --channel                    <str>  聊天/消息渠道名，例如 feishu 或       │\n│                                        magic-campus。用于 binding            │\n│                                        解析和来源边界校验；文档平台请用      │\n│                                        --provider。                          │\n│                                        [required]                            │\n│ *  --external-subject-id        <str>  渠道侧用户唯一 ID。 [required]        │\n│    --user-id                    <str>  Project Agent 内部 userId。           │\n│    --principal-type             <str>  授权主体类型，默认 user。             │\n│                                        [default: user]                       │\n│    --permission-id              <str>  provider 侧 permission ID。           │\n│    --last-error                 <str>  失败原因。                            │\n│    --payload-json               <str>  provider-neutral 授权细节 JSON        │\n│                                        或文件路径。                          │\n│    --help                              Show this message and exit.           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub access target": "                                                                                \n Usage: project-agent doc-hub access target [OPTIONS]                           \n                                                                                \n 解析项目成员对应的文档空间授权目标。                                           \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id                 <str>  项目内部 canonical                    │\n│                                        projectId。不要直接传群 ID 或外部文 … │\n│                                        ID；只有外部信号时先用 context        │\n│                                        命令解析。                            │\n│                                        [required]                            │\n│    --provider                   <str>  外部文档平台 provider，例如 feishu  … │\n│                                        google-drive。用于文档与 doc-hub      │\n│                                        归属；doc-hub register/sync-manifest  │\n│                                        未传时沿用已登记同一文档的            │\n│                                        provider，否则与 bind-space           │\n│                                        一样使用项目默认平台；其他命令按各自… │\n│                                        [default: feishu]                     │\n│ *  --channel                    <str>  聊天/消息渠道名，例如 feishu 或       │\n│                                        magic-campus。用于 binding            │\n│                                        解析和来源边界校验；文档平台请用      │\n│                                        --provider。                          │\n│                                        [required]                            │\n│ *  --external-subject-id        <str>  渠道侧用户唯一 ID。 [required]        │\n│    --help                              Show this message and exit.           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub bind-root": "                                                                                \n Usage: project-agent doc-hub bind-root [OPTIONS]                               \n                                                                                \n 配置某个 provider 的 Doc Hub 根节点。                                          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --provider                   <str>  外部文档平台 provider，例如 feishu 或    │\n│                                     google-drive。用于文档与 doc-hub         │\n│                                     归属；doc-hub register/sync-manifest     │\n│                                     未传时沿用已登记同一文档的               │\n│                                     provider，否则与 bind-space              │\n│                                     一样使用项目默认平台；其他命令按各自默 … │\n│                                     [default: feishu]                        │\n│ --external-root-id           <str>  外部平台上的根节点 ID。                  │\n│ --url                        <str>  根节点链接。                             │\n│ --status                     <str>  根节点绑定状态，默认 active。            │\n│                                     [default: active]                        │\n│ --default-policy-json        <str>  根节点默认策略 JSON 或 JSON 文件路径。   │\n│ --help                              Show this message and exit.              │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub bind-space": "                                                                                \n Usage: project-agent doc-hub bind-space [OPTIONS]                              \n                                                                                \n 把项目绑定到某个外部文档空间。                                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id               <str>  项目内部 canonical                      │\n│                                      projectId。不要直接传群 ID 或外部文档   │\n│                                      ID；只有外部信号时先用 context          │\n│                                      命令解析。                              │\n│                                      [required]                              │\n│    --provider                 <str>  外部文档平台 provider，例如 feishu 或   │\n│                                      google-drive。用于文档与 doc-hub        │\n│                                      归属；doc-hub register/sync-manifest    │\n│                                      未传时沿用已登记同一文档的              │\n│                                      provider，否则与 bind-space             │\n│                                      一样使用项目默认平台；其他命令按各自默… │\n│    --external-space-id        <str>  外部平台上的空间 ID。                   │\n│    --url                      <str>  外部空间链接。                          │\n│    --status                   <str>  绑定状态，默认 active。                 │\n│                                      [default: active]                       │\n│    --payload-json             <str>  provider-neutral 空间扩展信息 JSON      │\n│                                      或文件路径，例如 logicalTypeFolders     │\n│                                      子目录映射；省略时保留已有 payload。    │\n│    --attributes               <str>  扩展属性 JSON                           │\n│                                      数组；未知属性会自动创建。              │\n│    --help                            Show this message and exit.             │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub classify": "                                                                                \n Usage: project-agent doc-hub classify [OPTIONS]                                \n                                                                                \n 给 Doc Hub 条目设置逻辑类型。                                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id          <str>  项目内部 canonical projectId。不要直接传群   │\n│                                 ID 或外部文档 ID；只有外部信号时先用 contex… │\n│                                 命令解析。                                   │\n│                                 [required]                                   │\n│ *  --entry-id            <str>  Doc Hub entryId。 [required]                 │\n│ *  --logical-type        <str>  目标逻辑分类，例如 project_planning /        │\n│                                 decision_meeting。                           │\n│                                 [required]                                   │\n│    --provider            <str>  外部文档平台 provider，例如 feishu 或        │\n│                                 google-drive。用于文档与 doc-hub             │\n│                                 归属；doc-hub register/sync-manifest         │\n│                                 未传时沿用已登记同一文档的 provider，否则与  │\n│                                 bind-space                                   │\n│                                 一样使用项目默认平台；其他命令按各自默认值。 │\n│    --help                       Show this message and exit.                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub get-root": "                                                                                \n Usage: project-agent doc-hub get-root [OPTIONS]                                \n                                                                                \n 读取某个 provider 当前配置的 Doc Hub 根节点。                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --provider        <str>  外部文档平台 provider，例如 feishu 或               │\n│                          google-drive。用于文档与 doc-hub 归属；doc-hub      │\n│                          register/sync-manifest 未传时沿用已登记同一文档的   │\n│                          provider，否则与 bind-space                         │\n│                          一样使用项目默认平台；其他命令按各自默认值。        │\n│                          [default: feishu]                                   │\n│ --help                   Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub index": "                                                                                \n Usage: project-agent doc-hub index [OPTIONS]                                   \n                                                                                \n 构建项目的 Doc Hub 索引视图。                                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --project-id              <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│ --channel-group-id        <str>  MagicCampus 项目群 ID。未传 --project-id    │\n│                                  时用它反查项目；聊天渠道默认 magic-campus。 │\n│ --provider                <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│ --help                           Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub propose-updates": "                                                                                \n Usage: project-agent doc-hub propose-updates [OPTIONS]                         \n                                                                                \n 根据某次文档阅读结果生成待审批更新 Proposal。                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id           <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│                                  [required]                                  │\n│ *  --read-id              <str>  doc-hub read 返回的 readId。 [required]     │\n│    --actor-user-id        <str>  执行这次正式写操作的内部 userId。需要审计 … │\n│                                  owner 校验的命令应显式传入。                │\n│    --provider             <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│    --help                        Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub read": "                                                                                \n Usage: project-agent doc-hub read [OPTIONS]                                    \n                                                                                \n 记录一次外部文档阅读结果，供后续生成 Proposal。                                \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id               <str>  项目内部 canonical                      │\n│                                      projectId。不要直接传群 ID 或外部文档   │\n│                                      ID；只有外部信号时先用 context          │\n│                                      命令解析。                              │\n│                                      [required]                              │\n│ *  --entry-id                 <str>  要记录读取结果的 Doc Hub entryId。      │\n│                                      [required]                              │\n│ *  --content-json             <str>  JSON 字符串或文件路径；必须是对象。     │\n│                                      [required]                              │\n│    --provider-revision        <str>  外部平台的文档版本号或 revision 标识。  │\n│    --provider                 <str>  外部文档平台 provider，例如 feishu 或   │\n│                                      google-drive。用于文档与 doc-hub        │\n│                                      归属；doc-hub register/sync-manifest    │\n│                                      未传时沿用已登记同一文档的              │\n│                                      provider，否则与 bind-space             │\n│                                      一样使用项目默认平台；其他命令按各自默… │\n│    --help                            Show this message and exit.             │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub register": "                                                                                \n Usage: project-agent doc-hub register [OPTIONS]                                \n                                                                                \n 注册一条外部文档记录到 Doc Hub。                                               \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id                  <str>  项目内部 canonical                   │\n│                                         projectId。不要直接传群 ID           │\n│                                         或外部文档 ID；只有外部信号时先用    │\n│                                         context 命令解析。                   │\n│                                         [required]                           │\n│ *  --title                       <str>  文档标题，用于 Doc Hub 展示和索引。  │\n│                                         [required]                           │\n│ *  --doc-kind                    <str>  文档类型，例如 user_document。       │\n│                                         [required]                           │\n│    --provider                    <str>  外部文档平台 provider，例如 feishu   │\n│                                         或 google-drive。用于文档与 doc-hub  │\n│                                         归属；doc-hub register/sync-manifes… │\n│                                         未传时沿用已登记同一文档的           │\n│                                         provider，否则与 bind-space          │\n│                                         一样使用项目默认平台；其他命令按各 … │\n│    --logical-type                <str>  逻辑分类，例如 project_planning /    │\n│                                         decision_meeting。留空时由后端按     │\n│                                         doc_kind/title 推断。                │\n│    --source-logical-type         <str>  由 provider                          │\n│                                         目录位置解析出的逻辑分类；优先级高 … │\n│    --parent-folder-id            <str>  文档所在 provider 父目录 ID，用于    │\n│                                         Doc Hub 目录同步和排障。             │\n│    --folder-path                 <str>  文档所在 provider 目录路径，用于 Do… │\n│                                         Hub 目录同步和排障。                 │\n│    --document-source-kind        <str>  文档来源类型，例如 user_provided 或  │\n│                                         agent_generated。                    │\n│                                         [default: user_provided]             │\n│    --external-doc-id             <str>  外部平台文档 ID。                    │\n│    --url                         <str>  外部文档访问链接。                   │\n│    --document-id                 <str>  本地                                 │\n│                                         project_documents.documentId；系统 … │\n│    --sprint-id                   <str>  目标 Sprint 的 canonical             │\n│                                         sprintId。留空时通常表示当前         │\n│                                         Sprint，具体以命令契约为准。         │\n│    --entry-key                   <str>  调用方提供的幂等                     │\n│                                         key。留空时由后端生成。              │\n│    --status                      <str>  条目状态，默认 active。              │\n│                                         [default: active]                    │\n│    --summary                     <str>  文档摘要，供索引和后续 proposal      │\n│                                         判断使用。                           │\n│    --attributes                  <str>  扩展属性 JSON                        │\n│                                         数组；未知属性会自动创建。           │\n│    --help                               Show this message and exit.          │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub relate": "                                                                                \n Usage: project-agent doc-hub relate [OPTIONS]                                  \n                                                                                \n 为两个 Doc Hub 条目建立关系。                                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id           <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│                                  [required]                                  │\n│ *  --from-entry-id        <str>  关系起点 Doc Hub entryId。 [required]       │\n│ *  --to-entry-id          <str>  关系终点 Doc Hub entryId。 [required]       │\n│ *  --relation-kind        <str>  关系类型，例如 references / supersedes。    │\n│                                  [required]                                  │\n│    --status               <str>  关系状态，默认 active。 [default: active]   │\n│    --provider             <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│    --attributes           <str>  扩展属性 JSON 数组；未知属性会自动创建。    │\n│    --help                        Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub remove": "                                                                                \n Usage: project-agent doc-hub remove [OPTIONS]                                  \n                                                                                \n 从 Doc Hub 索引移除文档条目，不删除外部文件。                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│ *  --entry-id          <str>  要移除的 Doc Hub entryId。 [required]          │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub set-provider": "                                                                                \n Usage: project-agent doc-hub set-provider [OPTIONS]                            \n                                                                                \n 经用户二次确认后切换新文档默认平台；不迁移已有文档。                           \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id           <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│                                  [required]                                  │\n│ *  --provider             <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│                                  [required]                                  │\n│ *  --actor-user-id        <str>  执行这次正式写操作的内部 userId。需要审计 … │\n│                                  owner 校验的命令应显式传入。                │\n│                                  [required]                                  │\n│    --confirmed                   仅在用户二次确认本次切换后传入。            │\n│    --help                        Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "doc-hub sync-manifest": "                                                                                \n Usage: project-agent doc-hub sync-manifest [OPTIONS]                           \n                                                                                \n 按 provider/host 扫描到的文档清单批量同步 Doc Hub registry。                   \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id           <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│                                  [required]                                  │\n│    --provider             <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│ *  --manifest-json        <str>  provider-neutral 文档清单 JSON 或 JSON      │\n│                                  文件路径。                                  │\n│                                  [required]                                  │\n│    --help                        Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "loop": "                                                                                \n Usage: project-agent loop [OPTIONS] COMMAND [ARGS]...                          \n                                                                                \n 运行和检查 backend-owned durable loop jobs。                                   \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ run-once           Claim and run one due loop job.                           │\n│ list               List loop jobs for a project.                             │\n│ record-result      Record a runtime/provider execution result for a claimed  │\n│                    loop job.                                                 │\n│ enqueue-bootstrap  Debug helper: enqueue bootstrap_continue for a project.   │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "loop enqueue-bootstrap": "                                                                                \n Usage: project-agent loop enqueue-bootstrap [OPTIONS]                          \n                                                                                \n Debug helper: enqueue bootstrap_continue for a project.                        \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│    --reason            <str>  Debug enqueue reason. [default: manual_debug]  │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "loop list": "                                                                                \n Usage: project-agent loop list [OPTIONS]                                       \n                                                                                \n List loop jobs for a project.                                                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "loop record-result": "                                                                                \n Usage: project-agent loop record-result [OPTIONS]                              \n                                                                                \n Record a runtime/provider execution result for a claimed loop job.             \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --loop-job-id        <str>  Loop job id returned by run-once/list.        │\n│                                [required]                                    │\n│ *  --outcome            <str>  success / retryable_failed / blocked.         │\n│                                [required]                                    │\n│    --result-json        <str>  Optional result object JSON.                  │\n│    --reason             <str>  Failure or blocker reason.                    │\n│    --next-run-at        <str>  Retry timestamp for retryable_failed.         │\n│    --help                      Show this message and exit.                   │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting": "                                                                                \n Usage: project-agent meeting [OPTIONS] COMMAND [ARGS]...                       \n                                                                                \n 把录音转录和 Fireflies 会议写入 Project Agent 数据库。                         \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ save        从 stdin 读取会议 JSON，在 Project Agent 数据库中建表并写入。    │\n│ parse-time  校验会议实际时间。可解析时输出 UTC 时间。                        │\n│ tasks       已保存会议纪要的独立 Task 后处理与恢复。                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting parse-time": "                                                                                \n Usage: project-agent meeting parse-time [OPTIONS]                              \n                                                                                \n 校验会议实际时间。可解析时输出 UTC 时间。                                      \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --value        <str>  ISO 8601 或 epoch。 [required]                      │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting save": "                                                                                \n Usage: project-agent meeting save [OPTIONS]                                    \n                                                                                \n 从 stdin 读取会议 JSON，在 Project Agent 数据库中建表并写入。                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks": "                                                                                \n Usage: project-agent meeting tasks [OPTIONS] COMMAND [ARGS]...                 \n                                                                                \n 已保存会议纪要的独立 Task 后处理与恢复。                                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ pending    读取已保存纪要的待办后处理；包括 summarized，不访问 Fireflies。   │\n│ plan       从已保存纪要生成的 JSON 固化稳定计划；同一会议不可覆盖。          │\n│ run        单遍执行一场会议的持久化计划；逐项记录并汇总通知。                │\n│ placement  仅补充尚未创建的单项任务归属；保留原计划与幂等键。                │\n│ resume     周期入口：单遍续跑已有计划，并返回需要从已保存纪要提取的会议。    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks pending": "                                                                                \n Usage: project-agent meeting tasks pending [OPTIONS]                           \n                                                                                \n 读取已保存纪要的待办后处理；包括 summarized，不访问 Fireflies。                \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks placement": "                                                                                \n Usage: project-agent meeting tasks placement [OPTIONS]                         \n                                                                                \n 仅补充尚未创建的单项任务归属；保留原计划与幂等键。                             \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --meeting-id        <str>  [required]                                     │\n│ *  --input             <str>  [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks plan": "                                                                                \n Usage: project-agent meeting tasks plan [OPTIONS]                              \n                                                                                \n 从已保存纪要生成的 JSON 固化稳定计划；同一会议不可覆盖。                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --meeting-id        <str>  [required]                                     │\n│ *  --input             <str>  [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks resume": "                                                                                \n Usage: project-agent meeting tasks resume [OPTIONS]                            \n                                                                                \n 周期入口：单遍续跑已有计划，并返回需要从已保存纪要提取的会议。                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "meeting tasks run": "                                                                                \n Usage: project-agent meeting tasks run [OPTIONS]                               \n                                                                                \n 单遍执行一场会议的持久化计划；逐项记录并汇总通知。                             \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --meeting-id        <str>  [required]                                     │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "mind": "                                                                                \n Usage: project-agent mind [OPTIONS] COMMAND [ARGS]...                          \n                                                                                \n 读取 Project Mind；正式写入通过 Task、Sprint、Proposal 场景命令执行。          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ migrate-tasks  将全部未映射的 Local Task 注册到 Task Center；包含历史        │\n│                Sprint。                                                      │\n│ read           读取 Project Mind 的 summary 或 full 视图；窄读走 query       │\n│                apply。                                                       │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "mind read": "                                                                                \n Usage: project-agent mind read [OPTIONS] COMMAND [ARGS]...                     \n                                                                                \n 读取 Project Mind 的 summary 或 full 视图；窄读走 query apply。                \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --project-id              <str>  项目内部 canonical projectId。不要直接传群  │\n│                                  ID 或外部文档 ID；只有外部信号时先用        │\n│                                  context 命令解析。                          │\n│ --view                    <str>  读取视图：summary|full；summary             │\n│                                  返回当前摘要，full 返回完整 snapshot。      │\n│                                  [default: summary]                          │\n│ --source-kind             <str>  调用来源类型。传 project_group              │\n│                                  时会启用来源群与 projectId 的边界校验。     │\n│ --channel                 <str>  聊天/消息渠道名，例如 feishu 或             │\n│                                  magic-campus。用于 binding                  │\n│                                  解析和来源边界校验；文档平台请用            │\n│                                  --provider。                                │\n│ --provider                <str>  外部文档平台 provider，例如 feishu 或       │\n│                                  google-drive。用于文档与 doc-hub            │\n│                                  归属；doc-hub register/sync-manifest        │\n│                                  未传时沿用已登记同一文档的 provider，否则 … │\n│                                  bind-space                                  │\n│                                  一样使用项目默认平台；其他命令按各自默认值… │\n│ --channel-group-id        <str>  已写入 project_bindings.external_channel_i… │\n│                                  的群聊 ID。常用于直接按绑定项目群反查       │\n│                                  projectId 并读取 Project Mind。             │\n│ --delivery-to             <str>  来源投递目标标识。和 chat-id / subject /    │\n│                                  group-id 一起参与 project_group binding     │\n│                                  解析。                                      │\n│ --chat-id                 <str>  聊天会话 ID。Feishu 项目群常见值为 oc_xxx   │\n│                                  或 chat:oc_xxx；CLI 会按既有规则做规范化。  │\n│ --subject                 <str>  来源主体 ID，例如会话主体或用户主体。仅在   │\n│                                  binding 解析需要该信号时传入。              │\n│ --group-id                <str>  群聊 ID 信号。用于 resolve-group 或         │\n│                                  project_group 边界校验，不是内部            │\n│                                  projectId。                                 │\n│ --help                           Show this message and exit.                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "monitoring": "                                                                                \n Usage: project-agent monitoring [OPTIONS] COMMAND [ARGS]...                    \n                                                                                \n 配置监控策略；内部评估仅供 scheduled/report 消费。                             \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ plan  开启或关闭项目的监控策略。                                             │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "monitoring evaluate-followups": "                                                                                \n Usage: project-agent monitoring evaluate-followups [OPTIONS]                   \n                                                                                \n 只计算 follow-up 结果，不写入 monitoring run。                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│ *  --at                <str>  评估时点，使用 ISO-8601 时间字符串。           │\n│                               [required]                                     │\n│    --task-id           <str>  目标 Task 的 canonical                         │\n│                               taskId。只在命令支持单任务上下文时传入。       │\n│    --format            <str>  输出格式。目前只支持 json。 [default: json]    │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "monitoring plan": "                                                                                \n Usage: project-agent monitoring plan [OPTIONS]                                 \n                                                                                \n 开启或关闭项目的监控策略。                                                     \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id                  <str>  项目内部 canonical                   │\n│                                         projectId。不要直接传群 ID           │\n│                                         或外部文档 ID；只有外部信号时先用    │\n│                                         context 命令解析。                   │\n│                                         [required]                           │\n│    --enabled       --disabled           监控开关。传 --disabled              │\n│                                         可关闭该项目的监控计划。             │\n│                                         [default: enabled]                   │\n│    --attributes                  <str>  扩展属性 JSON                        │\n│                                         数组；未知属性会自动创建。           │\n│    --help                               Show this message and exit.          │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "monitoring run": "                                                                                \n Usage: project-agent monitoring run [OPTIONS]                                  \n                                                                                \n 执行一次监控评估，并落库存档的 monitoring run。                                \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>  项目内部 canonical projectId。不要直接传群 ID  │\n│                               或外部文档 ID；只有外部信号时先用 context      │\n│                               命令解析。                                     │\n│                               [required]                                     │\n│ *  --at                <str>  评估时点，使用 ISO-8601 时间字符串。           │\n│                               [required]                                     │\n│    --task-id           <str>  目标 Task 的 canonical                         │\n│                               taskId。只在命令支持单任务上下文时传入。       │\n│    --format            <str>  输出格式。目前只支持 json。 [default: json]    │\n│    --help                     Show this message and exit.                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "onboarding": "                                                                                \n Usage: project-agent onboarding [OPTIONS] COMMAND [ARGS]...                    \n                                                                                \n 一次处理项目群入群成员 onboarding。                                            \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply  从 stdin 接收入群事件 JSON，并返回 terminal receipt。                 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "onboarding apply": "                                                                                \n Usage: project-agent onboarding apply [OPTIONS]                                \n                                                                                \n 从 stdin 接收入群事件 JSON，并返回 terminal receipt。                          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "proposal": "                                                                                \n Usage: project-agent proposal [OPTIONS] COMMAND [ARGS]...                      \n                                                                                \n 一次查询、批准或拒绝一个或多个 Proposal。                                      \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply  从 stdin 接收 Proposal scene JSON，并返回 terminal receipt。          │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "proposal apply": "                                                                                \n Usage: project-agent proposal apply [OPTIONS]                                  \n                                                                                \n 从 stdin 接收 Proposal scene JSON，并返回 terminal receipt。                   \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "query": "                                                                                \n Usage: project-agent query [OPTIONS] COMMAND [ARGS]...                         \n                                                                                \n 一次读取项目、用户、Task、Sprint 或 roster 事实。                              \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply  从 stdin 接收一个 Query scene JSON document，并返回 compact receipt。 │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "query apply": "                                                                                \n Usage: project-agent query apply [OPTIONS]                                     \n                                                                                \n 从 stdin 接收一个 Query scene JSON document，并返回 compact receipt。          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "report": "                                                                                \n Usage: project-agent report [OPTIONS] COMMAND [ARGS]...                        \n                                                                                \n 基于当前项目状态生成结构化报告；Agent 热路径走 report apply。                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply  从 stdin 接收 Reporting scene JSON，并返回 terminal receipt。         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "report apply": "                                                                                \n Usage: project-agent report apply [OPTIONS]                                    \n                                                                                \n 从 stdin 接收 Reporting scene JSON，并返回 terminal receipt。                  \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "report build": "                                                                                \n Usage: project-agent report build [OPTIONS]                                    \n                                                                                \n 生成日报、follow-up 或 kickoff 报告，并返回结构化 JSON。                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id               <str>                  项目内部 canonical      │\n│                                                      projectId。不要直接传 … │\n│                                                      ID 或外部文档           │\n│                                                      ID；只有外部信号时先用  │\n│                                                      context 命令解析。      │\n│                                                      [required]              │\n│ *  --report-kind              <daily_status|followu  报告类型。常见值包括    │\n│                               p|kickoff>             daily_status、followup… │\n│                                                      [required]              │\n│ *  --at                       <str>                  报告生成时点，使用      │\n│                                                      ISO-8601 时间字符串。   │\n│                                                      [required]              │\n│    --task-id                  <str>                  目标 Task 的 canonical  │\n│                                                      taskId。只在命令支持单… │\n│    --monitoring-run-id        <str>                  复用 monitoring run     │\n│                                                      ID。                    │\n│    --format                   <str>                  输出格式。目前只支持    │\n│                                                      json。                  │\n│                                                      [default: json]         │\n│    --help                                            Show this message and   │\n│                                                      exit.                   │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "scheduled": "                                                                                \n Usage: project-agent scheduled [OPTIONS] COMMAND [ARGS]...                     \n                                                                                \n 执行定时监控入口，输出适合调度器消费的标准结果。                               \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ run  按给定时间窗执行一次定时监控，并输出 text 契约结果。                    │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "scheduled run": "                                                                                \n Usage: project-agent scheduled run [OPTIONS]                                   \n                                                                                \n 按给定时间窗执行一次定时监控，并输出 text 契约结果。                           \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --project-id        <str>                      项目内部 canonical         │\n│                                                   projectId。不要直接传群 I… │\n│                                                   或外部文档                 │\n│                                                   ID；只有外部信号时先用     │\n│                                                   context 命令解析。         │\n│                                                   [required]                 │\n│ *  --window            <09:00|10:00|11:00|15:00|  调度时间窗，取值为 09:00 … │\n│                        18:00>                     10:00 / 11:00 / 15:00 /    │\n│                                                   18:00。由上游 cron 决定。  │\n│                                                   [required]                 │\n│ *  --at                <str>                      本次调度触发时点，使用     │\n│                                                   ISO-8601 时间字符串。      │\n│                                                   [required]                 │\n│    --format            <str>                      输出格式。目前只支持       │\n│                                                   text。                     │\n│                                                   [default: text]            │\n│    --help                                         Show this message and      │\n│                                                   exit.                      │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "sprint": "                                                                                \n Usage: project-agent sprint [OPTIONS] COMMAND [ARGS]...                        \n                                                                                \n 一次完成 Sprint、Workstream 与 tracking 治理。                                 \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply     从 stdin 接收 Sprint scene JSON document，并返回 terminal          │\n│           receipt。                                                          │\n│ rollover  规划或执行 Sprint 收口，并在命令内处理未完成 Task 去向。           │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "sprint apply": "                                                                                \n Usage: project-agent sprint apply [OPTIONS]                                    \n                                                                                \n 从 stdin 接收 Sprint scene JSON document，并返回 terminal receipt。            \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "sprint rollover": "                                                                                \n Usage: project-agent sprint rollover [OPTIONS]                                 \n                                                                                \n 规划或执行 Sprint 收口，并在命令内处理未完成 Task 去向。                       \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "task": "                                                                                \n Usage: project-agent task [OPTIONS] COMMAND [ARGS]...                          \n                                                                                \n 一次完成 Task create/update/complete/cancel/move/snooze。                      \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ --help          Show this message and exit.                                  │\n╰──────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ───────────────────────────────────────────────────────────────────╮\n│ apply     从 stdin 接收一个 Task scene JSON document，并返回 terminal        │\n│           receipt。                                                          │\n│ maintain  Prepare current evidence, apply Agent synthesis (append or amend   │\n│           WorkNodes), or reconcile an uncertain write.                       │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "task apply": "                                                                                \n Usage: project-agent task apply [OPTIONS]                                      \n                                                                                \n 从 stdin 接收一个 Task scene JSON document，并返回 terminal receipt。          \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  固定为 @-，从 stdin 读取 JSON。 [required]          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n",
+  "task maintain": "                                                                                \n Usage: project-agent task maintain [OPTIONS]                                   \n                                                                                \n Prepare current evidence, apply Agent synthesis (append or amend WorkNodes),   \n or reconcile an uncertain write.                                               \n                                                                                \n╭─ Options ────────────────────────────────────────────────────────────────────╮\n│ *  --input        <str>  [required]                                          │\n│    --help                Show this message and exit.                         │\n╰──────────────────────────────────────────────────────────────────────────────╯\n\n"
+}

project_agent_client-0.1.0/src/project_agent_client.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: project-agent-client
+Version: 0.1.0
+Summary: Remote Project Agent command-line client
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Project Agent CLI
+
+Install the client with `python -m pip install project-agent-client`, or install
+from this repository with `python -m pip install ./apps/cli`. Build a wheel
+with `python -m build apps/cli` for distribution. The installed
+entry point is `project-agent`; do not install it into the same environment as
+the legacy backend package, which exposes the same command name.
+
+This separately packaged client forwards Task, Query, Sprint and Proposal scene
+commands, Quest Task handoffs, and explicitly supported Context, Doc Hub,
+Meeting, Bootstrap, Attribute, Report, Monitoring and Scheduled commands.
+The service must implement and authorize each operation; this client cannot
+override a service-side rejection. Scene receipts and the stdout, stderr and
+exit code of bridged commands are preserved. Administrative database and
+upgrade operations are not exposed through this client. The server's database
+location is never selected by a client-supplied path.
+
+Configure `PROJECT_SERVICE_URL` and set `PROJECT_SERVICE_TOKEN` to a Magic
+Campus API Key (access token), or to an existing service grant. The client sends
+it as `Authorization: Bearer <token>`; it does not need Magic Campus account
+API settings or service database credentials. HTTPS is required
+except for a local loopback service. The client does not automatically retry a
+write because a network failure can leave its outcome unknown. Legacy Doc Hub
+JSON-file arguments are read on the client and sent as inline JSON; paths are
+never read on the server. A Magic Campus API Key acts only for its verified
+user; it cannot delegate another actor. Commands that mutate data require an
+active user and the applicable project membership. Existing trusted Agent
+grants can still supply a verified per-request actor.
+
+With a personal Magic Campus API Key, Task and Sprint scene writes continue to
+enforce their actor and business rules, and Task Quest commands remain available
+with their own authorization checks. Proposal `list` is readable, while
+`approve` and `reject` require a trusted service grant because the existing
+policy does not yet enforce approval eligibility. For Story/People Quest
+sources, personal keys may use status, query and detail; private query scopes
+must match the caller's active Magic Campus identity. The source operations
+ingest, publish-source, reconcile and history require a trusted service grant
+and an active actor: history also updates the shared review journal. The grant
+must bind the actor or explicitly allow per-request delegation. The CLI bridge supports the
+read-only context commands, Doc Hub reads (`get-root`, `index`, `access target`,
+`access plan`), `meeting parse-time`, `meeting tasks pending`, `mind read`,
+`loop list`, and `monitoring evaluate-followups`; it also supports
+`attribute apply` and `meeting save`, which check project membership.
+
+Other bridge commands require a configured trusted service grant: context
+member/identity management, onboarding, all bootstrap commands (including
+`checkpoint` and `loop-state`, which update state), Doc Hub writes, report,
+monitoring writes, scheduled runs, meeting task plan/placement/run/resume, and
+loop writes. These commands do not yet all enforce caller authorization. The
+service grant must have a bound actor or explicitly trust per-request delegation
+for writes. A personal API Key cannot be used to bypass this restriction.
+
+With a trusted service grant, meeting `tasks run` and `tasks resume` execute on the service, using the bound
+actor. Existing plans must resolve to that actor; a resume batch with a plan
+for another actor is rejected. Task writes use the service-side Quest handoff.
+Meeting notifications are sent by the service's `magic-campus` executable, so
+that executable and its account configuration must be available in the service
+runtime; an absent executable leaves the notification pending for retry.
+The meeting-assistant skill uses the same `PROJECT_SERVICE_URL` and
+`PROJECT_SERVICE_TOKEN` for meeting state when those are set, and does not
+fall back to a local database if the remote service is unavailable.
+
+When an explicitly trusted Agent credential uses `trustActorRefs: true`, the
+runtime must set `PROJECT_SERVICE_ACTOR_REF` to the current verified actor JSON
+(e.g. `{"userId":"..."}`) for CLI bridge operations which need a user. A bound
+actor credential does not need this variable. The service validates that actor
+is active and rejects a conflicting actor in the command input.

project_agent_client-0.1.0/src/project_agent_client.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/project_agent_client/__init__.py
+src/project_agent_client/cli.py
+src/project_agent_client/help.json
+src/project_agent_client.egg-info/PKG-INFO
+src/project_agent_client.egg-info/SOURCES.txt
+src/project_agent_client.egg-info/dependency_links.txt
+src/project_agent_client.egg-info/entry_points.txt
+src/project_agent_client.egg-info/top_level.txt
+tests/test_cli.py

project_agent_client-0.1.0/src/project_agent_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

project_agent_client-0.1.0/src/project_agent_client.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+project-agent = project_agent_client.cli:main

project_agent_client-0.1.0/src/project_agent_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+project_agent_client

project_agent_client-0.1.0/tests/test_cli.py

@@ -0,0 +1,146 @@
+import io
+import json
+from urllib.error import URLError
+
+from project_agent_client.cli import run
+
+
+def test_forwards_task_request_and_preserves_receipt():
+    output = io.StringIO()
+    expected = {"status": "partial_success", "results": [{"taskId": "t1"}]}
+    calls = []
+
+    def send(request, timeout):
+        calls.append((request, timeout))
+        return io.BytesIO(json.dumps(expected).encode())
+
+    result = run(["task", "apply", "--input", "@-"], io.StringIO('{"operations": []}'), output,
+                 {"PROJECT_SERVICE_URL": "https://project.example", "PROJECT_SERVICE_TOKEN": "secret"}, send)
+    assert result == 1
+    assert json.loads(output.getvalue()) == expected
+    assert calls[0][0].full_url == "https://project.example/v1/tasks/apply"
+    assert calls[0][0].get_header("Authorization") == "Bearer secret"
+    assert json.loads(calls[0][0].data) == {"operations": []}
+
+
+def test_network_failure_is_not_retried_or_reported_as_safe_to_repeat():
+    output = io.StringIO()
+    calls = []
+
+    def send(request, timeout):
+        calls.append(request)
+        raise URLError("unavailable")
+
+    result = run(["task", "apply", "--input", "@-"], io.StringIO("{}"), output,
+                 {"PROJECT_SERVICE_URL": "https://project.example", "PROJECT_SERVICE_TOKEN": "secret"}, send)
+    assert result == 1
+    assert len(calls) == 1
+    assert "outcome may be unknown" in json.loads(output.getvalue())["results"][0]["error"]["message"]
+
+
+def test_maintenance_forwards_its_original_result():
+    output = io.StringIO()
+    result_body = {"status": "prepared", "snapshotToken": "snapshot"}
+    calls = []
+
+    def send(request, timeout):
+        calls.append(request.full_url)
+        return io.BytesIO(json.dumps(result_body).encode())
+
+    result = run(["task", "maintain", "--input", "@-"], io.StringIO("{}"), output,
+                 {"PROJECT_SERVICE_URL": "https://project.example", "PROJECT_SERVICE_TOKEN": "secret"}, send)
+    assert result == 0
+    assert calls == ["https://project.example/v1/tasks/maintain"]
+    assert json.loads(output.getvalue()) == result_body
+
+
+def test_rejects_plain_http_to_remote_hosts():
+    output = io.StringIO()
+    result = run(["task", "apply", "--input", "@-"], io.StringIO("{}"), output,
+                 {"PROJECT_SERVICE_URL": "http://project.example", "PROJECT_SERVICE_TOKEN": "secret"})
+    assert result == 1
+    assert json.loads(output.getvalue())["results"][0]["error"]["code"] == "service_configuration_error"
+
+
+def test_legacy_command_forwards_arguments_and_preserves_streams():
+    output, error, calls = io.StringIO(), io.StringIO(), []
+    def send(request, timeout):
+        calls.append(request)
+        return io.BytesIO(json.dumps({'stdout': 'result\n', 'stderr': 'diagnostic\n', 'exitCode': 2}).encode())
+    result = run(['context', 'get-user', '--user-id', 'u'], io.StringIO(''), output,
+                 {'PROJECT_SERVICE_URL': 'https://project.example', 'PROJECT_SERVICE_TOKEN': 'secret'}, send, error)
+    assert result == 2 and output.getvalue() == 'result\n' and error.getvalue() == 'diagnostic\n'
+    assert json.loads(calls[0].data) == {'command': ['context', 'get-user'], 'arguments': ['--user-id', 'u'], 'stdin': ''}
+
+
+def test_inline_document_json_file_is_read_only_by_client(tmp_path):
+    source = tmp_path / 'doc.json'
+    source.write_text('{"title":"hello"}')
+    captured = []
+    def send(request, timeout):
+        captured.append(json.loads(request.data))
+        return io.BytesIO(b'{"stdout":"ok","stderr":"","exitCode":0}')
+    assert run(['doc-hub', 'read', '--project-id', 'p', '--entry-id', 'e', '--content-json', str(source)], io.StringIO(), io.StringIO(),
+               {'PROJECT_SERVICE_URL': 'https://project.example', 'PROJECT_SERVICE_TOKEN': 'secret'}, send) == 0
+    assert captured[0]['arguments'][-1] == '{"title":"hello"}'
+
+
+def test_quest_handoff_uses_service_and_preserves_uncertain_outcome():
+    captured, output = [], io.StringIO()
+    def send(request, timeout):
+        captured.append(request)
+        return io.BytesIO(b'{"status":"partial_success","result":{"status":"unknown_write"}}')
+    result = run(['quest', 'publish-task', '--input', '@-'], io.StringIO('{"projectId":"p","taskId":"t"}'), output,
+                 {'PROJECT_SERVICE_URL': 'https://project.example', 'PROJECT_SERVICE_TOKEN': 'secret'}, send)
+    assert result == 1
+    assert captured[0].full_url == 'https://project.example/v1/quest/publish-task'
+    assert json.loads(output.getvalue())['result']['status'] == 'unknown_write'
+
+
+def test_quest_status_forwards_request_unchanged():
+    captured, output = [], io.StringIO()
+    def send(request, timeout):
+        captured.append(request)
+        return io.BytesIO(b'{"status":"ok","publication":{"state":"pending"}}')
+    body = '{"projectId":"p","taskId":"t","actorRef":{"userId":"u"}}'
+    assert run(['quest', 'status', '--input', '@-'], io.StringIO(body), output,
+               {'PROJECT_SERVICE_URL':'https://project.example', 'PROJECT_SERVICE_TOKEN':'secret'}, send) == 0
+    assert captured[0].full_url == 'https://project.example/v1/quest/status'
+    assert json.loads(captured[0].data) == json.loads(body)
+
+
+def test_offline_version_and_help_never_contact_service():
+    def never_send(*args, **kwargs):
+        raise AssertionError('help must not contact service')
+    for args, expected in [(['--version'], '0.'), (['--help'], 'Commands:'),
+                           (['task', 'apply', '--help'], '--input'),
+                           (['quest', 'status', '--help'], '--input'),
+                           (['quest', 'reconcile-task-create', '--help'], '--input')]:
+        out = io.StringIO()
+        assert run(args, io.StringIO(), out, {}, never_send) == 0
+        assert expected in out.getvalue()
+
+
+def test_quest_pending_forwards_request_unchanged():
+    captured, output = [], io.StringIO()
+    def send(request, timeout):
+        captured.append(request)
+        return io.BytesIO(b'{"status":"ok","result":{"items":[],"nextCursor":null}}')
+    body = '{"projectId":"p","actorRef":{"userId":"u"},"limit":10}'
+    assert run(['quest', 'pending', '--input', '@-'], io.StringIO(body), output,
+               {'PROJECT_SERVICE_URL':'https://project.example', 'PROJECT_SERVICE_TOKEN':'secret'}, send) == 0
+    assert captured[0].full_url == 'https://project.example/v1/quest/pending'
+    assert json.loads(captured[0].data) == json.loads(body)
+
+
+def test_quest_reconcile_task_create_forwards_request_and_receipt():
+    captured, output = [], io.StringIO()
+    def send(request, timeout):
+        captured.append(request)
+        return io.BytesIO(b'{"status":"ok","result":{"status":"recovered","taskId":"t"}}')
+    body = '{"projectId":"p","taskId":"t","remoteId":"r","actorRef":{"userId":"u"}}'
+    assert run(['quest', 'reconcile-task-create', '--input', '@-'], io.StringIO(body), output,
+               {'PROJECT_SERVICE_URL':'https://project.example', 'PROJECT_SERVICE_TOKEN':'secret'}, send) == 0
+    assert captured[0].full_url == 'https://project.example/v1/quest/reconcile-task-create'
+    assert json.loads(captured[0].data) == json.loads(body)
+    assert json.loads(output.getvalue())['result']['status'] == 'recovered'