freecodego 0.1.6-alpha.2

package/LICENSE

@@ -0,0 +1,23 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+The full license text is maintained at the repository root:
+https://github.com/XiangSu-ce/dsh-plugin-freecodego/blob/main/LICENSE

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/freecodego/bundle-latest/README.md
+README.md: c84b923b4a08b4d754752b5db63a5cc81d1ceac7
+README.zh.md: 27ad7904392963a4026a0d6949f638af7f5266f4

package/README.md

@@ -0,0 +1,85 @@
+---
+description: "The installable single-package FreeCodeGo composition for DeepSeek Harness: install channel, release tagging, and the bundled Agent Teams composition."
+kind: "package-bundle"
+---
+
+# FreeCodeGo Harness Bundle
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Installable single-package FreeCodeGo composition for DeepSeek Harness `freecodego@0.1.6-alpha.2`, targeting Harness baseline `0.1.6-alpha.2`. The npm artifact contains the compiled Host plugin, browser client, session-event prerequisite, native worker entrypoints, and the bundled Harness Agent Teams composition. A release publishes on npm's `next` dist-tag, and its plugin version intentionally matches the Harness version it targets exactly; for a reproducible install, name the version (`freecodego@0.1.6-alpha.2`) instead of the channel. Official Codex and Claude runtime binaries remain optional platform downloads — the package does not embed every platform's native binary.
+
+## Table of Contents
+
+- [Install](#install)
+- [Agent Teams](#agent-teams)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="install"></a>
+## Install
+
+Install the release for the Harness baseline you run; each release carries one tarball, named after the baseline it mounts on:
+
+```sh
+dsh plugin --profile web add --save-exact \
+  https://github.com/XiangSu-ce/dsh-plugin-freecodego/releases/download/freecodego-v0.1.6-alpha.2/freecodego-0.1.6-alpha.2.tgz
+```
+
+`freecodego-0.1.6-alpha.2.tgz` is the bundle for Harness `0.1.6-alpha.2`: substitute the version you run, which the settings page shows beside the installed plugin version. The asset name is the naming contract in `packages/freecodego/AGENTS.md`.
+
+The `dsh` command is provided by the Harness CLI, not this bundle. In a normal terminal install it first with `npm install --global @deepseek-ai/dsh` (and ensure `pnpm` is available). Desktop launches the same command through its private shims and passes the active `DSH_HOME`, so Web and Desktop use one Profile data directory when they select the same Harness home.
+
+Maintainers release from a tag. `pnpm run release:freecodego <version>` bumps the bundle and creates the `freecodego-v<version>` tag, and the workflow is dispatched from that tag:
+
+```sh
+pnpm run release:freecodego <version>
+gh workflow run release-freecodego.yml --ref freecodego-v<version>
+```
+
+The workflow verifies the family, builds, packs, and creates the GitHub release for that tag. It refuses to publish unless the packed file already carries the asset name an update check looks for, and it re-reads the published release the way the plugin does before the run is allowed to pass. The family publishes only from a `freecodego-v*` tag that names the version the workspace carries, so a dispatch from a branch fails before the build rather than after it.
+
+-----
+
+<a id="agent-teams"></a>
+## Agent Teams
+
+The bundle enables Harness Agent Teams with same-engine child sessions. A DeepSeek parent creates DeepSeek teammates, a Codex parent creates Codex teammates, and a Claude parent creates Claude teammates; the child route is inherited from the parent session rather than selected from the process default. Team roster, mailbox, task-board, and teammate Session records remain owned by Harness. The Web Chat renders the live delegated-Agent progress tree inside the parent conversation, including each task label, current tool, status, and tool-use count.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through the packages the bundle mounts; each inserted row's package owns its own model-facing behavior.
+
+#### KV Cache effect
+
+The bundle adds no request text of its own, so the cached prefix is whatever the composed rows produce.
+
+## Known Limitations and Deferred Work
+<a id="known-limitations-and-deferred-work"></a>
+
+- **The artifact is assembled, not authored** — `prepack` rebuilds the Host plugin, browser client, native worker entrypoints, and the Agent Teams composition; nothing in the tarball is edited by hand.
+- **The version matches the Harness baseline exactly** — a hotfix keeps the tag precise while the release asset keeps the baseline in its name.
+- **Official runtime binaries stay optional platform downloads** — the package does not embed every platform's native binary.
+- **Install is pinned by version** — a reproducible install names the baseline rather than a channel.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+No invariant companion is published because the bundle is static composition metadata with no runtime registry relationship of its own.
+
+The plugin version tracking the Harness version exactly is deliberate: a bundle assembled against one baseline composes the rows of that baseline, so an independent version number would only invite installing a pair that no build ever tested.
+
+</details>
+
+**Runtime invariant:** the bundle declares its composition as data (`dsh.bundle.patch`); it owns no runtime state.

package/README.zh.md

@@ -0,0 +1,85 @@
+---
+description: "面向 DeepSeek Harness 的可安装单包 FreeCodeGo 组合：安装渠道、发布打标，以及随包交付的 Agent Teams 组合。"
+kind: "package-bundle"
+---
+
+# FreeCodeGo Harness Bundle
+
+[English](README.md) | 中文
+
+## 概述
+
+面向 DeepSeek Harness `freecodego@0.1.6-alpha.2` 的可安装单包 FreeCodeGo 组合，目标 Harness 基线为 `0.1.6-alpha.2`。npm 产物包含编译后的 Host 插件、浏览器端 client、会话事件前置包、原生 worker 入口，以及随包交付的 Harness Agent Teams 组合。发布产物使用 npm 的 `next` dist-tag，且其插件版本刻意与所面向的 Harness 版本完全一致；需要可复现安装时请指定版本（`freecodego@0.1.6-alpha.2`），而不是渠道名。官方 Codex 与 Claude 运行时二进制仍按平台可选下载——本包不内嵌每个平台的原生二进制。
+
+## 目录
+
+- [安装](#install)
+- [Agent Teams](#agent-teams)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="install"></a>
+## 安装
+
+安装你实际运行的那条 Harness 基线对应的 release；每个 release 只带一个 tarball，名字即它所挂载的基线：
+
+```sh
+dsh plugin --profile web add --save-exact \
+  https://github.com/XiangSu-ce/dsh-plugin-freecodego/releases/download/freecodego-v0.1.6-alpha.2/freecodego-0.1.6-alpha.2.tgz
+```
+
+`freecodego-0.1.6-alpha.2.tgz` 就是面向 Harness `0.1.6-alpha.2` 的 bundle：请替换为你实际运行的版本，设置页会把它显示在已装插件版本旁边。资产名即 `packages/freecodego/AGENTS.md` 里的命名约定。
+
+`dsh` 命令由 Harness CLI 提供，不来自本 bundle。普通终端里请先用 `npm install --global @deepseek-ai/dsh` 安装它（并确保 `pnpm` 可用）。桌面端通过自己的私有 shim 运行同一条命令并传入当前 `DSH_HOME`，因此 Web 与桌面端选择同一个 Harness home 时共用同一份 Profile 数据目录。
+
+维护者从 tag 发布。`pnpm run release:freecodego <version>` 会提升 bundle 版本并创建 `freecodego-v<version>` tag，然后从该 tag 触发工作流：
+
+```sh
+pnpm run release:freecodego <version>
+gh workflow run release-freecodego.yml --ref freecodego-v<version>
+```
+
+工作流先校验家族、构建、打包，再为这个 tag 创建 GitHub release。若打包出来的文件没有带着更新检查所寻找的资产名，它会拒绝发布；发布之后还会按插件读取 release 的方式复验一遍，才会让本次运行通过。该家族只允许从 `freecodego-v*` tag 发布，且 tag 必须命名工作区实际携带的版本，所以从分支触发的运行会在构建之前失败，而不是之后。
+
+-----
+
+<a id="agent-teams"></a>
+## Agent Teams
+
+bundle 以同引擎子会话启用 Harness Agent Teams。DeepSeek 父会话创建 DeepSeek 队友，Codex 父会话创建 Codex 队友，Claude 父会话创建 Claude 队友；子会话路由继承自父会话，而不是从进程默认值中选取。团队名册、邮箱、任务看板与队友 Session 记录仍由 Harness 持有。Web Chat 在父对话内渲染实时的委派 Agent 进度树，包括每个任务标签、当前工具、状态与工具使用次数。
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+间接地，经由 bundle 挂载的各个包；每个被插入的行由它自己的包决定模型可见行为。
+
+#### KV Cache 影响
+
+bundle 自身不改动请求文本，已缓存的 prefix 完全由被组合的行产生。
+
+## 已知限制与延期工作
+<a id="known-limitations-and-deferred-work"></a>
+
+- **产物是组装出来的，不是手写的** —— `prepack` 会重建 Host 插件、浏览器客户端、原生 worker 入口与 Agent Teams 组合；tarball 里没有任何内容是手工编辑的。
+- **版本与 Harness 基线完全一致** —— hotfix 让 tag 保持精确，而发布资产在名字里保留基线。
+- **官方运行时二进制仍是可选的平台下载** —— 本包不内嵌每个平台的原生二进制。
+- **安装按版本钉住** —— 可复现的安装点名基线，而不是通道。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
+
+不发布运行时不变式伴生入口，因为 bundle 是静态组合元数据，本身没有运行时注册关系。
+
+插件版本与 Harness 版本完全一致是刻意的：针对某个基线组装的 bundle 组合的是该基线的行，因此独立版本号只会诱导用户安装一对从未被任何构建测试过的组合。
+
+</details>
+
+**运行时不变式：** bundle 以数据形式声明其组合（`dsh.bundle.patch`）；它不持有运行时状态。

package/cordis.patch.yml

@@ -0,0 +1,56 @@
+# Standard DeepSeek Harness 0.1.6-alpha.2 FreeCodeGo composition.
+- id: llm-deepseek
+  disabled: true
+- id: web-search-deepseek
+  disabled: true
+- id: system-prompt
+  config:
+    persona: >-
+      You are a coding agent powered by FreeCodeGo. Your working directory is
+      {{cwd}}. Harness owns the active workspace, session history, permissions,
+      tools, and model routing. Never reveal internal provider IDs, route keys,
+      or transport aliases to the user. When asked about model identity,
+      identify as the FreeCodeGo coding agent; do not infer, claim, or speculate
+      about an underlying model identity.
+- id: session-persistence-jsonl
+  inject:
+    - freeCodeGoSessionEvents
+- insert:
+    - id: freecodego-session-events
+      name: 'freecodego/session-events'
+    # The Harness's team runtime, loaded BEFORE the FreeCodeGo plugin. The order is
+    # load-bearing: the plugin decides at construction whether to register its own
+    # board and member lifecycle, and that decision has to be settled before the
+    # first request catalog is assembled rather than changing mid-session. Nothing
+    # here depends on FreeCodeGo, so the earlier position costs nothing.
+    - id: freecodego-agent-team
+      name: 'freecodego/agent-team'
+      config:
+        maxMembers: 8
+        maxTasks: 256
+        maxPendingMessagesPerMember: 64
+        maxMessageBytes: 65536
+        disposalTimeoutMs: 5000
+    - id: freecodego-tool-agent-team
+      name: 'freecodego/tool-agent-team'
+      config:
+        freshProvider: spawn
+        forkProvider: fork
+    # The Harness's own reminder scheduler. It is not mounted by any upstream
+    # bundle — only by an example config — so without this row the composition has
+    # `@deepseek-ai/dsh-client-ui-schedule` on the client plane with no host
+    # projection behind it, and no `schedule_create`/`schedule_list`/
+    # `schedule_delete` for a model to call. The plugin's own cron tools used to
+    # stand in for those three verbs; this row is what replaced them.
+    - id: freecodego-schedule
+      name: 'freecodego/schedule'
+    # The Harness's Auto-preset authorization gate: while a session's permission
+    # preset is `auto`, every native call is classified by a reviewer before its
+    # body runs. Mounting it also advertises the preset, which is the only way a
+    # user can select it. The plugin's own approval reviewer stands down on this
+    # preset (see action-reviewer.ts), so an Auto action gets one verdict, not two.
+    - id: freecodego-auto-review
+      name: 'freecodego/auto-review'
+    - id: freecodego
+      name: 'freecodego'
+      config: {}