enforce @scope/name format for all variables #29

New Issue

2026-06-01T15:29:04Z

xiaoju commented

2026-06-01 15:29:04 +00:00

What

All variable names must follow @scope/name format:

Pattern: ^@[a-zA-Z][a-zA-Z0-9]*/ followed by one or more name segments
@ocas/* reserved for internal use (already enforced)
User variables: @myapp/config, @todo/schema, etc.

Why

Visually distinct from hashes (13-char Base32)
Scoped namespace prevents collisions between projects sharing a store
Consistent with @ocas/* builtin convention

Changes

Core: variable-store.ts — validate name format on set()
CLI: update var set / var delete / var tag validation (replace bare @ocas/ check with format validation)
Bootstrap: builtin names already @ocas/* — no change needed
Tests: update existing tests to use @scope/name format
Docs: update cards, README, CLAUDE.md

Rejected Names

config — no scope
@/foo — empty scope
@123/foo — scope must start with letter
foo/bar — missing @

小橘 🍊（NEKO Team）

## What All variable names must follow `@scope/name` format: - Pattern: `^@[a-zA-Z][a-zA-Z0-9]*/` followed by one or more name segments - `@ocas/*` reserved for internal use (already enforced) - User variables: `@myapp/config`, `@todo/schema`, etc. ## Why - Visually distinct from hashes (13-char Base32) - Scoped namespace prevents collisions between projects sharing a store - Consistent with `@ocas/*` builtin convention ## Changes 1. **Core**: `variable-store.ts` — validate name format on `set()` 2. **CLI**: update `var set` / `var delete` / `var tag` validation (replace bare `@ocas/` check with format validation) 3. **Bootstrap**: builtin names already `@ocas/*` — no change needed 4. **Tests**: update existing tests to use `@scope/name` format 5. **Docs**: update cards, README, CLAUDE.md ## Rejected Names - `config` — no scope - `@/foo` — empty scope - `@123/foo` — scope must start with letter - `foo/bar` — missing `@` 小橘 🍊（NEKO Team）

xiaoju referenced this issue from a commit

2026-06-01 16:12:27 +00:00

feat: enforce @scope/name format for all variable names

xiaoju referenced a pull request that will close this issue

2026-06-01 16:12:40 +00:00

feat: enforce @scope/name format for all variable names #30

xiaomo closed this issue

2026-06-01 16:15:26 +00:00

xiaoju referenced this issue from a commit

2026-06-01 16:17:49 +00:00

docs: update all docs for @scope/name variable naming convention

Sign in to join this conversation.