skill-family-engineering-kit 0.2.1 → 0.3.0

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.
Files changed (31) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/CHANGELOG.zh-CN.md +22 -0
  3. package/README.md +15 -12
  4. package/README.zh-CN.md +15 -12
  5. package/candidate/profile-bundle.mjs +1058 -176
  6. package/candidate/projection-bundle-cli.mjs +57 -15
  7. package/candidate/skill-naming-cli.mjs +59 -0
  8. package/candidate/skill-naming-policy.json +46 -0
  9. package/candidate/skill-naming.mjs +280 -0
  10. package/docs/agents/capability-catalog.en.json +13 -10
  11. package/docs/agents/capability-catalog.json +3 -2
  12. package/docs/agents/capability-catalog.zh-CN.json +13 -10
  13. package/docs/en/migration/index.html +4 -3
  14. package/docs/en/recipes/adopt-existing-repository/index.html +2 -1
  15. package/docs/en/recipes/domain-schema-validation/index.html +3 -1
  16. package/docs/en/recipes/index.html +2 -1
  17. package/docs/en/reference/api/index.html +24 -0
  18. package/docs/en/reference/compatibility/index.html +51 -5
  19. package/docs/migration/index.html +4 -3
  20. package/docs/public/status/index.html +3 -3
  21. package/docs/recipes/adopt-existing-repository/index.html +2 -1
  22. package/docs/recipes/domain-schema-validation/index.html +3 -1
  23. package/docs/recipes/index.html +2 -1
  24. package/docs/reference/api/contracts/index.html +26 -0
  25. package/docs/reference/api/engineering-kit/index.html +26 -0
  26. package/docs/reference/api/harness/index.html +27 -1
  27. package/docs/reference/api/index.html +25 -1
  28. package/docs/reference/compatibility/index.html +51 -5
  29. package/docs/search/search_index.json +1 -1
  30. package/package.json +5 -4
  31. package/release-notes/0.3.0.yaml +25 -0
package/docs/reference/compatibility/index.html CHANGED
@@ -595,6 +595,17 @@
595
595
  </span>
596
596
  </a>
597
597
 
598
+ </li>
599
+
600
+ <li class="md-nav__item">
601
+ <a href="#Quickstart-Profile-candidate-兼容性" class="md-nav__link">
602
+ <span class="md-ellipsis">
603
+
604
+ Quickstart Profile candidate 兼容性
605
+
606
+ </span>
607
+ </a>
608
+
598
609
  </li>
599
610
 
600
611
  <li class="md-nav__item">
@@ -1748,6 +1759,17 @@
1748
1759
  </span>
1749
1760
  </a>
1750
1761
 
1762
+ </li>
1763
+
1764
+ <li class="md-nav__item">
1765
+ <a href="#Quickstart-Profile-candidate-兼容性" class="md-nav__link">
1766
+ <span class="md-ellipsis">
1767
+
1768
+ Quickstart Profile candidate 兼容性
1769
+
1770
+ </span>
1771
+ </a>
1772
+
1751
1773
  </li>
1752
1774
 
1753
1775
  <li class="md-nav__item">
@@ -1840,33 +1862,56 @@
1840
1862
  <tbody>
1841
1863
  <tr>
1842
1864
  <td><code>skill-family-contracts</code></td>
1843
- <td>0.2.1</td>
1865
+ <td>0.3.0</td>
1844
1866
  <td>Contracts 1.4.0 机器契约</td>
1845
1867
  <td>公开发布目标（private: false）</td>
1846
1868
  </tr>
1847
1869
  <tr>
1848
1870
  <td><code>skill-family-harness-node</code></td>
1849
- <td>0.2.1</td>
1871
+ <td>0.3.0</td>
1850
1872
  <td>Contracts 的 Node 薄机制运行时</td>
1851
1873
  <td>公开发布目标</td>
1852
1874
  </tr>
1853
1875
  <tr>
1854
1876
  <td><code>skill-family-engineering-kit</code></td>
1855
- <td>0.2.1</td>
1877
+ <td>0.3.0</td>
1856
1878
  <td>四个工程命令（CLI <code>skill-family-kit</code>）</td>
1857
1879
  <td>公开发布目标</td>
1858
1880
  </tr>
1859
1881
  <tr>
1860
1882
  <td>工作区仓</td>
1861
- <td>0.2.1</td>
1883
+ <td>0.3.0</td>
1862
1884
  <td>私有父工作区（private: true）</td>
1863
1885
  <td>仅开发真源</td>
1864
1886
  </tr>
1865
1887
  </tbody>
1866
1888
  </table>
1867
1889
  <blockquote>
1868
- <p>契约权威版本（<code>CONTRACTS_VERSION</code>）为 <code>1.4.0</code>，npm 包版本为 <code>0.2.1</code>，两套版本并行，不混用。</p>
1890
+ <p>契约权威版本（<code>CONTRACTS_VERSION</code>）为 <code>1.4.0</code>，npm 包版本为 <code>0.3.0</code>，两套版本并行，不混用。</p>
1869
1891
  </blockquote>
1892
+ <h2 id="Quickstart-Profile-candidate-兼容性">Quickstart Profile candidate 兼容性<a class="headerlink" href="#Quickstart-Profile-candidate-兼容性" title="Permanent link">&para;</a></h2>
1893
+ <table>
1894
+ <thead>
1895
+ <tr>
1896
+ <th>包版本</th>
1897
+ <th>candidate profile</th>
1898
+ <th>兼容规则</th>
1899
+ </tr>
1900
+ </thead>
1901
+ <tbody>
1902
+ <tr>
1903
+ <td>0.2.1</td>
1904
+ <td>v1</td>
1905
+ <td>已有接入可继续精确锁定 0.2.1</td>
1906
+ </tr>
1907
+ <tr>
1908
+ <td>0.3.0</td>
1909
+ <td>v2</td>
1910
+ <td>使用 <code>execute-method</code>、真实 <code>$id</code> Schema 集合与离线 Bundle；必须精确锁定 0.3.0</td>
1911
+ </tr>
1912
+ </tbody>
1913
+ </table>
1914
+ <p>v2 替换 v1，不提供双轨兼容层。稳定 Contracts 1.4.0、18 类对象、内核协议与错误码登记不随 candidate 切换而变化。</p>
1870
1915
  <h2 id="Node-支持矩阵">Node 支持矩阵<a class="headerlink" href="#Node-支持矩阵" title="Permanent link">&para;</a></h2>
1871
1916
  <ul>
1872
1917
  <li>引擎要求：<code>&gt;=22.22.2 &lt;23</code>（锁定 major 22）。</li>
@@ -1922,6 +1967,7 @@
1922
1967
  <li><strong>Kit 命令</strong>：顶层命令固定 4 个（scaffold/adopt-plan/projection/check），不扩张；<code>REFUSED_MUTATION_FLAGS</code> 在 CLI 入口即拒。</li>
1923
1968
  <li><strong>Node/pnpm/projen</strong>：跟随 <code>.foundation/version-lock.json</code> 与 <code>package.json</code> 的精确锁定，升级须经 <code>pnpm synth</code> 重新生成受管投影。</li>
1924
1969
  <li><strong>宿主</strong>：新增受支持宿主须登记 descriptor 并绑定受信 driver；unsupported 宿主（如 qoder）只参考结构，不声称已在其上运行。</li>
1970
+ <li><strong>Candidate</strong>：candidate 子路径允许在后续 minor 版本修改或移除；0.2.1 v1 与 0.3.0 v2 不混装，消费者按所需 profile 精确锁定三个包版本。</li>
1925
1971
  </ul>
1926
1972
  <h2 id="反兼容边界明确不支持">反兼容边界（明确不支持）<a class="headerlink" href="#反兼容边界明确不支持" title="Permanent link">&para;</a></h2>
1927
1973
  <ul>