weichen c61920a8dc Stop task-finish from uninitializing shared submodule config
Why: cmd_finish ran git submodule deinit --all, but submodule.<name>.url entries live in the shared .git/config — finishing any task silently marked every other checkout and worktree uninitialized (observed twice on 2026-09-30: main checkout uninit=12 after each finish; a parallel session hit it minutes before this fix landed). The deinit serves no purpose: worktree removal with gitlinks is refused regardless, so cleanup already goes through rm -rf + prune. Also aligns AGENTS.md with observed hook behavior (post-merge fires on ff-only pulls too, and its inline close cannot see cards merged remotely until they are pulled), and ignores the ZCode-generated .zcodeignore that tripped the BUSY gate in every session.
Evidence: bash -n clean; abandon-path smoke of the patched script — start + FORCE_ABANDON=1 finish of a throwaway branch left shared submodule url config at 12 entries (pre-fix: 0), main checkout submodule status uninit=0, smoke worktree and branch fully recycled; the smoke close also backfilled a parallel session card left open (gitea-access-facts) via a card-close branch, proving the fallback path.
Impact: scripts/task.sh cmd_finish only (removes one line, updates comment), AGENTS.md card-close paragraph, .gitignore one entry. No product or gitlink change; make test not applicable (repo-level tooling/docs only). web_base default fix intentionally withdrawn from this PR — landed via parallel PR #73.
Refs: .task/fix-task-finish-close-followups.md
2026-09-30 16:00:31 +00:00

Agent-System-Dev

Agent-System 的开发集成仓(父仓):以 submodule 固定全部模块组合,承载跨仓构建、测试编排与原生(非容器)开发环境。非分发单元——发布物在 Agent-System-Releases。

组合结构

modules/core        Agent-System-Core        核心契约(领域模型/事件协议/插件 API/设置与 UI 词汇)
modules/backend     Agent-System-Backend     后端单二进制(内嵌前端与嵌入式 SQLite)
modules/frontend    Agent-System-Frontend    前端(React 19 + Vite + TS)
modules/documents   Agent-System-Documents   系统文档与过程记录
modules/ui          Agent-System-UI          UI 组件库(词汇渲染器/设计令牌/收件箱卡片工作区组件)
deps/development-guidelines                 开发规范(gitlink 固定版本)
deps/agent-native  deps/agent-squad  deps/agent-intent   生态执行/编排/意图
deps/agent-command   Agent-Command           命令总线基础库(spec/注册表/危险分级/审计信封)
deps/error-code-system  deps/logging-system   基础设施
plugins/            示例插件与插件开发参考(P4 起填充)

父仓 gitlink 是各组件源码版本的权威;构建、审核与发布固定提交,不执行 submodule update --remote。

常用命令

make sync     # 物化全部 submodule(递归)
make build    # 构建单二进制 bin/agent-system
make test     # 全量测试
make dev      # 开发模式说明(前后端分离热更新)

约束(全局)

  • 非容器化部署:默认单二进制,必要时拆分多个原生二进制;不发布容器镜像。
  • 依赖方向:frontend→core←backend;插件只依赖 core;生态仓依赖纪律沿用各仓既有约定。
  • 开发规范:deps/development-guidelines(见各仓 AGENTS.md)。

文档

设计方案:modules/documents/docs/proposals/2026-09-29-system-skeleton-design-and-plan.md(含 D1–D16 决策记录)。 本机服务管理(后端/前端/数据库部署、生命周期、备份克隆):docs/svc.md(scripts/svc.sh)。

S
Description
开发集成仓:以 submodule 固定全部模块组合,承载跨仓构建、测试编排与原生(非容器)开发环境;发布物在 Agent-System-Releases。
Readme
31 MiB
Languages
Python 56.1%
Shell 35.9%
Go 5.3%
JavaScript 1.4%
Makefile 1.1%
Other 0.2%