@gencode/cli 0.0.52 → 0.0.54
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/CHANGELOG.md +28 -0
- package/README.md +78 -0
- package/package.json +5 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# @gencode/cli
|
|
2
|
+
|
|
3
|
+
## 0.0.54
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 350b9d1: Add a publish-time changelog guard and include package changelogs in npm artifacts.
|
|
8
|
+
- 71b3e30: Add stable session metadata types to @gencode/shared, expand memory tool suite, and switch subagent spawn to synchronous result delivery.
|
|
9
|
+
|
|
10
|
+
- @gencode/shared: export `SessionSummary` and `SessionMetadata` types for cross-package use
|
|
11
|
+
- @gencode/agents: add memory_write, memory_log, memory_list, memory_forget, memory_update tools; improve memory tool descriptions and system prompt guidance; change subagent spawn from async acceptance to synchronous result return; suppress redundant assistant text after subagent completion
|
|
12
|
+
- @gencode/cli: update memory tool test coverage to match new tools
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [8ef3f8f]
|
|
15
|
+
- Updated dependencies [839f628]
|
|
16
|
+
- Updated dependencies [350b9d1]
|
|
17
|
+
- Updated dependencies [a2149e3]
|
|
18
|
+
- Updated dependencies [6a154b5]
|
|
19
|
+
- Updated dependencies [5f15359]
|
|
20
|
+
- Updated dependencies [71b3e30]
|
|
21
|
+
- @gencode/agents@0.1.0
|
|
22
|
+
- @gencode/shared@0.1.0
|
|
23
|
+
|
|
24
|
+
## 0.0.53
|
|
25
|
+
|
|
26
|
+
### Patch Changes
|
|
27
|
+
|
|
28
|
+
- Establish the initial changelog baseline for the current published package version.
|
package/README.md
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# @gencode/cli
|
|
2
|
+
|
|
3
|
+
## 包定位
|
|
4
|
+
|
|
5
|
+
`@gencode/cli` 负责 AIMax 的 CLI 入口与进程级执行编排。
|
|
6
|
+
它的作用是把 agent 执行能力包装成可以被外部系统消费的命令行为。
|
|
7
|
+
|
|
8
|
+
## 负责内容
|
|
9
|
+
|
|
10
|
+
这个包适合承载：
|
|
11
|
+
- CLI 入口
|
|
12
|
+
- 命令解析与分发
|
|
13
|
+
- 单次任务执行编排
|
|
14
|
+
- stdout 输出处理
|
|
15
|
+
- HTTP callback 适配
|
|
16
|
+
- websocket stream 适配
|
|
17
|
+
- 命令配置与运行时装配
|
|
18
|
+
|
|
19
|
+
## 不负责内容
|
|
20
|
+
|
|
21
|
+
这个包不应成为以下能力的主要归属位置：
|
|
22
|
+
- agent 领域逻辑
|
|
23
|
+
- 本该属于 `@gencode/agents` 的 session 核心行为
|
|
24
|
+
- 本该属于 `@gencode/agents` 的 memory 领域内部逻辑
|
|
25
|
+
- 应沉淀到 `@gencode/shared` 的共享协议定义
|
|
26
|
+
|
|
27
|
+
## 当前源码入口
|
|
28
|
+
|
|
29
|
+
阅读本包时，建议先看：
|
|
30
|
+
- `src/bin.ts` —— CLI 可执行入口
|
|
31
|
+
- `src/program.ts` —— 命令编排
|
|
32
|
+
- `src/output.ts` —— 输出处理
|
|
33
|
+
- `src/config.ts` —— 运行配置
|
|
34
|
+
- `src/auth.ts` —— 认证相关配置
|
|
35
|
+
- `src/plugins-config.ts` —— 插件配置装配
|
|
36
|
+
- `src/logger.ts` —— 日志工具
|
|
37
|
+
|
|
38
|
+
当前较有代表性的测试：
|
|
39
|
+
- `src/build-config.test.ts`
|
|
40
|
+
- `src/logger.test.ts`
|
|
41
|
+
|
|
42
|
+
当 `dist/` 存在时，应将其视为生成产物，而不是主要编辑目标。
|
|
43
|
+
|
|
44
|
+
## 与其他包的关系
|
|
45
|
+
|
|
46
|
+
- `@gencode/cli` 依赖 `@gencode/agents` 提供真实的 agent 执行与领域能力
|
|
47
|
+
- `@gencode/shared` 应提供本包消费的稳定共享协议类型
|
|
48
|
+
- `@gencode/web` 应通过 CLI 使用能力，而不是绕过它直接调用 `@gencode/agents`
|
|
49
|
+
|
|
50
|
+
## 开发说明
|
|
51
|
+
|
|
52
|
+
当你在这里增加新 CLI 能力时：
|
|
53
|
+
- 保持所有进程外通信统一收口在这里
|
|
54
|
+
- 不要把领域所有权从 `@gencode/agents` 拉到 CLI 层
|
|
55
|
+
- 优先复用 `@gencode/shared` 中的共享协议结构
|
|
56
|
+
- 保持命令行为小、显式、可测试
|
|
57
|
+
|
|
58
|
+
## 验证
|
|
59
|
+
|
|
60
|
+
在工作区根目录可运行：
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
pnpm -C source/packages/cli test
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
工作区级验证：
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
pnpm -C source typecheck
|
|
70
|
+
pnpm -C source test
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## 相关规格文档
|
|
74
|
+
|
|
75
|
+
- `../../../specs/system-overview.md`
|
|
76
|
+
- `../../../specs/architecture-boundaries.md`
|
|
77
|
+
- `../../../specs/development-workflow.md`
|
|
78
|
+
- `../../../specs/repo-map.md`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gencode/cli",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.54",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
6
|
"aimax": "./dist/bin.js"
|
|
@@ -12,7 +12,8 @@
|
|
|
12
12
|
}
|
|
13
13
|
},
|
|
14
14
|
"files": [
|
|
15
|
-
"dist"
|
|
15
|
+
"dist",
|
|
16
|
+
"CHANGELOG.md"
|
|
16
17
|
],
|
|
17
18
|
"publishConfig": {
|
|
18
19
|
"access": "public"
|
|
@@ -21,8 +22,8 @@
|
|
|
21
22
|
"commander": "^14.0.3",
|
|
22
23
|
"gensign-node": "latest",
|
|
23
24
|
"log4js": "^6.9.1",
|
|
24
|
-
"@gencode/
|
|
25
|
-
"@gencode/
|
|
25
|
+
"@gencode/shared": "0.1.0",
|
|
26
|
+
"@gencode/agents": "0.1.0"
|
|
26
27
|
},
|
|
27
28
|
"devDependencies": {
|
|
28
29
|
"@types/node": "^22.0.0",
|