Handling of remote repos and mnemonics

[amhellmund]

@claude
The handling of remote repos and mnemonics is still suboptimal. Here is the target state.

• There must be at least one mnemonic per archml workspace, typically the name of the workspace.
• It is not possible to define mnemonics of the form name/subname.
• Each mnemonics must begin with a letter followed by alphanumeric letters, dashes or understores. Every letter must be lowercase. All other letters are not allowed.
• A source file always belongs to a repository.
• Imports without a @repo are resolved from the repo the archml source file belongs to.
• Model the mnemonics as a mapping from repo+mnemonic to path
• Modify the path resolution to include the repo of the archml source file for resolution.

Examples for import path

@repo/mnemonic/path/subpath/file
mnemonic/path/subpath/file

Adapt the tests.

[claude]

Claude encountered an error —— View job

---

Task Progress

• Gather context and understand the request
• Explore existing codebase (repos, mnemonics, path resolution)
• Implement mnemonic name validation in workspace/config.py (^[a-z][a-z0-9_-]*$, at least one required)
• Refactor compiler/build.py: model mnemonics as (repo, mnemonic) → path, resolve using source repo context
• Update cli/main.py: remove workspace-root "" key, scan only mnemonic directories
• Update tests/workspace/test_config.py
• Update tests/compiler/test_build.py
• Update tests/cli/test_main.py
• Run CI checks
• Commit and push

Design decisions:

• source_import_map keys: local mnemonics as "mnemonic", remote as "@repo/mnemonic" (no bare "" or "@repo" keys)
• _resolve_import_source(import_path, map, source_repo) — uses source_repo to look up source_repo/mnemonic for remote files
• All imports must have format mnemonic/path/... or @repo/mnemonic/path/...
• Workspace config must have ≥1 source-imports entry

[claude]

Claude finished @amhellmund's task in 21m 3s —— View job • claude/issue-43-20260301-2038 • Create PR ➔

---

Task Progress

• Gather context and understand the request
• Explore existing codebase (repos, mnemonics, path resolution)
• Implement mnemonic name validation in workspace/config.py (^[a-z][a-z0-9_-]*$, at least one required)
• Refactor compiler/build.py: model mnemonics as (repo, mnemonic) → path, resolve using source repo context
• Update cli/main.py: remove workspace-root "" key, scan only mnemonic directories, validate mnemonic in init
• Update tests/workspace/test_config.py
• Update tests/compiler/test_build.py
• Update tests/cli/test_main.py
• Commit and push
• CI checks (running)
  |