@blxzer/cursor-trellis 0.3.0 → 0.3.3
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 +45 -0
- package/README.md +51 -10
- package/README.zh-CN.md +21 -7
- package/bin/cstl.js +1 -1
- package/bin/smart-search.js +1 -1
- package/dist/cli/index.d.ts.map +1 -1
- package/dist/cli/index.js +17 -15
- package/dist/cli/index.js.map +1 -1
- package/dist/commands/capability-smoke.js +2 -2
- package/dist/commands/capability-smoke.js.map +1 -1
- package/dist/commands/channel/agent-loader.d.ts +1 -1
- package/dist/commands/channel/agent-loader.js +4 -4
- package/dist/commands/channel/agent-loader.js.map +1 -1
- package/dist/commands/channel/guard.d.ts +2 -2
- package/dist/commands/channel/guard.js +3 -3
- package/dist/commands/channel/guard.js.map +1 -1
- package/dist/commands/channel/index.js +3 -3
- package/dist/commands/channel/index.js.map +1 -1
- package/dist/commands/channel/list.d.ts +1 -1
- package/dist/commands/channel/list.js +1 -1
- package/dist/commands/channel/rm.d.ts +1 -1
- package/dist/commands/channel/rm.js +1 -1
- package/dist/commands/channel/store/lock.d.ts +1 -1
- package/dist/commands/channel/store/lock.js +1 -1
- package/dist/commands/channel/store/paths.js +1 -1
- package/dist/commands/channel/store/paths.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +105 -59
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/uninstall.d.ts +3 -3
- package/dist/commands/uninstall.d.ts.map +1 -1
- package/dist/commands/uninstall.js +69 -15
- package/dist/commands/uninstall.js.map +1 -1
- package/dist/commands/update.d.ts +6 -1
- package/dist/commands/update.d.ts.map +1 -1
- package/dist/commands/update.js +83 -28
- package/dist/commands/update.js.map +1 -1
- package/dist/commands/workflow.d.ts +4 -4
- package/dist/commands/workflow.d.ts.map +1 -1
- package/dist/commands/workflow.js +10 -9
- package/dist/commands/workflow.js.map +1 -1
- package/dist/configurators/index.d.ts.map +1 -1
- package/dist/configurators/index.js +1 -1
- package/dist/configurators/index.js.map +1 -1
- package/dist/configurators/shared.js +6 -6
- package/dist/configurators/shared.js.map +1 -1
- package/dist/configurators/workflow.d.ts +4 -4
- package/dist/configurators/workflow.js +1 -1
- package/dist/constants/paths.d.ts +24 -24
- package/dist/constants/paths.d.ts.map +1 -1
- package/dist/constants/paths.js +16 -16
- package/dist/constants/paths.js.map +1 -1
- package/dist/migrations/manifests/0.3.1.json +32 -0
- package/dist/templates/common/bundled-skills/cstl-cursor2plus-setup/SKILL.md +11 -11
- package/dist/templates/common/bundled-skills/cstl-meta/SKILL.md +15 -15
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/add-project-local-conventions.md +12 -12
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-agents.md +2 -2
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-context-loading.md +21 -21
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-hooks.md +9 -9
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-skills-or-commands.md +7 -7
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-spec-structure.md +15 -15
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-task-lifecycle.md +27 -27
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/change-workflow.md +7 -7
- package/dist/templates/common/bundled-skills/cstl-meta/references/customize-local/overview.md +11 -11
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/context-injection.md +12 -12
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/generated-files.md +21 -21
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/overview.md +14 -14
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/spec-system.md +12 -12
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/task-system.md +23 -23
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/workflow.md +3 -3
- package/dist/templates/common/bundled-skills/cstl-meta/references/local-architecture/workspace-memory.md +16 -16
- package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/agents.md +2 -2
- package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/hooks-and-settings.md +6 -6
- package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/overview.md +5 -5
- package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/platform-map.md +3 -3
- package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/skills-and-commands.md +5 -5
- package/dist/templates/common/bundled-skills/cstl-skill-creator/SKILL.md +2 -2
- package/dist/templates/common/bundled-skills/cstl-skill-creator/references/review-checklist.md +1 -1
- package/dist/templates/common/bundled-skills/cstl-spec-bootstrap/SKILL.md +5 -5
- package/dist/templates/common/bundled-skills/cstl-spec-bootstrap/references/repository-analysis.md +1 -1
- package/dist/templates/common/bundled-skills/cstl-spec-bootstrap/references/spec-task-planning.md +3 -3
- package/dist/templates/common/bundled-skills/cstl-spec-bootstrap/references/spec-writing.md +1 -1
- package/dist/templates/common/commands/continue.md +6 -6
- package/dist/templates/common/commands/finish-work.md +5 -5
- package/dist/templates/common/commands/start.md +8 -8
- package/dist/templates/common/skills/before-dev.md +4 -4
- package/dist/templates/common/skills/brainstorm.md +5 -5
- package/dist/templates/common/skills/break-loop.md +3 -3
- package/dist/templates/common/skills/check.md +5 -5
- package/dist/templates/common/skills/update-spec.md +4 -4
- package/dist/templates/cursor/agents/cstl-check.md +6 -6
- package/dist/templates/cursor/agents/cstl-implement.md +7 -7
- package/dist/templates/cursor/agents/cstl-research.md +9 -9
- package/dist/templates/cursor/commands/cursor2plus-setup.md +10 -10
- package/dist/templates/cursor/rules/cstl-subagent-dispatch.mdc +2 -2
- package/dist/templates/cursor/rules/cstl-triage.mdc +2 -2
- package/dist/templates/cursor/rules/retrieval-routing.mdc +4 -4
- package/dist/templates/extract.d.ts +1 -1
- package/dist/templates/extract.js +1 -1
- package/dist/templates/markdown/agents.md +11 -11
- package/dist/templates/markdown/prompts/run-semantic-slice-12.md.txt +1 -1
- package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +5 -5
- package/dist/templates/markdown/spec/guides/cursor-context-injection-guide.md.txt +3 -3
- package/dist/templates/markdown/spec/guides/cursor-semantic-compliance.md.txt +1 -1
- package/dist/templates/markdown/spec/guides/cursor-subagent-policy.md.txt +11 -11
- package/dist/templates/markdown/spec/guides/cursor-trellis-release-coexistence-guide.md.txt +166 -0
- package/dist/templates/markdown/spec/guides/durable-learning-decision-guide.md.txt +8 -8
- package/dist/templates/markdown/spec/guides/execution-strategy.md.txt +3 -3
- package/dist/templates/markdown/spec/guides/index.md.txt +1 -0
- package/dist/templates/markdown/spec/guides/retrieval-daily-guide.md.txt +10 -10
- package/dist/templates/markdown/workspace-index.md +3 -3
- package/dist/templates/markdown/worktree.yaml.txt +1 -1
- package/dist/templates/shared-hooks/index.d.ts +1 -1
- package/dist/templates/shared-hooks/index.js +1 -1
- package/dist/templates/shared-hooks/inject-retrieval-plan.py +3 -3
- package/dist/templates/shared-hooks/inject-shell-session-context.py +7 -7
- package/dist/templates/shared-hooks/inject-subagent-context.py +1 -1
- package/dist/templates/shared-hooks/inject-workflow-state.py +11 -11
- package/dist/templates/shared-hooks/research-end-retrieval-pack.py +1 -1
- package/dist/templates/shared-hooks/session-start.py +13 -13
- package/dist/templates/trellis/config.yaml +2 -22
- package/dist/templates/trellis/index.d.ts +2 -2
- package/dist/templates/trellis/index.js +2 -2
- package/dist/templates/trellis/local/README.md +3 -3
- package/dist/templates/trellis/local/patch_wpelc8.py +4 -4
- package/dist/templates/trellis/scripts/add_session.py +20 -20
- package/dist/templates/trellis/scripts/common/active_task.py +2 -2
- package/dist/templates/trellis/scripts/common/artifact_search.py +587 -587
- package/dist/templates/trellis/scripts/common/codebase_retrieval_router.py +6 -6
- package/dist/templates/trellis/scripts/common/config.py +3 -3
- package/dist/templates/trellis/scripts/common/developer.py +2 -2
- package/dist/templates/trellis/scripts/common/packages_context.py +23 -23
- package/dist/templates/trellis/scripts/common/parent_orchestration.py +16 -16
- package/dist/templates/trellis/scripts/common/paths.py +107 -107
- package/dist/templates/trellis/scripts/common/project_file_stats.py +1 -1
- package/dist/templates/trellis/scripts/common/retrieval_agent_instructions.py +1 -1
- package/dist/templates/trellis/scripts/common/safe_commit.py +31 -31
- package/dist/templates/trellis/scripts/common/session_memory.py +360 -360
- package/dist/templates/trellis/scripts/common/smart_search_evidence.py +514 -514
- package/dist/templates/trellis/scripts/common/smart_search_resolve.py +1 -1
- package/dist/templates/trellis/scripts/common/subagent_dispatch.py +2 -2
- package/dist/templates/trellis/scripts/common/task_context.py +1 -1
- package/dist/templates/trellis/scripts/common/task_dashboard.py +140 -140
- package/dist/templates/trellis/scripts/common/task_gates.py +23 -23
- package/dist/templates/trellis/scripts/common/task_store.py +5 -5
- package/dist/templates/trellis/scripts/common/task_utils.py +3 -3
- package/dist/templates/trellis/scripts/common/tasks.py +1 -1
- package/dist/templates/trellis/scripts/common/trellis_config.py +3 -3
- package/dist/templates/trellis/scripts/common/workflow_phase.py +1 -1
- package/dist/templates/trellis/scripts/cursor_retrieval_probe.py +3 -3
- package/dist/templates/trellis/scripts/cursor_retrieval_probe_prompt.md +11 -11
- package/dist/templates/trellis/scripts/hooks/linear_sync.py +8 -8
- package/dist/templates/trellis/scripts/init_developer.py +2 -2
- package/dist/templates/trellis/scripts/retrieval_probe_matrix_template.json +4 -4
- package/dist/templates/trellis/scripts/route_codebase_retrieval.py +1 -1
- package/dist/templates/trellis/scripts/task.py +918 -918
- package/dist/templates/trellis/tasks/templates/release-readiness/implement.md +2 -2
- package/dist/templates/trellis/workflow.md +64 -64
- package/dist/types/migration.d.ts +1 -1
- package/dist/types/migration.d.ts.map +1 -1
- package/dist/utils/agents-md.d.ts +47 -0
- package/dist/utils/agents-md.d.ts.map +1 -0
- package/dist/utils/agents-md.js +107 -0
- package/dist/utils/agents-md.js.map +1 -0
- package/dist/utils/codebase-retrieval-router.js +5 -5
- package/dist/utils/codebase-retrieval-router.js.map +1 -1
- package/dist/utils/manifest-prune.d.ts +2 -2
- package/dist/utils/manifest-prune.js +4 -4
- package/dist/utils/manifest-prune.js.map +1 -1
- package/dist/utils/mirror-check.d.ts +3 -1
- package/dist/utils/mirror-check.d.ts.map +1 -1
- package/dist/utils/mirror-check.js +22 -11
- package/dist/utils/mirror-check.js.map +1 -1
- package/dist/utils/project-capabilities.js +5 -5
- package/dist/utils/project-capabilities.js.map +1 -1
- package/dist/utils/retrieval-agent-instructions.js +1 -1
- package/dist/utils/retrieval-agent-instructions.js.map +1 -1
- package/dist/utils/retrieval-execution-telemetry.js +1 -1
- package/dist/utils/retrieval-execution-telemetry.js.map +1 -1
- package/dist/utils/template-fetcher.js +1 -1
- package/dist/utils/template-fetcher.js.map +1 -1
- package/dist/utils/template-hash.d.ts +2 -2
- package/dist/utils/template-hash.d.ts.map +1 -1
- package/dist/utils/template-hash.js +51 -18
- package/dist/utils/template-hash.js.map +1 -1
- package/dist/utils/workflow-dir.d.ts +13 -0
- package/dist/utils/workflow-dir.d.ts.map +1 -0
- package/dist/utils/workflow-dir.js +35 -0
- package/dist/utils/workflow-dir.js.map +1 -0
- package/dist/utils/workflow-ownership.d.ts +36 -0
- package/dist/utils/workflow-ownership.d.ts.map +1 -0
- package/dist/utils/workflow-ownership.js +137 -0
- package/dist/utils/workflow-ownership.js.map +1 -0
- package/dist/utils/workflow-resolver.d.ts +1 -1
- package/dist/utils/workflow-resolver.js +1 -1
- package/package.json +2 -2
|
@@ -32,7 +32,7 @@ the **codegraph_search** MCP tool to answer.
|
|
|
32
32
|
|
|
33
33
|
Task: Call `codegraph_search` with the query `patch_wpelc8` and report:
|
|
34
34
|
1. The file path(s) returned (expected to contain `patch_wpelc8.py` under
|
|
35
|
-
`.
|
|
35
|
+
`.cstl/local/cursor2plus/`).
|
|
36
36
|
2. The symbol kind (expected: `function`).
|
|
37
37
|
3. The exact tool name you invoked (from your tool-use record).
|
|
38
38
|
|
|
@@ -57,7 +57,7 @@ the **codegraph_callers** MCP tool to answer.
|
|
|
57
57
|
Task: Call `codegraph_callers` with the symbol `route_codebase_retrieval` and
|
|
58
58
|
report:
|
|
59
59
|
1. The list of caller sites returned (expected: at least one caller in
|
|
60
|
-
`route_codebase_retrieval.py` under `.
|
|
60
|
+
`route_codebase_retrieval.py` under `.cstl/scripts/`).
|
|
61
61
|
2. The count of callers.
|
|
62
62
|
3. The exact tool name you invoked.
|
|
63
63
|
|
|
@@ -85,7 +85,7 @@ Task: Call the fast-context semantic search with the query:
|
|
|
85
85
|
Report:
|
|
86
86
|
1. Whether the tool returned any results.
|
|
87
87
|
2. If so, the top file path (expected to contain something under
|
|
88
|
-
`.
|
|
88
|
+
`.cstl/local/cursor2plus/` or `.cstl/spec/guides/cursor-subagent-policy.md`).
|
|
89
89
|
3. The exact tool name you invoked.
|
|
90
90
|
|
|
91
91
|
Reply in this exact format:
|
|
@@ -111,7 +111,7 @@ concept recall** (not Grep on a known string). Do **not** invoke tools yet — l
|
|
|
111
111
|
your **available tool table / MCP list** only.
|
|
112
112
|
|
|
113
113
|
Also run locally (or ask the user to confirm):
|
|
114
|
-
`python .\.
|
|
114
|
+
`python .\.cstl\scripts\cursor_retrieval_probe.py --json` and note `env.env`,
|
|
115
115
|
`mcp_config.fast_context_configured`, and auto `D-01` status.
|
|
116
116
|
|
|
117
117
|
Reply in this exact format:
|
|
@@ -153,10 +153,10 @@ Semantic question:
|
|
|
153
153
|
> the official cloud?"
|
|
154
154
|
|
|
155
155
|
Expected answer (for verification, do NOT reveal this to the solver path):
|
|
156
|
-
the relevant logic lives in `.
|
|
156
|
+
the relevant logic lives in `.cstl/local/cursor2plus/patch_wpelc8.py` (the
|
|
157
157
|
`WPeLc8` function patch) and is documented in
|
|
158
|
-
`.
|
|
159
|
-
`.
|
|
158
|
+
`.cstl/spec/guides/cursor-subagent-policy.md` and
|
|
159
|
+
`.cstl/spec/guides/cursor-subagent-reverse-engineering-report.md`.
|
|
160
160
|
|
|
161
161
|
Reply in this exact format:
|
|
162
162
|
|
|
@@ -192,8 +192,8 @@ Semantic question (same as P-08 — no literal file/symbol/path clues in your qu
|
|
|
192
192
|
> the official cloud?"
|
|
193
193
|
|
|
194
194
|
Expected (for verification only — do not paste paths into fast_context_search query):
|
|
195
|
-
Top hits should include `.
|
|
196
|
-
`.
|
|
195
|
+
Top hits should include `.cstl/local/cursor2plus/patch_wpelc8.py` and/or
|
|
196
|
+
`.cstl/spec/guides/cursor-subagent-policy.md`.
|
|
197
197
|
|
|
198
198
|
Reply in this exact format:
|
|
199
199
|
|
|
@@ -231,7 +231,7 @@ Semantic question (no literal clues):
|
|
|
231
231
|
Expected (for verification only): the answer should weave together
|
|
232
232
|
`.cursor/hooks/inject-retrieval-plan.py` (beforeSubmitPrompt injection),
|
|
233
233
|
`.cursor/rules/retrieval-routing.mdc` (alwaysApply policy), and the
|
|
234
|
-
`sessionStart` bug #158452 noted in `.
|
|
234
|
+
`sessionStart` bug #158452 noted in `.cstl/spec/guides/cursor-context-injection-guide.md`.
|
|
235
235
|
|
|
236
236
|
Reply in this exact format:
|
|
237
237
|
|
|
@@ -263,7 +263,7 @@ confirm line numbers after codegraph returns a definition.
|
|
|
263
263
|
|
|
264
264
|
Task: Locate the **definition** of `route_codebase_retrieval` (Python function).
|
|
265
265
|
|
|
266
|
-
Expected: definition in `.
|
|
266
|
+
Expected: definition in `.cstl/scripts/common/codebase_retrieval_router.py`
|
|
267
267
|
(`def route_codebase_retrieval(`).
|
|
268
268
|
|
|
269
269
|
Reply in this exact format:
|
|
@@ -4,18 +4,18 @@
|
|
|
4
4
|
Syncs task events to Linear via the `linearis` CLI.
|
|
5
5
|
|
|
6
6
|
Usage (called automatically by task.py hooks):
|
|
7
|
-
python3 .
|
|
8
|
-
python3 .
|
|
9
|
-
python3 .
|
|
7
|
+
python3 .cstl/scripts/hooks/linear_sync.py create
|
|
8
|
+
python3 .cstl/scripts/hooks/linear_sync.py start
|
|
9
|
+
python3 .cstl/scripts/hooks/linear_sync.py archive
|
|
10
10
|
|
|
11
11
|
Manual usage:
|
|
12
|
-
TASK_JSON_PATH=.
|
|
12
|
+
TASK_JSON_PATH=.cstl/tasks/<name>/task.json python3 .cstl/scripts/hooks/linear_sync.py sync
|
|
13
13
|
|
|
14
14
|
Environment:
|
|
15
15
|
TASK_JSON_PATH - Absolute path to task.json (set by task.py)
|
|
16
16
|
|
|
17
17
|
Configuration:
|
|
18
|
-
.
|
|
18
|
+
.cstl/hooks.local.json - Local config (gitignored), example:
|
|
19
19
|
{
|
|
20
20
|
"linear": {
|
|
21
21
|
"team": "TEAM_KEY",
|
|
@@ -46,13 +46,13 @@ STATUS_DONE = "Done"
|
|
|
46
46
|
|
|
47
47
|
|
|
48
48
|
def _load_config() -> dict:
|
|
49
|
-
"""Load local hook config from .
|
|
49
|
+
"""Load local hook config from .cstl/hooks.local.json."""
|
|
50
50
|
task_json_path = os.environ.get("TASK_JSON_PATH", "")
|
|
51
51
|
if task_json_path:
|
|
52
|
-
# Walk up from task.json to find .
|
|
52
|
+
# Walk up from task.json to find .cstl/
|
|
53
53
|
trellis_dir = Path(task_json_path).parent.parent.parent
|
|
54
54
|
else:
|
|
55
|
-
trellis_dir = Path(".
|
|
55
|
+
trellis_dir = Path(".cstl")
|
|
56
56
|
|
|
57
57
|
config_path = trellis_dir / "hooks.local.json"
|
|
58
58
|
try:
|
|
@@ -6,8 +6,8 @@ Usage:
|
|
|
6
6
|
python3 init_developer.py <developer-name>
|
|
7
7
|
|
|
8
8
|
This creates:
|
|
9
|
-
- .
|
|
10
|
-
- .
|
|
9
|
+
- .cstl/.developer file with developer info
|
|
10
|
+
- .cstl/workspace/<name>/ directory structure
|
|
11
11
|
"""
|
|
12
12
|
|
|
13
13
|
from __future__ import annotations
|
|
@@ -117,10 +117,10 @@
|
|
|
117
117
|
"degraded_capabilities": ["P-08", "P-09"],
|
|
118
118
|
"probed_at": "2026-06-23",
|
|
119
119
|
"probe_evidence_files": [
|
|
120
|
-
".
|
|
121
|
-
".
|
|
122
|
-
".
|
|
123
|
-
".
|
|
120
|
+
".cstl/tasks/06-23-06-23-cursor-retrieval-byok-lsp-fastcontext/research/01-byok-retrieval-role-matrix.md",
|
|
121
|
+
".cstl/tasks/06-23-06-23-cursor-retrieval-byok-lsp-fastcontext/research/02-lsp-via-codegraph-decision.md",
|
|
122
|
+
".cstl/tasks/06-23-06-23-cursor-retrieval-byok-lsp-fastcontext/research/04-semantic-search-target-directories.md",
|
|
123
|
+
".cstl/tasks/06-23-experiment-d-byok-semanticsearch-drop/research/01-semanticsearch-drop-byok.md"
|
|
124
124
|
]
|
|
125
125
|
}
|
|
126
126
|
}
|
|
@@ -34,7 +34,7 @@ def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
|
|
|
34
34
|
parser.add_argument("query", nargs="?", default="", help="Natural-language retrieval question.")
|
|
35
35
|
parser.add_argument(
|
|
36
36
|
"--capabilities",
|
|
37
|
-
help="Path to .
|
|
37
|
+
help="Path to .cstl/capabilities.json for optional adapter gating.",
|
|
38
38
|
)
|
|
39
39
|
parser.add_argument(
|
|
40
40
|
"--no-codebase-retrieval",
|