get-tbd 0.1.21 → 0.1.23
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/README.md +17 -19
- package/dist/bin.mjs +181 -12
- package/dist/bin.mjs.map +1 -1
- package/dist/cli.mjs +110 -644
- package/dist/cli.mjs.map +1 -1
- package/dist/config-CB1tcqTZ.mjs +3 -0
- package/dist/config-CmEAGaxz.mjs +637 -0
- package/dist/config-CmEAGaxz.mjs.map +1 -0
- package/dist/docs/README.md +17 -19
- package/dist/docs/guidelines/bun-monorepo-patterns.md +816 -80
- package/dist/docs/guidelines/pnpm-monorepo-patterns.md +586 -16
- package/dist/docs/guidelines/python-cli-patterns.md +2 -2
- package/dist/docs/guidelines/tbd-sync-troubleshooting.md +27 -0
- package/dist/docs/guidelines/typescript-cli-tool-rules.md +465 -196
- package/dist/docs/tbd-design.md +86 -46
- package/dist/docs/tbd-docs.md +0 -6
- package/dist/id-mapping-0-R0X8zb.mjs +3 -0
- package/dist/{id-mapping-CD5c_ZVA.mjs → id-mapping-JGow6Jk4.mjs} +57 -3
- package/dist/{id-mapping-CD5c_ZVA.mjs.map → id-mapping-JGow6Jk4.mjs.map} +1 -1
- package/dist/index.d.mts +6 -0
- package/dist/index.mjs +2 -2
- package/dist/{src-BjMRpmMh.mjs → src-7qUDeWJf.mjs} +3 -3
- package/dist/{src-BjMRpmMh.mjs.map → src-7qUDeWJf.mjs.map} +1 -1
- package/dist/tbd +181 -12
- package/dist/{yaml-utils-x_kr2IId.mjs → yaml-utils-U7l9hhkh.mjs} +7 -1
- package/dist/yaml-utils-U7l9hhkh.mjs.map +1 -0
- package/package.json +4 -4
- package/dist/id-mapping-BqSnxlxk.mjs +0 -3
- package/dist/yaml-utils-x_kr2IId.mjs.map +0 -1
|
@@ -34,10 +34,10 @@ src/myproject/
|
|
|
34
34
|
### Agent & CI Compatibility
|
|
35
35
|
|
|
36
36
|
Support automation with explicit flags:
|
|
37
|
-
- `--non-interactive`: Disable prompts, fail if input required
|
|
38
|
-
- `--yes` / `-y`: Assume yes to confirmations
|
|
39
37
|
- `--format text|json|jsonl`: Output format
|
|
40
38
|
- `--no-progress`: Disable spinners (critical for AI agents)
|
|
39
|
+
- `--non-interactive`: Disable prompts (only if the CLI has interactive prompts)
|
|
40
|
+
- `--yes` / `-y`: Assume yes to confirmations (only if the CLI has confirmations)
|
|
41
41
|
|
|
42
42
|
Respect environment variables:
|
|
43
43
|
- `CI`: Set by GitHub Actions, GitLab CI, etc.
|
|
@@ -91,6 +91,33 @@ auto-saving, since the issue is likely temporary.
|
|
|
91
91
|
using field-level LWW and the trivial changes will be harmless
|
|
92
92
|
3. Run `tbd sync` to clear the outbox
|
|
93
93
|
|
|
94
|
+
### Missing ID Mappings After Branch Merge
|
|
95
|
+
|
|
96
|
+
**Symptoms:**
|
|
97
|
+
- `tbd list` crashes with “No short ID mapping found for internal ID: is-...”
|
|
98
|
+
- `tbd doctor` reports missing ID mappings
|
|
99
|
+
- Happened after merging a feature branch into main
|
|
100
|
+
|
|
101
|
+
**Causes:**
|
|
102
|
+
- Git 3-way merge can delete `.tbd/workspaces/outbox/mappings/ids.yml` when merging a
|
|
103
|
+
feature branch back to main, because main has no outbox directory and the merge treats
|
|
104
|
+
“no file” as the correct state
|
|
105
|
+
- This causes issues to exist without corresponding short ID mappings
|
|
106
|
+
- See [#99](https://github.com/jlevy/tbd/issues/99) for full details
|
|
107
|
+
|
|
108
|
+
**Prevention (v0.1.22+):**
|
|
109
|
+
- `tbd setup` creates `.tbd/.gitattributes` with `merge=union` for all `ids.yml` files,
|
|
110
|
+
which prevents git from ever deleting rows during merge
|
|
111
|
+
- The sync code includes `reconcileMappings()` which detects and repairs missing
|
|
112
|
+
mappings after merge, recovering original short IDs from git history when possible
|
|
113
|
+
|
|
114
|
+
**If you encounter this:**
|
|
115
|
+
1. Run `tbd doctor --fix` to detect and repair missing mappings
|
|
116
|
+
2. The fix will attempt to recover original short IDs from git history
|
|
117
|
+
3. If history is unavailable, new short IDs are generated
|
|
118
|
+
4. Run `tbd setup --auto` to ensure `.tbd/.gitattributes` is in place for future
|
|
119
|
+
prevention
|
|
120
|
+
|
|
94
121
|
## Workspace Issues
|
|
95
122
|
|
|
96
123
|
### Don’t gitignore .tbd/workspaces/
|