mini-trellis 0.1.0

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 (186) hide show
  1. package/COPYRIGHT +20 -0
  2. package/LICENSE +235 -0
  3. package/README.md +66 -0
  4. package/bin/mini-trellis.js +3 -0
  5. package/dist/cli/index.d.ts +3 -0
  6. package/dist/cli/index.d.ts.map +1 -0
  7. package/dist/cli/index.js +153 -0
  8. package/dist/cli/index.js.map +1 -0
  9. package/dist/commands/init.d.ts +19 -0
  10. package/dist/commands/init.d.ts.map +1 -0
  11. package/dist/commands/init.js +401 -0
  12. package/dist/commands/init.js.map +1 -0
  13. package/dist/commands/mem.d.ts +30 -0
  14. package/dist/commands/mem.d.ts.map +1 -0
  15. package/dist/commands/mem.js +412 -0
  16. package/dist/commands/mem.js.map +1 -0
  17. package/dist/commands/migrate.d.ts +40 -0
  18. package/dist/commands/migrate.d.ts.map +1 -0
  19. package/dist/commands/migrate.js +272 -0
  20. package/dist/commands/migrate.js.map +1 -0
  21. package/dist/commands/uninstall.d.ts +11 -0
  22. package/dist/commands/uninstall.d.ts.map +1 -0
  23. package/dist/commands/uninstall.js +135 -0
  24. package/dist/commands/uninstall.js.map +1 -0
  25. package/dist/commands/upgrade.d.ts +28 -0
  26. package/dist/commands/upgrade.d.ts.map +1 -0
  27. package/dist/commands/upgrade.js +84 -0
  28. package/dist/commands/upgrade.js.map +1 -0
  29. package/dist/configurators/claude.d.ts +3 -0
  30. package/dist/configurators/claude.d.ts.map +1 -0
  31. package/dist/configurators/claude.js +62 -0
  32. package/dist/configurators/claude.js.map +1 -0
  33. package/dist/configurators/codex.d.ts +3 -0
  34. package/dist/configurators/codex.d.ts.map +1 -0
  35. package/dist/configurators/codex.js +21 -0
  36. package/dist/configurators/codex.js.map +1 -0
  37. package/dist/configurators/index.d.ts +24 -0
  38. package/dist/configurators/index.d.ts.map +1 -0
  39. package/dist/configurators/index.js +80 -0
  40. package/dist/configurators/index.js.map +1 -0
  41. package/dist/configurators/opencode.d.ts +2 -0
  42. package/dist/configurators/opencode.d.ts.map +1 -0
  43. package/dist/configurators/opencode.js +62 -0
  44. package/dist/configurators/opencode.js.map +1 -0
  45. package/dist/configurators/pi.d.ts +2 -0
  46. package/dist/configurators/pi.d.ts.map +1 -0
  47. package/dist/configurators/pi.js +18 -0
  48. package/dist/configurators/pi.js.map +1 -0
  49. package/dist/configurators/shared.d.ts +147 -0
  50. package/dist/configurators/shared.d.ts.map +1 -0
  51. package/dist/configurators/shared.js +377 -0
  52. package/dist/configurators/shared.js.map +1 -0
  53. package/dist/configurators/workflow.d.ts +15 -0
  54. package/dist/configurators/workflow.d.ts.map +1 -0
  55. package/dist/configurators/workflow.js +46 -0
  56. package/dist/configurators/workflow.js.map +1 -0
  57. package/dist/constants/paths.d.ts +74 -0
  58. package/dist/constants/paths.d.ts.map +1 -0
  59. package/dist/constants/paths.js +83 -0
  60. package/dist/constants/paths.js.map +1 -0
  61. package/dist/constants/version.d.ts +9 -0
  62. package/dist/constants/version.d.ts.map +1 -0
  63. package/dist/constants/version.js +15 -0
  64. package/dist/constants/version.js.map +1 -0
  65. package/dist/index.d.ts +9 -0
  66. package/dist/index.d.ts.map +1 -0
  67. package/dist/index.js +9 -0
  68. package/dist/index.js.map +1 -0
  69. package/dist/templates/claude/index.d.ts +11 -0
  70. package/dist/templates/claude/index.d.ts.map +1 -0
  71. package/dist/templates/claude/index.js +17 -0
  72. package/dist/templates/claude/index.js.map +1 -0
  73. package/dist/templates/claude/settings.json +40 -0
  74. package/dist/templates/codex/config.toml +39 -0
  75. package/dist/templates/codex/hooks.json +15 -0
  76. package/dist/templates/codex/index.d.ts +11 -0
  77. package/dist/templates/codex/index.d.ts.map +1 -0
  78. package/dist/templates/codex/index.js +22 -0
  79. package/dist/templates/codex/index.js.map +1 -0
  80. package/dist/templates/common/bundled-skills/mini-trellis-session-insight/SKILL.md +37 -0
  81. package/dist/templates/common/bundled-skills/mini-trellis-session-insight/references/cli-quick-reference.md +36 -0
  82. package/dist/templates/common/bundled-skills/mini-trellis-session-insight/references/triggering-patterns.md +93 -0
  83. package/dist/templates/common/commands/remember.md +22 -0
  84. package/dist/templates/common/index.d.ts +48 -0
  85. package/dist/templates/common/index.d.ts.map +1 -0
  86. package/dist/templates/common/index.js +104 -0
  87. package/dist/templates/common/index.js.map +1 -0
  88. package/dist/templates/common/skills/update-spec.md +16 -0
  89. package/dist/templates/extract.d.ts +40 -0
  90. package/dist/templates/extract.d.ts.map +1 -0
  91. package/dist/templates/extract.js +106 -0
  92. package/dist/templates/extract.js.map +1 -0
  93. package/dist/templates/markdown/agents.md +15 -0
  94. package/dist/templates/markdown/index.d.ts +10 -0
  95. package/dist/templates/markdown/index.d.ts.map +1 -0
  96. package/dist/templates/markdown/index.js +18 -0
  97. package/dist/templates/markdown/index.js.map +1 -0
  98. package/dist/templates/markdown/research-readme.md +9 -0
  99. package/dist/templates/markdown/spec/guides/index.md.txt +5 -0
  100. package/dist/templates/markdown/spec/guides/mini-memory.md.txt +30 -0
  101. package/dist/templates/markdown/workspace-index.md +23 -0
  102. package/dist/templates/opencode/lib/context-visibility.js +148 -0
  103. package/dist/templates/opencode/lib/session-utils.js +394 -0
  104. package/dist/templates/opencode/lib/trellis-context.js +627 -0
  105. package/dist/templates/opencode/package.json +5 -0
  106. package/dist/templates/opencode/plugins/session-start.js +65 -0
  107. package/dist/templates/pi/extensions/mini-trellis/index.ts.txt +170 -0
  108. package/dist/templates/pi/index.d.ts +4 -0
  109. package/dist/templates/pi/index.d.ts.map +1 -0
  110. package/dist/templates/pi/index.js +9 -0
  111. package/dist/templates/pi/index.js.map +1 -0
  112. package/dist/templates/pi/settings.json +9 -0
  113. package/dist/templates/shared-hooks/index.d.ts +13 -0
  114. package/dist/templates/shared-hooks/index.d.ts.map +1 -0
  115. package/dist/templates/shared-hooks/index.js +26 -0
  116. package/dist/templates/shared-hooks/index.js.map +1 -0
  117. package/dist/templates/shared-hooks/session-start.py +676 -0
  118. package/dist/templates/template-utils.d.ts +26 -0
  119. package/dist/templates/template-utils.d.ts.map +1 -0
  120. package/dist/templates/template-utils.js +64 -0
  121. package/dist/templates/template-utils.js.map +1 -0
  122. package/dist/templates/trellis/config.yaml +34 -0
  123. package/dist/templates/trellis/gitattributes.txt +9 -0
  124. package/dist/templates/trellis/gitignore.txt +32 -0
  125. package/dist/templates/trellis/index.d.ts +8 -0
  126. package/dist/templates/trellis/index.d.ts.map +1 -0
  127. package/dist/templates/trellis/index.js +16 -0
  128. package/dist/templates/trellis/index.js.map +1 -0
  129. package/dist/templates/trellis/scripts/__init__.py +5 -0
  130. package/dist/templates/trellis/scripts/add_session.py +1545 -0
  131. package/dist/templates/trellis/scripts/common/__init__.py +94 -0
  132. package/dist/templates/trellis/scripts/common/active_task.py +855 -0
  133. package/dist/templates/trellis/scripts/common/cli_adapter.py +950 -0
  134. package/dist/templates/trellis/scripts/common/config.py +482 -0
  135. package/dist/templates/trellis/scripts/common/developer.py +192 -0
  136. package/dist/templates/trellis/scripts/common/git.py +203 -0
  137. package/dist/templates/trellis/scripts/common/git_context.py +106 -0
  138. package/dist/templates/trellis/scripts/common/io.py +160 -0
  139. package/dist/templates/trellis/scripts/common/log.py +45 -0
  140. package/dist/templates/trellis/scripts/common/packages_context.py +238 -0
  141. package/dist/templates/trellis/scripts/common/paths.py +543 -0
  142. package/dist/templates/trellis/scripts/common/safe_commit.py +322 -0
  143. package/dist/templates/trellis/scripts/common/session_context.py +708 -0
  144. package/dist/templates/trellis/scripts/common/task_context.py +470 -0
  145. package/dist/templates/trellis/scripts/common/task_queue.py +188 -0
  146. package/dist/templates/trellis/scripts/common/task_store.py +1930 -0
  147. package/dist/templates/trellis/scripts/common/task_utils.py +498 -0
  148. package/dist/templates/trellis/scripts/common/tasks.py +122 -0
  149. package/dist/templates/trellis/scripts/common/trellis_config.py +239 -0
  150. package/dist/templates/trellis/scripts/common/types.py +110 -0
  151. package/dist/templates/trellis/scripts/common/workflow_phase.py +242 -0
  152. package/dist/templates/trellis/scripts/get_context.py +16 -0
  153. package/dist/templates/trellis/scripts/init_developer.py +51 -0
  154. package/dist/types/ai-tools.d.ts +30 -0
  155. package/dist/types/ai-tools.d.ts.map +1 -0
  156. package/dist/types/ai-tools.js +89 -0
  157. package/dist/types/ai-tools.js.map +1 -0
  158. package/dist/utils/atomic-write.d.ts +12 -0
  159. package/dist/utils/atomic-write.d.ts.map +1 -0
  160. package/dist/utils/atomic-write.js +30 -0
  161. package/dist/utils/atomic-write.js.map +1 -0
  162. package/dist/utils/cwd-guard.d.ts +38 -0
  163. package/dist/utils/cwd-guard.d.ts.map +1 -0
  164. package/dist/utils/cwd-guard.js +62 -0
  165. package/dist/utils/cwd-guard.js.map +1 -0
  166. package/dist/utils/file-writer.d.ts +36 -0
  167. package/dist/utils/file-writer.d.ts.map +1 -0
  168. package/dist/utils/file-writer.js +204 -0
  169. package/dist/utils/file-writer.js.map +1 -0
  170. package/dist/utils/managed-paths.d.ts +5 -0
  171. package/dist/utils/managed-paths.d.ts.map +1 -0
  172. package/dist/utils/managed-paths.js +51 -0
  173. package/dist/utils/managed-paths.js.map +1 -0
  174. package/dist/utils/managed-removal.d.ts +42 -0
  175. package/dist/utils/managed-removal.d.ts.map +1 -0
  176. package/dist/utils/managed-removal.js +223 -0
  177. package/dist/utils/managed-removal.js.map +1 -0
  178. package/dist/utils/posix.d.ts +13 -0
  179. package/dist/utils/posix.d.ts.map +1 -0
  180. package/dist/utils/posix.js +15 -0
  181. package/dist/utils/posix.js.map +1 -0
  182. package/dist/utils/uninstall-scrubbers.d.ts +66 -0
  183. package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
  184. package/dist/utils/uninstall-scrubbers.js +417 -0
  185. package/dist/utils/uninstall-scrubbers.js.map +1 -0
  186. package/package.json +80 -0
@@ -0,0 +1,238 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Package discovery and context output.
4
+
5
+ Provides:
6
+ get_packages_info - Get structured package info
7
+ get_packages_section - Build PACKAGES text section
8
+ get_context_packages_text - Full packages text output (--mode packages)
9
+ get_context_packages_json - Full packages JSON output (--mode packages --json)
10
+ """
11
+
12
+ from __future__ import annotations
13
+
14
+ from pathlib import Path
15
+
16
+ from .config import _is_true_config_value, get_default_package, get_packages, get_spec_scope
17
+ from .paths import (
18
+ DIR_SPEC,
19
+ DIR_WORKFLOW,
20
+ get_current_task,
21
+ get_repo_root,
22
+ )
23
+ from .tasks import load_task
24
+
25
+
26
+ # =============================================================================
27
+ # Internal Helpers
28
+ # =============================================================================
29
+
30
+ def _scan_spec_layers(spec_dir: Path, package: str | None = None) -> list[str]:
31
+ """Scan spec directory for available layers (subdirectories).
32
+
33
+ For monorepo: scans spec/<package>/
34
+ For single-repo: scans spec/
35
+ """
36
+ target = spec_dir / package if package else spec_dir
37
+ if not target.is_dir():
38
+ return []
39
+ return sorted(
40
+ d.name for d in target.iterdir() if d.is_dir() and d.name != "guides"
41
+ )
42
+
43
+
44
+ def _get_active_task_package(repo_root: Path) -> str | None:
45
+ """Get the package field from the active task's task.json."""
46
+ current = get_current_task(repo_root)
47
+ if not current:
48
+ return None
49
+ ct = load_task(repo_root / current)
50
+ return ct.package if ct and ct.package else None
51
+
52
+
53
+ def _resolve_scope_set(
54
+ packages: dict,
55
+ spec_scope,
56
+ task_pkg: str | None,
57
+ default_pkg: str | None,
58
+ ) -> set | None:
59
+ """Resolve spec_scope to a set of allowed package names, or None for full scan."""
60
+ if not packages:
61
+ return None
62
+
63
+ if spec_scope is None:
64
+ return None
65
+
66
+ if isinstance(spec_scope, str) and spec_scope == "active_task":
67
+ if task_pkg and task_pkg in packages:
68
+ return {task_pkg}
69
+ if default_pkg and default_pkg in packages:
70
+ return {default_pkg}
71
+ return None
72
+
73
+ if isinstance(spec_scope, list):
74
+ valid = {e for e in spec_scope if e in packages}
75
+ if valid:
76
+ return valid
77
+ # All invalid: fallback
78
+ if task_pkg and task_pkg in packages:
79
+ return {task_pkg}
80
+ if default_pkg and default_pkg in packages:
81
+ return {default_pkg}
82
+ return None
83
+
84
+ return None
85
+
86
+
87
+ # =============================================================================
88
+ # Public Functions
89
+ # =============================================================================
90
+
91
+ def get_packages_info(repo_root: Path) -> list[dict]:
92
+ """Get structured package info for monorepo projects.
93
+
94
+ Returns list of dicts with keys: name, path, type, default, specLayers,
95
+ isSubmodule, isGitRepo.
96
+ Returns empty list for single-repo projects.
97
+ """
98
+ packages = get_packages(repo_root)
99
+ if not packages:
100
+ return []
101
+
102
+ default_pkg = get_default_package(repo_root)
103
+ spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
104
+ result = []
105
+
106
+ for pkg_name, pkg_config in packages.items():
107
+ pkg_path = pkg_config.get("path", pkg_name) if isinstance(pkg_config, dict) else str(pkg_config)
108
+ pkg_type = pkg_config.get("type", "local") if isinstance(pkg_config, dict) else "local"
109
+ pkg_git = pkg_config.get("git", False) if isinstance(pkg_config, dict) else False
110
+ layers = _scan_spec_layers(spec_dir, pkg_name)
111
+
112
+ result.append({
113
+ "name": pkg_name,
114
+ "path": pkg_path,
115
+ "type": pkg_type,
116
+ "default": pkg_name == default_pkg,
117
+ "specLayers": layers,
118
+ "isSubmodule": pkg_type == "submodule",
119
+ "isGitRepo": _is_true_config_value(pkg_git),
120
+ })
121
+
122
+ return result
123
+
124
+
125
+ def get_packages_section(repo_root: Path) -> str:
126
+ """Build the PACKAGES section for text output."""
127
+ spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
128
+ pkg_info = get_packages_info(repo_root)
129
+
130
+ lines: list[str] = []
131
+ lines.append("## PACKAGES")
132
+
133
+ if not pkg_info:
134
+ lines.append("(single-repo mode)")
135
+ layers = _scan_spec_layers(spec_dir)
136
+ if layers:
137
+ lines.append(f"Spec layers: {', '.join(layers)}")
138
+ return "\n".join(lines)
139
+
140
+ default_pkg = get_default_package(repo_root)
141
+
142
+ for pkg in pkg_info:
143
+ layers_str = f" [{', '.join(pkg['specLayers'])}]" if pkg["specLayers"] else ""
144
+ submodule_tag = " (submodule)" if pkg["isSubmodule"] else ""
145
+ git_repo_tag = " (git repo)" if pkg["isGitRepo"] else ""
146
+ default_tag = " *" if pkg["default"] else ""
147
+ lines.append(
148
+ f"- {pkg['name']:<16} {pkg['path']:<20}{layers_str}{submodule_tag}{git_repo_tag}{default_tag}"
149
+ )
150
+
151
+ if default_pkg:
152
+ lines.append(f"Default package: {default_pkg}")
153
+
154
+ return "\n".join(lines)
155
+
156
+
157
+ def get_context_packages_text(repo_root: Path | None = None) -> str:
158
+ """Get packages context as formatted text (for --mode packages)."""
159
+ if repo_root is None:
160
+ repo_root = get_repo_root()
161
+
162
+ pkg_info = get_packages_info(repo_root)
163
+ lines: list[str] = []
164
+
165
+ if not pkg_info:
166
+ spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
167
+ lines.append("Single-repo project (no packages configured)")
168
+ lines.append("")
169
+ layers = _scan_spec_layers(spec_dir)
170
+ if layers:
171
+ lines.append(f"Spec layers: {', '.join(layers)}")
172
+ return "\n".join(lines)
173
+
174
+ # Resolve scope for annotations
175
+ packages_dict = get_packages(repo_root) or {}
176
+ default_pkg = get_default_package(repo_root)
177
+ spec_scope = get_spec_scope(repo_root)
178
+ task_pkg = _get_active_task_package(repo_root)
179
+ scope_set = _resolve_scope_set(packages_dict, spec_scope, task_pkg, default_pkg)
180
+
181
+ lines.append("## PACKAGES")
182
+ lines.append("")
183
+ for pkg in pkg_info:
184
+ default_tag = " (default)" if pkg["default"] else ""
185
+ type_tag = f" [{pkg['type']}]" if pkg["type"] != "local" else ""
186
+ git_tag = " [git repo]" if pkg["isGitRepo"] else ""
187
+
188
+ # Scope annotation
189
+ scope_tag = ""
190
+ if scope_set is not None and pkg["name"] not in scope_set:
191
+ scope_tag = " (out of scope)"
192
+
193
+ lines.append(f"### {pkg['name']}{default_tag}{type_tag}{git_tag}{scope_tag}")
194
+ lines.append(f"Path: {pkg['path']}")
195
+ if pkg["specLayers"]:
196
+ lines.append(f"Spec layers: {', '.join(pkg['specLayers'])}")
197
+ for layer in pkg["specLayers"]:
198
+ lines.append(f" - .trellis/spec/{pkg['name']}/{layer}/index.md")
199
+ else:
200
+ lines.append("Spec: not configured")
201
+ lines.append("")
202
+
203
+ # Also show shared guides
204
+ guides_dir = repo_root / DIR_WORKFLOW / DIR_SPEC / "guides"
205
+ if guides_dir.is_dir():
206
+ lines.append("### Shared Guides (always included)")
207
+ lines.append("Path: .trellis/spec/guides/index.md")
208
+ lines.append("")
209
+
210
+ return "\n".join(lines)
211
+
212
+
213
+ def get_context_packages_json(repo_root: Path | None = None) -> dict:
214
+ """Get packages context as a dictionary (for --mode packages --json)."""
215
+ if repo_root is None:
216
+ repo_root = get_repo_root()
217
+
218
+ pkg_info = get_packages_info(repo_root)
219
+
220
+ if not pkg_info:
221
+ spec_dir = repo_root / DIR_WORKFLOW / DIR_SPEC
222
+ layers = _scan_spec_layers(spec_dir)
223
+ return {
224
+ "mode": "single-repo",
225
+ "specLayers": layers,
226
+ }
227
+
228
+ default_pkg = get_default_package(repo_root)
229
+ spec_scope = get_spec_scope(repo_root)
230
+ task_pkg = _get_active_task_package(repo_root)
231
+
232
+ return {
233
+ "mode": "monorepo",
234
+ "packages": pkg_info,
235
+ "defaultPackage": default_pkg,
236
+ "specScope": spec_scope,
237
+ "activeTaskPackage": task_pkg,
238
+ }