@venizia/vulcan 0.4.10-3 → 0.4.10-5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -11
- package/base/checks/wiki-source-links.ts +17 -1
- package/base/hooks/guard-outside.ts +4 -2
- package/base/make/vulcan.mk +1 -4
- package/base/rules.md +2 -2
- package/base/templates/board.html +10 -110
- package/package.json +3 -3
- package/src/board/command.ts +16 -1
- package/src/board/common/constants.ts +2 -0
- package/src/board/page.ts +57 -5
- package/src/board/server.ts +13 -2
- package/src/commands/graph.command.ts +6 -0
- package/src/commands/index.ts +2 -0
- package/src/commands/sync.command.ts +5 -1
- package/src/commands/table.ts +12 -0
- package/src/common/constants.ts +1 -0
- package/src/config/schema.ts +51 -26
- package/src/create/scratch.ts +2 -1
- package/src/doctor/checks.ts +96 -4
- package/src/doctor/runner.ts +2 -0
- package/src/hooks/project-guards.ts +3 -0
- package/src/hooks/project-tmp.ts +39 -4
- package/src/local/browser-socket.ts +33 -0
- package/src/local/index.ts +1 -0
- package/src/local/scan.ts +33 -9
- package/src/manifest/render.ts +22 -3
- package/src/sync/claude-launch.ts +12 -12
- package/src/sync/local-choice.ts +32 -3
- package/src/theme/tokens.ts +114 -9
- package/src/visualize/assets.ts +2 -2
- package/src/visualize/theme.ts +17 -3
- package/src/wiki/command.ts +10 -3
- package/src/wiki/source-links.ts +57 -18
package/README.md
CHANGED
|
@@ -18,24 +18,26 @@ flag `bun x` fetches it when `@venizia/vulcan` is not installed yet.
|
|
|
18
18
|
|
|
19
19
|
| Command | What it does |
|
|
20
20
|
|---|---|
|
|
21
|
-
| `init` | Scaffold the project layer: `AGENTS.md`, `.configs/vulcan.config.mts`, the two lint configs, `.agents/rules.md`, `.agents/knowledge/index.md`, `.agents/hooks/trusted-hosts.local.example`, a Makefile with the `-include` and a fallback rule for a missing `vulcan.mk`. Appends the agent entries to `.gitignore`, installs the lint tools (listing them first; a failed install exits 1), and ends with a numbered list of what is left. Needs a `package.json` in the directory. A project whose `package.json` declares `workspaces` gets no root lint configs. Never overwrites; prints what to add to existing files |
|
|
22
|
-
| `init --preset <name\|file:path> --project <name> --app <name> [--backend-dir\|--frontend-dir <name>] [--shared-dir <name>]` | Create a new monorepo with its first app from a framework preset: the root manifests, the app's files, the VULCAN layer and a knowledge bundle, then install, `git init` (a missing git is reported, not fatal), `sync` and the checks, and ends with `cd <project> && make dev` and the app's URL. A name missing from the flags is asked in a terminal; none has a default. Refuses a folder that is not empty |
|
|
21
|
+
| `init [--key <KEY>]` | Scaffold the project layer: `AGENTS.md`, `.configs/vulcan.config.mts`, the two lint configs, `.agents/rules.md`, `.agents/knowledge/index.md`, `.agents/hooks/trusted-hosts.local.example`, `.dockerignore`, `bunfig.toml`, a Makefile with the `-include` and a fallback rule for a missing `vulcan.mk`. `--key` is the project's flow key (2 to 8 uppercase letters or digits; a terminal asks, else it is made from the name); it counts only while no config exists yet. Appends the agent entries to `.gitignore`, installs the lint tools (listing them first; a failed install exits 1), and ends with a numbered list of what is left. Needs a `package.json` in the directory. A project whose `package.json` declares `workspaces` gets no root lint configs. Never overwrites; prints what to add to existing files |
|
|
22
|
+
| `init --preset <name\|file:path> --project <name> --app <name> [--backend-dir\|--frontend-dir <name>] [--shared-dir <name>] [--scope <@scope>] [--key <KEY>]` | Create a new monorepo with its first app from a framework preset: the root manifests (with `.dockerignore` and `bunfig.toml`), the app's files, the VULCAN layer and a knowledge bundle, then install, `git init` (a missing git is reported, not fatal), `sync` and the checks, and ends with `cd <project> && make dev` and the app's URL. `--scope` names the app's package `@scope/<name>`; `--key` is the flow key, as for `init`. A name missing from the flags is asked in a terminal; none has a default. Refuses a folder that is not empty |
|
|
23
23
|
| `add --preset <name\|file:path> (--app <name> \| --lib <name> \| --shared <name>) [--dir <folder>] [--scope <@scope>] [--backend-dir\|--frontend-dir <name>] [--api <app> \| --no-api]` | Add an app, a library other apps import (`--lib`) or a side-neutral shared package (`--shared`) to a monorepo `init --preset` created: registers it in `workspaces`, the `catalog`, the config and the knowledge bundle, picks a free port, then installs, syncs and checks. `--dir` is for a library or a shared package; `--scope` names the package `@scope/<name>`. A frontend says which backend app to proxy `/api` to |
|
|
24
|
-
| `sync [--dry-run]` | Write the gitignored agent adapters: `CLAUDE.md` (`@AGENTS.md`; an existing file is left alone), `.claude/settings.json` (shipped + slot + project hooks + `claude.settings` over your personal keys; what it applied is recorded in `.claude/vulcan-managed.json`, so a removed choice is removed, and a hook it wrote is taken back by its command even after you edited its entry), `.claude/skills/` links, and the committed `.agents/vulcan.manifest.json`. Prints each base rule added, changed or removed since the manifest last recorded it, with its new text, then records the new hashes. `--dry-run` writes nothing and labels each line `would create`, `would replace` or `would remove`. Idempotent |
|
|
25
|
-
| `preset diff <package
|
|
24
|
+
| `sync [--agents <list>\|list] [--dry-run]` | Write the gitignored agent adapters: `CLAUDE.md` (`@AGENTS.md`; an existing file is left alone), `.claude/settings.json` (shipped + slot + project hooks + `claude.settings` over your personal keys; what it applied is recorded in `.claude/vulcan-managed.json`, so a removed choice is removed, and a hook it wrote is taken back by its command even after you edited its entry), `.claude/skills/` links, and the committed `.agents/vulcan.manifest.json`. It also writes the adapters of the other agents you chose (`--agents claude,omp` or `none`, kept in `.agents/vulcan.local.json`; `--agents list` prints the table), the Atlas block in `AGENTS.md`, and the clone's `commit-msg` hook when a commit check is on. Prints each base rule added, changed or removed since the manifest last recorded it, with its new text, then records the new hashes. `--dry-run` writes nothing and labels each line `would create`, `would replace` or `would remove`. Idempotent |
|
|
25
|
+
| `preset diff <package> [--preset <name\|file:path>] [--api <app> \| --no-api] [--full] [--check]` | Read-only: set each file the preset makes now against the file the package has (same, differs, missing); `--preset` names the preset when it cannot be found from the package, `--api` or `--no-api` says what a frontend proxies to, `--full` prints the diffs, `--check` exits 1 on a difference |
|
|
26
26
|
| `agents [list\|add\|remove\|setup]` | See, add, remove or re-choose the coding agents you use on this machine |
|
|
27
27
|
| `doctor` | Check the project follows VULCAN; exit 1 on any violation. The checks are listed in `docs/wiki/content/references/commands/doctor.md` |
|
|
28
28
|
| `commit-check <message-file> \| --range <revs> \| --text <message>` | Check a commit message against the `commit.message` checks of the config; `sync` installs it as the `commit-msg` hook; exit 1 on a problem, 2 on bad input |
|
|
29
|
-
| `board` | Fold the event log (and GitHub pull requests, checks and reviews when `gh` can read them) into flows and write one HTML file, by default `.agents/local/reports/board.html`; read-only |
|
|
29
|
+
| `board [--out <file>] [--open] [--since <date>] [--dir <events folder>] [--repo owner/name]... [--no-github]` | Fold the event log (and GitHub pull requests, checks and reviews when `gh` can read them) into flows and write one HTML file, by default `.agents/local/reports/board.html`; read-only. `--repo` is repeatable; `--no-github` leaves GitHub out |
|
|
30
|
+
| `board serve [--port <n>] [--since <date>] [--dir <events folder>] [--repo owner/name]... [--no-github]` | Serve the same page on 127.0.0.1 (default port 4317) and push new events to the open page with no reload, until Ctrl+C |
|
|
30
31
|
| `ci affected --base <ref> \| template <github\|gitlab>` | List the workspace packages a change touches with the checks each has; `template` prints a CI file that runs exactly those |
|
|
31
32
|
| `event add \| tail` | Write a line to the agent event log (`.agents/local/events/<day>.jsonl`) or read it |
|
|
32
|
-
| `visualize <spec.json
|
|
33
|
+
| `visualize <spec.json> [--out <name>] \| --schema` | Make one small static HTML page from a JSON spec, in `.agents/local/prototypes/` (`--out` names the page); `--schema` prints the spec's schema |
|
|
33
34
|
| `profile [show\|edit\|reset]` | Tell VULCAN how you like to work (reply language, tone, habits) in `.agents/local/profile.json` |
|
|
34
35
|
| `clean [--tmp\|--worktrees\|--clones\|--cache\|--all] [--yes]` | List what an agent left under `.agents/local/` (a dry run) and, with `--yes`, remove it |
|
|
35
|
-
|
|
36
36
|
| `upgrade [--stable \| --nightly] [<version\|tag>]` | Install the target `@venizia/vulcan`, then run `sync` from the newly installed CLI. `--stable` (default) is the `latest` dist-tag, never a prerelease; `--nightly` is the higher of `latest` and `next`; a named version or tag wins over both. `--nightly` that cannot read the dist-tags exits 1; a stable upgrade from an installed prerelease says that `--nightly` keeps the prerelease line |
|
|
37
|
+
| `graph build [--full]` | Write the code graph of the project (the short name of `x atlas graph build`); `--full` reads everything again |
|
|
38
|
+
| `graph status [--json]` | Say whether the graph still matches the files it was built from (fresh, behind, diverged or unknown) |
|
|
37
39
|
| `x <tool> [args...]` | Run a shipped tool at the pinned version: `okf`, `atlas`. `x --help` prints the help; `x <tool> --help` goes to the tool |
|
|
38
|
-
| `help`, `version` | |
|
|
40
|
+
| `help`, `version` | `help` prints the usage; `version` prints the installed version |
|
|
39
41
|
|
|
40
42
|
Diagnostics go to stderr; a command that produces a result prints only that on stdout, and `vulcan x atlas mcp` is a
|
|
41
43
|
clean MCP stdio server.
|
|
@@ -58,22 +60,23 @@ export default {
|
|
|
58
60
|
} satisfies VulcanConfig;
|
|
59
61
|
```
|
|
60
62
|
|
|
61
|
-
An unknown key is an error; every error names the file and the field.
|
|
63
|
+
An unknown key is an error; every error names the file and the field. The example shows a few keys; each key, with its type and default, is in `docs/wiki/content/references/configuration/index.md`. Three that a new project often wants: `local.tmp` (a short folder for the temporary files of a session, so a browser socket path fits), `theme` (the colours, fonts and radius of the board and the pages VULCAN makes) and `board` (the owner, title, logo and agents of `vulcan board`).
|
|
62
64
|
|
|
63
65
|
## What ships (`base/`)
|
|
64
66
|
|
|
65
67
|
- `rules.md` - the base rules: write boundaries, security, process, build, and the coding style V-C-01..V-C-19 (51 rules).
|
|
66
68
|
- `slots.json` - rules a project picks a wording for (V-W-01 today).
|
|
67
|
-
- `skills/` - 12 project-neutral skills, described in `docs/wiki/content/references/skills.md` (a project-specific skill stays in its project).
|
|
69
|
+
- `skills/` - 12 project-neutral skills, described in `docs/wiki/content/references/skills.md` (a project-specific skill stays in its project). Each but `knowledge-sync` has an `evals/evals.json`; `make skill-evals` runs them against models and spends quota.
|
|
68
70
|
- `hooks/` - 16 hook files, described in `docs/wiki/content/references/hooks/index.md`.
|
|
69
71
|
- `claude/settings.json`, `make/vulcan.mk`, `templates/`.
|
|
72
|
+
- `agents.json` (the coding agents `sync` can write adapters for), `commit-agents.json` (the agent names, addresses and phrases `commit-check` looks for in a message), `ci-global.json` (the files that make `ci affected` select every package), `checks/` (the wiki link and anchor gates), `extensions/` (the guards for an agent that loads an extension, such as omp or pi) and `references/` (testing, design pass, evidence and the other pages the skills link to).
|
|
70
73
|
|
|
71
74
|
A project **extends** this: it adds rules with bare IDs (the base owns `V-`), skills, hooks and make targets, and never edits
|
|
72
75
|
or shadows a shipped one.
|
|
73
76
|
|
|
74
77
|
## `doctor` checks
|
|
75
78
|
|
|
76
|
-
`doctor` runs
|
|
79
|
+
`doctor` runs its checks in order; each is described in `docs/wiki/content/references/commands/doctor.md`.
|
|
77
80
|
|
|
78
81
|
The session-start digest prints the base write boundaries, the slot choices, the project's own rules (bold `| **W-00** |` rows and `| V-W-02, V-W-03 |` rows that elaborate base rules), the project's `<!-- minimap-shape:start -->` ... `<!-- minimap-shape:end -->` block from `.agents/rules.md` verbatim, and the `digest.oftenDropped` rules.
|
|
79
82
|
|
|
@@ -2,7 +2,23 @@
|
|
|
2
2
|
* Gate: every source path the wiki and the knowledge bundle name is tracked by git. Run from the
|
|
3
3
|
* repository root, through `make wiki-links-check WIKI_REPO=<owner/name>` or directly:
|
|
4
4
|
* bun node_modules/@venizia/vulcan/base/checks/wiki-source-links.ts --repo <owner/name>
|
|
5
|
+
* The folders it checks come from the `layout` of `.configs/vulcan.config.mts`; with no layout, the default list.
|
|
5
6
|
*/
|
|
7
|
+
import { ConfigLoader } from '../../src/config/index.ts';
|
|
6
8
|
import { runSourceLinksCommand } from '../../src/wiki/index.ts';
|
|
7
9
|
|
|
8
|
-
|
|
10
|
+
const root = process.cwd();
|
|
11
|
+
const loaded = await ConfigLoader.load({ root });
|
|
12
|
+
const note = ConfigLoader.unreadableNote({ loaded });
|
|
13
|
+
|
|
14
|
+
if (note !== undefined) {
|
|
15
|
+
console.error(`wiki-source-links: ${note}`);
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
process.exit(
|
|
19
|
+
runSourceLinksCommand({
|
|
20
|
+
args: process.argv.slice(2),
|
|
21
|
+
root,
|
|
22
|
+
layout: loaded.ok ? loaded.config.layout : undefined,
|
|
23
|
+
}),
|
|
24
|
+
);
|
|
@@ -30,6 +30,8 @@ try {
|
|
|
30
30
|
const { HookDecision } = await import('../../src/hooks/decision.ts');
|
|
31
31
|
const { OutsideGuard } = await import('../../src/hooks/guard-outside.ts');
|
|
32
32
|
const { ManifestGuard } = await import('../../src/hooks/guard-manifest.ts');
|
|
33
|
+
const { ProjectTmp } = await import('../../src/hooks/project-tmp.ts');
|
|
34
|
+
const { relative } = await import('node:path');
|
|
33
35
|
const input = ManifestGuard.parseHookInput({ text });
|
|
34
36
|
|
|
35
37
|
if (input) {
|
|
@@ -42,8 +44,8 @@ try {
|
|
|
42
44
|
if (hits.length > 0) {
|
|
43
45
|
const isScratchpad = hits.some((hit) => hit.isAgentToolScratchpad);
|
|
44
46
|
const hitLines = hits.map((hit) => ` - ${hit.message} (${hit.path})`);
|
|
45
|
-
const
|
|
46
|
-
|
|
47
|
+
const tmpFolder = relative(projectRoot, ProjectTmp.projectOf({ root: projectRoot }));
|
|
48
|
+
const places = `Scratch files go under ${tmpFolder}/<task>/ (worktrees under .agents/local/worktrees/, clones under .agents/local/clones/), never in /tmp or the home folder.`;
|
|
47
49
|
|
|
48
50
|
const isDeny = isScratchpad || outside === GuardDecisions.DENY;
|
|
49
51
|
let reason: string[];
|
package/base/make/vulcan.mk
CHANGED
|
@@ -7,7 +7,7 @@ VULCAN_BASE ?= node_modules/@venizia/vulcan/base
|
|
|
7
7
|
# The GitHub repository the wiki links point into, owner/name; the link gate checks only links into it.
|
|
8
8
|
WIKI_REPO ?=
|
|
9
9
|
|
|
10
|
-
.PHONY: vulcan-sync vulcan-doctor okf-check okf-check-strict okf-gen okf-coverage
|
|
10
|
+
.PHONY: vulcan-sync vulcan-doctor okf-check okf-check-strict okf-gen okf-coverage \
|
|
11
11
|
surface-gen surface-check atlas-symbols atlas-releases wiki-links-check wiki-anchors-check
|
|
12
12
|
|
|
13
13
|
vulcan-sync: ## Write the agent adapters, settings, skill links and manifest from the config
|
|
@@ -29,9 +29,6 @@ okf-gen: ## Regenerate the generated pages and regions of the knowledge bundle
|
|
|
29
29
|
okf-coverage: ## Report how much of the code the knowledge bundle covers
|
|
30
30
|
@$(VULCAN) x okf coverage
|
|
31
31
|
|
|
32
|
-
okf-viz: ## Build the knowledge graph view
|
|
33
|
-
@$(VULCAN) x okf viz
|
|
34
|
-
|
|
35
32
|
# The public surface: an optional API gate a project commits and checks. It reads the built .d.ts -
|
|
36
33
|
# build first.
|
|
37
34
|
surface-gen: ## Write the public API surface from the built .d.ts
|
package/base/rules.md
CHANGED
|
@@ -62,7 +62,7 @@ An ID the base drops is never reused.
|
|
|
62
62
|
| V-B-05 | **One script set for every app**, backend and frontend: `server:dev` (`NODE_ENV=development bun run src/index.ts` for a backend, `vite --config .configs/builders/vite.config.mts` for a frontend), `compile` (`bun .configs/builders/compile.ts` for a backend, `vite build --config .configs/builders/vite.config.mts` for a frontend), `typecheck` (`bun check`), `lint` (`devz lint`), `lint:fix` (`devz lint --fix`), `test` (`bun test`), `clean` (`devz clean`). The logic lives in `.configs/builders/` or in `devz`, never in the `package.json` string. No `dev`, `start`, `build`, `rebuild`, `preview` or `server:prod`. A domain extra such as `migrate:dev` is allowed on top. **An app root holds only `.configs/`, `src/`, `package.json`, `tsconfig.json` and `.env.example`**; every other config lives in `.configs/{lints,formatters,builders}/`. A library package keeps Makefile targets instead: `build`, `typecheck`, `lint`, `lint-fix`, `test`, `clean`. | SOFT - `vulcan doctor` notes an app that lacks one or carries a legacy name (info, never a failure) |
|
|
63
63
|
| V-B-06 | **Small never cuts safety.** Saving code never removes input validation, error handling, security checks or data safety: they are part of the task at any size (V-S-03, V-C-06 and V-B-04 still apply). | SOFT |
|
|
64
64
|
| V-B-07 | **Say what you skipped.** Report plainly what was not done, not checked or left as a shortcut; never let a check that did not run read as one that did. A deliberate shortcut in code is marked `// SHORTCUT: <what>, <why>, <revisit when>` so it can be found again. | SOFT - build-a-feature step 8 summary, session-start digest |
|
|
65
|
-
| V-B-08 | **Leave no trace, and none outside the project.** Everything you create while you work - scratch files, temporary files, logs, worktrees, clones of other repositories, subagent output - lives under the project's gitignored `.agents/local
|
|
65
|
+
| V-B-08 | **Leave no trace, and none outside the project.** Everything you create while you work - scratch files, temporary files, logs, worktrees, clones of other repositories, subagent output - lives under the project's gitignored `.agents/local/`, or in the folder `local.tmp` names, always inside the project (`tmp/`, `worktrees/`, `clones/`; each directory's lifetime is in the table of the rules reference) and you remove it when its lifetime ends: scratch when the task ends, a worktree when its branch is merged or abandoned, a clone when the research is reported. Nothing goes in the system temp directory, the home directory or any other place outside the project; the done report says what was removed and what was kept, and why. The scratchpad folder an agent tool offers is a system temp directory, not one of its own files: never use it, even when the tool's text says to. What a tool writes for itself (its task output, its memory) is outside this rule's reach. | SOFT |
|
|
66
66
|
| V-B-09 | **Agent scripting uses bun by default.** A script you write to do a task (an edit, a check, a report) is `bun -e '…'` or `bun file.ts`, with `Bun.file()` for files. Python or another language is allowed when the task needs it - an existing project script, a tool only that language has - and you say so in one line. | SOFT - the guard-scripting hook adds a reminder when a command runs python, python3 or pip; it never blocks |
|
|
67
67
|
|
|
68
68
|
## C - Code and writing
|
|
@@ -75,7 +75,7 @@ An ID the base drops is never reused.
|
|
|
75
75
|
| V-C-06 | **Never a silent catch - log it.** Always braces. Early return. `switch` with `default` over a long if-else chain. Strict TypeScript; no `any` where a type exists. | LINT (braces, floating promises) + SOFT |
|
|
76
76
|
| V-C-07 | **A function name opens with its verb** - `generate` `build` `to` `is` `has` `assert` `extract` `enrich` `get` `resolve`. `is*` returns a boolean and leaves the branch to the caller; `assert*` throws and returns `void`, so the code after it needs none - reach for `assert*` when every caller would throw on `false` anyway. `has*` is the ownership question (`hasBucket`, never `isBucketExists`). That list is for UTILITY functions; service methods lean on a wider set. **Arrow functions, not `function` declarations** (do not churn existing ones). State plus the operations on it live in a class with static members - the `LoggerFactory` shape - never module-level `let` plus exported arrows. | SOFT |
|
|
77
77
|
| V-C-08 | **Enumerable strings are a const class plus `TConstValue`,** never a raw string-literal union. When something validates against such a class, it carries `static readonly SCHEME_SET = new Set([...])` over its values and `static isValid(value: string): boolean` reading it, so a runtime check exists wherever a value crosses a boundary (`IsolationLevels` in connectors is the model; a subclass redeclares `SCHEME_SET` with `...Parent.SCHEME_SET` first); a class nothing validates against needs neither. The `T`/`I` prefix follows the declaration keyword: `type` gets `T`, `interface` gets `I`; an interface turned into a type alias is renamed, and no tool catches it - grep both directions. | SOFT |
|
|
78
|
-
| V-C-09 | **Comments state only a lasting fact the code cannot show** - a constraint, an external contract, a non-obvious invariant; one to three lines; no history, no dates, no decision or review notes, no restating the code. An exported declaration
|
|
78
|
+
| V-C-09 | **Comments state only a lasting fact the code cannot show** - a constraint, an external contract, a non-obvious invariant; one to three lines; no history, no dates, no decision or review notes, no restating the code. An exported declaration may carry TSDoc when it tells the reader what the name and the types do not: a summary first, `@param`/`@returns` without `{type}`, `@default`, `@deprecated` with what replaces it, `@example` when use is not obvious, on the declaration itself; it stays within the three-line limit except an `@example`. Write it when you write or change that export, never as a sweep; a TSDoc that no longer matches the code is wrong and is fixed in the same change. Machine directives stay. The one other exception is the `// SHORTCUT:` marker of V-B-07. Most code needs none; remove a meaningless comment in the lines you touch. | SOFT |
|
|
79
79
|
| V-C-10 | **No explicit cast in new code.** `as X`, `as any`, `as unknown as X` and `as never` assert nothing; they silence the compiler where the type is wrong. Fix the type instead: a generic on the setter, a narrower parameter, a typed helper, `satisfies`. A pre-existing cast is removed when the line is touched, never copied. Generic parameters are full words (`ApplicationType`, `TDocument`), never `App` or `TDoc` (V-C-04). | SOFT |
|
|
80
80
|
| V-C-11 | **SIMPLE FIRST, in code and in prose.** Fewest concepts, plainest words, smallest surface. Complexity must buy correctness, speed or safety the simple version cannot, and the artifact says what it bought. Something a reader cannot follow in one pass is a defect even when it works. Fix the root cause with the smallest change; never layer an abstraction on a misdiagnosed problem. Small means the code holds only what the task needs - not golfed: no clever one-liners to save lines, and no code for a need nobody has yet. | SOFT |
|
|
81
81
|
| V-C-12 | **Consistent, never self-invented.** Before writing anything new - a constant, file, binding key, error shape - find the nearest precedent in this repo and copy its shape. Binding keys are namespaced (`controllers.X`, `services.X`, `repositories.X`, `datasources.X`). Every scope is one folder with nested `common/{types,constants}.ts` and an index barrel (`inversion` is the model). A second style for something that already has one is a defect. | SOFT |
|