weichen/Agent-System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

merge: candidate agentctl-mgmt-go-live launchd go-live into dev

Browse Source
This commit is contained in:
WeiCHEN
2026-09-23 18:06:45 +08:00
parent eebe83e0c5 92d30a498b
commit 5e11db50ce
15 changed files with 121 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.doc/ops/CURRENT.md
+1
View File
@@ -18,6 +18,7 @@
| owner | task | branch | worktree | mutex | status |
|---|---|---|---|---|---|
| Cursor | agentctl-mgmt-go-live-2026-09-23 | feature/agentctl-mgmt-go-live-2026-09-23 | .worktrees/agentctl-mgmt-go-live-2026-09-23 | agentctl-mgmt-go-live | in_progress |
| Cursor | w3-u6-current-fix-2026-09-23 | feature/w3-u6-current-fix-2026-09-23 | .worktrees/w3-u6-current-fix-2026-09-23 | w3-u6-current-fix | done |
| Cursor | integrate-w3-u6-closeout-2026-09-23 | feature/integrate-w3-u6-closeout-2026-09-23 | .worktrees/integrate-w3-u6-closeout-2026-09-23 | git:dev | done |
| Cursor | integrate-matrix-record-id-2026-09-23 | feature/integrate-matrix-record-id-2026-09-23 | .worktrees/integrate-matrix-record-id-2026-09-23 | git:dev | done |
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/bootstrap.out
+1
View File
@@ -0,0 +1 @@
bootstrap: ok
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/daemon-bounded-run.jsonl
+5
View File
@@ -0,0 +1,5 @@
{"interval": 1.0, "max_cycles": 3, "pid": 63316, "status": "daemon_started"}
{"processed": 0, "results": [], "status": "ok"}
{"processed": 0, "results": [], "status": "ok"}
{"processed": 0, "results": [], "status": "ok"}
{"cycles": 3, "pid": 63316, "reason": "max_cycles", "status": "daemon_stopped"}
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/daemon-status-after-load.json
+1
View File
@@ -0,0 +1 @@
{"epoch": "7fa35ad9-518f-4a0d-a446-49baf12c666c", "heartbeat": {"cycle": 2, "pid": 63557, "updated": 1790157919.612233}, "heartbeat_age_seconds": 0.8667151927947998, "lock_root": "/private/tmp/Agent-System/.locks", "manager_lock": {"held": true, "holder_pid": 63557, "path": "/private/tmp/Agent-System/.locks/os/manager.lock"}, "queue": {"claimed": 0, "pending": 0}, "status": "ok"}
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/err-log-head.txt
View File
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/host.txt
+1
View File
@@ -0,0 +1 @@
Darwin WeiCHENdeMac-mini.local 25.6.0 Darwin Kernel Version 25.6.0: Fri Jul 31 19:17:26 PDT 2026; root:xnu-12377.161.14~5/RELEASE_ARM64_T6041 arm64
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/launchctl-print-summary.txt
+13
View File
@@ -0,0 +1,13 @@
2: active count = 1
3: path = /Users/weichen/Library/LaunchAgents/com.agentctl.coordinator.plist
5: state = running
7: program = /usr/bin/python3
17: working directory = /private/tmp/Agent-System
19: stdout path = /tmp/agentctl-coordinator.out.log
20: stderr path = /tmp/agentctl-coordinator.err.log
38: runs = 1
39: pid = 63557
55: state = active
56: active count = 1
63: state = active
64: active count = 1
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/load-commands.txt
+3
View File
@@ -0,0 +1,3 @@
domain=gui/501
dest=/Users/weichen/Library/LaunchAgents/com.agentctl.coordinator.plist
cmd: launchctl bootstrap gui/501 /Users/weichen/Library/LaunchAgents/com.agentctl.coordinator.plist
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/loaded-plist.plist
+27
View File
@@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key>
<true/>
<key>Label</key>
<string>com.agentctl.coordinator</string>
<key>ProgramArguments</key>
<array>
<string>/usr/bin/python3</string>
<string>/private/tmp/Agent-System/scripts/agentctl.py</string>
<string>daemon</string>
<string>run</string>
<string>--interval</string>
<string>1.0</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>StandardErrorPath</key>
<string>/tmp/agentctl-coordinator.err.log</string>
<key>StandardOutPath</key>
<string>/tmp/agentctl-coordinator.out.log</string>
<key>WorkingDirectory</key>
<string>/private/tmp/Agent-System</string>
</dict>
</plist>
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/loaded_at_utc.txt
+1
View File
@@ -0,0 +1 @@
2026-09-23T10:05:09Z
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/owner.txt
+1
View File
@@ -0,0 +1 @@
weichen
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/plutil-lint.txt
+1
View File
@@ -0,0 +1 @@
/Users/weichen/Library/LaunchAgents/com.agentctl.coordinator.plist: OK
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/rollback.txt
+6
View File
@@ -0,0 +1,6 @@
# Rollback (fail-closed)
launchctl bootout gui/501/com.agentctl.coordinator
rm -f /Users/weichen/Library/LaunchAgents/com.agentctl.coordinator.plist
# verify:
launchctl print gui/501/com.agentctl.coordinator # expect not found
python3 /private/tmp/Agent-System/scripts/agentctl.py daemon status
.doc/ops/evidence/2026-09-23-agentctl-mgmt-go-live/unittest-summary.txt
+2
View File
@@ -0,0 +1,2 @@
146:Ran 134 tests in 118.996s
148:OK (skipped=3)
.doc/ops/short-term/2026-09-23-agentctl-mgmt-go-live.md
+58
View File
@@ -0,0 +1,58 @@
---
title: "agentctl 管理面启用（launchd go-live）"
task_id: agentctl-mgmt-go-live-2026-09-23
status: in_progress
created: 2026-09-23
updated: 2026-09-23
owner: Cursor
task_type: ops
task_tier: single
policy_revision: "agent-governance-2026-09-21-r1 @ eebe83e0c5e61ad81beeb59bc9138954555afd52"
branch: feature/agentctl-mgmt-go-live-2026-09-23
worktree: .worktrees/agentctl-mgmt-go-live-2026-09-23
base_dev_sha: "eebe83e0c5e61ad81beeb59bc9138954555afd52"
write_scope: [".doc"]
allowed_environments: []
mutex: agentctl-mgmt-go-live
review_state: pending
integration_state: pending
deployment: pending_loaded_local_launchd
cleanup: pending
cleanup_owner: "独立维护者"
cleanup_trigger: "合入后复查；卸载用 evidence/rollback.txt"
remote_sync: not_requested
---
# agentctl 管理面启用（launchd go-live）
## 用户目标与授权
- 目标：将 L1 协调库从按会话 CLI 提升为常驻管理面（macOS launchd）。
- 授权：用户批准「agentctl 管理面：启用（上线）计划」并要求实现全步骤（含装载）。
- 禁止：push；晋升 test/main；装载外的产品环境写；L2/ADR。
## 验收证据
| 步骤 | 结果 | 证据 |
|---|---|---|
| unittest discover | 134 ran / 3 skipped OK @ `eebe83e0` | [unittest-summary](../evidence/2026-09-23-agentctl-mgmt-go-live/unittest-summary.txt) |
| daemon 有界试运行 | `--max-cycles 3` 正常启停，锁释放 | [daemon-bounded-run](../evidence/2026-09-23-agentctl-mgmt-go-live/daemon-bounded-run.jsonl) |
| launchd bootstrap | `gui/501/com.agentctl.coordinator` state=running | [launchctl-print-summary](../evidence/2026-09-23-agentctl-mgmt-go-live/launchctl-print-summary.txt) |
| stderr | 空 | [err-log-head](../evidence/2026-09-23-agentctl-mgmt-go-live/err-log-head.txt) |
| 回滚 | `launchctl bootout` + 删 plist | [rollback](../evidence/2026-09-23-agentctl-mgmt-go-live/rollback.txt) |
装载命令：`launchctl bootstrap gui/501 ~/Library/LaunchAgents/com.agentctl.coordinator.plist`（UTC `2026-09-23T10:05:09Z`）。
## 端到端
本 short-term 本身作为已 validate 候选入队，由常驻 daemon 自动 `--ff-only` 合入（见收口字段更新）。
## 收口
| 字段 | 值 |
|---|---|
| review_state | pending |
| integration_state | pending |
| deployment | pending_loaded_local_launchd |
| cleanup | pending |
| remote_sync | not_requested |