sino-v2 0.2.0

package/README.md

@@ -0,0 +1,203 @@
+<p align="center">
+  <img src="docs/logo-ghost-wave-effect.svg" alt="SinoAgent" width="360"/>
+</p>
+
+<p align="center">
+  <strong>English</strong>
+  &nbsp;·&nbsp;
+  <a href="./README.zh-CN.md">简体中文</a>
+  &nbsp;·&nbsp;
+  <a href="./docs/GUIDE.md">Guide</a>
+  &nbsp;·&nbsp;
+  <a href="./docs/ACP.md">ACP</a>
+  &nbsp;·&nbsp;
+  <a href="./docs/EXTENSIONS.md">Extensions</a>
+  &nbsp;·&nbsp;
+  <a href="./docs/SPEC.md">Spec</a>
+  &nbsp;·&nbsp;
+  <a href="https://gitee.com/wqy_94/sino-agentv2">Website</a>
+  &nbsp;·&nbsp;
+  <strong><a href="https://discord.gg/XF78rEME2D">Discord</a></strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/sinoagent"><img src="https://img.shields.io/npm/v/sinoagent.svg?style=flat-square&color=cb3837&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a>
+  <a href="https://gitee.com/wqy_94/sino-agentv2/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/wqy_94/sino-agentv2/ci.yml?style=flat-square&label=ci&labelColor=161b22&logo=githubactions&logoColor=white" alt="CI"/></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/sinoagent.svg?style=flat-square&color=8b949e&labelColor=161b22" alt="license"/></a>
+  <a href="https://www.npmjs.com/package/sinoagent"><img src="https://img.shields.io/npm/dm/sinoagent.svg?style=flat-square&color=3fb950&labelColor=161b22&label=downloads" alt="downloads"/></a>
+  <a href="https://gitee.com/wqy_94/sino-agentv2/stargazers"><img src="https://img.shields.io/github/stars/wqy_94/sino-agentv2.svg?style=flat-square&color=dbab09&labelColor=161b22&logo=github&logoColor=white" alt="GitHub stars"/></a>
+  <a href="https://gitee.com/wqy_94/sino-agentv2"><img src="https://gitee.com/wqy_94/sino-agentv2/star/badge.svg" alt="AtomGit stars"/></a>
+  <a href="https://gitee.com/wqy_94/sino-agentv2/graphs/contributors"><img src="https://img.shields.io/github/contributors/wqy_94/sino-agentv2.svg?style=flat-square&color=bc8cff&labelColor=161b22&logo=github&logoColor=white" alt="contributors"/></a>
+  <a href="https://gitee.com/wqy_94/sino-agentv2/discussions"><img src="https://img.shields.io/github/discussions/wqy_94/sino-agentv2.svg?style=flat-square&color=58a6ff&labelColor=161b22&logo=github&logoColor=white" alt="Discussions"/></a>
+  <a href="https://discord.gg/XF78rEME2D"><img src="https://img.shields.io/badge/discord-join-5865F2.svg?style=flat-square&labelColor=161b22&logo=discord&logoColor=white" alt="Discord"/></a>
+</p>
+
+<p align="center">
+  <a href="https://trendshift.io/repositories/27020?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27020/monthly?language=Go" alt="wqy_94/sino-agentv2 | Trendshift" width="250" height="55"/></a>
+  <a href="https://trendshift.io/repositories/27020?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/27020" alt="wqy_94/sino-agentv2 | Trendshift" width="250" height="55"/></a>
+</p>
+
+<br/>
+
+<p align="center"><strong>Open source · MIT · a single Go binary</strong></p>
+<h3 align="center">A coding agent you can leave running.</h3>
+<p align="center">One local engine, two ways in — terminal, or your editor over ACP. Plan mode, permissions, a workspace sandbox and per-turn checkpoints keep a long autonomous run something you can still read and undo.</p>
+
+<div align="center">
+  <video src="https://github.com/user-attachments/assets/ab2f3878-e224-4931-8254-060e7695cfb9" controls preload="metadata" width="560"></video>
+</div>
+
+<br/>
+
+> [!IMPORTANT]
+> **Community · 加入社区** — bilingual Discord for setup help (`#help` / `#求助`), workflow showcases, and feature ideas. → **<https://discord.gg/XF78rEME2D>**
+
+<br/>
+
+## Features
+
+- **Config-driven.** Providers, the agent, enabled tools, and plugins are all
+  declared in `sinoagent.toml`. No hardcoded models.
+- **Multi-model & composable.** DeepSeek ships as a preset; any
+  OpenAI-compatible endpoint is a config entry, not new code. Optionally run
+  two models together (executor + planner) in separate, cache-stable sessions.
+- **Plugin-driven.** MCP servers contribute tools, prompts, and resources;
+  Extension Protocol v1 sidecars can also intercept runtime events, contribute
+  Providers and structured UI, and ship versioned plugin packages.
+- **Cache-aware context maintenance.** Startup injects a small stable environment
+  summary, stale tool output is snipped/pruned before summary compaction, and the
+  built-in tool schema contract is documented for regression review.
+- **Zero-friction distribution.** `CGO_ENABLED=0` single binary; cross-compile
+  to six targets with one command. The result is a fully self-contained static
+  binary — nothing to install on the target machine beyond the binary itself.
+
+## Install
+
+SinoAgent is a single native CLI binary.
+
+### CLI / TUI
+
+Install the native binary through npm on any supported platform, or use
+Homebrew on macOS:
+
+```sh
+npm i -g sinov2                # one-command install; also: npm i -g @sinoagent/sinov2
+brew install wqy_94/sinoagent/sino   # macOS
+```
+
+Prebuilt archives (`darwin|linux|windows × amd64|arm64`) and `SHA256SUMS` are on
+every [release](https://gitee.com/wqy_94/sino-agentv2/releases).
+
+### Build from source
+
+Clone the repository first:
+
+```sh
+git clone https://gitee.com/wqy_94/sino-agentv2.git
+cd sino-agentv2
+```
+
+The CLI build requires **Go 1.25+**. The module pins a `toolchain` directive;
+keep `GOTOOLCHAIN=auto` so Go downloads the pinned toolchain, or install it.
+
+```sh
+make build      # -> bin/sino(.exe)
+make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)
+```
+
+## Quick start
+
+### CLI / TUI
+
+These commands are for the CLI/TUI installed through Path A:
+
+```sh
+sino setup                      # configure a provider and model
+sino                            # start an interactive session
+sino run "implement the TODOs in main.go"
+```
+
+In an interactive session, run `/init` when you want SinoAgent to create project
+instructions.
+
+For advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.md)**,
+**[Guide](./docs/GUIDE.md)**, and
+**[configuration paths](./docs/CONFIG_PATHS.md)**.
+
+## Documentation
+
+- **Getting started:** [Guide](./docs/GUIDE.md) · [CLI reference](./docs/CLI.md) ·
+  [Configuration paths](./docs/CONFIG_PATHS.md) · [ACP editor integration](./docs/ACP.md)
+- **Features & troubleshooting:** [Subagent profiles](./docs/SUBAGENT_PROFILES.md) ·
+  [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.md) ·
+  [Capability diagnostics](./docs/CAPABILITY_DIAGNOSTICS.md) ·
+  [Recovery and updates](./docs/RECOVERY.md) · [Bot guide](./docs/BOT_GUIDE.md) ·
+  [Checkpoints & rewind](./docs/CHECKPOINTS.md)
+- **Engineering & migration:** [Spec](./docs/SPEC.md) ·
+  [Task contracts & pause policy](./docs/TASK_CONTRACT.md) ·
+  [Tool contract](./docs/TOOL_CONTRACT.md) · [Migrating from 0.x](./docs/MIGRATING.md)
+- **Extension development:** [Extensions](./docs/EXTENSIONS.md) ·
+  [Plugin packages and Manifest v1](./docs/PLUGIN_PACKAGES.md) ·
+  [Extension Protocol](./docs/EXTENSION_PROTOCOL.md) ·
+  [Go SDK and starter](./sdk/go/README.md)
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=wqy_94%2Fsino-agentv2&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://gitee.com/wqy_94/sino-agentv2/raw/main/star-history/assets/star-history/star-history-dark.svg" />
+   <source media="(prefers-color-scheme: light)" srcset="https://gitee.com/wqy_94/sino-agentv2/raw/main/star-history/assets/star-history/star-history-light.svg" />
+   <img alt="Star History Chart" src="https://gitee.com/wqy_94/sino-agentv2/raw/main/star-history/assets/star-history/star-history-light.svg" />
+ </picture>
+</a>
+
+<br/>
+
+## Acknowledgments
+
+A small list of folks whose work has shaped SinoAgent the most — the current top
+20 contributors by commit count. The full contributor graph is on
+[GitHub](https://gitee.com/wqy_94/sino-agentv2/graphs/contributors?all=1).
+
+<!-- sinoagent-top-contributors:start -->
+| Contributor | Contributor | Contributor | Contributor |
+| --- | --- | --- | --- |
+| [**wqy_94**](https://gitee.com/wqy_94/sino-agentv2) | [**wqy_94**](https://gitee.com/wqy_94/sino-agentv2) | [**wqy_94**](https://gitee.com/wqy_94/sino-agentv2) | [**wqy_94**](https://gitee.com/wqy_94/sino-agentv2) |
+| **sinoagent** | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) |
+| **merge-order-check** | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** |
+| [**CVEngineer66**](https://github.com/CVEngineer66) | [**dependabot\[bot\]**](https://github.com/apps/dependabot) | [**lanshi17**](https://github.com/lanshi17) | [**SuMuxi66**](https://github.com/SuMuxi66) |
+| [**CnsMaple**](https://github.com/CnsMaple) | [**cyq1017**](https://github.com/cyq1017) | [**JesonChou**](https://github.com/JesonChou) | [**XTLine**](https://github.com/XTLine) |
+<!-- sinoagent-top-contributors:end -->
+
+Special thanks to [**Bernardxu123**](https://github.com/Bernardxu123) for designing the project logo and intro video.
+
+<p align="center">
+  <a href="https://gitee.com/wqy_94/sino-agentv2/graphs/contributors">
+    <img src="https://contrib.rocks/image?repo=wqy_94/sino-agentv2&max=100&columns=12" alt="Contributors to wqy_94/sino-agentv2" width="860"/>
+  </a>
+</p>
+
+<br/>
+
+---
+
+<p align="center">
+  <sub>MIT — see <a href="./LICENSE">LICENSE</a></sub>
+  <br/>
+  <sub>Built by the community at <a href="https://gitee.com/wqy_94/sino-agentv2/graphs/contributors">wqy_94/sino-agentv2</a></sub>
+</p>
+
+---
+
+<p align="center"><sub><strong>Support this project</strong></sub></p>
+
+If SinoAgent has been useful and you'd like to say thanks, you can. It stays a
+coffee, not a contract — donations don't buy feature priority or change how
+issues get triaged.
+
+- **International** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)
+- **国内** — 微信支付（扫码）
+
+<p align="center">
+  <img src=".github/sponsor/wechat-pay.jpg" alt="WeChat Pay QR code" width="180"/>
+</p>

package/bin/sino.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+
+const pkg = `@sinoagent/cli-${process.platform}-${process.arch}`;
+const exe = `sino${process.platform === "win32" ? ".exe" : ""}`;
+
+let binary;
+try {
+  binary = require.resolve(`${pkg}/bin/${exe}`);
+} catch {
+  console.error(
+    `sino: no prebuilt binary for ${process.platform}-${process.arch}.\n` +
+      `Install the matching optional package (${pkg}), or build from source:\n` +
+      `  https://gitee.com/wqy_94/sino-agentv2`,
+  );
+  process.exit(1);
+}
+
+const res = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (res.error) throw res.error;
+process.exit(res.status === null ? 1 : res.status);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "sino-v2",
+  "version": "0.2.0",
+  "description": "Cache-first DeepSeek coding agent for the terminal.",
+  "bin": {
+    "sino": "bin/sino.js"
+  },
+  "files": [
+    "bin/sino.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "homepage": "https://gitee.com/wqy_94/sino-agentv2#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/wqy_94/sino-agentv2.git"
+  },
+  "bugs": {
+    "url": "https://gitee.com/wqy_94/sino-agentv2/issues"
+  },
+  "keywords": [
+    "deepseek",
+    "ai",
+    "agent",
+    "cli",
+    "coding-assistant",
+    "tui"
+  ],
+  "optionalDependencies": {
+    "@sinoagent/cli-darwin-arm64": "0.2.0",
+    "@sinoagent/cli-darwin-x64": "0.2.0",
+    "@sinoagent/cli-linux-arm64": "0.2.0",
+    "@sinoagent/cli-linux-x64": "0.2.0",
+    "@sinoagent/cli-win32-arm64": "0.2.0",
+    "@sinoagent/cli-win32-x64": "0.2.0"
+  },
+  "sinoagentCandidateSha": "d984f7754216a59297259c0b908f0af80c782d28"
+}