|
|
|
@@ -29,16 +29,17 @@ below it; an alias to any other file owns only that file. No overlap: no file
|
|
|
|
|
may be owned by 2 aliases, so no alias inside another alias's area and no 2
|
|
|
|
|
aliases with the same target. Outside an area, only the exact alias reaches
|
|
|
|
|
it; a deeper alias specifier or a relative path into the area is a bypass.
|
|
|
|
|
Inside an area, relative imports of siblings and subfolders are free. `../`
|
|
|
|
|
is banned in every file, owned or not
|
|
|
|
|
(`import/no-relative-parent-imports`). Files no alias owns need no `index.ts`
|
|
|
|
|
and no alias, and import `./` siblings and subfolders freely. The one alias
|
|
|
|
|
is `#testing` (`./src/testing/index.ts`): tests that use its helpers import
|
|
|
|
|
it by alias, and `tests/` reaches `src/` only through it. Local convention, stricter than the
|
|
|
|
|
general rule above: in this repo, aliases point only at a direct subfolder of
|
|
|
|
|
`src/` (`"#helpers": "./src/helpers/index.ts"`), and code outside `src/` uses
|
|
|
|
|
`./` relative imports. `scripts/` is flat: one file per
|
|
|
|
|
tool, no subfolders and no `index.ts`, imported directly by file path
|
|
|
|
|
Inside an area, relative imports of siblings and subfolders are free. A `../`
|
|
|
|
|
import is banned in every file, owned or not
|
|
|
|
|
(`import/no-relative-parent-imports`); runtime file URLs such as
|
|
|
|
|
`new URL("../prompt.md", import.meta.url)` are paths, not imports, and stay.
|
|
|
|
|
Files no alias owns need no `index.ts` and no alias, and import `./` siblings
|
|
|
|
|
and subfolders freely. The one alias is `#testing` (`./src/testing/index.ts`):
|
|
|
|
|
tests that use its helpers import it by alias, and `tests/` imports `src/`
|
|
|
|
|
only through it. Local convention, stricter than the general rule above: in
|
|
|
|
|
this repo, aliases point only at a direct subfolder of `src/`
|
|
|
|
|
(`"#helpers": "./src/helpers/index.ts"`), and code outside `src/` uses `./`
|
|
|
|
|
relative imports. `scripts/` is flat: one file per tool, no subfolders and no `index.ts`, imported directly by file path
|
|
|
|
|
([.agents/memory/imports-aliases-barrels.md](.agents/memory/imports-aliases-barrels.md)).
|
|
|
|
|
|
|
|
|
|
The only config files are `package.json`, `tsconfig.json`, and
|
|
|
|
|