LPK-E0303 — registry of unsupported layout or without index

What it means

A registry is a directory with a fixed layout: an identity file naming the format version, descriptors under one path shape, packages under another, and a version index per package. When the format version is unknown or a layout path differs from the fixed shape, the tool cannot read the registry safely, so it refuses before trusting anything. Nothing is created or changed by the refusal.

A registry in the current format — with the version index named explicitly — is what the tool expects; older layouts name the exact version instead of listing.

Example

pkgtest

{"files": {"law.toml": "[package]\nname = \"demo.mini\"\nversion = \"0.1.0\"\nlanguage = \"0.2\"\nnamespace = \"urn:law:demo:mini\"\n", "registry.json": "{\"registryId\":\"local\",\"specVersion\":\"9.9\",\"layout\":{}}"}, "cmd": ["add", "foo", "--from", "local", "--registry", "local=.", "--project", "."], "expect": "LPK-E0303"}

Fix

pkgtest

{"files": {}, "cmd": ["init", ".", "--name", "demo.diag"]}

Engine message

The tool reports this in its own wording:

Output

law: REFUSAL LPK-E0303: registry local: unsupported specVersion Some("9.9") (0.1 and 0.2 supported)

Related

• Package, context, snapshots — what a project directory holds.