skill-family-engineering-kit 0.25.0 → 0.27.0

package/data/hosts/qoder/host-descriptor.json

@@ -11,7 +11,15 @@
     "authStrategy": "existing-user-state",
     "credentialMutation": "host-managed"
   },
-  "pathCategories": [],
+  "pathCategories": [
+    {
+      "id": "qoder-project-skills",
+      "role": "skill-root",
+      "scope": "project",
+      "anchor": "project-root",
+      "relPath": ".qoder/skills"
+    }
+  ],
   "probeCapabilities": [
     "cli",
     "version",

package/data/hosts/workbuddy/host-descriptor.json

@@ -18,6 +18,13 @@
       "scope": "project",
       "anchor": "project-root",
       "relPath": "skills"
+    },
+    {
+      "id": "workbuddy-project-skills",
+      "role": "skill-root",
+      "scope": "project",
+      "anchor": "project-root",
+      "relPath": ".workbuddy/skills"
     }
   ],
   "probeCapabilities": [

package/docs/agents/capability-catalog.en.json

@@ -1507,6 +1507,57 @@
     "Foundation entry contract: check entries"
    ]
   },
+  {
+   "id": "foundation.kit.register-existing",
+   "intent": "Seed the three official closed-world documents for a nonempty project that already has a valid profile.json and does not yet have a legal registry",
+   "useWhen": [
+    "Need the only legal first write of .foundation/file-registry.json, skill-family.project-manifest.json, and skill-family.managed-file-lock.json into a nonempty root",
+    "Need an official first-nonempty registration that is exclusive-create, idempotent on identical bytes, and refuse-with-zero-overwrite otherwise"
+   ],
+   "doNotUseWhen": [
+    "The target is empty (use scaffold)",
+    "The three official documents already exist and a later handwritten file must be admitted (use check relock)",
+    "Need a read-only inventory of an existing project (use adopt-plan)",
+    "Need to overwrite drifted closed-world bytes"
+   ],
+   "prerequisites": [
+    "Caller supplies an absolute project working directory",
+    "profile.json exists at the target root and is contract-valid, including profile.adoption.foundation_profile.id",
+    "handwritten classification list is non-empty"
+   ],
+   "inputs": [
+    "Absolute project working directory root",
+    "Non-empty handwritten globs or relative paths",
+    "Optional engineering JSON, trackedToolLocks paths, and gitignore-style artifacts patterns"
+   ],
+   "outputs": [
+    "register-existing report (kind skill-family.register-existing-report)",
+    "On first create: exclusive publication of the three closed-world documents; on identical bytes: idempotent success with zero write; otherwise refuse with zero overwrite"
+   ],
+   "sideEffects": [
+    "Writes at most the three closed-world documents; never overwrites mismatched existing bytes; does not scaffold, apply adopt-plan, or seed via relock"
+   ],
+   "failureSemantics": [
+    "Missing or invalid profile.json refuses",
+    "Empty handwritten list refuses",
+    "Class overlap among handwritten, artifacts, and trackedToolLocks refuses",
+    "Any incomplete or drifted combination of the three documents refuses with zero overwrite"
+   ],
+   "invariants": [
+    "Adds no fifth top-level command; it runs as the check register-existing sub-action",
+    "Relock never seeds; this sub-action is the only legal first write of the three documents into a nonempty root",
+    "Scaffold still refuses nonempty directories; adopt-plan remains read-only"
+   ],
+   "ownedByCaller": [
+    "Choosing handwritten, artifacts, and trackedToolLocks classifications",
+    "Remediation after a refuse-with-zero-overwrite result"
+   ],
+   "routeElsewhere": [
+    "Empty target: scaffold",
+    "Existing legal registry plus new handwritten files: check relock",
+    "Read-only nonempty inventory: adopt-plan"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "intent": "Run the controlled relock transaction: register new handwritten files by default, or persistent tool-lock paths with explicit trackedToolLocks selection; update the registry and managed-file lock in the existing transaction without hashing tool-lock contents.",

package/docs/agents/capability-catalog.json

@@ -996,6 +996,32 @@
     "packages/skill-family-engineering-kit/test/cli.test.mjs"
    ]
   },
+  {
+   "id": "foundation.kit.register-existing",
+   "package": "skill-family-engineering-kit",
+   "layer": "engineering-kit",
+   "since": "0.27.0",
+   "stability": "candidate",
+   "migration": "none",
+   "promotionPolicy": "consumer-transparent",
+   "adoptionScopes": ["engineering-kit"],
+   "entrypoints": [
+    "runRegisterExisting (packages/skill-family-engineering-kit/src/register-existing.mjs)",
+    "registerExistingAction (packages/skill-family-engineering-kit/src/register-existing.mjs)",
+    "REGISTER_EXISTING_REPORT_KIND (packages/skill-family-engineering-kit/src/register-existing.mjs)"
+   ],
+   "sourceRefs": [
+    "packages/skill-family-engineering-kit/src/register-existing.mjs",
+    "packages/skill-family-engineering-kit/src/cli.mjs",
+    "packages/skill-family-engineering-kit/src/index.mjs"
+   ],
+   "positiveTestRefs": [
+    "packages/skill-family-engineering-kit/test/register-existing.test.mjs"
+   ],
+   "negativeTestRefs": [
+    "packages/skill-family-engineering-kit/test/register-existing.test.mjs"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "package": "skill-family-engineering-kit",

package/docs/agents/capability-catalog.zh-CN.json

@@ -1506,6 +1506,57 @@
     "Foundation 入口契约：check entries"
    ]
   },
+  {
+   "id": "foundation.kit.register-existing",
+   "intent": "为已有有效 profile.json、尚未具备合法登记的非空工程，播种三份官方闭域文件",
+   "useWhen": [
+    "需要把 .foundation/file-registry.json、skill-family.project-manifest.json、skill-family.managed-file-lock.json 合法地首次写入非空根",
+    "需要官方首次非空登记：三份皆无则排他创建，字节一致则幂等零写入，其余情况拒绝且零覆盖"
+   ],
+   "doNotUseWhen": [
+    "目标为空（走 scaffold）",
+    "三份官方文件已存在、只需纳入后来的手写文件（走 check relock）",
+    "只需只读盘点既有工程（走 adopt-plan）",
+    "需要覆盖已漂移的闭域字节"
+   ],
+   "prerequisites": [
+    "调用方给出绝对项目工作目录",
+    "目标根已有合同有效的 profile.json，且含 profile.adoption.foundation_profile.id",
+    "手写分类清单非空"
+   ],
+   "inputs": [
+    "绝对项目工作目录 root",
+    "非空手写 glob 或相对路径",
+    "可选 engineering JSON、trackedToolLocks 路径，以及 gitignore 风格的 artifacts 模式"
+   ],
+   "outputs": [
+    "register-existing 报告（kind skill-family.register-existing-report）",
+    "首次创建时排他写入三份闭域文件；字节一致时幂等成功且零写入；否则拒绝且零覆盖"
+   ],
+   "sideEffects": [
+    "最多写入三份闭域文件；从不覆盖不匹配的既有字节；不 scaffold、不 apply adopt-plan、不经 relock 播种"
+   ],
+   "failureSemantics": [
+    "缺少或无效的 profile.json 拒绝",
+    "空手写清单拒绝",
+    "handwritten、artifacts、trackedToolLocks 分类重叠拒绝",
+    "三份文件任一不完整或字节漂移时拒绝且零覆盖"
+   ],
+   "invariants": [
+    "不新增第五个顶层命令，落在 check register-existing 子动作",
+    "relock 不为缺锁工程播种；本子动作是非空根首次写入三份文件的唯一合法入口",
+    "scaffold 仍拒绝非空目录；adopt-plan 仍只读"
+   ],
+   "ownedByCaller": [
+    "选择 handwritten、artifacts、trackedToolLocks 分类",
+    "拒绝且零覆盖之后的整改"
+   ],
+   "routeElsewhere": [
+    "空目标：scaffold",
+    "已有合法登记且需纳入新手写文件：check relock",
+    "非空只读盘点：adopt-plan"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "intent": "运行受控 relock 事务：默认登记新增手写文件；显式选择 trackedToolLocks 时登记持久工具锁路径，并在原事务中同步 registry 与受管文件锁。工具锁内容不纳入受管摘要。",

package/docs/public/status/index.html

@@ -1814,24 +1814,24 @@
 <tbody>
 <tr>
 <td><code>skill-family-contracts</code></td>
-<td>0.25.0</td>
+<td>0.27.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-contracts">ifoohoo/skill-family-contracts</a></td>
 </tr>
 <tr>
 <td><code>skill-family-harness-node</code></td>
-<td>0.25.0</td>
+<td>0.27.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-harness-node">ifoohoo/skill-family-harness-node</a></td>
 </tr>
 <tr>
 <td><code>skill-family-engineering-kit</code></td>
-<td>0.25.0</td>
+<td>0.27.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-engineering-kit">ifoohoo/skill-family-engineering-kit</a></td>
 </tr>
 </tbody>
 </table>
 <h2 id="独立-Plugin">独立 Plugin<a class="headerlink" href="#独立-Plugin" title="Permanent link">&para;</a></h2>
 <ul>
-<li><code>foundation-adoption-review</code>：0.25.0，公开镜像 <a href="https://github.com/ifoohoo/foundation-adoption-review">ifoohoo/foundation-adoption-review</a></li>
+<li><code>foundation-adoption-review</code>：0.27.0，公开镜像 <a href="https://github.com/ifoohoo/foundation-adoption-review">ifoohoo/foundation-adoption-review</a></li>
 <li><code>foundation-adoption-review</code>：只读采用诊断</li>
 <li><code>foundation-engineering-check</code>：只读静态工程审阅与证明读取</li>
 <li><code>foundation-initialize</code>：在明确授权下初始化目标工程，保留业务和人工判断</li>