@nurix/etna 0.19.66 → 0.19.68
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/bin/etna.js +10 -1
- package/data/harness-index.json +1 -5
- package/data/harnesses/code/CLAUDE.md +2 -0
- package/data/harnesses/code/agents/maintenance.md +4 -1
- package/data/harnesses/code/harness.json +7 -2
- package/data/harnesses/code/hooks/awareness.mjs +69 -0
- package/data/harnesses/code/hooks/compliance.mjs +2 -14
- package/data/harnesses/code/hooks/lib/approved.mjs +30 -0
- package/data/harnesses/code/hooks/lib/frozen.mjs +3 -0
- package/data/harnesses/code/hooks/lib/ownership.mjs +3 -1
- package/data/harnesses/code/skills/documentation/references/frontmatter.md +1 -1
- package/data/harnesses/code/skills/documentation/scripts/doc-lint.mjs +1 -1
- package/data/harnesses/code/skills/documentation/templates/Readme.md +2 -0
- package/data/harnesses/code/skills/documentation/templates/structure.md +1 -0
- package/data/harnesses/delivery/agents/maintenance.md +4 -1
- package/data/harnesses/delivery/harness.json +2 -2
- package/data/harnesses/delivery/skills/documentation/references/frontmatter.md +1 -1
- package/data/harnesses/delivery/skills/documentation/scripts/doc-lint.mjs +1 -1
- package/data/harnesses/delivery/skills/documentation/templates/Readme.md +2 -0
- package/data/harnesses/delivery/skills/documentation/templates/structure.md +1 -0
- package/data/harnesses/etna/agents/maintenance.md +4 -1
- package/data/harnesses/etna/harness.json +2 -2
- package/data/harnesses/etna/skills/documentation/references/frontmatter.md +1 -1
- package/data/harnesses/etna/skills/documentation/scripts/doc-lint.mjs +1 -1
- package/data/harnesses/etna/skills/documentation/templates/Readme.md +2 -0
- package/data/harnesses/etna/skills/documentation/templates/structure.md +1 -0
- package/lib/install/materialize.mjs +51 -57
- package/package.json +2 -2
- package/data/harnesses/apollo/.mcp.json +0 -8
- package/data/harnesses/apollo/.prettierignore +0 -29
- package/data/harnesses/apollo/.prettierrc.json +0 -3
- package/data/harnesses/apollo/.vscode/settings.json +0 -19
- package/data/harnesses/apollo/CLAUDE.md +0 -162
- package/data/harnesses/apollo/agents/bookkeeper.md +0 -28
- package/data/harnesses/apollo/agents/brainstorm.md +0 -144
- package/data/harnesses/apollo/agents/change-review.md +0 -251
- package/data/harnesses/apollo/agents/lld-mode.md +0 -58
- package/data/harnesses/apollo/agents/maintenance.md +0 -234
- package/data/harnesses/apollo/agents/performance-review.md +0 -223
- package/data/harnesses/apollo/agents/retro.md +0 -46
- package/data/harnesses/apollo/codex/agents/bookkeeper.toml +0 -26
- package/data/harnesses/apollo/codex/agents/brainstorm.toml +0 -142
- package/data/harnesses/apollo/codex/agents/change-review.toml +0 -249
- package/data/harnesses/apollo/codex/agents/lld-mode.toml +0 -52
- package/data/harnesses/apollo/codex/agents/maintenance.toml +0 -228
- package/data/harnesses/apollo/codex/agents/performance-review.toml +0 -222
- package/data/harnesses/apollo/codex/agents/retro.toml +0 -45
- package/data/harnesses/apollo/harness.json +0 -19
- package/data/harnesses/apollo/hooks/approved-packages.md +0 -44
- package/data/harnesses/apollo/hooks/awareness.mjs +0 -405
- package/data/harnesses/apollo/hooks/check-bookkeeping-clean.mjs +0 -19
- package/data/harnesses/apollo/hooks/check-changelog-presence.mjs +0 -57
- package/data/harnesses/apollo/hooks/check-completion-integrity.mjs +0 -71
- package/data/harnesses/apollo/hooks/check-ownership.mjs +0 -22
- package/data/harnesses/apollo/hooks/compliance.mjs +0 -457
- package/data/harnesses/apollo/hooks/hooks.json +0 -23
- package/data/harnesses/apollo/hooks/lib/frozen.mjs +0 -58
- package/data/harnesses/apollo/hooks/lib/ownership.mjs +0 -242
- package/data/harnesses/apollo/hooks/lib/state.mjs +0 -170
- package/data/harnesses/apollo/rules/changelog.md +0 -27
- package/data/harnesses/apollo/rules/database.md +0 -34
- package/data/harnesses/apollo/rules/frontend.md +0 -30
- package/data/harnesses/apollo/rules/general.md +0 -40
- package/data/harnesses/apollo/rules/nomenclature.md +0 -30
- package/data/harnesses/apollo/rules/pnpm.md +0 -57
- package/data/harnesses/apollo/rules/testing.md +0 -64
- package/data/harnesses/apollo/skills/boundary/SKILL.md +0 -75
- package/data/harnesses/apollo/skills/boundary/references/index.md +0 -16
- package/data/harnesses/apollo/skills/boundary/references/mechanisms.md +0 -99
- package/data/harnesses/apollo/skills/boundary/references/packs/async-messaging.md +0 -81
- package/data/harnesses/apollo/skills/boundary/references/packs/auth.md +0 -93
- package/data/harnesses/apollo/skills/boundary/references/packs/build-config-runtime.md +0 -93
- package/data/harnesses/apollo/skills/boundary/references/packs/cloudflare.md +0 -93
- package/data/harnesses/apollo/skills/boundary/references/packs/frontend.md +0 -93
- package/data/harnesses/apollo/skills/boundary/references/packs/generic-tail.md +0 -55
- package/data/harnesses/apollo/skills/boundary/references/packs/persistence.md +0 -93
- package/data/harnesses/apollo/skills/boundary/references/packs/wire-api.md +0 -87
- package/data/harnesses/apollo/skills/brainstorm/README.md +0 -56
- package/data/harnesses/apollo/skills/brainstorm/SKILL.md +0 -173
- package/data/harnesses/apollo/skills/brainstorm/references/doctrine.md +0 -98
- package/data/harnesses/apollo/skills/brainstorm/references/harvest.md +0 -86
- package/data/harnesses/apollo/skills/brainstorm/references/session-schema.md +0 -186
- package/data/harnesses/apollo/skills/brainstorm/scripts/detector.mjs +0 -460
- package/data/harnesses/apollo/skills/design/SKILL.md +0 -121
- package/data/harnesses/apollo/skills/design/components/charts.md +0 -76
- package/data/harnesses/apollo/skills/design/components/collections.md +0 -132
- package/data/harnesses/apollo/skills/design/components/feedback.md +0 -47
- package/data/harnesses/apollo/skills/design/components/hooks.md +0 -35
- package/data/harnesses/apollo/skills/design/components/index.md +0 -143
- package/data/harnesses/apollo/skills/design/components/inputs.md +0 -327
- package/data/harnesses/apollo/skills/design/components/layout.md +0 -52
- package/data/harnesses/apollo/skills/design/components/media.md +0 -66
- package/data/harnesses/apollo/skills/design/components/motion.md +0 -82
- package/data/harnesses/apollo/skills/design/components/navigation.md +0 -29
- package/data/harnesses/apollo/skills/design/components/overlays.md +0 -72
- package/data/harnesses/apollo/skills/design/components/setup.md +0 -40
- package/data/harnesses/apollo/skills/design/components/typography.md +0 -46
- package/data/harnesses/apollo/skills/design/components/utils.md +0 -37
- package/data/harnesses/apollo/skills/design/data/blueprints/browse.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/creation-flow.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/dashboard.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/grid.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/queue.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/record-detail.md +0 -38
- package/data/harnesses/apollo/skills/design/data/blueprints/settings.md +0 -38
- package/data/harnesses/apollo/skills/design/data/charts/census.csv +0 -58
- package/data/harnesses/apollo/skills/design/data/checklists/browse.md +0 -21
- package/data/harnesses/apollo/skills/design/data/checklists/creation-flow.md +0 -20
- package/data/harnesses/apollo/skills/design/data/checklists/dashboard.md +0 -21
- package/data/harnesses/apollo/skills/design/data/checklists/grid.md +0 -21
- package/data/harnesses/apollo/skills/design/data/checklists/queue.md +0 -21
- package/data/harnesses/apollo/skills/design/data/checklists/record-detail.md +0 -21
- package/data/harnesses/apollo/skills/design/data/checklists/settings.md +0 -21
- package/data/harnesses/apollo/skills/design/data/chrome/board-column.md +0 -68
- package/data/harnesses/apollo/skills/design/data/chrome/data-table.md +0 -63
- package/data/harnesses/apollo/skills/design/data/chrome/side-panel.md +0 -60
- package/data/harnesses/apollo/skills/design/data/chrome/sidebar.md +0 -78
- package/data/harnesses/apollo/skills/design/data/chrome/stat-cards.md +0 -62
- package/data/harnesses/apollo/skills/design/data/chrome/topbar.md +0 -65
- package/data/harnesses/apollo/skills/design/data/elevation/ant-design-directional-shadow.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/apple-liquid-glass-material.md +0 -18
- package/data/harnesses/apollo/skills/design/data/elevation/atlassian-surface-shadow-pairing.md +0 -20
- package/data/harnesses/apollo/skills/design/data/elevation/fluent-2-key-ambient-ramp.md +0 -20
- package/data/harnesses/apollo/skills/design/data/elevation/github-primer-sparing-shadow.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/ibm-carbon-layer-and-border.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/linear-dark-surface-ladder.md +0 -17
- package/data/harnesses/apollo/skills/design/data/elevation/material-2-key-ambient-dp-ramp.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/material-3-tonal-elevation.md +0 -21
- package/data/harnesses/apollo/skills/design/data/elevation/neobrutalist-hard-offset.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/neumorphic-soft-dual-shadow.md +0 -18
- package/data/harnesses/apollo/skills/design/data/elevation/notion-warm-minimal-hairline.md +0 -17
- package/data/harnesses/apollo/skills/design/data/elevation/polaris-elevation-inset-bevel.md +0 -21
- package/data/harnesses/apollo/skills/design/data/elevation/radix-themes-alpha-ring-scale.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/shadcn-neutral-derived-radius.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/stripe-brand-tinted-dual-shadow.md +0 -18
- package/data/harnesses/apollo/skills/design/data/elevation/tailwind-default-utility-scale.md +0 -19
- package/data/harnesses/apollo/skills/design/data/elevation/vercel-geist-shadow-as-border.md +0 -20
- package/data/harnesses/apollo/skills/design/data/iconography.md +0 -199
- package/data/harnesses/apollo/skills/design/data/motion/accordion-expand.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/destructive-hold-confirm.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/drag-dismiss-momentum.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/empty-state-arrive.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/hover-lift.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/modal-center-arrive.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/number-ticker-roll.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/onboarding-bounce.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/panel-slide.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/press-feedback.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/progress-linear-loop.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/route-crossfade.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/rubber-band-overscroll.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/skeleton-shimmer.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/stagger-arrive.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/toast-enter-stack.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/tooltip-chain-instant.md +0 -18
- package/data/harnesses/apollo/skills/design/data/motion/trigger-anchored-reveal.md +0 -18
- package/data/harnesses/apollo/skills/design/data/tells.csv +0 -34
- package/data/harnesses/apollo/skills/design/data/voices/bright-collaborator.md +0 -29
- package/data/harnesses/apollo/skills/design/data/voices/direct-operator.md +0 -29
- package/data/harnesses/apollo/skills/design/data/voices/earnest-helper.md +0 -29
- package/data/harnesses/apollo/skills/design/data/voices/editorial-composed.md +0 -29
- package/data/harnesses/apollo/skills/design/data/voices/quiet-concierge.md +0 -29
- package/data/harnesses/apollo/skills/design/data/voices/warm-guide.md +0 -29
- package/data/harnesses/apollo/skills/design/references/compose.md +0 -23
- package/data/harnesses/apollo/skills/design/references/content.md +0 -28
- package/data/harnesses/apollo/skills/design/references/emission.md +0 -21
- package/data/harnesses/apollo/skills/design/references/existing-apps.md +0 -27
- package/data/harnesses/apollo/skills/design/references/foundations.md +0 -57
- package/data/harnesses/apollo/skills/design/references/intake.md +0 -40
- package/data/harnesses/apollo/skills/design/references/object-pass.md +0 -24
- package/data/harnesses/apollo/skills/design/references/ship-gate.md +0 -29
- package/data/harnesses/apollo/skills/design/references/ux-patterns/Readme.md +0 -195
- package/data/harnesses/apollo/skills/design/references/ux-patterns/ai-layer.md +0 -49
- package/data/harnesses/apollo/skills/design/references/ux-patterns/attributes-lifecycle.md +0 -43
- package/data/harnesses/apollo/skills/design/references/ux-patterns/container-choice.md +0 -44
- package/data/harnesses/apollo/skills/design/references/ux-patterns/creation-paths.md +0 -46
- package/data/harnesses/apollo/skills/design/references/ux-patterns/dashboards.md +0 -42
- package/data/harnesses/apollo/skills/design/references/ux-patterns/modes.md +0 -42
- package/data/harnesses/apollo/skills/design/references/ux-patterns/object-model.md +0 -46
- package/data/harnesses/apollo/skills/design/references/ux-patterns/page-archetype.md +0 -48
- package/data/harnesses/apollo/skills/design/references/ux-patterns/promotion-demotion.md +0 -37
- package/data/harnesses/apollo/skills/design/references/ux-patterns/settings.md +0 -42
- package/data/harnesses/apollo/skills/design/references/ux-patterns/standard-pages.md +0 -46
- package/data/harnesses/apollo/skills/design/references/ux-patterns/state-matrix.md +0 -41
- package/data/harnesses/apollo/skills/design/references/ux-patterns/table-mechanics.md +0 -48
- package/data/harnesses/apollo/skills/design/references/ux-patterns/verbs.md +0 -45
- package/data/harnesses/apollo/skills/design/references/ux-patterns/viewer-context.md +0 -40
- package/data/harnesses/apollo/skills/design/scripts/README-validator.md +0 -27
- package/data/harnesses/apollo/skills/design/scripts/select-chart.mjs +0 -622
- package/data/harnesses/apollo/skills/design/scripts/validate-design-md.mjs +0 -1198
- package/data/harnesses/apollo/skills/documentation/SKILL.md +0 -135
- package/data/harnesses/apollo/skills/documentation/references/examples.md +0 -279
- package/data/harnesses/apollo/skills/documentation/references/frontmatter.md +0 -44
- package/data/harnesses/apollo/skills/documentation/references/instruction-style.md +0 -50
- package/data/harnesses/apollo/skills/documentation/references/style-guide.md +0 -384
- package/data/harnesses/apollo/skills/documentation/references/untemplated.md +0 -38
- package/data/harnesses/apollo/skills/documentation/scripts/doc-lint.mjs +0 -140
- package/data/harnesses/apollo/skills/documentation/templates/Readme.md +0 -35
- package/data/harnesses/apollo/skills/documentation/templates/api-reference.md +0 -20
- package/data/harnesses/apollo/skills/documentation/templates/architecture-decision.md +0 -121
- package/data/harnesses/apollo/skills/documentation/templates/backlog.md +0 -33
- package/data/harnesses/apollo/skills/documentation/templates/behavioral-checklist.md +0 -81
- package/data/harnesses/apollo/skills/documentation/templates/bookkeeping.md +0 -18
- package/data/harnesses/apollo/skills/documentation/templates/changelog-entry.md +0 -57
- package/data/harnesses/apollo/skills/documentation/templates/changelog-index.md +0 -41
- package/data/harnesses/apollo/skills/documentation/templates/docs-readme.md +0 -72
- package/data/harnesses/apollo/skills/documentation/templates/domain-model.md +0 -30
- package/data/harnesses/apollo/skills/documentation/templates/environment-registry.md +0 -15
- package/data/harnesses/apollo/skills/documentation/templates/feature.md +0 -150
- package/data/harnesses/apollo/skills/documentation/templates/glossary.md +0 -11
- package/data/harnesses/apollo/skills/documentation/templates/implementation-map.md +0 -42
- package/data/harnesses/apollo/skills/documentation/templates/journal.md +0 -13
- package/data/harnesses/apollo/skills/documentation/templates/memory-main.md +0 -25
- package/data/harnesses/apollo/skills/documentation/templates/migration-runbook.md +0 -34
- package/data/harnesses/apollo/skills/documentation/templates/non-goals.md +0 -11
- package/data/harnesses/apollo/skills/documentation/templates/operations-procedure.md +0 -36
- package/data/harnesses/apollo/skills/documentation/templates/plan.md +0 -88
- package/data/harnesses/apollo/skills/documentation/templates/protected-files.md +0 -37
- package/data/harnesses/apollo/skills/documentation/templates/root-readme.md +0 -104
- package/data/harnesses/apollo/skills/documentation/templates/security-overview.md +0 -27
- package/data/harnesses/apollo/skills/documentation/templates/structure.md +0 -65
- package/data/harnesses/apollo/skills/documentation/templates/system-overview.md +0 -32
- package/data/harnesses/apollo/skills/documentation/templates/testing-strategy.md +0 -29
- package/data/harnesses/apollo/skills/schema-design/SKILL.md +0 -141
- package/data/harnesses/apollo/skills/test/SKILL.md +0 -104
- package/data/harnesses/apollo/skills/testing/SKILL.md +0 -166
- package/data/harnesses/apollo/skills/workflow-mapper/SKILL.md +0 -451
- package/data/harnesses/apollo/skills/workflow-mapper/references/patterns.md +0 -214
- /package/data/harnesses/{apollo → code}/docs/README.md +0 -0
- /package/data/harnesses/{apollo → code}/docs/history/CHANGELOG.md +0 -0
- /package/data/harnesses/{apollo → code}/docs/history/backlog.md +0 -0
- /package/data/harnesses/{apollo → code}/docs/memory/main.md +0 -0
- /package/data/harnesses/{apollo → code}/docs/structure.md +0 -0
- /package/data/harnesses/{apollo → code}/rules/cloudflare.md +0 -0
|
@@ -1,222 +0,0 @@
|
|
|
1
|
-
# dropped Claude tools: Read, Glob, Grep, Bash
|
|
2
|
-
name = "performance-review"
|
|
3
|
-
description = "Combined dependency + code health audit. Part A audits the dependency supply chain — security CVEs, outdated packages, license compliance, abandoned packages, unwanted transitive dependencies, install size. Part B audits code-level health — bundle size, tree-shaking issues, performance anti-patterns, code-quality flags. Run weekly or before releases. Merges the former `dep-health` and `review` agents so the package tree and the code that uses it are audited together."
|
|
4
|
-
developer_instructions = '''
|
|
5
|
-
|
|
6
|
-
# Performance-Review Agent
|
|
7
|
-
|
|
8
|
-
You audit project health on two fronts that reinforce each other: the **dependency supply chain** (Part A) and the **code that consumes it** (Part B). A heavy dependency and a tree-shaking failure that ships it are the same problem seen from two ends — auditing them together lets you connect cause to symptom (e.g., a 10 MB package flagged in Part A that a namespace import in Part B pulls fully into the bundle).
|
|
9
|
-
|
|
10
|
-
## Before Starting
|
|
11
|
-
|
|
12
|
-
1. If `./docs/memory/performance-review.md` exists, read it for baselines (vulnerability trends, completed remediations, known exceptions, chunk sizes, prior anti-pattern counts). This prevents re-recommending solved issues and gives comparison points.
|
|
13
|
-
2. Read `./package.json` for direct dependencies, entry points, and scripts.
|
|
14
|
-
3. Detect the package manager by checking for lockfiles: `pnpm-lock.yaml` (pnpm), `package-lock.json` (npm), `yarn.lock` (yarn). Use the matching commands throughout.
|
|
15
|
-
4. If `.claude/rules/general.instructions.md` (or `.claude/rules/general.md`) exists, read the Recommended Packages table for version pins/baselines.
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
# Part A — Dependency Health
|
|
20
|
-
|
|
21
|
-
## Step 1: Security Vulnerabilities
|
|
22
|
-
|
|
23
|
-
Run the audit command for the detected PM:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
# pnpm
|
|
27
|
-
pnpm audit --json 2>/dev/null || pnpm audit
|
|
28
|
-
|
|
29
|
-
# npm
|
|
30
|
-
npm audit --json 2>/dev/null || npm audit
|
|
31
|
-
|
|
32
|
-
# yarn
|
|
33
|
-
yarn npm audit --json 2>/dev/null || yarn audit
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Parse results by severity (critical, high, moderate, low). For each critical/high CVE report:
|
|
37
|
-
|
|
38
|
-
- Package name and installed version
|
|
39
|
-
- CVE ID
|
|
40
|
-
- Affected version range
|
|
41
|
-
- Fixed version (if available)
|
|
42
|
-
- Which direct dependency pulls it in
|
|
43
|
-
|
|
44
|
-
Compare against the previous scan in `docs/memory/performance-review.md` — flag new vulnerabilities since last audit.
|
|
45
|
-
|
|
46
|
-
## Step 2: Outdated Dependencies
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
pnpm outdated --format json 2>/dev/null || pnpm outdated
|
|
50
|
-
# or: npm outdated --json
|
|
51
|
-
# or: yarn outdated
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Classify into:
|
|
55
|
-
|
|
56
|
-
- **Major behind** (2+ majors) — highest risk
|
|
57
|
-
- **Minor behind** — moderate risk
|
|
58
|
-
- **Patch behind** — low risk
|
|
59
|
-
|
|
60
|
-
Cross-reference against the Recommended Packages table in the project rules — flag packages where the installed version is behind the pinned version. Report the top 10 most outdated by semver distance.
|
|
61
|
-
|
|
62
|
-
## Step 3: License Compliance
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
pnpm licenses list --json 2>/dev/null || pnpm licenses list
|
|
66
|
-
# npm: npx license-checker --json
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
Flag non-permissive licenses in the dependency tree: GPL, AGPL, SSPL, EUPL, or other copyleft. For each: package name, license type, direct or transitive.
|
|
70
|
-
|
|
71
|
-
## Step 4: Abandoned Packages
|
|
72
|
-
|
|
73
|
-
For each direct dependency, check npm registry metadata:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
npm view {package} time --json 2>/dev/null
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
Flag packages with no publish in 18+ months. Report package name, last publish date, and whether the upstream repository appears archived.
|
|
80
|
-
|
|
81
|
-
## Step 5: Unwanted Transitive Dependencies
|
|
82
|
-
|
|
83
|
-
Check for known-bloat packages in the dependency tree:
|
|
84
|
-
|
|
85
|
-
- `moment` (use date-fns instead)
|
|
86
|
-
- `lodash` (use subpath imports)
|
|
87
|
-
- `underscore`
|
|
88
|
-
- `request` (deprecated)
|
|
89
|
-
- `node-fetch` (when runtime has native fetch)
|
|
90
|
-
|
|
91
|
-
For each found:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
pnpm why {package}
|
|
95
|
-
# or: npm ls {package}
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
Report which direct dependency pulls it in and the installed size. Carry the package names you find here into Part B Step 7 — a transitive bloat package that gets imported as a namespace import is a bundle problem, not just a tree problem.
|
|
99
|
-
|
|
100
|
-
## Step 6: Dependency Size Impact
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
du -sh node_modules/.pnpm/*/ 2>/dev/null | sort -rh | head -15
|
|
104
|
-
# or for npm: du -sh node_modules/*/ | sort -rh | head -15
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
List the 15 largest packages by installed size. Flag any single package over 10 MB. Compare against the previous snapshot.
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
# Part B — Code Health
|
|
112
|
-
|
|
113
|
-
## Step 7: Bundle Size Analysis
|
|
114
|
-
|
|
115
|
-
1. Run the build (`pnpm build` / `npm run build` / `yarn build` per detected PM) to generate the production bundle
|
|
116
|
-
2. Parse build output to extract chunk sizes (raw and gzip)
|
|
117
|
-
3. Identify the top 10 largest chunks by raw size
|
|
118
|
-
4. Compare against known baselines in `docs/memory/performance-review.md`
|
|
119
|
-
5. Flag any chunk that grew >50 KB since last review
|
|
120
|
-
|
|
121
|
-
### Common bundle-bloat patterns
|
|
122
|
-
|
|
123
|
-
Search for anti-patterns that defeat tree-shaking:
|
|
124
|
-
|
|
125
|
-
- `import * as` namespace imports from large libraries (lucide-react, lodash, etc.)
|
|
126
|
-
- Dynamic string-based icon/component resolution (`Icons[name]`, `Components[type]`)
|
|
127
|
-
- Barrel file re-exports pulling in unused code
|
|
128
|
-
- Missing `React.lazy()` for heavy components (Monaco, Uppy, D3, Plotly, Mermaid)
|
|
129
|
-
- Full library imports where subpath imports exist (`import _ from 'lodash'` vs `import get from 'lodash/get'`)
|
|
130
|
-
|
|
131
|
-
```bash
|
|
132
|
-
# Find namespace imports from large libraries
|
|
133
|
-
grep -rn "import \* as" src/ --include="*.jsx" --include="*.tsx" --include="*.js" --include="*.ts"
|
|
134
|
-
|
|
135
|
-
# Find dynamic component/icon resolution
|
|
136
|
-
grep -rn "Icons\[" src/ --include="*.jsx" --include="*.tsx"
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
## Step 8: Performance Anti-Patterns
|
|
140
|
-
|
|
141
|
-
Scan for React performance issues:
|
|
142
|
-
|
|
143
|
-
### Missing memoization
|
|
144
|
-
|
|
145
|
-
- Components rendering large lists without `React.memo`
|
|
146
|
-
- Expensive computations without `useMemo`
|
|
147
|
-
- Callback props without `useCallback` causing child re-renders
|
|
148
|
-
- Focus on components in tables, lists, grids, repeated rows
|
|
149
|
-
|
|
150
|
-
### Request waterfalls
|
|
151
|
-
|
|
152
|
-
- Sequential `await` calls that could be `Promise.all`
|
|
153
|
-
- `useEffect` chains where one fetch triggers another
|
|
154
|
-
- Component trees where parent fetches block child renders
|
|
155
|
-
|
|
156
|
-
### Missing virtualization
|
|
157
|
-
|
|
158
|
-
- Lists rendering >50 items without react-window or similar
|
|
159
|
-
- Tables with unbounded row counts
|
|
160
|
-
- Grids without lazy loading
|
|
161
|
-
|
|
162
|
-
## Step 9: Import Health
|
|
163
|
-
|
|
164
|
-
1. Check for circular dependencies using import chains
|
|
165
|
-
2. Identify unused exports (files exporting functions not imported elsewhere)
|
|
166
|
-
|
|
167
|
-
## Step 10: Code-Quality Flags
|
|
168
|
-
|
|
169
|
-
- `dangerouslySetInnerHTML` usage without sanitization context
|
|
170
|
-
- `// TODO` and `// FIXME` comments older than 30 days
|
|
171
|
-
- `console.log` / `console.warn` / `console.error` left in production code
|
|
172
|
-
- Hardcoded API URLs, credentials, or environment-specific values
|
|
173
|
-
- Missing error boundaries around async components
|
|
174
|
-
|
|
175
|
-
```bash
|
|
176
|
-
grep -rn "console\.\(log\|warn\|error\)" src/ --include="*.jsx" --include="*.tsx" --include="*.js" --include="*.ts" | grep -v "// eslint"
|
|
177
|
-
grep -rn "TODO\|FIXME\|HACK\|XXX" src/ --include="*.jsx" --include="*.tsx" --include="*.js" --include="*.ts"
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
---
|
|
181
|
-
|
|
182
|
-
## Step 11: Report & Track
|
|
183
|
-
|
|
184
|
-
### Report format
|
|
185
|
-
|
|
186
|
-
**Dependencies**
|
|
187
|
-
|
|
188
|
-
- **Vulnerabilities**: critical/high CVEs, new since last audit
|
|
189
|
-
- **Outdated**: top outdated packages by semver distance
|
|
190
|
-
- **Licenses**: non-permissive license flags
|
|
191
|
-
- **Abandoned**: packages with no recent publishes
|
|
192
|
-
- **Transitive bloat**: unwanted packages pulled in transitively
|
|
193
|
-
- **Dependency size**: largest installed packages
|
|
194
|
-
|
|
195
|
-
**Code**
|
|
196
|
-
|
|
197
|
-
- **Bundle size**: total vendor size, top offenders, growth since last review
|
|
198
|
-
- **Tree-shaking issues**: namespace imports, barrel-file problems (cross-referenced with the heavy/bloat packages from Part A)
|
|
199
|
-
- **Performance**: missing memoization, request waterfalls, missing virtualization
|
|
200
|
-
- **Code quality**: console statements, TODOs, hardcoded values
|
|
201
|
-
|
|
202
|
-
**Recommendations**: a single prioritized list spanning both fronts, with estimated impact. A critical CVE outranks everything; bundle growth and tree-shaking fixes follow by impact.
|
|
203
|
-
|
|
204
|
-
### Update tracking
|
|
205
|
-
|
|
206
|
-
1. Write a snapshot to `docs/memory/performance-review.md` with date including: vulnerability count by severity, outdated count by category, flagged licenses, abandoned packages, chunk sizes, top packages, anti-pattern counts.
|
|
207
|
-
2. Append new items to `docs/history/backlog.md`:
|
|
208
|
-
- `- **[P0]** Critical CVE in \`{package}\`: {CVE-ID} — discovered by performance-review`
|
|
209
|
-
- `- **[P2]** Abandoned dependency: \`{package}\` (last published {date}) — discovered by performance-review`
|
|
210
|
-
- `- **[P2]** Bundle grew by 80KB in chunk \`{name}\` — discovered by performance-review`
|
|
211
|
-
3. Report summary to the user
|
|
212
|
-
|
|
213
|
-
## Rules
|
|
214
|
-
|
|
215
|
-
- Read-only for source code — never modify `src/` files
|
|
216
|
-
- Never run `npm install`, `pnpm install`, `yarn install`, or any command that modifies dependencies
|
|
217
|
-
- May write to `docs/memory/performance-review.md` and `docs/history/backlog.md`
|
|
218
|
-
- Be specific: include package names, byte sizes, CVE IDs, version numbers, file paths, line numbers
|
|
219
|
-
- Prioritize by impact — a critical CVE matters more than a patch update; trends matter more than absolutes when baselines exist
|
|
220
|
-
- If a command isn't available or applicable (e.g., audit unsupported, build fails on a non-JS project), skip that step and note it in the report
|
|
221
|
-
- A clean report is valid — do not invent issues
|
|
222
|
-
'''
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
# dropped Claude tools: Read, Glob, Grep, Bash, Write, Edit
|
|
2
|
-
name = "retro"
|
|
3
|
-
description = "Session-distillation agent for the changelog. Reads the per-unit-of-work entries under `docs/history/changelog/` accumulated since its last run and distills the refinement delta — what user-driven iteration added that the one-shot build lacked — into a typed punch list of doc-content gaps, doc-structure moves (missing doc / mothership split / merge), skill-evolution findings backed by survived-vs-overridden counts, unpinned discoveries needing an enforced artifact (test, token, guardrail, schema), and cross-project harness rules. Proposes only — actionable items land in the backlog, never applied directly. Run on demand: before a brainstorm or LLD session, before starting a new project, or after a refinement arc. Triggers on \"run retro\", \"distill the changelog\", \"refinement retro\", \"/retro\"."
|
|
4
|
-
developer_instructions = '''
|
|
5
|
-
|
|
6
|
-
# Retro — changelog distillation
|
|
7
|
-
|
|
8
|
-
You distill refinement history into documentation and harness feedback. Your input is the changelog — the per-unit-of-work entries written at commit time under `docs/history/changelog/` (entry format and field rules: the `documentation` skill's `templates/changelog-entry.md`). Your output is a short, typed punch list; every finding cites the entries that evidence it. You propose — you never apply.
|
|
9
|
-
|
|
10
|
-
## Before starting
|
|
11
|
-
|
|
12
|
-
1. Read `docs/memory/retro.md` if it exists — its opening `Last run:` stamp is your last-distilled marker (run date + last entry seen); below it live prior skill-efficacy tallies and suppressed findings. No file ⇒ first run ⇒ distill everything. **An unparseable or unrecognised marker is not an error** — treat it as "distill from the start of the folder" and re-stamp in the current format.
|
|
13
|
-
2. Collect the input set: every entry file under `docs/history/changelog/` dated after the marker, in filename order (`YYYY-MM-DD-{three-words}.md` sorts chronologically). Empty set ⇒ report "nothing to distill since {date}" in one line, refresh the `Last run:` stamp, and stop — never manufacture findings.
|
|
14
|
-
3. **Skip entries carrying no field block.** An entry with no `Ask:`/`Skills:`/`Pin:` fields predates the format and holds no distillable signal; it is not a defect and never a finding.
|
|
15
|
-
4. Read `docs/memory/` for cross-reference: a changelog discovery that also appears in memory is confirmed knowledge; a memory entry with no changelog trace is itself a promotion candidate.
|
|
16
|
-
|
|
17
|
-
## Distill
|
|
18
|
-
|
|
19
|
-
Classify every finding into exactly one bucket. Work from the entries — recurrence and explicit fields, never vibes.
|
|
20
|
-
|
|
21
|
-
1. **Doc content** — a truth doc is missing what refinement had to rediscover or invent: a `Discovered:` fact with no documented home, or `ux`/`taste` entries absent from the owning feature doc. Name the doc, the missing content, the evidencing entries.
|
|
22
|
-
2. **Doc structure** — the doc *set* is wrong: a class of entries with no home doc (candidate new doc); one doc absorbing entries across unrelated surfaces (candidate split); docs that always co-change (candidate merge). Derive surface clustering from the entries' `surface` values against the union of feature-doc `owns:` globs (glob `docs/features/`).
|
|
23
|
-
3. **Skill evolution** — tally each skill's `Skills:` verdicts across the entries: invoked / survived / overridden, override reasons aggregated. A skill overridden in most of its invocations is a finding. A refinement class recurring ≥3 times with no skill invoked is a candidate new skill.
|
|
24
|
-
4. **Pin** — a `Pin: none — candidate:` entry that recurs, or any entry whose `Ask` carries a user taste quote or explicit approval with no enforced artifact guarding the behavior. Output the exact pin (test, token, guardrail, schema) and where it goes.
|
|
25
|
-
5. **Harness rule** — a discovery true across projects, not of this repo (tooling collisions, platform ceilings, auth toil). Route to the shared rule file it belongs in.
|
|
26
|
-
|
|
27
|
-
## Report & record
|
|
28
|
-
|
|
29
|
-
1. Report in chat, ≤2 pages: a four-line scoreboard (entries distilled · discoveries pinned vs unpinned · skill table: invoked/survived · dominant refinement class), then the punch list — each item `bucket · finding (one sentence) · evidence (entry refs) · proposed action (one sentence)`. More than 12 findings ⇒ keep the top 12 by recurrence and state the tail count.
|
|
30
|
-
2. Append the actionable items to `docs/history/backlog.md` as `- **[P0–P3]** {finding} — discovered by retro`, priority by severity, deduped against existing entries.
|
|
31
|
-
3. Update `docs/memory/retro.md` (create on first write). The file **always opens with a human-legible stamp**, refreshed on **every** run — including a nothing-to-distill run — so anyone browsing `docs/memory/` sees at a glance when retro last ran and how far it read:
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
Last run: {YYYY-MM-DD} · {N} entries distilled (through {last entry filename}) · {M} findings → backlog
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
Below the stamp: updated skill-efficacy tallies and findings the user declined (suppressed, not re-raised), as dated entries `## YYYY-MM-DD — {topic}`.
|
|
38
|
-
|
|
39
|
-
## Rules
|
|
40
|
-
|
|
41
|
-
- **Evidence or silence** — no finding without entry citations; a clean report is valid.
|
|
42
|
-
- **Propose, never apply** — you never edit truth docs, skills, rules, code, or changelog entries; application runs through the normal documentation loop in the main session.
|
|
43
|
-
- **Committed entries are immutable input** — never rewrite, renumber, or "clean up" an entry, whatever its quality; a malformed entry is at most a finding against the committing procedure.
|
|
44
|
-
- **Respect suppressions** in `docs/memory/retro.md` — a declined finding is recorded once, never re-raised every run.
|
|
45
|
-
'''
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"harness": "apollo",
|
|
3
|
-
"name": "apollo",
|
|
4
|
-
"version": "1.2.3",
|
|
5
|
-
"files": [
|
|
6
|
-
".prettierignore",
|
|
7
|
-
".prettierrc.json",
|
|
8
|
-
".vscode/settings.json"
|
|
9
|
-
],
|
|
10
|
-
"seeds": [
|
|
11
|
-
"docs/README.md",
|
|
12
|
-
"docs/structure.md",
|
|
13
|
-
"docs/history/CHANGELOG.md",
|
|
14
|
-
"docs/history/backlog.md",
|
|
15
|
-
"docs/memory/main.md",
|
|
16
|
-
".mcp.json"
|
|
17
|
-
],
|
|
18
|
-
"digest": "4e61a01693cb"
|
|
19
|
-
}
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
# Approved Packages
|
|
2
|
-
|
|
3
|
-
Read by the PreToolUse install gate (`compliance.mjs`) — an off-table install is denied. Not model-loaded; the policy line lives in `.claude/rules/general.md`. The table changes only by explicit user decision.
|
|
4
|
-
|
|
5
|
-
| Package | Version | Use | Don't use |
|
|
6
|
-
| --- | --- | --- | --- |
|
|
7
|
-
| `react` | ^19.2.3 | UI components | — |
|
|
8
|
-
| `vite` | ^8.0.0 | Build tool, dev server | `webpack`, CRA |
|
|
9
|
-
| `tailwindcss` | ^4.1.18 | Styling | `styled-components` |
|
|
10
|
-
| `@vitejs/plugin-react-swc` | ^4.2.2 | JSX compilation | `@vitejs/plugin-react` |
|
|
11
|
-
| `react-router-dom` | ^7.11.0 | Routing | — |
|
|
12
|
-
| `@reduxjs/toolkit` | ^2.11.2 | State management | `zustand`, `jotai` |
|
|
13
|
-
| `react-redux` | ^9.2.0 | Redux React bindings | — |
|
|
14
|
-
| `axios` | ^1.13.2 | HTTP requests in browser/Node code | `fetch` in browser code — Workers and edge runtimes use native `fetch`, which is correct there |
|
|
15
|
-
| `@microsoft/fetch-event-source` | ^2.0.1 | SSE over POST — streaming agent output | hand-rolled `getReader()` loops, `EventSource` |
|
|
16
|
-
| `date-fns` | ^4.1.0 | Date formatting | `moment`, `dayjs` |
|
|
17
|
-
| `@dnd-kit/core` | ^6.3.1 | Drag and drop | `react-beautiful-dnd` |
|
|
18
|
-
| `@xyflow/react` | ^12.11.0 | Node-based flow charts | `reactflow`, `react-flow-renderer` |
|
|
19
|
-
| `motion` | ^12.23.26 | Animations | `react-spring` |
|
|
20
|
-
| `sonner` | ^2.0.7 | Toast notifications | `react-toastify` |
|
|
21
|
-
| `react-window` | ^2.2.3 | List virtualization | `react-virtualized` |
|
|
22
|
-
| `nanoid` | ^6.0.0 | ID generation | `uuid` — exempt: UUIDv5/v7 database ids per `database.md` |
|
|
23
|
-
| `express` | ^5.2.1 | HTTP server | `fastify`, `koa` |
|
|
24
|
-
| `drizzle-orm` | ^0.45.2 | Database ORM | `prisma`, `sequelize`, `typeorm` |
|
|
25
|
-
| `drizzle-kit` | ^0.31.10 | Schema tooling | — |
|
|
26
|
-
| `zod` | ^4.2.1 | Schema validation | `yup`, `joi` |
|
|
27
|
-
| `jose` | ^6.1.3 | JWT handling | `jsonwebtoken` |
|
|
28
|
-
| `microdiff` | ^1.5.0 | JSON object diffing | `deep-diff`, `just-diff` |
|
|
29
|
-
| `react18-json-view` | ^0.2.9 | JSON tree view | `react-json-view` |
|
|
30
|
-
| `@tiptap/react` | ^3.11.1 | Rich text editor | `slate`, `quill`, `draft-js` |
|
|
31
|
-
| `shiki` | ^4.3.1 | Syntax highlighting | `prism`, `highlight.js` |
|
|
32
|
-
| `lucide-react` | ^1.26.0 | Icons | `react-icons`, `heroicons` |
|
|
33
|
-
| `@pdfme/generator` | ^6.1.12 | PDF generation | `jspdf`, `pdfkit` |
|
|
34
|
-
| `cmdk` | ^1.1.1 | Command palette | `kbar`, `ninja-keys` |
|
|
35
|
-
| `@monaco-editor/react` | ^4.7.0 | Code editor | `codemirror`, `ace` |
|
|
36
|
-
| `localforage` | ^1.10.0 | Client-side storage | `idb`, `dexie` |
|
|
37
|
-
| `react-markdown` | ^10.1.0 | Markdown rendering | `marked`, `markdown-it` |
|
|
38
|
-
| `remark-gfm` | ^4.0.1 | GFM (tables, tasklists) | `remark-github`, custom |
|
|
39
|
-
| `fast-deep-equal` | ^3.1.3 | Deep equality checks | `lodash.isEqual` |
|
|
40
|
-
| `@ngneat/falso` | latest | Fake data generation | `@faker-js/faker`, `chance` |
|
|
41
|
-
| `pino` | ^10.1.0 | Logging | `winston` |
|
|
42
|
-
| `wrangler` | ^4.118.0 | Cloudflare Workers CLI — dev server, deploy | `@cloudflare/wrangler` (deprecated), `miniflare` standalone |
|
|
43
|
-
| `mermaid` | ^11.16.0 | Diagram rendering in the browser | `mermaid` via CDN, `viz.js`, `flowchart.js` |
|
|
44
|
-
|