Skip to content

Commit 18d9cea

Browse files
chore(xtest): rename lmgmt to otdf-local
- Rename package from lmgmt to otdf-local - Rename Python module from lmgmt to otdf_local (PEP 8) - Update CLI command to otdf-local - Update environment variable prefix: LMGMT_* → OTDF_LOCAL_* - Update all imports and documentation - Preserve git history with git mv BREAKING CHANGE: Command changed from 'lmgmt' to 'otdf-local' Environment variables now use OTDF_LOCAL_ prefix instead of LMGMT_ Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
1 parent 400fc94 commit 18d9cea

40 files changed

Lines changed: 269 additions & 255 deletions

.github/workflows/check.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ jobs:
3232
uv run ruff format --check .
3333
uv run pyright
3434
working-directory: xtest
35-
- name: Lint lmgmt
35+
- name: Lint otdf-local
3636
run: |
3737
uv sync
3838
uv run ruff check .
3939
uv run ruff format --check .
4040
uv run pyright
41-
working-directory: lmgmt
41+
working-directory: otdf-local
4242
- name: Lint otdf-sdk-mgr
4343
run: |
4444
uv sync

AGENTS.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,8 @@ otdf-sdk-mgr install tip go # Build from source
2626

2727
```bash
2828
# Configure environment for pytest (recommended)
29-
cd tests/lmgmt
30-
eval $(uv run lmgmt env)
29+
cd tests/otdf-local
30+
eval $(uv run otdf-local env)
3131
cd ../xtest
3232

3333
# Run with specific SDK
@@ -92,11 +92,11 @@ Or ensure services are running with logs in `../../platform/logs/` (auto-discove
9292

9393
## Environment Management
9494

95-
Use `lmgmt` for all environment management (starting/stopping services, viewing logs, restart procedures, troubleshooting). See:
96-
- `lmgmt/README.md` - command reference and installation
97-
- `lmgmt/CLAUDE.md` - operational procedures (restarts, tmux navigation, golden key config, troubleshooting)
95+
Use `otdf-local` for all environment management (starting/stopping services, viewing logs, restart procedures, troubleshooting). See:
96+
- `otdf-local/README.md` - command reference and installation
97+
- `otdf-local/CLAUDE.md` - operational procedures (restarts, tmux navigation, golden key config, troubleshooting)
9898

99-
Quick start: `cd tests/lmgmt && uv run lmgmt up`
99+
Quick start: `cd tests/otdf-local && uv run otdf-local up`
100100

101101
## Key Concepts
102102

@@ -131,7 +131,7 @@ yq e -i ".services.kas.root_key = \"$PLATFORM_ROOT_KEY\"" "$CONFIG_FILE"
131131
```bash
132132
yq e -i '.services.kas.preview.ec_tdf_enabled = true' platform/opentdf.yaml
133133
yq e -i '.services.kas.preview.ec_tdf_enabled = true' platform/opentdf-dev.yaml
134-
cd tests/lmgmt && uv run lmgmt restart platform
134+
cd tests/otdf-local && uv run otdf-local restart platform
135135
```
136136

137137
### ABAC Test Failures: Decrypt Errors
@@ -146,18 +146,18 @@ curl http://localhost:8080/api/kas/v2/kas/key-access-servers | jq '.key_access_s
146146
# Expected: alpha=8181, beta=8282, gamma=8383, delta=8484
147147
```
148148

149-
**Fix**: Ensure all KAS instances are properly registered during startup (`lmgmt up` handles this).
149+
**Fix**: Ensure all KAS instances are properly registered during startup (`otdf-local up` handles this).
150150

151151
### Legacy/Golden TDF Test Failures
152152

153153
**Symptom**: "cipher: message authentication failed"
154154

155-
**Root Cause**: Golden TDFs require specific keys loaded by the platform. `lmgmt up` auto-configures these. See `lmgmt/CLAUDE.md` for manual configuration details.
155+
**Root Cause**: Golden TDFs require specific keys loaded by the platform. `otdf-local up` auto-configures these. See `otdf-local/CLAUDE.md` for manual configuration details.
156156

157157
```bash
158-
cd tests/lmgmt
159-
uv run lmgmt up # or restart platform
160-
eval $(uv run lmgmt env)
158+
cd tests/otdf-local
159+
uv run otdf-local up # or restart platform
160+
eval $(uv run otdf-local env)
161161
cd ../xtest
162162
uv run pytest test_legacy.py --sdks go -v --no-audit-logs
163163
```
@@ -182,13 +182,13 @@ export SCHEMA_FILE=/path/to/schema.json
182182
curl http://localhost:8080/api/kas/v2/kas/key-access-servers | jq
183183
curl http://localhost:8080/healthz
184184
```
185-
4. **Check service logs**: `cd tests/lmgmt && uv run lmgmt logs --grep "error" -f`
185+
4. **Check service logs**: `cd tests/otdf-local && uv run otdf-local logs --grep "error" -f`
186186
5. **Manual reproduction**:
187187
```bash
188188
sdk/go/dist/main/cli.sh encrypt test.txt test.tdf --attr https://example.com/attr/foo/value/bar
189189
sdk/go/dist/main/cli.sh decrypt test.tdf test.out.txt
190190
```
191-
6. **Fix and verify**: Make changes, restart services if needed (`lmgmt restart <service>`), re-run failing test, then run full suite
191+
6. **Fix and verify**: Make changes, restart services if needed (`otdf-local restart <service>`), re-run failing test, then run full suite
192192

193193
## Code Modification Best Practices
194194

@@ -206,7 +206,7 @@ After changes to SDK source, rebuild with `otdf-sdk-mgr install tip go` (or java
206206
### When Modifying Platform Code
207207

208208
```bash
209-
cd tests/lmgmt && uv run lmgmt restart platform
209+
cd tests/otdf-local && uv run otdf-local restart platform
210210
```
211211

212212
### When Modifying Test Code
@@ -221,7 +221,7 @@ cd tests/lmgmt && uv run lmgmt restart platform
221221

222222
- `test_tdfs.py` - Core TDF roundtrip, manifest validation, tampering tests
223223
- `test_abac.py` - ABAC policy, autoconfigure, key management tests
224-
- `test_legacy.py` - Backward compatibility with golden TDFs (requires golden-r1 key, auto-configured by lmgmt)
224+
- `test_legacy.py` - Backward compatibility with golden TDFs (requires golden-r1 key, auto-configured by otdf-local)
225225
- `test_policytypes.py` - Policy type tests (OR, AND, hierarchy)
226226
- `test_self.py` - Platform API tests (namespaces, attributes, SCS)
227227

@@ -259,18 +259,18 @@ See `otdf-sdk-mgr/README.md` for full command reference.
259259
### Preferred Workflow
260260

261261
1. **Configure SDK artifacts**: `cd tests/otdf-sdk-mgr && otdf-sdk-mgr install stable`
262-
2. **Start environment**: `cd tests/lmgmt && uv run lmgmt up`
263-
3. **Configure shell**: `eval $(uv run lmgmt env)`
262+
2. **Start environment**: `cd tests/otdf-local && uv run otdf-local up`
263+
3. **Configure shell**: `eval $(uv run otdf-local env)`
264264
4. **Run tests**: `cd ../xtest && uv run pytest --sdks go -v`
265-
5. **Restart after config changes**: `cd ../lmgmt && uv run lmgmt restart <service>`
265+
5. **Restart after config changes**: `cd ../otdf-local && uv run otdf-local restart <service>`
266266

267267
### When Debugging Test Failures
268268

269269
1. Read error messages carefully - they guide you to the root cause
270270
2. Check platform configuration matches expected test behavior
271271
3. Verify all KAS instances have consistent keys
272-
4. Ensure services are running and healthy (`lmgmt status`)
273-
5. Check service logs (`lmgmt logs <service> -f`)
272+
4. Ensure services are running and healthy (`otdf-local status`)
273+
5. Check service logs (`otdf-local logs <service> -f`)
274274
6. Reproduce issues manually when possible
275275
7. Always restart services after config changes
276276
8. Read before writing - understand existing code patterns

lmgmt/src/lmgmt/__init__.py

Lines changed: 0 additions & 3 deletions
This file was deleted.

lmgmt/src/lmgmt/__main__.py

Lines changed: 0 additions & 6 deletions
This file was deleted.

lmgmt/src/lmgmt/config/__init__.py

Lines changed: 0 additions & 6 deletions
This file was deleted.

lmgmt/src/lmgmt/health/__init__.py

Lines changed: 0 additions & 6 deletions
This file was deleted.

lmgmt/src/lmgmt/process/__init__.py

Lines changed: 0 additions & 1 deletion
This file was deleted.

lmgmt/src/lmgmt/services/__init__.py

Lines changed: 0 additions & 23 deletions
This file was deleted.

lmgmt/src/lmgmt/utils/__init__.py

Lines changed: 0 additions & 1 deletion
This file was deleted.

lmgmt/tests/__init__.py

Lines changed: 0 additions & 1 deletion
This file was deleted.

0 commit comments

Comments
 (0)