npm - skill-family-engineering-kit - Versions diffs - 0.1.0 - Mend

skill-family-engineering-kit 0.1.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 (80) hide show

package/CODE_OF_CONDUCT.md +131 -0
package/CONTRIBUTING.md +69 -0
package/LICENSE +201 -0
package/README.md +74 -0
package/SECURITY.md +34 -0
package/data/licensing/registry.json +211 -0
package/data/licensing/schema.json +207 -0
package/docs/.nojekyll +0 -0
package/docs/404.html +613 -0
package/docs/architecture/index.html +904 -0
package/docs/assets/images/favicon.png +0 -0
package/docs/assets/javascripts/bundle.d7400e89.min.js +16 -0
package/docs/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
package/docs/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
package/docs/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
package/docs/assets/javascripts/lunr/tinyseg.js +206 -0
package/docs/assets/javascripts/lunr/wordcut.js +6708 -0
package/docs/assets/javascripts/workers/search.2c215733.min.js +42 -0
package/docs/assets/stylesheets/main.ec1eaa64.min.css +1 -0
package/docs/assets/stylesheets/palette.ab4e12ef.min.css +1 -0
package/docs/git-lifecycle/index.html +976 -0
package/docs/help/index.html +907 -0
package/docs/index.html +837 -0
package/docs/integration/audit/baseline/audit-codes.json +62 -0
package/docs/integration/audit/failure-evidence/index.html +872 -0
package/docs/integration/audit/independence/index.html +841 -0
package/docs/integration/audit/index.html +826 -0
package/docs/integration/audit/mutation-taxonomy/index.html +1022 -0
package/docs/integration/audit/schemas/audit-evidence.schema.json +182 -0
package/docs/integration/audit/version-compatibility/index.html +845 -0
package/docs/migration/index.html +1213 -0
package/docs/quickstart/index.html +842 -0
package/docs/search/search_index.json +1 -0
package/docs/setup/index.html +941 -0
package/docs/sitemap.xml +51 -0
package/package.json +42 -0
package/src/adopt-plan.mjs +594 -0
package/src/check.mjs +415 -0
package/src/cli.mjs +230 -0
package/src/errors.mjs +144 -0
package/src/gitprobe.mjs +230 -0
package/src/identity-check.mjs +563 -0
package/src/index.mjs +233 -0
package/src/license-texts/Apache-2.0.txt +201 -0
package/src/license-texts/MIT.txt +21 -0
package/src/licensing.mjs +299 -0
package/src/migration.mjs +427 -0
package/src/projection.mjs +397 -0
package/src/scaffold.mjs +178 -0
package/src/skeleton.mjs +886 -0
package/src/workspace.mjs +236 -0

package/docs/help/index.html ADDED Viewed

@@ -0,0 +1,907 @@
+<!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/help/">
+        <link rel="prev" href="../git-lifecycle/">
+        <link rel="next" href="../architecture/">
+      <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 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="#当前能做什么" 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>
+        <li class="md-nav__item">
+  <a href="#Kit-四命令与副作用" class="md-nav__link">
+    <span class="md-ellipsis">
+        Kit 四命令与副作用
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#check-的七个诊断类" class="md-nav__link">
+    <span class="md-ellipsis">
+        check 的七个诊断类
+    </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="../architecture/" 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="../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="#当前能做什么" 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>
+        <li class="md-nav__item">
+  <a href="#Kit-四命令与副作用" class="md-nav__link">
+    <span class="md-ellipsis">
+        Kit 四命令与副作用
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#check-的七个诊断类" class="md-nav__link">
+    <span class="md-ellipsis">
+        check 的七个诊断类
+    </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">
+<h1 id="能力与诊断">能力与诊断<a class="headerlink" href="#能力与诊断" title="Permanent link">&para;</a></h1>
+<p>产品级的当前状态只在唯一状态页 当前产品状态 声明（由 <code>node scripts/docs/fact-check.mjs</code> 对照机器真源机械校验）；本页正文不复制任何动态状态口径。仓内检查的诚实边界：manifest、package.json、门禁脚本与工作流等结构检查只证明“字节/结构一致性（仓内可证）”；自然语言语义的正确性不属于仓内正则或摘要可证明的范围，需外部独立审阅。</p>
+<h2 id="当前能做什么">当前能做什么<a class="headerlink" href="#当前能做什么" title="Permanent link">&para;</a></h2>
+<ul>
+<li>projen 受管文件的合成（<code>pnpm synth</code>）、只读漂移检查（<code>pnpm drift</code>）与幂等性验证（<code>pnpm synth-idempotency</code>）；</li>
+<li>Contracts v1 校验：六类顶层对象、协议名登记、SFC 错误码体系、13 条强制机械规则（预算不超过 20 条，绝对上限 30 条）；</li>
+<li>Harness 机制：原子写、路径与符号链接收容、资源闭包、临时工作区、kernel 请求处理；</li>
+<li>Engineering Kit 四命令（见下节），全部不执行 Git 写操作、发布或删除；</li>
+<li>稳定产品门禁（<code>pnpm check</code> 串联，逐 ID 见 当前产品状态）；</li>
+<li>发布字节合同：<code>pnpm run release-artifacts:build</code> 与 <code>pnpm run release-artifacts:verify</code>（见 当前产品状态）；</li>
+<li>公开静态站渲染：<code>node scripts/render-public-site.mjs</code>（冻结 MkDocs 环境 strict 构建、内容泄漏扫描与确定性基线；<code>--write</code> / <code>--check</code> / <code>--self-test</code>）；</li>
+<li>文档事实/链接检查（<code>node scripts/docs/fact-check.mjs</code>、<code>node scripts/docs/link-check.mjs</code>）。</li>
+</ul>
+<h2 id="当前不能做什么">当前不能做什么<a class="headerlink" href="#当前不能做什么" title="Permanent link">&para;</a></h2>
+<ul>
+<li>不提供发布、部署或远端写入的命令能力；发布与部署的当前状态见 当前产品状态；</li>
+<li>没有第五个 Kit 顶层命令；<code>check</code> 只诊断、绝不自动修复；</li>
+<li>不做多宿主投影、Python 对称运行时或第二套模板引擎（首版禁止扩张项）。</li>
+</ul>
+<h2 id="Kit-四命令与副作用">Kit 四命令与副作用<a class="headerlink" href="#Kit-四命令与副作用" title="Permanent link">&para;</a></h2>
+<p>CLI 入口：<code>packages/skill-family-engineering-kit/src/cli.mjs</code>。恰好四个顶层命令：</p>
+<table>
+<thead>
+<tr>
+<th>命令</th>
+<th>作用</th>
+<th>副作用边界</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>scaffold</code></td>
+<td>在空目录生成 Skill Family 项目骨架</td>
+<td>只向空目标目录写入骨架文件（原子写、路径收容）；非空或冲突目标被拒绝且不被触碰</td>
+</tr>
+<tr>
+<td><code>adopt-plan</code></td>
+<td>严格只读地规划存量仓采用</td>
+<td>无——不写任何文件（含临时文件），不运行 Git 写命令；计划输出到 stdout</td>
+</tr>
+<tr>
+<td><code>projection</code></td>
+<td>投影受管生成物</td>
+<td>只写 manifest 授权且被目标声明为受管的路径；未授权、手写或越界路径一律拒绝（拒绝时零写入）</td>
+</tr>
+<tr>
+<td><code>check</code></td>
+<td>契约/漂移/闭包/版本/文档事实/Git 前置状态/许可证身份诊断</td>
+<td>无——只诊断、绝不自动修复；Git 仅只读探测</td>
+</tr>
+</tbody>
+</table>
+<p>退出码：0 成功或无发现；1 <code>check</code> 有发现；2 拒绝、用法或机制错误。每次拒绝都打印已注册的 SFC 错误码和稳定 kind。<code>--fix</code>、<code>--apply</code> 等变更模式标志在入口处被拒绝（退出码 2）。</p>
+<h2 id="check-的七个诊断类">check 的七个诊断类<a class="headerlink" href="#check-的七个诊断类" title="Permanent link">&para;</a></h2>
+<p><code>check</code> 命令按类报告发现，可用 <code>--only &lt;class&gt;</code> 单独运行一类：</p>
+<table>
+<thead>
+<tr>
+<th>类</th>
+<th>检查内容</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>contracts</code></td>
+<td>发现的契约文档是否通过已登记 Schema 校验</td>
+</tr>
+<tr>
+<td><code>drift</code></td>
+<td>managed-file-lock 条目与磁盘实际字节是否一致</td>
+</tr>
+<tr>
+<td><code>closure</code></td>
+<td>声明输入/输出的资源闭包是否完整</td>
+</tr>
+<tr>
+<td><code>version</code></td>
+<td>声明的 Contracts 版本与冻结版本是否一致</td>
+</tr>
+<tr>
+<td><code>docs</code></td>
+<td>文档事实（README 存在性、身份一致性）</td>
+</tr>
+<tr>
+<td><code>git</code></td>
+<td>只读 Git 前置状态（绝不执行 Git 写）</td>
+</tr>
+<tr>
+<td><code>identity</code></td>
+<td>许可证 Profile 与身份防漂移（机器身份记录为权威）</td>
+</tr>
+</tbody>
+</table>
+<h2 id="故障排查">故障排查<a class="headerlink" href="#故障排查" title="Permanent link">&para;</a></h2>
+<ul>
+<li>命令失败时先确认 Node、pnpm 与锁文件一致（见 <a href="../setup/">安装与环境</a>），再运行 <code>pnpm synth</code>；不要手改 projen 生成文件来绕过失败；</li>
+<li>Git 写操作的授权边界唯一见 <a href="../git-lifecycle/">Git 生命周期指南</a>；未获针对当前任务的显式授权时不得执行任何 Git 写操作；</li>
+<li><code>pnpm check</code> 失败会打印具体门禁与路径；按提示修复根因，不得为转绿放宽检查或修改独立预期值；</li>
+<li>并行开发时若疑似资源抢占导致偶发失败，稍候重试一次再下结论；</li>
+<li>文档站点构建失败时优先核对 <code>scripts/docs/requirements.txt</code> 是否与 <code>scripts/docs/toolchain.json</code> 一致（<code>node scripts/docs/fact-check.mjs</code> 会校验）。</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>