Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -56,15 +56,14 @@ jobs:
set -euo pipefail
mkdir release
npm pack --json --ignore-scripts --pack-destination release > "$RUNNER_TEMP/package.json"
node scripts/check-package.mjs "$RUNNER_TEMP/package.json"
npm sbom --sbom-format cyclonedx --package-lock-only --omit=dev > release/sbom.cyclonedx.json
node --input-type=module - "$RUNNER_TEMP/package.json" <<'JS'
import fs from 'node:fs';
import crypto from 'node:crypto';
const [pack]=JSON.parse(fs.readFileSync(process.argv[2],'utf8'));
const version=JSON.parse(fs.readFileSync('package.json','utf8')).version;
if(pack.name!=='@chumanic/skillsync'||pack.version!==version||pack.filename!==`chumanic-skillsync-${version}.tgz`) throw new Error('Package identity mismatch');
const allowed=/^(dist\/|runner\/|profiles\/|templates\/|fixtures\/(behavior|product|runner|policy)\/|config\/|docs\/[^/]+[.]md$|README[.]md$|LICENSE$|CHANGELOG[.]md$|package[.]json$)/;
if(!pack.files.length||pack.files.some(file=>!allowed.test(file.path)||file.path.split('/').some(part=>part.startsWith('.')&&part!=='.skillsync'))) throw new Error('Unexpected public package file');
const sbom=JSON.parse(fs.readFileSync('release/sbom.cyclonedx.json','utf8'));
if(sbom.bomFormat!=='CycloneDX'||!Array.isArray(sbom.components)) throw new Error('Invalid SBOM');
const sha256=crypto.createHash('sha256').update(fs.readFileSync(`release/${pack.filename}`)).digest('hex');
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/skillsync-docker.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- run: npm run build
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/skillsync-runtime-canary.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- name: Run offline runtime contracts
Expand Down Expand Up @@ -65,7 +65,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- name: Reject live capability mode
Expand All @@ -91,7 +91,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- run: npm run build
Expand Down Expand Up @@ -119,7 +119,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- name: Verify the remote/microVM protocol contract only
Expand Down
16 changes: 13 additions & 3 deletions .github/workflows/skillsync.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ jobs:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: python3 desktop/tests/test_fixture_paths.py
- run: npm ci
Expand All @@ -58,20 +58,30 @@ jobs:
- run: npm run type-check
- run: npm run build:browser
- run: npm run lint
- run: npm pack --dry-run
- run: npm pack --dry-run --json --ignore-scripts > "$RUNNER_TEMP/package.json"
- run: node scripts/check-package.mjs "$RUNNER_TEMP/package.json"
- name: Generate SBOM preview (non-blocking)
run: |
npm sbom --sbom-format cyclonedx --sbom-type library > /tmp/sbom.cyclonedx.json 2>&1 || true
if [ -f /tmp/sbom.cyclonedx.json ]; then echo "SBOM preview OK ($(wc -c < /tmp/sbom.cyclonedx.json) bytes)"; fi
continue-on-error: true
- name: Select the supported CLI runtime floor
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020
with:
node-version: "20"
package-manager-cache: false
- name: Check runtime compatibility independently of the development runner
run: |
node dist/cli/index.js --version
node dist/cli/index.js verify --format json --path fixtures/behavior/review-basic --target codex > "$RUNNER_TEMP/node20-report.json"

verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
node-version: "24"
cache: npm
- run: npm ci
- run: npm run build
Expand Down
9 changes: 8 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
# Changelog

## 0.4.0 - 2026-11-16
## 0.4.1 - 2026-11-16

- Update the schema validator and build/test dependencies to patched releases. Keep the CLI Node20 floor while using Node24 for development and CI. Scope the temporary minimatch override to typescript-estree.

- Validate the actual npm file list in both source CI and publication. Include the two named READMEs while continuing to refuse private, hidden, ambiguous and duplicate files.
- The 0.4.0 tag remains an unpublished failed build; it is not overwritten.

## 0.4.0 source changes - 2026-11-16

- Check retained repair originals, create a new bounded recovery copy, reopen the same operation after interruption and verify/download the copy without changing the selected directory.
- Bind new backups to the local selected directory, preserve v1 legacy manifests with original-plan verification, and invalidate confirmation on content, permissions or identity changes.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Thanks for helping improve SkillSync. The project is an evidence and verificatio

## Local checks

Use Node.js 20 or newer and run:
Use Node.js 24 for development and tests. The installed CLI also supports Node.js 20. Run:

```bash
npm ci
Expand Down
12 changes: 6 additions & 6 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ Load the sample, check its frontmatter, and use the reported line and column to

Inspect local Skill folders and declared artifact deliveries. Review provenance, compatibility and changes without executing the Skill.

> **Alpha · GitHub release v0.4.0 · Node.js 20+**
> **Alpha · GitHub release v0.4.1 · Node.js 20+**
> SkillSync performs offline checks of local Skill content. It does not execute Skill scripts, does not read credentials, and does not enable live provider, remote-worker, or runtime capabilities.

GitHub v0.4.0 adds a declared cross-file checklist to HTML, text and JSON reports, including paths, field mappings and capacity limits. Declarations remain separate from actual results, and expected values are omitted. [Review the declaration list](docs/declared-checks.md). It also locates citation metadata failures by file, data record and compared columns. It checks exact digests and revisions without copying record values into reports. The offline review, correction workflow and bounded composite-key reconciliation remain available. The npm registry stays at 0.1.0; use the verified GitHub archive for current features.
GitHub v0.4.1 adds a declared cross-file checklist to HTML, text and JSON reports, including paths, field mappings and capacity limits. Declarations remain separate from actual results, and expected values are omitted. [Review the declaration list](docs/declared-checks.md). It also locates citation metadata failures by file, data record and compared columns. It checks exact digests and revisions without copying record values into reports. The offline review, correction workflow and bounded composite-key reconciliation remain available. The npm registry stays at 0.1.0; use the verified GitHub archive for current features.

[![Terminal demo](https://raw.githubusercontent.com/Chumaniac/skillsync/main/docs/assets/verify-demo.svg)](https://github.com/Chumaniac/skillsync/blob/main/docs/assets/verify-demo.svg)

Expand Down Expand Up @@ -49,7 +49,7 @@ Current source also supports [multi-delivery acceptance plans and portable revie

Tagged builds now publish a CLI tarball, checksums, a validated CycloneDX SBOM
and a source manifest on [GitHub Releases](https://github.com/Chumaniac/skillsync/releases).
[GitHub v0.4.0](https://github.com/Chumaniac/skillsync/releases/tag/v0.4.0)
[GitHub v0.4.1](https://github.com/Chumaniac/skillsync/releases/tag/v0.4.1)
is distributed as a versioned CLI tarball with checksums, SBOM, source manifest
and GitHub provenance. Its release workflow requires the exact immutable tag
and an already successful main check before packaging. Earlier v0.1.7 assets
Expand All @@ -58,12 +58,12 @@ Installation uses Node.js 20+ and fetches the package's public dependencies;
it needs no npm login.

```bash
release_base="https://github.com/Chumaniac/skillsync/releases/download/v0.4.0"
for asset in chumanic-skillsync-0.4.0.tgz checksums.txt sbom.cyclonedx.json release-manifest.json; do
release_base="https://github.com/Chumaniac/skillsync/releases/download/v0.4.1"
for asset in chumanic-skillsync-0.4.1.tgz checksums.txt sbom.cyclonedx.json release-manifest.json; do
curl --fail --location --output "$asset" "$release_base/$asset"
done
shasum -a 256 -c checksums.txt
npm install --prefix ./skillsync-tools ./chumanic-skillsync-0.4.0.tgz
npm install --prefix ./skillsync-tools ./chumanic-skillsync-0.4.1.tgz
./skillsync-tools/node_modules/.bin/skillsync --version
```

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

在运行 Skill 之前,检查它来自哪里、需要哪些权限,以及交付物是否满足声明的规则。

**[打开 SKILL.md 检查器 →](https://chumaniac.github.io/skillsync/)** · [English / CLI reference](README.en.md) · [桌面下载](https://github.com/Chumaniac/skillsync/releases/tag/v0.4.0)
**[打开 SKILL.md 检查器 →](https://chumaniac.github.io/skillsync/)** · [English / CLI reference](README.en.md) · [桌面下载](https://github.com/Chumaniac/skillsync/releases/tag/v0.4.1)

进入后,点击「载入示例」再检查文档;出现行列提示时,用「定位错误」回到原文。网页只解析粘贴的文档,本机目录、权限和交付物由 CLI 核验。

Expand Down Expand Up @@ -49,4 +49,4 @@ node dist/cli/index.js verify --path fixtures/product/trust-loop/review --target

修复前的持久备份、并发编辑保全和中断后的核对步骤见[修复与恢复](docs/repair-recovery.md)。工作台会区分完成历史和保留的未完成材料。

修复前文件可在本机核验台检查、恢复到独立副本并只读核验。原目录不被覆盖,旧版备份需关联原计划,结果待查时查询原恢复编号。详见[恢复说明](docs/repair-recovery.md)。GitHub 0.4.0 包与 npm 0.1.0 是不同发行渠道;npm 观察值保持实际记录,不冒充新版已发布。
修复前文件可在本机核验台检查、恢复到独立副本并只读核验。原目录不被覆盖,旧版备份需关联原计划,结果待查时查询原恢复编号。详见[恢复说明](docs/repair-recovery.md)。GitHub 0.4.1 包与 npm 0.1.0 是不同发行渠道;npm 观察值保持实际记录,不冒充新版已发布。
2 changes: 1 addition & 1 deletion desktop/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ Native smoke checks use port 19012, a dedicated canonical cache directory and no

完整可移动程序的构建步骤、运行时闭包和许可要求见[构建说明](../docs/build.md)。

The 0.4.0 workbench can check retained repair originals, restore to a new private copy and verify it without changing the selected directory. Source build identity must match the package version and exact Git tree before runtime assembly. The release pipeline includes the portable Apple Silicon app and reports ad-hoc signing explicitly.
The 0.4.1 workbench can check retained repair originals, restore to a new private copy and verify it without changing the selected directory. Source build identity must match the package version and exact Git tree before runtime assembly. The release pipeline includes the portable Apple Silicon app and reports ad-hoc signing explicitly.
6 changes: 3 additions & 3 deletions desktop/tests/test_application_manifest.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,16 @@ class ManifestTests(unittest.TestCase):
def fixture(self,root):
app=root/'SkillSync.app';resources=app/'Contents/Resources';runtime=resources/'runtime';dist=runtime/'app/dist';dist.mkdir(parents=True)
(resources/'app.json').write_text(json.dumps({'sourceCommit':'a'*40,'includesWorkingTreeChanges':False}))
(runtime/'app/package.json').write_text(json.dumps({'version':'0.4.0'}))
(dist/'build-info.json').write_text(json.dumps({'version':'0.4.0','sourceRevision':'a'*40,'dirty':False}))
(runtime/'app/package.json').write_text(json.dumps({'version':'0.4.1'}))
(dist/'build-info.json').write_text(json.dumps({'version':'0.4.1','sourceRevision':'a'*40,'dirty':False}))
files={str(p.relative_to(runtime)):hashlib.sha256(p.read_bytes()).hexdigest() for p in runtime.rglob('*') if p.is_file()}
(runtime/'runtime-manifest.json').write_text(json.dumps({'sourceCommit':'a'*40,'includesWorkingTreeChanges':False,'minimumSystemVersion':'13.5','architecture':'arm64','files':files}))
archive=root/'application.zip';archive.write_bytes(b'owned zip fixture');return app,archive,dist
def test_nonexecuting_same_source_inventory_and_changed_bytes(self):
with tempfile.TemporaryDirectory() as temporary,chdir(temporary):
app,archive,dist=self.fixture(Path(temporary))
with mock.patch('subprocess.Popen',side_effect=AssertionError('must not execute app code')):data=module.create(app,archive)
self.assertEqual(data['version'],'0.4.0');self.assertFalse(data['notarized'])
self.assertEqual(data['version'],'0.4.1');self.assertFalse(data['notarized'])
(dist/'changed.txt').write_text('unrecognized file')
with self.assertRaisesRegex(ValueError,'BYTES_CHANGED'):module.create(app,archive)
def test_outside_context_and_external_links_fail(self):
Expand Down
2 changes: 2 additions & 0 deletions docs/build.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,5 @@ npm test
运行包从实际 Mach-O 部署目标计算最低系统版本,当前 Apple Silicon 包最低 macOS 13.5。嵌入的 Node 运行时最低13.5;源码 package.json 的 >=20 是库兼容下限,此桌面构建固定使用 Node 24。具体下载以 source-manifest.json 与应用信息为准。本机验收不等于其他系统版本已实机验收。

正式GitHub发行从准确main成功检查和不可变版本标签构建CLI及Apple Silicon可移动程序。原生包用临时签名,不宣称Apple公证;实际最低系统版本以运行时Mach-O清单为准。检查程序清单只读文件哈希,不执行待检查App。

开发与CI使用Node24;安装后的CLI兼容下限仍为Node20。测试工具已更新到Vitest5。typescript-eslint尚未发布上游修复版本时,仅对其typescript-estree下的minimatch固定11.0.8,避免扩大覆盖范围;上游依赖升级后复查并移除这项临时覆盖。
2 changes: 1 addition & 1 deletion eslint.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import tseslint from "typescript-eslint";

export default [
{
ignores: ["dist/**", "browser-dist/**", "node_modules/**", "coverage/**", ".worktrees/**"],
ignores: ["dist/**", "browser-dist/**", "node_modules/**", "coverage/**", ".worktrees/**", ".release-workspace/**", "release/**"],
},
eslint.configs.recommended,
...tseslint.configs.recommended,
Expand Down
Loading
Loading