@succsoft/succapp 5.0.3 → 5.0.6

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.
Files changed (12) hide show
  1. package/CHANGELOG.md +62 -193
  2. package/README.md +13 -1
  3. package/dist/cli/l10n/bundle.l10n.json +268 -39
  4. package/dist/cli/l10n/bundle.l10n.zh-cn.json +266 -37
  5. package/dist/cli/succapp.js +100 -82
  6. package/package.json +1 -1
  7. package/resources/workspace-templates/succapp-workspace/.agents/README.md +1 -1
  8. package/resources/workspace-templates/succapp-workspace/.agents/rules/workspace-rules.md +13 -1
  9. package/resources/workspace-templates/succapp-workspace/.succapp/tsconfig.action.json +12 -12
  10. package/resources/workspace-templates/succapp-workspace/.succapp/tsconfig.browser.json +13 -13
  11. package/resources/workspace-templates/succapp-workspace/.vscode/settings.typescript-support.jsonc +4 -1
  12. package/resources/workspace-templates/succapp-workspace/AGENTS.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@succsoft/succapp",
3
- "version": "5.0.3",
3
+ "version": "5.0.6",
4
4
  "description": "SuccApp CLI for AI-assisted low-code development, metadata workspace sync, and server automation.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "bin": {
package/resources/workspace-templates/succapp-workspace/.agents/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
  - `reviews/`：Code Review、设计评审和变更评审结果。
9
9
  - `reports/`：调查、分析、验证和排查报告。
10
10
  - `rules/`：团队长期维护的 AI 协作规则。
11
- - `skills/`：面向特定开发场景的 AI skill。`skills/succapp-docs/` 是 SuccApp CLI 同步的官方离线文档 skill。
11
+ - `skills/`：面向特定开发场景的 AI skill。`skills/succapp-docs/` 是 SuccApp CLI 同步的官方离线文档 skill，并包含服务器下载的 `dev-types/`、`json-schemas/` 开发支持资产。
12
12
  - `tmp/`：临时脚本、草稿和一次性排查文件。
13
13
 
14
14
  ## 规则
package/resources/workspace-templates/succapp-workspace/.agents/rules/workspace-rules.md CHANGED
@@ -10,6 +10,17 @@
10
10
  2. 再看目标文件父目录的 `.meta`。父目录 `.meta` 记录的子文件或子目录，才是该目录下的服务器元数据资源。
11
11
  3. 没有被对应 `.meta` 记录的内容，默认按本地辅助文件、临时文件或工具配置处理。
12
12
 
13
+ ## 定位元数据
14
+
15
+ - 用户提到 `/项目名/...` 形式的路径时，默认表示 SuccApp 服务器上的元数据路径，不是本地绝对文件路径。
16
+ - 用户给出 SuccApp 页面 URL 时，可以从 URL 路径识别 `/项目名/...`；如果 URL 带 `:open` 等资源 ID 参数，可以用 `succapp server file locate` 反查服务器路径。
17
+ - 回答业务问题、排查模型、查字段、查依赖、判断当前项目内容时，优先查当前工作区中已克隆的项目，其次查当前活跃服务器。
18
+ - 用户要求修改页面、模型等元数据资源时，如果当前已经在 SuccApp 工作区，但目标项目尚未克隆，应询问用户是否先把项目克隆到当前工作区，再继续修改。
19
+ - 查询服务器前，先执行 `succapp workspace status --json` 确认工作区和服务器，再使用 `succapp server file` 或 `succapp model` 的只读命令查询。
20
+ - 示例只用于参考和学习。除非用户明确要求查询示例、DEMO 示例或参考写法，`.agents/skills/succapp-docs/metadata-examples/` 一般不是用户想找的目标。
21
+ - 除非用户明确要求，不要向上级目录、相邻目录或其它 SuccApp 工作区搜索同名项目来回答当前项目问题。
22
+ - 如果当前工作区和当前活跃服务器都找不到，或 CLI 不可用、未登录、无权限、服务器不可达，应明确说明无法确认真实元数据，并询问用户补充目标服务器、工作区、项目或更详细路径。
23
+
13
24
  ## `.meta` 边界
14
25
 
15
26
  - `.meta` 是目录级资源索引，描述同目录下的直接子资源。
@@ -28,7 +39,8 @@
28
39
  ## AI 协作目录
29
40
 
30
41
  - `.agents/` 用来放 AI 协作规则和产物，不属于业务元数据。
31
- - `.agents/skills/succapp-docs/` 是 SuccApp CLI 同步的官方离线文档缓存，不直接手改。
42
+ - `.agents/skills/succapp-docs/` 是 SuccApp CLI 同步的官方离线文档缓存，并包含服务器下载的 `dev-types/`、`json-schemas/` 开发支持资产，不直接手改。
43
+ - `.agents/skills/succapp-docs/metadata-examples/` 是官方示例资料，不是真实业务项目。除非用户明确要求查询示例、DEMO 示例或参考写法，不得把它作为当前项目事实依据。
32
44
  - 团队长期规则放 `.agents/rules/`；计划、报告、评审和临时文件分别放 `.agents/plans/`、`.agents/reports/`、`.agents/reviews/` 和 `.agents/tmp/`。
33
45
 
34
46
  ## 修改规范
package/resources/workspace-templates/succapp-workspace/.succapp/tsconfig.action.json CHANGED
@@ -13,30 +13,30 @@
13
13
  "es2020",
14
14
  "ES2021.String"
15
15
  ],
16
- "baseUrl": ".",
16
+ "baseUrl": "..",
17
17
  "paths": {
18
18
  "svr-api/*": [
19
- "succ-types/svr-api/*"
19
+ ".agents/skills/succapp-docs/dev-types/svr-api/*"
20
20
  ],
21
21
  "*": [
22
- "succ-types/*",
23
- "succ-types/node_modules/*"
22
+ ".agents/skills/succapp-docs/dev-types/*",
23
+ ".agents/skills/succapp-docs/dev-types/node_modules/*"
24
24
  ]
25
25
  }
26
26
  },
27
27
  "include": [
28
28
  "../**/*.action.ts",
29
- "succ-types/svr-api/**/*.d.ts",
30
- "succ-types/commons/common-types.d.ts",
31
- "succ-types/qunit/**/*.d.ts",
32
- "succ-types/dw/dw-types.d.ts",
33
- "succ-types/sys/sys.types.d.ts",
34
- "succ-types/types*/**/*.d.ts"
29
+ "../.agents/skills/succapp-docs/dev-types/svr-api/**/*.d.ts",
30
+ "../.agents/skills/succapp-docs/dev-types/commons/common-types.d.ts",
31
+ "../.agents/skills/succapp-docs/dev-types/qunit/**/*.d.ts",
32
+ "../.agents/skills/succapp-docs/dev-types/dw/dw-types.d.ts",
33
+ "../.agents/skills/succapp-docs/dev-types/sys/sys.types.d.ts",
34
+ "../.agents/skills/succapp-docs/dev-types/types*/**/*.d.ts"
35
35
  ],
36
36
  "exclude": [
37
37
  "../node_modules",
38
38
  "../.git",
39
- "succ-types.tmp-*",
40
- "succ-types/types-dev/succ-prototype-ext-browser.d.ts"
39
+ "../.agents/skills/succapp-docs/dev-types.tmp-*",
40
+ "../.agents/skills/succapp-docs/dev-types/types-dev/succ-prototype-ext-browser.d.ts"
41
41
  ]
42
42
  }
package/resources/workspace-templates/succapp-workspace/.succapp/tsconfig.browser.json CHANGED
@@ -21,31 +21,31 @@
21
21
  "ES2018.AsyncGenerator",
22
22
  "ES2020.Promise"
23
23
  ],
24
- "baseUrl": ".",
24
+ "baseUrl": "..",
25
25
  "paths": {
26
26
  "*": [
27
- "succ-types/*",
28
- "succ-types/node_modules/*"
27
+ ".agents/skills/succapp-docs/dev-types/*",
28
+ ".agents/skills/succapp-docs/dev-types/node_modules/*"
29
29
  ]
30
30
  }
31
31
  },
32
32
  "include": [
33
33
  "../**/*.ts",
34
34
  "../**/*.tsx",
35
- "succ-types/types*/**/*.d.ts",
36
- "succ-types/fapp/**/*.d.ts",
37
- "succ-types/metadata/**/*.d.ts",
38
- "succ-types/sys/**/*.d.ts"
35
+ "../.agents/skills/succapp-docs/dev-types/types*/**/*.d.ts",
36
+ "../.agents/skills/succapp-docs/dev-types/fapp/**/*.d.ts",
37
+ "../.agents/skills/succapp-docs/dev-types/metadata/**/*.d.ts",
38
+ "../.agents/skills/succapp-docs/dev-types/sys/**/*.d.ts"
39
39
  ],
40
40
  "exclude": [
41
41
  "../**/*.action.ts",
42
42
  "../node_modules",
43
43
  "../.git",
44
- "succ-types.tmp-*",
45
- "succ-types/svr-api",
46
- "succ-types/commons",
47
- "succ-types/qunit",
48
- "succ-types/dw",
49
- "succ-types/node_modules"
44
+ "../.agents/skills/succapp-docs/dev-types.tmp-*",
45
+ "../.agents/skills/succapp-docs/dev-types/svr-api",
46
+ "../.agents/skills/succapp-docs/dev-types/commons",
47
+ "../.agents/skills/succapp-docs/dev-types/qunit",
48
+ "../.agents/skills/succapp-docs/dev-types/dw",
49
+ "../.agents/skills/succapp-docs/dev-types/node_modules"
50
50
  ]
51
51
  }
package/resources/workspace-templates/succapp-workspace/.vscode/settings.typescript-support.jsonc CHANGED
@@ -3,6 +3,9 @@
3
3
  "tsconfig.json",
4
4
  ".succapp/tsconfig.action.json",
5
5
  ".succapp/tsconfig.browser.json",
6
- ".succapp/succ-types/**"
6
+ ".succapp/succ-types/**",
7
+ ".succapp/json-schemas/**",
8
+ ".agents/skills/succapp-docs/dev-types/**",
9
+ ".agents/skills/succapp-docs/json-schemas/**"
7
10
  ]
8
11
  }
package/resources/workspace-templates/succapp-workspace/AGENTS.md CHANGED
@@ -22,7 +22,7 @@ succapp workspace init --scope agent-docs --force
22
22
  ## 本地边界
23
23
 
24
24
  - `.meta`、`.succapp/`、`.agents/` 和本地配置目录的具体边界见 `.agents/rules/workspace-rules.md`。
25
- - `.agents/skills/succapp-docs/` 由 SuccApp CLI 同步维护，默认作为官方文档缓存处理。团队规则、客户现场经验和项目约定写入 `.agents/rules/` 或其它自定义 skill，不直接修改官方文档缓存。
25
+ - `.agents/skills/succapp-docs/` 由 SuccApp CLI 同步维护，包含官方文档缓存以及服务器下载的 `dev-types/`、`json-schemas/` 开发支持资产。团队规则、客户现场经验和项目约定写入 `.agents/rules/` 或其它自定义 skill，不直接修改官方缓存。
26
26
 
27
27
  ## 工作规则
28
28