@pennixrv/trellis 0.7.0-beta.46 → 0.7.0-beta.47

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 (31) hide show
  1. package/dist/commands/workflow.js +1 -1
  2. package/dist/commands/workflow.js.map +1 -1
  3. package/dist/migrations/manifests/0.7.0-beta.47.json +9 -0
  4. package/dist/templates/codex/hooks/session-start.py +6 -6
  5. package/dist/templates/copilot/hooks/session-start.py +6 -6
  6. package/dist/templates/markdown/spec/backend/database-guidelines.md.txt +22 -22
  7. package/dist/templates/markdown/spec/backend/directory-structure.md.txt +20 -20
  8. package/dist/templates/markdown/spec/backend/error-handling.md.txt +22 -22
  9. package/dist/templates/markdown/spec/backend/index.md.txt +19 -19
  10. package/dist/templates/markdown/spec/backend/logging-guidelines.md.txt +22 -22
  11. package/dist/templates/markdown/spec/backend/quality-guidelines.md.txt +22 -22
  12. package/dist/templates/markdown/spec/frontend/component-guidelines.md.txt +25 -25
  13. package/dist/templates/markdown/spec/frontend/directory-structure.md.txt +20 -20
  14. package/dist/templates/markdown/spec/frontend/hook-guidelines.md.txt +22 -22
  15. package/dist/templates/markdown/spec/frontend/index.md.txt +20 -20
  16. package/dist/templates/markdown/spec/frontend/quality-guidelines.md.txt +22 -22
  17. package/dist/templates/markdown/spec/frontend/state-management.md.txt +22 -22
  18. package/dist/templates/markdown/spec/frontend/type-safety.md.txt +22 -22
  19. package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +80 -85
  20. package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +164 -209
  21. package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +161 -185
  22. package/dist/templates/markdown/spec/guides/index.md.txt +51 -51
  23. package/dist/templates/markdown/workspace-index.md +44 -44
  24. package/dist/templates/opencode/lib/session-utils.js +2 -2
  25. package/dist/templates/shared-hooks/session-start.py +7 -7
  26. package/dist/templates/trellis/scripts/add_session.py +35 -32
  27. package/dist/templates/trellis/scripts/common/developer.py +18 -18
  28. package/dist/templates/trellis/scripts/common/task_store.py +11 -11
  29. package/dist/templates/trellis/scripts/common/workflow_phase.py +4 -3
  30. package/dist/templates/trellis/workflow.md +403 -458
  31. package/package.json +2 -2
@@ -1,59 +1,59 @@
1
- # Component Guidelines
1
+ # 组件指南(Component Guidelines)
2
2
 
3
- > How components are built in this project.
3
+ > 本项目如何构建组件。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's component conventions here.
10
+ 在此记录项目的组件约定。
11
11
 
12
- Questions to answer:
13
- - What component patterns do you use?
14
- - How are props defined?
15
- - How do you handle composition?
16
- - What accessibility standards apply?
12
+ 需要回答的问题:
13
+ - 使用哪些组件模式?
14
+ - 如何定义 props?
15
+ - 如何处理组合?
16
+ - 适用哪些无障碍标准?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## Component Structure
23
+ ## 组件结构(Component Structure)
24
24
 
25
- <!-- Standard structure of a component file -->
25
+ <!-- 组件文件的标准结构 -->
26
26
 
27
- (To be filled by the team)
27
+ (待团队填写)
28
28
 
29
29
  ---
30
30
 
31
- ## Props Conventions
31
+ ## Props 约定(Props Conventions)
32
32
 
33
- <!-- How props should be defined and typed -->
33
+ <!-- props 应如何定义和声明类型 -->
34
34
 
35
- (To be filled by the team)
35
+ (待团队填写)
36
36
 
37
37
  ---
38
38
 
39
- ## Styling Patterns
39
+ ## 样式模式(Styling Patterns)
40
40
 
41
- <!-- How styles are applied (CSS modules, styled-components, Tailwind, etc.) -->
41
+ <!-- 如何应用样式(CSS modules、styled-components、Tailwind 等) -->
42
42
 
43
- (To be filled by the team)
43
+ (待团队填写)
44
44
 
45
45
  ---
46
46
 
47
- ## Accessibility
47
+ ## 无障碍(Accessibility)
48
48
 
49
- <!-- A11y requirements and patterns -->
49
+ <!-- A11y 要求和模式 -->
50
50
 
51
- (To be filled by the team)
51
+ (待团队填写)
52
52
 
53
53
  ---
54
54
 
55
- ## Common Mistakes
55
+ ## 常见错误(Common Mistakes)
56
56
 
57
- <!-- Component-related mistakes your team has made -->
57
+ <!-- 团队曾经出现过的组件相关错误 -->
58
58
 
59
- (To be filled by the team)
59
+ (待团队填写)
@@ -1,26 +1,26 @@
1
- # Directory Structure
1
+ # 目录结构(Directory Structure)
2
2
 
3
- > How frontend code is organized in this project.
3
+ > 本项目如何组织前端代码。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's frontend directory structure here.
10
+ 在此记录项目的前端目录结构。
11
11
 
12
- Questions to answer:
13
- - Where do components live?
14
- - How are features/modules organized?
15
- - Where are shared utilities?
16
- - How are assets organized?
12
+ 需要回答的问题:
13
+ - 组件位于何处?
14
+ - 功能/模块如何组织?
15
+ - 共享工具位于何处?
16
+ - 资源如何组织?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## Directory Layout
23
+ ## 目录布局(Directory Layout)
24
24
 
25
25
  ```
26
26
  <!-- Replace with your actual structure -->
@@ -31,24 +31,24 @@ src/
31
31
 
32
32
  ---
33
33
 
34
- ## Module Organization
34
+ ## 模块组织(Module Organization)
35
35
 
36
- <!-- How should new features be organized? -->
36
+ <!-- 新功能应如何组织? -->
37
37
 
38
- (To be filled by the team)
38
+ (待团队填写)
39
39
 
40
40
  ---
41
41
 
42
- ## Naming Conventions
42
+ ## 命名约定(Naming Conventions)
43
43
 
44
- <!-- File and folder naming rules -->
44
+ <!-- 文件和目录的命名规则 -->
45
45
 
46
- (To be filled by the team)
46
+ (待团队填写)
47
47
 
48
48
  ---
49
49
 
50
- ## Examples
50
+ ## 示例(Examples)
51
51
 
52
- <!-- Link to well-organized modules as examples -->
52
+ <!-- 链接到组织良好的模块作为示例 -->
53
53
 
54
- (To be filled by the team)
54
+ (待团队填写)
@@ -1,51 +1,51 @@
1
- # Hook Guidelines
1
+ # Hook 指南(Hook Guidelines)
2
2
 
3
- > How hooks are used in this project.
3
+ > 本项目如何使用 Hook。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's hook conventions here.
10
+ 在此记录项目的 Hook 约定。
11
11
 
12
- Questions to answer:
13
- - What custom hooks do you have?
14
- - How do you handle data fetching?
15
- - What are the naming conventions?
16
- - How do you share stateful logic?
12
+ 需要回答的问题:
13
+ - 有哪些自定义 Hook?
14
+ - 如何处理数据获取?
15
+ - 遵循哪些命名约定?
16
+ - 如何共享有状态逻辑?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## Custom Hook Patterns
23
+ ## 自定义 Hook 模式(Custom Hook Patterns)
24
24
 
25
- <!-- How to create and structure custom hooks -->
25
+ <!-- 如何创建和组织自定义 Hook -->
26
26
 
27
- (To be filled by the team)
27
+ (待团队填写)
28
28
 
29
29
  ---
30
30
 
31
- ## Data Fetching
31
+ ## 数据获取(Data Fetching)
32
32
 
33
- <!-- How data fetching is handled (React Query, SWR, etc.) -->
33
+ <!-- 如何处理数据获取(React Query、SWR 等) -->
34
34
 
35
- (To be filled by the team)
35
+ (待团队填写)
36
36
 
37
37
  ---
38
38
 
39
- ## Naming Conventions
39
+ ## 命名约定(Naming Conventions)
40
40
 
41
- <!-- Hook naming rules (use*, etc.) -->
41
+ <!-- Hook 命名规则(use* 等) -->
42
42
 
43
- (To be filled by the team)
43
+ (待团队填写)
44
44
 
45
45
  ---
46
46
 
47
- ## Common Mistakes
47
+ ## 常见错误(Common Mistakes)
48
48
 
49
- <!-- Hook-related mistakes your team has made -->
49
+ <!-- 团队曾经出现过的 Hook 相关错误 -->
50
50
 
51
- (To be filled by the team)
51
+ (待团队填写)
@@ -1,39 +1,39 @@
1
- # Frontend Development Guidelines
1
+ # 前端开发指南(Frontend Development Guidelines)
2
2
 
3
- > Best practices for frontend development in this project.
3
+ > 本项目的前端开发最佳实践。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
- This directory contains guidelines for frontend development. Fill in each file with your project's specific conventions.
9
+ 本目录包含前端开发指南。请在各文件中填写项目的具体约定。
10
10
 
11
11
  ---
12
12
 
13
- ## Guidelines Index
13
+ ## 指南索引(Guidelines Index)
14
14
 
15
- | Guide | Description | Status |
15
+ | 指南(Guide) | 说明(Description) | 状态(Status) |
16
16
  |-------|-------------|--------|
17
- | [Directory Structure](./directory-structure.md) | Module organization and file layout | To fill |
18
- | [Component Guidelines](./component-guidelines.md) | Component patterns, props, composition | To fill |
19
- | [Hook Guidelines](./hook-guidelines.md) | Custom hooks, data fetching patterns | To fill |
20
- | [State Management](./state-management.md) | Local state, global state, server state | To fill |
21
- | [Quality Guidelines](./quality-guidelines.md) | Code standards, forbidden patterns | To fill |
22
- | [Type Safety](./type-safety.md) | Type patterns, validation | To fill |
17
+ | [目录结构(Directory Structure)](./directory-structure.md) | 模块组织和文件布局 | 待填写 |
18
+ | [组件指南(Component Guidelines)](./component-guidelines.md) | 组件模式、props 和组合 | 待填写 |
19
+ | [Hook 指南(Hook Guidelines)](./hook-guidelines.md) | 自定义 Hook 和数据获取模式 | 待填写 |
20
+ | [状态管理(State Management)](./state-management.md) | 本地状态、全局状态和服务端状态 | 待填写 |
21
+ | [质量指南(Quality Guidelines)](./quality-guidelines.md) | 代码标准和禁止模式 | 待填写 |
22
+ | [类型安全(Type Safety)](./type-safety.md) | 类型模式和校验 | 待填写 |
23
23
 
24
24
  ---
25
25
 
26
- ## How to Fill These Guidelines
26
+ ## 如何填写这些指南(How to Fill These Guidelines)
27
27
 
28
- For each guideline file:
28
+ 对于每个指南文件:
29
29
 
30
- 1. Document your project's **actual conventions** (not ideals)
31
- 2. Include **code examples** from your codebase
32
- 3. List **forbidden patterns** and why
33
- 4. Add **common mistakes** your team has made
30
+ 1. 记录项目的**实际约定**,而不是理想状态
31
+ 2. 包含代码库中的**代码示例**
32
+ 3. 列出**禁止模式**及其原因
33
+ 4. 补充团队曾经出现过的**常见错误**
34
34
 
35
- The goal is to help AI assistants and new team members understand how YOUR project works.
35
+ 目标是帮助 AI 助手和新团队成员理解项目的实际工作方式。
36
36
 
37
37
  ---
38
38
 
39
- **Language**: All documentation should be written in **English**.
39
+ **语言(Language)**:所有文档默认使用**简体中文**。
@@ -1,51 +1,51 @@
1
- # Quality Guidelines
1
+ # 质量指南(Quality Guidelines)
2
2
 
3
- > Code quality standards for frontend development.
3
+ > 前端开发的代码质量标准。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's quality standards here.
10
+ 在此记录项目的质量标准。
11
11
 
12
- Questions to answer:
13
- - What patterns are forbidden?
14
- - What linting rules do you enforce?
15
- - What are your testing requirements?
16
- - What code review standards apply?
12
+ 需要回答的问题:
13
+ - 禁止哪些模式?
14
+ - 执行哪些 lint 规则?
15
+ - 有哪些测试要求?
16
+ - 适用哪些代码审查标准?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## Forbidden Patterns
23
+ ## 禁止模式(Forbidden Patterns)
24
24
 
25
- <!-- Patterns that should never be used and why -->
25
+ <!-- 永远不应使用的模式及其原因 -->
26
26
 
27
- (To be filled by the team)
27
+ (待团队填写)
28
28
 
29
29
  ---
30
30
 
31
- ## Required Patterns
31
+ ## 必须遵守的模式(Required Patterns)
32
32
 
33
- <!-- Patterns that must always be used -->
33
+ <!-- 必须始终使用的模式 -->
34
34
 
35
- (To be filled by the team)
35
+ (待团队填写)
36
36
 
37
37
  ---
38
38
 
39
- ## Testing Requirements
39
+ ## 测试要求(Testing Requirements)
40
40
 
41
- <!-- What level of testing is expected -->
41
+ <!-- 期望达到的测试层级 -->
42
42
 
43
- (To be filled by the team)
43
+ (待团队填写)
44
44
 
45
45
  ---
46
46
 
47
- ## Code Review Checklist
47
+ ## 代码审查清单(Code Review Checklist)
48
48
 
49
- <!-- What reviewers should check -->
49
+ <!-- 审查者应检查的内容 -->
50
50
 
51
- (To be filled by the team)
51
+ (待团队填写)
@@ -1,51 +1,51 @@
1
- # State Management
1
+ # 状态管理(State Management)
2
2
 
3
- > How state is managed in this project.
3
+ > 本项目如何管理状态。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's state management conventions here.
10
+ 在此记录项目的状态管理约定。
11
11
 
12
- Questions to answer:
13
- - What state management solution do you use?
14
- - How is local vs global state decided?
15
- - How do you handle server state?
16
- - What are the patterns for derived state?
12
+ 需要回答的问题:
13
+ - 使用什么状态管理方案?
14
+ - 如何决定使用本地状态还是全局状态?
15
+ - 如何处理服务端状态?
16
+ - 派生状态遵循哪些模式?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## State Categories
23
+ ## 状态分类(State Categories)
24
24
 
25
- <!-- Local state, global state, server state, URL state -->
25
+ <!-- 本地状态、全局状态、服务端状态、URL 状态 -->
26
26
 
27
- (To be filled by the team)
27
+ (待团队填写)
28
28
 
29
29
  ---
30
30
 
31
- ## When to Use Global State
31
+ ## 何时使用全局状态(When to Use Global State)
32
32
 
33
- <!-- Criteria for promoting state to global -->
33
+ <!-- 将状态提升为全局状态的条件 -->
34
34
 
35
- (To be filled by the team)
35
+ (待团队填写)
36
36
 
37
37
  ---
38
38
 
39
- ## Server State
39
+ ## 服务端状态(Server State)
40
40
 
41
- <!-- How server data is cached and synchronized -->
41
+ <!-- 如何缓存和同步服务端数据 -->
42
42
 
43
- (To be filled by the team)
43
+ (待团队填写)
44
44
 
45
45
  ---
46
46
 
47
- ## Common Mistakes
47
+ ## 常见错误(Common Mistakes)
48
48
 
49
- <!-- State management mistakes your team has made -->
49
+ <!-- 团队曾经出现过的状态管理错误 -->
50
50
 
51
- (To be filled by the team)
51
+ (待团队填写)
@@ -1,51 +1,51 @@
1
- # Type Safety
1
+ # 类型安全(Type Safety)
2
2
 
3
- > Type safety patterns in this project.
3
+ > 本项目的类型安全模式。
4
4
 
5
5
  ---
6
6
 
7
- ## Overview
7
+ ## 概览(Overview)
8
8
 
9
9
  <!--
10
- Document your project's type safety conventions here.
10
+ 在此记录项目的类型安全约定。
11
11
 
12
- Questions to answer:
13
- - What type system do you use?
14
- - How are types organized?
15
- - What validation library do you use?
16
- - How do you handle type inference?
12
+ 需要回答的问题:
13
+ - 使用什么类型系统?
14
+ - 如何组织类型?
15
+ - 使用什么校验库?
16
+ - 如何处理类型推断?
17
17
  -->
18
18
 
19
- (To be filled by the team)
19
+ (待团队填写)
20
20
 
21
21
  ---
22
22
 
23
- ## Type Organization
23
+ ## 类型组织(Type Organization)
24
24
 
25
- <!-- Where types are defined, shared types vs local types -->
25
+ <!-- 类型定义位置,共享类型与局部类型的区别 -->
26
26
 
27
- (To be filled by the team)
27
+ (待团队填写)
28
28
 
29
29
  ---
30
30
 
31
- ## Validation
31
+ ## 校验(Validation)
32
32
 
33
- <!-- Runtime validation patterns (Zod, Yup, io-ts, etc.) -->
33
+ <!-- 运行时校验模式(Zod、Yup、io-ts 等) -->
34
34
 
35
- (To be filled by the team)
35
+ (待团队填写)
36
36
 
37
37
  ---
38
38
 
39
- ## Common Patterns
39
+ ## 常见模式(Common Patterns)
40
40
 
41
- <!-- Type utilities, generics, type guards -->
41
+ <!-- 类型工具、泛型和类型守卫 -->
42
42
 
43
- (To be filled by the team)
43
+ (待团队填写)
44
44
 
45
45
  ---
46
46
 
47
- ## Forbidden Patterns
47
+ ## 禁止模式(Forbidden Patterns)
48
48
 
49
- <!-- any, type assertions, etc. -->
49
+ <!-- any、类型断言等 -->
50
50
 
51
- (To be filled by the team)
51
+ (待团队填写)