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.
- package/COPYRIGHT +20 -0
- package/LICENSE +235 -0
- package/README.md +66 -0
- package/bin/mini-trellis.js +3 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +153 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/commands/init.d.ts +19 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +401 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/mem.d.ts +30 -0
- package/dist/commands/mem.d.ts.map +1 -0
- package/dist/commands/mem.js +412 -0
- package/dist/commands/mem.js.map +1 -0
- package/dist/commands/migrate.d.ts +40 -0
- package/dist/commands/migrate.d.ts.map +1 -0
- package/dist/commands/migrate.js +272 -0
- package/dist/commands/migrate.js.map +1 -0
- package/dist/commands/uninstall.d.ts +11 -0
- package/dist/commands/uninstall.d.ts.map +1 -0
- package/dist/commands/uninstall.js +135 -0
- package/dist/commands/uninstall.js.map +1 -0
- package/dist/commands/upgrade.d.ts +28 -0
- package/dist/commands/upgrade.d.ts.map +1 -0
- package/dist/commands/upgrade.js +84 -0
- package/dist/commands/upgrade.js.map +1 -0
- package/dist/configurators/claude.d.ts +3 -0
- package/dist/configurators/claude.d.ts.map +1 -0
- package/dist/configurators/claude.js +62 -0
- package/dist/configurators/claude.js.map +1 -0
- package/dist/configurators/codex.d.ts +3 -0
- package/dist/configurators/codex.d.ts.map +1 -0
- package/dist/configurators/codex.js +21 -0
- package/dist/configurators/codex.js.map +1 -0
- package/dist/configurators/index.d.ts +24 -0
- package/dist/configurators/index.d.ts.map +1 -0
- package/dist/configurators/index.js +80 -0
- package/dist/configurators/index.js.map +1 -0
- package/dist/configurators/opencode.d.ts +2 -0
- package/dist/configurators/opencode.d.ts.map +1 -0
- package/dist/configurators/opencode.js +62 -0
- package/dist/configurators/opencode.js.map +1 -0
- package/dist/configurators/pi.d.ts +2 -0
- package/dist/configurators/pi.d.ts.map +1 -0
- package/dist/configurators/pi.js +18 -0
- package/dist/configurators/pi.js.map +1 -0
- package/dist/configurators/shared.d.ts +147 -0
- package/dist/configurators/shared.d.ts.map +1 -0
- package/dist/configurators/shared.js +377 -0
- package/dist/configurators/shared.js.map +1 -0
- package/dist/configurators/workflow.d.ts +15 -0
- package/dist/configurators/workflow.d.ts.map +1 -0
- package/dist/configurators/workflow.js +46 -0
- package/dist/configurators/workflow.js.map +1 -0
- package/dist/constants/paths.d.ts +74 -0
- package/dist/constants/paths.d.ts.map +1 -0
- package/dist/constants/paths.js +83 -0
- package/dist/constants/paths.js.map +1 -0
- package/dist/constants/version.d.ts +9 -0
- package/dist/constants/version.d.ts.map +1 -0
- package/dist/constants/version.js +15 -0
- package/dist/constants/version.js.map +1 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -0
- package/dist/templates/claude/index.d.ts +11 -0
- package/dist/templates/claude/index.d.ts.map +1 -0
- package/dist/templates/claude/index.js +17 -0
- package/dist/templates/claude/index.js.map +1 -0
- package/dist/templates/claude/settings.json +40 -0
- package/dist/templates/codex/config.toml +39 -0
- package/dist/templates/codex/hooks.json +15 -0
- package/dist/templates/codex/index.d.ts +11 -0
- package/dist/templates/codex/index.d.ts.map +1 -0
- package/dist/templates/codex/index.js +22 -0
- package/dist/templates/codex/index.js.map +1 -0
- package/dist/templates/common/bundled-skills/mini-trellis-session-insight/SKILL.md +37 -0
- package/dist/templates/common/bundled-skills/mini-trellis-session-insight/references/cli-quick-reference.md +36 -0
- package/dist/templates/common/bundled-skills/mini-trellis-session-insight/references/triggering-patterns.md +93 -0
- package/dist/templates/common/commands/remember.md +22 -0
- package/dist/templates/common/index.d.ts +48 -0
- package/dist/templates/common/index.d.ts.map +1 -0
- package/dist/templates/common/index.js +104 -0
- package/dist/templates/common/index.js.map +1 -0
- package/dist/templates/common/skills/update-spec.md +16 -0
- package/dist/templates/extract.d.ts +40 -0
- package/dist/templates/extract.d.ts.map +1 -0
- package/dist/templates/extract.js +106 -0
- package/dist/templates/extract.js.map +1 -0
- package/dist/templates/markdown/agents.md +15 -0
- package/dist/templates/markdown/index.d.ts +10 -0
- package/dist/templates/markdown/index.d.ts.map +1 -0
- package/dist/templates/markdown/index.js +18 -0
- package/dist/templates/markdown/index.js.map +1 -0
- package/dist/templates/markdown/research-readme.md +9 -0
- package/dist/templates/markdown/spec/guides/index.md.txt +5 -0
- package/dist/templates/markdown/spec/guides/mini-memory.md.txt +30 -0
- package/dist/templates/markdown/workspace-index.md +23 -0
- package/dist/templates/opencode/lib/context-visibility.js +148 -0
- package/dist/templates/opencode/lib/session-utils.js +394 -0
- package/dist/templates/opencode/lib/trellis-context.js +627 -0
- package/dist/templates/opencode/package.json +5 -0
- package/dist/templates/opencode/plugins/session-start.js +65 -0
- package/dist/templates/pi/extensions/mini-trellis/index.ts.txt +170 -0
- package/dist/templates/pi/index.d.ts +4 -0
- package/dist/templates/pi/index.d.ts.map +1 -0
- package/dist/templates/pi/index.js +9 -0
- package/dist/templates/pi/index.js.map +1 -0
- package/dist/templates/pi/settings.json +9 -0
- package/dist/templates/shared-hooks/index.d.ts +13 -0
- package/dist/templates/shared-hooks/index.d.ts.map +1 -0
- package/dist/templates/shared-hooks/index.js +26 -0
- package/dist/templates/shared-hooks/index.js.map +1 -0
- package/dist/templates/shared-hooks/session-start.py +676 -0
- package/dist/templates/template-utils.d.ts +26 -0
- package/dist/templates/template-utils.d.ts.map +1 -0
- package/dist/templates/template-utils.js +64 -0
- package/dist/templates/template-utils.js.map +1 -0
- package/dist/templates/trellis/config.yaml +34 -0
- package/dist/templates/trellis/gitattributes.txt +9 -0
- package/dist/templates/trellis/gitignore.txt +32 -0
- package/dist/templates/trellis/index.d.ts +8 -0
- package/dist/templates/trellis/index.d.ts.map +1 -0
- package/dist/templates/trellis/index.js +16 -0
- package/dist/templates/trellis/index.js.map +1 -0
- package/dist/templates/trellis/scripts/__init__.py +5 -0
- package/dist/templates/trellis/scripts/add_session.py +1545 -0
- package/dist/templates/trellis/scripts/common/__init__.py +94 -0
- package/dist/templates/trellis/scripts/common/active_task.py +855 -0
- package/dist/templates/trellis/scripts/common/cli_adapter.py +950 -0
- package/dist/templates/trellis/scripts/common/config.py +482 -0
- package/dist/templates/trellis/scripts/common/developer.py +192 -0
- package/dist/templates/trellis/scripts/common/git.py +203 -0
- package/dist/templates/trellis/scripts/common/git_context.py +106 -0
- package/dist/templates/trellis/scripts/common/io.py +160 -0
- package/dist/templates/trellis/scripts/common/log.py +45 -0
- package/dist/templates/trellis/scripts/common/packages_context.py +238 -0
- package/dist/templates/trellis/scripts/common/paths.py +543 -0
- package/dist/templates/trellis/scripts/common/safe_commit.py +322 -0
- package/dist/templates/trellis/scripts/common/session_context.py +708 -0
- package/dist/templates/trellis/scripts/common/task_context.py +470 -0
- package/dist/templates/trellis/scripts/common/task_queue.py +188 -0
- package/dist/templates/trellis/scripts/common/task_store.py +1930 -0
- package/dist/templates/trellis/scripts/common/task_utils.py +498 -0
- package/dist/templates/trellis/scripts/common/tasks.py +122 -0
- package/dist/templates/trellis/scripts/common/trellis_config.py +239 -0
- package/dist/templates/trellis/scripts/common/types.py +110 -0
- package/dist/templates/trellis/scripts/common/workflow_phase.py +242 -0
- package/dist/templates/trellis/scripts/get_context.py +16 -0
- package/dist/templates/trellis/scripts/init_developer.py +51 -0
- package/dist/types/ai-tools.d.ts +30 -0
- package/dist/types/ai-tools.d.ts.map +1 -0
- package/dist/types/ai-tools.js +89 -0
- package/dist/types/ai-tools.js.map +1 -0
- package/dist/utils/atomic-write.d.ts +12 -0
- package/dist/utils/atomic-write.d.ts.map +1 -0
- package/dist/utils/atomic-write.js +30 -0
- package/dist/utils/atomic-write.js.map +1 -0
- package/dist/utils/cwd-guard.d.ts +38 -0
- package/dist/utils/cwd-guard.d.ts.map +1 -0
- package/dist/utils/cwd-guard.js +62 -0
- package/dist/utils/cwd-guard.js.map +1 -0
- package/dist/utils/file-writer.d.ts +36 -0
- package/dist/utils/file-writer.d.ts.map +1 -0
- package/dist/utils/file-writer.js +204 -0
- package/dist/utils/file-writer.js.map +1 -0
- package/dist/utils/managed-paths.d.ts +5 -0
- package/dist/utils/managed-paths.d.ts.map +1 -0
- package/dist/utils/managed-paths.js +51 -0
- package/dist/utils/managed-paths.js.map +1 -0
- package/dist/utils/managed-removal.d.ts +42 -0
- package/dist/utils/managed-removal.d.ts.map +1 -0
- package/dist/utils/managed-removal.js +223 -0
- package/dist/utils/managed-removal.js.map +1 -0
- package/dist/utils/posix.d.ts +13 -0
- package/dist/utils/posix.d.ts.map +1 -0
- package/dist/utils/posix.js +15 -0
- package/dist/utils/posix.js.map +1 -0
- package/dist/utils/uninstall-scrubbers.d.ts +66 -0
- package/dist/utils/uninstall-scrubbers.d.ts.map +1 -0
- package/dist/utils/uninstall-scrubbers.js +417 -0
- package/dist/utils/uninstall-scrubbers.js.map +1 -0
- 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
|
+
}
|