skill-family-engineering-kit 0.8.2 → 0.8.3
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 +16 -0
- package/CHANGELOG.zh-CN.md +16 -0
- package/README.md +8 -12
- package/README.zh-CN.md +8 -12
- package/docs/agents/capability-catalog.en.json +3 -3
- package/docs/agents/capability-catalog.zh-CN.json +3 -3
- package/docs/public/status/index.html +3 -3
- package/docs/reference/api/harness/index.html +1 -1
- package/docs/search/search_index.json +1 -1
- package/package.json +3 -3
- package/release-notes/0.8.3.yaml +17 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.8.3 locale=en baseline=sha256:93875982c9f941309d63e40d5758b0fe7b20d74242f71934c3fd3cd90fe6ba52 -->
|
|
4
|
+
## [0.8.3] - 2026-08-23
|
|
5
|
+
|
|
6
|
+
Lockstep patch release whose managed Bundle carries the bounded Harness containment fix.
|
|
7
|
+
|
|
8
|
+
### Changed
|
|
9
|
+
|
|
10
|
+
- Moves the package version to 0.8.3 together with Contracts and Harness; the four stable top-level Kit commands and Profile SPI remain unchanged.
|
|
11
|
+
- Rebuilding a managed Bundle projects the updated Harness paths module, including its single ENOENT anchor recomputation and unchanged fail-closed boundaries.
|
|
12
|
+
|
|
13
|
+
### Upgrade Notes
|
|
14
|
+
|
|
15
|
+
Consumers must pin Contracts, Harness, and Engineering Kit to exactly 0.8.3 and rebuild the managed Bundle. No Kit API or Profile SPI migration is required.
|
|
16
|
+
<!-- release-skill:changelog:end version=0.8.3 locale=en -->
|
|
17
|
+
|
|
18
|
+
|
|
3
19
|
<!-- release-skill:changelog:start version=0.8.2 locale=en baseline=sha256:cebfcfd816f8fd5824135d2681f443e5b226d65096bb6f6a9360f6b3bba34fc1 -->
|
|
4
20
|
## [0.8.2] - 2026-08-23
|
|
5
21
|
|
package/CHANGELOG.zh-CN.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# 变更日志
|
|
2
2
|
|
|
3
|
+
<!-- release-skill:changelog:start version=0.8.3 locale=zh-CN baseline=sha256:3315d4594a7e28926b54dae3057c35d192b1e9293d07d22fd8856f44da2a7d80 -->
|
|
4
|
+
## [0.8.3] - 2026-08-23
|
|
5
|
+
|
|
6
|
+
随 Foundation 0.8.3 锁步升版;受管 Bundle 携带 Harness 的有界路径收容修复。
|
|
7
|
+
|
|
8
|
+
### 变更
|
|
9
|
+
|
|
10
|
+
- 包版本与 Contracts、Harness 一同升至 0.8.3;Kit 的四个稳定顶层命令与 Profile SPI 均保持不变。
|
|
11
|
+
- 重建受管 Bundle 会投影更新后的 Harness paths 模块,包括仅一次 ENOENT 锚点重求和保持不变的失败关闭边界。
|
|
12
|
+
|
|
13
|
+
### 升级说明
|
|
14
|
+
|
|
15
|
+
消费者必须把 Contracts、Harness 和 Engineering Kit 精确锁定到 0.8.3,再重建受管 Bundle;无需迁移 Kit API 或 Profile SPI。
|
|
16
|
+
<!-- release-skill:changelog:end version=0.8.3 locale=zh-CN -->
|
|
17
|
+
|
|
18
|
+
|
|
3
19
|
<!-- release-skill:changelog:start version=0.8.2 locale=zh-CN baseline=sha256:620f03e3fc81c1ef06d23b99fb0e70e547d58f3c6e956691b9c4a05e1b517c3b -->
|
|
4
20
|
## [0.8.2] - 2026-08-23
|
|
5
21
|
|
package/README.md
CHANGED
|
@@ -4,27 +4,23 @@
|
|
|
4
4
|
|
|
5
5
|
# skill-family-engineering-kit
|
|
6
6
|
|
|
7
|
-
<!-- release-skill:release-version: 0.8.
|
|
7
|
+
<!-- release-skill:release-version: 0.8.3 -->
|
|
8
8
|
|
|
9
9
|
An engineering toolkit used in development and CI. There are **exactly four** top-level commands, and no fifth:
|
|
10
10
|
|
|
11
11
|
<!-- release-skill:managed:start id=latest-release -->
|
|
12
|
-
**0.8.
|
|
12
|
+
**0.8.3** (2026-08-23)
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
**Added**
|
|
17
|
-
|
|
18
|
-
- Projects strict-read.mjs into the managed Bundle and maps its closure, errors, and paths dependencies to sibling runtime modules.
|
|
19
|
-
- Records the real strict-read.mjs source in Foundation provenance and verifies the read-file-strict bridge in an offline runner.
|
|
14
|
+
Lockstep patch release whose managed Bundle carries the bounded Harness containment fix.
|
|
20
15
|
|
|
21
16
|
**Changed**
|
|
22
17
|
|
|
23
|
-
- Moves the package version to 0.8.
|
|
18
|
+
- Moves the package version to 0.8.3 together with Contracts and Harness; the four stable top-level Kit commands and Profile SPI remain unchanged.
|
|
19
|
+
- Rebuilding a managed Bundle projects the updated Harness paths module, including its single ENOENT anchor recomputation and unchanged fail-closed boundaries.
|
|
24
20
|
|
|
25
21
|
**Upgrade Notes**
|
|
26
22
|
|
|
27
|
-
Consumers must pin Contracts, Harness, and Engineering Kit to exactly 0.8.
|
|
23
|
+
Consumers must pin Contracts, Harness, and Engineering Kit to exactly 0.8.3 and rebuild the managed Bundle. No Kit API or Profile SPI migration is required.
|
|
28
24
|
<!-- release-skill:managed:end id=latest-release -->
|
|
29
25
|
|
|
30
26
|
| Command | Purpose | Side effects |
|
|
@@ -45,7 +41,7 @@ Kit is the "engineering stage" layer, depending on the Harness and Contracts. It
|
|
|
45
41
|
## Installation and Minimal Example
|
|
46
42
|
|
|
47
43
|
```sh
|
|
48
|
-
npm install --save-dev skill-family-engineering-kit@0.8.
|
|
44
|
+
npm install --save-dev skill-family-engineering-kit@0.8.3
|
|
49
45
|
npm exec -- skill-family-kit --help
|
|
50
46
|
npm exec -- skill-family-kit scaffold --root <empty-dir> --project-id my-project
|
|
51
47
|
npm exec -- skill-family-kit adopt-plan --root <repo>
|
|
@@ -53,7 +49,7 @@ npm exec -- skill-family-kit projection --root <repo>
|
|
|
53
49
|
npm exec -- skill-family-kit check --root <repo>
|
|
54
50
|
```
|
|
55
51
|
|
|
56
|
-
The four commands above cover skeleton generation, read-only inventory, managed projection, and diagnostics respectively; a zero-install form is available via `npm exec --package=skill-family-engineering-kit@0.8.
|
|
52
|
+
The four commands above cover skeleton generation, read-only inventory, managed projection, and diagnostics respectively; a zero-install form is available via `npm exec --package=skill-family-engineering-kit@0.8.3 -- skill-family-kit --help`.
|
|
57
53
|
|
|
58
54
|
### Public Profile SPI
|
|
59
55
|
|
package/README.zh-CN.md
CHANGED
|
@@ -5,27 +5,23 @@
|
|
|
5
5
|
|
|
6
6
|
# skill-family-engineering-kit
|
|
7
7
|
|
|
8
|
-
<!-- release-skill:release-version: 0.8.
|
|
8
|
+
<!-- release-skill:release-version: 0.8.3 -->
|
|
9
9
|
|
|
10
10
|
开发与 CI 阶段使用的工程工具包。**恰好四个**顶层命令,没有第五个:
|
|
11
11
|
|
|
12
12
|
<!-- release-skill:managed:start id=latest-release -->
|
|
13
|
-
**0.8.
|
|
13
|
+
**0.8.3** (2026-08-23)
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
**新增**
|
|
18
|
-
|
|
19
|
-
- 把 strict-read.mjs 投影进受管 Bundle,并把它的 closure、errors 和 paths 依赖映射到相邻运行时模块。
|
|
20
|
-
- 在 Foundation provenance 中记录真实 strict-read.mjs 源码,并通过离线 runner 复验 read-file-strict。
|
|
15
|
+
随 Foundation 0.8.3 锁步升版;受管 Bundle 携带 Harness 的有界路径收容修复。
|
|
21
16
|
|
|
22
17
|
**变更**
|
|
23
18
|
|
|
24
|
-
- 包版本与 Contracts、Harness 一同升至 0.8.
|
|
19
|
+
- 包版本与 Contracts、Harness 一同升至 0.8.3;Kit 的四个稳定顶层命令与 Profile SPI 均保持不变。
|
|
20
|
+
- 重建受管 Bundle 会投影更新后的 Harness paths 模块,包括仅一次 ENOENT 锚点重求和保持不变的失败关闭边界。
|
|
25
21
|
|
|
26
22
|
**升级说明**
|
|
27
23
|
|
|
28
|
-
消费者必须把 Contracts、Harness 和 Engineering Kit 精确锁定到 0.8.
|
|
24
|
+
消费者必须把 Contracts、Harness 和 Engineering Kit 精确锁定到 0.8.3,再重建受管 Bundle;无需迁移 Kit API 或 Profile SPI。
|
|
29
25
|
<!-- release-skill:managed:end id=latest-release -->
|
|
30
26
|
|
|
31
27
|
| 命令 | 用途 | 副作用 |
|
|
@@ -46,7 +42,7 @@ Kit 是「工程阶段」层,依赖 Harness 与 Contracts。它只做四件事
|
|
|
46
42
|
## 安装和最小示例
|
|
47
43
|
|
|
48
44
|
```sh
|
|
49
|
-
npm install --save-dev skill-family-engineering-kit@0.8.
|
|
45
|
+
npm install --save-dev skill-family-engineering-kit@0.8.3
|
|
50
46
|
npm exec -- skill-family-kit --help
|
|
51
47
|
npm exec -- skill-family-kit scaffold --root <empty-dir> --project-id my-project
|
|
52
48
|
npm exec -- skill-family-kit adopt-plan --root <repo>
|
|
@@ -54,7 +50,7 @@ npm exec -- skill-family-kit projection --root <repo>
|
|
|
54
50
|
npm exec -- skill-family-kit check --root <repo>
|
|
55
51
|
```
|
|
56
52
|
|
|
57
|
-
以上四条命令分别覆盖生成骨架、只读盘点、受管投影与诊断;零安装形式可用 `npm exec --package=skill-family-engineering-kit@0.8.
|
|
53
|
+
以上四条命令分别覆盖生成骨架、只读盘点、受管投影与诊断;零安装形式可用 `npm exec --package=skill-family-engineering-kit@0.8.3 -- skill-family-kit --help`。
|
|
58
54
|
|
|
59
55
|
### 公共 Profile SPI
|
|
60
56
|
|
|
@@ -1967,7 +1967,7 @@
|
|
|
1967
1967
|
"Need a compatibility-frozen Quickstart API"
|
|
1968
1968
|
],
|
|
1969
1969
|
"prerequisites": [
|
|
1970
|
-
"Pin skill-family-contracts, skill-family-harness-node, and skill-family-engineering-kit to exactly 0.8.
|
|
1970
|
+
"Pin skill-family-contracts, skill-family-harness-node, and skill-family-engineering-kit to exactly 0.8.3 and rebuild the managed Bundle",
|
|
1971
1971
|
"Observation and read-file-strict paths are contained under the caller-supplied root"
|
|
1972
1972
|
],
|
|
1973
1973
|
"inputs": [
|
|
@@ -2015,7 +2015,7 @@
|
|
|
2015
2015
|
"Need to bypass target manifest authorization or handwritten-file protection"
|
|
2016
2016
|
],
|
|
2017
2017
|
"prerequisites": [
|
|
2018
|
-
"Install exact matching 0.8.
|
|
2018
|
+
"Install exact matching 0.8.3 versions of all three Foundation packages",
|
|
2019
2019
|
"The target prefix is a contained relative POSIX path"
|
|
2020
2020
|
],
|
|
2021
2021
|
"inputs": [
|
|
@@ -2037,7 +2037,7 @@
|
|
|
2037
2037
|
],
|
|
2038
2038
|
"invariants": [
|
|
2039
2039
|
"The Bundle contains no node_modules or runtime Ajv and runs without installed Foundation packages or network access",
|
|
2040
|
-
"The managed Bundle is rebuilt from installed 0.8.
|
|
2040
|
+
"The managed Bundle is rebuilt from installed 0.8.3 package bytes and never imports source from a Foundation worktree",
|
|
2041
2041
|
"The helper adds no top-level Kit command and never bypasses runProjection",
|
|
2042
2042
|
"Stability is candidate: a later minor release may change or remove this subpath"
|
|
2043
2043
|
],
|
|
@@ -1967,7 +1967,7 @@
|
|
|
1967
1967
|
"需要兼容性已冻结的 Quickstart API"
|
|
1968
1968
|
],
|
|
1969
1969
|
"prerequisites": [
|
|
1970
|
-
"把 skill-family-contracts、skill-family-harness-node 与 skill-family-engineering-kit 精确锁定到 0.8.
|
|
1970
|
+
"把 skill-family-contracts、skill-family-harness-node 与 skill-family-engineering-kit 精确锁定到 0.8.3,并重建受管 Bundle",
|
|
1971
1971
|
"observation 路径与 read-file-strict 路径受调用方提供的 root 收容"
|
|
1972
1972
|
],
|
|
1973
1973
|
"inputs": [
|
|
@@ -2015,7 +2015,7 @@
|
|
|
2015
2015
|
"需要绕过目标 manifest 授权或手写文件保护"
|
|
2016
2016
|
],
|
|
2017
2017
|
"prerequisites": [
|
|
2018
|
-
"安装精确匹配的三个 Foundation 0.8.
|
|
2018
|
+
"安装精确匹配的三个 Foundation 0.8.3 包版本",
|
|
2019
2019
|
"targetPrefix 是受收容的 POSIX 相对路径"
|
|
2020
2020
|
],
|
|
2021
2021
|
"inputs": [
|
|
@@ -2037,7 +2037,7 @@
|
|
|
2037
2037
|
],
|
|
2038
2038
|
"invariants": [
|
|
2039
2039
|
"Bundle 不含 node_modules 或运行时 Ajv,不依赖已安装 Foundation 包或网络",
|
|
2040
|
-
"受管 Bundle 从 0.8.
|
|
2040
|
+
"受管 Bundle 从 0.8.3 的已安装包字节重建,不从 Foundation 工作树导入源码",
|
|
2041
2041
|
"辅助函数不增加 Kit 顶层命令,也不绕过 runProjection",
|
|
2042
2042
|
"稳定性为 candidate:后续小版本可以修改或移除该子路径"
|
|
2043
2043
|
],
|
|
@@ -1792,17 +1792,17 @@
|
|
|
1792
1792
|
<tbody>
|
|
1793
1793
|
<tr>
|
|
1794
1794
|
<td><code>skill-family-contracts</code></td>
|
|
1795
|
-
<td>0.8.
|
|
1795
|
+
<td>0.8.3</td>
|
|
1796
1796
|
<td><a href="https://github.com/ifoohoo/skill-family-contracts">ifoohoo/skill-family-contracts</a></td>
|
|
1797
1797
|
</tr>
|
|
1798
1798
|
<tr>
|
|
1799
1799
|
<td><code>skill-family-harness-node</code></td>
|
|
1800
|
-
<td>0.8.
|
|
1800
|
+
<td>0.8.3</td>
|
|
1801
1801
|
<td><a href="https://github.com/ifoohoo/skill-family-harness-node">ifoohoo/skill-family-harness-node</a></td>
|
|
1802
1802
|
</tr>
|
|
1803
1803
|
<tr>
|
|
1804
1804
|
<td><code>skill-family-engineering-kit</code></td>
|
|
1805
|
-
<td>0.8.
|
|
1805
|
+
<td>0.8.3</td>
|
|
1806
1806
|
<td><a href="https://github.com/ifoohoo/skill-family-engineering-kit">ifoohoo/skill-family-engineering-kit</a></td>
|
|
1807
1807
|
</tr>
|
|
1808
1808
|
</tbody>
|
|
@@ -3166,7 +3166,7 @@
|
|
|
3166
3166
|
<p><code>params</code> 是闭合对象。<code>root</code> 与 <code>path</code> 是必填非空字符串;<code>encoding</code> 只能是 <code>utf8</code> 或省略;<code>expectedSha256</code> 省略时不做预期摘要比对,提供时沿用核心严格读取合同。</p>
|
|
3167
3167
|
<p>桥接保留核心回执的 <code>path</code>、<code>sha256</code>、<code>bytes</code> 与 <code>mode</code>。UTF-8 内容仍是字符串;二进制内容投影成 Node 标准的 Buffer JSON 形态 <code>{ "type": "Buffer", "data": [...] }</code>,以便通过 JSON 传输后无损还原字节。</p>
|
|
3168
3168
|
<p>直接调用失败时沿用核心异常,包括 <code>SFC2004</code> 与 <code>details.kind</code>。候选 <code>mechanisms-cli.mjs</code> 继续使用一请求一响应 JSON:成功退出 0,拒绝或用法错误退出 2;CLI 错误 JSON 只承诺 <code>name</code> 与 <code>message</code>,不承诺跨语言保留 <code>details</code>。</p>
|
|
3169
|
-
<p>该入口不选择 method,不解释 domainResult,也不拥有重试、调度或生命周期。消费者必须把 Contracts、Harness 与 Engineering Kit 精确锁定到 0.8.
|
|
3169
|
+
<p>该入口不选择 method,不解释 domainResult,也不拥有重试、调度或生命周期。消费者必须把 Contracts、Harness 与 Engineering Kit 精确锁定到 0.8.3,并重建受管 Bundle;禁止从 Foundation 工作树导入候选源码。0.3.0 的 v2 与 0.2.1 的 v1 不兼容。</p>
|
|
3170
3170
|
<hr />
|
|
3171
3171
|
<h2 id="与机器事实层的互链">与机器事实层的互链<a class="headerlink" href="#与机器事实层的互链" title="Permanent link">¶</a></h2>
|
|
3172
3172
|
<ul>
|