dsh-ap-three-way 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -36,6 +36,10 @@
36
36
 
37
37
  ## [Unreleased]
38
38
 
39
+ ## [0.2.1] - 2026-11-22
40
+
41
+ - Compatibility: declare DeepSeek Harness 0.2.3-alpha.1 support (>=0.2.3-0 <0.3.0-0 in engines.dsh and every @deepseek-ai/dsh-* peer range) and refresh README verification stamps.
42
+
39
43
  ### Added
40
44
 
41
45
  - `ap_tolerance_match`: three-way match with a configurable policy — price, quantity and amount tolerances in basis points, explicit `matched`/`exception` reasons, and header-only GRN treated as "no receipt". Read-only; it does not overwrite stored matches. Verified by `node --test test/*.test.mjs` (8/8); fixtures are our own public/synthetic rows.
package/README.en.md CHANGED
@@ -1,5 +1,10 @@
1
1
  <div align="center">
2
2
 
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: real local test-run terminal output — four tests passed, zero failed; one real capture shared by both colour schemes">
6
+ </picture>
7
+
3
8
  <picture>
4
9
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
5
10
  <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="dsh-ap-three-way data flow: invoice/PO/GRN CSV and invoice XML → ap_import into the local storage domain → ap_match three-way match (1% price tolerance) → ap_export Matches/Exceptions workpaper; ap_tolerance_match and ap_duplicate_check are read-only">
@@ -11,6 +16,8 @@
11
16
 
12
17
  A purely local AP three-way-match plugin for DeepSeek Harness: CSV/XML import, a 1% default price tolerance, a bps-tunable tolerance policy, and duplicate-line detection — no network, no model call.
13
18
 
19
+ Last verified on DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
14
21
  [Install](#three-step-setup) · [Configuration](#configuration) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
22
 
16
23
  [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
@@ -103,7 +110,7 @@ Every PerryLink plugin is listed in the built-in DSH Desktop market: **Market
103
110
 
104
111
  Tool names are a stable API (a compatibility promise since 0.1.0 — breaking changes require a minor bump). Writing tools are marked **R1 (local write)**, read-only tools **R0**.
105
112
 
106
- Since 0.2.0 tool names use underscores (e.g. `ap_import`): the provider validates `tools[].name` against `^[a-zA-Z0-9_-]+$`, and a dot makes it reject the whole `tools` array. The old dotted names are no longer registered — migrate using the table below.
113
+ Since 0.2.1 tool names use underscores (e.g. `ap_import`): the provider validates `tools[].name` against `^[a-zA-Z0-9_-]+$`, and a dot makes it reject the whole `tools` array. The old dotted names are no longer registered — migrate using the table below.
107
114
 
108
115
  | Tool | Purpose | Risk |
109
116
  |---|---|---|
@@ -142,6 +149,10 @@ node samples/quickstart/run.mjs --json # canonical result — the source of the
142
149
 
143
150
  *Synthetic sample → gold file `samples/quickstart/expected/result.json`; the command and output hashes are recorded in `screenshots.json` (real run on 2026-11-02).*
144
151
 
152
+ ![Real dsh-ap-three-way quickstart run output](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *Animated replay of a real run recorded in this repository.*
155
+
145
156
  Public-fixture acceptance: input [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (public MIT sample); re-run `node scripts/acceptance.mjs`. Details in `ACCEPTANCE.csv`, quoted verbatim:
146
157
 
147
158
  ```text
@@ -269,7 +280,7 @@ node scripts/acceptance.mjs # re-run the public/sy
269
280
  node samples/quickstart/run.mjs # synthetic sample, should print quickstart ok
270
281
  ```
271
282
 
272
- Current version `0.2.0` (matches `package.json`). Tests: `node --test test/*.test.mjs` all green (11 test files, 27 cases; `pnpm test` builds first). The README images are generated programmatically by [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; light/dark SVG flow pair shared by all five languages) and are safe to re-run: `python scripts/gen-readme-assets.py`.
283
+ Current version `0.2.1` (matches `package.json`). Tests: `node --test test/*.test.mjs` all green (11 test files, 27 cases; `pnpm test` builds first). The README images are generated programmatically by [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; light/dark SVG flow pair shared by all five languages) and are safe to re-run: `python scripts/gen-readme-assets.py`.
273
284
 
274
285
  Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
275
286
 
package/README.es.md CHANGED
@@ -1,5 +1,10 @@
1
1
  <div align="center">
2
2
 
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: salida real de terminal de la ejecución local de pruebas — cuatro pruebas pasadas, cero fallidas; una sola captura real compartida por ambos esquemas de color">
6
+ </picture>
7
+
3
8
  <picture>
4
9
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
5
10
  <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="Flujo de datos de dsh-ap-three-way: CSV de factura/OC/recepción y XML de factura → ap_import al dominio de almacenamiento local → ap_match conciliación triple (tolerancia de precio del 1%) → ap_export hoja Matches/Exceptions; ap_tolerance_match y ap_duplicate_check son de solo lectura">
@@ -11,6 +16,8 @@
11
16
 
12
17
  Un plugin de conciliación triple de AP puramente local para DeepSeek Harness: importación CSV/XML, tolerancia de precio predeterminada del 1%, política de tolerancia ajustable en bps y detección de líneas duplicadas — sin red y sin llamadas a un modelo.
13
18
 
19
+ Última verificación: DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
14
21
  [Instalar](#instalación-en-tres-pasos) · [Configuración](#configuración) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
22
 
16
23
  [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
@@ -103,7 +110,7 @@ Todos los plugins de PerryLink están en el mercado integrado de DSH Desktop: **
103
110
 
104
111
  Los nombres de las herramientas son una API estable (promesa de compatibilidad desde 0.1.0: los cambios disruptivos requieren un bump minor). Las herramientas que escriben se marcan **R1 (escritura local)** y las de solo lectura **R0**.
105
112
 
106
- Desde 0.2.0 los nombres usan guiones bajos (p. ej. `ap_import`): el proveedor valida `tools[].name` con `^[a-zA-Z0-9_-]+$` y un punto hace que se rechace todo el array `tools`. Los nombres con punto ya no se registran; migra según la tabla siguiente.
113
+ Desde 0.2.1 los nombres usan guiones bajos (p. ej. `ap_import`): el proveedor valida `tools[].name` con `^[a-zA-Z0-9_-]+$` y un punto hace que se rechace todo el array `tools`. Los nombres con punto ya no se registran; migra según la tabla siguiente.
107
114
 
108
115
  | Herramienta | Propósito | Riesgo |
109
116
  |---|---|---|
@@ -142,6 +149,10 @@ node samples/quickstart/run.mjs --json # resultado canónico — origen del oro
142
149
 
143
150
  *Muestra sintética → archivo de oro `samples/quickstart/expected/result.json`; el comando y los hashes de salida están en `screenshots.json` (ejecución real del 2026-11-02).*
144
151
 
152
+ ![Salida real de la ejecución del quickstart de dsh-ap-three-way](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *Repetición animada de una ejecución real registrada en este repositorio.*
155
+
145
156
  Aceptación con fixture pública: entrada [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (muestra MIT pública); se repite con `node scripts/acceptance.mjs`. Detalle en `ACCEPTANCE.csv`, citado literalmente:
146
157
 
147
158
  ```text
@@ -269,7 +280,7 @@ node scripts/acceptance.mjs # repetir la aceptaci
269
280
  node samples/quickstart/run.mjs # muestra sintética, debe imprimir quickstart ok
270
281
  ```
271
282
 
272
- Versión actual `0.2.0` (coincide con `package.json`). Pruebas: `node --test test/*.test.mjs` todo en verde (11 archivos de prueba, 27 casos; `pnpm test` compila primero). Las imágenes del README se generan programáticamente con [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; par SVG de flujo claro/oscuro compartido por los cinco idiomas) y se pueden repetir: `python scripts/gen-readme-assets.py`.
283
+ Versión actual `0.2.1` (coincide con `package.json`). Pruebas: `node --test test/*.test.mjs` todo en verde (11 archivos de prueba, 27 casos; `pnpm test` compila primero). Las imágenes del README se generan programáticamente con [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; par SVG de flujo claro/oscuro compartido por los cinco idiomas) y se pueden repetir: `python scripts/gen-readme-assets.py`.
273
284
 
274
285
  Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
275
286
 
package/README.hi.md CHANGED
@@ -1,5 +1,10 @@
1
1
  <div align="center">
2
2
 
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: स्थानीय परीक्षण रन का वास्तविक टर्मिनल आउटपुट — चार परीक्षण पास, शून्य विफल; एक ही वास्तविक कैप्चर दोनों रंग-योजनाओं के लिए साझा">
6
+ </picture>
7
+
3
8
  <picture>
4
9
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
5
10
  <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="dsh-ap-three-way डेटा प्रवाह: इनवॉइस/PO/GRN CSV और इनवॉइस XML → ap_import स्थानीय स्टोरेज डोमेन में → ap_match तीन-तरफ़ा मिलान (1% मूल्य टॉलरेंस) → ap_export Matches/Exceptions वर्कपेपर; ap_tolerance_match और ap_duplicate_check रीड-ओनली हैं">
@@ -11,6 +16,8 @@
11
16
 
12
17
  DeepSeek Harness के लिए पूरी तरह स्थानीय AP तीन-तरफ़ा मिलान प्लगइन: CSV/XML इम्पोर्ट, 1% डिफ़ॉल्ट मूल्य टॉलरेंस, bps में समायोज्य टॉलरेंस नीति और डुप्लिकेट पंक्ति पहचान — बिना नेटवर्क, बिना मॉडल कॉल।
13
18
 
19
+ अंतिम सत्यापन: DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
14
21
  [इंस्टॉल](#तीन-चरणों-में-शुरुआत) · [कॉन्फ़िगरेशन](#कॉन्फ़िगरेशन) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
22
 
16
23
  [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
@@ -103,7 +110,7 @@ dsh plugin --profile <profile> add dsh-ap-three-way
103
110
 
104
111
  टूल नाम स्थिर API हैं (0.1.0 से संगतता वचन: ब्रेकिंग बदलाव के लिए minor बम्प आवश्यक)। लिखने वाले टूल **R1 (स्थानीय लेखन)**, रीड-ओनली टूल **R0** चिह्नित हैं।
105
112
 
106
- 0.2.0 से टूल नामों में अंडरस्कोर है (जैसे `ap_import`): प्रोवाइडर `tools[].name` को `^[a-zA-Z0-9_-]+$` से जाँचता है, और बिंदु होने पर पूरा `tools` ऐरे अस्वीकार हो जाता है। पुराने बिंदु-युक्त नाम अब पंजीकृत नहीं होते; नीचे की तालिका के अनुसार माइग्रेट करें।
113
+ 0.2.1 से टूल नामों में अंडरस्कोर है (जैसे `ap_import`): प्रोवाइडर `tools[].name` को `^[a-zA-Z0-9_-]+$` से जाँचता है, और बिंदु होने पर पूरा `tools` ऐरे अस्वीकार हो जाता है। पुराने बिंदु-युक्त नाम अब पंजीकृत नहीं होते; नीचे की तालिका के अनुसार माइग्रेट करें।
107
114
 
108
115
  | टूल | उद्देश्य | जोखिम |
109
116
  |---|---|---|
@@ -142,6 +149,10 @@ node samples/quickstart/run.mjs --json # कैनोनिकल परिण
142
149
 
143
150
  *सिंथेटिक सैंपल → गोल्ड फ़ाइल `samples/quickstart/expected/result.json`; कमांड और आउटपुट हैश `screenshots.json` में दर्ज हैं (2026-11-02 का वास्तविक रन)।*
144
151
 
152
+ ![dsh-ap-three-way quickstart रन का वास्तविक आउटपुट](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *इस रिपॉज़िटरी में दर्ज असली रन का एनिमेटेड रीप्ले।*
155
+
145
156
  सार्वजनिक fixture स्वीकृति: इनपुट [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (सार्वजनिक MIT सैंपल); `node scripts/acceptance.mjs` से दोबारा चलाएँ। विवरण `ACCEPTANCE.csv` में, यथामूल्य उदृत:
146
157
 
147
158
  ```text
@@ -269,7 +280,7 @@ node scripts/acceptance.mjs # सार्वज
269
280
  node samples/quickstart/run.mjs # सिंथेटिक सैंपल, quickstart ok प्रिंट करना चाहिए
270
281
  ```
271
282
 
272
- वर्तमान वर्ज़न `0.2.0` (`package.json` से मेल खाता है)। टेस्ट: `node --test test/*.test.mjs` सब हरे (11 टेस्ट फ़ाइलें, 27 केस; `pnpm test` पहले बिल्ड करता है)। README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) से प्रोग्रामेटिक रूप से बनती हैं (Python; सभी पाँच भाषाओं में साझा light/dark SVG फ़्लो जोड़ी) और दोबारा चलाई जा सकती हैं: `python scripts/gen-readme-assets.py`।
283
+ वर्तमान वर्ज़न `0.2.1` (`package.json` से मेल खाता है)। टेस्ट: `node --test test/*.test.mjs` सब हरे (11 टेस्ट फ़ाइलें, 27 केस; `pnpm test` पहले बिल्ड करता है)। README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) से प्रोग्रामेटिक रूप से बनती हैं (Python; सभी पाँच भाषाओं में साझा light/dark SVG फ़्लो जोड़ी) और दोबारा चलाई जा सकती हैं: `python scripts/gen-readme-assets.py`।
273
284
 
274
285
  Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
275
286
 
package/README.md CHANGED
@@ -1,5 +1,10 @@
1
1
  <div align="center">
2
2
 
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way:本机真实测试运行的终端输出——4 项测试全部通过(0 失败);单张真实截图,深浅两种主题共用">
6
+ </picture>
7
+
3
8
  <picture>
4
9
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
5
10
  <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="dsh-ap-three-way 数据流:发票/PO/GRN 的 CSV 与发票 XML → ap_import 导入本地存储域 → ap_match 三单匹配(1% 价格容差)→ ap_export 导出 Matches/Exceptions 底稿;ap_tolerance_match 与 ap_duplicate_check 只读">
@@ -11,6 +16,8 @@
11
16
 
12
17
  面向 DeepSeek Harness 的纯本地 AP 三单匹配插件:CSV/XML 导入、默认 1% 价格容差、可按 bps 调整的容差策略与重复行检测,全程不联网、不调用模型。
13
18
 
19
+ 最近一次核验:DeepSeek Harness `dsh-v0.2.3-alpha.1`(2026-11-22)。
20
+
14
21
  [安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
22
 
16
23
  [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
@@ -101,7 +108,7 @@ dsh plugin --profile <profile> add dsh-ap-three-way
101
108
 
102
109
  工具名是稳定 API(0.1.0 起有兼容承诺,破坏性变更需 minor 版本);写文件的工具标 **R1(本地写)**,只读工具标 **R0**。
103
110
 
104
- 0.2.0 起工具名改用下划线(如 `ap_import`):provider 对 `tools[].name` 校验 `^[a-zA-Z0-9_-]+$`,点号会让整个 `tools` 数组被拒;旧点号名不再注册,请按下表迁移。
111
+ 0.2.1 起工具名改用下划线(如 `ap_import`):provider 对 `tools[].name` 校验 `^[a-zA-Z0-9_-]+$`,点号会让整个 `tools` 数组被拒;旧点号名不再注册,请按下表迁移。
105
112
 
106
113
  | 工具 | 用途 | 风险 |
107
114
  |---|---|---|
@@ -140,6 +147,10 @@ node samples/quickstart/run.mjs --json # 规范化结果,即金标 expected/re
140
147
 
141
148
  *合成样例 → 金标 `samples/quickstart/expected/result.json`;命令与输出哈希见 `screenshots.json`(2026-11-02 真实运行)。*
142
149
 
150
+ ![dsh-ap-three-way quickstart 真实运行输出](docs/assets/dsh-ap-three-way-demo.gif)
151
+
152
+ *本仓库一次真实运行的动图回放。*
153
+
143
154
  公开 fixture 验收:输入 [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml)(公开 MIT 样本),重跑 `node scripts/acceptance.mjs`,明细见 `ACCEPTANCE.csv`:
144
155
 
145
156
  | req_id | metric | threshold | actual | pass | source | counted |
@@ -260,7 +271,7 @@ node scripts/acceptance.mjs # 重跑公开/合成
260
271
  node samples/quickstart/run.mjs # 合成样例,应输出 quickstart ok
261
272
  ```
262
273
 
263
- 当前版本 `0.2.0`(与 `package.json` 一致)。测试:`node --test test/*.test.mjs` 全绿(11 个测试文件、27 个用例;`pnpm test` 已内置构建步骤)。配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python;SVG 流程图深浅双版、五语共用),可重复执行:`python scripts/gen-readme-assets.py`。
274
+ 当前版本 `0.2.1`(与 `package.json` 一致)。测试:`node --test test/*.test.mjs` 全绿(11 个测试文件、27 个用例;`pnpm test` 已内置构建步骤)。配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python;SVG 流程图深浅双版、五语共用),可重复执行:`python scripts/gen-readme-assets.py`。
264
275
 
265
276
  Topics:`deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
266
277
 
package/README.pt.md CHANGED
@@ -1,5 +1,10 @@
1
1
  <div align="center">
2
2
 
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-hero-en-light.png">
5
+ <img src="docs/assets/dsh-ap-three-way-hero-en-light.png" width="100%" alt="dsh-ap-three-way: saída real de terminal da execução local de testes — quatro testes passaram, zero falharam; uma única captura real partilhada pelos dois esquemas de cor">
6
+ </picture>
7
+
3
8
  <picture>
4
9
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-ap-three-way-flow-dark.svg">
5
10
  <img src="docs/assets/dsh-ap-three-way-flow-light.svg" width="100%" alt="Fluxo de dados do dsh-ap-three-way: CSV de fatura/OC/recebimento e XML de fatura → ap_import no domínio de armazenamento local → ap_match conciliação tripla (tolerância de preço de 1%) → ap_export planilha Matches/Exceptions; ap_tolerance_match e ap_duplicate_check são somente leitura">
@@ -11,6 +16,8 @@
11
16
 
12
17
  Um plugin de conciliação tripla de AP puramente local para o DeepSeek Harness: importação CSV/XML, tolerância de preço padrão de 1%, política de tolerância ajustável em bps e detecção de linhas duplicadas — sem rede e sem chamada a modelo.
13
18
 
19
+ Última verificação: DeepSeek Harness `dsh-v0.2.3-alpha.1` (2026-11-22).
20
+
14
21
  [Instalar](#instalação-em-três-passos) · [Configuração](#configuração) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
22
 
16
23
  [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
@@ -103,7 +110,7 @@ Todos os plugins da PerryLink estão na loja embutida do DSH Desktop: **Market
103
110
 
104
111
  Os nomes das ferramentas são uma API estável (promessa de compatibilidade desde 0.1.0: mudanças disruptivas exigem bump minor). Ferramentas que escrevem são marcadas **R1 (escrita local)**, as de somente leitura **R0**.
105
112
 
106
- Desde 0.2.0 os nomes usam sublinhado (ex.: `ap_import`): o provedor valida `tools[].name` com `^[a-zA-Z0-9_-]+$` e um ponto faz o array `tools` inteiro ser rejeitado. Os nomes com ponto não são mais registrados; migre conforme a tabela abaixo.
113
+ Desde 0.2.1 os nomes usam sublinhado (ex.: `ap_import`): o provedor valida `tools[].name` com `^[a-zA-Z0-9_-]+$` e um ponto faz o array `tools` inteiro ser rejeitado. Os nomes com ponto não são mais registrados; migre conforme a tabela abaixo.
107
114
 
108
115
  | Ferramenta | Finalidade | Risco |
109
116
  |---|---|---|
@@ -142,6 +149,10 @@ node samples/quickstart/run.mjs --json # resultado canônico — origem do gabar
142
149
 
143
150
  *Amostra sintética → arquivo de gabarito `samples/quickstart/expected/result.json`; o comando e os hashes de saída estão em `screenshots.json` (execução real em 2026-11-02).*
144
151
 
152
+ ![Saída real da execução do quickstart do dsh-ap-three-way](docs/assets/dsh-ap-three-way-demo.gif)
153
+
154
+ *Repetição animada de uma execução real registrada neste repositório.*
155
+
145
156
  Aceitação com fixture pública: entrada [`fixtures/public/mit/invoice-github-sample.xml`](https://github.com/PerryLink/dsh-ap-three-way/blob/main/fixtures/public/mit/invoice-github-sample.xml) (amostra MIT pública); repita com `node scripts/acceptance.mjs`. Detalhes em `ACCEPTANCE.csv`, citado literalmente:
146
157
 
147
158
  ```text
@@ -269,7 +280,7 @@ node scripts/acceptance.mjs # repetir a aceitaçã
269
280
  node samples/quickstart/run.mjs # amostra sintética, deve imprimir quickstart ok
270
281
  ```
271
282
 
272
- Versão atual `0.2.0` (confere com `package.json`). Testes: `node --test test/*.test.mjs` tudo verde (11 arquivos de teste, 27 casos; `pnpm test` compila antes). As imagens do README são geradas programaticamente por [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; par SVG de fluxo claro/escuro compartilhado pelos cinco idiomas) e podem ser refeitas: `python scripts/gen-readme-assets.py`.
283
+ Versão atual `0.2.1` (confere com `package.json`). Testes: `node --test test/*.test.mjs` tudo verde (11 arquivos de teste, 27 casos; `pnpm test` compila antes). As imagens do README são geradas programaticamente por [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python; par SVG de fluxo claro/escuro compartilhado pelos cinco idiomas) e podem ser refeitas: `python scripts/gen-readme-assets.py`.
273
284
 
274
285
  Topics: `deepseek-harness`, `dsh`, `dsh-plugin`, `ap`, `three-way-match`, `finance`, `perrylink`, `invoice`
275
286
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-ap-three-way",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "AP invoice/PO/GRN three-way match with tolerance policy and exception workpaper.",
5
5
  "type": "module",
6
6
  "main": "./lib/plugin/index.js",
@@ -18,10 +18,10 @@
18
18
  "LICENSE",
19
19
  "NOTICE",
20
20
  "THIRD-PARTY-NOTICES",
21
- "README-zh.md",
22
- "README-es.md",
23
- "README-pt.md",
24
- "README-hi.md",
21
+ "README.en.md",
22
+ "README.es.md",
23
+ "README.pt.md",
24
+ "README.hi.md",
25
25
  "docs/assets",
26
26
  "samples",
27
27
  "SECURITY.md",
@@ -57,7 +57,7 @@
57
57
  "labels": []
58
58
  },
59
59
  "engines": {
60
- "dsh": ">=0.2.1-rc.3 <0.4.0",
60
+ "dsh": ">=0.2.1-rc.3 <0.4.0 || >=0.2.3-0 <0.3.0-0",
61
61
  "node": ">=24.9.0 <25"
62
62
  },
63
63
  "packageManager": "pnpm@11.28.5",
@@ -91,8 +91,8 @@
91
91
  },
92
92
  "peerDependencies": {
93
93
  "@deepseek-ai/cordis": ">=4.0.5 <5.0.0",
94
- "@deepseek-ai/dsh-storage-domain": ">=0.2.1-rc.3 <0.4.0",
95
- "@deepseek-ai/dsh-tools": ">=0.2.1-rc.3 <0.4.0"
94
+ "@deepseek-ai/dsh-storage-domain": ">=0.2.1-rc.3 <0.4.0 || >=0.2.3-0 <0.3.0-0",
95
+ "@deepseek-ai/dsh-tools": ">=0.2.1-rc.3 <0.4.0 || >=0.2.3-0 <0.3.0-0"
96
96
  },
97
97
  "dependencies": {
98
98
  "fast-xml-parser": "5.11.2",