advisers 0.4.0 → 0.4.2
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/README-zh.md +3 -3
- package/README.md +20 -12
- package/THIRD-PARTY-NOTICES.md +1 -1
- package/bin/advisers.js +322 -41
- package/index.js +1 -1
- package/lib/fact-entry.js +320 -0
- package/lib/mail-probe.js +307 -0
- package/lib/mail-watch.js +287 -0
- package/lib/mail.js +2 -2
- package/lib/sync.js +37 -2
- package/package.json +4 -4
package/README-zh.md
CHANGED
|
@@ -5,12 +5,12 @@
|
|
|
5
5
|
## 安装
|
|
6
6
|
|
|
7
7
|
```sh
|
|
8
|
-
# 0.4.
|
|
8
|
+
# 0.4.2 已于 2026-11-22 发布;npm @latest 现为 0.4.2(稳定渠道 = 默认 `latest`):
|
|
9
9
|
# npm i -g --registry=https://registry.npmjs.org advisers@latest advisers-office@latest
|
|
10
10
|
# 从 checkout 运行:
|
|
11
11
|
# corepack pnpm install && corepack pnpm -r build
|
|
12
12
|
# ADVISERS_OFFICE_LOCAL=1 node packages/advisers/bin/advisers.js status
|
|
13
|
-
# `next` 渠道也指向 0.4.
|
|
13
|
+
# `next` 渠道也指向 0.4.2:
|
|
14
14
|
# npm i -g --registry=https://registry.npmjs.org advisers@next advisers-office@next
|
|
15
15
|
advisers soul init
|
|
16
16
|
advisers brief "做一份 Q4 预算 Excel,周五前给老板"
|
|
@@ -36,7 +36,7 @@ CLI 是**本地秘书运行时**:一个 REPL、用户账/承诺账/流程账
|
|
|
36
36
|
|
|
37
37
|
## 状态
|
|
38
38
|
|
|
39
|
-
`0.4.
|
|
39
|
+
`0.4.2` 已于 2026-11-22 发布(npm `latest` = `0.4.2`;`next` 也为 `0.4.2`)。0.4.2 是 0.4.1 之上的补丁:新增手工事实录入(`fact add`,`--quote` 必填、重复幂等,事实 + supersede 链 + KB 链接 + 一条 `fact.add` 审计同事务提交)、只读 IMAP 探测(`mail account test`)、显式前台 `mail sync --watch`、`sync pull --dry-run` 预览、`doctor --check-db` 的备份年龄提示、子命令 `--help` 一致性(TOS 接受前即可用),以及零模型/零网络的 `pnpm eval:mail-local` 质量门(30 个合成 fixture,已接入 Linux CI),并按审计结论纠偏文档。0.4.0 的功能面不变:本地知识库(schema v22)、TLS-only IMAP 邮件入口、交互式壳、可解释的主动式晨报、Policy/Evidence 2.0 子集、回款/对账与客户状态包 v2、MCP modern dual-era、Windows CI 与便携 ZIP,以及 v2026.11.4 法务修订。所有新命令都不需要模型调用,也没有后台常驻进程,`mail sync` 是唯一新增的显式网络路径(TLS-only、只读、用户主动触发)。**schema v22 是单向迁移**:升级前 CLI 会写 `state.db.before-migrate-v*` 备份,0.3.2 打开 v22 数据库会报 `E_SCHEMA_NEWER`,降级需要恢复该备份。`0.4.1`/`0.4.0`/`0.3.2`/`0.3.1`/`0.3.0` 仍可按版本号安装但已被取代。运行时基线仍是「可信交付」feature line:所有出网面逐 item secrecy clearance、本地审计尾锚、备份轮换/可验证恢复与 `doctor --repair`、200k 读路径、MCP 输出上限 + legacy 协议协商、DSH 只读账本门面、机器可读契约、无 key 的确定性评测套件与 SBOM 门禁。`0.4.2` tarball 由 GitHub Actions OIDC/Trusted Publishing 发布,带 SLSA provenance;可用 `scripts/verify-release.mjs --version 0.4.2 --tag latest --sbom artifacts/sbom.cdx.json --require-sbom` 校验(SBOM 由 `pnpm run sbom` 生成)。Release notes:<https://github.com/PerryLink/advisers/releases/tag/v0.4.2>。模型化 `kb compile`/`kb ask`、embedding、完整 PolicyGrant/exit 4–6 与 DSH 写账本仍属后续版本;未交付清单见仓库 CHANGELOG。
|
|
40
40
|
|
|
41
41
|
- SQLite 账本 `~/.advisers/state.db`(JSON fallback;schema v22 —— 0.4.0 一次迁移加入 KB/邮件/回款对象、无锁只读快照、增量写);
|
|
42
42
|
- soul 位于 `~/.advisers/soul.md`,人类独占;
|
package/README.md
CHANGED
|
@@ -7,12 +7,12 @@ routines.
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
# 0.4.
|
|
10
|
+
# 0.4.2 was published on 2026-11-22; npm @latest is now 0.4.2:
|
|
11
11
|
# npm i -g --registry=https://registry.npmjs.org advisers@latest advisers-office@latest
|
|
12
12
|
# From checkout:
|
|
13
13
|
# corepack pnpm install && corepack pnpm -r build
|
|
14
14
|
# ADVISERS_OFFICE_LOCAL=1 node packages/advisers/bin/advisers.js status
|
|
15
|
-
# The `next` channel also points at 0.4.
|
|
15
|
+
# The `next` channel also points at 0.4.2:
|
|
16
16
|
# npm i -g --registry=https://registry.npmjs.org advisers@next advisers-office@next
|
|
17
17
|
advisers soul init
|
|
18
18
|
advisers brief "做一份 Q4 预算 Excel,周五前给老板"
|
|
@@ -43,24 +43,32 @@ turn natural language into commitments or artifacts.
|
|
|
43
43
|
|
|
44
44
|
## Status
|
|
45
45
|
|
|
46
|
-
`0.4.
|
|
47
|
-
is the
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
46
|
+
`0.4.2` was published on 2026-11-22 (npm `latest` = `0.4.2`; `next` is also `0.4.2`). It
|
|
47
|
+
is a patch on the 0.4.1 same-day follow-up: it adds manual fact entry (`fact add`, with a
|
|
48
|
+
required evidence quote and one-transaction supersede/KB-link/audit), the read-only IMAP
|
|
49
|
+
probe (`mail account test`), the explicit foreground `mail sync --watch`, the `sync pull
|
|
50
|
+
--dry-run` preview, the backup-age hint in `doctor --check-db`, a subcommand `--help`
|
|
51
|
+
consistency pass (usable before TOS acceptance) and the zero-model/zero-network
|
|
52
|
+
`pnpm eval:mail-local` quality gate (30 synthetic fixtures, wired into Linux CI), plus the
|
|
53
|
+
audit-driven documentation corrections. The 0.4.0 feature surface is unchanged: the local
|
|
54
|
+
knowledge base (schema v22), TLS-only IMAP mail entry, the interactive shell, proactive
|
|
55
|
+
urgent-first briefs, the policy/evidence 2.0 subset, receivables/payments with client
|
|
56
|
+
pack v2, MCP modern dual-era, Windows CI plus a portable ZIP, and the v2026.11.4 legal
|
|
57
|
+
revision. No new command requires a model call,
|
|
51
58
|
there is no background daemon, and `mail sync` is the one new explicit network path
|
|
52
59
|
(TLS-only, read-only, user-invoked). **Schema v22 is a one-way migration**: the CLI writes
|
|
53
60
|
`state.db.before-migrate-v*` before upgrading, a 0.3.2 binary opening a v22 database fails
|
|
54
|
-
with `E_SCHEMA_NEWER`, and downgrading means restoring that backup.
|
|
55
|
-
remain installable by pinning but are superseded.
|
|
61
|
+
with `E_SCHEMA_NEWER`, and downgrading means restoring that backup.
|
|
62
|
+
`0.4.1`/`0.4.0`/`0.3.2`/`0.3.1`/`0.3.0` remain installable by pinning but are superseded.
|
|
63
|
+
The runtime baseline remains the
|
|
56
64
|
"trustworthy delivery" line: per-item secrecy clearance on every egress surface, a local
|
|
57
65
|
audit tail anchor, backup rotation/verified restore and `doctor --repair`, 200k-row read
|
|
58
66
|
paths, MCP output caps plus legacy protocol negotiation, a read-only ledger facade, machine
|
|
59
|
-
readable contracts, a deterministic no-key eval suite and an SBOM gate. The 0.4.
|
|
67
|
+
readable contracts, a deterministic no-key eval suite and an SBOM gate. The `0.4.2` tarballs
|
|
60
68
|
are published from GitHub Actions OIDC/Trusted Publishing with SLSA provenance; verify with
|
|
61
|
-
`scripts/verify-release.mjs --version 0.4.
|
|
69
|
+
`scripts/verify-release.mjs --version 0.4.2 --tag latest --sbom artifacts/sbom.cdx.json
|
|
62
70
|
--require-sbom` (the SBOM is generated by `pnpm run sbom`).
|
|
63
|
-
Release notes: <https://github.com/PerryLink/advisers/releases/tag/v0.4.
|
|
71
|
+
Release notes: <https://github.com/PerryLink/advisers/releases/tag/v0.4.2>. Model-backed KB
|
|
64
72
|
compile/ask, embeddings, the full PolicyGrant/exit 4–6 and DSH writes remain future work;
|
|
65
73
|
see the repository CHANGELOG for the full not-delivered list.
|
|
66
74
|
|
package/THIRD-PARTY-NOTICES.md
CHANGED
|
@@ -11,7 +11,7 @@ dependency closure of the published packages ("pnpm list --prod --depth 100";
|
|
|
11
11
|
devDependencies and workspace packages excluded). Do not edit by hand; CI runs
|
|
12
12
|
"node scripts/check-licenses.mjs".
|
|
13
13
|
|
|
14
|
-
This file is shipped with the advisers@0.4.
|
|
14
|
+
This file is shipped with the advisers@0.4.2 npm package and covers the third-party production dependencies of that package only. Each dependency keeps its own license.
|
|
15
15
|
|
|
16
16
|
Optional platform-specific binaries (for example the @napi-rs/canvas builds for
|
|
17
17
|
other operating systems and CPU architectures) are installed only on a matching
|