@fooksky/lodestar 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.
- package/README.md +13 -9
- package/package.json +3 -3
- package/tests/scenarios.md +1 -1
package/README.md
CHANGED
|
@@ -56,10 +56,10 @@ PR/MR 地址、源/目标分支、评审/合入结果和证据记录在既有 pl
|
|
|
56
56
|
|
|
57
57
|
## 开发与验证
|
|
58
58
|
|
|
59
|
-
需要 Node.js
|
|
59
|
+
需要 Node.js 24+、pnpm（不固定版本）、Git 及宿主 subprocess 服务，核对宿主版本为 DSH `0.2.2-rc.1`；Git 查询遵守调用会话的 sandbox policy，不使用裸 Node child_process 或 shell 绕过宿主。依赖无安装脚本：
|
|
60
60
|
|
|
61
61
|
```sh
|
|
62
|
-
|
|
62
|
+
pnpm install --frozen-lockfile --ignore-scripts
|
|
63
63
|
# prepack 自动执行语法检查和测试，并预览实际发布文件
|
|
64
64
|
npm pack --dry-run
|
|
65
65
|
```
|
|
@@ -67,7 +67,7 @@ npm pack --dry-run
|
|
|
67
67
|
真实宿主集成测试可使用现有 DSH 安装目录，无需 profile 安装：
|
|
68
68
|
|
|
69
69
|
```sh
|
|
70
|
-
DSH_HOST_ROOT=/absolute/path/to/node_modules/@deepseek-ai/dsh
|
|
70
|
+
DSH_HOST_ROOT=/absolute/path/to/node_modules/@deepseek-ai/dsh pnpm test
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
未提供该路径时宿主集成测试会显式跳过；其余单测独立运行。测试覆盖状态转换、版本关系、并发、损坏状态、目录边界、注册及资源。真实模型的授权理解、Team 协作和中断恢复等行为验收见 [场景清单](tests/scenarios.md)；程序测试不能代替这些观察。
|
|
@@ -82,9 +82,9 @@ DSH_HOST_ROOT=/absolute/path/to/node_modules/@deepseek-ai/dsh npm test
|
|
|
82
82
|
|
|
83
83
|
包名为 `@fooksky/lodestar`，采用 [MIT 许可证](LICENSE)，发布到公共 npm registry。[GitHub 源码仓库](https://github.com/urzz/lodestar) 保持私有，npm 包公开，安装公开包无需 GitHub 仓库权限或 npm 登录。直接分发 ESM 源码、bundle patch、Skill、图标和文档，这些发布文件可被公开下载；无需构建产物，`npm pack` 和 `npm publish` 的 `prepack` 钩子会先执行语法检查与测试。
|
|
84
84
|
|
|
85
|
-
[CI](.github/workflows/ci.yml) 在 `main` 分支推送、PR 和发布前运行，使用 Node.js
|
|
85
|
+
[CI](.github/workflows/ci.yml) 在 `main` 分支推送、PR 和发布前运行，使用 Node.js 24 和最新版 pnpm，并安装固定版本的 DSH `0.2.2-rc.1` 执行真实宿主集成测试及打包预览。临时宿主与项目依赖分开安装，不修改任何本机 profile。
|
|
86
86
|
|
|
87
|
-
[发布工作流](.github/workflows/publish.yml) 在推送 `v*` 标签时触发，等待完整 CI 通过，然后使用 Node.js 24、npm 11 和 GitHub OIDC Trusted Publishing 发布，无需长期 npm Token。私有源码仓库不支持 npm provenance，因此在 `publishConfig` 中显式关闭，适用于 Actions 和本地发布；仓库无需公开。稳定版本发布到 `latest`，含预发布后缀的版本发布到 `next`；标签必须严格等于包版本的 `v` 前缀形式。
|
|
87
|
+
[发布工作流](.github/workflows/publish.yml) 在推送 `v*` 标签时触发，等待完整 CI 通过，然后使用 Node.js 24、pnpm 冻结安装依赖，再通过 npm 11 和 GitHub OIDC Trusted Publishing 发布，无需长期 npm Token。私有源码仓库不支持 npm provenance，因此在 `publishConfig` 中显式关闭，适用于 Actions 和本地发布；仓库无需公开。稳定版本发布到 `latest`，含预发布后缀的版本发布到 `next`；标签必须严格等于包版本的 `v` 前缀形式。
|
|
88
88
|
|
|
89
89
|
首次发布前需要完成：
|
|
90
90
|
|
|
@@ -95,11 +95,15 @@ DSH_HOST_ROOT=/absolute/path/to/node_modules/@deepseek-ai/dsh npm test
|
|
|
95
95
|
后续发布流程：
|
|
96
96
|
|
|
97
97
|
```sh
|
|
98
|
-
#
|
|
99
|
-
npm version patch
|
|
100
|
-
|
|
98
|
+
# 更新版本，再同步 pnpm 锁文件；暂不自动创建提交和标签
|
|
99
|
+
npm version patch --no-git-tag-version
|
|
100
|
+
pnpm install --lockfile-only --ignore-scripts
|
|
101
|
+
# 审阅后提交版本文件，并创建匹配标签；示例版本需替换成实际版本
|
|
102
|
+
git add package.json pnpm-lock.yaml
|
|
103
|
+
git commit -m "chore: release v0.2.1"
|
|
104
|
+
git tag v0.2.1
|
|
101
105
|
git push origin main
|
|
102
106
|
git push origin v0.2.1
|
|
103
107
|
```
|
|
104
108
|
|
|
105
|
-
若用 `npm version prerelease --preid=beta
|
|
109
|
+
若用 `npm version prerelease --preid=beta --no-git-tag-version` 更新版本，再按上述步骤同步锁文件、提交和打标签，发布工作流会自动选择 `next`。origin 和 npm Trusted Publisher 配置完成前，本地仍可运行 `npm pack --dry-run` 验证分发内容。
|
package/package.json
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fooksky/lodestar",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": { "type": "git", "url": "git+https://github.com/urzz/lodestar.git" },
|
|
6
6
|
"publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/", "provenance": false },
|
|
7
7
|
"keywords": ["dsh", "cordis", "agent", "development", "workflow", "worktree"],
|
|
8
8
|
"type": "module",
|
|
9
9
|
"description": "Native DSH development workflow skill and structured change state",
|
|
10
|
-
"engines": { "node": ">=
|
|
10
|
+
"engines": { "node": ">=24", "dsh": ">=0.2.2-rc.1 <0.3.0" },
|
|
11
11
|
"exports": {
|
|
12
12
|
".": "./index.js",
|
|
13
13
|
"./preset": "./src/preset.js",
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"./locale/*.json": "./locale/*.json"
|
|
17
17
|
},
|
|
18
18
|
"files": ["index.js", "src", "cordis.patch.yml", "skills", "locale", "icon.svg", "README.md", "docs/design.md", "docs/branch-management.md", "docs/proposal.md", "docs/research", "tests/scenarios.md", "LICENSE"],
|
|
19
|
-
"scripts": { "test": "node --test tests/*.test.js", "check": "node --check index.js && node --check src/state.js && node --check src/store.js && node --check src/tool.js && node --check src/schema.js && node --check src/workspace.js && node --check src/preset.js", "prepack": "
|
|
19
|
+
"scripts": { "test": "node --test tests/*.test.js", "check": "node --check index.js && node --check src/state.js && node --check src/store.js && node --check src/tool.js && node --check src/schema.js && node --check src/workspace.js && node --check src/preset.js", "prepack": "pnpm check && pnpm test" },
|
|
20
20
|
"icon": "./icon.svg",
|
|
21
21
|
"dsh": { "bundle": { "patch": "./cordis.patch.yml" } },
|
|
22
22
|
"peerDependencies": {
|