skill-family-harness-node 0.1.0 → 0.1.2

package/CONTRIBUTING.md

@@ -7,8 +7,18 @@ Git 写操作的授权边界见仓库内文档站的生命周期指南（`docs/g
 拓扑说明：本工作区仓永久 private，是唯一开发真源；三个 public 仓
 （`skill-family-contracts`、`skill-family-harness-node`、
 `skill-family-engineering-kit`）是版本化发布镜像，不承载完整开发历史与
-测试，也不接受直接 PR 或 issue。本指南描述的是私有工作区内经授权的开发
-流程；消费坐标与发布状态唯一见 `docs/status/current.md`。
+测试。本指南描述的是私有工作区内经授权的开发流程；消费坐标与发布状态
+唯一见 `docs/status/current.md`。
+
+## Bug 报告与 Issue
+
+普通 bug 报告欢迎通过各 public 发布镜像仓的 GitHub Issues 提交（例如
+`https://github.com/ifoohoo/skill-family-engineering-kit/issues`）。提交
+bug 报告时请尽量提供：受影响包与版本、最小复现步骤、预期与实际行为。
+
+**未经事先讨论的 Pull Request 不予接受。** 如果你希望贡献代码，请先
+通过 Issue 讨论变更的动机与范围，获得维护者确认后再提交 PR。这是为了
+避免重复劳动、确保变更与本项目的架构裁决和发布合同一致。
 
 ## 本地安装
 

package/README.md

@@ -39,7 +39,7 @@ Contracts 机制协议的**唯一默认 Node 实现**。这是一个薄运行时
 3. 符号链接逃逸：末位组件是指向根外的符号链接（或断链）→ `symlink-escape`。
 4. 真实路径逃逸：任一中间符号链接链的规范化结果离开根 → `realpath-escape`。
 
-比较基于 `realpath` 之后的规范根，避免 macOS `/var → /private/var` 一类系统级符号链接造成误判。
+比较是基于 `realpath` 之后的规范根，避免 macOS `/var → /private/var` 一类系统级符号链接造成误判。
 
 ## 测试
 
@@ -49,14 +49,28 @@ Contracts 机制协议的**唯一默认 Node 实现**。这是一个薄运行时
 
 ```sh
 npm install skill-family-harness-node
+npm info skill-family-harness-node --help
 ```
 
 ## 最小示例
 
 ```js
-// release-skill: harness runtime validation
+// 从空目录运行：npm install skill-family-harness-node
 import { validateContractDocument } from "skill-family-harness-node";
-const result = validateContractDocument(doc, { schemaId: "project-manifest" });
+
+const document = {
+  schemaVersion: 1,
+  kind: "skill-family.project-manifest",
+  project: { id: "my-project", name: "My Project", description: "Example" },
+  contracts: { version: "1.0.0", profile: "generic" },
+  managedFiles: ["package.json"],
+  updatedAt: "2026-01-01T00:00:00Z",
+};
+
+const result = validateContractDocument(document, {
+  schemaId: "https://contracts.skill-family.example/v1/project-manifest.json",
+});
+if (!result.valid) console.error(result.errorCode);
 ```
 
 ## 故障诊断

package/SECURITY.md

@@ -12,11 +12,15 @@
 ## 报告漏洞
 
 请勿通过公开 issue 直接披露未修复的安全漏洞。private workspace 仓永久
-private，不是公开报告渠道；请通过任一 public 发布镜像仓（例如
-`https://github.com/ifoohoo/skill-family-engineering-kit`）在 GitHub 上使用
-**Private vulnerability reporting**（仓库 Security 页签的
-"Report a vulnerability"）私下报告；如该通道不可用，再通过仓库维护者
-提供的私下联系方式报告。
+private，不是公开报告渠道；请通过以下渠道私下报告：
+
+1. **首选**：通过任一 public 发布镜像仓（例如
+   `https://github.com/ifoohoo/skill-family-engineering-kit`）在 GitHub 上使用
+   **Private vulnerability reporting**（仓库 Security 页签的
+   "Report a vulnerability"）；
+2. **备选**：如上述通道不可用，请通过邮件联系仓库维护者
+   （`ifoohoo` GitHub 组织的 `security` 团队，或仓库 `README.md` 中列出的
+   维护者邮箱）。
 
 报告时请尽量提供：
 

package/package.json

@@ -1,35 +1,35 @@
 {
-  "name": "skill-family-harness-node",
-  "version": "0.1.0",
-  "private": false,
-  "description": "Thin Node.js mechanism runtime for Skill Family engineering contracts.",
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"npx projen\".",
   "author": "广州市风荷科技有限公司",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ifoohoo/skill-family-harness-node.git"
-  },
-  "homepage": "https://github.com/ifoohoo/skill-family-harness-node",
   "bugs": {
     "url": "https://github.com/ifoohoo/skill-family-harness-node/issues"
   },
-  "type": "module",
+  "dependencies": {
+    "skill-family-contracts": "0.1.2"
+  },
+  "description": "Thin Node.js mechanism runtime for Skill Family engineering contracts.",
   "engines": {
     "node": ">=22.22.2 <23"
   },
   "exports": "./src/index.mjs",
-  "dependencies": {
-    "skill-family-contracts": "0.1.0"
-  },
   "files": [
     "src",
     "SECURITY.md",
     "CONTRIBUTING.md",
     "CODE_OF_CONDUCT.md"
   ],
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"npx projen\".",
+  "homepage": "https://github.com/ifoohoo/skill-family-harness-node",
+  "license": "Apache-2.0",
+  "name": "skill-family-harness-node",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ifoohoo/skill-family-harness-node.git"
+  },
+  "type": "module",
+  "version": "0.1.2",
   "scripts": {
-    "check": "node --test",
-    "test": "node --test"
+    "check": "node --input-type=module -e \"import('./src/index.mjs').then(() => console.log('smoke ok')).catch(e => { console.error(e); process.exit(1) })\"",
+    "test": "node --input-type=module -e \"import('./src/index.mjs').then(() => console.log('smoke ok')).catch(e => { console.error(e); process.exit(1) })\""
   }
 }