npm - skill-family-engineering-kit - Versions diffs - 0.2.0 → 0.2.1 - Mend

skill-family-engineering-kit 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.

Files changed (70) hide show

package/CHANGELOG.md +21 -0
package/CHANGELOG.zh-CN.md +21 -0
package/NOTICE +10 -0
package/README.md +157 -55
package/README.zh-CN.md +207 -0
package/candidate/index.mjs +4 -0
package/candidate/profile-bundle.mjs +268 -0
package/candidate/projection-bundle-cli.mjs +22 -0
package/docs/404.html +1434 -408
package/docs/agents/architecture-routing/index.html +1944 -0
package/docs/agents/capability-catalog.en.json +1561 -0
package/docs/agents/capability-catalog.json +934 -0
package/docs/agents/capability-catalog.schema.json +179 -0
package/docs/agents/capability-catalog.zh-CN.json +1561 -0
package/docs/agents/index.html +1914 -0
package/docs/architecture/index.html +1706 -497
package/docs/assets/javascripts/lunr/tinyseg.js +2 -2
package/docs/assets/javascripts/lunr/wordcut.js +37 -37
package/docs/en/agents/architecture-routing/index.html +1944 -0
package/docs/en/agents/index.html +1925 -0
package/docs/en/architecture/index.html +2187 -0
package/docs/en/examples-and-fixtures/index.html +1888 -0
package/docs/en/help/index.html +2035 -0
package/docs/en/index.html +1895 -0
package/docs/en/licensing/index.html +1917 -0
package/docs/en/migration/index.html +2334 -0
package/docs/en/quickstart/index.html +1919 -0
package/docs/en/recipes/adapter-text-closure/index.html +2000 -0
package/docs/en/recipes/adopt-existing-repository/index.html +1986 -0
package/docs/en/recipes/deterministic-human-report/index.html +1998 -0
package/docs/en/recipes/domain-schema-validation/index.html +2007 -0
package/docs/en/recipes/durable-local-state/index.html +2009 -0
package/docs/en/recipes/host-profile-integration/index.html +2001 -0
package/docs/en/recipes/index.html +1876 -0
package/docs/en/recipes/safe-filesystem-and-atomic-write/index.html +1994 -0
package/docs/en/reference/api/index.html +1917 -0
package/docs/en/reference/compatibility/index.html +1990 -0
package/docs/en/reference/failure-and-side-effect-matrix/index.html +2216 -0
package/docs/examples-and-fixtures/index.html +1871 -0
package/docs/git-lifecycle/index.html +1508 -482
package/docs/help/index.html +1655 -554
package/docs/index.html +1479 -450
package/docs/integration/audit/failure-evidence/index.html +1488 -462
package/docs/integration/audit/independence/index.html +1513 -487
package/docs/integration/audit/index.html +1514 -488
package/docs/integration/audit/mutation-taxonomy/index.html +1548 -522
package/docs/integration/audit/version-compatibility/index.html +1489 -463
package/docs/licensing/index.html +1917 -0
package/docs/migration/index.html +1678 -586
package/docs/public/status/index.html +1542 -516
package/docs/quickstart/index.html +1589 -539
package/docs/recipes/adapter-text-closure/index.html +2000 -0
package/docs/recipes/adopt-existing-repository/index.html +1986 -0
package/docs/recipes/deterministic-human-report/index.html +1998 -0
package/docs/recipes/domain-schema-validation/index.html +2007 -0
package/docs/recipes/durable-local-state/index.html +2009 -0
package/docs/recipes/host-profile-integration/index.html +2001 -0
package/docs/recipes/index.html +1876 -0
package/docs/recipes/safe-filesystem-and-atomic-write/index.html +1994 -0
package/docs/reference/api/contracts/index.html +2532 -0
package/docs/reference/api/engineering-kit/index.html +2551 -0
package/docs/reference/api/harness/index.html +2608 -0
package/docs/reference/api/index.html +1857 -0
package/docs/reference/compatibility/index.html +1990 -0
package/docs/reference/failure-and-side-effect-matrix/index.html +2216 -0
package/docs/search/search_index.json +1 -1
package/docs/setup/index.html +1494 -468
package/docs/sitemap.xml +152 -0
package/package.json +14 -4
package/release-notes/0.2.1.yaml +23 -0

package/docs/reference/failure-and-side-effect-matrix/index.html ADDED Viewed

@@ -0,0 +1,2216 @@
+<!doctype html>
+<html lang="zh" class="no-js">
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+        <meta name="description" content="Skill Family 生命周期公共工程基础设施父工作区">
+        <link rel="canonical" href="https://ifoohoo.github.io/skill-family-engineering-kit/reference/failure-and-side-effect-matrix/">
+        <link rel="prev" href="../compatibility/">
+        <link rel="next" href="../api/">
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+        <title>中文 · 失败与副作用 - Skill Family Foundation</title>
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+  </head>
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+        <a href="#失败与副作用矩阵" class="md-skip">
+          跳转至
+        </a>
+    </div>
+    <div data-md-component="announce">
+    </div>
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="页眉">
+    <a href="../.." title="Skill Family Foundation" class="md-header__button md-logo" aria-label="Skill Family Foundation" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            Skill Family Foundation
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+              中文 · 失败与副作用
+          </span>
+        </div>
+      </div>
+    </div>
+        <form class="md-header__option" data-md-component="palette">
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="切换到深色模式"  type="radio" name="__palette" id="__palette_0">
+      <label class="md-header__button md-icon" title="切换到深色模式" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="切换到浅色模式"  type="radio" name="__palette" id="__palette_1">
+      <label class="md-header__button md-icon" title="切换到浅色模式" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+</form>
+      <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+        <label class="md-header__button md-icon" for="__search">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        </label>
+        <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="搜索" placeholder="搜索" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="查找">
+        <button type="reset" class="md-search__icon md-icon" title="清空当前内容" aria-label="清空当前内容" tabindex="-1">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
+        </button>
+      </nav>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            正在初始化搜索引擎
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+  </nav>
+</header>
+    <div class="md-container" data-md-component="container">
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="Skill Family Foundation" class="md-nav__button md-logo" aria-label="Skill Family Foundation" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
+    </a>
+    Skill Family Foundation
+  </label>
+  <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 首页
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../setup/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 安装与环境
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../quickstart/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 快速开始
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../git-lifecycle/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Git 生命周期指南
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../help/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 能力与诊断
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 架构边界
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../public/status/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 公开状态
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../migration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 存量采用与迁移
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../licensing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 许可与署名
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../agents/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 智能体入口
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../agents/architecture-routing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 架构路由
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 兼容性
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item md-nav__item--active">
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+  <span class="md-ellipsis">
+    中文 · 失败与副作用
+  </span>
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <a href="./" class="md-nav__link md-nav__link--active">
+  <span class="md-ellipsis">
+    中文 · 失败与副作用
+  </span>
+      </a>
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#Contracts纯函数层" class="md-nav__link">
+    <span class="md-ellipsis">
+        Contracts（纯函数层）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#Harness机制层受收容" class="md-nav__link">
+    <span class="md-ellipsis">
+        Harness（机制层，受收容）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#Engineering-Kit工程命令层" class="md-nav__link">
+    <span class="md-ellipsis">
+        Engineering Kit（工程命令层）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#残余状态合集" class="md-nav__link">
+    <span class="md-ellipsis">
+        残余状态合集
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#失败后调用方该做什么" class="md-nav__link">
+    <span class="md-ellipsis">
+        失败后调用方该做什么
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+    </li>
+    <li class="md-nav__item">
+      <a href="../api/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · API 参考
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../api/contracts/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Contracts API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../api/harness/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Harness API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../api/engineering-kit/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Engineering Kit API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples-and-fixtures/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 样例与 Fixture
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Recipes
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/adopt-existing-repository/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 采用存量仓库
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/safe-filesystem-and-atomic-write/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 安全文件系统与原子写
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/adapter-text-closure/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Adapter 文本闭包
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/deterministic-human-report/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 确定性人类报告
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/durable-local-state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 持久本地状态
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/host-profile-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 宿主 Profile 集成
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../recipes/domain-schema-validation/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 领域 Schema 校验
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Home
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/quickstart/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Quickstart
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/help/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Capabilities and diagnostics
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/architecture/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Architecture
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/migration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Migration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/licensing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Licensing
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/agents/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Agent entry
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/agents/architecture-routing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Architecture routing
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Compatibility
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/failure-and-side-effect-matrix/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Failures and side effects
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/api/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · API reference
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/examples-and-fixtures/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Examples and fixtures
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Recipes
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/adopt-existing-repository/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Adopt an existing repository
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/safe-filesystem-and-atomic-write/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Safe filesystem and atomic write
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/adapter-text-closure/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Adapter text closure
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/deterministic-human-report/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Deterministic human report
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/durable-local-state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Durable local state
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/host-profile-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Host Profile integration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/domain-schema-validation/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Domain Schema validation
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 入口
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/mutation-taxonomy/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 变异分类学
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/independence/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 独立性证明
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/version-compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 版本兼容
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/failure-evidence/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 失败证据与 AUD 码
+  </span>
+      </a>
+    </li>
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#Contracts纯函数层" class="md-nav__link">
+    <span class="md-ellipsis">
+        Contracts（纯函数层）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#Harness机制层受收容" class="md-nav__link">
+    <span class="md-ellipsis">
+        Harness（机制层，受收容）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#Engineering-Kit工程命令层" class="md-nav__link">
+    <span class="md-ellipsis">
+        Engineering Kit（工程命令层）
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#残余状态合集" class="md-nav__link">
+    <span class="md-ellipsis">
+        残余状态合集
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#失败后调用方该做什么" class="md-nav__link">
+    <span class="md-ellipsis">
+        失败后调用方该做什么
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+<blockquote>
+<p><a href="../../en/reference/failure-and-side-effect-matrix/">English</a></p>
+</blockquote>
+<h1 id="失败与副作用矩阵">失败与副作用矩阵<a class="headerlink" href="#失败与副作用矩阵" title="Permanent link">&para;</a></h1>
+<p>本页逐公共入口列出读写、spawn、Git、网络、残余状态与稳定错误码。它服务于调用方在接入前判断风险，并作为 <code>capability-catalog.json</code> 中 <code>sideEffects</code> 与 <code>failureSemantics</code> 字段的人类可读投影。所有事实以真实实现与负例测试为准。</p>
+<blockquote>
+<p>符号约定：读=读取文件系统；写=写入文件系统；spawn=启动子进程；Git=读写 Git；网络=访问远端；残余=调用结束后仍留在磁盘/进程中的状态。</p>
+</blockquote>
+<h2 id="Contracts纯函数层">Contracts（纯函数层）<a class="headerlink" href="#Contracts纯函数层" title="Permanent link">&para;</a></h2>
+<table>
+<thead>
+<tr>
+<th>入口</th>
+<th>读</th>
+<th>写</th>
+<th>spawn</th>
+<th>Git</th>
+<th>网络</th>
+<th>残余状态</th>
+<th>稳定错误码</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>validateDocument</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（编译缓存仅驻留内存）</td>
+<td><code>SFC1001</code>/<code>SFC1002</code>/<code>SFC1006</code></td>
+</tr>
+<tr>
+<td><code>compileSchema</code> / <code>detectDialect</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC1006</code>/<code>SFC1012</code></td>
+</tr>
+<tr>
+<td><code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC1003</code>/<code>SFC1004</code></td>
+</tr>
+<tr>
+<td><code>runChecks</code> / <code>collectUnresolvedRefs</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC1002</code>–<code>SFC1010</code></td>
+</tr>
+<tr>
+<td><code>verifyAllFixtures</code> / <code>verifyFixture</code></td>
+<td>否</td>
+<td>否</td>
+<td>否? 否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC1010</code></td>
+</tr>
+<tr>
+<td><code>ERROR_CODES</code> / <code>stableError</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td>冻结登记表，不新增</td>
+</tr>
+</tbody>
+</table>
+<p>Contracts 全部为纯函数，无文件/Git/网络/进程副作用；错误对象含 <code>stableError</code> 与 <code>details.kind</code>，便于调用方分类。</p>
+<h2 id="Harness机制层受收容">Harness（机制层，受收容）<a class="headerlink" href="#Harness机制层受收容" title="Permanent link">&para;</a></h2>
+<table>
+<thead>
+<tr>
+<th>入口</th>
+<th>读</th>
+<th>写</th>
+<th>spawn</th>
+<th>Git</th>
+<th>网络</th>
+<th>残余状态</th>
+<th>稳定错误码</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>validateContractDocument</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（校验器缓存内存）</td>
+<td><code>SFC</code> 校验失败</td>
+</tr>
+<tr>
+<td><code>resolveContained</code> / <code>readFileContained</code></td>
+<td>是（只读）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC2004</code>（<code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>）</td>
+</tr>
+<tr>
+<td><code>writeFileAtomic</code></td>
+<td>否</td>
+<td>是（受收容）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>失败回滚临时文件</td>
+<td><code>SFC2004</code>（<code>atomic-write-failed</code>）</td>
+</tr>
+<tr>
+<td><code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code></td>
+<td>否</td>
+<td>是（临时目录）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>退出时清理临时目录</td>
+<td><code>SFC2004</code>（<code>workspace-disposed</code>）</td>
+</tr>
+<tr>
+<td><code>computeResourceClosure</code> / <code>digestBytes</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC</code>（声明/内容违规）</td>
+</tr>
+<tr>
+<td><code>parseRequest</code> / <code>processRequest</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（纯函数管线）</td>
+<td><code>SFC2004</code></td>
+</tr>
+<tr>
+<td><code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>checkReport</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（纯函数）</td>
+<td><code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code></td>
+</tr>
+<tr>
+<td><code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC2004</code>（<code>missing-resource</code>）</td>
+</tr>
+<tr>
+<td><code>materializeAdapterBuild</code></td>
+<td>否</td>
+<td>是（受收容，sibling + rename）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（原子 rename）</td>
+<td><code>SFC2004</code></td>
+</tr>
+<tr>
+<td><code>probeVersionVector</code></td>
+<td>否</td>
+<td>否</td>
+<td>默认否（需显式 <code>--allow-host-spawn</code>）</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC2004</code></td>
+</tr>
+<tr>
+<td><code>openStateStore</code> / <code>appendEvent</code> / <code>readEvents</code> / <code>writeSnapshot</code></td>
+<td>是</td>
+<td>是（事件/快照/锁文件）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>事件日志 + 锁文件</td>
+<td><code>SFC2004</code>（<code>store-locked</code>/链断裂）</td>
+</tr>
+<tr>
+<td><code>inspectStateStoreLock</code> / <code>recoverStateStoreLock</code></td>
+<td>是</td>
+<td>是（仅恢复写锁）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>锁文件（单调 fencing）</td>
+<td><code>SFC2004</code></td>
+</tr>
+</tbody>
+</table>
+<p>Harness 的 <code>HARNESS_EXCLUSIONS</code> 明确排除 release-state、remote-network-access、business-semantics、workflow-orchestration、model-calls、git-writes。</p>
+<h2 id="Engineering-Kit工程命令层">Engineering Kit（工程命令层）<a class="headerlink" href="#Engineering-Kit工程命令层" title="Permanent link">&para;</a></h2>
+<table>
+<thead>
+<tr>
+<th>入口</th>
+<th>读</th>
+<th>写</th>
+<th>spawn</th>
+<th>Git</th>
+<th>网络</th>
+<th>残余状态</th>
+<th>稳定错误码 / 退出码</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>scaffoldTarget</code></td>
+<td>否</td>
+<td>是（受收容骨架，原子 + 收容）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（失败不留半成品）</td>
+<td><code>SFC2004</code>（<code>target-not-empty</code>）</td>
+</tr>
+<tr>
+<td><code>planAdoption</code> / <code>buildHandoffDraft</code></td>
+<td>是</td>
+<td>否</td>
+<td>否</td>
+<td>只读探测</td>
+<td>否</td>
+<td>无（stdout 输出）</td>
+<td><code>SFC</code> 完成判定 false</td>
+</tr>
+<tr>
+<td><code>runProjection</code></td>
+<td>是（读 manifest）</td>
+<td>是（受管路径，两阶段）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无（失败零写/回滚）</td>
+<td><code>SFC2004</code>（<code>unauthorized-path</code>/<code>handwritten-overwrite</code>/<code>conflict-drift</code>）</td>
+</tr>
+<tr>
+<td><code>runChecks</code>（<code>check</code>）</td>
+<td>是</td>
+<td>否</td>
+<td>否</td>
+<td>只读白名单</td>
+<td>否</td>
+<td>无</td>
+<td>退出码 1（发现）/ 2（机制）</td>
+</tr>
+<tr>
+<td><code>renderReportAction</code> / <code>checkReportAction</code></td>
+<td>是</td>
+<td>仅 <code>--out</code>/<code>--binding</code></td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>默认只写 stdout</td>
+<td><code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code></td>
+</tr>
+<tr>
+<td><code>probeGitState</code> / <code>probeGitFacts</code></td>
+<td>是</td>
+<td>否</td>
+<td>否</td>
+<td>只读白名单</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC</code>（越权参数拒绝）</td>
+</tr>
+<tr>
+<td><code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code></td>
+<td>是</td>
+<td>build 写（受收容）</td>
+<td>probe 默认否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC2004</code>；apply 稳定拒绝</td>
+</tr>
+<tr>
+<td><code>loadLicensingProfile</code> / <code>generateLicenseContent</code> 等</td>
+<td>否</td>
+<td>否（纯函数生成）</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td><code>SFC</code>（非法 Profile）</td>
+</tr>
+<tr>
+<td><code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code></td>
+<td>是</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>否</td>
+<td>无</td>
+<td>findings</td>
+</tr>
+<tr>
+<td><code>cliMain</code> / <code>runCommand</code></td>
+<td>依命令</td>
+<td>依命令</td>
+<td>依命令</td>
+<td>依命令</td>
+<td>否</td>
+<td>依命令</td>
+<td>退出码 0/1/2</td>
+</tr>
+</tbody>
+</table>
+<p>Kit 的 <code>FORBIDDEN_SIDE_EFFECTS</code> 含 git-init/commit/push/tag、publish、remote-write；<code>REFUSED_MUTATION_FLAGS</code>（含 <code>--apply</code>）在 CLI 入口即拒。</p>
+<h2 id="残余状态合集">残余状态合集<a class="headerlink" href="#残余状态合集" title="Permanent link">&para;</a></h2>
+<ul>
+<li>原子写：失败时回滚临时文件，目标目录不留半成品。</li>
+<li>临时工作区：退出（含异常路径）时清理。</li>
+<li>状态存储：事件日志是唯一权威，snapshot 为派生缓存；崩溃遗留锁需调用方在 Foundation 外确认旧写者终止后显式恢复，不自动偷锁。</li>
+<li>投影：任一校验失败整体拒绝、零写入；覆盖既有文件需声明 <code>expect.sha256</code> 前置状态。</li>
+<li>adopt-plan / check：结构性只读，运行前后字节级零变化。</li>
+</ul>
+<h2 id="失败后调用方该做什么">失败后调用方该做什么<a class="headerlink" href="#失败后调用方该做什么" title="Permanent link">&para;</a></h2>
+<ul>
+<li>校验失败（<code>SFC1001</code>/<code>SFC2002</code>/<code>SFC2003</code>）：检查输入是否满足目标 Schema 或参数合同，不重试已被冻结拒绝的登记。</li>
+<li>收容失败（<code>SFC2004</code> + <code>path-traversal</code> 等）：确认根目录与路径是否越界，不要把业务选择规则塞进 Foundation。</li>
+<li>状态锁冲突（<code>store-locked</code>）：在 Foundation 之外确认旧写者已终止，再用精确匹配的 owner/fencing 调用恢复。</li>
+<li>check 发现（退出码 1）：处置发现项，Kit 不自动修复。</li>
+</ul>
+              </article>
+            </div>
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+      </main>
+        <footer class="md-footer">
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+</div>
+    </div>
+  </div>
+</footer>
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+      <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": [], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "\u5df2\u590d\u5236", "clipboard.copy": "\u590d\u5236", "search.result.more.one": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.more.other": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 # \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.none": "\u6ca1\u6709\u627e\u5230\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.one": "\u627e\u5230 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.other": "# \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.placeholder": "\u952e\u5165\u4ee5\u5f00\u59cb\u641c\u7d22", "search.result.term.missing": "\u7f3a\u5c11", "select.version": "\u9009\u62e9\u5f53\u524d\u7248\u672c"}, "version": null}</script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
+  </body>
+</html>