From af0cb26d0fefc2331d69ac0b9199afed9f999c9c Mon Sep 17 00:00:00 2001 From: Lan_zhijiang Date: Sun, 20 Sep 2026 20:06:40 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=B3=E9=97=AD=20Agent=20Query=20Si?= =?UTF-8?q?nk=20=E5=8D=95=E5=85=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../collaboration/roster.md | 2 +- .../decisions/index.md | 2 +- .../packet.md | 16 ++++++------- .../units/agent-query-sink/acceptance.md | 8 +++---- .../implementation-evidence.md | 24 +++++++++++++++---- .../units/agent-query-sink/packet.md | 14 +++++------ 6 files changed, 40 insertions(+), 26 deletions(-) diff --git a/tasks/knowledge-lifecycle-capabilities/collaboration/roster.md b/tasks/knowledge-lifecycle-capabilities/collaboration/roster.md index 73eb13b1..7367d084 100644 --- a/tasks/knowledge-lifecycle-capabilities/collaboration/roster.md +++ b/tasks/knowledge-lifecycle-capabilities/collaboration/roster.md @@ -9,7 +9,7 @@ | `telegram-extension` | `01a04685-aa31-7682-a4a2-824727eacce5` | core-py PR #89 / `.github` PR #28 | merged as core-py `42d8527` and `.github` `f7269b9` | Closed / merged | D-421–D-460 | Telegram、repository-wide Changie→Towncrier cutover and organization guidance are complete；Unit worktrees are retired and Release PR #90 is independently owned by the release lifecycle | | `organization-nowledge-study` | current session | PR #100 / #101 merged；root worktree on main retains local task-control records | protected `main` `b3ccb00` | Closed / production delivered | D-461–D-570 | Core 0.2.0、production probes and stable admission complete under D-562；no active implementation ownership | | `cli-sink` | 当前 CLI session | `feat/cli-sink-closure` / root core-py worktree | production `4143abe`；关闭记录 PR #104 | Closed | D-571–D-610 | Sir 授权后依序合并；CLI 0.1.0 PyPI 安装与生产复验通过。无 active 源码 ownership；见 unit delivery.md | -| `agent-query-sink` | 当前 session | `feat/agent-query-sink` / root core-py worktree | `676886a` | Revised baseline / packet commit authorized | D-611–D-650 | 未授权源码实施；读取能力按领域 controller/service 分离，增加 Hub meta 文档准则与 Core authority 纠正；拟改 Core/CLI，共享 SinkManager 修正需回归 MCP | +| `agent-query-sink` | 当前 session | PR #111 / #109 / Hub #29 merged；root worktree closing on main | production `5113490` | Closed / production delivered | D-611–D-650 | Core 0.5.0、CLI 0.2.0、production query 与 stable admission 完成；无 active 源码 ownership | ## Shared-worktree coordination diff --git a/tasks/knowledge-lifecycle-capabilities/decisions/index.md b/tasks/knowledge-lifecycle-capabilities/decisions/index.md index 1e85d30f..0fe60000 100644 --- a/tasks/knowledge-lifecycle-capabilities/decisions/index.md +++ b/tasks/knowledge-lifecycle-capabilities/decisions/index.md @@ -89,7 +89,7 @@ so one stable ID has one predictable address；the shard boundary does not imply D-421–D-460；Organization Nowledge study retains D-461–D-570；CLI sink retains D-571–D-610；Agent Query Sink reserves D-611–D-650。 - MCP、Telegram 和 [organization-nowledge-study](../units/organization-nowledge-study/packet.md) 均已关闭；Organization 已完成 PR #100 / #101 合并及 Core 0.2.0 生产交付。[CLI sink](../units/cli-sink/packet.md) 已正式发布并关闭；当前 - [Agent Query Sink](../units/agent-query-sink/packet.md) 已进入 Implementation / local acceptance，等待 draft PR preview 的真实模型验收； + [Agent Query Sink](../units/agent-query-sink/packet.md) 已完成正式交付与 production/PyPI 复验并关闭； Parent task 保留其余候选与 durable-owner reconciliation。 - Parallel placement and integration surfaces are shared peer control in the [roster](../collaboration/roster.md)；there is no coordinator role。 diff --git a/tasks/knowledge-lifecycle-capabilities/packet.md b/tasks/knowledge-lifecycle-capabilities/packet.md index ef30157f..aac0ad15 100644 --- a/tasks/knowledge-lifecycle-capabilities/packet.md +++ b/tasks/knowledge-lifecycle-capabilities/packet.md @@ -14,13 +14,13 @@ loop。各 session 维护自己的 Unit packet，并只为本 Unit 的登记、阶段或集成结果最小更新共享 task control。 InKCre 的长期产品事实是不建立 terminal-user、tenant 或 per-user ownership/ACL domain；deployment 是单一 owner context，runtime nodes 称为 peers（D-033/D-109）。 - Memos、RSS、Mail、semantic retrieval、feature/lexical retrieval 与 graph-navigation retrieval 均已关闭； + Memos、RSS、Mail、semantic retrieval、feature/lexical retrieval、graph-navigation retrieval 与 Agent Query Sink + 均已关闭； 能力划分见 [capability-map.md](capability-map.md)，当前状态见本页下方；details stay in each unit packet and the [decision register](decisions/index.md)。GitHub extension 的 collection-side correction remains queued, but no longer blocks root-usability selection after ownership corrections merged。 -- **Next Step**: [Agent Query Sink](units/agent-query-sink/packet.md) 已实现并通过 Preview 真实模型 A1–A4； - Sir 对 #111 的维护性 review 已落实，本轮冷启动/路由 smoke 与本地门禁通过。继续 review Core PR #111 与 - Hub PR #29，不合并。 +- **Next Step**: [Agent Query Sink](units/agent-query-sink/packet.md) 已完成正式交付并关闭；回到下一 implementable + unit 选择，不从本 unit 的残余自动推导新范围。 ## Program Boundary @@ -44,7 +44,7 @@ 2026-09-20，Sir 选择 `agent-query-sink`，由 AI 组合 info-base 原始查询，服务检索而非下游创作；见 [D-611](decisions/D611-D620.md)。已从干净、与 origin/main 一致的 `676886a` 切出 `feat/agent-query-sink`。 -当前已完成实现与 Preview 验收，Sir 对 #111 的维护性 review 已落实（`daab9d6`），继续等待复审。 +当前已完成实现、Preview、正式发布与 production 复验；Hub #29、Core #111 与 Release #109 已合并，unit 关闭。 环境入口仍为 `AGENTS.local.md` 与 `svc.local.json`。 Organization 保留 D-461–D-570，CLI 保留 D-571–D-610，新 unit 保留 D-611–D-650，不复用历史空号。 @@ -56,9 +56,9 @@ Organization 保留 D-461–D-570，CLI 保留 D-571–D-610，新 unit 保留 D ## Unit 状态与选择 -[Agent Query Sink](units/agent-query-sink/packet.md) 为当前 active unit。D-611–D-631 的合同、工具归属、 -controller/service 与文档 authority 修正均已实现；Core PR #111 的 Preview 真实模型 A1–A4 与修正后镜像 smoke -均已通过。合并、发布与 production 复验尚未授权。 +[Agent Query Sink](units/agent-query-sink/packet.md) 已关闭。D-611–D-631 的合同、工具归属、controller/service +与文档 authority 修正均已实现；Preview A1–A4、Hub/Core/Release 合并、Core 0.5.0、CLI 0.2.0、production +stable admission 与已发布 CLI 的有依据查询均已通过。 [CLI sink](units/cli-sink/packet.md) 已关闭，公开接口、实现、四条本地旅程、跨 owner 正式交付及 PyPI 安装 连接生产 Core 的复验均通过。研究依据包括本任务 Agent Tool 模式、xiaoland/svc 的 CLI 实践及一手公开材料。 diff --git a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/acceptance.md b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/acceptance.md index dcc107ce..ea12acb4 100644 --- a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/acceptance.md +++ b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/acceptance.md @@ -2,7 +2,7 @@ 依据 D-611–D-628。验收证明配置、异步交付、基于材料回答与实际消费；不以工具数量、固定调用次序、 固定措辞或单次模型正常结束代替产品价值。本文保留已确认的验收合同；Preview 执行结果见 -[implementation-evidence](implementation-evidence.md)，production/PyPI 仍待后续授权。 +[implementation-evidence](implementation-evidence.md)。Preview、production 与 PyPI 交付终点均已完成。 ## 数据与证据 @@ -67,6 +67,6 @@ D-629–D-631 增补结构与文档核验，不改变四条产品旅程：检查 调用方向、exact IDs/输入合同和普通领域返回能力；按 documentation-authority.md 核对合同唯一 owner、 旧位置清理及引用可达。此项通过源码/文档审查与既有静态检查完成，不增加自动化测试。 -已确认交付终点：preview 四旅程通过 → 经单独授权合并与发布 → production 部署成功、CLI 发布 PyPI → -本地隔离安装已发布版本并连接 production 完成配置/一次有依据查询。此终点不代表当前 -已获提交、推送、合并或发布授权。Core 先就绪，再验证 CLI 消费；不重做现有 release workflow。 +已确认并完成的交付终点：preview 四旅程通过 → 经授权合并与发布 → production 部署成功、CLI 发布 PyPI → +本地隔离安装已发布版本并连接 production 完成配置/一次有依据查询。Core 先就绪，再验证 CLI 消费； +未重做现有 release workflow。 diff --git a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/implementation-evidence.md b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/implementation-evidence.md index d8ab582c..098ead2b 100644 --- a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/implementation-evidence.md +++ b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/implementation-evidence.md @@ -105,7 +105,23 @@ print('Core Agent Tool bootstrap passed') PY ``` -## 尚待 - -- Hub PR #29、Core PR #111 的合并、版本准备、production 与 PyPI 复验均需要后续明确授权；draft PR 不能写成 - unit 已关闭。 +## 正式交付与生产复验 + +2026-09-20 按依赖顺序完成交付：Hub PR #29 squash merge 为 `42f7bad`；Core PR #111 在 shared ref 跟进并重新 +通过全部 checks/Preview 后 squash merge 为 `ee6e2cf`；Release PR #109 准备 Core 0.5.0 与 CLI 0.2.0，并 +merge 为 `5113490`。Runtime artifact run +[35508769034](https://github.com/InKCre/core-py/actions/runs/35508769034)、CLI PyPI run +[35508769025](https://github.com/InKCre/core-py/actions/runs/35508769025) 与 production run +[35508851500](https://github.com/InKCre/core-py/actions/runs/35508851500) 均成功，最后一项完成生产收敛、probe 与 +stable admission。 + +从 PyPI 在独立 virtualenv 安装 `inkcre-cli==0.2.0`，使用默认 `production` connection 读取在线 Peer、17 个 +Agent Tools 与 Agent Query 动态 schema。production 配置 Alibaba Model Studio / `qwen3.5-omni-flash`、推荐 +Agent definition 与启用的 Agent Query Sink；Block 6–7 经 lexical maintenance Job 4 建立 projection。 +开放式 Job 5–7 均如实以 `completed without submit_query_result` / `max_model_calls` 失败，证明增加预算不能掩盖 +provider 选择残余。收窄到已知材料后，Job 8 读取 Block 6，准确回答 Agent Tool controller/domain owner 边界， +返回 `block:6` 引用并以 `finished` 收尾；其 `termination=max_model_calls` 同时验证最后一次成功提交被保留。 +验收后恢复 durable 文档推荐的完整七工具 Agent 配置，保留生产 Sink 作为可用 demo capability。 + +上述证据满足已确认交付终点；本 unit 关闭。开放式问题下模型可能不提交结果仍是可观察的 provider/Agent +配置残余，不扩大为本 unit 的 runtime 特例。 diff --git a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/packet.md b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/packet.md index c115a097..1e5a132b 100644 --- a/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/packet.md +++ b/tasks/knowledge-lifecycle-capabilities/units/agent-query-sink/packet.md @@ -1,9 +1,7 @@ # Agent Query Sink -- **阶段**：Human review。原实现的 P1–P4、本地门禁、真实模型 A1–A4 与镜像 smoke 已通过； - 本轮注册完整性、schema/route rationale 与历史文档状态修正已完成，冷启动/路由 smoke 与本地门禁通过。 - PR #111 保持 draft 且未合并。 - 证据见 [implementation-evidence](implementation-evidence.md)。 +- **阶段**：Closed。Preview A1–A4、维护性复审、Hub authority 修正、Core/CLI 发布、production delivery + 与已发布 CLI 的生产查询旅程均已通过；证据见 [implementation-evidence](implementation-evidence.md)。 - **目标与边界**：[D-611](../../decisions/D611-D620.md)。由 AI 组合既有 info-base 原子查询，承担检索决策并交付相关信息；不另建索引或接管下游创作。 - **位置**：`feat/agent-query-sink`，core-py root worktree；从干净且与 origin/main 一致的 `676886a4d2242be2f14465523c3267a126b60fd3` 切出。决策保留 D-611–D-650。 - **已确认交付物**：[D-620](../../decisions/D611-D620.md) 修正 D-612：基于 info-base 回答信息需求，实体是可寻址依据而非答案上限；允许跨材料比较、解释与有依据的推论。 @@ -22,10 +20,10 @@ - **已确认结束语义**：[D-627](../../decisions/D621-D630.md)：正常 Turn 有交付则 finished，未交付则 failed；保留真实中断状态。预算只由 runtime 控制，不向 LLM 暴露。 - **当前复核面**：[Impact Handshake](impact-handshake.md)。[四条验收旅程与交付终点](acceptance.md) 已由 D-628 确认；[实现计划](implementation-plan.md)、[preflight](preflight.md)、[实测记录](preflight-evidence.md) 与 [corpus](corpus.md) 已准备。 - **事实依据**：[代码与边界调查](research.md)。区分读取工具可发现的方法、能够返回的内容和模型实际能够理解的输入。 -- **下一步**：由 Sir 继续 review PR #111 与 Hub PR #29；本轮修正提交为 `daab9d6`，最新 CI/Preview 结果以 - PR checks 为准。后续合并、版本准备、production 与 PyPI 复验需 - 单独授权后才能关闭 unit。 -- **文档修正**：D-631 已落实到领域 owner 文档；长期准则见 Hub draft PR #29，具体运行合同仍留 Core。 +- **交付**：Hub PR #29、Core PR #111 与 Release PR #109 已依序合并；Core 0.5.0、CLI 0.2.0、production + 与 stable admission 已交付。production Agent Query Job 8 读取 Block 6 并交付准确答案与真实引用。 +- **文档修正**：D-631 已落实到领域 owner 文档；长期准则已由 Hub PR #29 进入 shared truth，具体运行合同仍留 + Core。 ## 工作方式