Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .oxlintrc.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
"rules": {
"no-unused-vars": "warn",
"no-console": "off",
"no-debugger": "error",
"eqeqeq": "error",
"unicorn/number-literal-case": "error"
},
Expand Down
22 changes: 11 additions & 11 deletions context/map/artifact-1-territory.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- GENERATED by tools/repo-map/scan.mjs — do not hand-edit. Run `npm run repo-map`. -->

> Scan of `a9e4416` (2026-07-28) · window: last 12 months · engine: tools/repo-map
> Scan of `a72fd96` (2026-07-28) · window: last 12 months · engine: tools/repo-map

**Where the work actually happens.** Git-history activity over the last 12 months, noise filtered (lockfiles, generated files, assets). Activity is a signal of *risk of accidental regression*, not of quality.

Expand All @@ -11,11 +11,11 @@
| Area | Commits |
| --- | --- |
| `src/lib` | 75 |
| `context/map` | 58 |
| `context/map` | 65 |
| `context/changes` | 53 |
| `tests/e2e` | 32 |
| `package.json` | 30 |
| `src/commands` | 30 |
| `package.json` | 29 |
| `.github/workflows` | 19 |
| `context/archive` | 19 |
| `tests/get-command.test.ts` | 13 |
Expand All @@ -30,18 +30,18 @@

| File | Commits |
| --- | --- |
| `package.json` | 29 |
| `package.json` | 30 |
| `src/commands/get.ts` | 16 |
| `context/map/artifact-2-structure.md` | 14 |
| `context/map/repo-map.md` | 14 |
| `.github/workflows/ci.yml` | 14 |
| `context/map/artifact-1-territory.md` | 13 |
| `context/map/artifact-3-contributors.md` | 13 |
| `tests/get-command.test.ts` | 13 |
| `context/map/artifact-1-territory.md` | 12 |
| `context/map/artifact-2-structure.md` | 12 |
| `context/map/artifact-3-contributors.md` | 12 |
| `context/map/repo-map.md` | 12 |
| `src/lib/writer.ts` | 12 |
| `context/map/graph/coupling.json` | 9 |
| `README.md` | 9 |
| `tests/writer.test.ts` | 9 |
| `context/map/graph/coupling.json` | 8 |
| `src/lib/config.ts` | 8 |
| `src/lib/manifest.ts` | 7 |
| `src/lib/api-content.ts` | 7 |
Expand All @@ -51,10 +51,10 @@
| Area | 2026-Q2 | 2026-Q3 |
| --- | --- | --- |
| `src/lib` | 34 | 1 |
| `context/map` | 0 | 12 |
| `context/map` | 0 | 14 |
| `context/changes` | 28 | 1 |
| `tests/e2e` | 11 | 0 |
| `src/commands` | 23 | 0 |
| `package.json` | 26 | 4 |

## Co-change — areas that move together in the same commit

Expand Down
10 changes: 3 additions & 7 deletions context/map/artifact-2-structure.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- GENERATED by tools/repo-map/scan.mjs — do not hand-edit. Run `npm run repo-map`. -->

> Scan of `a9e4416` (2026-07-28) · window: last 12 months · engine: tools/repo-map
> Scan of `a72fd96` (2026-07-28) · window: last 12 months · engine: tools/repo-map

**How it is built.** Static import graph of `src` plus a file inventory of every module. Folders show where the code is; the graph shows what actually depends on what.

Expand All @@ -20,13 +20,9 @@ _None detected this run._

## Highest fan-out folders (efferent coupling Ce — depends on many)

| Folder | Ce (out) | Ca (in, lower bound) | Modules |
| --- | --- | --- | --- |
| `src/commands` | 38 | 5 | 5 |
| `src` | 24 | 0 | 25 |
| `src/lib` | 17 | 33 | 19 |
_Metrics unavailable this run (see limitations)._

## Limitations

- Afferent coupling (Ca) from dependency-cruiser is unreliable without a fully installed toolchain (external/aliased imports go unresolved). Treat Ca as a lower bound.
- dependency-cruiser not runnable — coupling metrics skipped this run.
- Static import graph only. Runtime wiring (dynamic import, template refs, feature flags, codegen) is invisible here and is an `unknown`, not "no dependency".
8 changes: 4 additions & 4 deletions context/map/artifact-3-contributors.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- GENERATED by tools/repo-map/scan.mjs — do not hand-edit. Run `npm run repo-map`. -->

> Scan of `a9e4416` (2026-07-28) · window: last 12 months · engine: tools/repo-map
> Scan of `a72fd96` (2026-07-28) · window: last 12 months · engine: tools/repo-map

**Who to ask before you change something.** Bots and AI agents (Claude, Codex, Copilot, dependabot…) are filtered out — this is about humans who hold undocumented context. Answers "who has context on this area", not "who changed this line" (that is `git blame`).

Expand All @@ -12,16 +12,16 @@
| --- | --- |
| “mkczarkowski” | 77 |
| psmyrdek | 8 |
| Marcin Czarkowski | 6 |
| Marcin Czarkowski | 7 |
| Przemek Smyrdek | 2 |

## Who to ask, per active area

| Area | Ask (commits) |
| --- | --- |
| `src/lib` | “mkczarkowski” (29), psmyrdek (4) |
| `context/map` | Marcin Czarkowski (3) |
| `context/map` | Marcin Czarkowski (4) |
| `context/changes` | “mkczarkowski” (28) |
| `tests/e2e` | “mkczarkowski” (8), psmyrdek (3) |
| `src/commands` | “mkczarkowski” (19), psmyrdek (4) |
| `package.json` | “mkczarkowski” (7), Marcin Czarkowski (1) |
| `src/commands` | “mkczarkowski” (19), psmyrdek (4) |
2 changes: 1 addition & 1 deletion context/map/graph/coupling.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"generatedFor": "a9e4416",
"generatedFor": "a72fd96",
"root": "src",
"folders": [
{
Expand Down
27 changes: 12 additions & 15 deletions context/map/repo-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- GENERATED by tools/repo-map/scan.mjs — do not hand-edit. Run `npm run repo-map`. -->

> Scan of `a9e4416` (2026-07-28) · window: last 12 months · engine: tools/repo-map
> Scan of `a72fd96` (2026-07-28) · window: last 12 months · engine: tools/repo-map
>
> Operational map of the territory, built from cheap deterministic signals (git history + import graph), synthesized for decisions — not an essay. A new developer should know in ~15 min where things live, what is dangerous, and where to start. Refresh with `npm run repo-map`.

Expand All @@ -29,11 +29,11 @@ Top active areas (full table in `artifact-1-territory.md`):
| Area | Commits |
| --- | --- |
| `src/lib` | 75 |
| `context/map` | 58 |
| `context/map` | 65 |
| `context/changes` | 53 |
| `tests/e2e` | 32 |
| `package.json` | 30 |
| `src/commands` | 30 |
| `package.json` | 29 |
| `.github/workflows` | 19 |
| `context/archive` | 19 |

Expand All @@ -54,37 +54,34 @@ Structural coupling and cycles live in `artifact-2-structure.md` and `graph/`.

## 4. Risk zones — where to be careful

| Zone | What | Why it matters (evidence) |
| --- | --- | --- |
| `src/commands` | Fan-out Ce=38 across 5 modules | Depends on many things; wide blast radius on change. (dependency-cruiser) |
| `src/lib` | Fan-out Ce=17 across 19 modules | Depends on many things; wide blast radius on change. (dependency-cruiser) |
_No high-risk zones flagged this run._

## 5. Who to ask

| Area | Ask |
| --- | --- |
| `src/lib` | “mkczarkowski” (29), psmyrdek (4) |
| `context/map` | Marcin Czarkowski (3) |
| `context/map` | Marcin Czarkowski (4) |
| `context/changes` | “mkczarkowski” (28) |
| `tests/e2e` | “mkczarkowski” (8), psmyrdek (3) |
| `src/commands` | “mkczarkowski” (19), psmyrdek (4) |
| `package.json` | “mkczarkowski” (7), Marcin Czarkowski (1) |
| `src/commands` | “mkczarkowski” (19), psmyrdek (4) |

## 6. First day — read these first

- `package.json` — 29 commits in window
- `package.json` — 30 commits in window
- `src/commands/get.ts` — 16 commits in window
- `context/map/artifact-2-structure.md` — 14 commits in window
- `context/map/repo-map.md` — 14 commits in window
- `.github/workflows/ci.yml` — 14 commits in window
- `context/map/artifact-1-territory.md` — 13 commits in window
- `context/map/artifact-3-contributors.md` — 13 commits in window
- `tests/get-command.test.ts` — 13 commits in window
- `context/map/artifact-1-territory.md` — 12 commits in window
- `context/map/artifact-2-structure.md` — 12 commits in window
- `context/map/artifact-3-contributors.md` — 12 commits in window
- `context/map/repo-map.md` — 12 commits in window

## 7. Limitations — what this map does NOT say

- It is a map of **activity and structure over the last 12 months**, not of correctness or quality.
- Afferent coupling (Ca) from dependency-cruiser is unreliable without a fully installed toolchain (external/aliased imports go unresolved). Treat Ca as a lower bound.
- dependency-cruiser not runnable — coupling metrics skipped this run.
- Static import graph only. Runtime wiring (dynamic import, template refs, feature flags, codegen) is invisible here and is an `unknown`, not "no dependency".

---
Expand Down